Interface: Grip

This Core Interface introduced in 3ds Max 2011 exposes methods to control the display of the Caddy (a.k.a. Grip) manipulators.

See also Interface: EPolyManipGrip

   

Interface: Grip

Properties:

Grip.Show : bool : Read|Write 	 

Get/set the visibility of the Caddy manipulator.

Default is true.

Grip.Show = True

Grip.Show = False

 
 

   

Grip.CenterOnSelected : bool : Read|Write   

Get/set whether to center the Caddy manipulator at the selection (true) or place it relative to the upper left corner of the current viewport (false).

Default was true in 3ds Max 2011, changed to false in 3ds Max 2012.

Grip.CenterOnSelected = True

Grip.CenterOnSelected = False

 
 

   

Grip.SelectedXOffset : integer : Read|Write 

Get/set the Horizontal Offset of the Caddy manipulator relatively to the current selection.

Default was 0 in 3ds Max 2011, changed to 80 in 3ds Max 2012.

Used when .CenterOnSelection is set to true.

Grip.SelectedXOffset = 0

Grip.SelectedXOffset = 50

 
 

   

Grip.SelectedYOffset : integer : Read|Write 

Get/set the Vertical Offset of the Caddy manipulator relatively to the current selection.

Default was 0 in 3ds Max 2011, changed to -35 in 3ds Max 2012.

Used when .CenterOnSelection is set to true.

Grip.SelectedXOffset = 0

Grip.SelectedYOffset = 0

Grip.SelectedXOffset = 50

Grip.SelectedYOffset = 50

 
 

   

Grip.CenterXPos : float : Read|Write 

Get/set the Horizontal Position of the Caddy manipulator's center.

Used when .CenterOnSelection is set to false.

   

Grip.CenterYPos : float : Read|Write 

Get/set the Vertical Position of the Caddy manipulator's center.

Used when .CenterOnSelection is set to false.

Grip.CenterOnSelected = False

Grip.CenterXPos = 0.5

Grip.CenterYPos = 0.5

 

 

 

Grip.CenterOnSelected = False

Grip.CenterXPos = 0.65

Grip.CenterYPos = 0.4

Grip.CenterOnSelected = False

Grip.CenterXPos = 0.65

Grip.CenterYPos = 0.4

 
 

As you can see from the above screenshots, the Caddy is offset relative to the viewport's upper left corner regardless of the location of the selected polygons being edited.

This allows you place the Caddy's gizmo at a constant position in viewport space relative to the view's upper left corner to avoid "hunting" for the Caddy as selection changes.

 

   

Grip.Transparency : float : Read|Write 

Get/set the Transparency of the Caddy Manipulator.

Default was 0.25 in 3ds Max 2011, changed to 0.4 in 3ds Max 2012.

Grip.Transparency = 0.25

Grip.Transparency = 0.75

 
 

   

Grip.HoverTransparency : float : Read|Write 

Get/set the Transparency of the Caddy Manipulator when the mouse hovers over it.

Default is 0.1

Grip.Transparency = 0.75

Grip.HoverTransparency = 0.1

Grip.Transparency = 0.75

Grip.HoverTransparency = 0.5

 
 

   

Grip.WidgetSpacing: float : Read|Write 

Get/set the Spacing of the Caddy Manipulator's Widgets.

Default is 7.0

Grip.WidgetSpacing = 0.0

Grip.WidgetSpacing = 15.0

 
 

See Also