RecolorDocument
Color
Descripción
Mueve todas las páginas del documento a un único espacio de color
Sintaxis
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Parámetros
| TargetSpace | 1 gris, 2 RGB, 3 CMYK |
|---|
Valores devueltos
| Count | Número de colores convertidos en todo el documento |
|---|---|
| 0 | No era necesario convertir nada o TargetSpace estaba fuera de 1 a 3. Una página cuyos colores ya están en el espacio de destino conserva sus bytes originales |
Observaciones
La conversión utiliza la aritmética ordinaria del dispositivo, no la gestión del color: un documento que solo indique DeviceRGB no contiene ningún perfil mediante el que realizar la conversión. RGB pasa a gris mediante las ponderaciones de luminancia de ITU-R BT.601 y CMYK se convierte como se describe en ISO 32000-1 §8.6.4.4, que es lo que ya hace un visor cuando muestra un documento CMYK en pantalla
Los colores establecidos mediante un espacio ICCBased, Separation, Indexed o Pattern se dejan tal como están. Leer sus componentes sin su perfil cambiaría el aspecto de la página en lugar de conservarlo, por lo que dicho documento solo se convierte en las partes que nombran directamente un espacio de dispositivo
También se convierten las imágenes que dibuja una página cuando la imagen tiene ocho bits por componente, un espacio de color de dispositivo y ninguna compresión o solo Flate. Una imagen JPEG o de fax tendría que volver a codificarse, lo que constituye una operación distinta de convertir sus colores, por lo que conserva sus propios bytes
Una imagen indexada se convierte mediante su tabla de colores, por lo que sus muestras conservan los índices que ya tenían. Esa ruta no depende de cómo estén empaquetadas o comprimidas las muestras, lo que permite convertir una captura de pantalla o un gráfico con paleta aunque sus muestras no se puedan volver a escribir
Los degradados se convierten junto con las funciones subyacentes, por lo que el espacio y las paradas siempre concuerdan. Un degradado creado a partir de una función muestreada o PostScript conserva sus propios colores, al igual que los tipos de sombreado de malla, que transportan sus colores en un flujo y no en una función
Las máscaras suaves y de plantilla no se modifican. Ambas se leen como cobertura, no como color, y convertirlas mostraría la máscara como imagen
La geometría, el texto, el recorte y todos los demás operadores se vuelven a escribir sin cambios
La página seleccionada se restaura cuando vuelve la llamada
Ejemplo
// Send a mixed-colour document to a press that expects CMYK
PDF.LoadFromFile('brochure.pdf', '');
Converted := PDF.RecolorDocument(3);
PDF.SaveToFile('brochure-cmyk.pdf');