Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve the default size of 3D shapes and meshes (Box, Capsule, and Cylinder) #56365

Merged
merged 1 commit into from
Feb 3, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion doc/classes/BoxMesh.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<tutorials>
</tutorials>
<members>
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(2, 2, 2)">
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(1, 1, 1)">
The box's width, height and depth.
</member>
<member name="subdivide_depth" type="int" setter="set_subdivide_depth" getter="get_subdivide_depth" default="0">
Expand Down
2 changes: 1 addition & 1 deletion doc/classes/BoxShape3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<link title="3D Platformer Demo">https://godotengine.org/asset-library/asset/125</link>
</tutorials>
<members>
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(2, 2, 2)">
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(1, 1, 1)">
The box's width, height and depth.
</member>
</members>
Expand Down
4 changes: 2 additions & 2 deletions doc/classes/CapsuleMesh.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@
<tutorials>
</tutorials>
<members>
<member name="height" type="float" setter="set_height" getter="get_height" default="3.0">
<member name="height" type="float" setter="set_height" getter="get_height" default="2.0">
Total height of the capsule mesh (including the hemispherical ends).
</member>
<member name="radial_segments" type="int" setter="set_radial_segments" getter="get_radial_segments" default="64">
Number of radial segments on the capsule mesh.
</member>
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="1.0">
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="0.5">
Radius of the capsule mesh.
</member>
<member name="rings" type="int" setter="set_rings" getter="get_rings" default="8">
Expand Down
4 changes: 2 additions & 2 deletions doc/classes/CapsuleShape3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,10 @@
<link title="3D Physics Tests Demo">https://godotengine.org/asset-library/asset/675</link>
</tutorials>
<members>
<member name="height" type="float" setter="set_height" getter="get_height" default="3.0">
<member name="height" type="float" setter="set_height" getter="get_height" default="2.0">
The capsule's height.
</member>
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="1.0">
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="0.5">
The capsule's radius.
</member>
</members>
Expand Down
4 changes: 2 additions & 2 deletions doc/classes/CylinderMesh.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@
<tutorials>
</tutorials>
<members>
<member name="bottom_radius" type="float" setter="set_bottom_radius" getter="get_bottom_radius" default="1.0">
<member name="bottom_radius" type="float" setter="set_bottom_radius" getter="get_bottom_radius" default="0.5">
Bottom radius of the cylinder. If set to [code]0.0[/code], the bottom faces will not be generated, resulting in a conic shape.
</member>
<member name="height" type="float" setter="set_height" getter="get_height" default="2.0">
Expand All @@ -21,7 +21,7 @@
<member name="rings" type="int" setter="set_rings" getter="get_rings" default="4">
Number of edge rings along the height of the cylinder. Changing [member rings] does not have any visual impact unless a shader or procedural mesh tool is used to alter the vertex data. Higher values result in more subdivisions, which can be used to create smoother-looking effects with shaders or procedural mesh tools (at the cost of performance). When not altering the vertex data using a shader or procedural mesh tool, [member rings] should be kept to its default value.
</member>
<member name="top_radius" type="float" setter="set_top_radius" getter="get_top_radius" default="1.0">
<member name="top_radius" type="float" setter="set_top_radius" getter="get_top_radius" default="0.5">
Top radius of the cylinder. If set to [code]0.0[/code], the top faces will not be generated, resulting in a conic shape.
</member>
</members>
Expand Down
2 changes: 1 addition & 1 deletion doc/classes/CylinderShape3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
<member name="height" type="float" setter="set_height" getter="get_height" default="2.0">
The cylinder's height.
</member>
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="1.0">
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="0.5">
The cylinder's radius.
</member>
</members>
Expand Down
8 changes: 4 additions & 4 deletions modules/csg/csg_shape.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -1451,8 +1451,8 @@ Ref<Material> CSGCylinder3D::get_material() const {

CSGCylinder3D::CSGCylinder3D() {
// defaults
radius = 1.0;
height = 1.0;
radius = 0.5;
height = 2.0;
sides = 8;
cone = false;
smooth_faces = true;
Expand Down Expand Up @@ -1671,8 +1671,8 @@ Ref<Material> CSGTorus3D::get_material() const {

CSGTorus3D::CSGTorus3D() {
// defaults
inner_radius = 2.0;
outer_radius = 3.0;
inner_radius = 0.5;
outer_radius = 1.0;
sides = 8;
ring_sides = 6;
smooth_faces = true;
Expand Down
2 changes: 1 addition & 1 deletion modules/csg/csg_shape.h
Original file line number Diff line number Diff line change
Expand Up @@ -239,7 +239,7 @@ class CSGBox3D : public CSGPrimitive3D {
virtual CSGBrush *_build_brush() override;

Ref<Material> material;
Vector3 size = Vector3(2, 2, 2);
Vector3 size = Vector3(1, 1, 1);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As long as it follows the style guide,

Suggested change
Vector3 size = Vector3(1, 1, 1);
Vector3 size(1, 1, 1);

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's actually a style that we don't really use in the codebase so far, so it's better not to start using it as it adds inconsistency in the codebase.


protected:
static void _bind_methods();
Expand Down
2 changes: 1 addition & 1 deletion modules/csg/doc_classes/CSGBox3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
<member name="material" type="Material" setter="set_material" getter="get_material">
The material used to render the box.
</member>
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(2, 2, 2)">
<member name="size" type="Vector3" setter="set_size" getter="get_size" default="Vector3(1, 1, 1)">
The box's width, height and depth.
</member>
</members>
Expand Down
4 changes: 2 additions & 2 deletions modules/csg/doc_classes/CSGCylinder3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,13 +12,13 @@
<member name="cone" type="bool" setter="set_cone" getter="is_cone" default="false">
If [code]true[/code] a cone is created, the [member radius] will only apply to one side.
</member>
<member name="height" type="float" setter="set_height" getter="get_height" default="1.0">
<member name="height" type="float" setter="set_height" getter="get_height" default="2.0">
The height of the cylinder.
</member>
<member name="material" type="Material" setter="set_material" getter="get_material">
The material used to render the cylinder.
</member>
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="1.0">
<member name="radius" type="float" setter="set_radius" getter="get_radius" default="0.5">
The radius of the cylinder.
</member>
<member name="sides" type="int" setter="set_sides" getter="get_sides" default="8">
Expand Down
4 changes: 2 additions & 2 deletions modules/csg/doc_classes/CSGTorus3D.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@
<tutorials>
</tutorials>
<members>
<member name="inner_radius" type="float" setter="set_inner_radius" getter="get_inner_radius" default="2.0">
<member name="inner_radius" type="float" setter="set_inner_radius" getter="get_inner_radius" default="0.5">
The inner radius of the torus.
</member>
<member name="material" type="Material" setter="set_material" getter="get_material">
The material used to render the torus.
</member>
<member name="outer_radius" type="float" setter="set_outer_radius" getter="get_outer_radius" default="3.0">
<member name="outer_radius" type="float" setter="set_outer_radius" getter="get_outer_radius" default="1.0">
The outer radius of the torus.
</member>
<member name="ring_sides" type="int" setter="set_ring_sides" getter="get_ring_sides" default="6">
Expand Down
2 changes: 1 addition & 1 deletion scene/resources/box_shape_3d.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -95,5 +95,5 @@ void BoxShape3D::_bind_methods() {

BoxShape3D::BoxShape3D() :
Shape3D(PhysicsServer3D::get_singleton()->shape_create(PhysicsServer3D::SHAPE_BOX)) {
set_size(Vector3(2, 2, 2));
set_size(Vector3(1, 1, 1));
}
4 changes: 2 additions & 2 deletions scene/resources/capsule_shape_3d.h
Original file line number Diff line number Diff line change
Expand Up @@ -35,8 +35,8 @@

class CapsuleShape3D : public Shape3D {
GDCLASS(CapsuleShape3D, Shape3D);
float radius = 1.0;
float height = 3.0;
float radius = 0.5;
float height = 2.0;

protected:
static void _bind_methods();
Expand Down
2 changes: 1 addition & 1 deletion scene/resources/cylinder_shape_3d.h
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@

class CylinderShape3D : public Shape3D {
GDCLASS(CylinderShape3D, Shape3D);
float radius = 1.0;
float radius = 0.5;
float height = 2.0;

protected:
Expand Down
10 changes: 5 additions & 5 deletions scene/resources/primitive_meshes.h
Original file line number Diff line number Diff line change
Expand Up @@ -106,8 +106,8 @@ class CapsuleMesh : public PrimitiveMesh {
GDCLASS(CapsuleMesh, PrimitiveMesh);

private:
float radius = 1.0;
float height = 3.0;
float radius = 0.5;
float height = 2.0;
int radial_segments = 64;
int rings = 8;

Expand Down Expand Up @@ -138,7 +138,7 @@ class BoxMesh : public PrimitiveMesh {
GDCLASS(BoxMesh, PrimitiveMesh);

private:
Vector3 size = Vector3(2.0, 2.0, 2.0);
Vector3 size = Vector3(1, 1, 1);
int subdivide_w = 0;
int subdivide_h = 0;
int subdivide_d = 0;
Expand Down Expand Up @@ -171,8 +171,8 @@ class CylinderMesh : public PrimitiveMesh {
GDCLASS(CylinderMesh, PrimitiveMesh);

private:
float top_radius = 1.0;
float bottom_radius = 1.0;
float top_radius = 0.5;
float bottom_radius = 0.5;
float height = 2.0;
int radial_segments = 64;
int rings = 4;
Expand Down