Up to date

This page is up to date for Godot 4.0. If you still find outdated information, please open an issue.

ViewportTexture

Inherits: Texture2D < Texture < Resource < RefCounted < Object

Provides the content of a Viewport as a dynamic texture.

Description

Provides the content of a Viewport as a dynamic Texture2D. This can be used to mix controls, 2D game objects, and 3D game objects in the same scene.

To create a ViewportTexture in code, use the Viewport.get_texture method on the target viewport.

Note: When local to scene, this texture uses Resource.setup_local_to_scene to set the proxy texture and flags in the local viewport. Local to scene ViewportTextures will return incorrect data until the scene root is ready (see Node.ready).

Tutorials

• GUI in 3D Demo

• 3D in 2D Demo

• 2D in 3D Demo

• 3D Viewport Scaling Demo

Properties

NodePath

viewport_path

NodePath("")

---

Property Descriptions

NodePath viewport_path = NodePath("")

• void set_viewport_path_in_scene ( NodePath value )

• NodePath get_viewport_path_in_scene ( )

The path to the Viewport node to display. This is relative to the scene root, not to the node that uses the texture.