W3cubDocs

/Godot 4.2

BoxMesh

Inherits: PrimitiveMesh < Mesh < Resource < RefCounted < Object

Generate an axis-aligned box PrimitiveMesh.

Description

Generate an axis-aligned box PrimitiveMesh.

The box's UV layout is arranged in a 3×2 layout that allows texturing each face individually. To apply the same texture on all faces, change the material's UV property to Vector3(3, 2, 1). This is equivalent to adding UV *= vec2(3.0, 2.0) in a vertex shader.

Note: When using a large textured BoxMesh (e.g. as a floor), you may stumble upon UV jittering issues depending on the camera angle. To solve this, increase subdivide_depth, subdivide_height and subdivide_width until you no longer notice UV jittering.

Properties

Vector3

size

Vector3(1, 1, 1)

int

subdivide_depth

0

int

subdivide_height

0

int

subdivide_width

0

Property Descriptions

Vector3 size = Vector3(1, 1, 1)

The box's width, height and depth.

int subdivide_depth = 0

  • void set_subdivide_depth ( int value )
  • int get_subdivide_depth ( )

Number of extra edge loops inserted along the Z axis.

int subdivide_height = 0

  • void set_subdivide_height ( int value )
  • int get_subdivide_height ( )

Number of extra edge loops inserted along the Y axis.

int subdivide_width = 0

  • void set_subdivide_width ( int value )
  • int get_subdivide_width ( )

Number of extra edge loops inserted along the X axis.

© 2014–present Juan Linietsky, Ariel Manzur and the Godot community
Licensed under the Creative Commons Attribution Unported License v3.0.
https://docs.godotengine.org/en/4.2/classes/class_boxmesh.html