DebugDraw3DScopeConfig Class Reference

This class is used to override scope parameters for DebugDraw3D. More...

#include <config_scope_3d.h>

Inheritance diagram for DebugDraw3DScopeConfig:

Public Member Functions
Ref< DebugDraw3DScopeConfig >	set_thickness (real_t _value) const
real_t	get_thickness () const
Ref< DebugDraw3DScopeConfig >	set_center_brightness (real_t _value) const
real_t	get_center_brightness () const
Ref< DebugDraw3DScopeConfig >	set_hd_sphere (bool _value) const
bool	is_hd_sphere () const
Ref< DebugDraw3DScopeConfig >	set_plane_size (real_t _value) const
real_t	get_plane_size () const
Ref< DebugDraw3DScopeConfig >	set_viewport (Viewport *_value) const
Viewport *	get_viewport () const
Ref< DebugDraw3DScopeConfig >	set_no_depth_test (bool _value) const
bool	is_no_depth_test () const

Detailed Description

This class is used to override scope parameters for DebugDraw3D.

Scope means that these overridden parameters will affect the drawn geometry until it exits the current scope.

To create it, use DebugDraw3D.new_scoped_config. Immediately after creation, you can change the values and save the reference in a variable.

Warning

But the main thing is not to save it outside the method or in other objects. After leaving the scope, this object should be deleted.

---

Warning

Also, you can't use scope config between awaits unless this object is freed before await. So, narrow the scope if you want to use await and DebugDraw3DScopeConfig in the same method. Or set the value of the variable to null so that the object is cleared due to lack of references.

# Bad example
var _s = DebugDraw3D.new_scoped_config().set_thickness(0.3)
DebugDraw3D.draw_box(Vector3.ZERO, Quaternion.IDENTITY, Vector3.ONE)
await get_tree().process_frame
# your code...
 
# Good example
if true:
   var _s = DebugDraw3D.new_scoped_config().set_thickness(0.3)
   DebugDraw3D.draw_box(Vector3.ZERO, Quaternion.IDENTITY, Vector3.ONE)
await get_tree().process_frame
# your code...

Examples:

var _s = DebugDraw3D.new_scoped_config().set_thickness(0.025).set_center_brightness(0.7)
DebugDraw3D.draw_grid_xf(%Grid.global_transform, Vector2i(10,10), Color.LIGHT_GRAY)

using (var s = DebugDraw3D.NewScopedConfig().SetThickness(0))
    DebugDraw3D.DrawCameraFrustum(dCamera, Colors.DarkOrange);

Member Function Documentation

set_thickness()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_thickness

(

real_t

_value

)

const

Set the thickness of the volumetric lines. If the value is 0, the standard wireframe rendering will be used.

set_center_brightness()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_center_brightness

(

real_t

_value

)

const

Set the brightness of the central part of the volumetric lines.

set_hd_sphere()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_hd_sphere

(

bool

_value

)

const

Set the mesh density of the sphere

set_plane_size()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_plane_size

(

real_t

_value

)

const

Set the size of the Plane in DebugDraw3D.draw_plane. If set to INF, the Far parameter of the current camera will be used.

set_viewport()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_viewport

(

Viewport *

_value

)

const

Set which Viewport will be used to get World3D.

If the World3D of this Viewport has not been used before, then the owner of this World3D will be found in the current branch of the tree, and special observer nodes will be added to it.

Note

Objects created for a specific Viewport will use only one camera related to that Viewport for culling.

set_no_depth_test()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_no_depth_test

(

bool

_value

)

const

Set whether the depth_test_disabled flag is added or not in the shaders of the debug shapes.

Note

It may cause artifacts when drawing volumetric objects.

---

The documentation for this class was generated from the following file:

• src/3d/config_scope_3d.h