dStartDrawing (Función)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones de dibujo

Casos especiales
Dibujo con opacidad
Función dStartDrawing, barras de desplazamiento y zoom automáticos

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

dStartDrawing (Función)

Indica que las funciones de dibujo que se utilizarán están destinadas a:

el control Imagen especificado,
una variable de tipo Image.
una variable de tipo WDPic (en la capa de fondo),
una variable de tipo picLayer.

Observación: La función dStartDrawing inicializa todos los parámetros necesarios para crear un dibujo de un elemento determinado.

Atención: Se requiere una configuración específica para usar esta función en Linux. Para obtener más información, consulte Los dibujos.

Ejemplo

// Start drawing in the "IMG_ImageDrawing" control
ResDrawing = dStartDrawing(IMG_ImageDrawing)
// Drawings performed in the "IMG_ImageDrawing" control
...
// End of drawing in the "IMG_ImageDrawing" control

dStartDrawing(IMG_Image1)
dFont("Arial", 12, iNormal, 0)
dText(4, 0, "Text in an Image control!")

Sintaxis

Iniciar un dibujo en un control Imagen Ocultar los detalles

<Result> = dStartDrawing(<Image control> [, <Options>])

<Result>: Entero del sistema

DC (device context) memoria del control Imagen,
0 si se produce un error. Este parámetro se puede utilizar para llamar a las rutinas de sistema (funciones de la API de Windows). En este caso, recomendamos utilizar un system integer.
Caso especial:
1 si la operación se realiza con éxito,
0 si se produce un error.

<Image control>: Nombre del control

Nombre del control Imagen en el que se realizará el dibujo.

<Options>: Constante o combinación de constantes de tipo Integer (opcional)

Opciones de dibujo:
dDisplayAsynchronous
dDisplayManual
dErase
(Valor predeterminado) Borra el dibujo del control Imagen.
dGridlinesOpacity El dibujo se muestra sobre las líneas de cuadrícula para resaltar las secciones transparentes o semitransparentes del dibujo. Las líneas de cuadrícula no se guardan en la imagen.
Esta constante no está disponible.
dNoErase No borra el dibujo del control Imagen.
dOnChart Permite dibujar en un control Imagen en el que ya se ha dibujado un gráfico. En este caso, no se borra el dibujo del gráfico.
Esta constante no está disponible.
dWithOpacity Permite gestionar la opacidad en las funciones de dibujo utilizadas con el control Imagen. Permite, por ejemplo, crear un dibujo guardado en formato PNG con canales alfa.

Iniciar un dibujo en una variable de tipo Image, WDPic o picLayer Ocultar los detalles

<Result> = dStartDrawing(<Element> [, <Options>])

<Result>: Booleano

True si se inicializó el dibujo,
False en caso contrario.

<Element>: Variable de tipo Image, WDPic o picLayer

Nombre de una variable:
de tipo Image.
de tipo WDPic. Solo se manipulará la capa de fondo.
de tipo picLayer.

<Options>: Constante o combinación de constantes de tipo Integer (opcional)

Opciones de dibujo:
dGridlinesOpacity El dibujo se muestra sobre las líneas de cuadrícula para resaltar las secciones transparentes o semitransparentes del dibujo. Las líneas de cuadrícula no se guardan en la imagen.
Esta constante no está disponible.
dNoErase No borra el dibujo de la variable.
dOnChart Permite dibujar en una variable en la que ya se ha dibujado un gráfico. En este caso, no se borra el dibujo del gráfico.
Esta constante no está disponible.
dWithOpacity Permite gestionar la opacidad en las funciones de dibujo utilizadas con la variable. Permite, por ejemplo, crear un dibujo guardado en formato PNG con canales alfa.

Si no se especifica este parámetro, no se utiliza ninguna opción de dibujo.

Observaciones

Casos especiales

Se debe llamar a la función dStartDrawing antes de utilizar otras funciones de dibujo. La función dStartDrawing permite definir el elemento (control Imagen o variable de tipo Image) en el que se aplicarán las funciones de dibujo.
Al dibujar en un control Imagen:
- las funciones de dibujo trabajan en una copia ("bitmap") de la imagen. Se pueden utilizar las funciones de dibujo de Windows (con la función API o CallDLL32), pero estas funciones deben utilizar el DC (Device Context) devuelto por la función dStartDrawing.
- no se debe llamar a las funciones dEndDrawing y dStartDrawing en el mismo proceso. Si se llama a las funciones dEndDrawing y dStartDrawing en el mismo proceso, no se mostrará el dibujo: se borrará automáticamente.

Dibujo con opacidad

Al crear un dibujo que admita la opacidad, puede guardar fácilmente imágenes PNG con canales alfa.

Para guardar un dibujo PNG con canales Alfa:

Utilice la función dStartDrawing. Esta función permite definir, si es necesario, el elemento sobre el que se aplicarán las funciones de dibujo, así como el modo de dibujo. La constante dWithOpacity indica que el dibujo gestionará la opacidad. La constante dGridlinesOpacity permite mostrar una cuadrícula debajo de las diferentes áreas del dibujo.

Configure la opacidad de los dibujos con las siguientes funciones:


dBackground	Declara el color de fondo y su opacidad para los siguientes dibujos.
dPoint	Declara el color de los puntos y su opacidad para los siguientes dibujos.
dPen	Declara el color de las líneas y su opacidad para los siguientes dibujos.

Observación: La función dPixelOpacity permite conocer la opacidad de un punto.

Utilice la función dSaveImagePNG para guardar el dibujo en formato PNG con canales alfa (opacidad).

Limite: En modo "Gestión de la opacidad", la función dText se limita al uso de fuentes True Type.

Función dStartDrawing, barras de desplazamiento y zoom automáticos

La opción "Barras de desplazamiento y zoom automáticos", disponible en los controles Imagen, no es compatible con la función dStartDrawing. Si se utiliza esta opción en el control Imagen, la función dStartDrawing inmoviliza la imagen. El zoom y las barras de desplazamiento también se inmovilizan. El comportamiento estándar se restablece al llamar a la función dEndDrawing.

Componente: wd290pnt.dll

Ver también

Versión mínima requerida

Versión 9

Esta página también está disponible para…

Comentarios

Haga clic en [Agregar] para publicar un comentario

Última modificación: 18/01/2024

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