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.
Checking the stable version of the documentation...
Texture2D
Hereda: Texture < Resource < RefCounted < Object
Heredado por: AnimatedTexture, AtlasTexture, CameraTexture, CanvasTexture, CompressedTexture2D, CurveTexture, CurveXYZTexture, DPITexture, DrawableTexture2D, 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_format() virtual const |
|
_get_height() virtual required const |
|
_get_image() virtual const |
|
_get_mipmap_count() virtual const |
|
_get_width() virtual required const |
|
_has_alpha() virtual const |
|
_has_mipmaps() 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_format() const |
|
get_height() const |
|
get_image() const |
|
get_mipmap_count() const |
|
get_size() const |
|
get_width() const |
|
has_alpha() const |
|
has_mipmaps() 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.
Format _get_format() virtual const 🔗
Called when get_format() is called.
int _get_height() virtual required const 🔗
Llamado cuando se consulta la altura de la Texture2D.
Image _get_image() virtual const 🔗
Called when get_image() is called.
int _get_mipmap_count() virtual const 🔗
Called when get_mipmap_count() is called.
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 _has_mipmaps() virtual const 🔗
Called when has_mipmaps() is called.
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.
Returns the image format of the texture.
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.
int get_mipmap_count() const 🔗
Returns the number of mipmaps of the texture.
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.
Returns true if the texture has mipmaps.