ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Recupera ciertos valores

Descripción

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

Recupera varios valores que han sido establecidos por ps_set_value(). Los valores son, por definición, valores de float.

El argumento name puede tener uno de los siguientes valores.

fontsize: El tamaño de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
font: La fuente actualmente activa en sí misma.
imagewidth: La anchura de la imagen cuyo identificador se pasa en el argumento modifier.
imageheight: La altura de la imagen cuyo identificador se pasa en el argumento modifier.
capheight: La altura de una letra mayúscula M en la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
ascender: La hampe de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
descender: El jambage de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
italicangle: El parámetro italicangle de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
underlineposition: El parámetro underlineposition de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
underlinethickness: El parámetro underlinethickness de la fuente actualmente activa o la fuente cuyo identificador se pasa en el argumento modifier.
textx: La posición x actual de visualización del texto.
texty: La posición y actual de visualización del texto.
textrendering: El modo actual para el renderizado del texto.
textrise: El espacio por el cual el texto es aumentado por encima de la línea de base.
leading: La distancia entre las líneas de texto en puntos.
wordspacing: El espacio entre las palabras como múltiplo de la anchura de un carácter de espacio.
charspacing: El espacio entre los caracteres. Si charspacing es != 0.0, las ligaduras siempre estarán desactivadas.
hyphenminchars: Número mínimo de caracteres antes de un guion al final de una palabra.
parindent: La indentación de las primeras n líneas en un párrafo.
numindentlines: Número de líneas en un párrafo a indentar si paraindent != 0.0.
parskip: Distancia entre los párrafos.
linenumberspace: Espacio general frente a cada línea para el número de línea.
linenumbersep: Espacio entre las líneas y los números de línea.
major: El número de versión mayor de pslib.
minor: El número de versión menor de pslib.
subminor, revision: El número de versión submenor de pslib.

Parámetros

psdoc: Identificador de un archivo postscript devuelto por ps_new().
name: Nombre del valor.
modifier: El argumento modifier especifica el recurso para el cual se recuperará el valor. Esto puede ser el ID de la fuente o una imagen.

Valores devueltos

Devuelve el valor del parámetro o false.

Ver también

ps_set_value() - Establecer ciertos valores

Found A Problem?

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 ¶

18 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