# ps_set_info

(PECL ps >= 1.1.0)

ps_set_info — Establecer los campos de información del documento

### Descripción

ps_set_info(resource `$p`, string `$key`, string `$val`): bool

Establece ciertos campos de información del documento. Estos campos se mostrarán como un comentario en la cabecera del fichero PostScript. Si el documento es convertido a pdf, estos campos también se usarán para la información del documento.

El campo `BoundingBox` normalmente se establece al valor dado a la primera página. Esto sólo funciona si no se ha llamado antes a la función ps_findfont(). En tal caso BoundingBox estará sin establecer a menos que se establezca explícitamente con esta función.

Esta función ya no tendrá efecto cuando la cabecera del fichero postscript ha sido escrita. Debe ser llamada antes de la primera página o de la primera llamada a la función ps_findfont().

### Parámetros

`psdoc`

  Un identificador de recursos del fichero postscript, como el devuelto por la función ps_new().

`key`

  El nombre del campo de información a establecer. Los valores que se pueden establecer son `Keywords` (palabras clave), `Subject` (asunto), `Title` (título), `Creator` (creador), `Author` (autor), `BoundingBox` (caja circundante), y `Orientation` (orientación). Tenga en cuenta que algunos de ellos tienen un significado para los visualizadoes de PostScript.

`value`

  El valor del campo de información. El campo `Orientation` puede ser establecido a `Portrait` (horizontal) o `Landscape` (vertical). El campo `BoundingBox` es una cadena de caracteres que consiste en cuatro números. Los dos primeros son las coordenadas de la esquina inferior izquierda de la página. Los dos últimos son las coordenadas de la esquina superior derecha.

  > Nota:

  > Hasta la versión 0.2.6 de pslib, los campos BoundingBox y Orientation eran sobrescritos por la función ps_begin_page(), a menos que se llamara antes a la función ps_findfont().

### Valores devueltos

Devuelve `true` en caso de éxito o `false` en caso de error.

### Ver también

- ps_findfont() - Cargar una fuente
- ps_begin_page() - Empezar una nueva página