uTools-Manuals/docs/php/imagepstext.html
2019-04-08 23:22:26 +08:00

256 lines
11 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>用 PostScript Type1 字体把文本字符串画在图像上</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.imagepstext" class="refentry">
<div class="refnamediv">
<h1 class="refname">imagepstext</h1>
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">imagepstext</span> &mdash; <span class="dc-title">用 PostScript Type1 字体把文本字符串画在图像上</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.imagepstext-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>imagepstext</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$image</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$text</code></span>
, <span class="methodparam"><span class="type">resource</span> <code class="parameter">$font_index</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$size</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$foreground</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$background</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$x</code></span>
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$y</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$space</code><span class="initializer"> = 0</span></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$tightness</code><span class="initializer"> = 0</span></span>
[, <span class="methodparam"><span class="type">float</span> <code class="parameter">$angle</code><span class="initializer"> = 0.0</span></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$antialias_steps</code><span class="initializer"> = 4</span></span>
]]]] ) : <span class="type">array</span></div>
<p class="para rdfs-comment">
用 PostScript Type1 字体把文本字符串画在图像上。
</p>
<p class="para">
如果不很理解请参考 PostScript
文档中关于字体及其度量系统的部分。
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.imagepstext-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">image</code></dt>
<dd>
<p class="para">由图象创建函数(例如<span class="function"><a href="imagecreatetruecolor.html" class="function">imagecreatetruecolor()</a></span>)返回的图象资源。</p></dd>
<dt>
<code class="parameter">text</code></dt>
<dd>
<p class="para">
要写入的文本。
</p>
</dd>
<dt>
<code class="parameter">font_index</code></dt>
<dd>
<p class="para"> <span class="function"><a href="imagepsloadfont.html" class="function">imagepsloadfont()</a></span> 返回的字体资源。
</p>
</dd>
<dt>
<code class="parameter">size</code></dt>
<dd>
<p class="para">
<code class="parameter">size</code> 以像素来表达。
</p>
</dd>
<dt>
<code class="parameter">foreground</code></dt>
<dd>
<p class="para">
写入的字体的颜色。
</p>
</dd>
<dt>
<code class="parameter">background</code></dt>
<dd>
<p class="para">
文本以防锯齿antialiasing方式尝试淡入的颜色。以 <code class="parameter">background</code>
为颜色的像素实际上不会被画上去,所以背景图像不需要是实心的颜色。
</p>
</dd>
<dt>
<code class="parameter">x</code></dt>
<dd>
<p class="para">
第一个字符的左下角起点 x 坐标。
</p>
</dd>
<dt>
<code class="parameter">y</code></dt>
<dd>
<p class="para">
第一个字符的左下角 y 坐标 。
</p>
</dd>
<dt>
<code class="parameter">space</code></dt>
<dd>
<p class="para">
<code class="parameter">space</code> 可以用来改变字体中默认间距的值。此值将被加到通常的值上,可以为负值。
以字符间距单元表示1 个单元为 1 em-square 的一千分之一。
</p>
</dd>
<dt>
<code class="parameter">tightness</code></dt>
<dd>
<p class="para"> <code class="parameter">tightness</code> 可以控制字符之间的间距。此值将被加到通常字符宽度上Z可以为负值。
以字符间距单元表示1 个单元为 1 em-square 的一千分之一。
</p>
</dd>
<dt>
<code class="parameter">angle</code></dt>
<dd>
<p class="para">
<code class="parameter">angle</code> 以角度表示。
</p>
</dd>
<dt>
<code class="parameter">antialias_steps</code></dt>
<dd>
<p class="para">
可以控制防混色文本使用的颜色的数目。允许值为
4 和 16。大的数值推荐用于大小小于 20
的文本,对文本质量的效果相当明显。对更大的大小,用 4计算强度小一些。
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.imagepstext-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
本函数返回一个包含下列单元的数组:
<table class="doctable informaltable">
<tbody class="tbody">
<tr>
<td>0</td>
<td>左下角的 X 坐标</td>
</tr>
<tr>
<td>1</td>
<td>左下角的 Y 坐标</td>
</tr>
<tr>
<td>2</td>
<td>右上角的 X 坐标</td>
</tr>
<tr>
<td>3</td>
<td>右上角的 Y 坐标</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.imagepstext-examples">
<h3 class="title">范例</h3>
<div class="example" id="example-3732">
<p><strong>Example #1 <span class="function"><strong>imagepstext()</strong></span> 用法</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">//&nbsp;创建图像句柄<br /></span><span style="color: #0000BB">$im&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">imagecreatetruecolor</span><span style="color: #007700">(</span><span style="color: #0000BB">200</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">200</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;分配颜色<br /></span><span style="color: #0000BB">$black&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">imagecolorallocate</span><span style="color: #007700">(</span><span style="color: #0000BB">$im</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">0</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$white&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">imagecolorallocate</span><span style="color: #007700">(</span><span style="color: #0000BB">$im</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">255</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">255</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">255</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;载入&nbsp;PostScript&nbsp;字体<br /></span><span style="color: #0000BB">$font&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">imagepsloadfont</span><span style="color: #007700">(</span><span style="color: #DD0000">'font.pfm'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;将字体写入图像<br /></span><span style="color: #0000BB">imagepstext</span><span style="color: #007700">(</span><span style="color: #0000BB">$im</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'Sample&nbsp;text&nbsp;is&nbsp;simple'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$font</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">12</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$black</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">$white</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">50</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">50</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">//&nbsp;输出图像并释放内存<br /></span><span style="color: #0000BB">header</span><span style="color: #007700">(</span><span style="color: #DD0000">'Content-type:&nbsp;image/png'</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">imagepng</span><span style="color: #007700">(</span><span style="color: #0000BB">$im</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">imagedestroy</span><span style="color: #007700">(</span><span style="color: #0000BB">$im</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
</div>
</div>
<div class="refsect1 notes" id="refsect1-function.imagepstext-notes">
<h3 class="title">注释</h3>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">此函数仅在 PHP
编译时指定了 <strong class="option configure">--with-t1lib[=DIR]</strong>
时可用。</span></p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-function.imagepstext-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="imagepsbbox.html" class="function" rel="rdfs-seeAlso">imagepsbbox()</a> - 给出一个使用 PostScript Type1 字体的文本方框</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>