ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Gets certain values

说明

float ps_get_value ( resource $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.

fontsize: The size of the currently active font or the font whose identifier is passed in parameter modifier.
font: The currently active font itself.
imagewidth: The width of the image whose id is passed in the parameter modifier.
imageheight: The height of the image whose id is passed in the parameter modifier.
capheight: The height of a capital M in the currently active font or the font whose identifier is passed in parameter modifier.
ascender: The ascender of the currently active font or the font whose identifier is passed in parameter modifier.
descender: The descender of the currently active font or the font whose identifier is passed in parameter modifier.
italicangle: The italicangle of the currently active font or the font whose identifier is passed in parameter modifier.
underlineposition: The underlineposition of the currently active font or the font whose identifier is passed in parameter modifier.
underlinethickness: The underlinethickness of the currently active font or the font whose identifier is passed in parameter modifier.
textx: The current x-position for text output.
texty: The current y-position for text output.
textrendering: The current mode for text rendering.
textrise: The space by which text is risen above the base line.
leading: The distance between text lines in points.
wordspacing: The space between words as a multiple of the width of a space char.
charspacing: The space between chars. If charspacing is != 0.0 ligatures will always be dissolved.
hyphenminchars: Minimum number of chars hyphenated at the end of a word.
parindent: Indention of the first n line in a paragraph.
numindentlines: Number of line in a paragraph to indent if parindent != 0.0.
parskip: Distance between paragraphs.
linenumberspace: Overall space in front of each line for the line number.
linenumbersep: Space between the line and the line number.
major: The major version number of pslib.
minor: The minor version number of pslib.
subminor, revision: 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 .

参见

ps_set_value() - Sets certain values

用户评论:

[#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