Typo fixes and some matrix docs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@289059 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Elizabeth Marie Smith 2009-10-01 17:42:16 +00:00
parent 9db5ec288e
commit b332926608
6 changed files with 88 additions and 88 deletions

View file

@ -5,7 +5,7 @@
<refnamediv>
<refname>Cairo::availableFonts</refname>
<refname>cairo_available_fonts</refname>
<refpurpose>Retrives the availables fonts types</refpurpose>
<refpurpose>Retrives the availables font types</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -21,7 +21,7 @@
<void />
</methodsynopsis>
<para>
Returns an array with the available fonts backends
Returns an array with the available font backends
</para>
</refsect1>
@ -34,7 +34,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
A list-type array with all available fonts backends.
A list-type array with all available font backends.
</para>
</refsect1>

View file

@ -21,7 +21,7 @@
<void />
</methodsynopsis>
<para>
Returns an array with the available surfaces backends
Returns an array with the available surface backends
</para>
</refsect1>
@ -34,7 +34,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
A list-type array with all available surfaces backends.
A list-type array with all available surface backends.
</para>
</refsect1>

View file

@ -21,7 +21,7 @@
<void />
</methodsynopsis>
<para>
Retrieves the current version of the cairo library
Retrieves the current version of the cairo library as an integer value
</para>
</refsect1>
@ -34,7 +34,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the version of the current cairo library
Current Cairo library version integer
</para>
</refsect1>

View file

@ -21,7 +21,7 @@
<void />
</methodsynopsis>
<para>
Retrieves the current cairo library version as string.
Retrieves the current cairo library version as a string.
</para>
</refsect1>
@ -34,7 +34,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a string represented version
Current Cairo library version string
</para>
</refsect1>

View file

@ -3,37 +3,58 @@
<refentry xml:id="cairomatrix.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>CairoMatrix::__construct</refname>
<refpurpose>The __construct purpose</refpurpose>
<refname>CairoPattern::__construct</refname>
<refname>cairo_matrix_init</refname>
<refpurpose>Creates a new CairoMatrix object</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<para>Object oriented style (method):</para>
<methodsynopsis>
<methodname>CairoMatrix::__construct</methodname>
<methodparam choice="opt"><type>string</type><parameter>yx</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>xy</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>yy</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>x0</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>y0</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>xx</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>yx</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>xy</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>yy</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>x0</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>y0</parameter></methodparam>
</methodsynopsis>
<para>Procedural style:</para>
<methodsynopsis>
<type>ReturnType</type><methodname>cairo_matrix_init</methodname>
<methodparam choice="opt"><type>float</type><parameter>xx</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>yx</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>xy</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>yy</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>x0</parameter></methodparam>
<methodparam choice="opt"><type>float</type><parameter>y0</parameter></methodparam>
</methodsynopsis>
<para>
The method description goes here.
Returns new CairoMatrix object. Matrices are used throughout cairo to convert between different coordinate spaces.
Sets matrix to be the affine transformation given by xx, yx, xy, yy, x0, y0. The transformation is given by:
x_new = xx * x + xy * y + x0; and y_new = yx * x + yy * y + y0;
</para>
&warn.undocumented.func;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>xx</parameter></term>
<listitem>
<para>
xx component of the affine transformation
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>yx</parameter></term>
<listitem>
<para>
Description...
yx component of the affine transformation
</para>
</listitem>
</varlistentry>
@ -41,7 +62,7 @@
<term><parameter>xy</parameter></term>
<listitem>
<para>
Description...
xy component of the affine transformation
</para>
</listitem>
</varlistentry>
@ -49,7 +70,7 @@
<term><parameter>yy</parameter></term>
<listitem>
<para>
Description...
yy component of the affine transformation
</para>
</listitem>
</varlistentry>
@ -57,7 +78,7 @@
<term><parameter>x0</parameter></term>
<listitem>
<para>
Description...
X translation component of the affine transformation
</para>
</listitem>
</varlistentry>
@ -65,7 +86,7 @@
<term><parameter>y0</parameter></term>
<listitem>
<para>
Description...
Y translation component of the affine transformation
</para>
</listitem>
</varlistentry>
@ -76,37 +97,49 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Description...
Returns a new CairoMatrix object that can be used with surfaces, contexts, and patterns.
</para>
</refsect1>
<refsect1 role="examples">
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><methodname>CairoMatrix::__construct</methodname> example</title>
<title>Object oriented style</title>
<programlisting role="php">
<![CDATA[
<?php
/* ... */
/* Create a new Matrix */
$matrix = new CairoMatrix(1.0, 0.5, 0.0, 1.0, 0.0, 0.0);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
</programlisting>
</example>
</para>
<para>
<example>
<title>Procedural style</title>
<programlisting role="php">
<![CDATA[
...
<?php
/* Create a new Matrix */
$matrix = cairo_matrix_init(1.0, 0.5, 0.0, 1.0, 0.0, 0.0);
?>
]]>
</screen>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>Classname::Method</methodname></member>
<member><methodname>CairoMatrix::initIdentity</methodname></member>
<member><methodname>CairoMatrix::initRotate</methodname></member>
<member><methodname>CairoMatrix::initScale</methodname></member>
<member><methodname>CairoMatrix::initTranslate</methodname></member>
</simplelist>
</para>
</refsect1>

View file

@ -4,8 +4,8 @@
<refentry xml:id="cairomatrix.scale" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>CairoMatrix::scale</refname>
<refname>cairo_scale</refname>
<refpurpose>The scale purpose</refpurpose>
<refname>cairo_matrix_scale</refname>
<refpurpose>Applies scaling to a matrix</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -13,21 +13,21 @@
<para>Object oriented style (method):</para>
<methodsynopsis>
<modifier>public</modifier> <type>void</type><methodname>CairoMatrix::scale</methodname>
<methodparam><type>string</type><parameter>sx</parameter></methodparam>
<methodparam><type>string</type><parameter>sy</parameter></methodparam>
<methodparam><type>float</type><parameter>sx</parameter></methodparam>
<methodparam><type>float</type><parameter>sy</parameter></methodparam>
</methodsynopsis>
<para>Procedural style:</para>
<methodsynopsis>
<type>ReturnType</type><methodname>cairo_scale</methodname>
<type>ReturnType</type><methodname>cairo_matrix_scale</methodname>
<methodparam><type>CairoContext</type><parameter>context</parameter></methodparam>
<methodparam><type>string</type><parameter>x</parameter></methodparam>
<methodparam><type>string</type><parameter>y</parameter></methodparam>
<methodparam><type>float</type><parameter>sx</parameter></methodparam>
<methodparam><type>float</type><parameter>sy</parameter></methodparam>
</methodsynopsis>
<para>
Description here.
Applies scaling by sx, sy to the transformation in the matrix. The effect of
the new transformation is to first scale the coordinates by sx and sy, then
apply the original transformation to the coordinates.
</para>
&warn.undocumented.func;
</refsect1>
@ -36,26 +36,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter>context</parameter></term>
<term><parameter>matrix</parameter></term>
<listitem>
<para>
Description...
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>x</parameter></term>
<listitem>
<para>
Description...
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>y</parameter></term>
<listitem>
<para>
Description...
Procedural only - CairoMatrix instance
</para>
</listitem>
</varlistentry>
@ -63,7 +47,7 @@
<term><parameter>sx</parameter></term>
<listitem>
<para>
Description...
scale factor in the X direction
</para>
</listitem>
</varlistentry>
@ -71,7 +55,7 @@
<term><parameter>sy</parameter></term>
<listitem>
<para>
Description...
scale factor in the Y direction
</para>
</listitem>
</varlistentry>
@ -79,13 +63,6 @@
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Description...
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
@ -94,17 +71,12 @@
<programlisting role="php">
<![CDATA[
<?php
/* ... */
/* Apply scaling to a matrix */
$matrix = new CairoMatrix(1.0, 0.5, 0.0, 1.0, 0.0, 0.0);
$matrix->scale(0.2, 2.0);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
...
]]>
</screen>
</example>
</para>
<para>
<example>
@ -112,17 +84,12 @@
<programlisting role="php">
<![CDATA[
<?php
/* ... */
/* Apply scaling to a matrix */
$matrix = cairo_matrix_init(1.0, 0.5, 0.0, 1.0, 0.0, 0.0);
cairo_matrix_scale($matrix, 0.2, 2.0);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
...
]]>
</screen>
</example>
</para>
</refsect1>
@ -130,7 +97,7 @@
&reftitle.seealso;
<para>
<simplelist>
<member><methodname>Classname::Method</methodname></member>
<member><methodname>CairoMatrix::initScale</methodname></member>
</simplelist>
</para>
</refsect1>