Up to date

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

CSGTorus3D

Inherits: CSGPrimitive3D < CSGShape3D < GeometryInstance3D < VisualInstance3D < Node3D < Node < Object

A CSG Torus shape.

Description

This node allows you to create a torus for use with the CSG system.

Note: CSG nodes are intended to be used for level prototyping. Creating CSG nodes has a significant CPU cost compared to creating a MeshInstance3D with a PrimitiveMesh. Moving a CSG node within another CSG node also has a significant CPU cost, so it should be avoided during gameplay.

Tutorials

Properties

float

inner_radius

0.5

Material

material

float

outer_radius

1.0

int

ring_sides

6

int

sides

8

bool

smooth_faces

true


Property Descriptions

float inner_radius = 0.5

  • void set_inner_radius ( float value )

  • float get_inner_radius ( )

The inner radius of the torus.


Material material

The material used to render the torus.


float outer_radius = 1.0

  • void set_outer_radius ( float value )

  • float get_outer_radius ( )

The outer radius of the torus.


int ring_sides = 6

  • void set_ring_sides ( int value )

  • int get_ring_sides ( )

The number of edges each ring of the torus is constructed of.


int sides = 8

  • void set_sides ( int value )

  • int get_sides ( )

The number of slices the torus is constructed of.


bool smooth_faces = true

  • void set_smooth_faces ( bool value )

  • bool get_smooth_faces ( )

If true the normals of the torus are set to give a smooth effect making the torus seem rounded. If false the torus will have a flat shaded look.