<?xml version="1.0" encoding="utf-8"?>

<!-- EN-Revision: 20a9aaa1f195160622f9c53eabcfd2da7b32b346 Maintainer: nobody Status: ready -->

<!-- Reviewed: yes -->

<!-- Rev-Revision: 593ea510e853ff034e03f78a4be0daa41661c9d4 Reviewer: samesch -->

<refentry xml:id="function.imagettftext" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>imagettftext</refname>

<refpurpose>Schreibt Text mit TrueType-Schriftarten ins Bild</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>array</type><type>false</type></type><methodname>imagettftext</methodname>

<methodparam><type>GdImage</type><parameter>image</parameter></methodparam>

<methodparam><type>float</type><parameter>size</parameter></methodparam>

<methodparam><type>float</type><parameter>angle</parameter></methodparam>

<methodparam><type>int</type><parameter>x</parameter></methodparam>

<methodparam><type>int</type><parameter>y</parameter></methodparam>

<methodparam><type>int</type><parameter>color</parameter></methodparam>

<methodparam><type>string</type><parameter>font_filename</parameter></methodparam>

<methodparam><type>string</type><parameter>text</parameter></methodparam>

<methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>

</methodsynopsis>

<para>

Schreibt den angegebenen <parameter>text</parameter> ins Bild unter

Verwendung von True-Type-Schriftarten.

</para>

<note>

<para>

Vor PHP 8.0.0 war <function>imagefttext</function> eine erweiterte

Variante von <function>imagettftext</function>, die zusätzlich den

Parameter <parameter>extrainfo</parameter> unterstützte. Ab PHP 8.0.0 ist

<function>imagettftext</function> ein Alias von

<function>imagefttext</function>.

</para>

</note>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

&gd.image.description;

<varlistentry>

<term><parameter>size</parameter></term>

<listitem>

<para>&gd.font.size;</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>angle</parameter></term>

<listitem>

<para>

Der Winkel in Grad, wobei 0 Grad einen von links nach rechts zu

lesenden Text ergibt. Höhere Werte bewirken eine Drehung gegen den

Uhrzeigersinn. Ein Wert von 90 ergibt zum Beispiel einen von unten nach

oben zu lesendem Text.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>x</parameter></term>

<listitem>

<para>

Die per <parameter>x</parameter> und <parameter>y</parameter>

angegebenen Koordinaten definieren den Startpunkt des ersten Zeichens

(in etwa die linke untere Ecke). Das ist anders als bei der

Funktion <function>imagestring</function>, bei der

<parameter>x</parameter> und <parameter>y</parameter> die obere rechte

Ecke des ersten Zeichens darstellen. Zum Beispiel ist oben links 0, 0.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>y</parameter></term>

<listitem>

<para>

Die y-Koordinate. Diese legt die Position der Grundlinie der Schriftart

fest, nicht den untersten Rand des Zeichens.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>color</parameter></term>

<listitem>

<para>

Der Farbindex. Die Verwendung des negativen Indexwerts schaltet das

Antialiasing ab. Siehe <function>imagecolorallocate</function>.

</para>

</listitem>

</varlistentry>

&gd.ttf.fontfile;

<varlistentry>

<term><parameter>text</parameter></term>

<listitem>

<para>

Die UTF8-kodierte Text-Zeichenkette.

</para>

<para>

Kann dezimale numerische Zeichen-Entity-Referenzen (in der Form

<literal>&amp;#8364;</literal>) enthalten, um Zeichen außerhalb des

ASCII-Bereichs zu referenzieren.

Das hexadizimale Format (wie <literal>&amp;#xA9;</literal>) wird

ebenfalls unterstützt. UTF-8-kodierte Zeichenketten können direkt

übergeben werden.

</para>

<para>

Benannte Zeichen-Entity-Referenzen wie <literal>&amp;copy;</literal>

werden nicht unterstützt. um diese Zeichen-Entity-Referenzen nach UTF-8

zu konvertieren, kann <function>html_entity_decode</function> verwendet

werden.

</para>

<para>

Wenn ein Zeichen in der Zeichenkette verwendet wird, das von der

Schriftart nicht untersützt wird, wird es durch ein hohles Rechteck

ersetzt.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Gibt ein Array mit 8 Elementen zurück, die die vier Punkte des umgebenden

Rechtecks des Textes repräsentieren. Die Reihenfolge der Punkte ist unten

links, unten rechts, oben rechts und oben links. Die Punkte sind relativ

zum Text, unabhängig vom Winkel, sodass "obere linke Ecke" bedeutet "in der

oberen linken Ecke, wenn der Text horizontal gesehen wird". Im Fehlerfall

wird &false; zurückgegeben.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.0.0</entry>

<entry>

Die <parameter>options</parameter> wurden hinzugefügt.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title><function>imagettftext</function>-Beispiel</title>

<para>

Dieses Beispielskript erzeugt ein weißes 400x30 Pixel großes PNG mit dem

Text "Testing..." in schwarz (mit grauem Schatten) in der Schriftart Arial.

</para>

<programlisting role="php">

<![CDATA[

<?php

// Setze den Content-Type

header('Content-Type: image/png');

// Erzeuge das Bild

$im = imagecreatetruecolor(400, 30);

// Erzeuge einige Farben

$white = imagecolorallocate($im, 255, 255, 255);

$grey = imagecolorallocate($im, 128, 128, 128);

$black = imagecolorallocate($im, 0, 0, 0);

imagefilledrectangle($im, 0, 0, 399, 29, $white);

// Der zu zeichnende Text

$text = 'Testing...';

// Bei Bedarf ist der Pfad anzupassen

$font = 'arial.ttf';

// Füge etwas Schatten zum Text hinzu

imagettftext($im, 20, 0, 11, 21, $grey, $font, $text);

// Füge den Text hinzu

imagettftext($im, 20, 0, 10, 20, $black, $font, $text);

// Die Verwendung von imagepng() ergibt eine bessere Textqualität als imagejpeg()

imagepng($im);

?>

]]>

</programlisting>

&example.outputs.similar;

<mediaobject>

<alt>Ausgabe des Beispiels: imagettftext()</alt>

<imageobject>

<imagedata fileref="en/reference/image/figures/imagettftext.png"/>

</imageobject>

</mediaobject>

</example>

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

&note.freetype;

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<simplelist>

<member><function>imagettfbbox</function></member>

<member><function>imagefttext</function></member>

</simplelist>

</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

-->