Ellipse : Shape

Ellipse - superclass: shape; super-superclass:node - classID: #(4247, 0) 

Value > MAXWrapper > Node > GeometryClass > Shape > Ellipse

 

   

Shapes and Splines - Quick Navigation

   

Constructor

ellipse...   

   

Properties

Parameters Rollout

<Ellipse>.length Float default: 25.0 -- animatable 

The size of the Ellipse along the local Y axis.

   

<Ellipse>.width Float default: 35.0 -- animatable 

The size of the Ellipse local X axis.

   

<Ellipse>.ellipse_outline     BooleanClass    default: false   --  animatable; boolean; Outline

Get/set the state of the Outline checkbox in the Ellipse Parameters.

When set to True, a second spline will be created inside the first one with an offset controller by the .ellipse_thickness property.

Available in 3ds Max 2013 and higher.

   

<Ellipse>.ellipse_thickness     Float    default: 0.0   --  animatable; float; Thickness

Get/set the Outline thickness of the Ellipse when .ellipse_outline is set to True.

Available in 3ds Max 2013 and higher.

   

Interpolation Rollout

<Ellipse>.steps Integer default: 6 

The number of divisions between each vertex.

   

<Ellipse>.optimize Boolean default: true 

When on, removes unneeded steps from straight segments in the spline.

   

<Ellipse>.adaptive Boolean default: false 

When on, Adaptive sets the number of steps for each spline to produce a smooth curve.

Straight segments always receive 0 steps.

   

Rendering Rollout

<Ellipse>.render_renderable BooleanClass default: false -- boolean; renderable 

Toggles the "Enable in Renderer" checkbox on and off.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_displayRenderMesh BooleanClass default: false -- boolean; displayRenderMesh 

Toggles the "Enable In Viewport" checkbox on and off.

When set to true, the mesh will be displayed in the viewports.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_useViewportSettings BooleanClass default: false -- boolean; useViewportSettings 

Toggles the "Use Viewport Settings" checkbox on and off.

When set to true, the mesh displayed in the viewport will use the Viewport settings.

When false, the Renderer settings will be used for the viewport mesh, too.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_mapcoords BooleanClass default: false -- boolean; mapcoords 

Toggles mapping coordinates generation on and off.

The U coordinate wraps once around the thickness of the spline; the V coordinate is mapped once along the length of the spline.

Available in 3ds Max 8 and higher.

   

<Ellipse>.realWorldMapSize BooleanClass default: false -- boolean 

Toggles the real-world map size option on and off.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_displayRenderSettings BooleanClass default: true -- boolean; displayRenderSettings 

Toggles the state of the Viewport/Renderer radio buttons.

When set to true, the Renderer settings will be displayed in the rollout.

When false, the Viewport settings will be shown instead.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_rectangular BooleanClass default: false -- boolean 

When set to true, enables the Rectangular cross-section mode to be used in the renderer.

When false (default), enables the Radial cross-section mode.

Corresponds to the Radial/Rectangular radio buttons in the UI in Renderer mode.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_rectangular BooleanClass default: false -- boolean 

When set to true, enables the Rectangular cross-section mode to be used in the viewports.

When false (default), enables the Radial cross-section mode.

Corresponds to the Radial/Rectangular radio buttons in the UI in Viewport mode.

Available in 3ds Max 8 and higher.

   

Renderer - Radial Cross-Section

<Ellipse>.render_thickness Float default: 1.0 -- animatable; thickness 

Get/Set the diameter of the Radial renderable spline mesh.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_sides Integer default: 12 -- animatable; sides 

Get/Set the number of sides for the spline mesh in the renderer.

A value of 4 will give you a square cross section, for example.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_angle Float default: 0.0 -- animatable; angle 

Get/Set the rotational position of the Radial cross-section in the renderer.

Available in 3ds Max 8 and higher.

   

Renderer - Rectangular Cross-Section

<Ellipse>.render_length Float default: 6.0 -- animatable 

Get/Set the length of the Rectangular renderable spline mesh.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_width Float default: 2.0 -- animatable 

Get/Set the width of the Rectangular renderable spline mesh.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_angle2 Float default: 0.0 -- animatable 

Get/Set rotational position of the Radial cross-section in the renderer.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_aspect_locked BooleanClass default: false -- boolean 

Controls the state of the Aspect Lock checkbutton.

When set to true, changing the Width will affect the Height and vice-versa, preserving the aspect at the time the lock was engaged.

Available in 3ds Max 8 and higher.

   

Viewport - Radial Cross-Section

<Ellipse>.render_viewport_thickness Float default: 1.0 -- float; viewport_thickness 

Get/Set the diameter of the Radial renderable spline mesh in the viewport.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_sides Integer default: 12 -- integer; viewport_sides 

Gets/Sets the number of sides for the Radial spline mesh in the viewports.

A value of 4 will give you a square cross section, for example.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_angle Float default: 0.0 -- float; viewport_angle 

Gets/Sets the rotational position of the cross-section in the viewports.

Available in 3ds Max 8 and higher.

   

Viewport - Rectangular Cross-Section

<Ellipse>.render_viewport_lengthFloat default: 6.0 -- float 

Get/Set the length of the Rectangular spline mesh in the viewports.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_width Float default: 2.0 -- float 

Get/Set the width of the Rectangular spline mesh in the viewports.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_angle2 Float default: 0.0 -- float 

Get/Set rotational position of the Rectangular cross-section in the viewports.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_viewport_aspect_locked BooleanClass default: false -- boolean 

Controls the state of the Aspect Lock checkbutton.

When set to true, changing the Width will affect the Height and vice-versa, preserving the aspect at the time the lock was engaged.

Available in 3ds Max 8 and higher.

   

Auto Smooth

<Ellipse>.render_auto_smooth BooleanClass default: true -- boolean 

Controls the state of the Auto Smooth checkbox.

When set to true, auto smoothing will be enabled.

Available in 3ds Max 8 and higher.

   

<Ellipse>.render_threshold Float default: 40.0 -- animatable; 

Get/set the Auto Smooth Threshold value.

Available in 3ds Max 8 and higher.

   

See Also