<!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>Gets width of a string</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ps-string-geometry.html">ps_string_geometry</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.ps-stroke.html">ps_stroke</a></div>
<div class="up"><a href="ref.ps.html">PS Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.ps-stringwidth" class="refentry">
<div class="refnamediv">
<h1 class="refname">ps_stringwidth</h1>
<p class="verinfo">(PECL ps >= 1.1.0)</p><p class="refpurpose"><span class="refname">ps_stringwidth</span> — <span class="dc-title">Gets width of a string</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.ps-stringwidth-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">float</span> <span class="methodname"><strong>ps_stringwidth</strong></span>
( <span class="methodparam"><span class="type">resource</span> <code class="parameter">$psdoc</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$text</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$fontid</code><span class="initializer"> = 0</span></span>
[, <span class="methodparam"><span class="type">float</span> <code class="parameter">$size</code><span class="initializer"> = 0.0</span></span>
]] )</div>
<p class="para rdfs-comment">
Calculates the width of a string in points if it was output
in the given font and font size.
This function needs an Adobe font
metrics file to calculate the precise width. If kerning is turned on,
it will be taken into account.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.ps-stringwidth-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">psdoc</code></em></span>
<dd>
<p class="para">
Resource identifier of the postscript file
as returned by <span class="function"><a href="function.ps-new.html" class="function">ps_new()</a></span>.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">text</code></em></span>
<dd>
<p class="para">
The text for which the width is to be calculated.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">fontid</code></em></span>
<dd>
<p class="para">
The identifier of the font to be used. If not font is specified
the current font will be used.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">size</code></em></span>
<dd>
<p class="para">
The size of the font. If no size is specified the current size
is used.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.ps-stringwidth-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Width of a string in points.
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.ps-stringwidth-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.ps-string-geometry.html" class="function" rel="rdfs-seeAlso">ps_string_geometry()</a> - Gets geometry of a string</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.ps-string-geometry.html">ps_string_geometry</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.ps-stroke.html">ps_stroke</a></div>
<div class="up"><a href="ref.ps.html">PS Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
