ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Récupère certaines valeurs

Description

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

Récupère plusieurs valeurs qui ont été fixées par ps_set_value(). Les valeurs sont par définition des valeurs de nombre décimal.

Le paramètre name peut avoir une des valeurs suivantes.

fontsize: La taille de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
font: La police présentement active en elle-même.
imagewidth: La largeur de l'image dont l'identifiant est passé dans le paramètre modifier.
imageheight: La hauteur de l'image dont l'identifiant est passé dans le paramètre modifier.
capheight: La hauteur d'une capitale M dans la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
ascender: La hampe de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
descender: Le jambage de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
italicangle: Le paramètre italicangle de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
underlineposition: Le paramètre underlineposition de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
underlinethickness: Le paramètre underlinethickness de la police présentement active ou la police dont l'identifiant est passé dans le paramètre modifier.
textx: La position x courante d'affichage du texte.
texty: La position y courante d'affichage du texte.
textrendering: Le mode courant pour le rendu du texte.
textrise: L'espace par lequel le texte est augmenté au dessus de la ligne de base.
leading: La distance entre les lignes de texte en points.
wordspacing: L'espace entre les mots en tant que multiple de la largeur d'un caractère d'espace.
charspacing: L'espace entre les caractères. Si charspacing est != 0.0, les ligatures seront toujours détachées.
hyphenminchars: Nombre minimal de caractères avant un trait d'union à la fin d'un mot.
parindent: L'indentation des premières n lignes dans un paragraphe.
numindentlines: Nombre de ligne dans un paragraphe à indenter si paraindent != 0.0.
parskip: Distance entre les paragraphes.
linenumberspace: Espace général en face de chaque ligne pour le numéro de ligne.
linenumbersep: Espace entre les lignes et les numéros de lignes.
major: Le numéro de version majeur de pslib.
minor: Le numéro de version mineur de pslib.
subminor, revision: Le numéro de version sous mineur de pslib.

Liste de paramètres

psdoc: Identifiant d'un fichier postscript retourné par ps_new().
name: Nom de la valeur.
modifier: Le paramètre modifier spécifie la ressource pour laquelle la valeur sera récupérée. Cela peut être l'ID de la police ou une image.

Valeurs de retour

Retourne la valeur du paramètre ou false.

Voir aussi

ps_set_value() - Fixe certaines valeurs

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