ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Obtener ciertos valores

Descripción

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

Obtiene varios valores que se establecieron con la función ps_set_value(). Los valores son por definición valores de tipo float.

El parámetro name puede tener los siguientes valores:

fontsize: El tamaño de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
font: La fuente activa misma.
imagewidth: El ancho de la imagen cuyo ID es pasado al parámetro modifier.
imageheight: El alto de la imagen cuyo ID es pasado al parámetro modifier.
capheight: El alto de una M mayúscula de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
ascender: El ascendente de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
descender: El descendente de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
italicangle: El ángulo de la letra itálica de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
underlineposition: La posición del subrayado de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
underlinethickness: El grosor del subrayado de la fuente activa o la fuente cuyo identificador es pasado al parámetro modifier.
textx: La coordenada x para la impresión del texto.
texty: La coordenada y para la impresión del texto.
textrendering: El modo actual de renderización de texto.
textrise: El espacio por el que el texto es alzado por encima de la línea base.
leading: La distancia entre líneas de texto en puntos.
wordspacing: El espacio entre palabras como un múltiplo del ancho de un carácter espacio.
charspacing: El espacio entre caracteres. Si "charspacing" es != 0.0, las liagaduras siempre serán disueltas.
hyphenminchars: El número mínimo de caracteres divididos mediante guión al final de una palabra.
parindent: El sangrado de las primeras n líneas de un párrafo.
numindentlines: El número de línea a sangrar de un párrafo si "parindent" != 0.0.
parskip: La distancia entre párrafos.
linenumberspace: El espacio total delante de cada línea para el número de línea.
linenumbersep: El espacio entre la línea y el número de línea.
major: El número de la versión mayor de pslib.
minor: El número de la versión menor pslib.
subminor, revision: El número de la versión submenor de pslib.

Parámetros

psdoc: El identificador de recursos del fichero postscript, como el devuelto por la función ps_new().
name: El nombre del valor.
modifier: El parámetro modifier especifica el recurso por el que recuperar el valor. Puede ser el ID de una fuente o imagen.

Valores devueltos

Devuelve el valor del parámetros o false.

Ver también

ps_set_value() - Establecer ciertos valores

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