Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Line2D

Inherits: Node2D < CanvasItem < Node < Object

Una línea 2D.

Descripción

A line through several points in 2D space.

Note: By default, Godot can only draw up to 4,096 polygon points at a time. To increase this limit, open the Project Settings and increase ProjectSettings.rendering/limits/buffers/canvas_polygon_buffer_size_kb and ProjectSettings.rendering/limits/buffers/canvas_polygon_index_buffer_size_kb.

Tutoriales

Propiedades

bool

antialiased

false

LineCapMode

begin_cap_mode

0

Color

default_color

Color( 0.4, 0.5, 1, 1 )

LineCapMode

end_cap_mode

0

Gradient

gradient

LineJointMode

joint_mode

0

PoolVector2Array

points

PoolVector2Array(  )

int

round_precision

8

float

sharp_limit

2.0

Texture

texture

LineTextureMode

texture_mode

0

float

width

10.0

Curve

width_curve

Métodos

void

add_point ( Vector2 position, int at_position=-1 )

void

clear_points ( )

int

get_point_count ( ) const

Vector2

get_point_position ( int i ) const

void

remove_point ( int i )

void

set_point_position ( int i, Vector2 position )

Enumeraciones

enum LineJointMode:

  • LINE_JOINT_SHARP = 0 --- Las articulaciones de la línea serán puntiagudas. Si sharp_limit es mayor que la rotación de una articulación, se convierte en una articulación en bisel en su lugar.

  • LINE_JOINT_BEVEL = 1 --- Las uniones de la línea serán biseladas/chamfered.

  • LINE_JOINT_ROUND = 2 --- Las articulaciones de la línea serán redondeadas.


enum LineCapMode:

  • LINE_CAP_NONE = 0 --- No dibujes una cubierta de línea.

  • LINE_CAP_BOX = 1 --- Dibuja la cubierta de la línea como una caja.

  • LINE_CAP_ROUND = 2 --- Dibuja la cubierta de la línea como un círculo.


enum LineTextureMode:

  • LINE_TEXTURE_NONE = 0 --- Toma los píxeles izquierdos de la textura y la renderiza sobre toda la línea.

  • LINE_TEXTURE_TILE = 1 --- Tesela la textura sobre la línea. La textura debe ser importada con Repeat habilitado para que funcione correctamente.

  • LINE_TEXTURE_STRETCH = 2 --- Estira la textura a través de la línea. Importa la textura con Repeat desactivado para obtener mejores resultados.

Descripciones de Propiedades

Default

false

Setter

set_antialiased(value)

Getter

get_antialiased()

If true, the line's border will be anti-aliased.

Note: Line2D is not accelerated by batching when being anti-aliased.


Default

0

Setter

set_begin_cap_mode(value)

Getter

get_begin_cap_mode()

Controla el estilo del primer punto de la línea. Usa las constantes LineCapMode.


Default

Color( 0.4, 0.5, 1, 1 )

Setter

set_default_color(value)

Getter

get_default_color()

El color de la línea. No se usará si se establece un gradiente.


Default

0

Setter

set_end_cap_mode(value)

Getter

get_end_cap_mode()

Controla el estilo del último punto de la línea. Usa las constantes LineCapMode.


Setter

set_gradient(value)

Getter

get_gradient()

El gradiente se dibuja a través de toda la línea de principio a fin. El color por defecto no se usará si se establece un gradiente.


Default

0

Setter

set_joint_mode(value)

Getter

get_joint_mode()

El estilo de los puntos entre el comienzo y el final.


Default

PoolVector2Array(  )

Setter

set_points(value)

Getter

get_points()

The points that form the lines. The line is drawn between every point set in this array. Points are interpreted as local vectors.


  • int round_precision

Default

8

Setter

set_round_precision(value)

Getter

get_round_precision()

La suavidad de las articulaciones redondeadas y las cubiertas. Esto sólo se usa si una cubierta o articulación se establece como redonda.


Default

2.0

Setter

set_sharp_limit(value)

Getter

get_sharp_limit()

The direction difference in radians between vector points. This value is only used if joint_mode is set to LINE_JOINT_SHARP.


Setter

set_texture(value)

Getter

get_texture()

La textura usada para la textura de la línea. Utiliza texture_mode para el estilo de dibujo.


Default

0

Setter

set_texture_mode(value)

Getter

get_texture_mode()

El estilo para renderizar la texture en la línea. Usa las constantes de LineTextureMode.


Default

10.0

Setter

set_width(value)

Getter

get_width()

El ancho de la línea.


Setter

set_curve(value)

Getter

get_curve()

El ancho de la línea varía con la curva. El ancho original simplemente se multiplica por el valor de la curva.

Descripciones de Métodos

  • void add_point ( Vector2 position, int at_position=-1 )

Añade un punto en la position. Añade el punto al final de la línea.

Si se da at_position, el punto se inserta antes del número de punto at_position, desplazando ese punto (y todos los puntos posteriores) después del punto insertado. Si no se da at_position, o es un valor ilegal (at_position < 0 o at_position >= [method get_point_count]), el punto se añadirá al final de la lista de puntos.


  • void clear_points ( )

Elimina todos los puntos de la línea.


  • int get_point_count ( ) const

Devuelve la cantidad de puntos de Line2D.


Devuelve la posición del punto i.


  • void remove_point ( int i )

Elimina el punto en el índice i de la línea.


  • void set_point_position ( int i, Vector2 position )

Sobrescribe la posición en el punto i con la position suministrada.