Texture2D
Hereda: Texture < Resource < RefCounted < Object
Heredado por: AnimatedTexture, AtlasTexture, CameraTexture, CanvasTexture, CompressedTexture2D, CurveTexture, CurveXYZTexture, DPITexture, ExternalTexture, GradientTexture1D, GradientTexture2D, ImageTexture, MeshTexture, NoiseTexture2D, PlaceholderTexture2D, PortableCompressedTexture2D, Texture2DRD, ViewportTexture
Textura para 2D y 3D.
Descripción
Una textura funciona registrando una imagen en el hardware de video, que luego puede ser usada en modelos 3D o 2D Sprite2D o GUI Control.
Las texturas se crean a menudo cargándolas desde un archivo. Véase @GDScript.load().
Texture2D es una base para otros recursos. No puede ser usado directamente.
Nota: El tamaño máximo de la textura es de 16384×16384 píxeles debido a las limitaciones del hardware de gráficos. Es posible que las texturas más grandes no se importen.
Métodos
void |
_draw(to_canvas_item: RID, pos: Vector2, modulate: Color, transpose: bool) virtual const |
void |
_draw_rect(to_canvas_item: RID, rect: Rect2, tile: bool, modulate: Color, transpose: bool) virtual const |
void |
_draw_rect_region(to_canvas_item: RID, rect: Rect2, src_rect: Rect2, modulate: Color, transpose: bool, clip_uv: bool) virtual const |
_get_height() virtual required const |
|
_get_width() virtual required const |
|
_has_alpha() virtual const |
|
_is_pixel_opaque(x: int, y: int) virtual const |
|
create_placeholder() const |
|
void |
draw(canvas_item: RID, position: Vector2, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const |
void |
draw_rect(canvas_item: RID, rect: Rect2, tile: bool, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const |
void |
draw_rect_region(canvas_item: RID, rect: Rect2, src_rect: Rect2, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false, clip_uv: bool = true) const |
get_height() const |
|
get_image() const |
|
get_size() const |
|
get_width() const |
|
has_alpha() const |
Descripciones de Métodos
void _draw(to_canvas_item: RID, pos: Vector2, modulate: Color, transpose: bool) virtual const 🔗
Se llama cuando se solicita que se dibuje la Texture2D completa sobre un CanvasItem, con el desplazamiento de la esquina superior izquierda especificado en pos. modulate especifica un multiplicador para los colores que se dibujan, mientras que transpose especifica si el dibujo debe realizarse en orden de columna principal en lugar de orden de fila principal (lo que resulta en una rotación de 90 grados en el sentido de las agujas del reloj).
Nota: Esto solo se usa en el renderizado en 2D, no en 3D.
void _draw_rect(to_canvas_item: RID, rect: Rect2, tile: bool, modulate: Color, transpose: bool) virtual const 🔗
Se llama cuando se solicita que se dibuje la Texture2D en el rect especificado de CanvasItem. modulate especifica un multiplicador para los colores que se dibujan, mientras que transpose especifica si el dibujo debe realizarse en orden de columna principal en lugar de orden de fila principal (lo que resulta en una rotación de 90 grados en el sentido de las agujas del reloj).
Nota: Esto solo se usa en el renderizado en 2D, no en 3D.
void _draw_rect_region(to_canvas_item: RID, rect: Rect2, src_rect: Rect2, modulate: Color, transpose: bool, clip_uv: bool) virtual const 🔗
Se llama cuando se solicita que una parte de la Texture2D especificada por las coordenadas de src_rect se dibuje en el rect especificado de CanvasItem. modulate especifica un multiplicador para los colores que se dibujan, mientras que transpose especifica si el dibujo debe realizarse en orden de columna principal en lugar de orden de fila principal (lo que resulta en una rotación de 90 grados en el sentido de las agujas del reloj).
Nota: Esto solo se usa en el renderizado en 2D, no en 3D.
int _get_height() virtual required const 🔗
Llamado cuando se consulta la altura de la Texture2D.
int _get_width() virtual required const 🔗
Llamado cuando se consulta el ancho de la Texture2D.
bool _has_alpha() virtual const 🔗
Llamado cuando se consulta la presencia de un canal alfa en la Texture2D.
bool _is_pixel_opaque(x: int, y: int) virtual const 🔗
Llamado cuando se consulta el estado opaco de un píxel en la Texture2D en la posición (x, y) especificada.
Resource create_placeholder() const 🔗
Crea una versión de marcador de posición de este recurso (PlaceholderTexture2D).
void draw(canvas_item: RID, position: Vector2, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const 🔗
Dibuja la textura utilizando un CanvasItem con la API RenderingServer en la position especificada.
void draw_rect(canvas_item: RID, rect: Rect2, tile: bool, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const 🔗
Dibuja la textura utilizando un CanvasItem con la API RenderingServer.
void draw_rect_region(canvas_item: RID, rect: Rect2, src_rect: Rect2, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false, clip_uv: bool = true) const 🔗
Dibuja una parte de la textura utilizando un CanvasItem con la API RenderingServer.
Devuelve la altura de la textura en píxeles.
Devuelve una Image que es una copia de los datos de esta Texture2D (se crea una nueva Image cada vez). Se puede acceder a las Images y manipularlas directamente.
Nota: Esto devolverá null si esta Texture2D no es válida.
Nota: Esto obtendrá los datos de la textura de la GPU, lo que podría causar problemas de rendimiento si se usa en exceso. Evita llamar a get_image() en cada fotograma, especialmente en texturas grandes.
Devuelve el tamaño de la textura en píxeles.
Devuelve el ancho de la textura en píxeles.
Devuelve true si este Texture2D tiene un canal alfa.