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

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
int	view_count	1

---

Переліки

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 впливає на розтяг.

---

int view_count = 1 🔗

• void set_view_count(value: int)

• int get_view_count()

Кількість шарів перегляду, на які ми виконуємо рендеринг. Встановіть це значення на 2, щоб увімкнути стерео-рендеринг.