NodeStyle.mesa
Copyright Ó 1985, 1986, 1988, 1991, 1992 by Xerox Corporation. All rights reserved.
Written by Bill Paxton, January 1981
Last changed by Bill Paxton, December 1, 1982 8:37 am
Plass, March 14, 1985 4:47:24 pm PST
Beach, March 23, 1985 5:16:53 pm PST
Michael Plass, May 20, 1985 8:01:47 pm PDT
Doug Wyatt, February 27, 1992 4:29 pm PST
DIRECTORY
Char USING [XCHAR],
ImagerFont USING [Font],
ImagerColor USING [Color],
Tioga USING [Looks];
NodeStyle: CEDAR DEFINITIONS ~ BEGIN
Style Record Definitions
Style: TYPE ~ REF StyleBody;
StyleBody: TYPE ~ PACKED RECORD [
kind: StyleKind ¬ screen,
fontFace: FontFace ¬ Regular,
fontAlphabets: FontAlphabets ¬ CapsAndLower,
strikeout: FontUnderlining ¬ None,
underlining: FontUnderlining ¬ None,
lineFormatting: LineFormatting ¬ FlushLeft,
lastLineFormatting: LineFormatting ¬ FlushLeft,
pathType: PathType ¬ Filled,
isComment: BOOL ¬ FALSE, -- set to node.comment; readonly for style rules
nestingLevel: NAT ¬ 0, -- node level in tree; readonly for style rules
fixedTabs: BOOL ¬ FALSE, -- true if stops at fixed locations. else relative to left margin
numTabStops: NAT ¬ 0, -- length of the tabStops list
defaultTabStops: TabStop ¬ NIL, -- if NIL, use 0.5 in flushLeft blank defaultTabStops
tabStops: LIST OF TabStop ¬ NIL, -- kept sorted by decreasing location (right to left on page)
this order substantially reduces allocations during the creation of the list since styles tend to define tab stops in increasing order, so can add to start of list and list additions must be non-destructive of the previous list. since length of list is given, can easily find the nth stop.
name: ARRAY NameParam OF ATOM ¬ ALL[NIL],
real: PACKED ARRAY RealParam OF RealCode ¬ ALL[0],
dataList: DataList ¬ NIL -- for special parameters
];
Ref: TYPE ~ Style; -- synonym for compatibility
StyleKind: TYPE ~ { screen, print, base };
MaxNestingLevel: NAT ~ NAT.LAST;
MaxTabStops: NAT ~ NAT.LAST;
NameParam: TYPE ~ {
style, -- name of the style, such as "TechnicalNote"
fontPrefix, -- prefix of interpress hierarchical name for font, e.g. Xerox/xc1-1-1/
fontFamily, -- name of the font family, such as "Helvetica"
textNamedColor, -- name of color for text
areaNamedColor, -- name of color for filled areas in graphics styles
outlineNamedColor, -- name of color for outlines in graphics styles
underlineNamedColor, -- name of color for underline
strikeoutNamedColor, -- name of color for strikeout
outlineBoxNamedColor, -- name of color for outline boxes
backgroundNamedColor, -- name of color for background
hyphenation -- kind of hyphenation applied to node
};
RealParam: TYPE ~ {
special variable used for extensions
freeVar,
miscellaneous font and positioning
fontSize, -- in points
letterspacing, -- distance added between each character
letterspacingStretch,
letterspacingShrink,
hshift, -- distance to offset text, positive to the right
vshift, -- distance to raise text above baseline (can be negative)
tabStops, -- tab spacing in points (for typewriter-style tab stops)
textRotation,
textHue, -- color for text
textSaturation,
textBrightness,
indent parameters
leftIndent, -- all lines indent this much on left
rightIndent, -- all lines indent this much on right
firstIndent, -- first line indent this much more on left
firstIndentRight, -- first line indent this much more on the right
restIndent, -- other lines indent this much more on left
runaroundLeft, -- depth of first indent on the left
runaroundRight, -- depth of first indent on the right
topIndent, -- top line at least this much down from top of viewer/page
bottomIndent, -- bottom baseline at least this up from bottom of page
leading parameters
minLineGap, -- min distance between line top and previous bottom (can be negative)
leading, -- distance between baselines
leadingStretch,
leadingShrink,
topLeading, -- min distance from first baseline to previous
topLeadingStretch,
topLeadingShrink,
bottomLeading, -- min distance from last baseline to next
bottomLeadingStretch,
bottomLeadingShrink,
graphics
areaHue, -- color for filled areas
areaSaturation,
areaBrightness,
outlineHue, -- color for outlines
outlineSaturation,
outlineBrightness,
lineWeight, -- width of graphics lines
page layout parameters
pageWidth,
pageLength,
leftMargin,
rightMargin,
topMargin,
bottomMargin,
headerMargin,
footerMargin,
bindingMargin,
lineLength,
columns, -- number of columns
pagebreak, -- glue added between pages (well sort of)
pagebreakStretch,
pagebreakShrink,
penalty parameters for page layout
pageBreakPenalty, -- penalty for breaking inside node
pageBreakAfterFirstLinePenalty, -- penalty for breaking node after its first line
pageBreakBeforeLastLinePenalty, -- penalty for breaking node before its last line
pageBreakBeforeFirstLinePenalty, -- penalty for breaking before first line of node
pageBreakAfterLastLinePenalty, -- penalty for breaking after last line of node
underline
underlineThickness, -- width of the rule drawn under characters
underlineDescent, -- positive offset to position bottom of underline below the baseline
underlineHue, -- color for underlines
underlineSaturation,
underlineBrightness,
strikeout
strikeoutThickness, -- width of the rule drawn through characters
strikeoutAscent, -- positive offset to position bottom of strikeout above the baseline
strikeoutHue, -- color for strikeouts
strikeoutSaturation,
strikeoutBrightness,
outlineBox
outlineBoxThickness, -- width of the rule drawn around text
outlineBoxBearoff, -- positive distance between the font box for text and the outline
outlineBoxHue, -- color for outlineBox
outlineBoxSaturation,
outlineBoxBrightness,
background
backgroundAscent, -- positive offset to position top of background above the baseline
backgroundDescent, -- positive offset to position bottom of background below the baseline
backgroundHue, -- color for backgrounds
backgroundSaturation,
backgroundBrightness,
other
hyphenCode, -- character code for hyphen
maxVerticalExpansion, -- insert extra fil if vertical expansion ratio would exceed this
maxHorizontalExpansion -- don't stretch spaces by more than this amount
};
RealCode: TYPE ~ [0..255] ¬ 0;
zero: RealCode ~ 0;
DataList: TYPE ~ REF DataEntry;
OfEntry: TYPE ~ { object, real, tab };
DataEntry: TYPE ~ RECORD [
next: DataList,
data: SELECT kind:OfEntry FROM
object => [
name: ATOM, -- name of the parameter
object: REF -- value of the parameter
],
real => [ -- for real values which overflow the table of common values
param: RealParam, -- which one it is
value: REAL ¬ 0.0, -- the value
valueI: INTEGER -- the value rounded to an integer
],
tab => [ -- for real values from tabspecs which overflow the table of common values
tabStop: TabStop, -- which tab stop it is
which: TabRealParam, -- which value for the tab stop it is
value: REAL ¬ 0.0, -- the value
valueI: INTEGER -- the value rounded to an integer
]
ENDCASE
];
TabRealParam: TYPE ~ { loc, spacing, weight, vshift };
TabStop: TYPE ~ REF TabStopRec;
LeaderTabStop: TYPE ~ REF leaders TabStopRec;
RuleTabStop: TYPE ~ REF rule TabStopRec;
RulesTabStop: TYPE ~ REF rules TabStopRec;
TabStopRec: TYPE ~ RECORD [
looks: Tioga.Looks, -- the default looks for the stop
loc: RealCode, -- the location of the stop
alignment: TabAlign ¬ FlushLeft, -- how the tab is aligned
alignmentChar: CHAR ¬ 0C, -- only of interest if alignment = Character
breakIfPast: BOOL ¬ FALSE, -- what to do if you are already beyond the tab stop
fill: SELECT fillKind:OfTabFill FROM
blank => [],
leaders => [
congruent: BOOL ¬ TRUE, -- otherwise, centered
char: CHAR ¬ 0C, -- the character to be repeated
spacing: RealCode -- the distance between repetitions
],
rule => [
weight: RealCode, -- the thickness of the rule
vshift: RealCode -- the distance up from the baseline to the bottom of the rule
],
rules => [
rules: TabArray -- array of records with weight and vshift for each rule
],
ENDCASE
];
TabAlign: TYPE ~ { FlushLeft, FlushRight, Centered, Character };
OfTabFill: TYPE ~ { blank, leaders, rule, rules };
TabArray: TYPE ~ REF TabArrayRec;
TabArrayRec: TYPE ~ RECORD[
array: SEQUENCE length: CARDINAL OF RECORD[weight, vshift: RealCode]
];
FontFace: TYPE ~ { Regular, Bold, Italic, BoldItalic };
FontAlphabets: TYPE ~ { CapsAndLower, CapsAndSmallCaps, LowerOnly, CapsOnly };
FontUnderlining: TYPE ~ { None, LettersAndDigits, Visible, All };
LineFormatting: TYPE ~ { FlushLeft, FlushRight, Justified, Centered };
PathType: TYPE ~ { Filled, Outlined, FilledAndOutlined };
PointsPerPica: REAL;
PointsPerInch: REAL;
PointsPerCentimeter: REAL;
PointsPerMillimeter: REAL;
PointsPerDidot: REAL;
PointsPerFil: REAL;
PointsPerFill: REAL;
PointsPerFilll: REAL;
Numeric style parameters
GetReal: PROC [ref: Style, param: RealParam] RETURNS [REAL];
GetInt: PROC [ref: Style, param: RealParam] RETURNS [INTEGER];
RealInit0: TYPE ~ REAL ¬ 0.0;
realArray: REF ARRAY RealCode OF RealInit0; -- array of distances
intArray: REF ARRAY RealCode OF INTEGER;
overflow: RealCode ~ LAST[RealCode];
realTableOverflow: ERROR;
IntegerValue: PROC [value: REAL ¬ 0.0] RETURNS [INTEGER];
safely rounds the real value to an integer
EnterReal: PROC [value: REAL ¬ 0.0] RETURNS [code: RealCode];
determine the code for this real value
SetReal: PROC [ref: Style, param: RealParam, value: REAL ¬ 0.0];
set the parameter to have this real value
Non-numeric style parameters
GetName: PROC [s: Style, param: NameParam] RETURNS [ATOM]
~ INLINE { RETURN [s.name[param]] };
SetName: PROC [s: Style, param: NameParam, value: ATOM]
~ INLINE { s.name[param] ¬ value };
GetFontFace: PROC [s: Style] RETURNS [FontFace]
~ INLINE { RETURN [s.fontFace] };
GetFontAlphabets: PROC [s: Style] RETURNS [FontAlphabets]
~ INLINE { RETURN [s.fontAlphabets] };
GetUnderlining: PROC [s: Style] RETURNS [FontUnderlining]
~ INLINE { RETURN [s.underlining] };
GetStrikeout: PROC [s: Style] RETURNS [FontUnderlining]
~ INLINE { RETURN [s.strikeout] };
GetLineFormatting: PROC [s: Style] RETURNS [LineFormatting]
~ INLINE { RETURN [s.lineFormatting] };
GetLastLineFormatting: PROC [s: Style] RETURNS [LineFormatting]
~ INLINE { RETURN [s.lastLineFormatting] };
GetHyphenChar: PROC [s: Style] RETURNS [Char.XCHAR]
~ INLINE { RETURN [VAL[MAX[GetInt[s, hyphenCode], 0]]] };
Tab stop info
GetTabLoc: PROC [stop: TabStop, s: Style] RETURNS [REAL];
GetTabLocI: PROC [stop: TabStop, s: Style] RETURNS [INTEGER];
GetTabLeaderSpacing: PROC [stop: LeaderTabStop, s: Style] RETURNS [REAL];
GetTabLeaderSpacingI: PROC [stop: LeaderTabStop, s: Style] RETURNS [INTEGER];
GetTabRuleWeight: PROC [stop: RuleTabStop, s: Style] RETURNS [REAL];
GetTabRuleWeightI: PROC [stop: RuleTabStop, s: Style] RETURNS [INTEGER];
GetTabRuleVShift: PROC [stop: RuleTabStop, s: Style] RETURNS [REAL];
GetTabRuleVShiftI: PROC [stop: RuleTabStop, s: Style] RETURNS [INTEGER];
GetTabRealCode: PROC [ref: Style, stop: TabStop, which: TabRealParam,
value: REAL ¬ 0.0] RETURNS [code: RealCode];
GetRulesTabCount: PROC [stop: RulesTabStop] RETURNS [count: INTEGER]; -- number of rules
GetRulesTabInfo: PROC [stop: RulesTabStop, num: INTEGER]
RETURNS [weight, vshift: REAL];
For num in [0..RulesTabCount), returns the weight and vshift values for that rule.
GetRulesTabInfoI: PROC [stop: RulesTabStop, num: INTEGER]
RETURNS [weight, vshift: INTEGER];
Font info
GetFont: PROC [style: Style] RETURNS [ImagerFont.Font];
Gets the font for the given style.
GetSpaceWidth: PROC [style: Style] RETURNS [REAL];
Returns the width of a space in the font for the given style.
Color info
ColorParam: TYPE ~ {text, underline, strikeout, outlineBox, background, area, outline};
GetColor: PROC [style: Style, param: ColorParam] RETURNS [ImagerColor.Color];
Looks for -NamedColor first, then tries -Hue, -Saturation, -Brightness.
DataList construction
ConsDataListObject: PROC [name: ATOM, object: REF, dataList: DataList] RETURNS [DataList];
END.