[_CDMiwok_01_]<cedarcommon2.0>Gargoyle>GGSelect.mesa!1

GGSelect.mesa

Contents: Procedures dealing selecting and deselecting objects, including both selection actions and selection feedback.

Pier, October 27, 1988 4:22:18 pm PDT

Kurlander August 25, 1986 2:16:06 pm PDT

Bier, June 22, 1989 9:19:52 pm PDT

DIRECTORY

GGBasicTypes, GGCoreTypes, GGInterfaceTypes, GGModelTypes, GGSegmentTypes, GGScene;

GGSelect: CEDAR DEFINITIONS = BEGIN

BoundBox: TYPE = GGCoreTypes.BoundBox;

Caret: TYPE = GGInterfaceTypes.Caret;

Scene: TYPE = GGModelTypes.Scene;

SelectionClass: TYPE = GGSegmentTypes.SelectionClass;

Sequence: TYPE = GGModelTypes.Sequence;

Slice: TYPE = GGModelTypes.Slice;

SliceDescriptor: TYPE = GGModelTypes.SliceDescriptor;

SliceDescriptorGenerator: TYPE = GGModelTypes.SliceDescriptorGenerator;

SliceGenerator: TYPE = GGModelTypes.SliceGenerator;

SliceParts: TYPE = GGModelTypes.SliceParts;

Traj: TYPE = GGModelTypes.Traj;

TrajEnd: TYPE = GGModelTypes.TrajEnd;

Select

SelectAll: PROC [scene: Scene, selectClass: SelectionClass];

SelectEntireSlice: PROC [slice: Slice, scene: Scene, selectClass: SelectionClass];

SelectSlice: PROC [sliceD: SliceDescriptor, scene: Scene, selectClass: SelectionClass];

SelectSliceFromParts: PROC [slice: Slice, parts: SliceParts, scene: Scene, selectClass: SelectionClass];

SaveSelectionsInSliceAllClasses: PROC [slice: Slice, scene: Scene];

ReselectSliceAllClasses: PROC [slice: Slice, scene: Scene];

ReselectTraj: PROC [traj: Traj, trajEnd: TrajEnd, scene: Scene, extend: BOOL] RETURNS [newHot: Sequence];

Deselect

DeselectEntity: PROC [entity: REF ANY, scene: Scene, selectClass: SelectionClass];

DeselectEntityAllClasses: PROC [entity: REF ANY, scene: Scene];

DeselectAll: PROC [scene: Scene, selectClass: SelectionClass];

DeselectAllAllClasses: PROC [scene: Scene];

DeselectSlice: PROC [slice: Slice, parts: SliceParts, scene: Scene, selectClass: SelectionClass];

DeselectEntireSlice: PROC [slice: Slice, scene: Scene, selectClass: SelectionClass];

Enumerate Selected Objects

IsSelectedInFull: PROC [slice: Slice, scene: Scene, selectClass: SelectionClass] RETURNS [BOOL];

Returns TRUE iff the slice is selected in entirety.

IsSelectedInPart: PROC [entity: REF ANY, scene: Scene, selectClass: SelectionClass] RETURNS [BOOL];

Returns TRUE if all or part of entity is selected. These are the cases:

1) entity is a slice. Some outline is selected all or in part.

2) entity is an outline. Some trajectory is selected all or in part.

3) entity is a trajectory. Some joint or segment is selected.

4) entity is a sequence. Some joint or segment is selected

NoSelections: PROC [scene: Scene, selectClass: SelectionClass] RETURNS [BOOL];

Returns TRUE if nothing is currently selected.

FindSelectedSlice: PROC [slice: Slice, selectClass: SelectionClass] RETURNS [sliceD: SliceDescriptor];

GetLastSelection: PROC [scene: Scene] RETURNS [sliceD: SliceDescriptor];

If slice is not selected at all, this returns NIL.

DuplicateSelections: PROC [scene: Scene, fromClass: SelectionClass, toClass: SelectionClass];

ForEachOutlineRun: PROC [scene: Scene, selectClass: SelectionClass, runProc: RunProc, segmentsOnly: BOOL ← TRUE, selectNewRuns: BOOL ← FALSE] RETURNS [bBox: BoundBox];

Finds all selected runs (contigous selections of joints and segments, and allows the called to replace them, using a callback proc. This is used for deletion and for changing spline type. IF segmentsOnly is true, ForEachOutlineRun will not call the runProc with runs consisting of a single joint. If selectNewRuns is true, the new runs will be normal selected after ForEachOutlineRun completes.

SubstituteForSegment: PROC [traj: Traj, segNum: NAT, newRun: Traj, scene: Scene] RETURNS [bBox: BoundBox, newTraj: Traj];

Replaces the specified segment with a new run. Probably shouldn't be in GGSelect, but it uses many of the non-public routines used by ForEachOutlineRun.

ListSelected: PROC [scene: Scene, selectClass: SelectionClass] RETURNS [selectedList: LIST OF SliceDescriptor];

SetSelected: PROC [scene: Scene, selectClass: SelectionClass, selected: LIST OF SliceDescriptor];

For each SliceDescriptor in selected that is not obsolete, re-establish that selection. Remember to call DeselectAll[scene, selectClass] if you wish to replace any existing selections.

UniformSelections: PROC [scene: Scene, selectClass: SelectionClass] RETURNS [BOOL];

Returns TRUE if every selected segment (or segment equivalent) has the same looks and every selected fence has the same fill color and every selected text slice has the same font.

END.