Editable_Poly Mapping Methods
The following methods are specific to Editable_Poly Mapping, Vertex and Edge Data:
Mapping Channels Methods
Sets the number of map channels available.
The number of map channels can be set from 0 to 100.
Map channels 0 and 1 are the Vertex Color and default Texture Map channels.
If <keep> is false , the old mapping information is discarded. If true , the old mapping information is retained after the resize.
Returns the number of map channels available as an <integer> .
Sets whether the specified mapping channel is supported or not.
If <support> is true , and the channel support state is currently false , a new map face array of the same size as the number of faces in the mesh is allocated, but no map vertex array is allocated.
If <support> is false , and the channel support state is currently true , existing map channel face and vertex arrays are deallocated.
If <support> and the current channel support state are both the same, no action is performed. SetNumMaps() is automatically called if the specified map channel is not available.
<mapChannel> index values are 0-based, with Map channels 0 and 1 being the Vertex Color and default Texture Map channels.
This method was previously broken but was fixed in 3ds Max 2008.
Returns whether the specified map channel is supported.
This signifies that a map face array is present, but not necessarily a map vertex array.
Sets the number of vertices for the map channel, initializing the map vertex array.
If <keep> is fals , the old map vertex information is discarded.
If true , the old map vertex information is retained after the resize.
Returns the number of vertices for the map channel as an <integer> .
Sets the number of faces for the map channel.
If keep is false , the old map face information is discarded.
If true , the old map face information is retained after the resize.
Dangerous to use with map channels 0 and 1.
Returns the number of faces for the map channel as an <integer> .
Sets the coordinates of the specified map vertex.
Returns the coordinates of the specified map vertex as a <point3> .
Sets the map vertices for the specified map face.
Returns the vertex indices of the specified map face as an array.
Allocates and initializes a basic planar map, or a white map for the vertex color hannel.
polyop.applyUVWMap <Poly poly> \ <#planar | #cylindrical | #spherical | #ball | #box> | <#face> \ utile:<float=1.0> vtile:<float=1.0> wtile:<float=1.0> \ uflip:<boolean=false> vflip:<boolean=false> wflip:<boolean=false> \ cap:<boolean=true> tm:<Matrix3=identity matrix> channel:<integer=1>
Applies the specified mapping type to the mapping channel.
utile/vtile/wtile - Number of tiles in the U/V/W directions.
uflip/vflip/wflip - U/V/W are mirrored if true .
cap - used with #cylindrical . If true , then any face normal that is pointing more vertically than horizontally will be mapped using planar coordinates.
tm - defines the mapping space. As each point is mapped, it is multiplied by this matrix, and then it is mapped.
channel - the mapping channel the mapping is applied to, defaults to channel 1.
Vertex Colors Methods
polyop.getVertsByColor <Poly poly> <Color color><Float red_thresh>\ <Float green_thresh><Float blue_thresh>\ channel:<int=0>
Returns the vertices whose vertex color is within the color range as a <bitarray> .
The range values should be in the range of 0 to 255.
polyop.getVertsByColor <Poly poly> <Point3 uvw> <Float u_thresh> \ <Float v_thresh> <Float w_thresh> channel:<int=0>
Returns the vertices whose UVW is within the UVW range as a <bitarray> .
The range values should be in the range of 0 to 1.
Sets the vertex color for the specified vertices in the specified <mapChannel> .
Sets the vertex color for the vertices used by the specified faces in the specified <mapChannel> .
VData Channels Methods
Sets the number of vertex data channels available. The number of vertex data channels can be set from 0 to 100.
If <keep> is false , the old channel data is discarded. If true , the old channel data is retained after the resize. The first ten channels for Discreet's use only.
channel 2: Vertex weights (for NURMS MeshSmooth)
channel 3: Vertex Alpha values
channel 4: Cornering values for subdivision use
Returns the number of vertex data channels available as an <integer> .
Sets whether the specified vertex data channel is supported or not.
<vdChannel> index values are 1-based, The first ten channels for Autodesk's use only.
channel 2: Vertex weights (for NURMS MeshSmooth)
channel 3: Vertex Alpha values
channel 4: Cornering values for subdivision use
Returns whether the specified vertex data channel is supported.
Returns the floating point data value associated with vertex vertex_index in vertex data channel <vdChannel> as a <float> .
Sets the floating point data value associated with the specified vertices in vertex data channel <vdChannel> .
Deallocates the existing vertex data channel and turns off the vertex data channel support state.
EData Channels Methods
Sets the number of edge data channels available. The number of edge data channels can be set from 0 to 10.
If <keep> is false , the old channel data is discarded.
If true , the old channel data is retained after the resize.
The first two channels for Autodesk's use only.
Returns the number of edge data channels available as an <integer> .
Sets whether the specified edge data channel is supported or not.
<edChannel> index values are 1-based, the first two channels for Autodesk's use only.
Returns whether the specified edge data channel is supported.
Returns the floating point data value associated with edge edge_index in edge data channel <edChannel> as a <float> .
Sets the floating point data value associated with the specified edges in edge data channel <edChannel> .
Deallocates the existing edge data channel and turns off the edge data channel support state.
See Also
Except where otherwise noted, this work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. Please see the Autodesk Creative Commons FAQ for more information.