Edit_Poly -superclass: modifier; super-superclass:MAXWrapper - classID:#(2041212445, 1906341303)
Properties:
<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.
<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 is 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
<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 is not 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 is 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_Poly>.paintSelMode Integer default: 0 -- integer; Paint_Mode
Get/set the Paint Soft Selection mode, where:
<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>.extrudeFaceBias Float default: 1.0 -- animatable; float
Get set the face extrusion bias level. This affects extrusion when extrudeFaceType is 1 (local normal). A setting of 1.0 extrudes faces along their original normal. When two or more faces share an edge, a setting of 0.0 biases the result toward the averages of the shared edges.
<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.
<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.
<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 are removed, leaving an opening. Available in 3ds Max 8 and higher.
<Edit_Poly>.chamferVertexAmount Float default: 1.0 -- animatable; world units; Vertex_Chamfer_Amount
Get/set the Vertex Chamfer amount.
<Edit_Poly>.chamferVertexDepth Float default: 0.5 -- float; Vertex_Depth
Get/set the vertex chamfer depth. Available in 3ds Max 2021 and higher.
<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 are removed, leaving an opening. Available in 3ds Max 8 and higher.
<Edit_Poly>.chamferVertexSegments Integer default: 1 -- integer; Vertex_Chamfer_Segments
Get/set the number of vertex chamfer segments. Available in 3ds Max 2021 and higher.
<Edit_Poly>.chamferVertexSmooth BooleanClass default: true -- boolean; Smooth
Get/set the vertex chamfer smooth setting. Available in 3ds Max 2021 and higher.
<Edit_Poly>.chamferVertexSmoothThreshold Float default: 30.0 -- float; Smooth_Threshold
Get/set the vertex chamfer smoothing threshold. Available in 3ds Max 2021 and higher.
<Edit_Poly>.chamferVertexSmoothType Integer default: 0 -- integer; Smooth_Type
Get/set the vertex chamfer smoothing type, where: Available in 3ds Max 2021 and higher.
<Edit_Poly>.edgeChamferDepth Float default: 0.5 -- float; Edge_Depth
Get/set the edge chamfer depth. Available in 3ds Max 2021 and higher.
<Edit_Poly>.edgeChamferEndBias Float default: 0.5 -- float; Edge_End_Bias
Get/set the edge chamfer end bias. Available in 3ds Max 2021 and higher.
<Edit_Poly>.edgeChamferMiteringType Integer default: 2 -- integer; Chamfer_Edge_Mitering_Type
Get/set the edge chamfer mitering type, where: Available in 3ds Max 2021 and higher.
edgeChamferType
and edgeChamferQuadIntersections
properties.<Edit_Poly>.edgeChamferRadialBias Float default: 0.0 -- float; Edge_Radial_Bias
Get/set the edge chamfer radial bias. Available in 3ds Max 2021 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.
<Edit_Poly>.edgeChamferQuadIntersections BooleanClass default: false -- boolean; alias: quad_intersections
Obsolete: Get/set the Quad Intersections mode. This property is replaced by edgeChamferMiteringType
in 3ds Max 2021.
Related Methods:
To press the Chamfer button, see the #ChamferVertex
and #ChamferEdge
operations in EditPolyMod Interface - Operation Methods.
<Edit_Poly>.edgeChamferSmooth BooleanClass default: true -- boolean; Smooth
Get/set the state of the Smooth checkbox in the Chamfer options dialog.
<Edit_Poly>.edgeChamferSmoothThreshold Float default: 30.0 -- float; Smooth_Threshold
Get/set the value of the "Smooth Threshold" checkbox in the Chamfer options dialog.
<Edit_Poly>.edgeChamferSmoothType Integer default: 0 -- integer; Smooth_Type
Get/set the selection of the Smooth Type option in the Chamfer options dialog.
Possible values are:
0 - Smooth Entire Object
1 - Smooth Chamfers Only
<Edit_Poly>.edgeChamferTension Float default: 1.0 -- float; Edge_Tension
Get/set the Tension value for the Chamfer mode.
<Edit_Poly>.edgeChamferType Integer default: 0 -- integer; Chamfer_Type
Obsolete: Get/set the Chamfer type. This property is replaced by edgeChamferMiteringType
in 3ds Max 2021.
<Edit_Poly>.edgeChamferInvert BooleanClass default: false -- boolean; Invert_Open
Get/set the state of the Invert Open checkbox in the Chamfer options dialog.
When set to True, the chamfered polygons will be retained and the original polygons will be removed.
<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.
<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.
<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.
<Edit_Poly>.bevelFaceBias Float default: 1.0 -- animatable; float
Get/set the Bevel bias value. This affects the bevel when bevelType is 1 (local normal). A setting of 1.0 bevels faces along their original normal. When two or more faces share an edge, a setting of 0.0 biases the result toward the averages of the shared edges.
<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.
<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.
<boolean>editPolyModReadyToBridge()
Returns whether the currently selected faces, edges, borders or elements on the currently selected object with an Edit_Poly modifier applied are ready to bridge. This is similar to EdititablePoly.ReadyToBridgeFlagged(), except it does not take a selection level argument or flag, and applies only to the current selection level.
<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.
<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.
No properties related to this feature are exposed. To press the Remove button, see the #RemoveVertex
and #RemoveEdge
operations in EditPolyMod Interface - Operation Methods.
No properties related to this feature are exposed. To press the Break button, see the #BreakVertex
operation in EditPolyMod Interface - Operation Methods.
No properties related to this feature are exposed. To press the Split button, see the #SplitEdges
operation in EditPolyMod Interface - Operation Methods.
No properties related to this feature are exposed. To press the Flip button, see the #FlipFace
and #FlipElement
operations in EditPolyMod Interface - Operation Methods.
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.
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_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
<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 do not affect the texture coordinates.
Related Methods:
For related methods, see EditPolyMod Interface - PreserveMap Methods.
<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.
<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.
<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.
<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 EditPolyMod Interface - Operation Methods.
<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.
<Edit_Poly>.deleteIsolatedVerts BooleanClass default: true -- boolean; Delete_Isolated_Vertices
Get/set the state of the Delete Isolated Vertices checkbox.
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.
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.
No properties related to this feature are exposed. To press the Copy/Paste buttons, see the #NamedSelectionCopy
and #NamedSelectionPaste
operations in EditPolyMod Interface - Operation Methods.
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.
<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 is 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.
<boolean><Edit_Poly>.MatID FloaterVisible()
Returns true if the Polygon Material IDs floater is visible, false if it is hidden.
Available in 3ds Max 2010 and higher.
Related Methods:
To press the Select ID button, see the #SelectByMaterial
operation in EditPolyMod Interface - Operation Methods.
<Edit_Poly>.smoothingGroupsToSet Integer default: 0 -- integer; Smoothing_Groups_to_Set
Get/set the smoothing group to set.
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, and 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 can 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 groups to 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 is 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 are compared to the threshold. If below the threshold, the two faces are 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.
<boolean><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.
<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.
<Edit_Poly>.paintDeformMode Integer default: 0 -- integer; Paint_Mode
Get/set the Paint Deformation mode, where:
<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.
<Edit_Poly>.dataChannel Integer default: 0 -- integer
Get/set the data channel as integer.
Available in 3ds Max 2016 and higher.
<Edit_Poly>.dataValue Float default: 0.0 -- float
Get/set the data value as float.
Available in 3ds Max 2016 and higher.
<Edit_Poly>.hardedgedisplay Integer default: 0 -- integer
Get/set the state of the hard edge display option as an integer.
Possible values are:
0 - disabled
1 - enabled
Available in 3ds Max 2016 and higher.
<Edit_Poly>.hardedgedisplaycolor Color default: (color 0 237.15 39.78) -- RGB color
Get/set the hard edge display color value.
Available in 3ds Max 2016 and higher.
<Editable_Poly>.hardedgedisplay : integer
Get/set the state of the hard edge display option as an integer.
Possible values are:
0 - disabled
1 - enabled
Available in 3ds Max 2016 and higher.
<Editable_Poly>.hardedgedisplaycolor : RGB color
Get/set the hard edge display color value.
Available in 3ds Max 2016 and higher.
Interface:EditPolyMod
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 can use:
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 searches both the modifier and all its Interfaces for the method name.
Thus, instead of using something like:
$Box01.modifiers[#Edit_Poly].EditPolyMod.GetSelection #Vertex
--or
$Box01.Edit_Poly.EditPolyMod.GetSelection #Vertex
you can use 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:
<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:<boolean>
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 sub-elements shared by a target sub-element must be selected for the target sub-element to be selected. For example, a polygon is selected only when all its vertices are selected, a vertex is selected only when all polygons that share it are selected, and so on.
<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 modifier instance assigned to the specified node.
<boolean>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 modifier instance assigned to the specified node.
<boolean>Select <enum>meshSelLevel <&bitArray>newSelection invert:<boolean> select:<boolean> 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 selection at the specified sub-object level. The modifier must be displayed in the command panel and must be in the requested sub-object mode for the selection to be set correctly.
If the optional invert
: keyword is supplied and set to true
, the selected state of the specified sub-objects is inverted - if they were selected they are deselected and vice-versa. If false
or not supplied, they become selected or remain selected if they were selected already.
If the optional select: keyword is supplied and set to false
, the specified sub-objects are deselected if they were already selected, or remain deselected if they were not selected. If true or not supplied, they are selected if they were previously not or remain selected if they were already selected.
If the modifier is instanced across multiple nodes and the optional node
: keyword is supplied, the method uses 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 max modify 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>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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 uses the selection's local transformation center as the origin.
<void>RotateSelection <quat>amount parent:<matrix3> axis:<matrix3> localOrigin:<boolean>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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 <boolean>MoveOnly <boolean>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 are moved.
If Addis true
and MoveOnly is true
, the newly selected edges are added to the current selection.
If MoveOnly is true
and Add is false
, the newly selected edges are removed from the 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 max modify 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.RingSelect 3 true false--shift the selection by 3
Shifting one or all edge loops by three using all 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 <boolean>MoveOnly <boolean>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 are moved.
If Add is true
and MoveOnly is true
, the newly selected edges are added to the current selection.
If MoveOnly is true
and Add is false
, the newly selected edges are 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 represents 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 max modify 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:
<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 | #BridgeEdge| #PreserveUVSettings | #RemoveEdgeRemoveVertices | #MakeHardEdges | #MakeSmoothEdges | #SelectHardEdges | #SelectSmoothEdges | #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 | #BridgeEdge | #PreserveUVSettings | #RemoveEdgeRemoveVertices | #MakeHardEdges | #MakeSmoothEdges | #SelectHardEdges | #SelectSmoothEdges | #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 | #BridgeEdge | #PreserveUVSettings | #RemoveEdgeRemoveVertices | #MakeHardEdges | #MakeSmoothEdges | #SelectHardEdges | #SelectSmoothEdges | #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 | #BridgeEdge | #PreserveUVSettings | #RemoveEdgeRemoveVertices | #MakeHardEdges | #MakeSmoothEdges | #SelectHardEdges | #SelectSmoothEdges | #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.
<enum>getCommandMode
Returns the current command mode (see the enums for toggleCommandMode()
above), or -1 if no command mode is 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.
<int>GetLastOperation()
Returns the last performed operation, indicating what operation will be performed if RepeatLastOperation()
is called. See currentOperation() above for a list of possible values and corresponding operations that this method can return.
Available in 3ds Max 2020 and higher.
<boolean>ShowOperationDialog()
Shows the operation dialog. Available in 3ds Max 8 and higher.
<boolean>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.
<void>MoveSlicePlane <point3>amount parent:<matrix3> axis:<matrix3>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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>
parent default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
axis default value: (matrix3 [1,0,0] [0,1,0] [0,0,1] [0,0,0])
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.
<boolean>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 - no automatic redraw after invoking.
Returns the transformation matrix of the slice plane.
<void>SetSlicePlane <point3>planeNormal <point3>planeCenter
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.
<boolean>InSlice()
Returns true if the modifier is in Slice mode, false otherwise. Available in 3ds Max 8 and higher.
<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.
<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.
<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 the object space. If the optional node parameter is provided, the point is 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()
Returns the 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
Cancels the cut. Available in 3ds Max 8 and higher.
<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.
<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.
editPolyModReadyToBridge <modifier>mod
Returns true if the specified selection level and flags are ready to be bridged, false otherwise.
<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.
<boolean>GetPreserveMap <integer>mapChannel
Returns the Preserve UVs state for the specified map channel.
<void>SetPreserveMap <integer>mapChannel <boolean>preserve
Sets the Preserve UVs state for the specified map channel to the supplied boolean value.
<void>Attach <node>nodeToAttach editPolyNode:<node>
editPolyNode default value: undefined
Attaches the specified node.
<void>AttachList <node array>nodesToAttach editPolyNode:<node>
editPolyNode default value: undefined
Attaches the specified nodes.
<void>DetachToObject <&string>newObjectName
newObjectName is In and Out parameter
Detaches the selected sub-object selection to a new object with the specified name.
<void>CreateShape <&string>newShapeName
newShapeName is In and Out parameter
Creates a shape with the given name from the selected edges.
<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 <inredex>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 three means a triangular face, a value of four means a quad face, and so on.
<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.
<integer>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.
<boolean>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 the indexed corner vertex of the indexed face from the specified mapping channel.
<void>RefreshScreen()
Redraws the screen to 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 <integer>parts
Available in 3ds Max 8 and higher.