MAXScript Language Reference > 3ds Max Objects > Node : MAXWrapper > Node Subclasses > Shape : Node > Shapes - Splines >

# 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

- Spline Shape Common Properties, Operators, and Methods

- Shape Common Properties, Operators, and Methods

- Node Common Properties, Operators, and Methods

- MAXWrapper Common Properties, Operators, and Methods

- Value Common Properties, Operators, and Methods