dPolygon (Function)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

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

Coordinates
Drawing with opacity or anti-aliasing
Uso de las funciones de dibujo
Dibujo en PHP
Dibujo en código Navegador

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

dPolygon (Function)

Draws a polygon:

in an Image control,
in a variable of type Image.
This type of variable is not available.
in a variable of type WDPic (on the background layer),
in a variable of type picLayer.

Caution: In Linux, this function requires a specific configuration. For more details, see Drawing in WINDEV, WEBDEV and WINDEV Mobile.

Ejemplo

Ver ejemplos adicionales

// Initialize the drawing in an Image control
dStartDrawing(IMG_Drawing)
// Draw a 4-side polygon whose
// background is light yellow and whose border is light blue
dPolygon(4, 10, 20, 20, 50, 40, 60, 50, 10, LightYellow, LightBlue)

// Draw a 4-side polygon whose 
// background is light yellow and whose border is light blue
dPolygon(IMG_Drawing, 4, 10, 20, 20, 50, 40, 60, 50, 10, LightYellow, LightBlue)

// Draw a polygon from an array of point coordinates
arrCoordinatesXY is array of 0 by 2 int = [[2, 3], [14, 100], [10,70], [50, 80]]
dPolygon(arrCoordinatesXY)
arrCoordinatesXY2 is array of 0 int = [2, 2, 140, 2, 150, 70, 0, 100, 200,100]
dPolygon(arrCoordinatesXY2)
arrCoordinatesXYC is array of 36 by 2 int
Radius is int = 50
FOR I = 1 TO 36
	// x
	arrCoordinatesXYC[I][1] = 80 + Cos(I*10) * Radius
	// y
	arrCoordinatesXYC[I][2] = 60 + Sin(I*10) * Radius
END
dPolygon(arrCoordinatesXYC, LightGray, TooltipYellow)

Sintaxis

Building a polygon point by point Ocultar los detalles

dPolygon([<Image>, ] <Number of sides> , <X1> , <Y1> , <X2> , <Y2> [, <X3> , <Y3> [... [, <Xn> , <Yn>]]] [, <Background color> [, <Side color>]])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. This image can correspond to:
the name of an Image control.
the name of a variable of type Image.
the name of a variable of type WDPic. Only the background layer will be handled.
the name of a variable of type picLayer.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Number of sides>: Integer

Number of sides in the polygon (up to 23 sides). This parameter defines the number of <X>, <Y> pairs to specify in the function.

<X1>: Integer

X-coordinate of first point of the polygon. These coordinates are expressed in pixels.

<Y1>: Integer

Y-coordinate of first point of the polygon. These coordinates are expressed in pixels.

<X2>: Integer

X-coordinate of second point of the polygon. These coordinates are expressed in pixels.

<Y2>: Integer

Y-coordinate of second point of the polygon. These coordinates are expressed in pixels.

<X3>: Integer

X-coordinate of 3rd point of the polygon. These coordinates are expressed in pixels.

<Y3>: Integer

Y-coordinate of 3rd point of the polygon. These coordinates are expressed in pixels.

<Xn>: Optional integer

X-coordinate of nth point of the polygon. These coordinates are expressed in pixels.

<Yn>: Optional integer

Y-coordinate of nth point of the polygon. These coordinates are expressed in pixels.

<Background color>: Integer or constant (optional)

Polygon background color. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.
If this parameter is not specified, the background color:
is Transparent if dBackground has not been used beforehand,
corresponds to the color specified in the last call to dBackground.

<Side color>: Integer or constant (optional)

Color of polygon sides. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color.
If this parameter is not specified, the line color:
is Transparent if dPen has not been previously used.
For a variable of type Image, the line will be black.
corresponds to the color specified in the last call to dPen.

Building a polygon via an array of X and Y-coordinates Ocultar los detalles

dPolygon([<Image>, ] <Array of coordinates> [, <Background color> [, <Side color>]])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. This image can correspond to:
the name of an Image control.
the name of a variable of type Image.
the name of a variable of type WDPic. Only the background layer will be handled.
the name of a variable of type picLayer.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Array of coordinates>: Array of integers or array of points

WLanguage array of integers containing the coordinates of polygon points. The even indexes represent the X-coordinates while the odd indexes represent the Y-coordinates of the points. These coordinates are expressed in pixels.
WLanguage array of Point variables containing the coordinates of the polygon points. These coordinates are expressed in pixels.

<Background color>: Integer or constant (optional)

Polygon background color. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color.
If this parameter is not specified, the background color:
is Transparent if dBackground has not been used beforehand,
corresponds to the color specified in the last call to dBackground.

<Side color>: Integer or constant (optional)

Color of polygon sides. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color.
If this parameter is not specified, the line color:
is Transparent if dPen has not been previously used.
For a variable of type Image, the line will be black.
corresponds to the color specified in the last call to dPen.

Building a polygon from a variable of type Polygon Ocultar los detalles

dPolygon([<Image>, ] <Polygon> [, <Background color> [, <Side color>]])

<Image>: Optional control name or optional Image, WDPic or picLayer variable

Image to use. This image can correspond to:
the name of an Image control.
the name of a variable of type Image.
the name of a variable of type WDPic. Only the background layer will be handled.
the name of a variable of type picLayer.
If this parameter is not specified, it is necessary to define the drawing destination with dStartDrawing.

<Polygon>: Polygon variable

Name of the Polygon variable that describes the different points of the polygon.

<Background color>: Integer or constant (optional)

Polygon background color. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color.
If this parameter is not specified, the background color:
is Transparent if dBackground has not been used beforehand,
corresponds to the color specified in the last call to dBackground.

<Side color>: Integer or constant (optional)

Color of polygon sides. This color can correspond to:
an RGB color (returned by RGB),
an HSL color (returned by HSL),
a WLanguage preset color,
a variable of type Color.
If this parameter is not specified, the line color:
is Transparent if dPen has not been previously used.
For a variable of type Image, the line will be black.
corresponds to the color specified in the last call to dPen.

Observaciones

Coordinates

Drawing a polygon:

dPolygon(5, 80, 10, 10, 150, 100, 200, 160, 80, 140, 40)

Coordinates are specified with respect to the upper-left corner of the image (coordinates: (0.0)).

Important You don't need to close the polygon (the coordinates of the last point don't have to be equal to the coordinates of the first point). The polygon is automatically "closed".

Limits A polygon can have a maximum of 100,000 points in WINDEV, WEBDEV and Java, and 1,000 points in Windows CE.

Drawing with opacity or anti-aliasing

In the case of drawing with opacity (function dStartDrawing with constant dWithOpacity) or anti-aliasing (function dChangeMode with constant drawingAntiAliasing), the outline is drawn on top of the polygon interior: the line is therefore partly combined with the polygon interior. If the line is very thick, it will be displayed in two colors.

Uso de las funciones de dibujo

Las funciones de dibujo se pueden utilizar según 2 métodos:

Método 1: Uso de la función dStartDrawing
- 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) 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 dStartDrawing o CallDLL32), pero estas funciones deben utilizar el DC (Device Context) devuelto por la función API.
  - las funciones dEndDrawing y dStartDrawing no deben llamarse 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.
Método 2: indicar el destino del dibujo directamente en la sintaxis (mediante un parámetro)
El parámetro <Imagen> permite especificar directamente el destino del dibujo. Ya no es necesario utilizar dStartDrawing. Esta función debe ser eliminada.

Dibujo en PHP

En PHP, las funciones de dibujo se basan en la biblioteca gráfica GD. Esta biblioteca es comúnmente utilizada por los servicios de alojamiento PHP, y por lo tanto, siempre está habilitada. La versión de la biblioteca GD debe ser la versión 2.0.28 (o posterior). Esta biblioteca se puede descargar desde el sitio web de PHP.

Para habilitar (si es necesario) esta biblioteca en el equipo local, se requieren los siguientes elementos:

PHP instalado.
el archivo PHP.INI ubicado en el directorio de Windows debe tener la línea "extension=php_gd2.dll" y no ";extension=php_gd2.dll".
el archivo php_gd2.dll debe existir en el directorio de extensiones PHP. Este directorio está definido en el archivo PHP.INI por la variable "extension_dir".

Dibujo en código Navegador

Algunas funciones de dibujo están disponibles en código Navegador. Las funciones de dibujo en código Navegador se basan en el estándar HTML 5. Más concretamente, en la etiqueta "canvas" de HTML 5.

Las funcionalidades de dibujo en código Navegador solo están disponibles en navegadores recientes (compatibles con el estándar HTML 5). Para saber si el navegador utilizado propone funcionalidades de dibujo, utilice la función DrawingAvailable.

Atención: Para utilizar las funciones de dibujo con Internet Explorer 9, el proyecto debe incluir la referencia en el archivo DTD. Para ello, el modo HTML debe ser "HTML 4.01 Transitional + DTD". Esta opción está disponible en la pestaña "Avanzado" de la ventana de descripción del proyecto.
Recordatorio: Para abrir la ventana de descripción del proyecto, en la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".

Caso especial: Dibujar en el navegador de un teléfono Android: Las funciones de dibujo del navegador solo están disponibles a partir de la versión 3 de Android.

Clasificación Lógica de negocio / UI: Código neutro

Componente: wd300pnt.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: 30/05/2025

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