Gumball

Toolbar	Menu	Status bar
Gumball Organic	Not on menus.	Gumball

Toolbar

Status bar

Toolbar: Gumball | Organic

Not on menus.

The Gumball command displays the gumball widget on a selected object facilitating move, scale, and rotate transformations around the gumball origin.

Steps

Click the Gumball pane in the status bar.

Object actions

Drag gumball arrows to Move the object.
Drag scale handles (squares) to Scale the object in one direction.
Drag arcs to Rotate the object.
Tap Alt after starting to drag to toggle copy mode.
Press and hold Shift during Scale to force 3-D scale.
Press and hold Shift while clicking and dragging the Axis Plane Indicator to force 2-D Scale.
Press and hold Ctrl during move, scale or rotate to Extrude a planar curve or surface.
Click a control handle to enter numeric value.

Gumball controls

Axis plane indicator

Gumball origin

Menu ball

Move arrows

Move X

Move Y

Move Z

Rotation arcs

Rotate X

Rotate Y

Rotate Z

Scale handles

Scale X

Scale Y

Scale Z

Extrude

Overview

Axis plane indicator (1)

Drag by the plane icons to constrain movement to that plane.
Hold down Shift to scale in two directions.

Gumball origin (2)

Drag the gumball origin to drag the whole object in any direction.

Control point style and size settings in display modes control the appearance of the Gumball origin point.

Menu ball "bunny tail" (3)

Click to change gumball settings.
Change the size in Gumball options. 0 turns it off.

Move arrows (4, 5, 6)

Click and drag a gumball x, y, or z arrow control to move the objects in the arrow direction.
Click an arrow to enter a distance, press Enter.

Rotation arcs (7, 8, 9)

Rotate the object on the gumball origin.
Click an arc to enter a rotation angle, press Enter.

Scale handles (10, 11, 12)

Click and drag a gumball scale handle to scale in one dimension along the arrow axis.
Click a scale handle to enter a scale factor, press Enter.
Press and hold Shift to force a 3-D scale.
The scale base point is the gumball origin.

Extrude handles (13)

Click and drag a gumball Extrude handle to Extrude a curve or point along the arrow axis.
Click an extrude handle to enter an extruding distance, press Enter.
Press and hold Shift to force extruding to both sides.

Copy

Tap Alt while dragging any control to create a copy.

Quick access of Gumball settings

Click the menu ball.
Right-click and hold on any part of the Gumball widget. When the page icon appears, release the right mouse button.
The Rhino mouse button settings in Options > Mouse control the display timing of the page icon and the accessibility of the Gumball menu.

Relocate Gumball

Drag to relocate gumball widget away from its default position.

Reset Gumball

Restores the default placement and orientation for the gumball.

Align to CPlane

Gumball widgets align to the construction plane.

Align to Object

Gumball widgets align to the object direction for:

Curves
Extrusion objects
Lights
Mesh faces and edges and vertices
Planar objects and sub-objects
The camera object (Camera) and NamedView camera widget

Exceptions

Free-form top-level objects

The gumball aligns with the construction plane with its origin at the object's centroid.

Curve control points

The gumball z direction (blue arrow) aligns with the curve normal.

The gumball x direction (red arrow) aligns with the curve tangent.

Surface control points

The gumball z direction (blue arrow) aligns with the surface normal.

The gumball x direction (red arrow) aligns with the surface u direction.

Align to World

Gumball widgets align to world xyz directions.

Snappy Dragging

Object snaps are used when dragging.

Smooth Dragging

Object snaps are ignored when dragging.

Drag Strength

Sets the amount of the gumball drag as a percentage of mouse movement to control the speed of the gumball movement. The default 100% moves the gumball consistently with the mouse.

To fine-tune placing objects (such as with control point editing) set the strength lower, so large hand/mouse movements result in smaller gumball changes. When the control is closed, drag strength is reset to 100%.

Settings...

Opens Gumball options.

Command-line options
On	Turns gumball widgets on for selected objects.
Off	Turns gumball widgets off.
Toggle	Toggles the on/off state of the gumball widgets.

Object actions

Move, rotate, or scale objects

Click and drag any gumball arrow, arc, or scale handle.

Copy during any operation

Click any gumball arrow, arc, or scale handle.
Start dragging the object.
Tap Alt to toggle copy mode on.
Tap Alt again to turn off copy mode.

Specify a distance, rotation angle, or scale factor

Click any gumball arrow, arc, or scale handle.
In the edit box, type a distance, rotation angle or scale factor that will be applied to the selected object.

Copy with numeric input

Press and hold Alt and click any gumball arrow, arc, or scale handle.
In the edit box, type a distance, rotation angle or scale factor that will be applied to a copy of the selected object.

Use distance and angle constraint

Normal Rhino distance and angle constraints can be used during a gumball operation.

Start dragging an object.
Type a number, and press Enter.
This number appears on the command line and is used to constrain a distance or angle of rotation.
Drag the object.
Distances are constrained along the axis arrow line.
Angles are constrained in increments of the angle around the rotation arc.

Extrude a curve or surface

Click and drag any gumball arrow on a planar curve or surface.
Press and hold Ctrl.
Release the mouse button.
The result is an open extrusion. To create a solid, Cap the result.

Note: Press the Shift key to extrude on both sides.

To extrude a specific distance

Start dragging a planar curve or surface.
With the mouse button down, type a distance and press Enter.
This number appears on the command line and will constrain the distance.
Press and hold Ctrl and release the mouse button.

The result is an open extrusion. To create a solid, Cap the result.

Gumball widget location and orientation

To move, rotate, or scale the gumball widget controls freely

Press and hold Ctrl and click and drag the gumball control to move, rotate, or scale the control freely.

To move rotate, or scale the gumball widget controls with numeric control

Press and hold Ctrl and click any gumball arrow, arc, or scale control.
In the edit box, type a distance, rotation angle or scale factor that will be applied to the gumball control.

Relocate Gumball

Press Ctrl and click the gumball widget (ignore the text field).
Release Ctrl and start dragging to relocate the gumball widget.

Status bar options

To access the status bar menu

Right-click the Gumball pane in the status bar to access options.

AutoReset Gumball

When an object is rotated, resets Gumball to align with CPlane or World axes based on the initial alignment.

Gumball On

Turns the gumball widget on any time objects are selected.

Gumball Off

Disables auto gumball.

Align to CPlane

Gumball widgets align to the construction plane.

Align to Object

Gumball widgets align to the object direction for:

Curves
Extrusion objects
Lights
Mesh faces and edges and vertices
Planar objects and sub-objects
The camera object (Camera) and NamedView camera widget

Exceptions

Free-form top-level objects

The gumball aligns with the construction plane with its origin at the object's centroid.

Curve control points

The gumball z direction (blue arrow) aligns with the curve normal.

The gumball x direction (red arrow) aligns with the curve tangent.

Surface control points

The gumball z direction (blue arrow) aligns with the surface normal.

The gumball x direction (red arrow) aligns with the surface u direction.

Align to World

Gumball widgets align to world xyz directions.

Snappy Dragging

Object snaps are used when dragging.

Smooth Dragging

Object snaps are ignored when dragging.

Rotate View Around Gumball

Rotate both the view camera and view target at the gumball origin when rotating the view.

Drag Strength

Sets the amount of the gumball drag as a percentage of mouse movement to control the speed of the gumball movement. The default 100% moves the gumball consistently with the mouse.

Settings...

Opens Gumball options.

Related commands

GumballAlignment

Toolbar	Menu	Status bar	Gumball widget menu
CPlane Object World Gumball	Not on menus.	Gumball <Options>	Align to CPlane Align to Object Align to World

Toolbar

Status bar

Gumball widget menu

GumballAlignment - CPlane

CPlane

GumballAlignment: Object

Object

GumballAlignment - World

World

Gumball

Not on menus.

Right-mouse button Gumball

Align to CPlane

Align to Object

Align to World

The GumballAlignment command resets the gumball widget alignment.

Note

Alignment will not change if you have previously modified the gumball position or orientation.
Right-click the gumball and use Reset from the gumball context menu to force the new alignment for these objects.
Alignment is based on the object bounding box.

Command-line options
CPlane	Sets the gumball widget alignment to the active construction plane.
Object	Sets the gumball widget alignment to the selected object. The object aligned gumball is placed at the planar face center unless the object is a picture frame.
World	Sets the gumball widget alignment to world coordinates.

GumballScaleMode

Toolbar	Menu
Not on toolbars.	Not on menus.

Toolbar

Not on toolbars.

Not on menus.

The GumballScaleMode command sets the size of the scale handles either relative to the gumball radius or based on the object size. This command does not affect the move handles (arrows) and rotate handles (arcs).

Command-line options
Mode	Relative The scale handle size is the product of the Gumball radius multiplied by the RelativeHandlePositionMultiplier value. Gumball Radius=x with RelativeHandlePositionMultiplier=1.25 Absolute The scale handles extend to the object's bounding box boundary. Note In the Absolute mode, entering the scale value with different formats scales the object differently. 10 scales the object 10 times. -10 scales the object 10 times and flips the object. 10mm scales the object to 10 mm in the direction. +10mm or -10mm grows or shrinks the object 10 mm in the direction.
RelativeHandlePositionMultiplier	Specifies the size of the scale handles relative to the Gumball radius setting. Numbers larger than 1 make the gumball scale handles longer than the Gumball radius. Numbers between 0 and 1 make the gumball scale handles shorter than the Gumball radius.

Command-line options

Mode

Relative

The scale handle size is the product of the Gumball radius multiplied by the RelativeHandlePositionMultiplier value.

Gumball Radius=x with RelativeHandlePositionMultiplier=1.25

Absolute

The scale handles extend to the object's bounding box boundary.

Note

In the Absolute mode, entering the scale value with different formats scales the object differently.

10 scales the object 10 times.
-10 scales the object 10 times and flips the object.
10mm scales the object to 10 mm in the direction.
+10mm or -10mm grows or shrinks the object 10 mm in the direction.

RelativeHandlePositionMultiplier

Specifies the size of the scale handles relative to the Gumball radius setting. Numbers larger than 1 make the gumball scale handles longer than the Gumball radius. Numbers between 0 and 1 make the gumball scale handles shorter than the Gumball radius.

GumballRelocate

Toolbar	Menu	Gumball widget menu
Gumball	Not on menus.	Relocate Gumball

Toolbar

Gumball widget menu

Toolbar: Gumball

Gumball

Not on menus.

Relocate Gumball

The GumballRelocate command moves the gumball origin and orientation of an object.

The other way to move Gumball is to press and hold Ctrl and drag the Gumball widget rather than the object.

Steps

Pick a location for the Gumball origin.
Press Enter to reset the Gumball y and z axes automatically based on the active viewport construction plane and the x axis direction.
Pick a location for the Gumball x axis direction.
Pick a point to specify the Gumball y axis orientation.
Release Ctrl to use object snaps to place the widget at a snap location.

GumballReset

Toolbar	Menu	Gumball widget menu
Not on toolbars.	Not on menus.	Reset Gumball

Toolbar

Gumball widget menu

Not on toolbars.

Not on menus.

Reset Gumball

The GumballReset command makes the orientation of the gumball instantly snap back to its original location after being relocated with GumballRelocate.

GumballAutoReset

Toolbar	Menu	Status bar
Gumball	Not on menus.	Gumball AutoReset Gumball

Toolbar

Status bar

Toolbar: Gumball

Gumball

Not on menus.

Right-mouse button Gumball

AutoReset Gumball

The GumballAutoReset command makes the orientation of the gumball snap back to its starting location after every transformation.

This setting allows free rotation of the object while constraining the original orientation.

Gumball

Steps

Object actions

Gumball controls

Move arrows

Rotation arcs

Scale handles

Axis plane indicator (1)

Gumball origin (2)

Menu ball "bunny tail" (3)

Move arrows (4, 5, 6)

Rotation arcs (7, 8, 9)

Scale handles (10, 11, 12)

Extrude handles (13)

Copy

Quick access of Gumball settings

Relocate Gumball

Reset Gumball

Align to CPlane

Align to Object

Exceptions

Free-form top-level objects

Curve control points

Surface control points

Align to World

Snappy Dragging

Smooth Dragging

Drag Strength

Settings...

Object actions

Move, rotate, or scale objects

Copy during any operation

Specify a distance, rotation angle, or scale factor

Copy with numeric input

Use distance and angle constraint

Extrude a curve or surface

To extrude a specific distance

Gumball widget location and orientation

To move, rotate, or scale the gumball widget controls freely

To move rotate, or scale the gumball widget controls with numeric control

Relocate Gumball

Status bar options

To access the status bar menu

AutoReset Gumball

Gumball On

Gumball Off

Align to CPlane

Align to Object

Exceptions

Free-form top-level objects

Curve control points

Surface control points

Align to World

Snappy Dragging

Smooth Dragging

Rotate View Around Gumball

Drag Strength

Settings...

Related commands

GumballAlignment

Note

GumballScaleMode

Relative

Absolute

Note

GumballRelocate

Steps

GumballReset

GumballAutoReset

See also