Gumball

Toolbar Menu Status bar

Gumball

Organic

Not on menus.

Gumball

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

Steps

Object actions

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)
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

Drag to relocate gumball widget away from its default position.

Reset Gumball

Restores the default placement and orientation for the gumball.

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 xyz directions. The Gumball origin will be at the CPlane oriented bounding box center of the object.

Align to Object

Gumball widgets align to the object direction for:

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. The Gumball origin will be at the World oriented bounding box center of the object.

Align to View

Gumball widgets align to the view plane of the current viewport.

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.

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

Copy during any operation

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

Specify a distance, rotation angle, or scale factor

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

Copy with numeric input

Use distance and angle constraint

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

  1. Start dragging an object.
  2. Type a number, and press Enter.
    This number appears on the command line and is used to constrain a distance or angle of rotation.
  3. 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

  1. Click and drag any gumball arrow on a planar curve or surface.
  2. Press and hold Ctrl.

  3. 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

  1. Start dragging a planar curve or surface.
  2. With the mouse button down, type a distance and press Enter.
    This number appears on the command line and will constrain the distance.
  3. 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

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

  1. Press and hold Ctrl and click any gumball arrow, arc, or scale control.

  2. In the edit box, type a distance, rotation angle or scale factor that will be applied to the gumball control.

Relocate Gumball

  1. Press Ctrl and click the gumball widget (ignore the text field).

  2. Release Ctrl and start dragging to relocate the gumball widget.

Status bar options

To access the status bar menu

Relocate Gumball

Drag to relocate gumball widget away from its default position.

Reset Gumball

Restores the default placement and orientation for the gumball.

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 xyz directions. The Gumball origin will be at the CPlane oriented bounding box center of the object.

Align to Object

Gumball widgets align to the object direction for:

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. The Gumball origin will be at the World oriented bounding box center of the object.

Align to View

Gumball widgets align to the view plane of the current viewport.

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.

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.

Related commands

GumballAlignment

Toolbar Menu Status bar Gumball widget menu

GumballAlignment - CPlane

CPlane

GumballAlignment: Object

Object

GumballAlignment - World

World

Gumball

Not on menus.

Gumball

<Options>

Align to CPlane

Align to Object

Align to World

The GumballAlignment command resets the gumball widget alignment.

Note

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.

View

Sets the gumball widget alignment to the view plane of the current viewport.

GumballScaleMode

Toolbar Menu

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.

GumballRelocate

Toolbar Menu Gumball widget menu

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

  1. 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.
  2. Pick a location for the Gumball x axis direction.
  3. Pick a point to specify the Gumball y axis orientation.
  4. Release Ctrl to use object snaps to place the widget at a snap location.

Command-line options

SetScaleHandles

Sets the length of the x, y, and z scale handles.

GumballReset

Toolbar Menu 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

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.

See also

Move objects

Transform objects

Hello Gumball!

Gumball Advanced

 

 

 

Rhinoceros 7 © 2010-2024 Robert McNeel & Associates. 10-Mar-2024