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 - cubic Default: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:true
frozen / fzn		bool
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.
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 node. Advanced flags
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 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.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')] #