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

Command-line options

On / Off / Toggle

Turns the Gumball widget on or off for the selected object, or toggles between on and off.

Gumball widget

The Gumball widget consists of many control handles for different transform actions.

To show tooltip for handle actions

To hide handles

  1. Run the GumballSettings command.
  2. Select the Handles option.
  3. Turn off the handles you would like to hide on the Gumball widget.

Plane handle actions

Move planar
Extrude - Ctrl (⌘ on Mac)
Copy - Tap Alt (⌥ on Mac)
Scale2D - Shift (⇧ on Mac)
Move gumball planar - Double click
  1. Double-click on a plane handle to relocate Gumball on the plane.

  2. Move the mouse and click, or type a distance and press Enter.

Extrude handle actions

Extrude
Open extrude - Ctrl (⌘ on Mac)
Extend Face - Shift (⇧ on Mac)

Extend
Extrude

The PushPull command provides the similar editing abilities of the Extrude / Extend handle.

Copy - Tap Alt (⌥ on Mac)
Numeric entry - Click

Origin point actions

Arrow handle actions

Move
Extrude - Ctrl (⌘ on Mac)
Copy - Tap Alt (⌥ on Mac)
Numeric entry - Click
Move Gumball
  1. Double-click on an arrow to relocate Gumball along the direction.
  2. Move the mouse and click, or type a distance and press Enter.

Menu ball (Bunny tail) actions

Click

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.

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.

The default alignment is different for different object types.

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.

Merge faces after extrude

Merges the coplanar faces related to the extruding operation when possible.

Rotate View Around Gumball

When the Gumball widget is visible, rotate the view around the Gumball origin. Otherwise, rotate the view around the center.

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.

Arc handle actions

Rotate
Extrude - Ctrl (⌘ on Mac)
Copy - Tap Alt (⌥ on Mac)
Numeric entry - Click
Rotate gumball - Double click
  1. Double-click on an arc to turn the Gumball widget around the axis.

  2. Move the mouse and click, or type an angle and press Enter.

Scale handle actions

Scale1D
Extrude - Ctrl (⌘ on Mac)
Scale3D - Shift (⇧ on Mac)
Copy - Tap Alt (⌥ on Mac)
Numeric entry - Click
Move handles - Double click
  1. Double-clink on a scale handle to change its length.

  2. Move the mouse and click, or type a scale factor and press Enter.

Cut handle actions

Cut
Boss - Ctrl (⌘ on Mac)
Both sides - Shift (⇧ on Mac)
Numeric entry - Click

Common operations

Some operations work the same way on different Gumball handles.

Numeric input

  1. Click on any handle.

  2. Type a number for distance, rotation angle, or scale factor.

Copy object

  1. Drag any handle.

  2. While dragging, tap Alt (⌥) to toggle copy mode on.

    Tap Alt (⌥) again to toggle copy mode off.

Copy object with numeric input

  1. Alt (⌥) + click on any handle.

  2. Type a number for distance, rotation angle, or scale factor.

Use distance and angle constraint

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

  1. While dragging a handle, type a number, and press Enter.

  2. Continue dragging the handle.

    Distances are constrained along the axis arrow line.
    Angles are constrained in increments of the angle around the rotation arc.

Change Gumball widget location and orientation

To move, rotate, or scale Gumball widget freely

  1. Double-click on a handle.
  2. Drag the handle and release.

To move rotate, or scale Gumball widget with numeric input

  1. Ctrl (⌘) + Double-click on a handle.

  2. Type a number in the value box for distance, rotation angle, or scale factor.

Related commands

GumballSettings

Toolbar

Menu

Not on toolbars.

Not on menus.

The GumballSettings command changes Gumball appearances from Command-line options.

Command-line options

AutoGumball

Turns on the Gumball widget for the selected object.

SnappyGumball

Uses object snaps when dragging one of the Gumball handles.

Colors

Sets the colors of the Gumball handles in X, Y, and Z directions.

Handles

Changes the visibility of Gumball components.

MoveHandle

The arrows including the cutting line and extrude dot.

RotateHandle

The arcs around the X, Y, and Z axes.

ScaleHandle

The small rectangles and the dotted lines connecting to the Gumball origin.

PlaneHandle

The window icons on the XY, YZ, and XZ planes.

ExtrudeHandle

The dot on the Z arrow shaft.

CutHandle

The short line on the Z arrow shaft.

MenuHandle

The small circle and the dotted line connecting to the Gumball origin.

Sizes

Sets the size of the Gumball widget and handles in pixels.

Radius

The size of the arcs and arrows.

TipLength

The length of the arrow heads.

TipWidth

The width of the arrow heads.

TailSize

The size of the small rectangles.

PlaneLocation

The distance between a window icon and the Gumball origin.

PlaneSize

The size of the window icons.

PlaneVisibilityAngle

The angle of view for a window icon to be visible. Details...

AxisThickness

The thickness of the arrow shafts.

ArcThickness

The thickness of the arcs.

MenuBallDistance

The distance between the Gumball origin and the menu circle.

MenuBallSize

The radius of the menu circle.

RotateViewAroundAutoGumball

When the Gumball widget is visible, rotate the view around the Gumball origin. Otherwise, rotate the view around the center.

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

Align to View

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.

GumballDynamicRelocate

Toolbar

Menu

Not on toolbars.

The GumballDynamicRelocate command allows relocating Gumball by dragging one of its controls.

Steps

See Also

GumballRelocate

Changes the Gumball widget location and orientation of on an object.

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.

    Continue with step 2, or press Enter to align Gumball to World, CPlane, or View axes based on the current Gumball alignment mode. When Gumball aligns to object, the current orientation is used.

  2. Pick a point to set the x-axis direction.

  3. Pick another point to set the y-axis direction.

    The z-axis direction is set according to the Right-hand rule.

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 8 © 2010-2024 Robert McNeel & Associates. 09-Apr-2024