CreateMeshPartitionClusters

Description

Partitions the polygons into separate clusters using a given partition criteria. Currently it only supports mesh objects created using the curvelist-to-mesh operator. The default criteria is to create one cluster per face (i.e., polygon island). In that case the clusters are named using the following convention:

"Face_#no"

[...where #no is the face number (e.g.: 1, 2, ... ).]

However, if the input curves were generated from a text primitive (using the text to curves operator) then a cluster per character of the input text is created. (For instance, when you do Create > Text > Planar Mesh or Solid Mesh.) In that case the clusters are named using the following convention:

"Char_#no_#char"

[...where #no is the character number in the text (e.g.: 1, 2, ...) and #char is the actual character itself.]

Scripting Syntax

CreateMeshPartitionClusters( [InputObjs] );

Parameters

Parameter Type Description
InputObjs String List of meshes to partition

Default Value: Current Selection

Examples

1. VBScript Example

'Create a Mesh Text

CreateMeshText "CurveListToSolidMeshForText", siPersistentOperation

'Open an explorer window. View the scene_root

'Open Polymsh and Polygon Mesh

'The following command will add one cluster per character in Clusters object

'You can see them if you open Clusters

CreateMeshPartitionClusters "polymsh"

2. VBScript Example

'Create two curves

CreatePrim "Circle", "NurbsCurve"

Duplicate "circle", , 2, 1, 1, 0, 0, 1, 0, 1, , , , , , , , , , , 0

Translate , 11.7369060459901, 0, 0, siRelative, siGlobal, siObj, siXYZ

AddToSelection "circle", , True

DeselectAll

SelectObj "circle", , True

AddToSelection "circle1", , True

'creates a mesh from those two curves

ApplyOp "CurveListToMesh", "circle,circle1", 3, siPersistentOperation

'Open an explorer window. View the scene_root

'Open Polymsh and Polygon Mesh

'The following command will add one cluster per face in Clusters object

'You can see them if you open Clusters

CreateMeshPartitionClusters "polymsh"