RecolorDocument
Color
Descripción
Mueve todas las páginas del documento a un espacio de color
Sintaxis
Delphi
Function TPDFlib.RecolorDocument(TargetSpace: Integer): Integer;Parámetros
| TargetSpace | 1 gris, 2 RGB, 3 CMYK |
|---|
Valores devueltos
| Count | Cuántos colores se convirtieron en todo el documento |
|---|---|
| 0 | No fue necesario realizar conversiones, o TargetSpace estuvo fuera del intervalo 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 usa la aritmética ordinaria del dispositivo y no una administrada por color: un documento que solo indica DeviceRGB no tiene perfil a través del cual convertir RGB se vuelve gris mediante los pesos de luminancia de ITU-R BT.601, y CMYK se convierte como se describe en ISO 32000-1 §8.6.4.4, tal como lo hace un visor al mostrar 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 vez de conservarlo, por lo que un documento así solo se convierte en las partes que nombran directamente un espacio de dispositivo
Las imágenes que dibuja una página también se convierten cuando tienen ocho bits por componente, un espacio de color de dispositivo y ninguna compresión o Flate simple. Una imagen JPEG o de fax tendría que recodificarse, una operación diferente 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 se empaqueten o compriman las muestras, por lo que una captura de pantalla de paleta o un gráfico se convierte aunque no se hayan podido reescribir sus muestras
Los degradados se convierten con las funciones que están detrás de ellos, por lo que el espacio y las paradas siempre coinciden. Un degradado construido a partir de una función muestreada o PostScript conserva sus propios colores, al igual que los tipos de sombreado de malla, que llevan sus colores en un flujo en lugar de en una función
Las máscaras suaves y las máscaras de esténcil se dejan intactas Ambas se leen como cobertura en lugar de color, y convertir una haría que la página mostrara 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');