cvs: phpdoc /en/reference/image/functions imagettftext.xml

aidan Fri Dec 17 22:49:03 2004 EDT Modified files: /phpdoc/en/reference/image/functions imagettftext.xml Log: Refined a couple of comments http://cvs.php.net/diff.php/phpdoc/en/reference/image/functions/imagettftext.xml?r1=1.14&r2=1.15&ty=u Index: phpdoc/en/reference/image/functions/imagettftext.xml diff -u phpdoc/en/reference/image/functions/imagettftext.xml:1.14 phpdoc/en/reference/image/functions/imagettftext.xml:1.15 --- phpdoc/en/reference/image/functions/imagettftext.xml:1.14 Tue Nov 16 04:33:43 2004 +++ phpdoc/en/reference/image/functions/imagettftext.xml Fri Dec 17 22:49:03 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Revision: 1.14 $ --> +<!-- $Revision: 1.15 $ --> <!-- splitted from ./en/functions/image.xml, last change in rev 1.2 --> <refentry id="function.imagettftext"> <refnamediv> @@ -88,18 +88,34 @@ The path to the TrueType font you wish to use. </simpara> <simpara> - Depending on which version of the GD library that PHP is using, when + Depending on which version of the GD library PHP is using, <emphasis>when <parameter>fontfile</parameter> does not begin with a leading - <literal>/</literal> then <literal>.ttf</literal> will be appended + <literal>/</literal> then <literal>.ttf</literal> will be appended</emphasis> to the filename and the library will attempt to search for that filename along a library-defined font path. </simpara> <simpara> - When using versions of the GD library lower than 2.0.18, a "space" character, - rather than a semicolon, was used to define alternate paths to the font files. + When using versions of the GD library lower than 2.0.18, a <literal>space</literal> character, + rather than a semicolon, was used as the 'path separator' for different font files. Unintentional use of this feature will result in the warning message: - <literal>Warning: Could not find/open font</literal>. + <literal>Warning: Could not find/open font</literal>. For these affected versions, the + only solution is moving the font to a path which does not contain spaces. </simpara> + <para> + In many cases where a font resides in the same directory as the script using it + the following trick will alleviate any include problems. + <programlisting role="php"> +<![CDATA[ +<?php +// Set the enviroment variable for GD +putenv('GDFONTPATH=' . realpath('.')); + +// Name the font to be used (note the lack of the .ttf extension) +$font = 'SomeFont'; +?> +]]> + </programlisting> + </para> </listitem> </varlistentry> <varlistentry>