CONVERT PICTURE

4D v16.3

CONVERT PICTURE


CONVERT PICTURE ( imagen ; codec {; compresion} )

Parámetro	Tipo	Descripción
imagen	Imagen	Imagen a convertir
		Imagen convertida
codec	Cadena	Identificador de codec de imagen
compresion	Real	Calidad de compresión

Descripción

El comando CONVERT PICTURE convierte imagen en un nuevo tipo.

El parámetro codec indica el tipo de imagen a generar. Un codec puede ser una extensión (por ejemplo, “.gif”) o un tipo Mime (por ejemplo, “image/jpg”).
Puede obtener una lista de codecs disponibles utilizando el comando PICTURE CODEC LIST.

Si el campo o variable imagen es de tipo compuesto (si por ejemplo es el resultado de la acción copiar -pegar), sólo la información correspondiente al tipo codec se conserva en la imagen resultante.

Nota: si el tipo de codec solicitado es elmismo que el tipo original de la imagen, no se efectúa ninguna conversión y la imagen se devuelve "tal cual" (excepto cuando se utiliza el parámetro compresion, ver a continuación).

El parámetro opcional compresion, si se pasa, permite definir la calidad de compresión a aplicar a la imagen resultante cuando se utiliza un Codec compatible. En compresion, pase un valor entre 0 y 1 para especificar la calidad de la compresión, donde 0 es la calidad más mediocre (alta compresión) y 1 la mejor calidad (compresión baja). Este parámetro sólo se tiene en cuenta cuando el codec soporta la compresión (por ejemplo JPEG o HDPhoto) y es soportado por los APIs WIC y ImageIO.
Para mayor información sobre los APIs de gestión de imagen en 4D, consulte la sección Introducción a las imágenes. Por defecto, si omite el parámetro compresion, se aplica la mejor calidad (compresion =1).

Ejemplo 1

Conversión de la imagen vpFoto al formato jpeg:

CONVERT PICTURE(vpFoto;".jpg")

Ejemplo 2

Conversión de una imagen con calidad del 60%:

CONVERT PICTURE(vPicture;".JPG";0.6)

Ver también

PICTURE CODEC LIST