From 6843f39875b59e7f8053c662464d28c97b4394ff Mon Sep 17 00:00:00 2001 From: Bastiaan Olij Date: Thu, 19 Jul 2018 19:31:12 +1000 Subject: Added some documentation for the CSG nodes --- modules/csg/doc_classes/CSGBox.xml | 6 ++++ modules/csg/doc_classes/CSGCombiner.xml | 2 ++ modules/csg/doc_classes/CSGCylinder.xml | 8 +++++ modules/csg/doc_classes/CSGMesh.xml | 3 ++ modules/csg/doc_classes/CSGPolygon.xml | 50 ++++++++++++++++---------------- modules/csg/doc_classes/CSGPrimitive.xml | 2 ++ modules/csg/doc_classes/CSGShape.xml | 8 +++++ modules/csg/doc_classes/CSGSphere.xml | 7 +++++ modules/csg/doc_classes/CSGTorus.xml | 8 +++++ 9 files changed, 69 insertions(+), 25 deletions(-) (limited to 'modules/csg/doc_classes') diff --git a/modules/csg/doc_classes/CSGBox.xml b/modules/csg/doc_classes/CSGBox.xml index 80455fda80..5ec7b5089d 100644 --- a/modules/csg/doc_classes/CSGBox.xml +++ b/modules/csg/doc_classes/CSGBox.xml @@ -1,8 +1,10 @@ + A CSG Box shape. + This node allows you to create a box for use with the CSG system. @@ -12,12 +14,16 @@ + Depth of the box measured from the center of the box. + Height of the box measured from the center of the box. + The material used to render the box. + Width of the box measured from the center of the box. diff --git a/modules/csg/doc_classes/CSGCombiner.xml b/modules/csg/doc_classes/CSGCombiner.xml index b2265d7703..1cfaa74b7d 100644 --- a/modules/csg/doc_classes/CSGCombiner.xml +++ b/modules/csg/doc_classes/CSGCombiner.xml @@ -1,8 +1,10 @@ + A CSG node that allows you to combine other CSG modifiers. + For complex arrangements of shapes it is sometimes needed to add structure to your CSG nodes. The CSGCombiner node allows you to create this structure. The node encapsulates the result of the CSG operations of its children. In this way it is possible to do operations on one set of shapes that are children of one CSGCombiner node, and a set of separate operations on a second set of shapes that are children of a second CSGCombiner node, and then do an operation that takes the two end results as their input to create the final shape. diff --git a/modules/csg/doc_classes/CSGCylinder.xml b/modules/csg/doc_classes/CSGCylinder.xml index 0cab26ad3d..92b170ed1f 100644 --- a/modules/csg/doc_classes/CSGCylinder.xml +++ b/modules/csg/doc_classes/CSGCylinder.xml @@ -1,8 +1,10 @@ + A CSG Cylinder shape. + This node allows you to create a cylinder (or cone) for use with the CSG system. @@ -12,16 +14,22 @@ + If true a cone is created, the [member radius] will only apply to one side. + The height of the cylinder. + The material used to render the cylinder. + The radius of the cylinder. + The number of sides of the cylinder, the higher this number the more detail there will be in the cylinder. + If true the normals of the cylinder are set to give a smooth effect making the cylinder seem rounded. When false the cylinder will have a flat shaded look. diff --git a/modules/csg/doc_classes/CSGMesh.xml b/modules/csg/doc_classes/CSGMesh.xml index e5c3e5ccf3..419214b7e6 100644 --- a/modules/csg/doc_classes/CSGMesh.xml +++ b/modules/csg/doc_classes/CSGMesh.xml @@ -1,8 +1,10 @@ + A CSG Mesh shape that uses a mesh resource. + This CSG node allows you to use any mesh resource as a CSG shape provided it is closed, does not self-intersect, does not contain internal faces and has no edges that connect to more then two faces. @@ -12,6 +14,7 @@ + The mesh resource to use as a CSG shape. diff --git a/modules/csg/doc_classes/CSGPolygon.xml b/modules/csg/doc_classes/CSGPolygon.xml index 1e6dec8085..a33e5557cb 100644 --- a/modules/csg/doc_classes/CSGPolygon.xml +++ b/modules/csg/doc_classes/CSGPolygon.xml @@ -1,7 +1,7 @@ - Extrudes a 2D polygon shape to create a 3D mesh + Extrudes a 2D polygon shape to create a 3D mesh. This node takes a 2D polygon shape and extrudes it to create a 3D mesh. @@ -14,63 +14,63 @@ - Extrusion depth when [member mode] is [constant MODE_DEPTH] + Extrusion depth when [member mode] is [constant MODE_DEPTH]. - Material to use for the resulting mesh + Material to use for the resulting mesh. - Extrusion mode + Extrusion mode. - - Interval at which a new extrusion slice is added along the path when [member mode] is [constant MODE_PATH] + + If true the u component of our uv will continuously increase in unison with the distance traveled along our path when [member mode] is [constant MODE_PATH]. - - The [Shape] object containing the path along which we extrude when [member mode] is [constant MODE_PATH] + + Interval at which a new extrusion slice is added along the path when [member mode] is [constant MODE_PATH]. - - The method by which each slice is rotated along the path when [member mode] is [constant MODE_PATH] + + If true the start and end of our path are joined together ensuring there is no seam when [member mode] is [constant MODE_PATH]. - If false we extrude centered on our path, if true we extrude in relation to the position of our CSGPolygon when [member mode] is [constant MODE_PATH] + If false we extrude centered on our path, if true we extrude in relation to the position of our CSGPolygon when [member mode] is [constant MODE_PATH]. - - If true the u component of our uv will continuously increase in unison with the distance traveled along our path when [member mode] is [constant MODE_PATH] + + The [Shape] object containing the path along which we extrude when [member mode] is [constant MODE_PATH]. - - If true the start and end of our path are joined together ensuring there is no seam when [member mode] is [constant MODE_PATH] + + The method by which each slice is rotated along the path when [member mode] is [constant MODE_PATH]. - Point array that defines the shape that we'll extrude + Point array that defines the shape that we'll extrude. - Generates smooth normals so smooth shading is applied to our mesh + Generates smooth normals so smooth shading is applied to our mesh. - Degrees to rotate our extrusion for each slice when [member mode] is [constant MODE_SPIN] + Degrees to rotate our extrusion for each slice when [member mode] is [constant MODE_SPIN]. - Number of extrusion when [member mode] is [constant MODE_SPIN] + Number of extrusion when [member mode] is [constant MODE_SPIN]. - Shape is extruded to [member depth] + Shape is extruded to [member depth]. - Shape is extruded by rotating it around an axis + Shape is extruded by rotating it around an axis. - Shape is extruded along a path set by a [Shape] set in [member path_node] + Shape is extruded along a path set by a [Shape] set in [member path_node]. - Slice is not rotated + Slice is not rotated. - Slice is rotated around the up vector of the path + Slice is rotated around the up vector of the path. - Slice is rotate to match the path exactly + Slice is rotate to match the path exactly. diff --git a/modules/csg/doc_classes/CSGPrimitive.xml b/modules/csg/doc_classes/CSGPrimitive.xml index bf41c40f22..2591bab7e3 100644 --- a/modules/csg/doc_classes/CSGPrimitive.xml +++ b/modules/csg/doc_classes/CSGPrimitive.xml @@ -1,6 +1,7 @@ + Base class for CSG primitives. @@ -12,6 +13,7 @@ + Invert the faces of the mesh. diff --git a/modules/csg/doc_classes/CSGShape.xml b/modules/csg/doc_classes/CSGShape.xml index cf236a4207..90621b94f4 100644 --- a/modules/csg/doc_classes/CSGShape.xml +++ b/modules/csg/doc_classes/CSGShape.xml @@ -1,8 +1,10 @@ + The CSG base class. + This is the CSG base class that provides CSG operation support to the various CSG nodes in Godot. @@ -13,23 +15,29 @@ + Returns true if this is a root shape and is thus the object that is rendered. + The operation that is performed on this shape. This is ignored for the first CSG child node as the operation is between this node and the previous child of this nodes parent. + Adds a collision shape to the physics engine for our CSG shape. This will always act like a static body. Note that the collision shape is still active even if the CSG shape itself is hidden. + Geometry of both primitives is merged, intersecting geometry is removed. + Only intersecting geometry remains, the rest is removed. + The second shape is susbtracted from the first, leaving a dent with it's shape. diff --git a/modules/csg/doc_classes/CSGSphere.xml b/modules/csg/doc_classes/CSGSphere.xml index 520368506e..a0069879cb 100644 --- a/modules/csg/doc_classes/CSGSphere.xml +++ b/modules/csg/doc_classes/CSGSphere.xml @@ -1,8 +1,10 @@ + A CSG Sphere shape. + This node allows you to create a sphere for use with the CSG system. @@ -12,14 +14,19 @@ + The material used to render the sphere. + Number of vertical slices for the sphere. + Radius of the sphere. + Number of horizontal slices for the sphere. + If true the normals of the sphere are set to give a smooth effect making the sphere seem rounded. When false the sphere will have a flat shaded look. diff --git a/modules/csg/doc_classes/CSGTorus.xml b/modules/csg/doc_classes/CSGTorus.xml index 58bbef2600..187d71a2fa 100644 --- a/modules/csg/doc_classes/CSGTorus.xml +++ b/modules/csg/doc_classes/CSGTorus.xml @@ -1,8 +1,10 @@ + A CSG Torus shape. + This node allows you to create a torus for use with the CSG system. @@ -12,16 +14,22 @@ + The inner radius of the torus. + The material used to render the torus. + The outer radius of the torus. + The number of edges each ring of the torus is constructed of. + The number of slices the torus is constructed of. + If true the normals of the torus are set to give a smooth effect making the torus seem rounded. When false the torus will have a flat shaded look. -- cgit v1.2.3