hholzgra Mon Oct 21 16:57:19 2002 EDT
Added files:
/phpdoc/en/reference/fdf/functions fdf-add-doc-javascript.xml
fdf-errno.xml fdf-error.xml
fdf-get-ap.xml
fdf-get-attachment.xml
fdf-get-encoding.xml
fdf-get-version.xml
fdf-open-string.xml
fdf-save-string.xml
fdf-set-target-frame.xml
fdf-set-version.xml
fdf_header.xml
Modified files:
/phpdoc/en/reference/fdf constants.xml reference.xml
/phpdoc/en/reference/fdf/functions fdf-close.xml fdf-create.xml
fdf-get-file.xml
fdf-get-status.xml
fdf-get-value.xml
fdf-next-field-name.xml
fdf-open.xml fdf-save.xml
fdf-set-ap.xml
fdf-set-encoding.xml
fdf-set-file.xml
fdf-set-flags.xml
fdf-set-javascript-action.xml
fdf-set-opt.xml
fdf-set-status.xml
fdf-set-submit-form-action.xml
fdf-set-value.xml
Log:
new functions, getting up-to-date with current CVS, examples ...
Index: phpdoc/en/reference/fdf/constants.xml
diff -u phpdoc/en/reference/fdf/constants.xml:1.1
phpdoc/en/reference/fdf/constants.xml:1.2
--- phpdoc/en/reference/fdf/constants.xml:1.1 Mon May 6 03:16:32 2002
+++ phpdoc/en/reference/fdf/constants.xml Mon Oct 21 16:57:17 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
<section id="fdf.constants">
&reftitle.constants;
&extension.constants;
@@ -260,6 +260,39 @@
<varlistentry>
<term>
<constant>FDFCalculate</constant>
+ (<link linkend="language.types.integer">integer</link>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>FDFNormalAP</constant>
+ (<link linkend="language.types.integer">integer</link>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>FDFRolloverAP</constant>
+ (<link linkend="language.types.integer">integer</link>)
+ </term>
+ <listitem>
+ <simpara>
+
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <constant>FDFDownAP</constant>
(<link linkend="language.types.integer">integer</link>)
</term>
<listitem>
Index: phpdoc/en/reference/fdf/reference.xml
diff -u phpdoc/en/reference/fdf/reference.xml:1.4
phpdoc/en/reference/fdf/reference.xml:1.5
--- phpdoc/en/reference/fdf/reference.xml:1.4 Fri Aug 9 06:26:00 2002
+++ phpdoc/en/reference/fdf/reference.xml Mon Oct 21 16:57:17 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
<reference id="ref.fdf">
<title>Forms Data Format functions</title>
<titleabbrev>FDF</titleabbrev>
@@ -50,8 +50,11 @@
<section id="fdf.requirements">
&reftitle.required;
<para>
- You must download the FDF toolkit from
+ You need the FDF toolkit SDK available from
<ulink url="&spec.pdf.fdf;">&spec.pdf.fdf;</ulink>.
+ As of PHP 4.3 you need at least SDK version 5.0.
+ The FDF toolkit library is available in binary form only,
+ platforms supported by Adobe are Win32, Linux, Solaris and AIX.
</para>
</section>
@@ -64,10 +67,16 @@
<note>
<simpara>
If you run into problems configuring PHP with fdftk support, check
- whether the header file FdfTk.h and the library libFdfTk.so are at
- the right place. They should be in fdftk-dir/include and
- fdftk-dir/lib. This will not be the case if you just unpack
- the FdfTk distribution.
+ whether the header file <filename>fdftk.h</filename> and the library
+ <filename>libfdftk.so</filename> are at the right place.
+ The configure script supports both the directory structure of the
+ FDF SDK distribution and the usual <filename>DIR/include</filename> /
+ <filename>DIR/lib</filename> layout, so you can point it either
+ directly to the unpacked distribution directory or put the header
+ file and the appropriate library for your platform into e.g.
+ <filename>/usr/local/include</filename> and
+ <filename>/usr/local/lib</filename> and configure with
+ <literal>--with-fdftk=/usr/local</literal>.
</simpara>
</note>
</section>
@@ -79,8 +88,16 @@
<section id="fdf.resources">
&reftitle.resources;
- <para>
- </para>
+ <section id="fdf.resources.fdf">
+ <title>fdf</title>
+ <para>
+ Most fdf functions require a <parameter>fdf</parameter> resource
+ as their first parameter. A <parameter>fdf</parameter> resource
+ is a handle to an opened fdf file. <parameter>fdf</parameter>
+ resources may be obtained using <function>fdf_create</function>,
+ <function>fdf_open</function> and <function>fdf_open_string</function>.
+ </para>
+ </section>
</section>
&reference.fdf.constants;
@@ -94,16 +111,11 @@
<programlisting role="php">
<![CDATA[
<?php
-// Save the FDF data into a temp file
-$fdffp = fopen("test.fdf", "w");
-fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA));
-fclose($fdffp);
-
-// Open temp file and evaluate data
+// Open fdf from input string provided by the extension
// The pdf form contained several input text fields with the names
// volume, date, comment, publisher, preparer, and two checkboxes
// show_publisher and show_preparer.
-$fdf = fdf_open("test.fdf");
+$fdf = fdf_open_string($HTTP_FDF_DATA);
$volume = fdf_get_value($fdf, "volume");
echo "The volume field has the value '<B>$volume</B>'<BR>";
Index: phpdoc/en/reference/fdf/functions/fdf-close.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-close.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-close.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-close.xml:1.2 Wed Apr 17 02:37:55 2002
+++ phpdoc/en/reference/fdf/functions/fdf-close.xml Mon Oct 21 16:57:18 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
<refentry id="function.fdf-close">
<refnamediv>
@@ -10,7 +10,7 @@
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_close</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
+
+<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
</methodsynopsis>
<para>
The <function>fdf_close</function> function closes the FDF document.</para>
Index: phpdoc/en/reference/fdf/functions/fdf-create.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-create.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-create.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-create.xml:1.2 Wed Apr 17 02:37:56
2002
+++ phpdoc/en/reference/fdf/functions/fdf-create.xml Mon Oct 21 16:57:18 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
<refentry id="function.fdf-create">
<refnamediv>
@@ -9,7 +9,7 @@
<refsect1>
<title>Description</title>
<methodsynopsis>
- <type>int</type><methodname>fdf_create</methodname>
+ <type>resource</type><methodname>fdf_create</methodname>
<void/>
</methodsynopsis>
<para>
Index: phpdoc/en/reference/fdf/functions/fdf-get-file.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-get-file.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-get-file.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-get-file.xml:1.2 Wed Apr 17 02:37:56
2002
+++ phpdoc/en/reference/fdf/functions/fdf-get-file.xml Mon Oct 21 16:57:18 2002
@@ -1,26 +1,25 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-get-file">
- <refnamediv>
- <refname>fdf_get_file</refname>
- <refpurpose>Get the value of the /F key</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>string</type><methodname>fdf_get_file</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_file</function> returns the value
- of the /F key.</para>
-
- <para>
- See also <function>fdf_set_file</function>.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-get-file">
+ <refnamediv>
+ <refname>fdf_get_file</refname>
+ <refpurpose>Get the value of the /F key</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>fdf_get_file</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_file</function> returns the value
+ of the /F key.
+ </para>
+ <para>
+ See also <function>fdf_set_file</function>.</para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-get-status.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-get-status.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-get-status.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-get-status.xml:1.2 Wed Apr 17 02:37:56
2002
+++ phpdoc/en/reference/fdf/functions/fdf-get-status.xml Mon Oct 21 16:57:18
+2002
@@ -1,26 +1,26 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-get-status">
- <refnamediv>
- <refname>fdf_get_status</refname>
- <refpurpose>Get the value of the /STATUS key</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>string</type><methodname>fdf_get_status</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_get_status</function> returns the value
- of the /STATUS key.</para>
-
- <para>
- See also <function>fdf_set_status</function>.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-get-status">
+ <refnamediv>
+ <refname>fdf_get_status</refname>
+ <refpurpose>Get the value of the /STATUS key</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>fdf_get_status</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_get_status</function> returns the value
+ of the /STATUS key.
+ </para>
+ <para>
+ See also <function>fdf_set_status</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-get-value.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-get-value.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-get-value.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-get-value.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-get-value.xml Mon Oct 21 16:57:18 2002
@@ -1,27 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-get-value">
- <refnamediv>
- <refname>fdf_get_value</refname>
- <refpurpose>Get the value of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>string</type><methodname>fdf_get_value</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_get_value</function> function returns the
- value of a field.</para>
-
- <para>
- See also <function>fdf_set_value</function>.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-get-value">
+ <refnamediv>
+ <refname>fdf_get_value</refname>
+ <refpurpose>Get the value of a field</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>fdf_get_value</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
+ <methodparam
+choice='opt'><type>int</type><parameter>which</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_get_value</function> function returns the
+ value for the requested <parameter>fieldname</parameter>.
+ </para>
+ <para>
+ Elements of an array field can be retrieved by passing the optional
+ <parameter>which</parameter>, starting at zero. For non-array fields
+ the optional parameter <parameter>which</parameter> will be ignored.
+ </para>
+ <note>
+ <para>
+ Array support and optional <parameter>which</parameter> parameter
+ were added in PHP 4.3.
+ </para>
+ </note>
+ <para>
+ See also <function>fdf_set_value</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-next-field-name.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-next-field-name.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-next-field-name.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-next-field-name.xml:1.2 Wed Apr 17
02:37:57 2002
+++ phpdoc/en/reference/fdf/functions/fdf-next-field-name.xml Mon Oct 21 16:57:18
+2002
@@ -1,30 +1,47 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-next-field-name">
- <refnamediv>
- <refname>fdf_next_field_name</refname>
- <refpurpose>Get the next field name</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>string</type><methodname>fdf_next_field_name</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam
choice="opt"><type>string</type><parameter>fieldname</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_next_field_name</function> function returns the
- name of the field after the field in
- <parameter>fieldname</parameter> or the field name of the first field
- if the second parameter is &null;.</para>
-
- <para>
- See also <function>fdf_set_value</function>,
- <function>fdf_get_value</function>.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-next-field-name">
+ <refnamediv>
+ <refname>fdf_next_field_name</refname>
+ <refpurpose>Get the next field name</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>string</type><methodname>fdf_next_field_name</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam
+choice="opt"><type>string</type><parameter>fieldname</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_next_field_name</function> function returns the
+ name of the field after the field in
+ <parameter>fieldname</parameter> or the field name of the first field
+ if the second parameter is &null;.
+ </para>
+ <para>
+ <example>
+ <title>Detecting all fieldnames in a FDF</title>
+ <programlisting>
+<![CDATA[
+<?php
+ $fdf = fdf_open($HTTP_FDF_DATA);
+ for($field = fdf_next_field_name($fdf);
+ $field != "";
+ $field = fdf_next_field_name($fdf, $field)) {
+ echo "field: $field\n";
+ }
+?>
+]]>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ See also <function>fdf_enum_fields</function> and
+ <function>fdf_get_value</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-open.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-open.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-open.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-open.xml:1.2 Wed Apr 17 02:37:57 2002
+++ phpdoc/en/reference/fdf/functions/fdf-open.xml Mon Oct 21 16:57:18 2002
@@ -1,30 +1,34 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-open">
- <refnamediv>
- <refname>fdf_open</refname>
- <refpurpose>Open a FDF document</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>int</type><methodname>fdf_open</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_open</function> function opens
- a file with form data. This file must contain the data as returned
- from a PDF form. Currently, the file has to be created 'manually'
- by using <function>fopen</function> and writing the content
- of HTTP_FDF_DATA with <function>fwrite</function> into it.
- A mechanism like for HTML form data where for each input
- field a variable is created does not exist.</para>
-
- <para>
- <example>
- <title>Accessing the form data</title>
- <programlisting>
+<refentry id="function.fdf-open">
+ <refnamediv>
+ <refname>fdf_open</refname>
+ <refpurpose>Open a FDF document</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>resource</type><methodname>fdf_open</methodname>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_open</function> function opens
+ a file with form data. This file must contain the data as returned
+ from a PDF form or created using <function>fdf_create</function> and
+ <function>fdf_save</function>.
+ </para>
+ <para>
+ You can process the results of a PDF form POST request by writing
+ the data recieved in <varname>$HTTP_FDF_DATA</varname> to a file
+ and open it using <function>fdf_open</function>. Starting with PHP 4.3
+ you can also use <function>fdf_open_string</function> which handles temporary
+ file creation and cleanup for you.
+ </para>
+ <para>
+ <example>
+ <title>Accessing the form data</title>
+ <programlisting>
<![CDATA[
<?php
// Save the FDF data into a temp file
@@ -38,14 +42,18 @@
fdf_close($fdf);
?>
]]>
- </programlisting>
- </example></para>
-
- <para>
- See also <function>fdf_close</function>.</para>
-
- </refsect1>
- </refentry>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ See also
+ <function>fdf_open_string</function>,
+ <function>fdf_close</function>,
+ <function>fdf_create</function> and
+ <function>fdf_save</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-save.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-save.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-save.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-save.xml:1.2 Wed Apr 17 02:37:57 2002
+++ phpdoc/en/reference/fdf/functions/fdf-save.xml Mon Oct 21 16:57:18 2002
@@ -1,32 +1,33 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-save">
- <refnamediv>
- <refname>fdf_save</refname>
- <refpurpose>Save a FDF document</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>int</type><methodname>fdf_save</methodname>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_save</function> function saves
- a FDF document.
- The FDF Toolkit provides a way to output the document to stdout if
- the parameter <parameter>filename</parameter>
- is '.'. This does not work if PHP is used as an apache module.
- In such a case one will have to write to a file and use e.g.
- <function>fpassthru</function> to output it.</para>
-
- <para>
- See also <function>fdf_close</function> and example for
- <function>fdf_create</function>.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-save">
+ <refnamediv>
+ <refname>fdf_save</refname>
+ <refpurpose>Save a FDF document</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_save</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam
+choice='opt'><type>string</type><parameter>filename</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_save</function> function saves a FDF document.
+ The resulting FDF will be written to <parameter>filename</parameter>.
+ Without a <parameter>filename</parameter> <function>fdf_save</function>
+ will write the FDF to the default PHP output stream.
+ </para>
+
+ <para>
+ See also <function>fdf_save_string</function>,
+ <function>fdf_create</function> and
+ <function>fdf_close</function>.
+ </para>
+
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-ap.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-ap.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-ap.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-ap.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-ap.xml Mon Oct 21 16:57:18 2002
@@ -1,29 +1,30 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-set-ap">
- <refnamediv>
- <refname>fdf_set_ap</refname>
- <refpurpose>Set the appearance of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_ap</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>field_name</parameter></methodparam>
- <methodparam><type>int</type><parameter>face</parameter></methodparam>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- <methodparam><type>int</type><parameter>page_number</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_ap</function> function sets the
- appearance of a field (i.e. the value of the /AP key).
- The possible values of <parameter>face</parameter>
- are 1=FDFNormalAP, 2=FDFRolloverAP, 3=FDFDownAP.</para>
-
- </refsect1>
- </refentry>
+<refentry id="function.fdf-set-ap">
+ <refnamediv>
+ <refname>fdf_set_ap</refname>
+ <refpurpose>Set the appearance of a field</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_ap</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>field_name</parameter></methodparam>
+ <methodparam><type>int</type><parameter>face</parameter></methodparam>
+ <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+ <methodparam><type>int</type><parameter>page_number</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_ap</function> function sets the
+ appearance of a field (i.e. the value of the /AP key).
+ The possible values of <parameter>face</parameter>
+ are <constant>FDFNormalAP</constant>, <constant>FDFRolloverAP</constant>
+ and <constant>FDFDownAP</constant>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-encoding.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-encoding.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-encoding.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-encoding.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-encoding.xml Mon Oct 21 16:57:18
+2002
@@ -1,32 +1,30 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.24 -->
- <refentry id="function.fdf-set-encoding">
- <refnamediv>
- <refname>fdf_set_encoding</refname>
- <refpurpose>Sets FDF character encoding</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_encoding</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
+<refentry id="function.fdf-set-encoding">
+ <refnamediv>
+ <refname>fdf_set_encoding</refname>
+ <refpurpose>Sets FDF character encoding</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_encoding</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>encoding</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>fdf_set_encoding</function> sets the character
- encoding in FDF document <parameter>fdf_document</parameter>.
- <parameter>encoding</parameter> should be the valid encoding
- name. The valid encoding name in Acrobat 5.0 are
- "<literal>Shift-JIS</literal>", "<literal>UHC</literal>",
- "<literal>GBK</literal>","<literal>BigFive</literal>".
- </para>
- <para>
- The <function>fdf_set_encoding</function> is available in
- PHP 4.1.0 or later.
- </para>
- </refsect1>
- </refentry>
+ </methodsynopsis>
+ <para>
+ <function>fdf_set_encoding</function> sets the character
+ encoding in FDF document <parameter>fdf_document</parameter>.
+ <parameter>encoding</parameter> should be the valid encoding
+ name. Currently the following values are supported:
+ "<literal>Shift-JIS</literal>", "<literal>UHC</literal>",
+ "<literal>GBK</literal>","<literal>BigFive</literal>".
+ An empty string resets the encoding to the default PDFDocEncoding/Unicode
+ scheme.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-file.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-file.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-file.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-file.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-file.xml Mon Oct 21 16:57:18 2002
@@ -1,30 +1,62 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-set-file">
- <refnamediv>
- <refname>fdf_set_file</refname>
- <refpurpose>Set the value of the /F key</refpurpose>
+<refentry id="function.fdf-set-file">
+ <refnamediv>
+ <refname>fdf_set_file</refname>
+ <refpurpose>Set PDF document to display FDF data in</refpurpose>
</refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_file</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>filename</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_file</function> sets the value
- of the /F key. The /F key is just a reference to a PDF form
- which is to be populated with data.
- In a web environment it is a URL (e.g. http:/testfdf/resultlabel.pdf).</para>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_file</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>url</parameter></methodparam>
+ <methodparam
+choice='opt'><type>string</type><parameter>target_frame</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_file</function> selects a different PDF
+ document to display the form results in then the form it originated
+ from. The <parameter>url</parameter> needs to be given as an
+ absolute URL.
+ </para>
+ <para>
+ The frame to display the document in may be selected using the optional
+ parameter <parameter>target_frame</parameter> or the function
+ <function>fdf_set_target_frame</function>.
+ </para>
+ <example>
+ <title>Passing FDF data to a second form</title>
+ <programlisting>
+<![CDATA[
+<?php
+ /* set content type for Adobe FDF */
+ fdf_header();
- <para>
- See also <function>fdf_get_file</function> and example for
- <function>fdf_create</function>.</para>
+ /* start new fdf */
+ $fdf = fdf_create();
+
+ /* set field "foo" to value "bar" */
+ $fdf_set_value($fdf, "foo", "bar");
- </refsect1>
- </refentry>
+ /* tell client to display FDF data using "fdf_form.pdf" */
+ fdf_set_file($fdf, "http://www.example.com/fdf_form.pdf";);
+
+ /* output fdf */
+ fdf_save();
+
+ /* clean up */
+ fdf_close();
+?>
+]]>
+ </programlisting>
+ </example>
+ <para>
+ See also <function>fdf_get_file</function> and
+ <function>fdf_set_target_frame</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-flags.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-flags.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-flags.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-flags.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-flags.xml Mon Oct 21 16:57:18 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.6 -->
<refentry id="function.fdf-set-flags">
<refnamediv>
@@ -10,7 +10,7 @@
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_set_flags</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
+
+<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
<methodparam><type>int</type><parameter>whichFlags</parameter></methodparam>
<methodparam><type>int</type><parameter>newFlags</parameter></methodparam>
Index: phpdoc/en/reference/fdf/functions/fdf-set-javascript-action.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-javascript-action.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-javascript-action.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-javascript-action.xml:1.2 Wed Apr 17
02:37:57 2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-javascript-action.xml Mon Oct 21
+16:57:18 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.6 -->
<refentry id="function.fdf-set-javascript-action">
<refnamediv>
@@ -10,7 +10,7 @@
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_set_javascript_action</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
+
+<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
<methodparam><type>int</type><parameter>trigger</parameter></methodparam>
<methodparam><type>string</type><parameter>script</parameter></methodparam>
Index: phpdoc/en/reference/fdf/functions/fdf-set-opt.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-opt.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-opt.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-opt.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-opt.xml Mon Oct 21 16:57:18 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.6 -->
<refentry id="function.fdf-set-opt">
<refnamediv>
@@ -10,7 +10,7 @@
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_set_opt</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
+
+<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
<methodparam><type>int</type><parameter>element</parameter></methodparam>
<methodparam><type>string</type><parameter>str1</parameter></methodparam>
Index: phpdoc/en/reference/fdf/functions/fdf-set-status.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-status.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-status.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-status.xml:1.2 Wed Apr 17 02:37:57
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-status.xml Mon Oct 21 16:57:18
+2002
@@ -1,27 +1,28 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-set-status">
- <refnamediv>
- <refname>fdf_set_status</refname>
+<refentry id="function.fdf-set-status">
+ <refnamediv>
+ <refname>fdf_set_status</refname>
<refpurpose>Set the value of the /STATUS key</refpurpose>
- </refnamediv>
+ </refnamediv>
<refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_status</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>status</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_status</function> sets the value
- of the /STATUS key.</para>
-
- <para>
- See also <function>fdf_get_status</function>.</para>
-
- </refsect1>
- </refentry>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_status</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>status</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_status</function> sets the value
+ of the /STATUS key. When a client recieves a FDF with a status set
+ it will present the value in an alert box.
+ </para>
+ <para>
+ See also <function>fdf_get_status</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-submit-form-action.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-submit-form-action.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-submit-form-action.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-submit-form-action.xml:1.2 Wed
Apr 17 02:37:58 2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-submit-form-action.xml Mon Oct 21
+16:57:18 2002
@@ -1,30 +1,30 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.6 -->
- <refentry id="function.fdf-set-submit-form-action">
- <refnamediv>
- <refname>fdf_set_submit_form_action</refname>
- <refpurpose>Sets a submit form action of a field</refpurpose>
- </refnamediv>
+<refentry id="function.fdf-set-submit-form-action">
+ <refnamediv>
+ <refname>fdf_set_submit_form_action</refname>
+ <refpurpose>Sets a submit form action of a field</refpurpose>
+ </refnamediv>
<refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_submit_form_action</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
- <methodparam><type>int</type><parameter>trigger</parameter></methodparam>
- <methodparam><type>string</type><parameter>script</parameter></methodparam>
- <methodparam><type>int</type><parameter>flags</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_submit_form_action</function> sets a submit form
- action for the given field <parameter>fieldname</parameter>.
- </para>
- <para>
- See also <function>fdf_set_javascript_action</function>.
- </para>
- </refsect1>
- </refentry>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_submit_form_action</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
+ <methodparam><type>int</type><parameter>trigger</parameter></methodparam>
+ <methodparam><type>string</type><parameter>script</parameter></methodparam>
+ <methodparam><type>int</type><parameter>flags</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_submit_form_action</function> sets a submit form
+ action for the given field <parameter>fieldname</parameter>.
+ </para>
+ <para>
+ See also <function>fdf_set_javascript_action</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-set-value.xml
diff -u phpdoc/en/reference/fdf/functions/fdf-set-value.xml:1.2
phpdoc/en/reference/fdf/functions/fdf-set-value.xml:1.3
--- phpdoc/en/reference/fdf/functions/fdf-set-value.xml:1.2 Wed Apr 17 02:37:58
2002
+++ phpdoc/en/reference/fdf/functions/fdf-set-value.xml Mon Oct 21 16:57:18 2002
@@ -1,31 +1,43 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
-<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
- <refentry id="function.fdf-set-value">
- <refnamediv>
- <refname>fdf_set_value</refname>
- <refpurpose>Set the value of a field</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <methodsynopsis>
- <type>bool</type><methodname>fdf_set_value</methodname>
- <methodparam><type>int</type><parameter>fdf_document</parameter></methodparam>
- <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
- <methodparam><type>string</type><parameter>value</parameter></methodparam>
- <methodparam><type>int</type><parameter>isName</parameter></methodparam>
- </methodsynopsis>
- <para>
- The <function>fdf_set_value</function> function sets the
- value of a field. The last parameter determines if the field value
- is to be converted to a PDF Name (<parameter>isName</parameter> = 1)
- or set to a PDF String (<parameter>isName</parameter> = 0).</para>
-
- <para>
- See also <function>fdf_get_value</function>.</para>
-
- </refsect1>
- </refentry>
+<!-- $Revision: 1.3 $ -->
+<refentry id="function.fdf-set-value">
+ <refnamediv>
+ <refname>fdf_set_value</refname>
+ <refpurpose>Set the value of a field</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <methodsynopsis>
+ <type>bool</type><methodname>fdf_set_value</methodname>
+ <methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
+ <methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
+ <methodparam><type>mixed</type><parameter>value</parameter></methodparam>
+ <methodparam
+choice='opt'><type>int</type><parameter>isName</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ The <function>fdf_set_value</function> function sets the
+ <parameter>value</parameter> for a field named <parameter>fieldname</parameter>.
+ The <parameter>value</parameter> will be stored as a string unless it is an array.
+ In this case all array elements will be stored as a value array.
+ </para>
+ <note>
+ <para>
+ In older versions of the fdf toolkit last parameter determined if the field value
+ was to be converted to a PDF Name (<parameter>isName</parameter> = 1)
+ or set to a PDF String (<parameter>isName</parameter> = 0). The value is no
+ longer used in the current toolkit version 5.0. For compatibility reasons it is
+ still supported as an optional parameter beginning with PHP 4.3, but ignored
+internaly.
+ </para>
+ <para>
+ Support for <parameter>value</parameter> arrays was added in PHP 4.3.
+ </para>
+ </note>
+ <para>
+ See also <function>fdf_get_value</function> and
+ <function>fdf_remove_item</function>.
+ </para>
+ </refsect1>
+</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Index: phpdoc/en/reference/fdf/functions/fdf-add-doc-javascript.xml
+++ phpdoc/en/reference/fdf/functions/fdf-add-doc-javascript.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.12 -->
<refentry id='function.fdf-add-doc_javascript'>
<refnamediv>
<refname>fdf_add_doc_javascript</refname>
<refpurpose>Adds javascript code to the FDF document</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_add_doc_javascript</methodname>
<methodparam><type>resource</type><parameter>fdfdoc</parameter></methodparam>
<methodparam><type>string</type><parameter>script_name</parameter></methodparam>
<methodparam><type>string</type><parameter>script_code</parameter></methodparam>
</methodsynopsis>
<para>
Adds a script to the FDF, which Acrobat then adds to the doc-level
scripts of a document, once the FDF is imported into it. It is strongly
suggested to use '\r' for linebreaks within <parameter>script_code</parameter>.
</para>
<para>
<example>
<title>Adding JavaScript code to a FDF</title>
<programlisting>
<![CDATA[
<?php
$fdf = fdf_create();
fdf_add_doc_javascript($fdf, "PlusOne", "function PlusOne(x)\r{\r return x+1;\r}\r");
fdf_save($fdf);
?>
]]>
</programlisting>
<simpara>will create a FDF like this:</simpara>
<screen>
<![CDATA[
%FDF-1.2
%âãÏÓ
1 0 obj
<<
/FDF << /JavaScript << /Doc [ (PlusOne)(function PlusOne\(x\)\r{\r return x+1;\r}\r)]
>> >>
>>
endobj
trailer
<<
/Root 1 0 R
>>
%%EOF
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-errno.xml
+++ phpdoc/en/reference/fdf/functions/fdf-errno.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-errno">
<refnamediv>
<refname>fdf_errno</refname>
<refpurpose>Return error code for last fdf operation</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>fdf_errno</methodname>
<void/>
</methodsynopsis>
<para>
<function>fdf_errno</function> returns the error code set by
the last <function>fdf_...</function> function call. This is zero
for a successfull operation or a non-zero error code on failure.
A textual description may be obtained using the
<function>fdf_error</function> function.
</para>
<para>
See also <function>fdf_error</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-error.xml
+++ phpdoc/en/reference/fdf/functions/fdf-error.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-error">
<refnamediv>
<refname>fdf_error</refname>
<refpurpose>Return error description for fdf error code</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>fdf_error</methodname>
<methodparam
choice='opt'><type>int</type><parameter>error_code</parameter></methodparam>
</methodsynopsis>
<para>
<function>fdf_error</function> returns a textual description for
the fdf error code given in <parameter>error_code</parameter>.
The function uses the internal error code set by the last operation
if no <parameter>error_code</parameter> is given, so
<literal>fdf_error()</literal> is a convenient shortcut for
<literal>fdf_error(fdf_errno())</literal>.
</para>
<para>
See also <function>fdf_errno</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-get-ap.xml
+++ phpdoc/en/reference/fdf/functions/fdf-get-ap.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/fdf.xml, last change in rev 1.2 -->
<refentry id="function.fdf-get-ap">
<refnamediv>
<refname>fdf_get_ap</refname>
<refpurpose>Get the appearance of a field</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_get_ap</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>field</parameter></methodparam>
<methodparam><type>int</type><parameter>face</parameter></methodparam>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
The <function>fdf_get_ap</function> function gets the
appearance of a <parameter>field</parameter> (i.e. the value of the /AP key) and
stores it in a file. The possible values of <parameter>face</parameter>
are <constant>FDFNormalAP</constant>, <constant>FDFRolloverAP</constant> and
<constant>FDFDownAP</constant>. The appearance is stored in
<parameter>filename</parameter>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-get-attachment.xml
+++ phpdoc/en/reference/fdf/functions/fdf-get-attachment.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-get-attachment">
<refnamediv>
<refname>fdf_get_attachment</refname>
<refpurpose>Extracts uploaded file embedded in the FDF</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>array</type><methodname>fdf_get_attachment</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>fieldname</parameter></methodparam>
<methodparam><type>string</type><parameter>savepath</parameter></methodparam>
</methodsynopsis>
<para>
Extracts a file uploaded by means of the "file selection" field
<parameter>fieldname</parameter> and stores it under
<parameter>savepath</parameter>. <parameter>savepath</parameter> may be
the name of a plain file or an existing directory in which the file is to be created
under its original name. Any existing file under the same name will be overwritten.
</para>
<note>
<para>
There seems to be no other way to find out the original filename but to store
the file using a directory as <parameter>savepath</parameter> and check
for the basename it was stored under.
</para>
</note>
<para>
The returned array contains the following fields:
<itemizedlist>
<listitem>
<simpara><parameter>path</parameter> - path were the file got stored</simpara>
<simpara><parameter>size</parameter> - size of the stored file in bytes</simpara>
<simpara><parameter>type</parameter> - mimetype if given in the FDF</simpara>
</listitem>
</itemizedlist>
</para>
<para>
<example>
<title>Storing an uploaded file</title>
<programlisting>
<![CDATA[
<?php
$fdf = fdf_open_string($HTTP_FDF_DATA);
$data = fdf_get_attachment($fdf, "filename", "/tmpdir");
echo "The uploaded file is stored in $data[path]";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-get-encoding.xml
+++ phpdoc/en/reference/fdf/functions/fdf-get-encoding.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-get-encoding">
<refnamediv>
<refname>fdf_get_encoding</refname>
<refpurpose>Get the value of the /Encoding key</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>fdf_get_encoding</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
</methodsynopsis>
<para>
The <function>fdf_get_encoding</function> returns the value
of the /Encoding key. An empty string is returned if the default
PDFDocEncoding/Unicode scheme is used.
</para>
<para>
See also <function>fdf_set_encoding</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-get-version.xml
+++ phpdoc/en/reference/fdf/functions/fdf-get-version.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-get-version">
<refnamediv>
<refname>fdf_get_version</refname>
<refpurpose>Gets version number for FDF api or file </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>fdf_get_version</methodname>
<methodparam
choice='opt'><type>resource</type><parameter>fdf_document</parameter></methodparam>
</methodsynopsis>
<para>
This function will return the fdf version for the given
<parameter>fdf_document</parameter>, or the toolkit api
version number if no parameter is given.
</para>
<para>
For the current FDF toolkit 5.0 the api version number is '5.0'
and the document version number is either '1.2', '1.3' or '1.4'.
</para>
<para>
See also <function>fdf_set_version</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-open-string.xml
+++ phpdoc/en/reference/fdf/functions/fdf-open-string.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-open-string">
<refnamediv>
<refname>fdf_open_string</refname>
<refpurpose>Read a FDF document from a string</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>resource</type><methodname>fdf_open</methodname>
<methodparam><type>string</type><parameter>fdf_data</parameter></methodparam>
</methodsynopsis>
<para>
The <function>fdf_open_string</function> function reads form data
from a string. <parameter>fdf_data</parameter> must contain the data
as returned from a PDF form or created using <function>fdf_create</function>
and <function>fdf_save_string</function>.
</para>
<para>
You can <function>fdf_open_string</function> together with
<varname>$HTTP_FDF_DATA</varname> to process fdf form input
from a remote client.
</para>
<para>
<example>
<title>Accessing the form data</title>
<programlisting>
<![CDATA[
<?php
$fdf = fdf_open_string($HTTP_FDF_DATA);
..
fdf_close($fdf);
?>
]]>
</programlisting>
</example>
</para>
<para>
See also
<function>fdf_open</function>,
<function>fdf_close</function>,
<function>fdf_create</function> and
<function>fdf_save_string</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-save-string.xml
+++ phpdoc/en/reference/fdf/functions/fdf-save-string.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-save-string">
<refnamediv>
<refname>fdf_save_string</refname>
<refpurpose>Returns the FDF document as a string</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>fdf_save_string</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
</methodsynopsis>
<para>
The <function>fdf_save_string</function> function returns the FDF document as a
string.
</para>
<para>
<example>
<title>Retrieving FDF as a string</title>
<programlisting>
<![CDATA[
<?php
$fdf = fdf_create();
fdf_set_value($fdf, "foo", "bar");
$str = fdf_save_string($fdf);
fdf_close($fdf);
echo $str;
?>
]]>
</programlisting>
<para>
will output something like
</para>
<screen>
<![CDATA[
%FDF-1.2
%âãÏÓ
1 0 obj
<<
/FDF << /Fields 2 0 R >>
>>
endobj
2 0 obj
[
<< /T (foo)/V (bar)>>
]
endobj
trailer
<<
/Root 1 0 R
>>
%%EOF
]]>
</screen>
</example>
</para>
<para>
See also <function>fdf_save</function>,
<function>fdf_open_string</function>,
<function>fdf_create</function> and
<function>fdf_close</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-set-target-frame.xml
+++ phpdoc/en/reference/fdf/functions/fdf-set-target-frame.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-set-target-frame">
<refnamediv>
<refname>fdf_set_target_frame</refname>
<refpurpose>Set target frame for form display</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_target_frame</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>frame_name</parameter></methodparam>
</methodsynopsis>
<para>
Sets the target frame to display a result PDF defined with
<function>fdf_save_file</function> in.
</para>
<para>
See also <function>fdf_save_file</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf-set-version.xml
+++ phpdoc/en/reference/fdf/functions/fdf-set-version.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-set-version">
<refnamediv>
<refname>fdf_set_version</refname>
<refpurpose>Sets version number for a FDF file </refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>fdf_set_version</methodname>
<methodparam><type>resource</type><parameter>fdf_document</parameter></methodparam>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
</methodsynopsis>
<para>
This function will set the fdf <parameter>version</parameter>
for the given <parameter>fdf_document</parameter>. Some features
supported by this extension are only available in newer fdf versions.
For the current FDF toolkit 5.0 <parameter>version</parameter>
may be either '1.2', '1.3' or '1.4'.
</para>
<para>
See also <function>fdf_get_version</function>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
Index: phpdoc/en/reference/fdf/functions/fdf_header.xml
+++ phpdoc/en/reference/fdf/functions/fdf_header.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry id="function.fdf-header">
<refnamediv>
<refname>fdf_header</refname>
<refpurpose>Sets FDF-specific output headers</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>bool</type><methodname>fdf_header</methodname>
<void/>
</methodsynopsis>
<para>
This is a convenience function to set appropriate HTTP headers
for FDF output. It sets the <literal>Content-type:</literal>
to <literal>application/vnd.fdf</literal>.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
