ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Gets certain values

Beschreibung

ps_get_value(resource $psdoc, string $name, float $modifier = ?): float

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.

Parameter-Liste

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.

Rückgabewerte

Returns the value of the parameter or false.

Siehe auch

ps_set_value() - Sets certain values

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

tilman dot schroeder at gmx dot de ¶

17 years ago

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

＋add a note