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
Наследует: Texture < Resource < RefCounted < Object
Наследуется от: AnimatedTexture, AtlasTexture, CameraTexture, CanvasTexture, CompressedTexture2D, CurveTexture, CurveXYZTexture, DPITexture, DrawableTexture2D, ExternalTexture, GradientTexture1D, GradientTexture2D, ImageTexture, MeshTexture, NoiseTexture2D, PlaceholderTexture2D, PortableCompressedTexture2D, Texture2DRD, ViewportTexture
Текстура для 2D и 3D.
Описание
Текстура работает путем регистрации изображения в видеооборудовании, которое затем может использоваться в 3D-моделях или 2D Sprite2D или GUI Control.
Текстуры часто создаются путем загрузки их из файла. См. @GDScript.load().
Texture2D является базой для других ресурсов. Его нельзя использовать напрямую.
Примечание: Максимальный размер текстуры составляет 16384×16384 пикселей из-за ограничений графического оборудования. Большие текстуры могут не импортироваться.
Методы
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 |
Описания метода
void _draw(to_canvas_item: RID, pos: Vector2, modulate: Color, transpose: bool) virtual const 🔗
Вызывается, когда запрашивается отрисовка всего Texture2D поверх CanvasItem со смещением в левом верхнем углу, указанным в pos. modulate указывает множитель для отрисовываемых цветов, а transpose указывает, следует ли выполнять отрисовку в порядке столбцов вместо порядка строк (что приводит к повороту на 90 градусов по часовой стрелке).
Примечание: Это используется только в 2D-рендеринге, а не в 3D.
void _draw_rect(to_canvas_item: RID, rect: Rect2, tile: bool, modulate: Color, transpose: bool) virtual const 🔗
Вызывается, когда Texture2D запрашивается для рисования на указанном rect CanvasItem. modulate указывает множитель для рисуемых цветов, а transpose указывает, должно ли рисование выполняться в порядке столбцов вместо порядка строк (что приводит к повороту на 90 градусов по часовой стрелке).
Примечание: Это используется только в 2D-рендеринге, а не в 3D.
void _draw_rect_region(to_canvas_item: RID, rect: Rect2, src_rect: Rect2, modulate: Color, transpose: bool, clip_uv: bool) virtual const 🔗
Вызывается, когда часть Texture2D, указанная координатами src_rect, запрашивается для рисования на указанном rect CanvasItem. modulate указывает множитель для рисуемых цветов, а transpose указывает, должно ли рисование выполняться в порядке столбцов вместо порядка строк (что приводит к повороту на 90 градусов по часовой стрелке).
Примечание: Это используется только в 2D-рендеринге, а не в 3D.
Format _get_format() virtual const 🔗
Called when get_format() is called.
int _get_height() virtual required const 🔗
Вызывается при запросе высоты 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 🔗
Вызывается при запросе ширины Texture2D.
bool _has_alpha() virtual const 🔗
Вызывается при запросе наличия альфа-канала в Texture2D.
bool _has_mipmaps() virtual const 🔗
Called when has_mipmaps() is called.
bool _is_pixel_opaque(x: int, y: int) virtual const 🔗
Вызывается, когда запрашивается непрозрачное состояние пикселя в Texture2D в указанной позиции (x, y).
Resource create_placeholder() const 🔗
Создайте замещающую версию этого ресурса (PlaceholderTexture2D).
void draw(canvas_item: RID, position: Vector2, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const 🔗
Рисует текстуру, используя CanvasItem с API RenderingServer в указанной position.
void draw_rect(canvas_item: RID, rect: Rect2, tile: bool, modulate: Color = Color(1, 1, 1, 1), transpose: bool = false) const 🔗
Рисует текстуру, используя CanvasItem с 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 🔗
Рисует часть текстуры, используя CanvasItem с API RenderingServer.
Returns the image format of the texture.
Возвращает высоту текстуры в пикселях.
Возвращает Image, являющийся копией данных из этого Texture2D (каждый раз создается новый Image). К Image можно получать доступ и управлять ими напрямую.
Примечание: Это вернет null, если этот Texture2D недействителен.
Примечание: Это извлечет данные текстуры из графического процессора, что может вызвать проблемы с производительностью при чрезмерном использовании. Избегайте вызова get_image() в каждом кадре, особенно на больших текстурах.
int get_mipmap_count() const 🔗
Returns the number of mipmaps of the texture.
Возвращает размер текстуры в пикселях.
Возвращает ширину текстуры в пикселях.
Возвращает true, если у этого Texture2D есть альфа-канал.
Returns true if the texture has mipmaps.