ViewportTexture

Успадковує: Texture2D < Texture < Resource < RefCounted < Object

Забезпечує вміст Перегляд як динамічної текстури.

Опис

ViewportTexture надає вміст Viewport як динамічну Texture2D. Це можна використовувати для комбінування візуалізації вузлів Control, Node2D і Node3D. Наприклад, ви можете використовувати цю текстуру для відображення 3D-сцени всередині TextureRect або 2D-накладання в Sprite3D.

Щоб отримати ViewportTexture у коді, використовуйте метод Viewport.get_texture() у цільовому вікні перегляду.

Примітка: ViewportTexture завжди є локальним для своєї сцени (див. Resource.resource_local_to_scene). Якщо корінь сцени не готовий, він може повернути неправильні дані (див. Node.ready).

Примітка. Створення екземплярів сцен, що містять ViewportTexture високої роздільної здатності, може спричинити помітне заїкання.

Примітка. Якщо використовується Viewport із Viewport.use_hdr_2d, установленим на true, повернута текстура буде зображенням HDR, закодованим у лінійному просторі. Це може виглядати темніше, ніж зазвичай, коли відображається безпосередньо на екрані. Щоб перетворити на гамма-простір, ви можете зробити наступне:

img.convert(Image.FORMAT_RGBA8)
imb.linear_to_srgb()

Примітка. Деякі вузли, як-от Decal, Light3D і PointLight2D, не підтримують пряме використання ViewportTexture. Щоб використовувати дані текстури з ViewportTexture у цих вузлах, вам потрібно створити ImageTexture, викликавши Texture2D.get_image() у ViewportTexture і передавши результат ImageTexture.create_from_image(). Це перетворення є повільною операцією, тому його не слід виконувати кожного кадру.

Посібники

Властивості

NodePath

viewport_path

NodePath("")

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

NodePath viewport_path = NodePath("") 🔗

void set_viewport_path_in_scene(value: NodePath)
NodePath get_viewport_path_in_scene()

Шлях до вершини Viewport для відображення. Це відносно кореня локальної сцени (див. Resource.get_local_scene()), not до вузлів, які використовують цю текстуру.

Примітка: У редакторі цей шлях автоматично оновлюється, коли цільовий порт або один з його предків перейменований або переміщений. У режимі runtime цей шлях не може автоматично оновлюватися, якщо корінь сцени не знайдено.