ps_get_value

(PECL ps >= 1.1.0)

ps_get_value — Получает определённые значения

Описание

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

Получает несколько значений, установленных ps_set_value(). Значения по определению являются значениями с плавающей точкой.

Параметр name может иметь следующие значения:

fontsize: Размер текущего активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
font: Текущий активный шрифт.
imagewidth: Ширина изображения, идентификатор которого передаётся в параметре modifier.
imageheight: Высота изображения, идентификатор которого передаётся в параметре modifier.
capheight: Высота заглавной буквы M активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
ascender: Верхний элемент активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
descender: Нисходящий элемент активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
italicangle: Курсив активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
underlineposition: Подчёркивание активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
underlinethickness: Толщина подчёркивания активного шрифта или шрифта, идентификатор которого передаётся в параметре modifier.
textx: Текущая позиция по оси X для вывода текста.
texty: Текущая позиция по оси Y для вывода текста.
textrendering: Текущий режим отрисовки текста.
textrise: Пространство, на которое текст поднимается над базовой линией.
leading: Расстояние между строками текста в точках.
wordspacing: Расстояние между словами, кратное ширине символа пробела.
charspacing: Пробел между символами. Если charspacing не равно 0.0, лигатуры всегда будут растворяться.
hyphenminchars: Минимальное количество символов в конце слова.
parindent: Отступ первой n строки абзаца.
numindentlines: Номер строки в абзаце для отступа, если parindent не равно 0,0.
parskip: Расстояние между абзацами.
linenumberspace: Общее пространство перед каждой строкой для номера строки.
linenumbersep: Пробел между строкой и номером строки.
major: Мажорная версия pslib.
minor: Минорная версия pslib.
subminor, revision: Патч-версия pslib.

Список параметров

psdoc: Идентификатор ресурса файла postscript, возвращённый функцией ps_new().
name: Название значения.
modifier: Параметр modifier указывает ресурс, для которого должно быть получено значение. Это может быть идентификатор шрифта или изображения.

Возвращаемые значения

Возвращает значение параметра или false.

Смотрите также

ps_set_value() - Устанавливает определённые значения

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