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...

DPITexture

Экспериментальное: This class may be changed or removed in future versions.

Наследует: Texture2D < Texture < Resource < RefCounted < Object

Автоматически масштабируемая Texture2D на основе изображения SVG.

Описание

Автоматически масштабируемая Texture2D на основе изображения SVG. DPITexture используются для автоматической перерастеризации значков и других элементов темы пользовательского интерфейса на основе текстур в соответствии с масштабом области просмотра и передискретизацией шрифтов. См. также ProjectSettings.display/window/stretch/mode (режим "canvas_items") и Viewport.oversampling_override.

Свойства

float

base_scale

1.0

Dictionary

color_map

{}

bool

fix_alpha_border

false

bool

premult_alpha

false

bool

resource_local_to_scene

false (overrides Resource)

float

saturation

1.0

Методы

DPITexture

create_from_string(source: String, scale: float = 1.0, saturation: float = 1.0, color_map: Dictionary = {}) static

RID

get_scaled_rid() const

String

get_source() const

void

set_size_override(size: Vector2i)

void

set_source(source: String)

Описания свойств

float base_scale = 1.0 🔗

  • void set_base_scale(value: float)

  • float get_base_scale()

Масштаб текстуры. 1.0 — исходный размер SVG. Более высокие значения приводят к увеличению размера изображения.

Dictionary color_map = {} 🔗

Если установлено, переназначает цвета текстуры в соответствии с картой Color-Color.

bool fix_alpha_border = false 🔗

  • void set_fix_alpha_border(value: bool)

  • bool get_fix_alpha_border()

Если true, пиксели одного и того же окружающего цвета переходят из прозрачных областей в непрозрачные. Для текстур, отображаемых с помощью билинейной фильтрации, это помогает уменьшить эффект контура при экспорте изображений из графического редактора.

bool premult_alpha = false 🔗

  • void set_premult_alpha(value: bool)

  • bool get_premult_alpha()

Альтернативой исправлению затемненных границ с помощью fix_alpha_border является использование предварительно умноженного альфа-канала. Включив эту опцию, текстура будет преобразована в этот формат. Для корректного отображения текстуры с предварительно умноженным альфа-каналом требуются определенные материалы:

  • В 2D необходимо создать и настроить CanvasItemMaterial для использования режима смешивания CanvasItemMaterial.BLEND_MODE_PREMULT_ALPHA для CanvasItem, использующих эту текстуру. В пользовательских шейдерах canvas_item следует использовать render_mode blend_premul_alpha;.

  • В 3D необходимо создать и настроить BaseMaterial3D для использования режима смешивания BaseMaterial3D.BLEND_MODE_PREMULT_ALPHA для материалов, использующих эту текстуру. В пользовательских spatial шейдерах следует использовать параметр render_mode blend_premul_alpha;.

float saturation = 1.0 🔗

  • void set_saturation(value: float)

  • float get_saturation()

Переопределяет насыщенность текстуры.

Описания метода

DPITexture create_from_string(source: String, scale: float = 1.0, saturation: float = 1.0, color_map: Dictionary = {}) static 🔗

Создает новый DPITexture и инициализирует его, выделяя и устанавливая данные SVG в source.

RID get_scaled_rid() const 🔗

Возвращает RID текстуры, растеризированной для соответствия избыточной выборке текущего нарисованного элемента холста.

String get_source() const 🔗

Возвращает исходный код этой SVG-текстуры.

void set_size_override(size: Vector2i) 🔗

Изменяет размер текстуры до указанных размеров.

void set_source(source: String) 🔗

Задает исходный код этой SVG-текстуры.