Edit_Poly : Modifier

Edit_Poly -superclass: modifier; super-superclass:MAXWrapper - classID:#(2041212445, 1906341303) 

Topic Navagation

Value > MAXWrapper > Modifier > Edit_Poly

 

   

Modifier Classes - Quick Navigation

Constructor:

Edit_Poly ... EditPolyMod... 

Topic Navigation:

   
 

   

Edit Poly Mode rollout

Selection rollout

Soft Selection rollout

Edit Vertices rollout

Edit Edges rollout

Edit Borders rollout

Edit Polygons rollout

Edit Geometry rollout

Polygon: Material IDs rollout

Polygon: Smoothing Groups rollout

Paint Deformation rollout

EditPolyMod Interface Selection Methods

EditPolyMod Interface Operation Methods

EditPolyMod Interface Topology Editing Methods

Slice Methods

Create Methods

Edit Triangulation_Methods

Cut Methods

Weld Methods

Bridge Methods

Divide Methods

Preserve Map Methods

Attach Methods

Create Shape Methods

EditPolyMod Interface Geometry Data Methods

EditPolyMod Interface Other Methods

Properties:

Edit Poly Mode

   

<Edit_Poly>.animationMode Integer default: 0 -- integer; Animation_Mode 

Get/Set the state of the Model/Animation radio buttons in the Edit Poly Mode rollout.

Possible values are:

0 - Model

1 - Animate

   

<Edit_Poly>.currentOperation Integer default: 0 -- integer; Edit_Type 

Get/set the current editing operation of the modifier.

Possible values are:

1

HideVertex

2

Hide Polygon

3

Unhide Vertices

4

Unhide Polygons

5

Hide Unselected Vertices

6

Hide Unselected Polygons

7

 

8

 

9

Cap Holes

10

Delete Vertex

11

Delete Polygon

12

Detach Vertex

13

Detach Polygon

14

Split Edge

15

BreakVertex

16

Collapse Vertex

17

Collapse Edge

18

Collapse Polygon

19

 

20

Slice

21

Slice Polygon

22

Weld Vertex

23

Weld Edge

24

 

25

Make Planar

26

Remove Isolated Vertices

27

MeshSmooth

28

Tessellate

29

Retriangulate

30

Flip Normals

31

Flip Normals

32

Bevel Polygon

33

Chamfer Vertex

34

Chamfer Edge

35

Cut

36

 

37

 

38

Inset Polygon

39

ExtrudeVertex

40

Extrude Edge

41

Extrude Polygon

42

Extrude Along Spline

43

Connect Edge

44

Connect Vertex

45

Hinge From Edge

46

 

47

 

48

Remove Unused Map Verts

49

Remove Vertex

50

Remove Edge

51

Outline Polygon

52

 

53

Transform

54

Delete Edge

55

 

56

Create

57

Align

58

Attach

59

Target Weld Vertex

60

Target Weld Edge

61

EditTriangulation

62

Create Edge

63

Clone Vertex

64

Clone Edge

65

Clone Face

66

Insert Vertex In Edge

67

Insert Vertex In Poly

68

Auto Smooth

69

Set Smoothing Groups

70

Set Material ID

71

 

72

 

73

 

74

Bridge Border

75

Bridge Polygon

76

Make Planar in X

77

Make Planar in Y

78

Make Planar in Z

79

Turn Edge

80

Relax

81

Paint Deformations

82

Bridge Edge

83

 

84

 

   

<Edit_Poly>.worldToObjectTransform Matrix3 default: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0]) -- matrix3; World_to_Object_Transform 

   

<Edit_Poly>.showCage BooleanClass default:false -- boolean; Show_Cage 

Get/Set the state of the Show Cage checkbox in the Edit Poly Mode rollout.

   

<Edit_Poly>.CageColor Point3 default: [1,0.588235,0] -- point3; Cage_Color 

Get/Set the Cage color.Available in 3ds Max 8 and higher.

   

<Edit_Poly>.selectedCageColor Point3 default: [0.94902,0.85098,0] -- point3; Selected_Cage_Color 

Get/Set the Selected Cage color.Available in 3ds Max 8 and higher.

Selection

   

<Edit_Poly>.useStackSelection BooleanClass default: false -- boolean; Use_Stack_Selection 

Get/Set the state of the Use Stack Selection checkbox in the Selection rollout. When checked, the incoming stack selection will be used instead of the modifier's sub-object selection.

   

<Edit_Poly>.selectByVertex BooleanClass default: false-- boolean; Select_By_Vertex 

   

<Edit_Poly>.ignoreBackfacing BooleanClass default: false -- boolean; Ignore_Backfacing 

Get/Set the state of the Ignore Backfacing checkbox in the Selection rollout.

   

<Edit_Poly>.selectByAngle BooleanClass default: false -- boolean; Select_by_Angle 

Get/Set the state of the Select By Angle checkbox in the Selection rollout.

   

<Edit_Poly>.selectAngle Float default: 45.0 -- angle; Selection_Angle 

Get/Set the Select Angle value in the Selection rollout.

   

<Edit_Poly>.loopEdgeSel Integer default: 0 -- integer; Edge_Loop 

Get/Set the Edge Loop value.Available in 3ds Max 8 and higher.

   

<Edit_Poly>.ringEdgeSel Integer default: 0 -- integer; Edge_Ring 

Get/Set the Edge Ring value.Available in 3ds Max 8 and higher.

   

<Edit_Poly>.selectMode Integer default: 0 -- integer; Select_Mode 

Get/Set the Edit Poly Selection Mode. Available in 3ds Max 2008 and higher.

Possible values are:

0 - Off

1 - Sub-Object

2 - Multi

Soft Selection

   

<Edit_Poly>.useSoftSel BooleanClass default: false-- boolean; Use_Soft_Selection 

Get/Set the state of the "Use Soft Selection" checkbox in the Soft Selection rollout.

   

<Edit_Poly>.ssUseEdgeDist BooleanClass default: false-- boolean; Use_Edge_Distance 

Get/Set the state of the Edge Distance checkbox in the Soft Selection rollout

   

<Edit_Poly>.ssEdgeDist Integer default:1 -- integer; Edge_Distance 

Get/Set the Edge Distance in the Soft Selection rollout

   

<Edit_Poly>.affectBackfacing BooleanClass default: true-- boolean; Affect_Backfacing 

Get/Set the Affect Backfacing checkbox state in the Soft Selection rollout.

   

<Edit_Poly>.falloff Float default: 20.0 -- animatable; world units 

Get/Set the Falloff value in the Soft Selection rollout.

   

<Edit_Poly>.pinch Float default: 0.0 -- animatable; float 

Get/Set the Pinch value in the Soft Selection rollout.

   

<Edit_Poly>.bubble Float default: 0.0 -- animatable; float 

Get/Set the Bubble value in the Soft Selection rollout.

   

<Edit_Poly>.lockSoftSel BooleanClass default: false -- boolean; Lock_Soft_Selection 

Get/Set the state of the Lock Soft Selection checkbox in the Soft Selection rollout. When enabled, the soft selection will not be recalculated automatically and can be defined using the Paint Soft Selection tools.

   

<Edit_Poly>.paintSelValue Float default: 1.0 -- float; Selection_Value 

Get/Set the Selection Value in the Paint Soft Selection group of controls in the Soft Selection rollout. Controls the selection value that will be applied to the vertices by the paint brush.

   

<Edit_Poly>.paintSelSize Float default: 10.0 -- world units; Brush_Size 

Get/Set the size of the paint selection brush.

   

<Edit_Poly>.paintSelStrength Float default: 1.0 -- float; Brush_Strength 

Get/Set the strength of the paint selection brush.

Edit Vertices/Edges/Borders/Polygons/Elements

Extrude Vertex/Edge/Face

<Edit_Poly>.extrudeEdgeHeight Float default: 0.0 -- animatable; world units; Edge_Extrude_Height 

Get/Set the edge extrusion height value.

   

<Edit_Poly>.extrudeEdgeWidth Float default: 0.0 -- animatable; world units; Edge_Extrude_Width 

Get/Set the edge extrusion width value.

   

<Edit_Poly>.extrudeFaceHeight Float default: 0.0 -- animatable; world units; Polygon_Extrude_Height 

Get/Set the face extrusion height value.

   

<Edit_Poly>.extrudeFaceType Integer default: 0 -- integer; Type_of_Extrusion 

Get/Set the radio button state controlling the face extrusion type.

Possible values are:

0 - Group

1 - Local Normal

2 - By Polygon

   

<Edit_Poly>.extrudeVertexHeight Float default: 0.0 -- animatable; world units; Vertex_Extrude_Height 

Get/Set the vertex extrusion height value.

   

<Edit_Poly>.extrudeVertexWidth Float default: 0.0 -- animatable; world units; Vertex_Extrude_Width 

Get/Set the vertex extrusion width value.

Related Methods:

To press the Extrude button, see the #ExtrudeVertex, #ExtrudeEdge and #ExtrudeFace operations in EditPolyMod InterfaceEditPolyMod Interface - Operation Methods

Weld

<Edit_Poly>.weldEdgeThreshold Float default: 0.1 -- animatable; world units; Edge_Weld_Threshold 

Get/Set the Weld Edge Threshold value

   

<Edit_Poly>.weldVertexThreshold Float default: 0.1 -- animatable; world units; Vertex_Weld_Threshold 

Get/Set the Weld Vertex Threshold value

Related Methods:

To press the Weld button, see the #WeldVertex and #WeldEdge operations in EditPolyMod Interface - Operation Methods

See also EditPolyMod Interface - Weld Methods

Chamfer

<Edit_Poly>.chamferEdgeAmount Float default:1.0 -- animatable; world units; Edge_Chamfer_Amount 

Get/Set the Edge Chamfer amount.

   

<Edit_Poly>.chamferEdgeOpen BooleanClass default: false -- boolean; Open_Chamfer 

Get/Set the state of the "Open" checkbox in the Edge Chamfer options dialog. When set to true, the new polygons created by the Chamfer operation will be removed, leaving an opening. Available in 3ds Max 8 and higher.

   

<Edit_Poly>.chamferVertexAmount Float default: 0.0 -- animatable; world units; Vertex_Chamfer_Amount 

Get/Set the Vertex Chamfer amount.

   

<Edit_Poly>.chamferVertexOpen BooleanClass default: false -- boolean; Open_Chamfer 

Get/Set the state of the "Open" checkbox in the Vertex Chamfer options dialog. When set to true, the new polygons created by the Chamfer operation will be removed, leaving an opening. Available in 3ds Max 8 and higher.

   

<Edit_Poly>.edgeChamferSegments Integer default: 1 -- integer; Edge_Chamfer_Segments 

Get/Set the Edge Chamfer Segments amount. Adding Segments to the Edge Chamfer effectively performs an Edge Fillet, rounding the edge.Available in 3ds Max 2008 and higher.

Related Methods:

To press the Chamfer button, see the #ChamferVertex and #ChamferEdge operations in EditPolyMod Interface - Operation Methods

Connect

   

<Edit_Poly>.connectEdgeSegments Integer default: 1 -- animatable; integer; Connect_Edge_Segments 

Get/Set the default Connect Edge Segments value.

   

<Edit_Poly>.connectEdgePinch Integer default: 0 -- animatable; integer; Connect_Edge_Pinch 

Get/Set the Pinch value in the Edge Connect options dialog. Available in 3ds Max 8 and higher.

   

<Edit_Poly>.connectEdgeSlide Integer default: 0 -- animatable; integer; Connect_Edge_Slide 

Get/Set the Slide value in the Edge Connect options dialog. Available in 3ds Max 8 and higher.

Related Methods:

To press the Connect button, see the #ConnectVertices and #ConnectEdges operations in EditPolyMod Interface - Operation Methods

Outline

   

<Edit_Poly>.outlineAmount Float default: 0.0 -- animatable; world units; Outline_Amount 

Get/Set the outline amount value.

Related Methods:

To press the Outline button, see the #Outline operation in EditPolyMod Interface - Operation Methods

Bevel

   

<Edit_Poly>.bevelHeight Float default: 0.0 -- animatable; world units; Bevel_Height 

Get/Set the Bevel Extrusion Height value

   

<Edit_Poly>.bevelOutline Float default: 0.0 -- animatable; world units; Bevel_Outline 

Get/Set the Bevel Outline value.

   

<Edit_Poly>.bevelType Integer default: 0 -- integer; Bevel_Type 

Get/Set the Extrusion Type in the Bevel dialog

0 - Group

1 - Local Normal

2 - by Polygon

Related Methods:

To press the Bevel button, see the #Bevel operation in EditPolyMod Interface - Operation Methods

Inset

   

<Edit_Poly>.insetAmount Float default: 0.0 -- animatable; world units; Inset_amount 

Get/Set the Inset Amount value.

   

<Edit_Poly>.insetType Integer default: 0 -- integer; Inset_Type 

Get/Set the Inset Type:

0 - Group

1 - By Polygon

Related Methods:

To press the Inset button, see the #Inset operation in EditPolyMod Interface - Operation Methods

Bridge

   

<Edit_Poly>.bridgeSelected Integer default: 1-- integer; Bridge_Selected 

Get/Set the state of the radio buttons in the Bridge dialog.

Possible values are:

0 - Use Specific Polygons

1 - Use Polygon Selection

   

<Edit_Poly>.bridgeSegments Integer default: 1 -- animatable; integer; Bridge_Segments 

Get/Set the number of Bridge segments.

   

<Edit_Poly>.bridgeTaper Float default: 0.0 --animatable; float; Bridge_Taper 

Get/Set the Bridge Taper value.

   

<Edit_Poly>.bridgeBias Float default: 0.0 --animatable; float; Bridge_Bias 

Get/Set the Bridge Bias value.

   

<Edit_Poly>.bridgeSmoothThreshold Float default: 45.0 -- animatable; angle; Bridge_Smoothing_Threshold; 

Get/Set the Bridge Smooth Threshold.

   

<Edit_Poly>.bridgeTarget1 Integer default: 0-- integer; Bridge_Target_1 

Get/Set the index of the Bridge's first Target Polygon.

   

<Edit_Poly>.bridgeTarget2 Integer default: 0-- integer; Bridge_Target_2 

Get/Set the index of the Bridge's second Target Polygon.

   

<Edit_Poly>.bridgeTwist1 Integer default:0 -- integer; Bridge_Twist_1 

Get/Set the first Twist value.

   

<Edit_Poly>.bridgeTwist2 Integer default:0 -- integer; Bridge_Twist_2 

Get/Set the second Twist value.

   

<Edit_Poly>.bridgeEdgeAdjacent Float default: 45.0 -- animatable; angle; Bridge_Adjacent 

Get/Set the Bridge Adjacent value.Available in 3ds Max 8 and higher.

   

<Edit_Poly>.bridgeReverseTriangle Integer default: 0 -- integer; Reverse_Triangles 

Get/Set the state of the Reverse Triangulation checkbox.Available in 3ds Max 8 and higher.

Possible values are

0 - disabled

1 - enabled

Related Methods:

To press the Bridge button, see the #BridgeBorder and #BridgePolygon operations and #PickBridgeTarget1 and #PickBridgeTarget2 command modes in EditPolyMod Interface - Operation Methods

See also EditPolyMod Interface - Bridge Methods

Hinge

<Edit_Poly>.hingeAngle Float default: 0.0 -- animatable; angle; Hinge_From_Edge_Angle 

Get/Set the Hinge Angle value.

   

<Edit_Poly>.hingeBase Point3 default: [0,0,0] -- animatable; point3; Hinge_from_Edge_Base 

   

<Edit_Poly>.hingeDirection Point3 default: [1,0,0] -- animatable; point3; Hinge_from_Edge_Direction 

   

<Edit_Poly>.hingeSegments Integer default: 1 -- animatable; integer; Hinge_From_Edge_Segments 

Get/Set the Hinge Segment value.

Related Methods:

To press the Hinge button, see the #HingeFromEdge operation and the #HingeFromEdge and # PickHinge command modes in EditPolyMod Interface - Operation Methods

Extrude Along Spline

<Edit_Poly>.extrudeAlongSplineAlign BooleanClass default: true -- animatable; boolean; Extrude_Along_Spline_Align 

Get/Set the state of the Align To Face Normal checkbox in the Extrude Along Spline dialog.

   

<Edit_Poly>.extrudeAlongSplineNode UndefinedClass default: undefined -- node; Extrude_Along_Spline_Node 

Get/Set the spline node for the Extrude Along Spline.

   

<Edit_Poly>.extrudeAlongSplineRotation Float default: 0.0 -- animatable; angle; Extrude_Along_Spline_Rotation; 

Get/Set the rotation value in the Extrude Along Spline dialog.

   

<Edit_Poly>.extrudeAlongSplineSegments Integer default: 6 -- animatable; integer; Extrude_Along_Spline_Segments 

Get/Set the number of segments value in the Extrude Along Spline dialog.

   

<Edit_Poly>.extrudeAlongSplineTaper Float default: 0.0 -- animatable; float; Extrude_Along_Spline_Taper_Amount 

Get/Set the taper amount in the Extrude Along Spline dialog.

   

<Edit_Poly>.extrudeAlongSplineTaperCurve Float default: 0.0 -- animatable; float; Extrude_Along_Spline_Taper_Curve 

Get/Set the taper curve value in the Extrude Along Spline dialog.

   

<Edit_Poly>.extrudeAlongSplineTwist Float default: 0.0 -- animatable; angle; Extrude_Along_Spline_Twist 

Get/Set the twist value in the Extrude Along Spline dialog.

Related Methods:

To press the Extrude Along Spline button, see the #ExtrudeAlongSpline operation in EditPolyMod Interface - Operation Methods

Remove Vertex/Edge

No properties related to this feature are exposed. To press the Remove button, see the #RemoveVertex and #RemoveEdge operations in EditPolyMod Interface - Operation Methods

Break Vertex

No properties related to this feature are exposed. To press the Break button, see the #BreakVertex operation in EditPolyMod Interface - Operation Methods

Split Edge

No properties related to this feature are exposed. To press the Split button, seet he #SplitEdges operation in EditPolyMod Interface - Operation Methods

Flip Face/Element

No properties related to this feature are exposed. To press the Flip button, see the #FlipFace and #FlipElement operations in EditPolyMod Interface - Operation Methods

Insert Vertex in Edge/Face

No properties related to this feature are exposed. To press the Insert Vertex button, see the #InsertVertexInEdge and #InsertVertexInFace operations in EditPolyMod Interface - Operation Methods

Remove Isolated Vertices

No properties related to this feature are exposed. To press the RemoveIsolated Vertices / Remove Unused Map Verts buttons, see the #RemoveIsoVerts and #RemoveIsoMapVerts operations in EditPolyMod Interface - Operation Methods

Edit Geometry

Constraints

   

<Edit_Poly>.constrainType Integer default: 0 -- integer; Vertex_Constraint_Type 

Get/Set the Vertex Constraint type.

Valid values are:

0 - None

1 - Edge

2 - Face

3 - Normal

Preserve UVs

<Edit_Poly>.preserveUVs BooleanClass default: false -- boolean; Preserve_UVs 

Get/Set the state of the Preserve UVs checkbox. When set to true, moving sub-object elements will not affect the texture coordinates.

Related Methods:

For related methods, see EditPolyMod Interface - PreserveMap Methods

Relaxdialog

<Edit_Poly>.relaxAmount Float default: 0.5 -- animatable; float; Amount 

Get/Set the relax Amount.

   

<Edit_Poly>.relaxIterations Integer default: 1 -- animatable; integer; Iterations 

Get/Set the relax Iterations value.

   

<Edit_Poly>.relaxHoldBoundaryPoints BooleanClass default: true -- boolean; Hold_Boundary_Points 

Get/Set the state of the Hold Boundary Points checkbox.

   

<Edit_Poly>.relaxHoldOuterPoints BooleanClass default: false -- boolean; Hold_Outer_Points 

Get/Set the state of the Hold Outer Points checkbox.

Related Methods:

To press the Relax button, see the #Relax operation in EditPolyMod Interface - Operation Methods

Slice Plane

<Edit_Poly>.slice_plane SubAnim default: SubAnim:Slice_Plane -- transform; SubAnim 

   

Edit_Poly.slice_plane - superclass: MAXObject; super-superclass:Value - 3:3 - classID: #(8197, 0) 

   

<Edit_Poly.slice_plane>.position Point3 default: [0,0,0] -- animatable; point3 

Get/Set the position of the slice plane.

   

<Edit_Poly.slice_plane>.rotation Quat default: (quat 0 0 0 1) -- animatable; quat 

Get/Set the rotation of the slice plane.

   

<Edit_Poly.slice_plane>.scale Point3 default: [1,1,1] -- animatable; point3 

Get/Set the scale of the slice plane.

   

<Edit_Poly>.split BooleanClass default: false -- boolean 

Get/Set the state of the Split option.

Related Methods:

To perform Slicing operations, see the #ResetSlicePlane, #Slice and #SliceSelectedFaces operations and the #SlicePlane command mode in EditPolyMod Interface - Operation Methods

See also the EditPolyMod Interface - Slice Methods

Align Plane

<Edit_Poly>.alignPlaneNormal Point3 default: [0,0,0] -- animatable; point3; Align_Plane_Normal 

Get/Set the normal vector of the align plane.

   

<Edit_Poly>.alignPlaneOffset Float default: 0.0 -- animatable; float; Align_Plane_Offset 

Get/Set the offset of the align plane.

   

<Edit_Poly>.alignType Integer default: 0 -- integer; Align_Type 

Get/Set the type of the align plane.

Related Methods:

To perform the Align operation, see the #Align operation in EditPolyMod Interface - Operation Methods

MeshSmooth

<Edit_Poly>.smoothness Float default: 1.0 -- float 

Get/Set the Viewport Smoothness value in the Subdivision Surface rollout.

   

<Edit_Poly>.separateByMaterial BooleanClass default: false -- boolean; Separate_by_Material_ID 

Get/Set the Separate By Materials checkbox in the Subdivision Surface rollout.

   

<Edit_Poly>.separateBySmoothing BooleanClass default: false -- boolean; Separate_by_Smoothing_Groups 

Get/Set the Separate By Smoothing checkbox in the Subdivision Surface rollout.

Related Methods:

To perform the Align operation, see the #MeshSmooth operation in

Tessellate

<Edit_Poly>.tessellateByFace Integer default: 0 -- animatable; integer; Tessellate_By 

Get/Set the Tessellation type:

0 -Edge

1 -Face

   

<Edit_Poly>.tessTension Float default: 0.0 -- animatable; float; Tessellation_Tension 

Get/Set the Tessellation Tension

Related Methods:

To perform the Align operation, see the #Tessellate operation in EditPolyMod Interface - Operation Methods

Delete Isolated Vertices

<Edit_Poly>.deleteIsolatedVerts BooleanClass default: true -- boolean; Delete_Isolated_Vertices 

Get/Set the state of the Delete Isolated Vertices checkbox.

Collapse

No properties related to this feature are exposed. To press the Collapse button, see the #CollapseVertex, #CollapseEdge and #CollapseFace operations in EditPolyMod Interface - Operation Methods

Hide/Unhide

No properties related to this feature are exposed. To press the Hide/Unhide buttons, see the #HideVertex, #HideFace, #HideUnselectedVertex, #HideUnselectedFace, #UnhideAllVertex and #UnhideAllFace operations in EditPolyMod Interface - Operation Methods

Copy/Paste Named Selection Sets

No properties related to this feature are exposed. To press th eCopy/Paste buttons, see the #NamedSelectionCopy and #NamedSelectionPaste operations in EditPolyMod Interface - Operation Methods

Make Planar

No properties related to this feature are exposed. To press the Make Planar buttons, see the #MakePlanar, #MakePlanarInX, #MakePlanarInY and #MakePlanarInZ operations in EditPolyMod Interface - Operation Methods

PolygonMaterial IDs

   

<Edit_Poly>.materialIDToSet Integer default: 0 -- animatable; integer; Material_ID_to_Set 

Get/Set the material ID value to set for the selected faces.

   

<Edit_Poly>.selectByMaterialID Integer default: 0 -- integer; Select_By_Material_ID 

Get/Set the ID to use in the Select By Material ID feature.

   

<Edit_Poly>.selectByMaterialClear BooleanClass default: false -- boolean; Select_By_Material_Clear 

Get/Set the Clear checkbox state in the Select By Material ID feature. When set to true, the previous selection will be cleared before new faces are selected.

Methods:

   

<Edit_Poly>.MatID Floater() 

Toggles the visibility of a Polygon Material IDs floater version of this rollout.

Available in 3ds Max 2010 and higher.

   

<bool><Edit_Poly>.MatID FloaterVisible() 

Returns true if the Polygon Material IDs floater is visible, false if it is hidden.

Available in 3ds Max 2010and higher.

Related Methods:

To press the Select ID button, see the #SelectByMaterial operation in EditPolyMod Interface - Operation Methods

Polygon Smoothing Groups

   

<Edit_Poly>.smoothingGroupsToSet Integer default: 0 -- integer; Smoothing_Groups_to_Set 

Get/Set the smoothing group to set.

NOTE:

The value is a long integer where each of the 32 bits stands for a smoothing group to be set. The first bit is 2^0, the second is 2^1 and so on, the last bit is 2^31. To calculate the integer to assign to this property, calculate the sum of all the bits to be set.

For example, to set bit 20, you would set the value to 2^(20-1) =524288.

To set smoothing groups 1, 5 and 17, you need to add 2^(1-1) + 2^(5-1) + 2^(17-1) =65553

   

<Edit_Poly>.smoothingGroupsToClear Integer default: 0 -- integer; Smoothing_Groups_to_Clear 

Get/Set the smoothing groups to clear. The value is a long integer where each of the 32 bits stands for a smoothing group to be cleared.See previous property for an example.

   

<Edit_Poly>.selectBySmoothingGroup Integer default: 0 -- integer; Select_By_Smoothing_Group 

Get/Set the smoothing groupsto select by.

   

<Edit_Poly>.selectBySmoothingGroupClear BooleanClass default: false -- boolean; Select_By_Smoothing_Group_Clear 

Get/Set the Clear checkbox state in the Select By Smooth Group dialog. When set to true, the previous selection will be cleared before new faces are selected.

   

<Edit_Poly>.autoSmoothThreshold Float default: 45.0 -- animatable; angle; Autosmooth_Threshold 

Get/Set the auto-smoothing threshold angle. The angle between the normals of two neighbor faces will be compared to the threshold. If below the threshold, the two faces will be automatically assigned the same smoothing group, causing smooth shading across the common edge.

   

Methods:

<Edit_Poly>.SmGrp Floater() 

Toggles the visibility of a Smoothing Groups floater version of this rollout.

Available in 3ds Max 2010 and higher.

   

<bool><Edit_Poly>.SmGrp FloaterVisible() 

Available in 3ds Max 2010 and higher.

Related Methods:

See the #SelectBySmooth, #AutoSmooth and #SetSmooth operations in EditPolyMod Interface - Operation Methods

Paint Deformation

   

<Edit_Poly>.paintDeformAxis Integer default: 1 -- integer; Push_Pull_Direction 

Get/Set the state of the Push/Pull Direction radio buttons in the Paint Deformation rollout.

Possible values are:

1 -Original Normals

2 -Deformed Normals

3 -Transform Axis : X

4 -Transform Axis : Y

5 -Transform Axis : Z

   

<Edit_Poly>.paintDeformValue Float default: 10.0 -- float; Deformation_Value 

Get/Set the Value applied by the Paint Deform brush.

   

<Edit_Poly>.paintDeformSize Floatdefault: 10.0 -- world units; Deformation_Size 

Get/Set the Size of the Paint Deform brush.

   

<Edit_Poly>.paintDeformStrength Float default: 1.0 -- float; Deformation_Strength 

Get/Set the Strength of the Paint Deform brush.

Other Properties

   

<Edit_Poly>.breakDistance Float default: 0.0 -- animatable; float; Amount 

Get/Set the break distance value. Available in 3ds Max 8 and higher.

   

<Edit_Poly>.remveEdgeCtrlKey BooleanClass default: false -- boolean; Remove_Edge_Control_Key 

Get/Set the remove edge control key option state. Available in 3ds Max 8 and higher.

Topic Navigation

   

Edit_Poly Interfaces:

Interface:EditPolyMod 
NOTE:

The EditPolyMod Interface is a [Mixin Interface] exposed by the Edit_Poly modifier.

You can call the methods listed below by accessing the Interface as stand-alone, passing the Edit_Poly modifier as first argument before all other arguments.

Thus, you could say

EditPolyMod.GetSelection $Box01.modifiers[#Edit_Poly] #Vertex
--or shorter,
EditPolyMod.GetSelection $Box01.Edit_Poly #Vertex

You can also call the methods listed below as methods exposed by the Edit_Poly modifier itself because MAXScript will search both the modifier and all its Interfaces for the method name.

Thus, instead of saying something like

$Box01.modifiers[#Edit_Poly].EditPolyMod.GetSelection #Vertex
--or
$Box01.Edit_Poly.EditPolyMod.GetSelection #Vertex

you could say either

$Box01.modifiers[#Edit_Poly].GetSelection #Vertex
--or
$Box01.Edit_Poly.GetSelection #Vertex

The stand-alone interface access is typically orders of magnitude faster than the alternative method!

Methods:

Selection Methods

Topic Navigation

<enum>GetEPolySelLevel() 

GetEPolySelLevel enums: {#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 

Returns the EditPoly selection level.

   

<enum>GetMeshSelLevel() 

GetMeshSelLevel enums: {#Object|#Vertex|#Edge|#Face|#CurrentLevel} 

Returns the Mesh selection level.

When the Edit Poly selection level is set to #Border , the Mesh selection level is returned as #Edge .

When the Edit Poly selection level is set to #Element , the Mesh selection level is returned as #Face .

   

<void>SetEPolySelLevel <enum>selectionLevel 

selectionLevel enums: {#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 

Sets the EditPoly selection level.

   

<integer>ConvertSelection <enum>fromLevel <enum>toLevel requireAll:<bool> 

fromLevel enums: {#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 
toLevel enums: {#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 
requireAll default value: false 

Converts the selection from the fromLevel into the toLevel. If requireAll :is set to true , all source subelements shared by a target subelement must be selected for the target subelement to be selected. For example, a polygon will only be selected if all its vertices are selected, a vertex will be selected only if all polygons that share it are selected etc.

   

<bitArray>GetSelection <enum>meshSelLevel node:<node> 

meshSelLevel enums: {#Object|#Vertex|#Edge|#Face|#CurrentLevel} 
node default value: undefined 

Returns the specified selection as bitArray value.

If node : is supplied, returns the selection from the modifierinstanceassigned to the specified node.

   

<bool>SetSelection <enum>meshSelLevel <&bitArray>newSelection node:<node> 

meshSelLevel enums: {#Object|#Vertex|#Edge|#Face|#CurrentLevel} 
newSelection is In and Out parameter node default value: undefined 

Sets the specified selection using the supplied bitArray.

If node : is supplied, uses the modifierinstanceassigned to the specified node.

   

<bool>Select <enum>meshSelLevel <&bitArray>newSelection invert:<bool> select:<bool> node:<node> 

meshSelLevel enums: {#Object|#Vertex|#Edge|#Face|#CurrentLevel} 
newSelection is In and Out parameter 
invert default value: false 
]select default value: true 
node default value: undefined 

Adds the bitArray passed by reference to the sub-object selectionatthe specified sub-object level.The modifier must be displayed in the command panel andmust bein the requested sub-object mode for the selection to be set correctly.

If the optional invert : keyword is supplied and set to true ,theselected state of thespecified sub-objectswill be inverted - if they were selected they will be deselected and vice-versa.If false or not supplied, they willbecome selected orremain selectedif they were selected already.

If the optional select: keyword is supplied and set to false , thespecified sub-objects will be deselected if they were already selected, or remain deselected if they were not selected. If true or not supplied, they will be selected if they were previously not or remain selected if they were already selected.

If themodifieris instanced across multiple nodes and the optional node : keyword is supplied, the method will use the specified node.

EXAMPLE:

--Create a box with 10x10x10 segments:
b = box width:100 length:100 height:100 heightsegs:10 widthsegs:10 lengthsegs:10
ep = Edit_Poly()--create an Edit_Poly modifier
addModifier b ep--add the Edit_Poly modifier to the box
maxmodify mode--switch to Modify tab of Command panel
modPanel.setCurrentObject ep--set the Edit_Poly as the current level
subObjectLevel = 3--switch to Border level
--Now print the selection level using stand-alone interface access:
format"Selection Level Is: %\n"(EditPolyMod.GetEPolySelLevel ep)
--Now print the Mesh selection level using interface access via the modifier:
format"Mesh Selection Level Is: %\n"(ep.EditPolyMod.GetMeshSelLevel())
subObjectLevel = 4--switch to Face level
--Select a whole side of the box- last 100 polygons. Call the method
--without explicitly specifying the EditPolyMod interface - still works:
ep.Select #Face #{501..600}
ep.convertSelection #Face #Edge--convert the face selection to edge selection
subObjectLevel = 2--switch to edge mode to see the result 

OUTPUT:

$Box:Box01 @ [0.000000,0.000000,0.000000]
Edit_Poly:Edit Poly
OK
OK
OK
3
Selection Level Is: #Border
OK
Mesh Selection Level Is: #edge
OK
4
true
220
2

   

<void>MoveSelection <&point3>amount parent:<&matrix3> axis:<&matrix3> localOrigin:<boolean> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter
localOrigin default value: false

Moves the current selection by the specified Point3 value.

If parent :is specified, its local coordinate system is used.

If axis :is specified, it is used as a custom coordinate system.

If localOrigin :is specified, the translation will be using the selection's local transformation center as the origin.

   

<void>RotateSelection <&quat>amount parent:<&matrix3> axis:<&matrix3> localOrigin:<boolean> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter
localOrigin default value: false

Rotates the current selection by the specified quaternion value.

If parent: is specified, its local coordinate system is used.

If axis: is specified, it is used as a custom coordinate system.

If localOrigin: is specified, the rotation is about the selection's local transformation center.

   

<void>ScaleSelection <&point3>amount parent:<&matrix3> axis:<&matrix3> localOrigin:<boolean> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter
localOrigin default value: false

Scales the current selection by the specified Point3 value.

If parent: is specified, its local coordinate system is used.

If axis: is specified, it is used as a custom coordinate system.

If localOrigin: is specified, the scaling is about the selection's local transformation center.

   

<void>RingSelect <integer>RingValue <bool>MoveOnly <bool>Add 

Moves the Ring selection. Available in 3ds Max 8 and higher.

RingValue is the quantity of edges to shift.

If MoveOnly is true , the selected edges will be moved,

If Addis true and MoveOnly is true , newly selected edges will be added to the current selection.

If MoveOnly is true and Add is false , newly selected edges will be removed fromthe current selection.

EXAMPLE:

p = plane width:100 length:100 widthsegs:10 lengthsegs:10--create a plane
ep = Edit_Poly()--create an Edit_Poly modifier
addModifier p ep--add modifier to the plane
maxmodify mode--switch to modify mode
select p--select theplane
subObjectLevel = 2--switch to Edge mode
ep.select #Edge #{1}--select first edge
ep.ButtonOp #SelectEdgeLoop--select Loop using the first edge
ep.RingSelect3true false--shift the selection by 3 

Shiftingone or all edge loopsby 3usingall possible argument combinations:

MoveOnly

Add

Result:

true

false

 

true

false

 

true

true

 

true

true

 

false

true

 

false

true

 

false

false

 

false

false

 

   

<void>LoopSelect <integer>LoopValue <bool>MoveOnly <bool>Add 

Moves the Loop selection. Available in 3ds Max 8 and higher.

LoopValue is the quantity of edges to shift.

If MoveOnly is true , the selected edges will be moved,

If Add is true and MoveOnly is true , newly selected edges will be added to the current selection.

If MoveOnly is true and Add is false , newly selected edges will be removed from the current selection.

   

<integer>ConvertSelectionToBorder <enum>fromLevel <enum>toLevel 

fromLevel enums:{#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 
toLevel enums:{#Object|#Vertex|#Edge|#Border|#Face|#Element|#CurrentLevel} 

Converts the current selection to border selection. The first argument represent the sub-object type to convert from, the second one represents the sub-object type to convert to.

Available in 3ds Max 8 and higher.

EXAMPLE:

p = plane width:100 length:100 widthsegs:10 lengthsegs:10--create a plane
ep = Edit_Poly()--create an Edit_Poly modifier
addModifier p ep--add modifier to the plane
maxmodify mode--switch to modify mode
select p--select theplane
subObjectLevel = 4--switch to face SO level
editPolyMod.select ep #Face #{12,13,14,23,33}--select some faces
editPolyMod.ConvertSelectionToBorder ep #Face #Edge--convert to edge selection
subObjectLevel = 2--switch toedgeSO levelto see the result: 

Operation Methods

Topic Navigation

<enum>GetOperation() 

GetOperation enums: {#GrowSelection | #ShrinkSelection | #SelectEdgeLoop | #SelectEdgeRing | #GetStackSelection | #HideVertex | #HideFace | #HideUnselectedVertex | #HideUnselectedFace | #UnhideAllVertex | #UnhideAllFace | #NamedSelectionCopy | #NamedSelectionPaste | #Cap | #DeleteVertex | #DeleteFace | #RemoveVertex | #RemoveEdge | #DetachVertex | #DetachFace | #SplitEdges | #BreakVertex | #CollapseVertex | #CollapseEdge | #CollapseFace | #ResetSlicePlane | #Slice | #SliceSelectedFaces | #Cut | #WeldVertex | #WeldEdge | #CreateShape | #MakePlanar | #MakePlanarInX | #MakePlanarInY | #MakePlanarInZ | #Align | #Relax | #MeshSmooth | #Tessellate | #Retriangulate | #FlipFace | #FlipElement | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #Bevel | #Inset | #Outline | #ExtrudeAlongSpline | #HingeFromEdge | #ConnectVertices | #ConnectEdges | #ChamferVertex | #ChamferEdge | #RemoveIsoVerts | #RemoveIsoMapVerts | #ToggleShadedFaces | #TransformVertex | #TransformEdge | #TransformFace | #Create | #Attach | #TargetWeldVertex | #TargetWeldEdge | #EditTriangulation | #TurnEdge | #CreateEdge | #CloneVertex | #CloneEdge | #CloneFace | #InsertVertexInEdge | #InsertVertexInFace | #Autosmooth | #SetSmooth | #SetMaterial | #SelectBySmooth | #SelectByMaterial | #BridgeBorder | #BridgePolygon | #DeleteEdge} 

Returns the current EditPoly Operation.

   

<void>SetOperation<enum>operation 

operation enums: {#GrowSelection | #ShrinkSelection | #SelectEdgeLoop | #SelectEdgeRing | #GetStackSelection | #HideVertex | #HideFace | #HideUnselectedVertex | #HideUnselectedFace | #UnhideAllVertex | #UnhideAllFace | #NamedSelectionCopy | #NamedSelectionPaste | #Cap | #DeleteVertex | #DeleteFace | #RemoveVertex | #RemoveEdge | #DetachVertex | #DetachFace | #SplitEdges | #BreakVertex | #CollapseVertex | #CollapseEdge | #CollapseFace | #ResetSlicePlane | #Slice | #SliceSelectedFaces | #Cut | #WeldVertex | #WeldEdge | #CreateShape | #MakePlanar | #MakePlanarInX | #MakePlanarInY | #MakePlanarInZ | #Align | #Relax | #MeshSmooth | #Tessellate | #Retriangulate | #FlipFace | #FlipElement | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #Bevel | #Inset | #Outline | #ExtrudeAlongSpline | #HingeFromEdge | #ConnectVertices | #ConnectEdges | #ChamferVertex | #ChamferEdge | #RemoveIsoVerts | #RemoveIsoMapVerts | #ToggleShadedFaces | #TransformVertex | #TransformEdge | #TransformFace | #Create | #Attach | #TargetWeldVertex | #TargetWeldEdge | #EditTriangulation | #TurnEdge | #CreateEdge | #CloneVertex | #CloneEdge | #CloneFace | #InsertVertexInEdge | #InsertVertexInFace | #Autosmooth | #SetSmooth | #SetMaterial | #SelectBySmooth | #SelectByMaterial | #BridgeBorder | #BridgePolygon | #DeleteEdge} 

Puts the Edit Poly modifier into the specified Operation mode.

   

<void>PopupDialog<enum>operation 

operation enums: {#GrowSelection | #ShrinkSelection | #SelectEdgeLoop | #SelectEdgeRing | #GetStackSelection | #HideVertex | #HideFace | #HideUnselectedVertex | #HideUnselectedFace | #UnhideAllVertex | #UnhideAllFace | #NamedSelectionCopy | #NamedSelectionPaste | #Cap | #DeleteVertex | #DeleteFace | #RemoveVertex | #RemoveEdge | #DetachVertex | #DetachFace | #SplitEdges | #BreakVertex | #CollapseVertex | #CollapseEdge | #CollapseFace | #ResetSlicePlane | #Slice | #SliceSelectedFaces | #Cut | #WeldVertex | #WeldEdge | #CreateShape | #MakePlanar | #MakePlanarInX | #MakePlanarInY | #MakePlanarInZ | #Align | #Relax | #MeshSmooth | #Tessellate | #Retriangulate | #FlipFace | #FlipElement | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #Bevel | #Inset | #Outline | #ExtrudeAlongSpline | #HingeFromEdge | #ConnectVertices | #ConnectEdges | #ChamferVertex | #ChamferEdge | #RemoveIsoVerts | #RemoveIsoMapVerts | #ToggleShadedFaces | #TransformVertex | #TransformEdge | #TransformFace | #Create | #Attach | #TargetWeldVertex | #TargetWeldEdge | #EditTriangulation | #TurnEdge | #CreateEdge | #CloneVertex | #CloneEdge | #CloneFace | #InsertVertexInEdge | #InsertVertexInFace | #Autosmooth | #SetSmooth | #SetMaterial | #SelectBySmooth | #SelectByMaterial | #BridgeBorder | #BridgePolygon | #DeleteEdge} 

Opens the corresponding pop-up dialog.

   

<void>ButtonOp<enum>operation 

operation enums: {#GrowSelection | #ShrinkSelection | #SelectEdgeLoop | #SelectEdgeRing | #GetStackSelection | #HideVertex | #HideFace | #HideUnselectedVertex | #HideUnselectedFace | #UnhideAllVertex | #UnhideAllFace | #NamedSelectionCopy | #NamedSelectionPaste | #Cap | #DeleteVertex | #DeleteFace | #RemoveVertex | #RemoveEdge | #DetachVertex | #DetachFace | #SplitEdges | #BreakVertex | #CollapseVertex | #CollapseEdge | #CollapseFace | #ResetSlicePlane | #Slice | #SliceSelectedFaces | #Cut | #WeldVertex | #WeldEdge | #CreateShape | #MakePlanar | #MakePlanarInX | #MakePlanarInY | #MakePlanarInZ | #Align | #Relax | #MeshSmooth | #Tessellate | #Retriangulate | #FlipFace | #FlipElement | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #Bevel | #Inset | #Outline | #ExtrudeAlongSpline | #HingeFromEdge | #ConnectVertices | #ConnectEdges | #ChamferVertex | #ChamferEdge | #RemoveIsoVerts | #RemoveIsoMapVerts | #ToggleShadedFaces | #TransformVertex | #TransformEdge | #TransformFace | #Create | #Attach | #TargetWeldVertex | #TargetWeldEdge | #EditTriangulation | #TurnEdge | #CreateEdge | #CloneVertex | #CloneEdge | #CloneFace | #InsertVertexInEdge | #InsertVertexInFace | #Autosmooth | #SetSmooth | #SetMaterial | #SelectBySmooth | #SelectByMaterial | #BridgeBorder | #BridgePolygon | #DeleteEdge} 

Presses the corresponding User Interface button.

   

<void>Commit() 

Corresponds to pressing the Commit button in the User Interface. Commits the edits.

   

<void>CommitUnlessAnimating() 

Pressed the Commit button in the User Interface unless the modifier is in animation mode.

   

<void>CommitAndRepeat() 

Pressed the Commit button and repeats the last operation

   

<void>Cancel() 

Corresponds to pressing the Cancel button, rejects all changes in the current operation.

   

<void>ToggleCommandMode <enum>commandMode 

commandMode enums: {#CreateVertex | #CreateEdge | #CreateFace | #DivideEdge | #DivideFace | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #ChamferVertex | #ChamferEdge | #Bevel | #InsetFace | #OutlineFace | #SlicePlane | #Cut | #Weld | #EditTriangulation | #TurnEdge | #QuickSlice | #HingeFromEdge | #PickHinge | #BridgeBorder | #BridgePolygon | #PickBridgeTarget1 | #PickBridgeTarget2} 

Toggles the specified command mode. Enables if disabled, disables if enabled.

   

<void>EnterCommandMode <enum>commandMode 

commandMode enums: {#CreateVertex | #CreateEdge | #CreateFace | #DivideEdge | #DivideFace | #ExtrudeVertex | #ExtrudeEdge | #ExtrudeFace | #ChamferVertex | #ChamferEdge | #Bevel | #InsetFace | #OutlineFace | #SlicePlane | #Cut | #Weld | #EditTriangulation | #TurnEdge | #QuickSlice | #HingeFromEdge | #PickHinge | #BridgeBorder | #BridgePolygon | #PickBridgeTarget1| #PickBridgeTarget2} 

Enables the specified command mode.

   

<void>EnterPickMode <enum>commandMode 

commandMode enums: {#Attach|#PickShape} 

Enters the specified pick mode.

   

<enum>GetCommandMode() 

GetCommandMode enums: {#CreateVertex| #CreateEdge| #CreateFace| #DivideEdge| #DivideFace| #ExtrudeVertex| #ExtrudeEdge| #ExtrudeFace| #ChamferVertex| #ChamferEdge| #Bevel| #InsetFace| #OutlineFace| #SlicePlane| #Cut| #Weld| #EditTriangulation| #TurnEdge| #QuickSlice| #HingeFromEdge| #PickHinge| #BridgeBorder| #BridgePolygon| #PickBridgeTarget1| #PickBridgeTarget2} 

Returns the current command mode. Returns -1 if no mode is enabled.

   

<enum>GetPickMode() 

   

GetPickMode enums: {#Attach|#PickShape} 

Returns the current pick mode. Returns -1 if no mode is enabled.

   

<void>RepeatLastOperation() 

Corresponds to pressing the Repeat Last button in the Edit Geometry rollout. Repeats the last operation.

   

<bool>ShowOperationDialog() 

Shows the operation dialog. Available in 3ds Max 8 and higher.

   

<bool>ShowingOperationDialog() 

Returns true if the modifier is showing an operation dialog, false otherwise. Available in 3ds Max 8 and higher.

   

<void>CloseOperationDialog() 

Closes the operation dialog. Available in 3ds Max 8 and higher.

Topology Editing Methods

Topic Navigation

   

Slice Methods

Topic Navigation

<void>MoveSlicePlane <&point3>amount parent:<&matrix3> axis:<&matrix3> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter

Moves the slice plane by the specified Point3 value. If parent is specified, its local coordinate system is used. If axis is specified, it is used as a custom coordinate system.

   

<void>RotateSlicePlane <&quat>amount parent:<&matrix3> axis:<&matrix3>localOrigin:<boolean> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter
localOrigin default value: false

Rotates the slice plane by the specified quaternion value. If parent is specified, its local coordinate system is used. If axis is specified, it is used as a custom coordinate system. If localOrigin is specified, the rotation is about the slice plane's local transformation center.

   

<void>ScaleSlicePlane <&point3>amount parent:<&matrix3> axis:<&matrix3> localOrigin:<boolean> 

amount is In parameter
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
parent is In parameter
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis is In parameter
localOrigin default value: false

Scales the slice plane by the specified Point3 value. If parent is specified, its local coordinate system is used. If axis is specified, it is used as a custom coordinate system. If localOrigin is specified, the scaling is about the slice plane's local transformation center.

   

<bool>InSlicePlaneMode() 

Returns true if the Edit Poly modifier is in slice plane mode, false otherwise.

   

<void>ResetSlicePlane() 

Resets the slice plane.

   

<matrix3 by value>GetSlicePlaneTM() 

GetSlicePlaneTM - noautomatic redraw after invoked

Returns the transformation matrix of the slice plane.

   

<void>SetSlicePlane c<&am;point3>planeNormal <&point3>planeCenter 

planeNormal is In parameter
planeCenter is In parameter

Sets the slice plane orientation using the supplied normal vector and plane center.

   

<void>GetSlicePlane <&point3>planeNormal <&point3>planeCenter 

planeNormal is Out parameter
planeCenter is Out parameter

Returns the normal vector and plane center of the slice plane by writing into the supplied by-reference arguments.

   

<bool>InSlice() 

Returns true if the modifier is in Slice mode, false otherwise. Available in 3ds Max 8 and higher.

Create Methods

Topic Navigation

<index>CreateVertex <point3>point node:<node> 

node default value: undefined

Creates a new vertex at the specified point. Returns the index of the new vertex.

   

<index>CreateFace <index array>vertices node:<node> 

node default value: undefined

Creates a new face from the supplied array of indices. Returns the index of the new face.

   

<index>CreateEdge <index>vertex1 <index>vertex2 node:<node> 

node default value:undefined

Creates an edge between the two supplied vertex indices. Returns the index of the new edge.

Edit Triangulation Methods

Topic Navigation

<void>SetDiagonal <index>vertex1 <index>vertex2 node:<node> 

node default value: undefined

Sets the diagonal between vertex1 and vertex2. This method can be used to manually adjust triangulation.

Cut Methods

Topic Navigation

<void>StartCut <enum>level <index>index <point3>point <point3>normal node:<node> 

level enums: {#Object | #Vertex | #Edge | #Face | #CurrentLevel} node default value: undefined 

Enters Cut mode at the specified sub-object level.

   

<void>SetCutEnd <point3>endPoint node:<node> 

node default value: undefined

Sets the cut end to the specified point in object space. If the optional node parameter is provided, the point will be taken in its object space. This can be useful when the modifier is instanced across multiple nodes. Available in 3ds Max 8 and higher.

   

<index>GetLastCutEnd() 

Returnsthe index of the last cut end. Available in 3ds Max 8 and higher.

   

<void>ClearLastCutEnd() 

Clears the last cut end. Available in 3ds Max 8 and higher.

   

<void>CutCancelnode:<node> 

node default value: undefined

Cencels the cut. Available in 3ds Max 8 and higher.

Weld Methods

Topic Navigation

<void>WeldVertices <index>vertex1 <index>vertex2 node:<node> 

node default value: undefined

Welds the two specified vertices.

   

<void>WeldEdges <index>edge1 <index>edge2 node:<node> 

node default value: undefined

Welds the two specified edges.

Bridge Methods

Topic Navigation

<void>BridgeBorders <index>edge1 <index>edge2 node:<node> 

node default value: undefined

Bridges the two specified edges.

   

<void>BridgePolygons<index>poly1 <index>poly2 node:<node> 

node default value: undefined

Bridges the two specified polygons.

   

<void>BridgeEdges <index>edge1 <index>edg2 node:<node> 

node default value: undefined

Bridges the two specified edges.Available in 3ds Max 8 and higher.

   

<node>GetBridgeNode() 

Returns the Bridge node.

   

<void>SetBridgeNode<node>node 

Sets the Bridge node.

Divide Methods

Topic Navigation

<index>DivideEdge <index>edgeID <float>proportion node:<node> 

node default value: undefined

Divides the specified edge into two edges with the given proportions.Available in 3ds Max 8 and higher.

   

<index>DivideFace <index>faceID <float array>vertexCoefficients node:<node> 

node default value: undefined

Divides the specified face using the supplied array of vertex coefficients.Available in 3ds Max 8 and higher.

Preserve Map Methods

Topic Navigation

<bool>GetPreserveMap <integer>mapChannel 

Returns the Preserve UVs state for the specified map channel.

   

<void>SetPreserveMap <integer>mapChannel <bool>preserve 

Sets the Preserve UVs state for the specified map channel to the supplied boolean value.

Attach / Detach Methods

Topic Navigation

<void>Attach <node>nodeToAttach editPolyNode:<node> 

editPolyNode default value: undefined

Attaches the specified node.

   

<void>AttachList <&node array>nodesToAttach editPolyNode:<node> 

nodesToAttach is In parameter
editPolyNode default value: undefined

Attaches the specified nodes.

   

<void>DetachToObject <&TSTR>newObjectName 

newObjectName is In and Out parameter

Detaches the selected sub-object selection to a new object with the specified name.

Create Shape Methods

Topic Navigation

<void>CreateShape <&TSTR>newShapeName 

newShapeName is In and Out parameter

Creates a shape with the given name from the selected edges.

Geometry Data Methods

Topic Navigation

<integer>GetNumVerticesnode:<node> 

node default value: undefined

Returns the number of vertices in the Edit_Poly.

   

<point3 by value>GetVertex <index>vertexID node:<node> 

node default value: undefined

Returns the vertex with the specified index.

   

<integer>GetVertexFaceCount <index>vertexID node:<node> 

node default value: undefined

Returns the number of faces sharing the specified indexed vertex.

   

<index>GetVertexFace <index>vertexID <index>face node:<node> 

node default value: undefined

Returns the indexed faces sharing the specified indexed vertex.

   

<integer>GetVertexEdgeCount <index>vertexID node:<node> 

node default value: undefined

Returns the number of edges sharing the specified indexed vertex.

   

<index>GetVertexEdge <index>vertexID <index>edge node:<node> 

node default value: undefined

Returns the indexed edge sharing the specified indexed vertex.

   

<integer>GetNumEdgesnode:<node> 

node default value: undefined

Returns the number of edges.

   

<index>GetEdgeVertex <index>edgeID <index>end node:<node> 

node default value: undefined

Returns the indexed vertex shared by the specified edge.

   

<index>GetEdgeFace <index>edgeID <index>side node:<node> 

node default value: undefined

Returns the indexed face shared by the specified edge.

   

<integer>GetNumFacesnode:<node> 

node default value: undefined

Returns the number of faces.

   

<integer>GetFaceDegree <index>faceID node:<node> 

node default value: undefined

Returns the number of sides (edges / vertices) of the indexed face. A value of 3 means a triangular face, a value of 4 meas a quad face etc.

   

<index>GetFaceVertex <index>faceID <index>corner node:<node> 

node default value: undefined

Returns the vertex used at the specified indexed corner of the given indexed face.

   

<index>GetFaceEdge <index>faceID <index>side node:<node> 

node default value: undefined

Returns the edge used at the specified indexed side of the given indexed face.

   

<index>GetFaceMaterial <index>faceID node:<node> 

node default value: undefined

Returns the Material ID of the indexed face.

   

<DWORD>GetFaceSmoothingGroups <index>faceID node:<node> 

node default value: undefined

Returns the Smoothing group of the indexed face. Smoothing groups are stored in long integers where the 32 bits correspond to the states of the 32 smoothing groups.

   

<integer>GetNumMapChannelsnode:<node> 

node default value: undefined

Returns the number of mapping channels.

   

<bool>GetMapChannelActive <integer>mapChannel node:<node> 

node default value: undefined

Returns true if the supplied mapping channel is active, false otherwise.

   

<integer>GetNumMapVertices <integer>mapChannel node:<node> 

node default value: undefined

Returns the number of map vertices in the specified mapping channel.

   

<point3 by value> GetMapVertex <integer>mapChannel <index>vertexID node:<node> 

node default value: undefined

Returns the indexed map vertex from the specified mapping channel.

   

<index>GetMapFaceVert <integer>mapChannel <index>faceID <index>corner node:<node> 

node default value: undefined

Returns theindexed cornervertexof the indexed facefrom the specified mapping channel.

Other Methods

Topic Navigation

<void>RefreshScreen() 

Redraws the screento update changes.Available in 3ds Max 8 and higher.

   

<void>SetPrimaryNode <node>node 

Sets the primary node. An Edit Poly modifier can be assigned as instance to any number of nodes. This method specifies which is the primary one.

   

<node>GetPrimaryNode() 

Returns the primary node. Available in 3ds Max 8 and higher.

   

<matrix3 by value>GetNodeTMnode:<node> 

node default value: undefined

Returns the Node Transformation Matrix. Available in 3ds Max 8 and higher.

   

<void>Listnode:<node> 

node default value: undefined

   

<void>LocalDataChanged <DWORD>parts 

Available in 3ds Max 8 and higher.

See Also