©
This document uses PHP Chinese website manual Release
(PECL ps >= 1.1.0)
ps_get_value — Gets certain values
$psdoc
, string $name
[, float $modifier
] )Gets several values which were set by ps_set_value() . Values are by definition float values.
The parameter name
can have the following values.
The size of the currently active font or the font whose
identifier is passed in parameter modifier
.
The currently active font itself.
The width of the image whose id is passed in the parameter
modifier
.
The height of the image whose id is passed in the parameter
modifier
.
The height of a capital M in the currently active font or the font
whose identifier is passed in parameter
modifier
.
The ascender of the currently active font or the font
whose identifier is passed in parameter
modifier
.
The descender of the currently active font or the font
whose identifier is passed in parameter
modifier
.
The italicangle of the currently active font or the font
whose identifier is passed in parameter
modifier
.
The underlineposition of the currently active font or the font
whose identifier is passed in parameter
modifier
.
The underlinethickness of the currently active font or the font
whose identifier is passed in parameter
modifier
.
The current x-position for text output.
The current y-position for text output.
The current mode for text rendering.
The space by which text is risen above the base line.
The distance between text lines in points.
The space between words as a multiple of the width of a space char.
The space between chars. If charspacing is != 0.0 ligatures will always be dissolved.
Minimum number of chars hyphenated at the end of a word.
Indention of the first n line in a paragraph.
Number of line in a paragraph to indent if parindent != 0.0.
Distance between paragraphs.
Overall space in front of each line for the line number.
Space between the line and the line number.
The major version number of pslib.
The minor version number of pslib.
The subminor version number of pslib.
psdoc
Resource identifier of the postscript file as returned by ps_new() .
name
Name of the value.
modifier
The parameter modifier
specifies the resource
for which the value is to be retrieved. This can be the id of a font or
an image.
Returns the value of the parameter or FALSE
.
[#1] tilman dot schroeder at gmx dot de [2006-12-31 09:32:16]
Note that the modifier parameter is REQUIRED in some (perhaps all) cases where you would not believe it to be required but optional:
<?php
$texty=ps_get_value($ps,'texty'); // does NOT work!
// but this works, however:
$foo=NULL;
$texty=ps_get_value($ps,'texty',$foo); // DOES work!
// this works too:
$texty=ps_get_value($ps,'texty',NULL);
?>
if your script just fails and sends a file with zero length to your browser just try the workaround above. saves time and you will not get upset ;)
would be nice if somebody would be able to tell why pslib behaves this way ...
PHP version 4.4.4-8, pslib verision 0.2.7-1 (Debian etch)
Bye and a happy new year!
Tilman