Max Edge Count

Check if the mesh exceeds a specified maximum edge count and correct it if necessary.

Parameter table

param	unit	required	description
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.
maxEdgeCount		yes	The maximum allowed number of edges for the mesh.

Detailed description

This rule checks if a mesh's edge count exceeds the specified maximum edge count (maxEdgeCount). If the mesh does exceed this number, the rule applies a correction to reduce the edge count.

It can be used to ensure that meshes are optimized for performance by keeping edge counts within acceptable limits.

This rule is particularly useful in scenarios where performance optimization is crucial, such as in game development and real-time rendering applications, where excessive edge counts can adversely affect performance and load times.

Correction

The correction process aims to decrease the number of edges without significantly compromising the mesh's visual and structural integrity.

The correction process uses edge collapse techniques to reduce edge counts efficiently while maintaining the mesh's overall shape and features.

How to setup

The 'Max Edge Count' rule is designed to help maintain mesh complexity within optimal performance boundaries by enforcing a maximum edge count.

** Key parameters include: **

• maxEdgeCount: This parameter sets the upper limit for the number of edges a mesh can have. It is crucial to select a value that balances performance with the necessary level of detail for meshes.
• meshName: This parameter specifies the name of the mesh to be checked.

Evaluate the performance constraints of your application or project. Lower edge counts are generally better for performance, but too low can compromise the visual quality.

Creator tips

When preparing your meshes, aim to keep edge counts as low as possible without sacrificing necessary detail. This practice ensures better performance across various platforms.

Consider using edge reduction tools and techniques during the modeling process to control edge counts effectively.

After applying corrections, visually inspect the mesh to ensure that the reduction in edge count has not adversely affected its appearance or function.

Examples

value	valid	maxEdgeCount	meshName	description
	❌	2000	Dice	This die is originally composed of approximately 18k edges.
	✅	2000	Dice	After applying the decimate modifier, the die is now composed of approximately 1405 edges.