pymel.core.modeling.cylinder¶

cylinder(*args, **kwargs)¶

The cylinder command creates a new cylinder and/or a dependency node that creates one, and returns their names.

Flags:

Long Name / Short Name		Argument Types	Properties
axis / ax		float, float, float
	The primitive’s axis
caching / cch		bool
	Modifies the node caching mode. See the node documentation for more information. Note:For advanced users only.
constructionHistory / ch		bool
	Turn the construction history on or off.
degree / d		int
	The degree of the resulting surface: 1 - linear, 3 - cubic Default:3
endSweep / esw		float
	The angle at which to end the surface of revolution. Default is 2Pi radians, or 360 degrees. Default:6.2831853
frozen / fzn		bool
heightRatio / hr		float
	Ratio of heightto widthDefault:2.0
name / n		unicode
	Sets the name of the newly-created node. If it contains namespace path, the new node will be created under the specified namespace; if the namespace does not exist, it will be created.
nodeState / nds		int
	Modifies the node state. See the node documentation for more information. Note:For advanced users only. Flag can have multiple arguments, passed either as a tuple or a list.
object / o		bool
	Create the result, or just the dependency node.
pivot / p		float, float, float
	The primitive’s pivot point
polygon / po		int
	The value of this argument controls the type of the object created by this operation 0: nurbs surface1: polygon (use nurbsToPolygonsPref to set the parameters for the conversion)2: subdivision surface (use nurbsToSubdivPref to set the parameters for the conversion)3: Bezier surface4: subdivision surface solid (use nurbsToSubdivPref to set the parameters for the conversion)Advanced flags
radius / r		float
	The radius of the object Default:1.0
sections / s		int
	The number of sections determines the resolution of the surface in the sweep direction. Used only if useTolerance is false. Default:8
spans / nsp		int
	The number of spans determines the resolution of the surface in the opposite direction. Default:1
startSweep / ssw		float
	The angle at which to start the surface of revolution Default:0
tolerance / tol		float
	The tolerance with which to build the surface. Used only if useTolerance is true Default:0.01
useTolerance / ut		bool
	Use the specified tolerance to determine resolution. Otherwise number of sections will be used. Default:false Common flags

Derived from mel command maya.cmds.cylinder

Example:

import pymel.core as pm

pm.cylinder()
# Result: [nt.Transform(u'nurbsCylinder1'), nt.MakeNurbCylinder(u'makeNurbCylinder1')] #
pm.cylinder( ch=True, radius=10, hr=3 )
# Result: [nt.Transform(u'nurbsCylinder2'), nt.MakeNurbCylinder(u'makeNurbCylinder2')] #
pm.cylinder( r=5, axis=(1, 1, 1), pivot=(0, 0, 1), ssw='0deg', esw='90deg' )
# Result: [nt.Transform(u'nurbsCylinder3'), nt.MakeNurbCylinder(u'makeNurbCylinder3')] #
pm.cylinder( ut=True, tol=0.01 )
# Result: [nt.Transform(u'nurbsCylinder4'), nt.MakeNurbCylinder(u'makeNurbCylinder4')] #

#Query the radius of the selected cylinder
r = pm.cylinder( q=True, r=True )