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.

ResourceImporterSVG

Успадковує: ResourceImporter < RefCounted < Object

Імпортує SVG-файл як автоматично масштабовану текстуру для використання в елементах інтерфейсу користувача та 2D-рендерингу.

Опис

Цей імпортер імпортує ресурси DPITexture. Див. також ResourceImporterTexture та ResourceImporterImage.

Властивості

float

base_scale

1.0

Dictionary

color_map

{}

bool

compress

true

bool

fix_alpha_border

false

bool

premult_alpha

false

float

saturation

1.0


Описи властивостей

float base_scale = 1.0 🔗

Масштаб текстури. 1.0 – це оригінальний розмір SVG. Вищі значення призводять до більшого зображення.


Dictionary color_map = {} 🔗

Якщо встановлено, перерозподіляє кольори текстур відповідно до карти Color-Color.


bool compress = true 🔗

Якщо true, для джерела SVG використовується стиснення без втрат.


bool fix_alpha_border = false 🔗

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


bool premult_alpha = false 🔗

Альтернативою виправленню затемнених країв за допомогою fix_alpha_border є використання альфа-каналу з попереднім множенням. Увімкнувши цю опцію, текстура буде перетворена у цей формат. Для коректного відображення текстури з попереднім множенням альфа-каналу необхідні спеціальні матеріали:

  • У 2D потрібно створити CanvasItemMaterial і налаштувати його на використання режиму змішування CanvasItemMaterial.BLEND_MODE_PREMULT_ALPHA на CanvasItems, які використовують цю текстуру. У власних шейдерах canvas_item слід використовувати render_mode blend_premul_alpha;.

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


float saturation = 1.0 🔗

Замінює насиченість текстури.