cvs: phpdoc /ja/functions mbstring.xml pdf.xml

hirokawa Sun Jan 6 22:23:28 2002 EDT Modified files: /phpdoc/ja/functions mbstring.xml pdf.xml Log: translation updated.

Index: phpdoc/ja/functions/mbstring.xml diff -u phpdoc/ja/functions/mbstring.xml:1.12 phpdoc/ja/functions/mbstring.xml:1.13 --- phpdoc/ja/functions/mbstring.xml:1.12 Wed Dec 12 15:53:16 2001 +++ phpdoc/ja/functions/mbstring.xml Sun Jan 6 22:23:28 2002 @@ -1,82 +1,82 @@ <?xml version="1.0" encoding="utf-8"?> - <reference id="ref.mbstring"> - <title>マルチバイト文字列関数</title> - <titleabbrev> - マルチバイト文字列 - </titleabbrev> - <partintro> - &warn.experimental; - - <sect1 id="mb-intro"> - <title>導入</title> - <warning> - <simpara> - このモジュールは、実験的なステータスにあります。関数名/APIは変更 - される可能性があります。現在の変換フィルタは日本語のみをサポート - しています。 +<!-- $Revision: 1.13 $ --> +<reference id="ref.mbstring"> + <title>マルチバイト文字列関数</title> + <titleabbrev> + マルチバイト文字列 + </titleabbrev> + <partintro> + <sect1 id="mb-intro"> + <title>導入</title> + <warning> + <simpara> + このモジュールは、実験的なステータスにあります。関数名/APIは変更 + される可能性があります。現在の変換フィルタは日本語のみをサポート + しています。 </simpara> - </warning> - <para> - 全ての文字をシングルバイトで表現可能な言語は数多くあります。マル - チバイト文字コードは、多くの言語で文字を表すために使用されていま - す。<literal>mbstring</literal> は日本語文字を処理するために開発 - されました。しかし、<literal>mbstring</literal> 関数の多くは、日 - 本語以外の文字エンコーディングも処理することが可能です。 - </para> - <para> - マルチバイト文字エンコーディングは、バイトの並びで単一の文字を表 - 現します。いくつかの文字エンコーディングでは、マルチバイト文字列 - の始まり/終わりを表すためにシフト(エスケープ)シーケンスが使用され - ています。この場合、マルチバイト文字エンコーディングに対応した方 - 法でない限り、分割または追加されるとマルチバイト文字列は壊れてし - まう可能性があります。このモジュールは、マルチバイト文字列に対応 - した文字列関数および変換関数のようなその他のユーティリティ関数を - 提供します。 - </para> - <para> - PHPは、基本的にISO-8859-1用に設計されているため、いくつかのマルチ - バイト文字エンコーディングは、PHPで正常に動作しません。このため、 - <literal>mbstring.internal_encoding</literal> にPHPで動作する文字 - エンコーディングを設定することが必要です。 - </para> - <para> - PHP4の文字エンコーディングに関する規約 - </para> - <para> - <itemizedlist> - <listitem> - <simpara> - バイト毎のエンコーディングである。 - </simpara> - </listitem> - <listitem> - <simpara> - シングルバイト文字は、<literal>ASCII</literal>互換の - <literal>00h-7fh</literal>の範囲にある。 - </simpara> - </listitem> - <listitem> - <simpara> - マルチバイト文字は、<literal>00h-7fh</literal>以外を使用する。 + </warning> + <para> + 全ての文字をシングルバイトで表現可能な言語は数多くあります。マル + チバイト文字コードは、多くの言語で文字を表すために使用されていま + す。<literal>mbstring</literal> は日本語文字を処理するために開発 + されました。しかし、<literal>mbstring</literal> 関数の多くは、日 + 本語以外の文字エンコーディングも処理することが可能です。 + </para> + <para> + マルチバイト文字エンコーディングは、バイトの並びで単一の文字を表 + 現します。いくつかの文字エンコーディングでは、マルチバイト文字列 + の始まり/終わりを表すためにシフト(エスケープ)シーケンスが使用され + ています。この場合、マルチバイト文字エンコーディングに対応した方 + 法でない限り、分割または追加されるとマルチバイト文字列は壊れてし + まう可能性があります。このモジュールは、マルチバイト文字列に対応 + した文字列関数および変換関数のようなその他のユーティリティ関数を + 提供します。 + </para> + <para> + PHPは、基本的にISO-8859-1用に設計されているため、いくつかのマルチ + バイト文字エンコーディングは、PHPで正常に動作しません。このため、 + <literal>mbstring.internal_encoding</literal> にPHPで動作する文字 + エンコーディングを設定することが必要です。 + </para> + <para> + PHP4の文字エンコーディングに関する規約 + </para> + <para> + <itemizedlist> + <listitem> + <simpara> + バイト毎のエンコーディングである。 + </simpara> + </listitem> + <listitem> + <simpara> + シングルバイト文字は、<literal>ASCII</literal>互換の + <literal>00h-7fh</literal>の範囲にある。 + </simpara> + </listitem> + <listitem> + <simpara> + マルチバイト文字は、<literal>00h-7fh</literal>以外を使用する。 </simpara> - </listitem> - </itemizedlist> - </para> - <para> - PHPの内部エンコーディングとして使用可能な文字エンコーディングと - 使用できない文字エンコーディングの例を以下に示します。 - <informalexample> - <programlisting> - + </listitem> + </itemizedlist> + </para> + <para> + PHPの内部エンコーディングとして使用可能な文字エンコーディングと + 使用できない文字エンコーディングの例を以下に示します。 + <informalexample> + <programlisting> +<![CDATA[ PHPで動作する文字エンコーディング: ISO-8859-*, EUC-JP, UTF-8 PHPで動作しない文字エンコーディング: JIS, SJIS - </programlisting> - </informalexample> - </para> - <para> +]]> + </programlisting> + </informalexample> + </para> + <para> PHPの内部エンコーディングとして使用できない文字エンコーディングは、 <literal>mbstring</literal>のHTTP入力/出力変換の機能/関数により変換 することが可能です。 @@ -163,7 +163,10 @@ <example> <title>php.iniでHTTP入力変換を無効にする</title> <programlisting role="php"> +<![CDATA[ +;; HTTP入力変換を無効にする mbstring.http_input = pass +]]> </programlisting> </example> </para> @@ -199,8 +202,8 @@ <para> <example> <title><literal>php.ini</literal>の設定例</title> - <programlisting role="php"> - + <programlisting> +<![CDATA[ ;; 全てのPHPページで出力の文字エンコーディング変換を有効にする ;; 出力バッファリングを有効にする @@ -208,6 +211,7 @@ ;; mb_output_handlerによる出力変換を有効にする output_handler = mb_output_handler +]]> </programlisting> </example> </para> @@ -215,8 +219,8 @@ <example> <title>スクリプトの例</title> <programlisting role="php"> - -&lt;?php +<![CDATA[ +<?php // このページでのみ出力の文字エンコーディング変換を有効にする @@ -227,7 +231,8 @@ // を指定する ob_start('mb_output_handler'); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -356,8 +361,8 @@ <para> <example> <title><literal>php.ini</literal>設定の例</title> - <programlisting role="php"> - + <programlisting> +<![CDATA[ ;; デフォルトの内部エンコーディングを設定 ;; 注意: PHPで動作する文字エンコーディングを使用すること mbstring.internal_encoding = UTF-8 ; 内部エンコーディングをUTF-8に設定 @@ -384,6 +389,7 @@ mbstring.substitute_character = 12307 ; Unicode値を指定 mbstring.substitute_character = none ; 文字を出力しない mbstring.substitute_character = long ; longの例: U+3000,JIS+7E7E +]]> </programlisting> </example> </para> @@ -393,8 +399,8 @@ <literal>EUC-JP</literal> ユーザ用の<literal>php.ini</literal> の設定 </title> - <programlisting role="php"> - + <programlisting> +<![CDATA[ ;; 出力バッファリングを無効にする output_buffering = Off @@ -411,7 +417,8 @@ mbstring.internal_encoding = EUC-JP ;; 無効な文字を出力しない -mbstring.substitute_character = none +mbstring.substitute_character = none +]]> </programlisting> </example> </para> @@ -421,8 +428,8 @@ <literal>SJIS</literal>ユーザ用の<literal>php.ini</literal>の 設定 </title> - <programlisting role="php"> - + <programlisting> +<![CDATA[ ;; 出力のバッファリングを有効に output_buffering = On @@ -442,7 +449,8 @@ mbstring.internal_encoding = EUC-JP ;; 無効な文字を出力しない -mbstring.substitute_character = none +mbstring.substitute_character = none +]]> </programlisting> </example> </para> @@ -662,11 +670,13 @@ <example> <title><function>mb_internal_encoding</function>の例</title> <programlisting role="php"> +<![CDATA[ /* 内部文字エンコーディングをUTF-8に設定 */ mb_internal_encoding("UTF-8"); /* カレントの内部文字エンコーディングを表示 */ echo mb_internal_encoding(); +]]> </programlisting> </example> </para> @@ -828,6 +838,7 @@ <example> <title><function>mb_detect_order</function>の例</title> <programlisting role="php"> +<![CDATA[ /* リストで検出順を設定 */ mb_detect_order("eucjp-win,sjis-win,UTF-8"); @@ -839,6 +850,7 @@ /* カレントの検出順を表示 */ echo implode(", ", mb_detect_order()); +]]> </programlisting> </example> </para> @@ -905,7 +917,8 @@ <example> <title><function>mb_substitute_character</function> の例</title> <programlisting role="php"> -/* Unicode U+3013 (〓)を設定 */ +<![CDATA[ +/* Unicode U+3013 (ゲタ記号)を設定 */ mb_substitute_character(0x3013); /* HEXフォーマットを設定 */ @@ -913,6 +926,7 @@ /* カレントの設定を表示 */ echo mb_substitute_character(); +]]> </programlisting> </example> </para> @@ -943,7 +957,7 @@ す。 </para> <para> - 4.0.6 以降のバージョンでは、以下の条件が満たされた場合にこのハン + 4.1.0以降のバージョンでは、以下の条件が満たされた場合にこのハン ドラはcharset HTTP ヘッダを設定します。 </para> <para> @@ -979,8 +993,10 @@ <example> <title><function>mb_output_handler</function>の例</title> <programlisting role="php"> +<![CDATA[ mb_http_output("UTF-8"); ob_start("mb_output_handler"); +]]> </programlisting> </example> </para> @@ -1020,10 +1036,12 @@ <example> <title><function>mb_preferred_mime_string</function>の例</title> <programlisting role="php"> +<![CDATA[ $outputenc = "sjis-win"; mb_http_output($outputenc); ob_start("mb_output_handler"); Header("Content-Type: text/html; charset=" . mb_preferred_mime_name($outputenc)); +]]> </programlisting> </example> </para> @@ -1295,6 +1313,7 @@ <para> <informalexample> <programlisting> +<![CDATA[ 文字幅 U+0000 - U+0019 0 @@ -1302,6 +1321,7 @@ U+2000 - U+FF60 2 U+FF61 - U+FF9F 1 U+FFA0 - 2 +]]> </programlisting> </informalexample> </para> @@ -1358,7 +1378,9 @@ <example> <title><function>mb_strimwidth</function> の例</title> <programlisting role="php"> +<![CDATA[ $str = mb_strimwidth($str, 0, 40, "..>"); +]]> </programlisting> </example> </para> @@ -1404,6 +1426,7 @@ <example> <title><function>mb_convert_encoding</function>の例</title> <programlisting role="php"> +<![CDATA[ /* 内部文字エンコーディングからSJISに変換 */ $str = mb_convert_encoding($str, "SJIS"); @@ -1415,7 +1438,7 @@ /* "auto" は、"ASCII,JIS,UTF-8,EUC-JP,SJIS" に展開される */ $str = mb_convert_encoding($str, "EUC-JP", "auto"); - +]]> </programlisting> </example> </para> @@ -1459,6 +1482,7 @@ <example> <title><function>mb_detect_encoding</function> の例</title> <programlisting role="php"> +<![CDATA[ /* カレントのdetect_orderで文字エンコーディングを検出 */ echo mb_detect_encoding($str); @@ -1473,6 +1497,7 @@ $ary[] = "JIS"; $ary[] = "EUC-JP"; echo mb_detect_encoding($str, $ary); +]]> </programlisting> </example> </para> @@ -1517,6 +1542,7 @@ <para> <informalexample> <programlisting> +<![CDATA[ 使用可能な変換オプション オプション : 以下のオプションを変換時に指定します。デフォルトは @@ -1538,6 +1564,7 @@ "c" : 「全角かた仮名」を「全角ひら仮名」に変換 "C" : 「全角ひら仮名」を「全角かた仮名」に変換 "V" : 濁点付きの文字を一文字に変換。"K","H"と共に使用します。 +]]> </programlisting> </informalexample> </para> @@ -1545,12 +1572,14 @@ <example> <title><function>mb_convert_kana</function> の例</title> <programlisting role="php"> +<![CDATA[ /* 「仮名」を全て「全角カタカナ」に変換します */ $str = mb_convert_kana($str, "KVC"); /* 「半角カタカナ」を「全角カタカナ」に変換し、「全角」英数字を「半角」 に変換します。 */ $str = mb_convert_kana($str, "KVa"); +]]> </programlisting> </example> </para> @@ -1602,11 +1631,13 @@ <example> <title><function>mb_convert_kana</function> の例</title> <programlisting role="php"> +<![CDATA[ $name = "太郎"; // 漢字 $mbox = "kru"; $doma = "gtinn.mon"; -$addr = mb_encode_mimeheader($name, "UTF-7", "Q") . " &lt;" . $mbox . "@" . $doma . ">"; +$addr = mb_encode_mimeheader($name, "UTF-7", "Q") . " <" . $mbox . "@" . $doma . ">"; echo $addr; +]]> </programlisting> </example> </para> @@ -1688,9 +1719,11 @@ <example> <title><function>mb_convert_variables</function> の例</title> <programlisting role="php"> +<![CDATA[ /* 変数 $post1, $post2 を内部エンコーディングに変換する */ $interenc = mb_internal_encoding(); $inputenc = mb_convert_variables($interenc, "ASCII,UTF-8,SJIS-win", $post1, $post2); +]]> </programlisting> </example> </para> @@ -1733,6 +1766,7 @@ <example> <title><parameter>convmap</parameter> の例</title> <programlisting role="php"> +<![CDATA[ $convmap = array ( int start_code1, int end_code1, int offset1, int mask1, int start_code2, int end_code2, int offset2, int mask2, @@ -1741,6 +1775,7 @@ // start_codeN および end_codeN に Unicode値を指定 // 値にoffsetNを追加、マスクmaskNを指定してビット毎の'AND'をとり、 // 数値エンティティに値を変換します。 +]]> </programlisting> </example> </para> @@ -1750,6 +1785,7 @@ <function>mb_encode_numericentity</function> の例 </title> <programlisting role="php"> +<![CDATA[ /* ISO-8859-1の左面をHTML数値エンティティに変換 */ $convmap = array(0x80, 0xff, 0, 0xff); $str = mb_encode_numericentity($str, $convmap, "ISO-8859-1"); @@ -1768,6 +1804,7 @@ 0xe2f0, 0xe32e, 0x1150, 0xffff, 0xe32f, 0xe3ab, 0x1151, 0xffff ); $str = mb_encode_numericentity($str, $convmap, "sjis-win"); +]]> </programlisting> </example> </para> @@ -1811,7 +1848,8 @@ <para> <example> <title><parameter>convmap</parameter> の例</title> - <programlisting> + <programlisting role="php"> +<![CDATA[ $convmap = array ( int start_code1, int end_code1, int offset1, int mask1, int start_code2, int end_code2, int offset2, int mask2, @@ -1820,6 +1858,7 @@ // start_codeN および end_codeN に Unicode値を指定 // 値にoffsetNを追加、マスクmaskNを指定してビット毎の'AND'をとり、 // 数値エンティティに値を変換します。 +]]> </programlisting> </example> </para> @@ -1829,68 +1868,105 @@ </refsect1> </refentry> - <refentry id="function.mb-send-mail"> - <refnamediv> + <refentry id="function.mb-send-mail"> + <refnamediv> <refname>mb_send_mail</refname> - <refpurpose> + <refpurpose> エンコード変換を行ってメールを送信する - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>boolean <function>mb_send_mail</function></funcdef> + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>boolean <function>mb_send_mail</function></funcdef> <paramdef>string <parameter>to</parameter></paramdef> - <paramdef>string <parameter>subject</parameter></paramdef> + <paramdef>string <parameter>subject</parameter></paramdef> <paramdef>string <parameter>message</parameter></paramdef> - <paramdef>string - <parameter><optional>additional_headers</optional></parameter> - </paramdef> - <paramdef>string - <parameter><optional>additional_parameter</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>mb_send_mail</function> は、emailを送信します。ヘッダと - メッセージは<function>mb_language</function>の設定に基づき変換、 - エンコードされます。<function>mb_send_mail</function> は、 - <function>mail</function>のラッパー関数です。詳細は、 - <function>mail</function> を参照下さい。 - </para> - <para> - <parameter>to</parameter> は送信先のメールアドレスです。各アドレ - スをカンマで区切ることにより複数の宛先を指定可能です。 - </para> - <para> - <parameter>subject</parameter> はメールの題名です。 - </para> - <para> - <parameter>message</parameter> はメールのメッセージです。 - </para> - <para> + <paramdef>string + <parameter><optional>additional_headers</optional></parameter> + </paramdef> + <paramdef>string + <parameter><optional>additional_parameter</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>mb_send_mail</function> は、emailを送信します。ヘッダと + メッセージは<function>mb_language</function>の設定に基づき変換、 + エンコードされます。<function>mb_send_mail</function> は、 + <function>mail</function>のラッパー関数です。詳細は、 + <function>mail</function> を参照下さい。 + </para> + <para> + <parameter>to</parameter> は送信先のメールアドレスです。各アドレ + スをカンマで区切ることにより複数の宛先を指定可能です。 + </para> + <para> + <parameter>subject</parameter> はメールの題名です。 + </para> + <para> + <parameter>message</parameter> はメールのメッセージです。 + </para> + <para> <parameter>additional_headers</parameter> は、ヘッダの最後に挿入 - されます。これは、通常、ヘッダを追加する際に使用されます。 - 改行(\n)で区切ることにより複数のヘッダを指定可能です。 - </para> - <para> - <parameter>additional_parameter</parameter> は、MTA のコマンドラ - インパラメータです。sendmailを使用する場合に正しいReturn-Pathを設 - 定する場合に便利です。 - </para> - <para> - 成功時に&true;、その他の場合 - &false;を返します。 - </para> - <para> - <function>mb_language</function>, - <function>mail</function>も参照下さい。 - </para> - </refsect1> - </refentry> - - </reference> + されます。これは、通常、ヘッダを追加する際に使用されます。 + 改行(\n)で区切ることにより複数のヘッダを指定可能です。 + </para> + <para> + <parameter>additional_parameter</parameter> は、MTA のコマンドラ + インパラメータです。sendmailを使用する場合に正しいReturn-Pathを設 + 定する場合に便利です。 + </para> + <para> + 成功時に&true;、その他の場合 + &false;を返します。 + </para> + <para> + <function>mb_language</function>, + <function>mail</function>も参照下さい。 + </para> + </refsect1> + </refentry> + + <refentry id="function.mb-get-info"> + <refnamediv> + <refname>mb_get_info</refname> + <refpurpose>mbstringの内部設定値を取得する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>mb_get_info</function></funcdef> + <paramdef>string + <parameter><optional>type</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + &warn.experimental.func; + <simpara> + <function>mb_get_info</function>は、mbstringの内部設定パラメータ + を返します。 + </simpara> + <para> + <parameter>type</parameter>が指定されない場合または"all"が指定され + た場合、"internal_encoding", "http_output", "http_input", + "func_overload" の設定値を有する連想配列が返されます。 + </para> + <para> + <parameter>type</parameter>に "http_output", + "http_input", "internal_encoding", "func_overload"が指定された場合、 + 指定された設定パラメータが返されます。 + </para> + <para> + <function>mb_internal_encoding</function>, + <function>mb_http_output</function>も参照下さい。 + </para> + </refsect1> + </refentry> + +</reference> <!-- Keep this comment at the end of the file Local variables: Index: phpdoc/ja/functions/pdf.xml diff -u phpdoc/ja/functions/pdf.xml:1.28 phpdoc/ja/functions/pdf.xml:1.29 --- phpdoc/ja/functions/pdf.xml:1.28 Wed Dec 12 15:53:32 2001 +++ phpdoc/ja/functions/pdf.xml Sun Jan 6 22:23:28 2002 @@ -305,7 +305,8 @@ <example> <title>PDFlibでPDFドキュメントを作成する</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $pdf = pdf_new(); pdf_open_file($pdf, "test.pdf"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); @@ -323,22 +324,25 @@ pdf_end_page($pdf); pdf_close($pdf); pdf_delete($pdf); -echo "&lt;A HREF=getpdf.php>完了しました&lt;/A>"; +echo "<A HREF=getpdf.php>完了しました</A>"; ?> +]]> </programlisting> <simpara> 以下のスクリプト<filename>getpdf.php</filename>は、PDFドキュメ ントを返すだけのものです。 </simpara> <informalexample> - <programlisting role="php"> -&lt;?php + <programlisting> +<![CDATA[ +<?php $len = filesize($filename); -header("Content-Length: $len"); header("Content-type: application/pdf"); +header("Content-Length: $len"); header("Content-Disposition: inline; filename=foo.pdf"); readfile($filename); -?&gt; +?> +]]> </programlisting> </informalexample> </example> @@ -354,8 +358,9 @@ <para> <example> <title>PDFlib配布ファイル中の pdfclockの例</title> - <programlisting role="php"> -&lt;?php + <programlisting> +<![CDATA[ +<?php $radius = 200; $margin = 20; $pagecount = 10; @@ -385,7 +390,7 @@ /* 1分刻みの目盛 */ pdf_setlinewidth($pdf, 2.0); - for ($alpha = 0; $alpha &lt; 360; $alpha += 6) { + for ($alpha = 0; $alpha < 360; $alpha += 6) { pdf_rotate($pdf, 6.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin/3, 0.0); @@ -397,7 +402,7 @@ /* 5分刻みの目盛 */ pdf_setlinewidth($pdf, 3.0); - for ($alpha = 0; $alpha &lt; 360; $alpha += 30) { + for ($alpha = 0; $alpha < 360; $alpha += 30) { pdf_rotate($pdf, 30.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin, 0.0); @@ -459,7 +464,8 @@ print $buf; pdf_delete($pdf); -?&gt; +?> +]]> </programlisting> </example> </para> @@ -526,10 +532,10 @@ <funcprototype> <funcdef>int <function>pdf_add_launchlink</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -550,10 +556,10 @@ <funcprototype> <funcdef>int <function>pdf_add_locallink</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>int <parameter>page</parameter></paramdef> <paramdef>string <parameter>dest</parameter></paramdef> </funcprototype> @@ -575,10 +581,10 @@ <funcprototype> <funcdef>int <function>pdf_add_note</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>string <parameter>contents</parameter></paramdef> <paramdef>string <parameter>title</parameter></paramdef> <paramdef>string <parameter>icon</parameter></paramdef> @@ -586,7 +592,7 @@ </funcprototype> </funcsynopsis> <para> - 注記を追加します。iconvは、"comment, "insert", "note", + 注記を追加します。iconは、"comment, "insert", "note", "paragraph", "newparagraph", "key", "help"のどれかとなります。 </para> </refsect1> @@ -619,10 +625,10 @@ <funcprototype> <funcdef>int <function>pdf_add_pdflink</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>int <parameter>page</parameter></paramdef> <paramdef>string <parameter>dest</parameter></paramdef> @@ -665,10 +671,10 @@ <funcprototype> <funcdef>int <function>pdf_add_weblink</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>string <parameter>url</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -743,10 +749,10 @@ <funcprototype> <funcdef>int <function>pdf_attach_file</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>llx</parameter></paramdef> - <paramdef>double <parameter>lly</parameter></paramdef> - <paramdef>double <parameter>urx</parameter></paramdef> - <paramdef>double <parameter>ury</parameter></paramdef> + <paramdef>float <parameter>llx</parameter></paramdef> + <paramdef>float <parameter>lly</parameter></paramdef> + <paramdef>float <parameter>urx</parameter></paramdef> + <paramdef>float <parameter>ury</parameter></paramdef> <paramdef>string <parameter>filename</parameter></paramdef> <paramdef>string <parameter>description</parameter></paramdef> <paramdef>string <parameter>author</parameter></paramdef> @@ -772,12 +778,77 @@ <funcprototype> <funcdef>void <function>pdf_begin_page</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> + <paramdef>float <parameter>height</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 新規ページをドキュメントに追加します。 + <parameter>width</parameter>および<parameter>height</parameter>は、 + ポイント数で指定します。１ポイントは1/72インチです。 + </para> + <para> + <table> + <title>一般的なページの大きさのポイント数</title> + <tgroup cols="2"> + <thead> + <row> + <entry>name</entry> + <entry>size</entry> + </row> + </thead> + <tbody> + <row> + <entry>A0</entry> + <entry>2380&cross;3368</entry> + </row> + <row> + <entry>A1</entry> + <entry>1684&cross;2380</entry> + </row> + <row> + <entry>A2</entry> + <entry>1190&cross;1684</entry> + </row> + <row> + <entry>A3</entry> + <entry>842&cross;1190</entry> + </row> + <row> + <entry>A4</entry> + <entry>595&cross;842</entry> + </row> + <row> + <entry>A5</entry> + <entry>421&cross;595</entry> + </row> + <row> + <entry>A6</entry> + <entry>297&cross;421</entry> + </row> + <row> + <entry>B5</entry> + <entry>501&cross;709</entry> + </row> + <row> + <entry>letter (8.5"&cross;11")</entry> + <entry>612&cross;792</entry> + </row> + <row> + <entry>legal (8.5"&cross;14")</entry> + <entry>612&cross;1008</entry> + </row> + <row> + <entry>ledger (17"&cross;11")</entry> + <entry>1224&cross;792</entry> + </row> + <row> + <entry>11"&cross;17"</entry> + <entry>792&cross;1224</entry> + </row> + </tbody> + </tgroup> + </table> </para> </refsect1> </refentry> @@ -793,10 +864,10 @@ <funcprototype> <funcdef>int <function>pdf_begin_pattern</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> - <paramdef>double <parameter>xstep</parameter></paramdef> - <paramdef>double <parameter>ystep</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> + <paramdef>float <parameter>height</parameter></paramdef> + <paramdef>float <parameter>xstep</parameter></paramdef> + <paramdef>float <parameter>ystep</parameter></paramdef> <paramdef>int <parameter>painttype</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -824,8 +895,8 @@ <funcprototype> <funcdef>void <function>pdf_begin_template</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> + <paramdef>float <parameter>height</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -845,9 +916,9 @@ <funcprototype> <funcdef>void <function>pdf_circle</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>r</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>r</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1030,12 +1101,12 @@ <funcprototype> <funcdef>void <function>pdf_concat</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>a</parameter></paramdef> - <paramdef>double <parameter>b</parameter></paramdef> - <paramdef>double <parameter>c</parameter></paramdef> - <paramdef>double <parameter>d</parameter></paramdef> - <paramdef>double <parameter>e</parameter></paramdef> - <paramdef>double <parameter>f</parameter></paramdef> + <paramdef>float <parameter>a</parameter></paramdef> + <paramdef>float <parameter>b</parameter></paramdef> + <paramdef>float <parameter>c</parameter></paramdef> + <paramdef>float <parameter>d</parameter></paramdef> + <paramdef>float <parameter>e</parameter></paramdef> + <paramdef>float <parameter>f</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1077,12 +1148,12 @@ <funcprototype> <funcdef>void <function>pdf_curveto</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x1</parameter></paramdef> - <paramdef>double <parameter>y1</parameter></paramdef> - <paramdef>double <parameter>x2</parameter></paramdef> - <paramdef>double <parameter>y2</parameter></paramdef> - <paramdef>double <parameter>x3</parameter></paramdef> - <paramdef>double <parameter>y3</parameter></paramdef> + <paramdef>float <parameter>x1</parameter></paramdef> + <paramdef>float <parameter>y1</parameter></paramdef> + <paramdef>float <parameter>x2</parameter></paramdef> + <paramdef>float <parameter>y2</parameter></paramdef> + <paramdef>float <parameter>x3</parameter></paramdef> + <paramdef>float <parameter>y3</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1240,7 +1311,7 @@ <funcdef>void <function>pdf_findfont</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>fontname</parameter></paramdef> - <paramdef>string <parameter>encoding^</parameter></paramdef> + <paramdef>string <parameter>encoding</parameter></paramdef> <paramdef>int <parameter>embed</parameter></paramdef> </funcprototype> </funcsynopsis> @@ -1248,8 +1319,9 @@ この後、<function>pdf_setfont</function>で使用するフォントを準備 します。このフォントのメトリックがロードされ、embedがゼロでない場 合、フォントファイルがチェックされますが、ロードはまだ行われませ - ん。encodingは、"builtin", "macroman", "winansi", "host" またはユー - ザが定義したエンコーディング名またはCMapの名前のどれかとなります。 + ん。<parameter>encoding</parameter>は、"builtin", "macroman", + "winansi", "host" またはユーザが定義したエンコーディング名または + CMapの名前のどれかとなります。 </para> <para> <function>pdf_findfont</function> はフォントのハンドルまたはエラー @@ -1259,14 +1331,16 @@ <example> <title><function>pdf_findfont</function> の例</title> <programlisting role="php"> -&lt;php +<![CDATA[ +<?php $font = pdf_findfont($pdf, "Times New Roman", "winansi", 1); if ($font) { pdf_setfont($pdf, $font, 10); } -?&gt; +?> +]]> </programlisting> </example> </para> @@ -1397,7 +1471,7 @@ <funcdef>string <function>pdf_get_parameter</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>double + <paramdef>float <parameter><optional>modifier</optional></parameter> </paramdef> </funcprototype> @@ -1454,6 +1528,48 @@ </refsect1> </refentry> + <refentry id='function.pdf-get-majorversion'> + <refnamediv> + <refname>pdf_get_majorversion</refname> + <refpurpose> + PDFlibのメジャーバージョン番号を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_get_majorversion</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + PDFlibのメジャーバージョン番号を返します。 + </para> + </refsect1> + </refentry> + + <refentry id='function.pdf-get-minorversion'> + <refnamediv> + <refname>pdf_get_minorversion</refname> + <refpurpose> + PDFlibのマイナーバージョン番号を返す + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_get_majorversion</function></funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + PDFlibのマイナーバージョン番号を返します。 + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-get-value"> <refnamediv> <refname>pdf_get_value</refname> @@ -1463,10 +1579,10 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>double <function>pdf_get_value</function></funcdef> + <funcdef>float <function>pdf_get_value</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>double + <paramdef>float <parameter> <replaceable><optional>modifier</optional></replaceable> </parameter> @@ -1510,8 +1626,8 @@ <funcprototype> <funcdef>void <function>pdf_lineto</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1552,8 +1668,8 @@ <funcprototype> <funcdef>void <function>pdf_moveto</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1630,7 +1746,7 @@ </funcprototype> </funcsynopsis> <para> - 生のCCITTイメージをオープンします。 + raw CCITTイメージをオープンします。 </para> </refsect1> </refentry> @@ -1664,7 +1780,8 @@ <example> <title>PDFドキュメントをメモリ内に作成する</title> <programlisting role="php"> -&lt;?php +<![CDATA[ +<?php $pdf = pdf_new(); @@ -1685,6 +1802,7 @@ echo $data; ?> +]]> </programlisting> </example> </para> @@ -1786,6 +1904,50 @@ </refsect1> </refentry> + <refentry id="function.pdf-open-memory-image"> + <refnamediv> + <refname>pdf_open_memory_image</refname> + <refpurpose> + PHPのイメージ関数で作成されたイメージをオープンする + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pdf_open_memory_image</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>int <parameter>image</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + 関数<function>pdf_open_memory_image</function>は、PHPのイメージ関 + 数で作成されたイメージを入力とし、PDFオブジェクトで利用可能としま + す。関数は、PDFのイメージIDを返します。 + <example> + <title>メモリイメージの読み込み</title> + <programlisting role="php"> +<![CDATA[ +<?php +$im = ImageCreate(100, 100); +$col = ImageColorAllocate($im, 80, 45, 190); +ImageFill($im, 10, 10, $col); +$pim = pdf_open_memory_image($pdf, $im); +ImageDestroy($im); +pdf_place_image($pdf, $pim, 100, 100, 1); +pdf_close_image($pdf, $pim); +?> +]]> + </programlisting> + </example> + </para> + <para> + <function>pdf_close_image</function>, + <function>pdf_place_image</function>も参照下さい。 + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-open-pdi"> <refnamediv> <refname>pdf_open_pdi</refname> @@ -1830,7 +1992,7 @@ </para> </refsect1> </refentry> - + <refentry id="function.pdf-open-png"> <refnamediv> <refname>pdf_open_png</refname> @@ -1884,9 +2046,9 @@ <funcdef>void <function>pdf_place_image</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>int <parameter>image</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>scale</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1909,10 +2071,10 @@ <funcdef>void <function>pdf_place_pdi_page</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>int <parameter>page</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>sx</parameter></paramdef> - <paramdef>double <parameter>sy</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>sx</parameter></paramdef> + <paramdef>float <parameter>sy</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1934,10 +2096,10 @@ <funcprototype> <funcdef>void <function>pdf_rect</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> + <paramdef>float <parameter>height</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -1978,7 +2140,7 @@ <funcprototype> <funcdef>void <function>pdf_rotate</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>phi</parameter></paramdef> + <paramdef>float <parameter>phi</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2017,8 +2179,8 @@ <funcprototype> <funcdef>void <function>pdf_scale</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x-scale</parameter></paramdef> - <paramdef>double <parameter>y-scale</parameter></paramdef> + <paramdef>float <parameter>x-scale</parameter></paramdef> + <paramdef>float <parameter>y-scale</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2030,7 +2192,7 @@ <refentry id="function.pdf-setcolor"> <refnamediv> <refname>pdf_setcolor</refname> - <refpurpose>塗りつぶし色および輪郭色をCMYKで設定する</refpurpose> + <refpurpose>塗りつぶし色および輪郭色を設定する</refpurpose> </refnamediv> <refsect1> <title>説明</title> @@ -2040,20 +2202,20 @@ <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>type</parameter></paramdef> <paramdef>string <parameter>colorspace</parameter></paramdef> - <paramdef>double <parameter>c1</parameter></paramdef> - <paramdef>double + <paramdef>float <parameter>c1</parameter></paramdef> + <paramdef>float <parameter><optional>c2</optional></parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter><optional>c3</optional></parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter><optional>c4</optional></parameter> </paramdef> </funcprototype> </funcsynopsis> <para> - カレントのカラースペースと色を設定します。パラメータ + カレントの色空間と色を設定します。パラメータ <parameter>type</parameter>は、"fill", "stroke", "both" のどれか とすることができ、それぞれ、塗りつぶし、輪郭描画、輪郭描画および 塗りつぶしを表します。パラメータ @@ -2064,20 +2226,49 @@ <parameter>c1</parameter>, <parameter>c2</parameter>, <parameter>c3</parameter>, <parameter>c4</parameter>は、 <parameter>colorspace</parameter>で指定された色空間の色要素を表し - ます。<literal>gray</literal>の場合には、 - <parameter>c1</parameter>のみが使用されます。 + ます。例外として記述された場合以外、これらの色要素は0から1までの + float数です。 + </para> + <para> + <literal>gray</literal>の場合には、<parameter>c1</parameter>のみ + が使用されます。 + </para> + <para> <literal>rgb</literal>の場合、パラメータ <parameter>c1</parameter>, <parameter>c2</parameter>, <parameter>c3</parameter>によりそれぞれ赤、緑、青の値を指定しま - す。<literal>cmyk</literal> の場合、パラメータ + す。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +// 塗りつぶしおよび輪郭色を白に設定 +pdf_setcolor($pdf, "both", "rgb", 1, 1, 1); +]]> + </programlisting> + </informalexample> + </para> + <para> + <literal>cmyk</literal> の場合、パラメータ <parameter>c1</parameter>, <parameter>c2</parameter>, <parameter>c3</parameter>, <parameter>c4</parameter> によりそれぞ れシアン、マゼンダ、黄色、黒の値を指定します。 + <informalexample> + <programlisting role="php"> +<![CDATA[ +// 塗りつぶしおよび輪郭色を白に設定 +pdf_setcolor($pdf, "cmyk", "rgb", 0, 0, 0, 1); +]]> + </programlisting> + </informalexample> + </para> + <para> <literal>spot</literal>の場合、<parameter>c1</parameter> に <function>pdf_makespotcolor</function>により返されるスポット色ハ ンドルを指定し、<parameter>c2</parameter>には明度を0から1の範囲の - 値で指定します。<literal>pattern</literal>の場合、 - <parameter>c1</parameter> に + 値で指定します。 + </para> + <para> + <literal>pattern</literal>の場合、<parameter>c1</parameter> に <function>pdf_begin_pattern</function>により返されるパターンハン ドルを指定します。 </para> @@ -2095,8 +2286,8 @@ <funcprototype> <funcdef>void <function>pdf_setdash</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>b</parameter></paramdef> - <paramdef>double <parameter>w</parameter></paramdef> + <paramdef>float <parameter>b</parameter></paramdef> + <paramdef>float <parameter>w</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2117,7 +2308,7 @@ <funcprototype> <funcdef>void <function>pdf_setflat</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>flatness</parameter></paramdef> + <paramdef>float <parameter>flatness</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2138,7 +2329,7 @@ <funcdef>void <function>pdf_setfont</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>int <parameter>font</parameter></paramdef> - <paramdef>double <parameter>size</parameter></paramdef> + <paramdef>float <parameter>size</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2146,10 +2337,12 @@ <parameter>font</parameter>ハンドルを使用して指定したサイズでカレ ントのフォントを設定します。 </para> + <para> + <function>pdf_findfont</function>も参照下さい。 + </para> </refsect1> </refentry> - <refentry id="function.pdf-setgray"> <refnamediv> <refname>pdf_setgray</refname> @@ -2161,12 +2354,18 @@ <funcprototype> <funcdef>void <function>pdf_setgray</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>gray</parameter></paramdef> + <paramdef>float <parameter>gray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの塗りつぶしおよび輪郭描画色を設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2181,12 +2380,18 @@ <funcprototype> <funcdef>void <function>pdf_setgray_fill</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>gray</parameter></paramdef> + <paramdef>float <parameter>gray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの塗りつぶし色を0から1までのグレー値に設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2201,12 +2406,18 @@ <funcprototype> <funcdef>void <function>pdf_setgray_stroke</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>gray</parameter></paramdef> + <paramdef>float <parameter>gray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの輪郭描画色を0から1までのグレー値に設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2262,7 +2473,7 @@ <funcprototype> <funcdef>void <function>pdf_setlinewidth</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2271,6 +2482,31 @@ </refsect1> </refentry> + <refentry id="function.pdf-setmatrix"> + <refnamediv> + <refname>pdf_setmatrix</refname> + <refpurpose>カレントの変換行列を設定する</refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pdf_setmatrix</function></funcdef> + <paramdef>int <parameter>pdf object</parameter></paramdef> + <paramdef>float <parameter>a</parameter></paramdef> + <paramdef>float <parameter>b</parameter></paramdef> + <paramdef>float <parameter>c</parameter></paramdef> + <paramdef>float <parameter>d</parameter></paramdef> + <paramdef>float <parameter>e</parameter></paramdef> + <paramdef>float <parameter>f</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + カレントの変換行列を明示的に設定します。 + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-setmiterlimit"> <refnamediv> <refname>pdf_setmiterlimit</refname> @@ -2282,7 +2518,7 @@ <funcprototype> <funcdef>void <function>pdf_setmiterlimit</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>miter</parameter></paramdef> + <paramdef>float <parameter>miter</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2302,7 +2538,7 @@ <funcprototype> <funcdef>void <function>pdf_setpolydash</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double *<parameter>dasharray</parameter></paramdef> + <paramdef>float *<parameter>dasharray</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2322,14 +2558,20 @@ <funcprototype> <funcdef>void <function>pdf_setrgbcolor</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <paramdef>float <parameter>red value</parameter></paramdef> + <paramdef>float <parameter>green value</parameter></paramdef> + <paramdef>float <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの塗りつぶし色と輪郭色を指定したRGB値に設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2344,14 +2586,20 @@ <funcprototype> <funcdef>void <function>pdf_setrgbcolor_fill</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <paramdef>float <parameter>red value</parameter></paramdef> + <paramdef>float <parameter>green value</parameter></paramdef> + <paramdef>float <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの塗りつぶし色を指定したRGB値に設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2366,14 +2614,20 @@ <funcprototype> <funcdef>void <function>pdf_setrgbcolor_stroke</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>red value</parameter></paramdef> - <paramdef>double <parameter>green value</parameter></paramdef> - <paramdef>double <parameter>blue value</parameter></paramdef> + <paramdef>float <parameter>red value</parameter></paramdef> + <paramdef>float <parameter>green value</parameter></paramdef> + <paramdef>float <parameter>blue value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> カレントの輪郭色を指定したRGB値に設定します。 </para> + <note> + <para> + PDFlib V4.0: 古い関数です。代わりに + <function>pdf_setcolor</function>を使用して下さい。 + </para> + </note> </refsect1> </refentry> @@ -2388,9 +2642,9 @@ <funcprototype> <funcdef>void <function>pdf_set_border_color</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>red</parameter></paramdef> - <paramdef>double <parameter>green</parameter></paramdef> - <paramdef>double <parameter>blue</parameter></paramdef> + <paramdef>float <parameter>red</parameter></paramdef> + <paramdef>float <parameter>green</parameter></paramdef> + <paramdef>float <parameter>blue</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2410,8 +2664,8 @@ <funcprototype> <funcdef>void <function>pdf_set_border_dash</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>black</parameter></paramdef> - <paramdef>double <parameter>white</parameter></paramdef> + <paramdef>float <parameter>black</parameter></paramdef> + <paramdef>float <parameter>white</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2434,7 +2688,7 @@ <funcdef>void <function>pdf_set_border_style</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>style</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2505,7 +2759,7 @@ <funcprototype> <funcdef>void <function>pdf_set_horiz_scaling</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>scale</parameter></paramdef> + <paramdef>float <parameter>scale</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2540,6 +2794,121 @@ </refsect1> </refentry> + <refentry id='function.pdf-set-info-author'> + <refnamediv> + <refname>pdf_set_info_author</refname> + <refpurpose> + ドキュメントのauthorフィールドを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pdf_set_info_author</function></funcdef> + <paramdef>int <parameter>pdfdoc</parameter></paramdef> + <paramdef>string <parameter>author</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + この関数は古いため、替わりに<function>pdf_set_info</function>を使 + 用して下さい。 + </para> + </refsect1> + </refentry> + + <refentry id='function.pdf-set-info-creator'> + <refnamediv> + <refname>pdf_set_info_creator</refname> + <refpurpose> + ドキュメントのcreatorフィールドを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pdf_set_info_creator</function></funcdef> + <paramdef>int <parameter>pdfdoc</parameter></paramdef> + <paramdef>string <parameter>creator</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + この関数は古いため、替わりに<function>pdf_set_info</function>を使 + 用して下さい。 + </para> + </refsect1> + </refentry> + + <refentry id='function.pdf-set-info-keywords'> + <refnamediv> + <refname>pdf_set_info_keywords</refname> + <refpurpose> + ドキュメントのkeywordフィールドを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pdf_set_info_keywords</function></funcdef> + <paramdef>int <parameter>pdfdoc</parameter></paramdef> + <paramdef>string <parameter>keywords</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + この関数は古いため、替わりに<function>pdf_set_info</function>を使 + 用して下さい。 + </para> + </refsect1> + </refentry> + + <refentry id='function.pdf-set-info-subject'> + <refnamediv> + <refname>pdf_set_info_subject</refname> + <refpurpose> + ドキュメントのsubjectフィールドを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pdf_set_info_subject</function></funcdef> + <paramdef>int <parameter>pdfdoc</parameter></paramdef> + <paramdef>string <parameter>subject</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + この関数は古いため、替わりに<function>pdf_set_info</function>を使 + 用して下さい。 + </para> + </refsect1> + </refentry> + + <refentry id='function.pdf-set-info-title'> + <refnamediv> + <refname>pdf_set_info_title</refname> + <refpurpose> + ドキュメントのtitleフィールドを設定する + </refpurpose> + </refnamediv> + <refsect1> + <title>説明</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pdf_set_info_title</function></funcdef> + <paramdef>int <parameter>pdfdoc</parameter></paramdef> + <paramdef>string <parameter>title</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + この関数は古いため、替わりに<function>pdf_set_info</function>を使 + 用して下さい。 + </para> + </refsect1> + </refentry> + <refentry id="function.pdf-set-leading"> <refnamediv> <refname>pdf_set_leading</refname> @@ -2588,8 +2957,8 @@ <funcprototype> <funcdef>void <function>pdf_set_text_pos</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2655,7 +3024,7 @@ <funcdef>void <function>pdf_set_value</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>key</parameter></paramdef> - <paramdef>double <parameter>value</parameter></paramdef> + <paramdef>float <parameter>value</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2712,10 +3081,10 @@ <funcdef>int <function>pdf_show_boxed</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>text</parameter></paramdef> - <paramdef>double <parameter>left</parameter></paramdef> - <paramdef>double <parameter>top</parameter></paramdef> - <paramdef>double <parameter>width</parameter></paramdef> - <paramdef>double <parameter>height</parameter></paramdef> + <paramdef>float <parameter>left</parameter></paramdef> + <paramdef>float <parameter>top</parameter></paramdef> + <paramdef>float <parameter>width</parameter></paramdef> + <paramdef>float <parameter>height</parameter></paramdef> <paramdef>string <parameter>hmode</parameter></paramdef> <paramdef>string <parameter><optional>feature</optional></parameter> @@ -2744,8 +3113,8 @@ <funcdef>void <function>pdf_show_xy</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>text</parameter></paramdef> - <paramdef>double <parameter>x</parameter></paramdef> - <paramdef>double <parameter>y</parameter></paramdef> + <paramdef>float <parameter>x</parameter></paramdef> + <paramdef>float <parameter>y</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2765,8 +3134,8 @@ <funcprototype> <funcdef>void <function>pdf_skew</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>alpha</parameter></paramdef> - <paramdef>double <parameter>beta</parameter></paramdef> + <paramdef>float <parameter>alpha</parameter></paramdef> + <paramdef>float <parameter>beta</parameter></paramdef> </funcprototype> </funcsynopsis> <para> @@ -2784,13 +3153,13 @@ <title>説明</title> <funcsynopsis> <funcprototype> - <funcdef>double <function>pdf_stringwidth</function></funcdef> + <funcdef>float <function>pdf_stringwidth</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> <paramdef>string <parameter>text</parameter></paramdef> <paramdef>int <parameter><optional>font</optional></parameter> </paramdef> - <paramdef>double + <paramdef>float <parameter><optional>size</optional></parameter> </paramdef> </funcprototype> @@ -2847,54 +3216,12 @@ <funcprototype> <funcdef>void <function>pdf_translate</function></funcdef> <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>double <parameter>tx</parameter></paramdef> - <paramdef>double <parameter>ty</parameter></paramdef> + <paramdef>float <parameter>tx</parameter></paramdef> + <paramdef>float <parameter>ty</parameter></paramdef> </funcprototype> </funcsynopsis> <para> 座標系の原点を変更します。 - </para> - </refsect1> - </refentry> - - <refentry id="function.pdf-open-memory-image"> - <refnamediv> - <refname>pdf_open_memory_image</refname> - <refpurpose> - PHPのイメージ関数で作成されたイメージをオープンする - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>pdf_open_memory_image</function></funcdef> - <paramdef>int <parameter>pdf object</parameter></paramdef> - <paramdef>int <parameter>image</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - 関数<function>pdf_open_memory_image</function>は、PHPのイメージ関 - 数で作成されたイメージを入力とし、PDFオブジェクトで利用可能としま - す。関数は、PDFのイメージIDを返します。 - <example> - <title>メモリイメージの読み込み</title> - <programlisting role="php"> -&lt;?php -$im = ImageCreate(100, 100); -$col = ImageColorAllocate($im, 80, 45, 190); -ImageFill($im, 10, 10, $col); -$pim = pdf_open_memory_image($pdf, $im); -ImageDestroy($im); -pdf_place_image($pdf, $pim, 100, 100, 1); -pdf_close_image($pdf, $pim); -?> - </programlisting> - </example> - </para> - <para> - <function>pdf_close_image</function>, - <function>pdf_place_image</function>も参照下さい。 </para> </refsect1> </refentry>