MAXScript Tools and Interaction with 3ds Max > Creating MAXScript Tools > Scripted Utilities and Rollouts > Rollout User-Interface Controls > Rollout User-Interface Controls Types >

# Angle UI element

User Interface Controls > Common Properties > Layout > Types > Angle

| Creating User Interfaces - Quick Navigation

The Angle is a UI Control which can be used to draw a circular clock-like element representing an angle in degrees or radians.

The syntax is:

    Angle <name> [caption] [color:<color>] [degrees:<float>] [bitmap:<bitmap>] [diameter:<float>] [StartDegrees:<integer>] [StartRadians:<integer>] [dir:<#cw|#ccw>] [range:<point3>]

Properties

    <Angle>.color color default:(color 0 0 255)

Get/set the angle fill-in color. Setting the color turns off the Bitmap fill.

    <Angle>.bitmap Bitmap default:undefined

Get/set the angle fill-in Bitmap. Setting the Bitmap turns off the color fill.

    <Angle>.diameter Integer default:64

Get/set the full diameter of the control, synonymous to .width and .height.

    <Angle>.degrees Float default:0.0

Get/set the current angle in degrees.

    <Angle>.radians Float default:0.0

Get/set the current angle in radians.

    <Angle>.StartDegrees Integerdefault:0

Get/set the start angle in degrees.

    <Angle>.StartRadians Integerdefault:0

Get/set the start angle in radians.

    <Angle>.dir Name default:#ccw

Get/set the angle direction. Possible values are #cw for Clockwise and #ccw for Counter-Clockwise.

    <Angle>.range

Get/set the angle range as a point3 value.The first component defines the min. value, the second is the max. value, the third is the current value. All three values are in degrees.

If min.and max.valueshavethe same sign, click and move in angle UI will give result with the same sign.

If min.and max. values have different signs, shift or ctrl click will give negative result, click will give positive result.

Events

    on <Angle> changed <arg> do <expr>

Called when the angle is being changed . <arg> is the current degrees value.

    on <Angle> rightClick do <expr>

Called when the Angle control is right-clicked.

If the handler is not defined, right-clicking the Angle control resets its value.

Available in 3ds Max 2010 and higher.

EXAMPLE
    rollout test "Angle Test"
    (
    Angle ang1 "Angle 1" diameter:50 align:#left range:[-180,180,45] startdegrees:0 dir:#cw color:red across:3
    Angle ang2 "Angle 2" diameter:50 align:#center range:[0,270,90] startdegrees:90 dir:#ccw color:green
    Angle ang3 "Angle 3" diameter:50 align:#right range:[0,360,120] startdegrees:270 dir:#cw color:blue
    spinner val1 fieldwidth:40 align:#left across:3range:[-180,180,45]
    spinner val2 fieldwidth:40 align:#centerrange:[0,270,90]
    spinner val3 fieldwidth:40 align:#rightrange:[0,360,120]
    on ang 1 changed val do val1.value = val
    on ang 2 changed val do val2.value = val
    on ang 3 changed val do val3.value = val
    on val 1 changed val do ang1.degrees = val
    on val 2 changed val do ang2.degrees= val
    on val 3 changed val do ang3.degrees= val
    )
    createdialog test 200 110

#### See Also

- Rollout User-Interface Controls

- Rollout User-Interface Controls Types

- Rollout User-Interface Controls Common Layout Parameters

- Rollout User-Interface Controls Common Properties

- Similar Controls

- Spinner

- Slider

- Curve Control

- Colorpicker