Mesh Size

Ensures the mesh dimensions do not exceed specified max size limits and meet min size requirements.

Parameter table

param	unit	required	description
xDimensionMaxSize	meter	no	The maximum size for the X dimension of the mesh.
xDimensionMinSize	meter	no	The minimum size for the X dimension of the mesh.
yDimensionMaxSize	meter	no	The maximum size for the Y dimension of the mesh.
yDimensionMinSize	meter	no	The minimum size for the Y dimension of the mesh.
zDimensionMaxSize	meter	no	The maximum size for the Z dimension of the mesh.
zDimensionMinSize	meter	no	The minimum size for the Z dimension of the mesh.
meshName		no	The name of the mesh to be checked.
meshKeyName		no	The key of the name of the mesh to be checked. This will be used if mesName is undefined.

Detailed description

This rule ensures each dimension (X, Y, Z) of the specified mesh is within the limits set by the maximum and minimum size parameters (xDimensionMaxSize, xDimensionMinSize, yDimensionMaxSize, yDimensionMinSize, zDimensionMaxSize, zDimensionMinSize). It checks that no dimension of the mesh exceeds its corresponding maximum limit or falls below the minimum limit. If any dimension does not comply, a correction process is initiated.

Correction

The correction process offers two types of proposals: rotating and scaling down the mesh:

• Rotating proposals: Depending on the mesh and arguments, up to 24 different orientations may be tried to fit the mesh within the specified dimensions. However, the exact number of proposals (e.g., 4) depends on the specific mesh and parameters.
• Scale proposals: Includes two scaling strategies:
  • One maintaining the original proportions (ratio) of the mesh.
  • Another adjusting each dimension independently, altering the original proportions.

Example: The mesh 'Suzanne' initially exceeds the maximum dimensions, particularly noticeable with the ears sticking out beyond the allowed space defined by xDimensionSize: 1.704, yDimensionSize: 1.9688, zDimensionSize: 2.735. A rectangular cuboid representing the maximum dimensions is shown alongside Suzanne for scale comparison. In the correction proposals:

• The 4 rotating proposals here:

• The 2 scale down proposals:

How to setup

This rule ensures each dimension (X, Y, Z) of the specified mesh is within the limits set by the maximum and minimum size parameters Each parameter (xDimensionMaxSize, xDimensionMinSize, yDimensionMaxSize, yDimensionMinSize, zDimensionMaxSize, zDimensionMinSize) can be set independently to ensure the mesh fits within the project's spatial constraints. At least one dimension parameter must be specified to implement the rule.

Creator tips

When designing your mesh, ensure it complies with the specified dimensional limits to avoid corrections. Use pre-checks in your modeling software to adjust the dimensions according to the project's requirements while maintaining the integrity of your design. This can reduce the likelihood of needing extensive corrections like scaling or rotating, which might alter the original appearance of your mesh.

Examples

value	valid	meshName	xDimensionMaxSize	yDimensionMaxSize	zDimensionMaxSize	description
	❌	Suzanne	1.704	1.9688	2.735	Suzanne mesh exceeds the set dimension limits for the X dimension.
	✅	Suzanne	3	2	2	Suzanne mesh respects the set dimension limits.