-
Notifications
You must be signed in to change notification settings - Fork 49
/
iptcembed.xml
150 lines (138 loc) · 3.84 KB
/
iptcembed.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a08be5cd1e589aa206aaee6b20443b5b802bf1d5 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id='function.iptcembed' xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iptcembed</refname>
<refpurpose>Incluir información IPTC binaria en una imagen JPEG</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>iptcembed</methodname>
<methodparam><type>string</type><parameter>iptcdata</parameter></methodparam>
<methodparam><type>string</type><parameter>jpeg_file_name</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>spool</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
Incluye información IPTC binaria en una imagen JPEG.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>iptcdata</parameter></term>
<listitem>
<para>
La información que va a ser escrita.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>jpeg_file_name</parameter></term>
<listitem>
<para>
Ruta a la imagen JPEG.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>spool</parameter></term>
<listitem>
<para>
Bandera de spool. Si la bandera de spool es menor que 2, el JPEG será
devuelto como una cadena. De lo contrario el JPEG será enviado a STDOUT.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Si <parameter>spool</parameter> es menor que 2, se devolverá el JPEG,
&return.falseforfailure;. De lo contrario devuelve &true; en caso de éxito
&return.falseforfailure;.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Incluir información IPTC a un JPEG</title>
<programlisting role="php">
<![CDATA[
<?php
// Función iptc_make_tag() por Thies C. Arntzen
function iptc_make_tag($rec, $data, $value)
{
$length = strlen($value);
$retval = chr(0x1C) . chr($rec) . chr($data);
if($length < 0x8000)
{
$retval .= chr($length >> 8) . chr($length & 0xFF);
}
else
{
$retval .= chr(0x80) .
chr(0x04) .
chr(($length >> 24) & 0xFF) .
chr(($length >> 16) & 0xFF) .
chr(($length >> 8) & 0xFF) .
chr($length & 0xFF);
}
return $retval . $value;
}
// Ruta al fichero jpeg
$ruta = './phplogo.jpg';
// Establecer las etiquetas IPTC
$iptc = array(
'2#120' => 'Imagen de prueba',
'2#116' => 'Copyright 2008-2009, The PHP Group'
);
// Convertir las etiquetas IPTC en código binario
$data = '';
foreach($iptc as $etiqueta => $cadena)
{
$etiqueta = substr($etiqueta, 2);
$data .= iptc_make_tag(2, $etiqueta, $cadena);
}
// Incluir la información IPTC
$contenido = iptcembed($data, $ruta);
// Escribir la nueva información de la imagen en un fichero.
$fp = fopen($ruta, "wb");
fwrite($fp, $contenido);
fclose($fp);
?>
]]>
</programlisting>
</example>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
¬e.gd.notrequired;
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->