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 є базою для інших ресурсів. Не можна використовувати безпосередньо.
Note: Максимальний розмір текстури 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 запитується на CanvasItem вказаний ct. 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, запитується на CanvasItem, вказаний ct. modulate визначає мультиплікатор для фарб, що мальуються, при цьому transpose визначає, чи слід виконувати малюнок у стовпці-маджорному порядку замість замовлення рядка-маджор (регуляція в 90-градусний годинниковий поворот).
Примітка: Це тільки використовується в 2D рендерингу, не 3D.
Format _get_format() virtual const 🔗
Викликається під час виклику методу get_format().
int _get_height() virtual required const 🔗
Зателефоновано при висоті Texture2D.
Image _get_image() virtual const 🔗
Викликається під час виклику методу get_image().
int _get_mipmap_count() virtual const 🔗
Викликається під час виклику методу get_mipmap_count().
int _get_width() virtual required const 🔗
Зателефоновано, коли ширина Texture2D передається.
bool _has_alpha() virtual const 🔗
Зателефоновано при наявності альфа-каналу в Texture2D передається.
bool _has_mipmaps() virtual const 🔗
Викликається під час виклику методу has_mipmaps().
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 за вказаною пам'ячою позицією.
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.
Повертає формат зображення текстури.
Повертає висоту текстури в пікселів.
Повертає Image, що є копією даних з цього Texture2D (щоразу створюється новий Image). До Image можна отримати доступ та маніпулювати ними безпосередньо.
Примітка: Це поверне null, якщо цей Texture2D недійсний.
Примітка: Це призведе до отримання даних текстури з графічного процесора, що може спричинити проблеми з продуктивністю при надмірному використанні. Уникайте виклику get_image() кожного кадру, особливо на великих текстурах.
int get_mipmap_count() const 🔗
Повертає кількість міпмапів текстури.
Повертає розмір текстури в пікселів.
Повертає ширину текстури в пікселів.
Повертає true, якщо це Texture2D має альфа-канал.
Повертає true, якщо текстура має міп-мапи.