[Cyan]<CedarChest7.0>Gargoyle>GGSlice.mesa!3

GGSlice.mesa

Contents: Implements the various slice classes in Gargoyle.

Pier, April 24, 1987 3:05:11 pm PDT

Bier, April 6, 1987 6:34:04 pm PDT

DIRECTORY

AtomButtonsTypes, GGBasicTypes, GGFont, GGInterfaceTypes, GGModelTypes, GGSegmentTypes, Imager, ImagerFont, ImagerTransformation, Interpress, NodeStyle, Rope, ViewerClasses;

GGSlice: CEDAR DEFINITIONS

IMPORTS Imager = BEGIN

WalkProc: TYPE = GGModelTypes.WalkProc;

BoundBox: TYPE = GGModelTypes.BoundBox;

Color: TYPE = Imager.Color;

DefaultData: TYPE = GGInterfaceTypes.DefaultData;

EntityGenerator: TYPE = GGModelTypes.EntityGenerator;

FeedbackData: TYPE = AtomButtonsTypes.FeedbackData;

FontData: TYPE = GGFont.FontData;

Point: TYPE = GGBasicTypes.Point;

PointGenerator: TYPE = GGModelTypes.PointGenerator;

PointPairGenerator: TYPE = GGModelTypes.PointPairGenerator;

Segment: TYPE = GGSegmentTypes.Segment;

SegmentGenerator: TYPE = GGModelTypes.SegmentGenerator;

Scene: TYPE = GGModelTypes.Scene;

SelectionClass: TYPE = GGSegmentTypes.SelectionClass;

Slice: TYPE = GGModelTypes.Slice;

SliceClass: TYPE = GGModelTypes.SliceClass;

SliceDescriptor: TYPE = GGModelTypes.SliceDescriptor;

SliceParts: TYPE = GGModelTypes.SliceParts;

StrokeEnd: TYPE = Imager.StrokeEnd;

Vector: TYPE = GGBasicTypes.Vector;

Viewer: TYPE = ViewerClasses.Viewer;

SliceBoundBoxProc: TYPE = GGModelTypes.SliceBoundBoxProc;

SliceTightBoxProc: TYPE = GGModelTypes.SliceTightBoxProc;

SliceCopyProc: TYPE = GGModelTypes.SliceCopyProc;

SliceDrawPartsProc: TYPE = GGModelTypes.SliceDrawPartsProc;

SliceDrawTransformProc: TYPE = GGModelTypes.SliceDrawTransformProc;

SliceDrawSelectionFeedbackProc: TYPE = GGModelTypes.SliceDrawSelectionFeedbackProc;

SliceDrawAttractorFeedbackProc: TYPE = GGModelTypes.SliceDrawAttractorFeedbackProc;

SliceTransformProc: TYPE = GGModelTypes.SliceTransformProc;

SliceDescribeHitProc: TYPE = GGModelTypes.SliceDescribeHitProc;

SliceDescribeProc: TYPE = GGModelTypes.SliceDescribeProc;

SliceFileoutProc: TYPE = GGModelTypes.SliceFileoutProc;

SliceFileinProc: TYPE = GGModelTypes.SliceFileinProc;

SliceEmptyPartsProc: TYPE = GGModelTypes.SliceEmptyPartsProc;

SliceNewPartsProc: TYPE = GGModelTypes.SliceNewPartsProc;

SliceUnionPartsProc: TYPE = GGModelTypes.SliceUnionPartsProc;

SliceDifferencePartsProc: TYPE = GGModelTypes.SliceDifferencePartsProc;

SliceMovingPartsProc: TYPE = GGModelTypes.SliceMovingPartsProc;

SliceAugmentPartsProc: TYPE = GGModelTypes.SliceAugmentPartsProc;

SliceSetSelectedFieldsProc: TYPE = GGModelTypes.SliceSetSelectedFieldsProc;

SlicePointsInDescriptorProc: TYPE = GGModelTypes.SlicePointsInDescriptorProc;

SlicePointPairsInDescriptorProc: TYPE = GGModelTypes.SlicePointPairsInDescriptorProc;

SliceSegmentsInDescriptorProc: TYPE = GGModelTypes.SliceSegmentsInDescriptorProc;

SliceWalkSegmentsProc: TYPE = GGModelTypes.SliceWalkSegmentsProc;

SliceNextSegmentProc: TYPE = GGModelTypes.SliceNextSegmentProc;

SliceNextPointProc: TYPE = GGModelTypes.SliceNextPointProc;

SliceNextPointPairProc: TYPE = GGModelTypes.SliceNextPointPairProc;

SliceClosestPointProc: TYPE = GGModelTypes.SliceClosestPointProc;

SliceClosestJointToHitDataProc: TYPE = GGModelTypes.SliceClosestJointToHitDataProc;

SliceClosestPointAndTangentProc: TYPE = GGModelTypes.SliceClosestPointAndTangentProc;

SliceClosestSegmentProc: TYPE = GGModelTypes.SliceClosestSegmentProc;

SliceLineIntersectionProc: TYPE = GGModelTypes.SliceLineIntersectionProc;

SliceCircleIntersectionProc: TYPE = GGModelTypes.SliceCircleIntersectionProc;

SliceHitDataAsSimpleCurveProc: TYPE = GGModelTypes.SliceHitDataAsSimpleCurveProc;

SliceSetDefaultsProc: TYPE = GGModelTypes.SliceSetDefaultsProc;

SliceSetStrokeWidthProc: TYPE = GGModelTypes.SliceSetStrokeWidthProc;

SliceGetStrokeWidthProc: TYPE = GGModelTypes.SliceGetStrokeWidthProc;

SliceSetStrokeEndProc: TYPE = GGModelTypes.SliceSetStrokeEndProc;

SliceGetStrokeEndProc: TYPE = GGModelTypes.SliceGetStrokeEndProc;

SliceSetStrokeJointProc: TYPE = GGModelTypes.SliceSetStrokeJointProc;

SliceGetStrokeJointProc: TYPE = GGModelTypes.SliceGetStrokeJointProc;

SliceSetStrokeColorProc: TYPE = GGModelTypes.SliceSetStrokeColorProc;

SliceGetStrokeColorProc: TYPE = GGModelTypes.SliceGetStrokeColorProc;

SliceSetFillColorProc: TYPE = GGModelTypes.SliceSetFillColorProc;

SliceGetFillColorProc: TYPE = GGModelTypes.SliceGetFillColorProc;

SliceSetArrowsProc: TYPE = GGModelTypes.SliceSetArrowsProc;

SliceGetArrowsProc: TYPE = GGModelTypes.SliceGetArrowsProc;

SliceSetDashedProc: TYPE = GGModelTypes.SliceSetDashedProc;

SliceGetDashedProc: TYPE = GGModelTypes.SliceGetDashedProc;

NotFound: SIGNAL;

FontNameError: SIGNAL;

Creation and Queries about Slice Classes

RegisterSliceClass: PROC [class: SliceClass];

FetchSliceClass: PROC [name: ATOM] RETURNS [class: SliceClass];

UpdateDescriptorBoundBoxes: PROC [sliceD: SliceDescriptor];

-- used to store bounding boxes in $Outline class sequences. Other classes are ignored.

Creation, Modification and Queries about Slices

SetDefaults: PROC [slice: Slice, parts: SliceParts, defaults: DefaultData];

CopySlice: PROC [slice: Slice] RETURNS [copy: Slice];

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

EntitiesInSlice: PROC [slice: Slice] RETURNS [entityGenerator: EntityGenerator];

DescriptorFromParts: PROC [slice: Slice, parts: SliceParts] RETURNS [sliceD: SliceDescriptor];

SegmentsInDescriptor: PROC [sliceD: SliceDescriptor] RETURNS [segGen: SegmentGenerator];

NextSegment: PROC [segGen: SegmentGenerator] RETURNS [next: Segment];

WalkSegments: PROC [slice: Slice, walkProc: WalkProc] RETURNS [sliceD: SliceDescriptor];

Calls the slice class walkSegments proc.

The walkProc is called with each segment in the slice. If walkProc returns TRUE, the part of the slice that corresponds to the segment will be in the SliceDescriptor returned by WalkSegments.

Text Slices

BuildTextSliceClass: PROC [] RETURNS [class: SliceClass];

MakeTextSlice: PROC [text: Rope.ROPE, color: Imager.Color ← Imager.black, amplifySpace: REAL ← 1.0, dropShadowsOn: BOOL ← FALSE, dropShadowOffset: Vector ← [0.0, 0.0], shadowColor: Imager.Color ← Imager.black] RETURNS [slice: Slice];

MakeTextSlice: PROC [text: Rope.ROPE, amplifySpace: REAL ← 1.0, dropShadowsOn: BOOL ← FALSE, dropShadowOffset: Vector ← [0.0, 0.0], shadowColor: Imager.Color ← Imager.black] RETURNS [slice: Slice];

MakeTextSlice MUST BE FOLLOWED BY A CALL TO SetTextFont !!

SetTextFont: PROC [slice: Slice, fontData: FontData, feedback: FeedbackData] RETURNS [ success: BOOL ← TRUE];

The text slice's font will be set using fontData. The translation component of the existing slice transform will be used. If fontData.transform=NIL, the scale component of the new transform is set to fontData.scale and the rotation component to 0.

SetTextFontAndTransform: PROC [slice: Slice, fontData: FontData, feedback: FeedbackData] RETURNS [ success: BOOL ← TRUE];

The text slice's font will be set using fontData. fontData.transform will be used.

GetFontData: PROC [slice: Slice] RETURNS [fontData: FontData];

GetFontDataRope: PROC [slice: Slice] RETURNS [Rope.ROPE];

GetFontLiteralDataRope: PROC [slice: Slice] RETURNS [Rope.ROPE];

UniformFonts: PROC [scene: Scene, selectClass: SelectionClass] RETURNS [font: ImagerFont.Font];

GetText: PROC [slice: Slice] RETURNS [text: Rope.ROPE];

AppendText: PROC [slice: Slice, text: Rope.ROPE];

BackspaceText: PROC [slice: Slice];

SetTextAmplifySpace: PROC [slice: Slice, amplifySpace: REAL, feedback: FeedbackData];

GetTextAmplifySpace: PROC [slice: Slice] RETURNS [amplifySpace: REAL];

SetTextColor: PROC [slice: Slice, color: Imager.Color, colorName: Rope.ROPE];

GetTextColor: PROC [slice: Slice] RETURNS [color: Imager.Color, colorName: Rope.ROPE];

DropShadowOn: PROC [slice: Slice, offset: Vector];

DropShadowOff: PROC [slice: Slice];

A fontName is a font designation with family, size, and face, like Helvetica23BI or TimesRoman6. A colorName is a name from the color naming system in the Cedar ColorTool.

may raise FontStringError

Box Slices

A box is a slice which maintains its rectilinear properties. It is possible to select/drag one of four corners, one of four edges, or the entire box. When a corner is dragged, box is rubberbanded to keep its box shape. When an edge is dragged, only the perpendicular component of the drag vector is used to move the edge, thus maintaining box shape. When the entire box is selected (traj or topLevel), it can be translated and rotated.

Corner: TYPE = {none, ll, ul, ur, lr}; -- lower left, upper left, upper right, lower right

Edge: TYPE = {none, left, right, top, bottom};

BuildBoxSliceClass: PROC [] RETURNS [class: SliceClass];

transform defaults to the identity.

MakeBoxSlice: PROC [box: BoundBox, corner: Corner, transform: ImagerTransformation.Transformation, strokeWidth: REAL ← 2.0, strokeEnd: StrokeEnd ← round] RETURNS [sliceD: SliceDescriptor];

MakeBoxSlice: PROC [box: BoundBox, corner: Corner, transform: ImagerTransformation.Transformation] RETURNS [sliceD: SliceDescriptor];

Circle Slices

BuildCircleSliceClass: PROC [] RETURNS [class: SliceClass];

MakeCircleSlice: PROC [origin: Point, outerPoint: Point, strokeWidth: REAL ← 2.0, strokeColor: Imager.Color ← Imager.black, fillColor: Imager.Color ← NIL] RETURNS [sliceD: SliceDescriptor];

MakeCircleSlice: PROC [origin: Point, outerPoint: Point] RETURNS [sliceD: SliceDescriptor];

Interpress Slices

BuildIPSliceClass: PROC [] RETURNS [class: SliceClass];

MakeIPSliceFromMaster: PROC [ipMaster: Interpress.Master, pixelsPerUnit: REAL ← 2834.646, fullName: Rope.ROPE ← NIL, feedback: FeedbackData, transform: ImagerTransformation.Transformation ← NIL, localBox: BoundBox ← NIL, includeByValue: BOOL] RETURNS [slice: Slice];

pixelsPerUnit explains what the unit was when the interpress master was made. The default value is for meters.

MakeIPSliceFromMaskPixel: PROC [pa: Imager.PixelArray, color: Color, feedback: FeedbackData, transform: ImagerTransformation.Transformation ← NIL] RETURNS [slice: Slice];

MakeIPSliceFromMaskBits: PROC [base: LONG POINTER, wordsPerLine: NAT,
sMin, fMin, sSize, fSize: NAT, tx, ty: INTEGER ← 0, color: Color, feedback: FeedbackData, transform: ImagerTransformation.Transformation ← NIL] RETURNS [slice: Slice];

SetIncludeByValue: PROC [slice: Slice, includeByValue: BOOL];

GetIncludeByValue: PROC [slice: Slice] RETURNS [includeByValue: BOOL];

NoOp Class Routines

In GGSliceImplC.NoOpBoundBox

NoOpBoundBox: SliceBoundBoxProc;

NoOpTightBox: SliceTightBoxProc;

NoOpCopy: SliceCopyProc;

Drawing

NoOpDrawParts: SliceDrawPartsProc;

NoOpDrawTransform: SliceDrawTransformProc;

NoOpDrawSelectionFeedback: SliceDrawSelectionFeedbackProc;

NoOpDrawAttractorFeedback: SliceDrawAttractorFeedbackProc;

Transforming

NoOpTransform: SliceTransformProc;

Textual Description

NoOpDescribe: SliceDescribeProc;

NoOpDescribeHit: SliceDescribeHitProc;

NoOpFileout: SliceFileoutProc;

NoOpFilein: SliceFileinProc;

Hit Testing

NoOpEmptyParts: SliceEmptyPartsProc;

NoOpNewParts: SliceNewPartsProc;

NoOpUnionParts: SliceUnionPartsProc;

NoOpDifferenceParts: SliceDifferencePartsProc;

NoOpMovingParts: SliceMovingPartsProc;

NoOpAugmentParts: SliceAugmentPartsProc;

NoOpSetSelectedFields: SliceSetSelectedFieldsProc;

NoOpPointsInDescriptor: SlicePointsInDescriptorProc;

NoOpPointPairsInDescriptor: SlicePointPairsInDescriptorProc;

NoOpSegmentsInDescriptor: SliceSegmentsInDescriptorProc;

NoOpWalkSegments: SliceWalkSegmentsProc;

NoOpNextPoint: SliceNextPointProc;

NoOpNextPointPair: SliceNextPointPairProc;

NoOpNextSegment: SliceNextSegmentProc;

NoOpClosestPoint: SliceClosestPointProc;

NoOpClosestJointToHitData: SliceClosestJointToHitDataProc;

NoOpClosestPointAndTangent: SliceClosestPointAndTangentProc;

NoOpClosestSegment: SliceClosestSegmentProc;

NoOpLineIntersection: SliceLineIntersectionProc;

NoOpCircleIntersection: SliceCircleIntersectionProc;

NoOpHitDataAsSimpleCurve: SliceHitDataAsSimpleCurveProc;

Style

NoOpSetDefaults: SliceSetDefaultsProc;

NoOpSetStrokeWidth: SliceSetStrokeWidthProc;

NoOpGetStrokeWidth: SliceGetStrokeWidthProc;

NoOpSetStrokeEnd: SliceSetStrokeEndProc;

NoOpGetStrokeEnd: SliceGetStrokeEndProc;

NoOpSetStrokeJoint: SliceSetStrokeJointProc;

NoOpGetStrokeJoint: SliceGetStrokeJointProc;

NoOpSetStrokeColor: SliceSetStrokeColorProc;

NoOpGetStrokeColor: SliceGetStrokeColorProc;

NoOpSetFillColor: SliceSetFillColorProc;

NoOpGetFillColor: SliceGetFillColorProc;

NoOpSetArrows: SliceSetArrowsProc;

NoOpGetArrows: SliceGetArrowsProc;

NoOpSetDashed: SliceSetDashedProc;

NoOpGetDashed: SliceGetDashedProc;

END.