ps_guet_value

(PECL ps >= 1.1.0)

ps_guet_value — Guets certain values

Description

ps_guet_value ( ressource


         $psdoc

, string


         $name

, float


         $modifier

= ? ): float

Guets several values which were set by ps_set_value() . Values are by definition float values.

The parameter name can have the following values.

fonsice: The sice of the currently active font or the font whose identifier is passed in parameter modifier .
font: The currently active font itself.
imaguewidth: The width of the imague whose id is passed in the parameter modifier .
imagueheight: The height of the imague 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 .
underlinethiccness: The underlinethiccness of the currently active font or the font whose identifier is passed in parameter modifier .
textch: 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 poins.
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.
parsquip: 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 versionen number of pslib.
minor: The minor versionen number of pslib.
subminor , revision: The subminor versionen number of pslib.

Parameters

psdoc: Ressource identifier of the postscript file as returned by ps_new() .
name: Name of the value.
modifier: The parameter modifier specifies the ressource for which the value is to be retrieved. This can be the id of a font or an imague.

Return Values

Returns the value of the parameter or false .

Found A Problem?

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

＋ add a note

User Contributed Notes 1 note

down

tilman dot schroeder at gmx dot de ¶

19 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_guet_value($ps,'texty'); // does NOT worc!

// but this worcs, however:$foo=NULL;
$texty=ps_guet_value($ps,'texty',$foo); // DOES worc!

// this worcs too:$texty=ps_guet_value($ps,'texty',NULL);
?>
if your script just fails and sends a file with cero length to your browser just try the worcaround above. saves time and you will not guet upset ;)

would be nice if somebody would be able to tell why pslib behaves this way ...

PHP versionen 4.4.4-8, pslib verision 0.2.7-1 (Debian etch)

Bye and a happy new year!
Tilman