mirror of
https://github.com/php/doc-de.git
synced 2026-03-23 23:02:13 +01:00
cbec81f3ab
git-svn-id: https://svn.php.net/repository/phpdoc/de/trunk@344611 c90b9560-bf6c-de11-be94-00142212c4b1
261 lines
7.4 KiB
XML
261 lines
7.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: b84cc8e4c5a84fa6b767c4528a85e8554f08f37d Maintainer: nobody Status: ready -->
|
|
|
|
<refentry xml:id="function.imagepstext" xmlns="http://docbook.org/ns/docbook">
|
|
<refnamediv>
|
|
<refname>imagepstext</refname>
|
|
<refpurpose>
|
|
Zeichnet Text auf einem Bild unter Verwendung von Typ 1 PostScript-Schriftarten
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsynopsisdiv>
|
|
&warn.removed.function-7-0-0;
|
|
</refsynopsisdiv>
|
|
|
|
<refsect1 role="description">
|
|
&reftitle.description;
|
|
<methodsynopsis>
|
|
<type>array</type><methodname>imagepstext</methodname>
|
|
<methodparam><type>resource</type><parameter>image</parameter></methodparam>
|
|
<methodparam><type>string</type><parameter>text</parameter></methodparam>
|
|
<methodparam><type>resource</type><parameter>font_index</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>size</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>foreground</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>background</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>x</parameter></methodparam>
|
|
<methodparam><type>int</type><parameter>y</parameter></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>space</parameter><initializer>0</initializer></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>tightness</parameter><initializer>0</initializer></methodparam>
|
|
<methodparam choice="opt"><type>float</type><parameter>angle</parameter><initializer>0.0</initializer></methodparam>
|
|
<methodparam choice="opt"><type>int</type><parameter>antialias_steps</parameter><initializer>4</initializer></methodparam>
|
|
</methodsynopsis>
|
|
<para>
|
|
Zeichnet Text auf einem Bild unter Verwendung von Typ 1
|
|
PostScript-Schriftarten.
|
|
</para>
|
|
<para>
|
|
Details zu Schriftarten und deren Maßsystem können der
|
|
PostScript-Dokumentation entnommen werden.
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="parameters">
|
|
&reftitle.parameters;
|
|
<para>
|
|
<variablelist>
|
|
&gd.image.description;
|
|
<varlistentry>
|
|
<term><parameter>text</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Der zu schreibende Text.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
&gd.psfont.description;
|
|
<varlistentry>
|
|
<term><parameter>size</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
<parameter>size</parameter> (Größe) wird in Pixel ausgedrückt.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>foreground</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Die Farbe, mit der der Text gezeichnet wird.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>background</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Die Farbe, zu der ein Farbübergang versucht werden soll. Dabei wird kein
|
|
Pixel mit der Farbe <parameter>background</parameter> ausgegeben, so dass
|
|
das Bild im Hintergrund keine festen Farben benötigt.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>x</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
x-Koordinate der linken unteren Ecke des ersten Zeichens.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>y</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
y-Koordinate der linken unteren Ecke des ersten Zeichens.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>space</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Ermöglicht, die Standardbreite eines Leerzeichens einer Schriftart zu
|
|
verändern. anzugeben. Dieser Wert wird zum Normal-Wert hinzu gezählt und
|
|
kann auch negativ sein. Wird in Zeichenraumeinheiten angegeben, wobei
|
|
eine Einheit ein Tausendstel einen em-Quadrats ist.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>tightness</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
<parameter>tightness</parameter> ermöglicht die Kontrolle über die
|
|
Zeichenabstände. Der angegebene Wert wird zur normalen Zeichenbreite
|
|
hinzu gezählt und kann auch negativ sein. Wird in Zeichenraumeinheiten
|
|
angegeben, wobei eine Einheit ein Tausendstel einen em-Quadrats ist.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>angle</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
<parameter>angle</parameter> (Winkel) wird in Grad angegeben.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term><parameter>antialias_steps</parameter></term>
|
|
<listitem>
|
|
<para>
|
|
Erlaubt die Kontrolle über die Anzahl der Farben, mit der der
|
|
Farbübergang vom Text zum Hintergrundbild vorgenommen werden soll.
|
|
Möglich sind Werte von 4 bis 16. Der höhere Wert wird empfohlen bei
|
|
Textgrößen kleiner als 20, wo der Effekt bei der Textqualität deutlich
|
|
sichtbar ist. Bei größeren Werten als 20 werden 4 Farben empfohlen. Das
|
|
ist weniger rechenintensiv.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="returnvalues">
|
|
&reftitle.returnvalues;
|
|
<para>
|
|
Diese Funktion gibt ein Array zurück, das folgende Elemente enthält::
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<tbody>
|
|
<row>
|
|
<entry>0</entry>
|
|
<entry>untere linke x-Koordinate</entry>
|
|
</row>
|
|
<row>
|
|
<entry>1</entry>
|
|
<entry>untere linke y-Koordinate</entry>
|
|
</row>
|
|
<row>
|
|
<entry>2</entry>
|
|
<entry>obere rechte x-Koordinate</entry>
|
|
</row>
|
|
<row>
|
|
<entry>3</entry>
|
|
<entry>obere rechte y-Koordinate</entry>
|
|
</row>
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="changelog">
|
|
&reftitle.changelog;
|
|
<para>
|
|
<informaltable>
|
|
<tgroup cols="2">
|
|
<thead>
|
|
<row>
|
|
<entry>&Version;</entry>
|
|
<entry>&Description;</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
&gd.changlog.t1lib;
|
|
</tbody>
|
|
</tgroup>
|
|
</informaltable>
|
|
</para>
|
|
</refsect1>
|
|
|
|
<refsect1 role="examples">
|
|
&reftitle.examples;
|
|
<example>
|
|
<title><function>imagepstext</function> Verwendung</title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
// Erzeuge ein Bild
|
|
$im = imagecreatetruecolor(200, 200);
|
|
|
|
// Alloziere Farben
|
|
$black = imagecolorallocate($im, 0, 0, 0);
|
|
$white = imagecolorallocate($im, 255, 255, 255);
|
|
|
|
// Lade die PostScript-Schriftart
|
|
$font = imagepsloadfont('font.pfm');
|
|
|
|
// Schreibe Text in das Bild
|
|
imagepstext($im, 'Ein einfacher Beispieltext', $font, 12, $black, $white, 50, 50);
|
|
|
|
// Ausgabe und Speicherbereinigung
|
|
header('Content-type: image/png');
|
|
|
|
imagepng($im);
|
|
imagedestroy($im);
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</refsect1>
|
|
|
|
<refsect1 role="notes">
|
|
&reftitle.notes;
|
|
¬e.config.t1lib;
|
|
</refsect1>
|
|
|
|
<refsect1 role="seealso">
|
|
&reftitle.seealso;
|
|
<para>
|
|
<simplelist>
|
|
<member><function>imagepsbbox</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:"~/.phpdoc/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
|
|
-->
|