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)
real_t	get_thickness () const
Ref< DebugDraw3DScopeConfig >	set_center_brightness (real_t _value)
real_t	get_center_brightness () const
Ref< DebugDraw3DScopeConfig >	set_hd_sphere (bool _value)
bool	is_hd_sphere () const
Ref< DebugDraw3DScopeConfig >	set_plane_size (real_t _value)
real_t	get_plane_size () const
Ref< DebugDraw3DScopeConfig >	set_viewport (Viewport *_value)
Viewport *	get_viewport () 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.

# 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

)

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

)

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

set_hd_sphere()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_hd_sphere

(

bool

_value

)

Set the mesh density of the sphere

set_plane_size()

Ref< DebugDraw3DScopeConfig > DebugDraw3DScopeConfig::set_plane_size

(

real_t

_value

)

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

)

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.

---

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

• src/3d/config_scope_3d.h