php-doc-en/reference/image/functions/imagecreatetruecolor.xml
Dave Barr 11055a8ad0 - Typos.
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@202396 c90b9560-bf6c-de11-be94-00142212c4b1
2005-12-08 12:10:54 +00:00

81 lines
2.4 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- splitted from ./en/functions/image.xml, last change in rev 1.2 -->
<refentry id="function.imagecreatetruecolor">
<refnamediv>
<refname>imagecreatetruecolor</refname>
<refpurpose>Create a new true color image</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>resource</type><methodname>imagecreatetruecolor</methodname>
<methodparam><type>int</type><parameter>x_size</parameter></methodparam>
<methodparam><type>int</type><parameter>y_size</parameter></methodparam>
</methodsynopsis>
<para>
<function>imagecreatetruecolor</function> returns an image identifier
representing a black image of size <parameter>x_size</parameter>
by <parameter>y_size</parameter>.
</para>
<para>
Depending on your PHP and GD versions this function is defined or not. With
PHP 4.0.6 through 4.1.x this function always exists if the GD module is
loaded, but calling it without GD2 being installed PHP will issue a fatal
error and exit. With PHP 4.2.x this behaviour is different in issuing a
warning instead of an error. Other versions only define this function, if
the correct GD version is installed.
</para>
<para>
<example>
<title>
Creating a new GD image stream and outputting an image.
</title>
<programlisting role="php">
<![CDATA[
<?php
header ("Content-type: image/png");
$im = @imagecreatetruecolor(50, 100)
or die("Cannot Initialize new GD image stream");
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "A Simple Text String", $text_color);
imagepng($im);
imagedestroy($im);
?>
]]>
</programlisting>
</example>
</para>
&note.gd.2;
<note>
<para>
This function will not work with GIF file formats.
</para>
</note>
<para>
See also <function>imagedestroy</function> and
<function>imagecreate</function>.
</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
-->