An interface to a game world that doesn't create a window or draw to the screen directly.
[SubViewport] Isolates a rectangular region of a scene to be displayed independently. This can be used, for example, to display UI in 3D space. [b]Note:[/b] [SubViewport] is a [Viewport] that isn't a [Window], i.e. it doesn't draw anything by itself. To display anything, [SubViewport] must have a non-zero size and be either put inside a [SubViewportContainer] or assigned to a [ViewportTexture]. [b]Note:[/b] [InputEvent]s are not passed to a standalone [SubViewport] by default. To ensure [InputEvent] propagation, a [SubViewport] can be placed inside of a [SubViewportContainer].
$DOCS_URL/tutorials/rendering/viewports.html $DOCS_URL/tutorials/2d/2d_transforms.html https://godotengine.org/asset-library/asset/2807 https://godotengine.org/asset-library/asset/2804 https://godotengine.org/asset-library/asset/2803 https://godotengine.org/asset-library/asset/2808 https://godotengine.org/asset-library/asset/2806 https://godotengine.org/asset-library/asset/2805
- The clear mode when the sub-viewport is used as a render target. [b]Note:[/b] This property is intended for 2D usage.
- The update mode when the sub-viewport is used as a render target.
- The width and height of the sub-viewport. Must be set to a value greater than or equal to 2 pixels on both dimensions. Otherwise, nothing will be displayed. [b]Note:[/b] If the parent node is a [SubViewportContainer] and its [member SubViewportContainer.stretch] is [code]true[/code], the viewport size cannot be changed manually.
- The 2D size override of the sub-viewport. If either the width or height is [code]0[/code], the override is disabled.
- If [code]true[/code], the 2D size override affects stretch as well.
- The number of view layers we are rendering to. Set this to [code]2[/code] to enable stereo rendering.
Always clear the render target before drawing.
Never clear the render target.
Clear the render target on the next frame, then switch to [constant CLEAR_MODE_NEVER].
Do not update the render target.
Update the render target once, then switch to [constant UPDATE_DISABLED].
Update the render target only when it is visible. This is the default value.
Update the render target only when its parent is visible.
Always update the render target.