Documentación API de servicio y procesamiento de imágenes de Dynamic Media

ic

Última actualización: 22 de julio de 2024

Temas:

Creado para:

Desarrollador
Usuario

Utilidad de conversión de imágenes.

ic es una herramienta de línea de comandos que convierte los archivos de imagen al formato de TIFF piramidal optimizado (PTIFF). Aunque el servicio de imágenes puede procesar imágenes sin conversión, le recomendamos que convierta todas las imágenes de más de 512 x 512 píxeles a PTIFF. Esta conversión garantiza un rendimiento de servidor y un uso de recursos óptimos y minimiza los tiempos de respuesta.

Se recomienda que los archivos PTIFF con contenido fotográfico estén codificados en el JPEG (especifique -jpegcompress). El contenido generado por el equipo puede beneficiarse de la compresión sin pérdidas (-deflatecompress o -lzwcompress). A menos que se requiera una conversión de color o de tipo de píxel, los datos de la imagen de origen del JPEG se transfieren al PTIFF sin descodificación, para evitar la degradación de la calidad. En este caso, las opciones de compresión especificadas sólo se aplican a los niveles piramidales de baja resolución.

Si no está convirtiendo imágenes grandes, no tiene que definir los parámetros que controlan la cantidad de memoria que se debe utilizar. Sin embargo, si es así, dé a ic más memoria utilizando la configuración -maxmem que se describe a continuación. Una buena regla general para calcular la cantidad de memoria necesaria es multiplicar la anchura de la imagen por la altura de la imagen por el número de canales. Por ejemplo, cuatro para una imagen RGB con alfa por tres. Además, si los canales son de 16 bits por componente en lugar de 8, el resultado final será el doble.

Uso

ic -convert [options]sourceFiledestFile

ic -convert [options]sourceFolderdestFolder

-c -convert [options]sourceFiledestFolder

opciones	Opciones de comando (consulte más abajo).
archivoDeOrigen	Archivo de imagen de entrada única.
destFile	Archivo PTIFF de salida única (no válido si se utiliza con SourceDirectory).
carpetaDeOrigen	Carpeta que contiene imágenes de entrada.
destFolder	Carpeta en la que se escriben los archivos PTIFF de salida.

Devuelve

0 si se realiza correctamente. Si se produce un error, se devuelve un valor distinto de cero y los detalles del error se envían a stderr.

Opciones

- sin comprimir	No comprima la imagen de salida.
-deflatecompress	Utilice la compresión deflate (zip) (predeterminada).
-lzwcompress	Utilice la compresión Lempel-Ziv-Welch (LZW).
-jpegcompress	Utilice la codificación del JPEG. Se omitirá si sourceFile incluye datos alfa.
-jpegquality < quality >	Calidad JPEG (0-100; el valor predeterminado es 95).
-fullsamplechrominance	Deshabilite la disminución de resolución de croma JPEG (puede mejorar la calidad del texto y los gráficos en color). Esto no afecta a las imágenes de salida CMYK o en escala de grises.
-usm < cantidad > < radio > < umbral > < monocromo >	Aplicar máscara de enfoque a los niveles piramidales submuestreados. Consulte op_usm=para obtener detalles. (No se aplica a la imagen con resolución completa).
- applyClippath	Utilice la ruta del clip en el archivo de origen, si existe, para crear datos alfa asociados.
-ppp < ppp >	Resolución de impresión (ppp) para destFile ; si no se especifica, la resolución de impresión de srcFile se copia en destFile .
-autorecorte < esquina > < modo > < tolerancia > < archivo de información >	Calcule un rectángulo de recorte para minimizar un fondo de color sólido. No se genera ninguna información de recorte si el algoritmo de recorte automático provoca el recorte total de la imagen. Para calcular el rectángulo de recorte sin convertir la imagen, especifique -autocrop sin -convert y sin destFile. *esquina* - ul \| ur \| ll \| lr Especifica la esquina de la imagen que debe utilizar un punto semilla. Se ignora si el modo es 1. *modo* - 0 \| 1 Definir en 0 para recortar en función del color del píxel de esquina especificado; funciona en datos de color premultiplicados si los datos alfa están asociados a la imagen de origen. Establezca el valor en 1 para recortar en función de los datos alfa; se omite corner y 0 es siempre el valor de semilla; no se aplica ningún recorte si no hay datos alfa asociados con la imagen de origen. *tolerancia* - Tolerancia de coincidencias. Valor real 0,0 a 1,0. Especifica la tolerancia para valores de componente de píxeles coincidentes. Establezca el valor en 0 para las coincidencias exactas. *infoFile*: ruta de acceso y nombre del archivo de salida XML en el que se escriben los datos de información de recorte.
-embedXmpData	XMP Copie los metadatos, si están disponibles, de sourceFile a destFile sin ninguna modificación.
-embedColorProfile	Incruste el perfil de color ICC en destFile , si está disponible (ningún perfil está incrustado de forma predeterminada).
-imageprofile < archivo >	Ruta y nombre de un archivo de perfil ICC. Define el espacio de color de sourceFile y debe coincidir con su tipo de píxel. Se debe especificar solamente si no hay ningún perfil incrustado en sourceFile , ya que esto anula el perfil incrustado.
-viewprofile < archivo >	Ruta y nombre de un archivo de perfil ICC. Define el tipo de píxel y el espacio de color de destFile . IC se convierte a este perfil si sourceFile tiene un perfil incrustado o si -imageprofile también está especificado.
- IntentPerceptual	Intento de representación perceptual para las conversiones del espacio de color.
- IntentRelColorimetric	Interpretación colorimétrica relativa para conversiones del espacio de color (predeterminada).
- IntentAbsColorimetric	Interpretación colorimétrica absoluta para conversiones del espacio de color.
- IntentSaturation	La saturación representa la intención para las conversiones del espacio de color.
-cmsNoBlackPointCompensation	Deshabilitar la compensación de punto negro para determinadas conversiones de color Habilitado de forma predeterminada.
-cmsNoDither8	Deshabilite el tramado (difusión de error) al convertir el color.
-maintainpixeltype	Deshabilite la conversión automática de CMYK a RGB.
- forceJPEGDecompress	Forzar la descodificación y la recodificación de las imágenes de entrada del JPEG. Precaución: La aplicación de esta opción puede reducir la calidad de la imagen.
-downsample2x2	Utilice un filtro de remuestreo de calidad estándar (bilineal).
-downsample8x8	Utilice un filtro de remuestreo de mayor calidad (ventana de Lanczos) (predeterminado).
-downsample8x8FlashPix	Utilice un filtro de remuestreo de mayor calidad (FlashPix).
-downsample8x8BicubicSharp	Disminución de resolución con el filtro bicúbico-sharp estilo Photoshop 8x8.
-nousage	Cuando se especifica como primera opción, suprime la salida de la información de uso cuando se encuentran opciones no válidas.
: sobrescribir	Permitir sobrescribir un elemento destFile de existente. De forma predeterminada, se anexa un sufijo numérico al nombre del archivo para evitar que se sobrescriba.
-skiphidden	Omitir archivos de origen ocultos.
-continueonerror	No detener el procesamiento cuando se produzca un error. Solo tiene efecto cuando se procesan varios archivos.
-logfile < file >	Ruta de acceso y nombre del archivo de registro (el valor predeterminado es stdout ).
-loglevel < nivel >	Nivel de registro. < 0 - Registro deshabilitado. 0 - Archivos de lista para procesar. 1 - Agregar informes para archivos innecesarios. 2 - Agregar informes de progreso. 3 - Añada informes sobre cada archivo encontrado. 4 - Agregar informes de progreso en el nivel de archivo.
-logappend	Anexar al archivo de registro (predeterminado).
-nologappend	Sobrescribir archivo de registro.
-logprogressmsec < msec >	Intervalo de registro en ms para el nivel de registro 2 y superior (el valor predeterminado es 3000).
-maxmem < bytes >	Límite de uso de memoria. Debe tener al menos 10 MB.
-maxmempercent < percent >	Límite de uso de memoria. El valor predeterminado es el 25 % de la memoria física. Si ni maxmem ni maxmempercent se establecen explícitamente, utiliza maxmempercent de forma predeterminada.
- versión	Devolver información de versión de esta utilidad. Especifique sin ninguna otra opción.

Formatos de imagen de entrada admitidos

En la tabla siguiente se enumeran los formatos de archivo de imagen y las opciones de formato que admite IC.

Formato	Tipo De Píxel Bits/Canal	Bits/Canal	Compresión	notas
BMP (Mapa de bits de Windows)	RGB \| indexado	1 \| 5/6 \| 8	sin comprimir \| RLE	5/6 bits/canal indica compatibilidad con RGB de 16 bits (5-5-5 y 5-6-5 bits/canal).
EPS (Postscript encapsulado)	CMYK \| RGB \| gris	8	ASCII \| ASCII85 \| Binario \| JPEG	Solo se admiten los archivos EPS generados por Photoshop.

CompuServe GIF	indexado	8	LZW	Si está presente, el valor de transparencia de la paleta se convierte a alfa.
JPG (JFIF/JPEG)	CMYK \| RGB \| gris	8	JPEG
Photoshop PSD	CMYK \| CMYKA \| RGB \| RGBA \| gris \| grayA	1 \| 8 \| 16	sin comprimir \| comprimido	Solo imagen combinada; se omiten las capas y los canales adicionales.
Macintosh PICT	RGB	8	RLE	Solo datos de mapa de bits; se omiten los datos vectoriales.
PNG	RGB \| RGBA \| gris \| grayA \| indexado	1 \| 2 \| 4 \| 8 \| 16	comprimido
TIFF	CMYK \| CMYKA \| RGB \| RGBA \| gris \| grayA \| indexado	1 \| 8 \| 16	sin comprimir \| ZIP \| LZW \| JPEG \| REGLA CCITT \| CCITT G3 \| CCITT G4 \| Bits de paquete	Con la excepción del primer canal alfa asociado, se omiten los canales adicionales.

Los perfiles ICC incrustados se reconocen en los archivos EPS, JPG, PSD, PNG y TIFF.

Las rutas incrustadas y los metadatos de la se reconocen en los archivos de EPS JPG, XMP de la aplicación, PSD y TIFF.

Ejemplos

Convierta una sola imagen con la mejor calidad y manténgala en la misma carpeta:

ic -convert src/myFile.png src/myFile.tif

Convierta todas las imágenes de srcFolder en TIFF piramidales con codificación de JPEG y colóquelas en destFolder:

ic -convert -jpegcompress -jpegquality 90 -overwrite -continueOnError srcFolder destFolder

Convertir todas las imágenes de srcFolder. Los datos de imagen codificados de los archivos JPG se utilizan para la compresión LZW sin pérdidas y de nivel de resolución completa para el resto de la pirámide de imágenes de estas imágenes, así como para toda la imagen de salida de todos los archivos de entrada no JPG. XMP Los tipos de píxeles, los perfiles de color incrustados, los metadatos de la, etc. se mantienen.

ic -convert -lzwcompress -embedXmpData -embedColorProfile -maintainpixeltype -overwrite -continueOnError srcFolder destFolder

recommendation-more-help