AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones de dibujo / Tipos de variables
  • Propiedades específicas de las variables de tipo Image
  • Acceder a los pixeles
  • Gestión del canal Alfa
  • Variable de tipo Image y control Imagen
  • Variable de tipo Image y depurador
  • Crear una imagen con un tamaño específico
  • Etiquetas EXIF disponibles
  • Funciones que manipulan variables de tipo Image
  • Funciones (sintaxis con prefijo) que manipulan variables de tipo Image
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
El tipo Image permite definir las características avanzadas de una imagen. Las características de la imagen se pueden definir y cambiar mediante diferentes propiedades WLanguage.
Observación: Para obtener más información sobre la declaración de este tipo de variable y el uso de propiedades WLanguage, consulte Declarar una variable.
Ejemplo
MyImage is Image
MyImage.Width = 500
MyImage.Height = 100
// Load from a file
MyImage = dLoadImage("image.png")
// Equivalent syntaxes
// MyImage = "image.png"
// MyImage..Image = "image.png"

// Draw in the image
dStartDrawing(MyImage)

// Write a text
dFont("Arial", 12, iNormal, 0)
dText(4, 0, "Text in an Image control!")

// Resize
dResize(MyImage, 100, 100)

// End of drawing
dEndDrawing(MyImage)

// Assign to an Image control
IMG_ImageControl = MyImage
Observaciones

Propiedades específicas de las variables de tipo Image

Las siguientes propiedades pueden utilizarse para manipular variables de tipo Image:
Nombre de la propiedadTipo utilizadoEfecto
BitPerPixelEnteroNúmero de bits por pixel.
Esta propiedad es de solo lectura.
DrawingScaleRealEscala a utilizar para las funciones de dibujo (funciones dXXX): las coordenadas utilizadas por estas funciones se multiplicarán por este valor.
Java Esta propiedad no está disponible.
EXIF[Exif tag]Array asociativoPermite obtener y cambiar el contenido de la etiqueta Exif especificada. Las etiquetas Exif modificadas se pueden guardar utilizando la función dSaveImageJPEG con la constante imgSaveTag.
La propiedad Empty permite determinar si el contenido de la etiqueta Exif está vacío. Por ejemplo:
MyImage is Image
...
IF NOT MyImage.EXIF[320]..Empty THEN
IsTagValue = MyImage.EXIF[320]
END
Las etiquetas Exif disponibles se encuentran en la lista de Observaciones.
iPhone/iPadIOS WidgetMac CatalystJava Esta propiedad no está disponible.
FillColorVariable de tipo ColorColor de relleno de la imagen. Este color se utiliza:
  • al redimensionar la imagen (propiedades Height y Width).
  • al girar la imagen (dRotation).
HeightEnteroAltura de la imagen en pixeles.
Si se modifica esta propiedad, la imagen no se deforma: se agregan pixeles adicionales. El color de los pixeles se define con la propiedad FillColor.
ImageTodos los tiposPermite cargar una imagen desde un buffer, archivo o memo.. Esta propiedad equivale a dLoadImage.
Observaciones:
  • En modo de lectura, esta propiedad devuelve un buffer con la imagen en formato PNG.
  • Las imágenes en formato SVG o PDF no están soportadas. Para utilizar estos formatos, se debe utilizar la función dLoadImage.
  • Las imágenes animadas no están soportadas.
  • Solo se puede cargar una página de las imágenes multipágina (TIF, ICO). Solo se carga la primera página.
  • Se puede dibujar un gráfico en una variable de tipo Image utilizando la función grDestinationImage.
iPhone/iPadIOS WidgetMac Catalyst El formato ICO no es compatible con iOS.
Pixel[x,y]Array de ColorPermite manipular los pixeles de la imagen.
ValidBooleanoDevuelve la validez de la imagen:
  • True si la imagen es válida: se cargó o creó correctamente.
  • False en caso contrario.
Esta propiedad es de solo lectura.
WidthEnteroAncho de la imagen en pixeles.
Si se modifica esta propiedad, la imagen no se deforma: se agregan pixeles adicionales. El color de los pixeles se define con la propiedad FillColor.
WithAlphaBooleanoPermite saber si la imagen contiene un canal alfa:
  • True si la imagen contiene un canal alfa,
  • False en caso contrario.
Esta propiedad es de solo lectura.

Acceder a los pixeles

Para acceder a los pixeles de la imagen, se puede utilizar la siguiente sintaxis:
<Name of Image Variable>[<Horizontal coordinate>, <Vertical coordinate>]
El origen de las coordenadas es (0,0).
Por ejemplo:
// Modify the pixel at coordinates 220,300
MyImage[220,300] = LightYellow
También se pueden utilizar las propiedades de tipo Color directamente. Por ejemplo:
MyImage[220,300].Lightness = MyImage[220,300].Lightness + 10

Gestión del canal Alfa

Una imagen contiene un canal Alfa en los siguientes casos:
  • si se creó de forma predeterminada con un canal alfa, utilizando la propiedad FillColor.
  • si se cargó a partir de un formato de imagen que contiene un canal alfa (formato PNG, por ejemplo).
También se puede manipular el canal Alfa de la imagen manipulando los pixeles..

Variable de tipo Image y control Imagen

Es posible:
  • asignar una variable de tipo Image a un control Imagen.
  • asignar un control Imagen a una variable de tipo Image.
Estas operaciones están disponibles en los controles Imagen del editor de ventanas, páginas y reportes.

Variable de tipo Image y depurador

El contenido de una variable Image se puede ver en el depurador.

Crear una imagen con un tamaño específico

Para crear una imagen con un tamaño específico, se deben utilizar las propiedades Width y Height.
Por ejemplo:
MyImage is Image
MyImage.Width = 10
MyImage.Height = 10
La unidad utilizada es el pixel.
El siguiente código crea una imagen de 0 x 0.
MyImage is Image

Etiquetas EXIF disponibles

La tabla que aparece a continuación muestra los valores de las etiquetas Exif y las constantes correspondientes:
TagWLanguage constantValue
37510imgCommentCharacter string
Comments about the image
37122imgCompressionReal
Compression of the image in bits/pixel
33432imgCopyrightCharacter string
Copyright of the image
306imgDateDate
Date and time of the image in YYYY:MM:DD HH:MM:SS format
270imgDescriptionCharacter string
Image description
37382imgSubjectDistanceReal
Distance from the subject in meters
37380imgExposureBiasReal
Exposure bias in APEX
37385imgFlashInteger
Status of the flash during the shot:
  • 0: Flash not fired.
  • 1: Flash off.
  • 5: Flash triggered and return light not detected.
  • 7: Flash triggered and return light detected.
928imgHeightInteger
Image height in pixels
672imgWidthInteger
Image width in pixels
305imgRecordingSoftwareCharacter string
Name of the software that was used to record the image.
37386imgFocalLengthReal
Focal length in millimeters
37379imgBrightnessReal
Brightness of the image in APEX
271imgDeviceMarkCharacter string
Mark of the camera that took the photo
272imgDeviceModelCharacter string
Model of camera that took the photo
37383imgMeteringModeInteger
Metering mode:
  • 0: unknown.
  • 1: average.
  • 2: centered average.
  • 3: point.
  • 4: multipoint.
  • 5: motif.
  • 6: partial.
  • 7 to 254: reserved.
  • 255: other.
37500imgManufacturerNoteCharacter string
Name of the camera manufacturer
274imgOrientationInteger
Orientation of the image:
This information indicates the location of the point (0,0) in the image.
To display the image in the correct direction based on this information, use the following values:
  • 1: the point (0,0) is at the top left of the transformed image, so there's nothing to do.
  • 2: the point (0,0) is at the top right of the transformed image, so we need to perform vertical symmetry.
  • 3: the point (0,0) is at bottom right in the transformed image, so we need to perform horizontal and vertical symmetry.
  • 4: the point (0,0) is at bottom left in the transformed image, so we need to perform horizontal symmetry.
  • 5: the point (0,0) is on the left and at the top of the transformed image, so we need to perform a horizontal symmetry and a 90° rotation.
  • 6: the point (0,0) is on the right and at the top of the transformed image, so a 90° rotation is required.
  • 7: the point (0,0) is on the right and at the bottom of the transformed image, so we need to perform a vertical symmetry and a 90° rotation.
  • 8: the point (0,0) is on the left and at the bottom of the transformed image, so we need to rotate it by -90°.
37378imgApertureReal
Aperture in APEX
33437imgFApertureReal
Focal
37381imgMaxApertureReal
Maximum aperture in APEX
34850imgExposureProgramInteger
Exposure mode used during the shot:
  • 0: undefined.
  • 1: manual.
  • 2: normal.
  • 3: aperture priority.
  • 4: speed priority.
  • 5: creative.
  • 6: action.
  • 7: close-up portrait without background.
  • 8: landscape.
  • 9 to 255: other.
282imgXResolutionReal
Horizontal resolution of the image
283imgYResolutionReal
Vertical resolution of the image
37384imgLightSourceInteger
Light source for the image:
  • 0: unknown.
  • 1: daylight.
  • 2: fluorescent.
  • 3: tungsten.
  • 17: standard light A.
  • 18: standard light B.
  • 19: standard light C.
  • 20: D55.
  • 21: D65.
  • 22: D75.
  • 23 to 254: reserved.
  • 255: other.
33434imgExposureTimeReal
Exposure time
296imgResolutionUnitInteger
Unit for the horizontal and vertical resolution of the image:
  • 2: inches.
  • 3: centimetres.
36864imgEXIFVersionCharacter string
Version of Exif information
65536imgThumbnailBinary string
Thumbnail corresponding to the image
37377imgShutterSpeedReal
Shutter speed in APEX

Other tags are also available. These unlisted tags are specific to some types of cameras or correspond to custom tags.

Funciones que manipulan variables de tipo Image

AlbumSaveSaves an image, a photo or a video in the photo album of the mobile device.
BCToImageGenera la Image de un código de barras.
dAlphaBlendCombina dos imágenes. Esto permite crear un efecto de fundido entre 2 imágenes.
dArcDibuja un arco de círculo o un arco de elipse:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dBackgroundDeclares the default background color for the rectangles, circles, etc::
  • in an Image control,
  • in an Image variable,
  • in a WDPic variable (on the background layer),
  • in a picLayer variable.
dBlurDesenfoca toda el área determinada:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dBorderDibuja los bordes.
dChangeModeCambia el modo de dibujo utilizado por las funciones (dLine, dRectangle, etc.).
dChordDraws the chord of a circle (intersection between an ellipse and a straight line):
  • in an Image control,
  • in an Image variable,
  • in a WDPic variable (on the background layer),
  • in a picLayer variable.
dCircleDibuja un círculo o una elipse:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dCopyCopia una imagen en otra.
dCopyControlImageCopia la imagen de un control de una ventana WINDEV a una variable de tipo Image.
dCopyImageCopia una imagen:
  • de un control Imagen a otro control Imagen.
  • de una variable Image a otra variable Image.
dCopyScreenImageCopia el contenido de la pantalla en una variable de tipo Image o en un control Imagen.
dCopyWindowImageCopia la imagen de una ventana WINDEV en una variable de tipo Image o en un control Imagen.
dCropDevuelve la parte recortada de una imagen. Esta imagen se encuentra en una variable de tipo Image.
dDominantImageColorDevuelve el color dominante (es decir, el más frecuente) de una imagen en una variable de tipo Image o en un control Imagen.
dEncrustColorIncrusta un color en una imagen contenida en una variable de tipo Image. |- 0 | | dEndDrawing| | Elimina los dibujos realizados desde la última llamada a la función dStartDrawing. |- | | dFill| | Colorea un área: * en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dFontDeclara la fuente que utilizará la función dText:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dHaloAgrega un efecto de halo a una imagen en una variable de tipo Image. |- 0 | | dHorizontalSymmetry| | Voltea la imagen con respecto a un eje horizontal (simetría con respecto a un eje horizontal). |- | | DiagramToImage| | Exporta un diagrama a una variable de tipo Image. |- 0 | | dInvertColor| | Invierte los colores: * en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dLineDibuja una línea:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dLoadImageCarga una imagen en una variable de tipo Image a partir de un memo, archivo o buffer binario.
dModifyHSLModifica el tono, la saturación y la luminosidad de una imagen:
  • en un control Imagen,
  • en una variable de tipo Image.
dModifyHueModifica el tono de una imagen encontrada:
  • en un control Imagen,
  • en una variable de tipo Image.
dModifyLightnessCambia la luminosidad de una imagen:
  • en un control Imagen,
  • en una variable de tipo Image.
dModifyOpacityModifica la opacidad de una imagen (es decir, el canal alfa de la imagen).
dModifySaturationModifica la saturación de una imagen:
  • en un control Imagen,
  • en una variable de tipo Image.
DocAddAdds:
  • at the end of a word processing document: an element, document, paragraph, text, image or fragment.
  • at the end of a fragment: an element, text or image.
DocInsertInserts an object into a Word Processing document or replaces the content of the current fragment. The objects that can be used are:
  • an element,
  • a document,
  • a paragraph,
  • a text,
  • an image,
  • a fragment.
DocToImageExporta una página encontrada en un documento de tratamiento de texto en formato de imagen.
dPenDeclara el color y estilo predeterminado de las líneas, rectángulos y círculos, ... que se encuentran:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dPixelColorIdentifica el color de un pixel:
  • en un control Imagen.
  • en una variable de tipo Image.
  • en una variable de tipo picLayer.
  • en una variable de tipo 1000023503|WDPic 1000023503|WDPic.
dPixelOpacityIdentifica la opacidad de un pixel de una imagen que admite canales Alfa. Esta imagen puede ser:
  • un control Imagen,
  • una variable de tipo Image,
  • una variable de tipo WDPic (en la capa de fondo),
  • una variable de tipo picLayer.
dPointDibuja un punto:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dPolygonDraws a polygon:
  • in an Image control,
  • in an Image variable,
  • in a WDPic variable (on the background layer),
  • in a picLayer variable.
dPolylineDibuja una línea compuesta de varios segmentos.
dRectangleDibuja un rectángulo:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dRectangleGradientDraws a rectangle:
  • in an Image control,
  • in an Image variable,
  • in a WDPic variable (on the background layer),
  • in a picLayer variable.
dResizeRedimensiona una imagen:
dRoundedRectangleDibuja un rectángulo redondeado:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dSaveImageBMPGuarda una imagen:
  • en un archivo en formato BMP.
  • en la memoria.
dSaveImageGIFGuarda una imagen:
  • en un archivo en formato GIF.
  • en la memoria.
dSaveImageJPEGGuarda una imagen:
  • en un archivo JPEG.
  • en la memoria.
dSaveImagePNGGuarda una imagen:
  • en un archivo PNG.
  • en la memoria.
dShadowAgrega un efecto de sombra a una imagen en una variable de tipo Image. |- | | dSlice| | Draws a circle section or an ellipse section: * in an Image control,
  • in an Image variable,
  • in a WDPic variable (on the background layer),
  • in a picLayer variable.
dStartDrawingIndica que las funciones de dibujo que se utilizarán están destinadas a:
  • el control Imagen especificado,
  • la variable de tipo Image especificada,
  • la variable de tipo Image especificada,
  • la variable de tipo WDPic especificada (en la capa de fondo),
  • la variable de tipo picLayer especificada.
dTextDibuja un texto:
  • en un control Imagen,
  • en una variable de tipo Image,
  • en una variable de tipo WDPic (en la capa de fondo),
  • en una variable de tipo picLayer.
dTextRTFDibuja un texto RTF:
  • en un control Imagen,
  • en una variable de tipo Image.
dTransferToImageCrea una imagen a partir de un bufffer de pixeles codificado en un formato específico.
Esta función es avanzada. Esta función se utiliza principalmente para manipular imágenes devueltas por las API externas a través de variables de tipo Image.
dVerticalSymmetryVoltea la imagen con respecto a un eje vertical (simetría con respecto a un eje vertical).
grDestinationImageDefine una variable Imagen como destino de un gráfico.
grSaveImageGuarda la imagen de un gráfico en una variable de tipo Image.
iImageHeightCalculates the height of the image to print (in millimeters).
iImageWidthCalculates the width of the image to print (in millimeters).
iPrintImageSends the image file to print to the print buffer.
PDFExtractPageExtrae una página de un archivo PDF en una variable de tipo Image.
PortapapelesRecupera el texto o la imagen que se encuentra en el portapapeles del sistema.
ToClipboardWrites text or image information into the system clipboard.

Funciones (sintaxis con prefijo) que manipulan variables de tipo Image

<Image variable>.ChangeModeCambia el modo de dibujo utilizado por las funciones (dLine, dRectangle, etc.).
<Image variable>.CopyCopia una imagen en otra.
<Image variable>.CropDevuelve la parte recortada de una imagen. Esta imagen se encuentra en una variable de tipo Image.
<Image variable>.DominantImageColorDevuelve el color dominante (es decir, el color más frecuente) de una imagen contenida en una variable de tipo Image.
<Image variable>.DrawArcDibuja el arco de un círculo o de una elipse en una variable tipo Image.
<Image variable>.DrawBorderDibuja los bordes en una variable de tipo Image.
<Image variable>.DrawChordDibuja la cuerda de un círculo (inserción entre una elipse y una línea recta) en una variable de tipo Image.
<Image variable>.DrawCircleDibuja un círculo o una elipse en una variable de tipo Image.
<Image variable>.DrawHaloAgrega un efecto de halo a una imagen en una variable de tipo Image. |- | | <Image variable>.DrawLine| | Dibuja una línea en una variable de tipo Image. |- | | <Image variable>.DrawPoint| | Dibuja un punto en una variable de tipo Image. |- | | <Image variable>.DrawPolygon| | Dibuja un polígono en una variable de tipo Image. |- | | <Image variable>.DrawRectangle| | Dibuja un rectángulo en una variable de tipo Image. |- | | <Image variable>.DrawRectangleGradient| | Dibuja un rectángulo en una variable de tipo Image. |- | | <Image variable>.DrawRoundedRectangle| | Dibuja un rectángulo redondeado en una variable de tipo Image. |- | | <Image variable>.DrawShadow| | Agrega un efecto de sombra a una imagen en una variable de tipo Image. |- | | <Image variable>.DrawSlice| | Dibuja un sector de círculo o elipse en una variable de tipo Image. |- | | <Image variable>.DrawText| | Dibuja un texto en una variable de tipo Image. |- | | <Image variable>.DrawTextRTF| | Dibuja un texto RTF en una variable de tipo Image. |- | | <Image variable>.EncrustColor| | Incrusta un color en una imagen contenida en una variable de tipo Image. |- | | <Image variable>.Fill| | Colorea un área en una variable de tipo Image. |- | | <Image variable>.HorizontalSymmetry| | Voltea la imagen de una variable de tipo Image con respecto a un eje horizontal (simetría con respecto a un eje horizontal). |- | | <Image variable>.InvertColor| | Invierte los colores en una variable de tipo Image. |- | | <Image variable>.ModifyHSL| | Modifica el tono, la saturación y la luminosidad de una imagen en una variable de tipo Image. |- | | <Image variable>.ModifyHue| | Modifica el tono de una imagen en una variable de tipo Image. |- | | <Image variable>.ModifyLightness| | Modifica la luminosidad de una imagen en una variable de tipo Image. |- | | <Image variable>.ModifyOpacity| | Modifica la opacidad de una imagen (es decir, el canal alfa de la imagen). |- | | <Image variable>.ModifySaturation| | Modifica la saturación de una imagen en una variable de tipo Image. |- | | <Image variable>.PixelColor| | Identifica el color de un pixel en una variable de tipo Image. |- | | <Image variable>.PixelOpacity| | Identifica la opacidad de un pixel de una imagen (en una variable de tipo Image) que admite canales Alfa. |- | | <Image variable>.Resize| | Redimensiona una imagen en una variable de tipo Image. |- | | <Image variable>.Rotation| | Gira una imagen en una variable de tipo Image. |- | | <Image variable>.SaveBMP| | Guarda una imagen contenida en una variable de tipo Image:* en un archivo en formato BMP.* en la memoria. |- | | <Image variable>.SaveGIF| | Guarda una imagen en una variable de tipo Image:* en un archivo en formato GIF.
  • en la memoria.
<Image variable>.SaveJPEGGuarda una imagen en una variable de tipo Image:
  • en un archivo JPEG.
  • en la memoria.
<Image variable>.SavePNGGuarda una imagen en una variable de tipo Image:
  • en un archivo PNG.
  • en la memoria.
<Image variable>.StartDrawingIndica que las funciones de dibujo que se utilizarán están destinadas a una variable de tipo Image.
<Image variable>.VerticalSymmetryVoltea la imagen de una variable de tipo Image con respecto a un eje vertical (simetría con respecto a un eje vertical).
<Variable Image>.BackgroundDeclara el color de fondo predeterminado de los rectángulos y círculos, ... utilizados en una variable de tipo Image.
<Variable Image>.DrawPolylineDibuja una línea compuesta de varios segmentos en una variable de tipo Image.
<Variable Image>.FontDeclara la fuente que utilizará la función dText en una variable de tipo Image.
<Variable Image>.PenDeclara el color y estilo predeterminado de las líneas, rectángulos y círculos, ... que se encuentran en una variable de tipo Image.
Versión mínima requerida
  • Versión 17
Esta página también está disponible para…
Comentarios
 image clip vidéo
https://youtu.be/A3x_45AOsPE

// image clip vidéo

// recortar imagen
amarildo
06 01 2019

Última modificación: 17/06/2024

Señalar un error o enviar una sugerencia | Ayuda local