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">
-
-<?php
+<![CDATA[
+<?php
//
このページでのみ出力の文字エンコーディング変換を有効にする
@@ -227,7 +231,8 @@
// を指定する
ob_start('mb_output_handler');
-?>
+?>
+]]>
</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") . " <" . $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">
-<?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 "<A HREF=getpdf.php>完了しました</A>";
+echo "<A HREF=getpdf.php>完了しました</A>";
?>
+]]>
</programlisting>
<simpara>
以下のスクリプト<filename>getpdf.php</filename>は、PDFドキュメ
ントを返すだけのものです。
</simpara>
<informalexample>
- <programlisting role="php">
-<?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);
-?>
+?>
+]]>
</programlisting>
</informalexample>
</example>
@@ -354,8 +358,9 @@
<para>
<example>
<title>PDFlib配布ファイル中の pdfclockの例</title>
- <programlisting role="php">
-<?php
+ <programlisting>
+<![CDATA[
+<?php
$radius = 200;
$margin = 20;
$pagecount = 10;
@@ -385,7 +390,7 @@
/* 1分刻みの目盛 */
pdf_setlinewidth($pdf, 2.0);
- for ($alpha = 0; $alpha < 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 < 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);
-?>
+?>
+]]>
</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✗3368</entry>
+ </row>
+ <row>
+ <entry>A1</entry>
+ <entry>1684✗2380</entry>
+ </row>
+ <row>
+ <entry>A2</entry>
+ <entry>1190✗1684</entry>
+ </row>
+ <row>
+ <entry>A3</entry>
+ <entry>842✗1190</entry>
+ </row>
+ <row>
+ <entry>A4</entry>
+ <entry>595✗842</entry>
+ </row>
+ <row>
+ <entry>A5</entry>
+ <entry>421✗595</entry>
+ </row>
+ <row>
+ <entry>A6</entry>
+ <entry>297✗421</entry>
+ </row>
+ <row>
+ <entry>B5</entry>
+ <entry>501✗709</entry>
+ </row>
+ <row>
+ <entry>letter (8.5"✗11")</entry>
+ <entry>612✗792</entry>
+ </row>
+ <row>
+ <entry>legal (8.5"✗14")</entry>
+ <entry>612✗1008</entry>
+ </row>
+ <row>
+ <entry>ledger (17"✗11")</entry>
+ <entry>1224✗792</entry>
+ </row>
+ <row>
+ <entry>11"✗17"</entry>
+ <entry>792✗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">
-<php
+<![CDATA[
+<?php
$font = pdf_findfont($pdf, "Times New Roman", "winansi", 1);
if ($font) {
pdf_setfont($pdf, $font, 10);
}
-?>
+?>
+]]>
</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">
-<?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">
-<?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>
