cvs: phpdoc-ja /reference/image/functions exif-imagetype.xml exif-read-data.xml exif-thumbnail.xml iptcparse.xml

hirokawa Fri Jun 21 01:30:55 2002 EDT Added files: /phpdoc-ja/reference/image/functions exif-imagetype.xml exif-read-data.xml exif-thumbnail.xml iptcparse.xml Log: update translation.

Index: phpdoc-ja/reference/image/functions/exif-imagetype.xml +++ phpdoc-ja/reference/image/functions/exif-imagetype.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.81 --> <refentry id="function.exif-imagetype"> <refnamediv> <refname>exif_imagetype</refname> <refpurpose>イメージの型を定義する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>int|false</type><methodname>exif_imagetype</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> <function>exif_imagetype</function>はイメージの先頭バイトを読み、そ のサインを調べます。正しいサインがみつかった場合は定数が返され、そ の他の場合は、&false;が返されます。返り値は <function>getimagesize</function>が添字2に返す値と同じですが、この 関数はずっとはやく動作します。 </para> <para> 以下の定数が定義されています。 1 = IMAGETYPE_GIF, 2 = IMAGETYPE_JPG, 3 = IMAGETYPE_PNG, 4 = IMAGETYPE_SWF, 5 = IMAGETYPE_PSD, 6 = IMAGETYPE_BMP, 7 = IMAGETYPE_TIFF_II (intel byte order), 8 = IMAGETYPE_TIFF_MM (motorola byte order), 9 = IMAGETYPE_JPC, 10 = IMAGETYPE_JP2, 11 = IMAGETYPE_JPX. </para> <para> この関数は、他のexif関数がサポートされていないファイル型式でコール されるのを防止したり、$_SERVER['HTTP_ACCEPT']と組み合わせて、 イメージを見る人がブラウザに特定のイメージを見ることができるかどう かを調べるために使用可能です。 </para> <para> <note> <simpara> この関数は、<option role="configure">--enable-exif</option>を指定 してPHP 4がコンパイルされている場合のみ利用可能です。 </simpara> <simpara> この関数は、GDイメージライブラリを必要としません。 </simpara> <simpara> <function>getimagesize</function>も参照ください。 </simpara> </note> </para> </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:"../../../../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 --> Index: phpdoc-ja/reference/image/functions/exif-read-data.xml +++ phpdoc-ja/reference/image/functions/exif-read-data.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry id="function.exif-read-data"> <refnamediv> <refname>exif_read_data</refname> <refpurpose> <acronym>JPEG</acronym>または<acronym>TIFF</acronym>から <acronym>EXIF</acronym>ヘッダを読みこむ </refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>exif_read_data</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>sections</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>arrays</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>thumbnail</parameter></methodparam> </methodsynopsis> <para> 関数<function>exif_read_data</function>はJPEGまたはTIFFイメージファ イルからEXIFヘッダを読みこみます。この関数は、キーがヘッダ名、値 がヘッダに関連するの値となる連想配列を返します。返すデータがない 場合、&false;が返されます。 </para> <para> <parameter>filename</parameter>は読みこむファイル名です。これは、 URLとして使用することはできません。 </para> <para> <parameter>sections</parameter>は、結果の配列を生成する際に含める カンマ区切りのセクションのリストです。 <informaltable> <tgroup cols="2"> <tbody> <row> <entry>FILE</entry> <entry>FileName, FileSize, FileDateTime, SectionsFound</entry> </row> <row> <entry>COMPUTED</entry> <entry>html, Width, Height, IsColor 及び他の取得可能なもの </entry> </row> <row> <entry>ANY_TAG</entry> <entry>タグを有する全ての情報 例えば、IFD0, EXIF, ...</entry> </row> <row> <entry>IFD0</entry> <entry>IFD0の全てのタグ付きのデータ。通常のイメージファイルで は、これにはイメージサイズが含まれます。</entry> </row> <row> <entry>THUMBNAIL</entry> <entry> 2番目のIFDがある場合にファイルにサムネイルが含まれている可能 性があります。埋め込まれているサムネイルに関する全てのタグ付 きの情報はこのセクションに保存されています。 </entry> </row> <row> <entry>COMMENT</entry> <entry>JPEGイメージのコメントヘッダ。</entry> </row> <row> <entry>EXIF</entry> <entry> EXIFセクションは、IFD0のサブセクションです。このセクションに は、イメージに関するより詳細な情報が含まれています。これらの エントリの多くはデジタルカメラに関するものです。 </entry> </row> </tbody> </tgroup> </informaltable> </para> <para> <parameter>arrays</parameter>は、各セクションを配列とするかどうか を指定します。セクション<emphasis>FILE</emphasis>、 <emphasis>COMPUTED</emphasis>、<emphasis>THUMBNAIL</emphasis>は、 常に配列となります。これは、これらのセクションに含まれる値の名前 が他のセクションと衝突するためです。 </para> <para> <parameter>thumbnail</parameter>は、サムネイルのタグ付きのデータ だけでなく、サムネイル本体を読みこむかどうかを指定します。 </para> <note> <para> Exifヘッダはデジタルカメラにより生成されたJPEG/TIFFイメージで使 用される傾向がありますが、残念なことに、各デジタルカメラメーカー は、個々のイメージに関するタグ付けの方法について異なった考えを持っ ており、特定のExifヘッダの存在を仮定することはできません。 </para> </note> <para> <example> <title><function>exif_read_data</function>の例</title> <programlisting role="php"> <![CDATA[ <?php echo "test1.jpg:<br>\n"; $exif = exif_read_data ('tests/test1.jpg','IFD0'); echo $exif===false ? "No header data found.<br>\n" : "Image contains headers<br>"; $exif = exif_read_data ('tests/test2.jpg',0,true); echo "test2.jpg:<br>\n"; foreach($exif as $key=>$section) { foreach($section as $name=>$val) { echo "$key.$name: $val<br>\n"; } }?> ]]> </programlisting> <para> 最初のコールは、失敗します。これは、イメージがヘッダ情報を有していないためです。 <screen role="php"> <![CDATA[ test1.jpg: No header data found. test2.jpg: FILE.FileName: test2.jpg FILE.FileDateTime: 1017666176 FILE.FileSize: 1240 FILE.FileType: 2 FILE.SectionsFound: ANY_TAG, IFD0, THUMBNAIL, COMMENT COMPUTED.html: width="1" height="1" COMPUTED.Height: 1 COMPUTED.Width: 1 COMPUTED.IsColor: 1 COMPUTED.ByteOrderMotorola: 1 COMPUTED.UserComment: Exif test image. COMPUTED.UserCommentEncoding: ASCII COMPUTED.Copyright: Photo (c) M.Boerger, Edited by M.Boerger. COMPUTED.Copyright.Photographer: Photo (c) M.Boerger COMPUTED.Copyright.Editor: Edited by M.Boerger. IFD0.Copyright: Photo (c) M.Boerger IFD0.UserComment: ASCII THUMBNAIL.JPEGInterchangeFormat: 134 THUMBNAIL.JPEGInterchangeFormatLength: 523 COMMENT.0: Comment #1. COMMENT.1: Comment #2. COMMENT.2: Comment #3end ]]> <!-- バージョン4.3で以下が追加されます。 THUMBNAIL.JPEGInterchangeFormat: 134 THUMBNAIL.Thumbnail.Height: 1 THUMBNAIL.Thumbnail.Height: 1 --> </screen> </para> </example> </para> <note> <para> イメージに何らかのIFDOデータが含まれている場合、COMPUTEDにはエン トリByteOrderMotorolaが含まれます。このエントリは、バイトオーダ がリトルインディアン(インテル)の場合に0、ビッグインディアン(モト ローラ)の場合に1となります。これは、PHP 4.3で追加されました。 </para> <para> ExifヘッダにCopyrightが含まれる場合、これには2つの値が含まれる可 能性があります。これはExif 2.10の規約に沿っていないため、 COMPUTEDセクションは、エントリ <emphasis>Copyright.Photographer</emphasis>および <emphasis>Copyright.Editor</emphasis> をともに返しますが、 IFD0セクションには両方のエントリをNULL文字で分割した型式のバイト 配列が含まれます。さもなくば、(Exifのデフォルト処理に基づき)デー タ型式に誤りがあるとして最初のエントリのみを返します。 COMPUTEDには、エントリ<emphasis>Copyright</emphasis>も含まれます。 これは、元のcopyright文字列またはphotoおよびeditor copyrightのカ ンマ区切りのリストとなります。 </para> </note> <note> <para> UserCommentタグにはCopyrightタグと同様の問題があります。 このタグには2つの値を保存する可能性があり、この場合、使用される エンコーディングが最初に、値自体が2番目にきます。この場合、IFDセ クションにはエンコーディングまたはバイト配列のみが含まれます。 COMPUTEDセクションには、エントリ <emphasis>UserCommentEncoding</emphasis>と <emphasis>UserComment</emphasis>の両方を保存します。 エントリ<emphasis>UserComment</emphasis>はどちらの場合でも取得可 能です。このため、FD0セクションの値の識別に使用されます。 </para> <para> ユーザコメントがUnicodeまたはJISエンコーディングを使用しており、 モジュールmbstringが利用できる場合、このエンコーディングはexifの 初期設定に基づき自動的に変更されます。この機能は、PHP 4.3で追加 されました。 </para> </note> <note> <para> Height と Width は、<function>getimagesize</function>と同じ方法 で計算されます。このため、これらの値はヘッダの一部として返す際に 使用するべきではありません。また、htmlは通常の <acronym>HTML</acronym>で使用されるheight/widthテキスト文字列です。 </para> </note> <note> <para> PHP 4.3以降、この関数は配列を含む埋めこまれた <acronym>IFD</acronym>データを全て読むことが可能となっています。 また、埋めこみのサムネイルの大きさもサブ配列 <emphasis>THUMBNAIL</emphasis>に返されます。 関数<function>exif_read_data</function>は<acronym>TIFF</acronym> 型式のサムネイルを返すことが可能です。 最後に返り値の(メモリリミットに達するまでではない)最大長はもはや ないことを追記しておきます。 </para> </note> <note> <simpara> この関数は、<option role="configure">--enable-exif</option>を指 定してPHP 4をコンパイルした場合のみ使用可能です。この機能と動作 は、PHP 4.2で変更されています。これより以前のバージョンは非常に 不安定です。 </simpara> <simpara> PHP 4.3以降、<option role="configure">--enable-mbstring</option>を指定してPHP 4がコ ンパイルされている場合、ユーザコメントのエンコーディングは自動 的に変換されます。 </simpara> <simpara> この関数は、GDイメージライブラリを必要としません。 </simpara> <simpara> <function>exif_thumbnail</function> および <function>getimagesize</function>も参照ください。 </simpara> </note> </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:"../../../../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 --> Index: phpdoc-ja/reference/image/functions/exif-thumbnail.xml +++ phpdoc-ja/reference/image/functions/exif-thumbnail.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.78 --> <refentry id="function.exif-thumbnail"> <refnamediv> <refname>exif_thumbnail</refname> <refpurpose>TIFFまたはJPEGイメージに埋め込まれたサムネイルを取得する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>string</type><methodname>exif_thumbnail</methodname> <methodparam><type>string</type><parameter>filename</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>&amp;width</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>&amp;height</parameter></methodparam> </methodsynopsis> <para> <function>exif_thumbnail</function>は、TIFFまたはJPEGイメージに埋め 込まれたサムネイルを読みこみます。サムネイルを含まないイメージの場 合は、&false;を返します。 </para> <para> パラメータ<parameter>width</parameter>および <parameter>height</parameter>はともにPHP 4.3以降で利用可能で、 サムネイルのサイズを返します。<function>exif_thumbnail</function>が イメージを生成できないが、そのサイズを定義することもありえます。 この場合、返り値は&false;となりますが、 <parameter>width</parameter>および<parameter>height</parameter>は設 定されます。 </para> <para> バージョンPHP 4.3以降、関数<function>exif_thumbnail</function>は <acronym>TIFF</acronym>型式のサムネイルも返します。 </para> <para> <note> <simpara> この関数は、<option role="configure">--enable-exif</option>を指定 してPHP 4がコンパイルされている場合のみ利用可能です。 </simpara> <simpara> この関数は、GDイメージライブラリを必要としません。 </simpara> <simpara> <function>exif_read_data</function>も参照ください。 </simpara> </note> </para> </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:"../../../../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 --> Index: phpdoc-ja/reference/image/functions/iptcparse.xml +++ phpdoc-ja/reference/image/functions/iptcparse.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- splitted from ./en/functions/misc.xml, last change in rev 1.2 --> <refentry id="function.iptcparse"> <refnamediv> <refname>iptcparse</refname> <refpurpose> バイナリのIPTC<ulink url="&url.iptc;">&url.iptc;</ulink>ブロックを パースする </refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>iptcparse</methodname> <methodparam><type>string</type><parameter>iptcblock</parameter></methodparam> </methodsynopsis> <simpara> この関数はバイナリのIPTCブロックに含まれるタグをパースします。この 関数は、タグマーカを配列の添字、値を配列の値として使用した配列を返 します。この関数は、エラーやIPTCデータが見付からなかった時に&false; を返します。<function>getimagesize</function>のサンプルを参照下さい。 </simpara> </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:"../../../../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 -->