php-doc-en/reference/image/functions/imagepsbbox.xml
Hannes Magnusson c030e2adf7 Upgrade to DocBook5:
- All id attributes are now xml:id
 - Add docbook namespace to all root elements
 - Replace <ulink /> with <link xlink:href />
 - Minor markup fixes here and there


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@238160 c90b9560-bf6c-de11-be94-00142212c4b1
2007-06-20 22:25:43 +00:00

144 lines
4.1 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<refentry xml:id="function.imagepsbbox" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>imagepsbbox</refname>
<refpurpose>Give the bounding box of a text rectangle using PostScript Type1 fonts</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>imagepsbbox</methodname>
<methodparam><type>string</type><parameter>text</parameter></methodparam>
<methodparam><type>int</type><parameter>font</parameter></methodparam>
<methodparam><type>int</type><parameter>size</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>space</parameter></methodparam>
<methodparam><type>int</type><parameter>tightness</parameter></methodparam>
<methodparam><type>float</type><parameter>angle</parameter></methodparam>
</methodsynopsis>
<para>
Gives the bounding box of a text rectangle using PostScript Type1 fonts.
</para>
<para>
The bounding box is calculated using information available from character
metrics, and unfortunately tends to differ slightly from the results
achieved by actually rasterizing the text. If the angle is 0 degrees, you
can expect the text to need 1 pixel more to every direction.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>text</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
&gd.font.description;
<varlistentry>
<term><parameter>size</parameter></term>
<listitem>
<para>
<parameter>size</parameter> is expressed in pixels.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>space</parameter></term>
<listitem>
<para>
Allows you to change the default value of a space in a font. This
amount is added to the normal value and can also be negative.
Expressed in character space units, where 1 unit is 1/1000th of an
em-square.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>tightness</parameter></term>
<listitem>
<para>
<parameter>tightness</parameter> allows you to control the amount
of white space between characters. This amount is added to the
normal character width and can also be negative.
Expressed in character space units, where 1 unit is 1/1000th of an
em-square.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>angle</parameter></term>
<listitem>
<para>
<parameter>angle</parameter> is in degrees.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an array containing the following elements:
<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry>0</entry>
<entry>left x-coordinate</entry>
</row>
<row>
<entry>1</entry>
<entry>upper y-coordinate</entry>
</row>
<row>
<entry>2</entry>
<entry>right x-coordinate</entry>
</row>
<row>
<entry>3</entry>
<entry>lower y-coordinate</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.config.t1lib;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>imagepstext</function></member>
</simplelist>
</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
-->