Terrapin Resources

HIT?

Also: HITP

Tests the first active widget against widgets listed on the hit list.

Syntax

Description

HIT? checks if the active widget overlaps one or more of the widgets listed in the hit list (see HITTABLE). It reports a list of the widgets that overlap the first active widget. If the widget does not overlap any other hittable widget, the returned list is empty.

See also HITTABLE and SETHITTABLE.

Example

HIT? Result: [ROCK TREE]

HITTABLE

Reports the contents of the hit list.

Syntax

Description

HITTABLE reports the current hit list. The hit list is a list of widgets that hit testing checks a moving widget against.

See also SETHITTABLE and HIT?.

Example

HITTABLE Result: [ROCK TREE FENCE]

PLACE

Attempts to place the active widgets at the suggested location.

Syntax

Description

PLACE works much like the SETXY command. It attempts to move the active widgets to the given coordinates. Before moving, it checks the suggested location to see whether it overlaps with any of the widgets in the hit list (see HITTABLE). If it does, PLACE attempts to place the widget(s) as close to the suggested position as possible without overlapping any other hittable widgets.

Therefore, the widget’s resulting position may be different from the suggested position.

Example

PLACE [100 100] GETXY Result: [105 100]

SETHITTABLE

Sets the contents of the hit list.

Syntax

Description

SETHITTABLE sets the hit list to a list of widget names. The hit list is a list of widgets that hit testing checks a moving widget against.

If a widget is destroyed, it is removed from the hit list.

See also HITTABLE and HIT?.

Example

SETHITTABLE [ROCK TREE FENCE]