Max Polygons Count

Check if the mesh exceeds a specified maximum polygon 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.
maxPolygonCount		yes	The maximum allowed number of polygons for the mesh.

Detailed description

In Blender, what we commonly refer to as a "polygon" is known as a "face". According to !(the official Blender documentation)[https://docs.blender.org/manual/en/latest/modeling/meshes/structure.html]:

Faces are used to build the actual surface of the object. They are what you see when you render the mesh. If this area does not contain a face, it will simply be transparent or nonexistent in the rendered image.

A face is defined as the area between either three (triangles), four (quadrangles) or more (n-gons) vertices, with an edge on every side. The faces are often abbreviated to tris, quads & n-gons.

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

It is used to ensure that meshes are optimized for performance by keeping polygon 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 polygon counts can adversely affect performance and load times.

Correction

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

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

How to setup

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

** Key parameters include: **

• maxPolygonCount: This parameter sets the upper limit for the number of polygons 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 polygon counts are generally better for performance, but too low can compromise the visual quality.

Creator tips

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

Consider using mesh decimation tools and techniques during the modeling process to control polygon counts effectively.

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

Examples

value	valid	maxPolygonCount	meshName	description
	❌	1500	Dice	This die is originally composed of approximately 9.3k polygons.
	✅	1500	Dice	After applying the decimate modifier, the die is now composed of approximately 1300 polygons.