pymel.core.modeling

functions related to modeling

Functions

alignCurve The curve align command is used to align curves in maya.
alignSurface The surface align command is used to align surfaces in maya.
angleBetween Returns the axis and angle required to rotate one vector onto another.
arcLengthDimension This command is used to create an arcLength dimension to display the arcLength of a curve/surface at a specified point on the curve/surface.
arclen This command returns the arclength of a curve if the history flag is not set (the default).
attachCurve This attach command is used to attach curves.
attachSurface This attach command is used to attach surfaces.
bevel The bevel command creates a new bevel surface for the specified curve.
bevelPlus The bevelPlus command creates a new bevel surface for the specified curves using a given style curve. The first curve should be the outsidecurve, and the (optional) rest of them should be inside of the first one. For predictable results, the curves should be planar and all in the same plane.
blend2 This command creates a surface by blending between given curves.
blindDataType This command creates a blind data type, which is represented by a blindDataTemplate node in the DG. A blind data type can have one or more attributes. On the command line, the attributes should be ordered by type for best memory utilization, largest first: string, binary, double, float, int, and finally boolean. Once a blind data type is created, blind data of that type may be assigned using the polyBlindData command. Note that as well as polygon components, blind data may be assigned to objects and to NURBS patches. A blind data type may not be modified after it is created: in order to do so it must be deleted and recreated. Any existing blind data of that type would also need to be deleted and recreated. When used with the query flag, this command will return information about the attributes of the specified blind data type.
boundary This command produces a boundary surface given 3 or 4 curves.
canCreateManip This command returns true if there can be a manipulator made for the specified selection, false otherwise.
changeSubdivComponentDisplayLevel Explicitly forces the subdivision surface to display components at a particular level of refinement.
changeSubdivRegion Changes a subdivision surface region based on the command parameters.
circle The circle command creates a circle or partial circle (arc)
circularFillet The cmd is used to compute the rolling ball surface fillet ( circular fillet ) between two given NURBS surfaces. To generate trim curves on the surfaces, use -cos true.
closeCurve The closeCurve command closes a curve, making it periodic. The pathname to the newly closed curve and the name of the resulting dependency node are returned. If a curve is not specified in the command, then the first active curve will be used.
closeSurface The closeSurface command closes a surface in the U, V, or both directions, making it periodic. The close direction is controlled by the direction flag. If a surface is not specified in the command, then the first selected surface will be used. The pathname to the newly closed surface and the name of the resulting dependency node are returned. This command also handles selected surface isoparms. For example, if an isoparm is specified, surface1.u[0.33], then the surface will be closed in V, regardless of the direction flag.
coarsenSubdivSelectionList Coarsens a subdivision surface set of components based on the selection list.
cone The cone command creates a new cone and/or a dependency node that creates one, and returns their names.
constructionHistory This command turns construction history on or off.
createSubdivRegion Creates a subdivision surface region based on the selection list.
curve The curve command creates a new curve from a list of control vertices (CVs). A string is returned containing the pathname to the newly created curve. You can create a curve from points either in world space or object (local) space, either with weights or without. You can replace an existing curve by using the -r/replaceflag. You can append a point to an existing curve by using the -a/appendflag. To create a curve-on-surface, use the curveOnSurface command. To change the degree of a curve, use the rebuildCurve command. To change the of parameter range curve, use the rebuildCurve command.
curveIntersect You must specify two curves to intersect.
curveOnSurface The curve-on-surface command creates a new curve-on-surface from a list of control vertices (CVs). A string is returned containing the pathname to the newly created curve-on-surface. You can replace an existing curve by using the -r/replaceflag. You can append points to an existing curve-on-surface by using the -a/appendflag. See also the curve command, which describes how to query curve attributes.
cylinder The cylinder command creates a new cylinder and/or a dependency node that creates one, and returns their names.
detachCurve The detachCurve command detaches a curve into pieces, given a list of parameter values. You can also specify which pieces to keep and which to discard using the -kflag. The names of the newly detached curve(s) is returned. If history is on, then the name of the resulting dependency node is also returned. You can use this command to open a periodic curve at a particular parameter value. You would use this command with only one -pflag. If you are specifying -kflags, then you must specify one, none or all -kflags. If you are specifying all -kflags, there must be one more -kflag than -pflags.
detachSurface The detachSurface command detaches a surface into pieces, given a list of parameter values and a direction. You can also specify which pieces to keep and which to discard using the -kflag. The names of the newly detached surface(s) are returned. If history is on, the name of the resulting dependency node is also returned. You can only detach in either U or V (not both) with a single detachSurface operation. You can use this command to open a closed surface at a particular parameter value. You would use this command with only one -pflag. If you are specifying -kflags, then you must specify one, none or all -kflags. If you are specifying all -kflags, there must be one more -kflag than -pflags.
doubleProfileBirailSurface The arguments are 4 cuves called profile1profile2rail1rail2.
duplicateCurve The duplicateCurve command takes a curve on a surface and and returns the 3D curve. The curve on a surface could be isoparam component, trimmed edge or curve on surface object.
duplicateSurface The duplicateSurface command takes a surface patch (face) and and returns the 3D surface. Connected patches are returned as a single surface.
extendCurve This command extends a curve or creates a new curve as an extension
extendSurface This command extends a surface or creates a new surface as an extension.
extrude This command computes a surface given a profile curve and possibly a path curve.
filletCurve The curve fillet command creates a fillet curve between two curves.
filterExpand Based on selected components (or components specified on the command line), the command filters and/or expands the list given the options.
fitBspline The fitBspline command fits the CVs from an input curve and and returns a 3D curve.
freeFormFillet This command creates a free form surface fillet across two surface trim edges or isoparms or curve on surface.
globalStitch This command computes a globalStitch of NURBS surfaces. There should be at least one NURBS surface. The NURBS surface(s) should be untrimmed.
grid This command changes the size and spacing of lines on the ground plane displayed in the perspective and orthographic views.
hardenPointCurve The hardenPointCurve command changes the knots of a curve given a list of control point indices so that the knot corresponding to that control point gets the specified multiplicity. Multiplicity of -1 is the universal value used for multiplicity equal to the degree of the curve.limitationsThe CV whose multiplicity is being raised needs to have its neighbouring CVs of multiplicity 1. How many neighbours depends on the degree of the curve and the difference in CV multiplicities before and after this operation. For example, if you’re changing a CV of multiplicity 1 into a CV of multiplicity 3, you will need the 4 neighbouring CVs (2 on each side) to be of multiplicity 1. The CVs that do not satisfy that requirement will be ignored.
illustratorCurves The illustratorCurves command creates NURBS curves from an input Adobe(R) Illustrator(R) file
insertKnotCurve The insertKnotCurve command inserts knots into a curve given a list of parameter values. The number of knots to add at each parameter value and whether the knots are added or complemented can be specified. The name of the curve is returned. If construction history is on, the name of the resulting dependency node is also returned. An edit point will appear where you insert the knot. Also, the number of spans and CVs in the curve will increase in the area where the knot is inserted. You can insert up to degreeknots at a curve parameter that isn’t already an edit point. eg. for a degree three curve, you can insert up to 3 knots. Use this operation if you need more CVs in a local area of the curve. Use this operation (or hardenPoint) if you want to create a corner in a curve.
insertKnotSurface The insertKnotSurface command inserts knots (aka isoparms) into a surface given a list of parameter values. The number of knots to add at each parameter value and whether the knots are added or complemented can be specified. The name of the surface is returned and if history is on, the name of the resulting dependency node is also returned. You must specify one, none or all number of knots with the -nkflag. eg. if you specify none, then the default (one) knot will be added at each specified parameter value. If you specify one -nkvalue then that number of knots will be added at each parameter value. Otherwise, you must specify the same number of -nkflags as -pflags, defining the number of knots to be added at each specified parameter value. You can insert up to degreeknots at a parameter value that isn’t already an isoparm. eg. for a degree 3 surface, you can insert up to 3 knots. Use this operation if you need more CVs in a local area of the surface. Use this operation if you want to create a corner in the surface. Note: A single insertKnotSurface command cannot insert in both directions at once; you must use two separate commands to do this.
intersect The intersect command creates a curve on surface where all surfaces intersect with each other.
loft This command computes a skinned (lofted) surface passing through a number of NURBS curves. There must be at least two curves present. The NURBS curves may be surface isoparms, curve on surfaces, trimmed edges or polygon edges.
makeSingleSurface This command performs a stitch and tessellate operation
manipOptions Changes the global manipulator parameters In query mode, return type is based on queried flag.
moveVertexAlongDirection The command moves the selected vertex ( control vertex ) in the specified unit direction by the given magnitude.
multiProfileBirailSurface The cmd creates a railed surface by sweeping the profiles using two rail curves.
nurbsBoolean This command performs a boolean operation.
nurbsCopyUVSet This is only a sample command for debugging purposes, which makes a copy of the implicit st parameterization on a nurbs surface to be the 1st explicit uvset.
nurbsCube The nurbsCube command creates a new NURBS Cube made up of six planes. It creates an unit cube with center at origin by default.
nurbsEditUV Command edits uvs on NURBS objects. When used with the query flag, it returns the uv values associated with the specified components.
nurbsPlane The nurbsPlane command creates a new NURBS Plane and return the name of the new surface. It creates an unit plane with center at origin by default.
nurbsSelect Performs selection operations on NURBS objects.If any of the border flags is set, then the appropriate borders are selected. Otherwise the current CV selection is used, or all CVs if the surfaces is selected as an object.The growSelection, shrinkSelection, borderSelection flags are then applied in that order.In practice, it is recommended to use one flag at a time, except for the border flags.
nurbsSquare The nurbsSquare command creates a square
nurbsToPoly This command tesselates a NURBS surface and produces a polygonal surface. The name of the new polygonal surface is returned. If construction history is ON, then the name of the new dependency node is returned as well.
nurbsToPolygonsPref This command sets the values used by the nurbs-to-polygons (or tesselate) preference.
nurbsToSubdiv This command converts a NURBS surface and produces a subd surface. The name of the new subdivision surface is returned. If construction history is ON, then the name of the new dependency node is returned as well.
nurbsToSubdivPref This command sets the values used by the nurbs-to-subdivision surface preference.
nurbsUVSet Allows user to toggle between implicit and explicit UVs on a NURBS object. Also provides a facility to create, delete, rename and set the current explicit UVSet. An implicit UVSet is non-editable. It uses the parametric make-up of the NURBS object to determine the location of UVs (isoparm intersections). NURBS objects also support explicit UVSets which are similar to the UVs of a polygonal object. UVs are created at the knots (isoparm intersections) of the object and are fully editable. In order to access UV editing capabilities on a NURBS object an explicit UVSet must be created and set as the current UVSet.
offsetCurve The offset command creates new offset curves from the selected curves.
offsetCurveOnSurface The offsetCurveOnSurface command offsets a curve on surface resulting in another curve on surface. The connecting type for breaks in offsets is off (no connection), circular (connect with an arc) or linear (connect linearly resulting in a sharp corner). If loop cutting is on then any loops in the offset curves are trimmed away and a sharp corner is created at each intersection. The subdivisionDensity flag is the maximum number of times the offset object can be subdivided (i.e. calculate the offset until the offset comes within tolerance or the iteration reaches this maximum.) The checkPoints flag sets the number of points per span at which the distance of the offset curve from the original curve is determined. The tolerance flag determines how accurately the offset curve should satisfy the required offset distance. A satisfactory offset curve is one for which all of the checkpoints are within the given tolerance of the required offset.
offsetSurface The offset command creates new offset surfaces from the selected surfaces.
planarSrf This command computes a planar trimmed surface given planar boundary curves that form a closed region.
plane The command creates a sketch plane (also known as a construction plane) in space.
pointCurveConstraint The command enables direct manipulation of a NURBS curve. It does so by apply a position constraint at the specified parameter location on the NURBS curve. If construction history for the cmd is enabled, a locator is created to enable subsequent interactive manipulation of the curve. The locator position may be key framed or transformed and the curve1will try to match the position of the locator. The argument is a curve location
pointOnCurve This command returns information for a point on a NURBS curve. If no flag is specified, it assumes p/position by default.
pointOnSurface This command returns information for a point on a surface.
pointPosition This command returns the world or local space position for any type of point object.
polyAppend Appends a new face to the selected polygonal object.
polyAppendVertex Appends a new face to the selected polygonal object.
polyAutoProjection Projects a map onto an object, using several orthogonal projections simultaneously.
polyAverageNormal Set normals of vertices or vertex-faces to an average value when the vertices within a given threshold.
polyAverageVertex Moves the selected vertices of a polygonal object to round its shape.
polyBevel Bevel edges.
polyBlendColor Takes two color sets and blends them together into a third specified color set.
polyBlindData Command creates blindData types (basically creates an instance of TdnPolyBlindData). When used with the query flag, it returns the data types that define this blindData type. This command is to be used create a blindData node *and* to edit the same.. The associationType flag *has* to be specified at all times.. This is because if an instance of the specified BD typeId exists in the history chain but if the associationType is not the same, then a new polyBlindData node is created.. For object level blind data, only the object itself must be specified. A new compound attribute BlindDataNNNN will be created on the object. Blind data attribute names must be unique across types for object level blind data. So, the command will require the following to be specified: - typeId, - associationType - longDataName or shortDataName of data being edited. - The actual data being specified. - The components that this data is to be attached to.
polyBoolOp This command creates a new poly as the result of a boolean operation on input polys : union, intersection, difference.
polyBridgeEdge Bridges two sets of edges.
polyCacheMonitor When the cacheInput attribute has a positive value the midModifier node caches the output mesh improving performance in computations of downstream nodes. When the counter has a zero value the midModifier releases the cached data.
polyCheck Dumps a description of internal memory representation of poly objects.
polyChipOff Extract facets.
polyClipboard The command allows the user to copy and paste certain polygonal attributes to a clipboard.
polyCloseBorder Closes open borders of objects.
polyCollapseEdge Turns each selected edge into a point.
polyCollapseFacet Turns each selected facet into a point.
polyColorBlindData This command applies false color to the selected polygonal components and objects, depending on whether or not blind data exists for the selected components (or, in the case of poly objects, dynamic attributes), and, depending on the color mode indicated, what the values are.
polyColorDel Deletes color from selected components.
polyColorMod Modifies the attributes of a poly color set.
polyColorPerVertex Command associates color(rgb and alpha) with vertices on polygonal objects.
polyColorSet Command to do the following to color sets: - delete an existing color set.
polyCompare Compares two Polygonal Geometry objects with a fine control on what to compare. If no objects are specified in the command line, then the objects from the active list are used. Default behaviour is to compare all flags. Use MEL script polyCompareTwoObjects.mel to get formatted output from this command.
polyCone The cone command creates a new polygonal cone.
polyCopyUV Copy some UVs from a UV set into another.
polyCrease Command to set the crease values on the edges or vertices of a poly.
polyCreateFacet Create a new polygonal object with the specified face, which will be closed.
polyCube The cube command creates a new polygonal cube.
polyCut This command splits a mesh, or a set of poly faces, along a plane.
polyCylinder The cylinder command creates a new polygonal cylinder.
polyCylindricalProjection Projects a cylindrical map onto an object.
polyDelEdge Deletes selected edges, and merges neighboring faces.
polyDelFacet Deletes faces.
polyDelVertex Deletes vertices.
polyDuplicateAndConnect This command duplicates the input polygonal object, connects up the outMesh attribute of the original polygonal shape to the inMesh attribute of the newly created duplicate shape and copies over the shader assignments from the original shape to the new duplicated shape. The command will fail if no objects are selected or sent as argument or if the object sent as argument is not a polygonal object.
polyDuplicateEdge Duplicates a series of connected edges (edgeLoop)
polyEditUV Command edits uvs on polygonal objects.
polyEditUVShell Command edits uv shells on polygonal objects.
polyEvaluate Returns the required counts on the specified objects.
polyExtrudeEdge Extrude edges separately or together.
polyExtrudeFacet Extrude faces.
polyExtrudeVertex Command that extrudes selected vertices outwards.
polyFlipEdge Command to flip the edges shared by 2 adjacent triangles.
polyFlipUV Flip (mirror) the UVs (in texture space) of input polyFaces, about either the U or V axis..
polyForceUV A set of functionalities can be called through this command.
polyGeoSampler This command performs a render sampling of surface color and transparency for each selected vertex or face and stores the sampled data as either the color value, or uses the sampled data to displace the affected vertices or faces by a sampled data value.
polyHelix The polyHelix command creates a new polygonal helix.
polyInfo Command query’s topological information on polygonal objects and components.
polyInstallAction Installs/uninstalls several things to help the user to perform the specified action : PickmaskInternal selection constraintsDisplay attributes
polyLayoutUV Move UVs in the texture plane to avoid overlaps.
polyListComponentConversion This command converts poly components from one or more types to another one or more types, and returns the list of the conversion.
polyMapCut Cut along edges of the texture mapping.
polyMapDel Deletes texture coordinates (UVs) from selected faces.
polyMapSew Sew border edges in texture space.
polyMapSewMove This command can be used to Move and Sew together separate UV pieces along geometric edges. UV pieces that correspond to the same geometric edge, are merged together by moving the smaller piece to the larger one.
polyMergeEdge Sews two border edges together.The new edge is located either on the first, last, or between both selected edges, depending on the mode. Both edges must belong to the same object, and orientations must match (i.e. normals on corresponding faces must point in the same direction).Edge flags are mandatory.
polyMergeFacet The second face becomes a hole in the first face.The new holed face is located either on the first, last, or between both selected faces, depending on the mode. Both faces must belong to the same object.Facet flags are mandatory.
polyMergeUV Merge UVs of an object based on their distance. UVs are merge only if they belong to the same 3D vertex.
polyMergeVertex Merge vertices within a given threshold.Since this allows merging any vertices that lie on the same object it is possible for the resulting geometry to be non-manifold.First, perform comparison of pairs of selected vertices. Pairs that lie within given distance of one another are merged, along with the edge between them.Second, any selected vertices which share an edge are merged if the distance between them is within the specified distance.Unlike Merge Edges, Merge Vertices will perform the merge even if the edges adjoining the vertices do not have matching orientation (i.e. normals of adjacent faces do not point in the same direction). As this restriction is not enforced while merging vertices, resulting geometry can be non-manifold.If alwaysMergeTwoVertices is set and there are only two vertices, tolerance is ignored and the vertices will be merged.Resulting mesh may have extra vertices or edges to ensure geometry is valid.
polyMirrorFace Mirror all the faces of the selected object.
polyMoveEdge Modifies edges of a polygonal object.
polyMoveFacet Modifies facet of a polygonal object.
polyMoveFacetUV Modifies the map by moving all UV values associated with the selected face(s). The UV coordinates of the model are manipulated without changing the vertices of the 3D object.
polyMoveUV Moves selected UV coordinates in 2D space. As the selected UVs are adjusted, the way the image is mapped onto the object changes accordingly. This command manipulates the UV values without changing the 3D geometry of the object.
polyMoveVertex Modifies vertices of a polygonal object.
polyMultiLayoutUV place the UVs of the selected polygonal objects so that they do not overlap.
polyNormal Control the normals of an object.
polyNormalPerVertex Command associates normal(x, y, z) with vertices on polygonal objects.
polyNormalizeUV Normalizes the UVs of input polyFaces. The existing UVs of the faces are normalized between 0 and 1.
polyOptUvs Optimizes selected UVs.
polyOptions Changes the global display polygonal attributes.
polyOutput Dumps a description of internal memory representation of poly objects.
polyPipe The polyPipe command creates a new polygonal pipe.
polyPlanarProjection Projects a map onto an object, using an orthogonal projection.
polyPlane The mesh command creates a new polygonal plane.
polyPlatonicSolid The polyPlatonicSolid command creates a new polygonal platonic solid.
polyPoke Introduces a new vertex in the middle of the selected face, and connects it to the rest of the vertices of the face.
polyPrimitive Create a polygon primative
polyPrism The prism command creates a new polygonal prism.
polyProjection Creates a mapping on the selected polygonal faces.
polyPyramid The pyramid command creates a new polygonal pyramid.
polyQuad Merges selected triangles of a polygonal object into four-sided faces.
polyQueryBlindData Command query’s blindData associated with particular polygonal components. So, the command will require the following to be specified: - selection list to query Optional are the: - typeId - associationType - longDataName or shortDataName of data being queried. - The actual data being specified. - showComponent flag Note that for object level blind data, the showComponent flag will be ignored. If no components are selected, the assocation flag will be ignored and object level data will be queried.
polyReduce Reduce a polygonal object.
polySelect This command makes different types of poly component selections.
polySelectConstraint Changes the global polygonal selection constraints.
polySelectConstraintMonitor Manage the window to display/edit the polygonal selection constraint parameters
polySeparate This command creates new objects from the given poly.
polySetToFaceNormal This command takes selected polygonal vertices or vertex-faces and changes their normals.
polySewEdge Merge border edges within a given threshold.Perform pair-wise comparison of selected edges. Pairs whose corresponding vertices meet threshold conditions and whose orientations are aligned (i.e. their respective normals point in the same direction) are merged, as are the vertices (in other words, vertices are shared). Resulting mesh may have extra vertices or edges to ensure geometry is valid. Edges must be on the same object to be merged. Default : share only vertices lying exactly at the same place. (polySewEdge -t 0.0)
polySlideEdge Moves an edge loop selection along the edges connected to the sides of its vertices.
polySmooth Smooth a polygonal object.
polySoftEdge Selectively makes edges soft or hard.
polySphere The sphere command creates a new polygonal sphere.
polySphericalProjection Projects a spherical map onto an object.
polySplit Split facets/edges of a polygonal object.
polySplitEdge Split Edges.Splits non-manifold edges so as to make them manifold edges. It creates the minimum number of edges that can be created to make the edge manifold. Resulting mesh may have extra vertices or edges to ensure geometry is valid.
polySplitRing Splits a series of ring edges of connected quads and inserts connecting edges between them.
polySplitVertex Use this command to split one or more vertices.A mesh is made up of one or more faces. The faces are defined by edges which connect vertices together. Typically a face will share vertices and edges with adjacent faces in the same mesh. Sharing vertices and edges helps reduce the amount of memory used by a mesh. It also ensures that when a face is moved, all the connected faces move together.Sometimes you may want to separate a face from its connected faces so that it may be moved in isolation. There are three ways to accomplish this depending upon which parts of the face you want to extract:polySplitVertexsplit one or more vertices so that each face that shared the vertex acquires its own copy of the vertexpolySplitEdgesplit one or more edges so that each face that shared the vertex acquires its own copy of the edgepolyChipOffcompletely extract the face so that it has its own vertices and edgesNotice that the area of affect of each operation is different. polySplitVertex will affect all the edges and faces that shared the vertex. This is the broadest effect. polySplitEdge will only affect the faces which shared the edge and polyChipOff will affect a specific face. If we just count vertices to measure the effect of each command when splitting all components of a face, starting from a 3x3 plane which has 16 vertices and we were to split the middle face:polySplitVertex applied to the four vertices would end up creating 12 new verticespolySplitEdge applied to the four edges would end up creating 4 new verticespolyChipOff applied to the middle face would end up creating 4 new verticesNote that polySplitVertex may create non-manifold geometry as a part of this operation. You can use Polygons-Cleanup afterwards to to clean up any non-manifold geometry.
polyStraightenUVBorder Move border UVs along a simple curve.
polySubdivideEdge Subdivides an edge into two or more subedges.
polySubdivideFacet Subdivides a face into quads or triangles.
polyToSubdiv This command converts a polygon and produces a subd surface.
polyTorus The torus command creates a new polygonal torus.
polyTransfer Transfer information from one polygonal object to another one.
polyTriangulate Triangulation breaks polygons down into triangles, ensuring that all faces are planar and non-holed.
polyUVSet Command to do the following to uv sets: - delete an existing uv set.
polyUnite This command creates a new poly as an union of a list of polys If no objects are specified in the command line, then the objects from the active list are used.
polyWedgeFace Extrude faces about an axis.
projectCurve The projectCurve command creates curves on surface where all selected curves project onto the selected surfaces. Projection can be done using the surface normals or the user can specify the vector to project along. Note: the user does not have to specify the curves and surfaces in any particular order in the command line.
projectTangent The project tangent command is used to align (for tangents) a curve to two other curves or a surface.
propMove Performs a proportional translate, scale or rotate operation on any number of objects.
querySubdiv Queries a subdivision surface based on a set of query parameters and updates the selection list with the results.
rebuildCurve This command rebuilds a curve by modifying its parameterization.
rebuildSurface This command rebuilds a surface by modifying its parameterization.
refineSubdivSelectionList Refines a subdivision surface set of components based on the selection list.
reverseCurve The reverseCurve command reverses the direction of a curve or curve-on-surface. A string is returned containing the pathname of the newly reversed curve and the name of the resulting dependency node. The reversed curve has the same parameter range as the original curve.
reverseSurface The reverseSurface command reverses one or both directions of a surface or can be used to swapthe U and V directions (this creates the effect of reversing the surface normal). The name of the newly reversed surface and the name of the resulting dependency node is returned. The resulting surface has the same parameter ranges as the original surface. This command also handles selected surface isoparms. For a selected isoparm, imagine that the isoparm curve is reversed after the operation. E.g. reverseSurface surface.v[0.1] will reverse in the U direction.
revolve This command creates a revolved surface by revolving the given profile curve about an axis.
roundConstantRadius This command generates constant radius NURBS fillets and NURBS corner surfaces for matching edge pairs on NURBS surfaces. An edge pair is a matching pair of surface isoparms or trim edges. This command can handle more than one edge pair at a time. This command can also handle compoundedges, which is where an edge pair is composed of more than two surfaces. Use the -saand -sbflags in this case. The results from this command are three surface var groups plus the name of the new roundConstantRadius dependency node, if history was on. The 1st var group contains trimmed copies of the original surfaces. The 2nd var group contains the new NURBS fillet surfaces. The 3rd var group contains the new NURBS corners (if any). A simple example of an edge pair is an edge of a NURBS cube, where two faces of the cube meet. This command generates a NURBS fillet at the edge and trims back the faces. Another example is a NURBS cylinder with a planar trim surface cap. This command will create a NURBS fillet where the cap meets the the cylinder and will trim back the cap and the cylinder. Another example involves all 12 edges of a NURBS cube. NURBS fillets are created where any face meets another face. NURBS corners are created whenever 3 edges meet at a corner.
setXformManip This command changes some of the settings of the xform manip, to control its appearance.
singleProfileBirailSurface This cmd creates a railed surface by sweeping the profile curve along the two rail curves.
smoothCurve The smooth command smooths the curve at the given control points.
smoothTangentSurface The smoothTangentSurface command smooths the surface along an isoparm at each parameter value. The name of the surface is returned and if history is on, the name of the resulting dependency node is also returned. This command only applies to parameter values with a multiple knot value. (If the given parameter value has no multiple knot associated with it, then the dependency node is created but the surface doesn’t change.) When would you use this? If you have a surface consisting of a number of Bezier patches or any isoparms with more than a single knot multiplicity, you could get into a situation where a tangent break occurs. So, it only makes sense to do this operation on the knot isoparms, and not anywhere in between, because the surface is already smooth everywhere in between. If you have a cubic or higher degree surface, asking for the maximal smoothness will give you tangent, curvature, etc. up to the degree-1 continuity. Asking for tangent will just give you tangent continuity. It should be mentioned that this is C, not Gcontinuity we’re talking about, so technically, you can still see visual tangent breaks if the surface is degenerate. Note: A single smoothTangentSurface command cannot smooth in both directions at once; you must use two separate commands to do this.
sphere The sphere command creates a new sphere.
squareSurface This command produces a square surface given 3 or 4 curves.
stitchSurface The stitchSurface command aligns two surfaces together to be G(0) and/or G(1) continuous by ajusting only the Control Vertices of the surfaces. The two surfaces can be stitched by specifying the two isoparm boundary edges that are to stitched together. The edge to which the two surfaces are stitched together is obtained by doing a weighted average of the two edges. The weights for the two edges is specified using the flags -wt0, -wt1 respectively.
stitchSurfacePoints The stitchSurfacePoints command aligns two or more surface points along the boundaries together to a single point. In the process, a node to average the points is created. The points are averaged together in a weighted fashion. The points may be control vertices along the boundaries. If the points are CVs then they are stitched together only with positional continuity. Note: No two points can lie on the same surface.
subdCleanTopology Command cleans topology of subdiv surfaces - at all levels.
subdCollapse This command converts a takes a subdivision surface, passed as the argument, and produces a subdivision surface with a number of hierarchy levels removed.
subdDuplicateAndConnect This command duplicates the input subdivision surface object, connects up the outSubdiv attribute of the original subd shape to the create attribute of the newly created duplicate shape and copies over the shader assignments from the original shape to the new duplicated shape. The command will fail if no objects are selected or sent as argument or if the object sent as argument is not a subdivision surface object.
subdEditUV Command edits uvs on subdivision surfaces.
subdListComponentConversion This command converts subdivision surface components from one or more types to another one or more types, and returns the list of the conversion.
subdMatchTopology Command matches topology across multiple subdiv surfaces - at all levels.
subdMirror This command takes a subdivision surface, passed as the argument, and produces a subdivision surface that is a mirror.
subdToBlind The subdivision surface hierarchical edits will get copied into blind data on the given polygon.
subdToPoly This command tessellates a subdivision surface and produces polygon.
subdTransferUVsToCache The subdivision surface finer level uvs will get copied to the polygonToSubd node sent in as argument. The command takes a single subdivision surface and a single polygonToSubd node as input. Additional inputs will be ignored. Please note that this command is an internal command and is to be used with care, directly by the user
subdiv Provides useful information about the selected subdiv or components, such as the deepest subdivided level, the children or parents of the currently selected components, etc.
subdivCrease Set the creasing on subdivision mesh edges or mesh points that are on the selection list.
subdivDisplaySmoothness Sets or querys the display smoothness of subdivision surfaces on the selection list or of all subdivision surfaces if the -all option is set.
surface The cmd creates a NURBS spline surface (rational or non rational). The surface is created by specifying control vertices (CV’s) and knot sequences in the U and V direction. You cannot query the properties of the surface using this command. See examples below.
textCurves The textCurves command creates NURBS curves from a text string using the specified font. A single letter can be made up of more than one NURBS curve. The number of curves per letter varies with the font.
tolerance This command sets tolerances used by modelling operations that require a tolerance, such as surface fillet.
torus The torus command creates a new torus and/or a dependency node that creates one, and returns their names.
transferAttributes Samples the attributes of a source surface (first argument) and transfers them onto a target surface (second argument).
trim This command trims a surface to its curves on surface by first splitting the surface and then selecting which regions to keep or discard.
unfold None
untangleUV This command will aid in the creation of non-overlapping regions (i.e.
untrim Untrim the surface.
uvSnapshot Builds an image containg the UVs of the selected objects.

Table Of Contents

Commands

Modules

This Page