pymel.core.modeling.circle

circle(*args, **kwargs)

The circle command creates a circle or partial circle (arc)

Flags:

Long name (short name)		Argument Types	Properties
caching (cch)		bool
	Modifies the node caching mode. See the node documentation for more information.Note:For advanced users only.
center (c)		float, float, float
	The center point of the circle.
centerX (cx)		float
	X of the center point.Default:0
centerY (cy)		float
	Y of the center point.Default:0
centerZ (cz)		float
	Z of the center point.Default:0
constructionHistory (ch)		bool
	Turn the construction history on or off
degree (d)		int
	The degree of the resulting circle: 1 - linear, 3 - cubicDefault:3
first (fp)		float, float, float
	The start point of the circle if fixCenter is false. Determines the orientation of the circle if fixCenter is true.
firstPointX (fpx)		float
	X of the first point.Default:1
firstPointY (fpy)		float
	Y of the first point.Default:0
firstPointZ (fpz)		float
	Z of the first point.Default:0
fixCenter (fc)		bool
	Fix the center of the circle to the specified center point. Otherwise the circle will start at the specified first point.Default:trueAdvanced flags
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.Common flags
normal (nr)		float, float, float
	The normal of the plane in which the circle will lie.
normalX (nrx)		float
	X of the normal direction.Default:0
normalY (nry)		float
	Y of the normal direction.Default:0
normalZ (nrz)		float
	Z of the normal direction.Default:1
object (o)		bool
	Create the result, or just the dependency nodeFlag can appear in Create mode of commandFlag can have multiple arguments, passed either as a tuple or a list.
radius (r)		float
	The radius of the circle.Default:1.0
sections (s)		int
	The number of sections determines the resolution of the circle. Used only if useTolerance is false.Default:8
sweep (sw)		float
	The sweep angle determines the completeness of the circle. A full circle is 2Pi radians, or 360 degrees.Default:6.2831853
tolerance (tol)		float
	The tolerance with which to build a circle. Used only if useTolerance is trueDefault:0.01
useTolerance (ut)		bool
	Use the specified tolerance to determine resolution. Otherwise number of sections will be used.Default:false

Derived from mel command maya.cmds.circle

Example:

import pymel.core as pm

# create full circle at origin on the x-y plane
pm.circle( nr=(0, 0, 1), c=(0, 0, 0) )
# Result: [nt.Transform(u'nurbsCircle1'), nt.MakeNurbCircle(u'makeNurbCircle1')] #

# create half circle at origin on the x-y plane with radius 2
pm.circle( nr=(0, 0, 1), c=(0, 0, 0), sw=180, r=2 )
# Result: [nt.Transform(u'nurbsCircle2'), nt.MakeNurbCircle(u'makeNurbCircle2')] #