<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: hirokawa Status: ready -->

<!-- CREDITS: shimooka -->

<refentry xml:id="function.iptcembed" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>iptcembed</refname>

<refpurpose>バイナリ IPTC データを JPEG イメージに埋めこむ</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>string</type><type>bool</type></type><methodname>iptcembed</methodname>

<methodparam><type>string</type><parameter>iptc_data</parameter></methodparam>

<methodparam><type>string</type><parameter>filename</parameter></methodparam>

<methodparam choice="opt"><type>int</type><parameter>spool</parameter><initializer>0</initializer></methodparam>

</methodsynopsis>

<para>

バイナリ IPTC データを JPEG イメージに埋めこみます。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>iptc_data</parameter></term>

<listitem>

<para>

書き込むデータ。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>filename</parameter></term>

<listitem>

<para>

JPEG 画像へのパス。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>spool</parameter></term>

<listitem>

<para>

Spool フラグ。このフラグが 2 より小さい場合は、JPEG

が文字列として返されます。そうでない場合は、JPEG を STDOUT に出力します。

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

成功し、かつ <parameter>spool</parameter> が 2 より小さい場合は、JPEG を返します。

&return.falseforfailure;。<parameter>spool</parameter> が 2 以上の場合は、成功した場合に &true; を返します。

&return.falseforfailure;。

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<example>

<title>IPTC データの JPEG への埋め込み</title>

<programlisting role="php">

<![CDATA[

<?php

// Thies C. Arntzen による iptc_make_tag() 関数

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;

}

// jpeg ファイルへのパス

$path = './phplogo.jpg';

// IPTC タグを設定します

$iptc = array(

'2#120' => 'Test image',

'2#116' => 'Copyright 2008-2009, The PHP Group'

);

// IPTC タグをバイナリコードに変換します

$data = '';

foreach($iptc as $tag => $string)

{

$tag = substr($tag, 2);

$data .= iptc_make_tag(2, $tag, $string);

}

// IPTC データを埋め込みます

$content = iptcembed($data, $path);

// 新しい画像データをファイルに書き込みます

$fp = fopen($path, "wb");

fwrite($fp, $content);

fclose($fp);

?>

]]>

</programlisting>

</example>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

&note.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

-->