DocumentaciónAPI de servicio y procesamiento de imágenes de Dynamic Media

ic ic

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 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 section-fb5293fa79894442aba831c1e14c5cc9

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 section-36a2dcfa39824d29b69547c432366219

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 section-df311ace43f947b3817b60b667ae04ca

- 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 section-ab13d941d6724e65b9f84b62d949d31c

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 section-3c1986b30315431989bd76b1ee5bef6d

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
a26166cd-f2f4-45ce-996d-96a0f0d6cf49