SubViewport

Успадковує: Viewport < Node < Object

Інтерфейс до ігрового світу, який не створює вікна або малюйте екран безпосередньо.

Опис

SubViewport Виокремлює прямокутну область сцени для незалежного відображення. Це можна використовувати, наприклад, для відображення інтерфейсу користувача в 3D-просторі.

Примітка: SubViewport — це Viewport, який не є Window, тобто сам по собі нічого не малює. Щоб відобразити будь-що, SubViewport має мати відмінний від нуля розмір і бути поміщеним у SubViewportContainer або призначеним ViewportTexture.

Примітка: InputEvent не передаються до окремого SubViewport за замовчуванням. Щоб забезпечити поширення InputEvent, SubViewport можна розмістити всередині SubViewportContainer.

Посібники

• Використання портів

• Перетворення вікна перегляду та полотна

• Графічний інтерфейс у 3D Viewport Demo

• 3D в 2D Viewport Демо

• 2D в 3D Viewport Demo

• Екран Capture Demo

• Динамічний дисплей екрану

• 3D дозвіл Scaling демо

Властивості

ClearMode	render_target_clear_mode	0
UpdateMode	render_target_update_mode	2
Vector2i	size	Vector2i(512, 512)
Vector2i	size_2d_override	Vector2i(0, 0)
bool	size_2d_override_stretch	false

---

Переліки

enum ClearMode: 🔗

ClearMode CLEAR_MODE_ALWAYS = 0

Завжди очищаємо від рендерної цілі перед кресленням.

ClearMode CLEAR_MODE_NEVER = 1

Ніколи не очищайте цільову пропозицію рендеру.

ClearMode CLEAR_MODE_ONCE = 2

Очистити подачу на наступну раму, потім перейти до CLEAR_MODE_NEVER.

---

enum UpdateMode: 🔗

UpdateMode UPDATE_DISABLED = 0

Не оновлюється мета рендеру.

UpdateMode UPDATE_ONCE = 1

Оновити подачу раз, потім перейти до UPDATE_DISABLED.

UpdateMode UPDATE_WHEN_VISIBLE = 2

Оновлення цілі рендерингу тільки при його видимості. Це значення за замовчуванням.

UpdateMode UPDATE_WHEN_PARENT_VISIBLE = 3

Оновлення цілі рендеру лише тоді, коли його батько видно.

UpdateMode UPDATE_ALWAYS = 4

Завжди оновлюється мета рендеру.

---

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

ClearMode render_target_clear_mode = 0 🔗

• void set_clear_mode(value: ClearMode)

• ClearMode get_clear_mode()

Чистий режим, коли суб-перевізник використовується в якості цільового рендеру.

Примітка: Ця властивість призначена для використання 2D.

---

UpdateMode render_target_update_mode = 2 🔗

• void set_update_mode(value: UpdateMode)

• UpdateMode get_update_mode()

Режим оновлення, коли суб-перевізник використовується в якості цільового рендеру.

---

Vector2i size = Vector2i(512, 512) 🔗

• void set_size(value: Vector2i)

• Vector2i get_size()

Ширина і висота під-експорту. Необхідно встановити значення більше або дорівнює 2 пікселів на обох розмірах. В іншому випадку нічого не буде відображено.

Примітка: Якщо материнська вершина є SubViewportContainer і його SubViewportContainer.stretch true, розмір огляду не можна змінити вручну.

---

Vector2i size_2d_override = Vector2i(0, 0) 🔗

• void set_size_2d_override(value: Vector2i)

• Vector2i get_size_2d_override()

2D розмір перенареченого субогляду. Якщо ширина або висота 0, перенаречена вимкнена.

---

bool size_2d_override_stretch = false 🔗

• void set_size_2d_override_stretch(value: bool)

• bool is_size_2d_override_stretch_enabled()

Якщо true, то зовнішній вигляд 2D впливає на розтяг.