DIRECTORY
AMEvents USING [Debugging, Debugged],
CIFS USING [Error],
CedarSnapshot USING [CheckpointProc, Register, RollbackProc],
Convert USING [Value, ValueToRope],
IO USING [GetCard, EndOfStream, Close, CR, CreateFilterCommentsStream, GetChar, GetIndex, int, PeekChar, PutF, RIS, rope, STREAM, time, TAB, SP, GetToken, SkipOver, TokenProc, BreakProc, WhiteSpace],
IOExtras USING [GetLine],
IconRegistry USING [Failure],
Icons USING [NewIconFromFile, IconFlavor],
FileIO USING [Open, OpenFailed],
MessageWindow USING [Append, Blink],
PageFault USING [AddressFault],
Process USING [Detach],
Rope USING [Cat, Equal, IsEmpty, ROPE],
UserProfile USING [CallWhenProfileChanges, ProfileChangedProc, Token],
ViewerClasses USING [Viewer],
ViewerEvents USING [EventProc, RegisterEventProc],
ViewerOps USING [FindViewer, RestoreViewer]
;


IconRegistryImpl: CEDAR MONITOR

IMPORTS AMEvents, CedarSnapshot, CIFS, Convert, FileIO, IO, IOExtras, MessageWindow, PageFault, Process, Rope, Icons, UserProfile, ViewerEvents, ViewerOps  

EXPORTS IconRegistry 

= BEGIN 
IconList: TYPE = LIST OF IconEntry;
IconEntry: TYPE = REF IconRecord;
IconRecord: TYPE = RECORD[
iconName: Rope.ROPE _ NIL,
fileName: Rope.ROPE _ NIL,
index: CARDINAL _ LAST[CARDINAL],
flavor: Icons.IconFlavor _ unInit,
position: INT _ -1  -- in catalogue
];
Failed: PUBLIC ERROR [why: IconRegistry.Failure, reason: Rope.ROPE] = CODE;

RegisterIcon: PUBLIC ENTRY PROC [iconName: Rope.ROPE, fileName: Rope.ROPE, index: CARDINAL, saveInCatalogue: BOOL _ FALSE] = {  
ENABLE UNWIND => NULL;
entry: IconEntry;
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF Rope.Equal[l.first.iconName, iconName, FALSE] THEN {
IF Rope.Equal[l.first.fileName, fileName, FALSE] THEN {
IF l.first.index = index OR NOT saveInCatalogue THEN RETURN[];  -- need way to specify whether or not this definition is to redefine. currently overloading on saveInCatalogue. Idea is that program can register and if user has already registered, then user's takes precedence 
entry _ l.first;
EXIT;
};
LOOP;
};
REPEAT
FINISHED => TRUSTED {
entry _ NEW[IconRecord _ []];
iconList _ CONS[entry, iconList];
};
ENDLOOP;
entry^ _ [iconName: iconName, fileName: fileName, index: index, flavor: unInit, position: -1];  
IF saveInCatalogue THEN WriteEntry[entry];
}; 

GetIcon: PUBLIC ENTRY PROC [iconName: Rope.ROPE, default: Icons.IconFlavor _ unInit] RETURNS [Icons.IconFlavor] = {
ENABLE UNWIND => NULL;
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF Rope.Equal[l.first.iconName, iconName, FALSE] THEN {
IF l.first.flavor = unInit THEN l.first.flavor _ Icons.NewIconFromFile[l.first.fileName, l.first.index !
CIFS.Error =>
IF code # noSuchFile THEN REJECT
ELSE IF default # unInit THEN GOTO Default
ELSE ERROR Failed[fileNotFound, l.first.fileName];
PageFault.AddressFault =>
IF default # unInit THEN GOTO Default
ELSE ERROR Failed[invalidIndex, Convert.ValueToRope[[signed[l.first.index]]]];
]; -- NewIconFromFile raises this if given badindex.
RETURN[l.first.flavor];
};
ENDLOOP;
IF default # unInit THEN GOTO Default;
ERROR Failed[noSuchIcon, iconName];
EXITS
Default => RETURN[default];
};

IsRegistered: PUBLIC ENTRY PROC[iconName: Rope.ROPE _ NIL, fileName: Rope.ROPE _ NIL, index: CARDINAL _ LAST[CARDINAL]] RETURNS[name: Rope.ROPE, file: Rope.ROPE, i: CARDINAL] = {
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF
(IF iconName # NIL THEN Rope.Equal[l.first.iconName, iconName, FALSE]
ELSE Rope.Equal[l.first.fileName, fileName, FALSE] AND l.first.index = index) THEN RETURN[l.first.iconName, l.first.fileName, l.first.index];
ENDLOOP;
RETURN[NIL, NIL, 0]; 
};

Lookup: PROC[iconName: Rope.ROPE] RETURNS[IconEntry] = {
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF Rope.Equal[l.first.iconName, iconName, FALSE] THEN RETURN[l.first];
ENDLOOP;
RETURN[NIL];
};

InvalidateCache: PUBLIC PROC [iconName: Rope.ROPE _ NIL] = {
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF iconName = NIL OR Rope.Equal[l.first.iconName, iconName, FALSE] THEN l.first.flavor _ unInit;
ENDLOOP;
};
iconList: IconList _ NIL;
catalogueName: Rope.ROPE _ "RegisteredIcons.Catalogue";

ParseCatalogue: ENTRY PROCEDURE  = {
stream: IO.STREAM;
stream _ IO.CreateFilterCommentsStream[FileIO.Open[fileName: catalogueName,
accessOptions: read, createOptions: oldOnly ! FileIO.OpenFailed => CONTINUE]];  -- change interface not to explain that it doesn't raise an error if no catalogue.
IF stream # NIL THEN {
ReadIcons[stream];
stream.Close[];
};
IF errorLog  # NIL THEN {
MessageWindow.Append["problems encountered, see IconRegistry.log."];
MessageWindow.Blink[];
errorLog.Close[];
errorLog _ NIL;
};
};

ReadIcons:  PROCEDURE [stream: IO.STREAM]  = {
OPEN IO;
ris: IO.STREAM;
{
ENABLE { 
Failed => REJECT;
IO.EndOfStream => GOTO Out;
};
DO
tokenProc: IO.BreakProc = {
RETURN[SELECT char FROM
IO.SP, IO.TAB, ', => sepr,
IO.CR => break,
ENDCASE => other
];
};
whiteSpace: IO.BreakProc = {
RETURN[IF char = CR THEN break ELSE IO.WhiteSpace[char]]
};
isACR: IO.BreakProc = {
RETURN[IF char = CR THEN break ELSE other]
};
entry: IconEntry;
iconName, fileName: Rope.ROPE;
index: CARDINAL;
position: INT;
IO.SkipOver[stream, IO.WhiteSpace];
position _ stream.GetIndex[];
iconName _ IO.GetToken[stream];
IO.SkipOver[stream, whiteSpace];  -- skips over spaces, tabs, but stops at CR
IF stream.PeekChar[] # ': THEN {
IO.SkipOver[stream, isACR];
Report1[msg: Rope.Cat["missing : at [", Convert.ValueToRope[[signed[position]]], "]"]];
LOOP;
};
[] _ stream.GetChar[];  -- the :
ris _ IO.RIS[IOExtras.GetLine[stream], ris];  -- read to CR, make this a stream. Reason is to bound the scope of the GetToken, GetCards below.
fileName _ IO.GetToken[ris, tokenProc];
IF Rope.IsEmpty[fileName] THEN {
Report1[msg: Rope.Cat["missing fileName at [", Convert.ValueToRope[[signed[position]]], "]"]];
LOOP;
};
index _ IO.GetCard[ris];
entry _ Lookup[iconName];
IF entry # NIL THEN {
entry.position _ position; -- comments may have changed.
IF NOT (Rope.Equal[entry.fileName, fileName, FALSE] AND index = entry.index) THEN {
entry.fileName _ fileName;
entry.index _ index;
entry.flavor _ unInit;
};
}  
ELSE iconList _ CONS[NEW[IconRecord _ [iconName: iconName, fileName: fileName, index: index, position: position]], iconList];
ENDLOOP;
EXITS
Out => NULL;
};
};

WriteEntry: INTERNAL PROC [entry: IconEntry] = {
OPEN IO;
viewer: ViewerClasses.Viewer;
stream: STREAM = FileIO.Open[fileName: catalogueName,
accessOptions: append, createOptions: oldOnly];
WriteOne[entry, stream];
stream.Close[];
IF (viewer _ ViewerOps.FindViewer[catalogueName]) # NIL THEN ViewerOps.RestoreViewer[viewer];
};

WriteOne: INTERNAL PROC [entry: IconEntry, stream: IO.STREAM] = {
OPEN IO;
entry.position _ stream.GetIndex[];
stream.PutF["\n%g: %g %d", rope[entry.iconName], rope[entry.fileName], int[entry.index]];
};

WriteCatalogue: PUBLIC ENTRY PROC [] = {
OPEN IO;
viewer: ViewerClasses.Viewer;
stream: STREAM;
lst: IconList;
FOR l: IconList _ iconList, l.rest UNTIL l = NIL DO
IF l.first.position = -1 THEN lst _ CONS[l.first, lst];  -- need to write them out in reverse order seen on lst, i.e. first one seen gets written out last
ENDLOOP;
IF lst = NIL THEN RETURN;
FOR l: IconList _ lst, l.rest UNTIL l = NIL DO
WriteOne[l.first, stream];
ENDLOOP;
stream _ FileIO.Open[fileName: catalogueName,
accessOptions: append, createOptions: oldOnly];
stream.Close[];
IF (viewer _ ViewerOps.FindViewer[catalogueName]) # NIL THEN ViewerOps.RestoreViewer[viewer];
};

Report1: PROCEDURE [entry: IconEntry _ NIL, msg: Rope.ROPE] = {
OPEN IO;
ENABLE {
UNWIND, AMEvents.Debugging, AMEvents.Debugged => NULL;
ANY => CONTINUE;
};
IF errorLog = NIL THEN {
errorLog _ FileIO.Open[fileName: "IconRegistry.log", accessOptions: append];
errorLog.PutF["Processing catalogue/profile at %t", time[]];
};
errorLog.PutF["\n\n%g", rope[msg]]; 
IF entry # NIL THEN errorLog.PutF[", at %g [%d]", rope[entry.iconName], int[entry.position]]; 
};


errorLog: IO.STREAM _ NIL;
NoticeChanges: CedarSnapshot.RollbackProc = {ParseCatalogue[]};

WasCatalogueEdited: ViewerEvents.EventProc -- [viewer: ViewerClasses.Viewer, event: ViewerEvent] --  =  {
IF Rope.Equal[viewer.name, catalogueName, FALSE] THEN
TRUSTED {Process.Detach[FORK ParseCatalogue[]]};
};

IconsFromProfile: UserProfile.ProfileChangedProc = {
r: Rope.ROPE _ UserProfile.Token["RegisteredIcons"];
IF r # NIL THEN ReadIcons[IO.RIS[r]]; 
IF errorLog  # NIL THEN {
MessageWindow.Append["problems encountered, see IconRegistry.log."];
MessageWindow.Blink[];
errorLog.Close[];
errorLog _ NIL;
};
};

[] _ ViewerEvents.RegisterEventProc[proc: WasCatalogueEdited, event: save, before: FALSE];
ParseCatalogue[];
UserProfile.CallWhenProfileChanges[IconsFromProfile];
TRUSTED
{CedarSnapshot.Register[c: NIL, r: NoticeChanges];
};



END.

	ΪIconRegistryImpl.mesa;
Edited by Teitelman on May 10, 1983 12:41 pm
Types
Accessing Icon Registry
Changes RegisteredIcons.Catalogue to reflect the indicated association. This definition will replace any previous definition. comments are for inclusion in the catalogue to help the user figure out what the icon looks like. 
IF iconList = NIL AND saveInCatalogue THEN Initialize[];  -- first time. The saveInCatalogue check is so that if a program registers an icon, and the user has redefined it in his catalogue or profile, then his will take precedence.
Obtain an icon flavor for the icon associated with iconName. Create a new icon flavor if one has not previously been created.
If for some reason it could not obtain the icon, and default # unInit, returns the default. Otherwise, raises Error (defined below) with appropriate parameters.
IF iconList = NIL THEN Parse[! Failed => IF default # unInit THEN GOTO Default];  -- first time
for use by iconeditor, so that it can force creation of a new flavor when an icon that has been registered was edited, obtain name of icon when selected, etc. Can be called with either iconName, or fileName and index.
IF iconList = NIL THEN Parse[! Failed => GOTO Out];  -- first time
for use by iconeditor, so that it can force creation of a new flavor when an icon that has been registered was edited.
If an iconFlavor was previous created for this icon, discard the flavor, i.e. the next call to GetIcon will create a new flavor. If iconName = NIL, do this for all registered icons. For use by iconeditor. 
Parsing Icon Catalogue
-- see if key is followed by a :
entry.endPosition _ endPosition; 
Reporting errors
Noticing changes 
Initialization
Edited on May 10, 1983 12:41 pm, by Teitelman
added facility to get icons from userprofile, and to enable icons registered by programs not to take precedence over those in the user's profile/catalogue, even if registered later, e.g. by a program that is loaded later.
does not raise error if no regsiteredicoons.catalogue.
deimplemented multiple registration idea. To get same effect, call GetIcon[name, GetIcon[otherName]];
changes to: RegisterIcon (do not parse on first call if saveInCatalogue is FALSE so that if program registers an icon, and there is also one specified by the user, his will take precedence)., GetIcon, IsRegistered, ParseCatalogue, ReadIcons, WriteEntry, Report1, NoticeChanges, WasCatalogueEdited, IconsFromProfile, UserProfile, TRUSTED, DIRECTORY, IMPORTS, UserProfile, RegisterIcon, RegisterIcon





ΚΤ–

"Cedar" style˜J˜Jš
Οc™Jšœ™,J˜š
Οk	˜	Jšœ	žœ˜%Jšžœ
žœ	˜Jšœžœ*˜=Jšœžœ˜#Jšžœ
žœžœEžœžœžœžœ8˜Η
Jšœ	žœ˜Jšœ
žœ˜Jšœžœ˜*Jšœžœ˜ Jšœžœ˜$Jšœ
žœ˜Jšœžœ
˜Jšœžœžœ˜'Jšœžœ5˜FJšœžœ
˜Jšœ
žœ ˜2Jšœ
žœ˜+J˜
J˜—J˜JšΠblœžœ
ž˜J˜Jšžœ1žœb˜œ
J˜Jšžœ˜J˜Jšœ
žœ
˜
headš
œ™JšΟnœžœ
žœ˜#Jš 	œžœžœ˜!š 
œžœžœ
˜Jšœžœžœ
˜Jšœžœžœ
˜Jšœžœžœ
žœ˜!Jš
œ"˜"Jšœ
žœ˜#Jš
œ˜—Jš
 œžœ
žœ*žœžœ
˜KJ˜—™š œžœ
žœ
žœžœžœ	žœžœžœ˜€
J™ΰ
Jš
ž˜J˜Jšžœžœžœ­
™η
šžœ žœžœ
ž˜3šžœ(žœžœ˜7šžœ(žœž˜7Jš
žœžœ
žœžœ
žœΠbcΟ

˜“J˜Jšžœ
˜J˜—Jš
ž˜Jš
ž˜—Jš
ž˜šžœžœ˜Jšœžœ˜Jšœžœ˜!J˜—Jš
ž˜—Jšœ_
˜`Jšžœžœ˜*J˜—J˜š œžœžœ$žœ˜sJš
}™}J™ 
Jš
ž˜Jš
žœžœ
žœžœžœ
žœ
™_šžœ žœžœ
ž˜3šžœ(žœžœ˜7šžœžœI˜hšžœ	˜
Jšžœžœ
ž˜ Jšžœ
žœžœ
žœ˜*Jšžœ
žœ(˜2—š
œ˜Jšžœžœ
žœ˜%Jšžœ
žœD˜N—Jšœ1˜4—Jšžœ˜J˜—Jš
ž˜—Jšžœžœ
žœ	˜&Jšžœ˜#š
ž˜Jšœžœ
˜—J˜J˜—š œžœ
žœ
žœžœžœžœžœ	žœžœ
žœžœžœ
žœžœ˜²
J™Ω
Jš	žœžœ
žœžœ
™Bšžœ žœžœ
ž˜3š
ž˜Jš	œ
žœžœ
žœ(žœ
˜EJš
žœ(žœžœžœ
žœ4˜
—Jš
ž˜—Jšžœ
žœ˜Jš
ž˜J˜—š œžœžœžœ˜8J™všžœ žœžœ
ž˜3Jšžœ(žœžœ
žœ
˜FJš
ž˜—Jšžœ
žœ˜Jš
œ˜J˜—š œžœž
œ˜<J™Ν
šžœ žœžœ
ž˜3Jš
žœžœ
žœ(žœžœ˜`Jš
ž˜—J˜——™Jš œ
žœ
˜Iprocš 
œž	œ˜7L˜š œžœ˜$Jšœžœ
žœ
˜šœ	žœ@˜KJšœCžœ‘N
˜’
—šžœ
žœ
žœ˜J˜Jš
œ˜J˜—šžœ
žœ
ž˜Jš
œD˜DJš
œ˜Jš
œ˜Jšœžœ
˜J˜—Jš
œ˜J˜—š 	œžœ˜.Jš
ž˜Jšœžœ
žœ
˜š
ž
˜
šžœ
˜	Jšœ
žœ
˜Jšžœžœ˜J˜—š
ž˜š 	œ˜šžœ
žœž˜Jšžœžœ
˜Jšžœ
˜Jšžœ	˜J˜—Jš
œ˜—š 
œ˜Jš
žœ
žœžœ
žœžœ˜8J˜—š œ˜Jš
žœ
žœžœ
žœžœ˜*J˜—J˜Jšœžœ
˜Jšœžœ
˜Jšœ
žœ
˜Jš
œ#˜#Jš
œ˜Jš
œ˜Jš
œ ™ Jšœ"+˜Mšžœž˜ Jš
œ˜Jš
œW˜WJšžœ
˜Jš
œ˜—Jšœ˜ Jšœžœ
žœ"`˜Ž
Jšœžœ˜'šžœžœ˜ Jš
œ^˜^Jšžœ
˜J˜—Jšœžœ˜J˜šžœ	žœ
ž˜Jšœ˜8Jš
œ!™!š
žœ
žœ'žœžœžœ˜SJ˜J˜Jš
œ˜Jš
œ˜—Jš
œ˜—Jšžœžœ
žœe˜}Jš
ž˜—š
ž˜Jšœžœ
˜—J˜—Jš
œ˜J˜—š 
œžœ
žœ˜0Jšžœ
žœ
˜J˜šœžœ'˜5Jš
œ/˜/—Jš
œ˜J˜Jšžœ2žœ
žœ!˜]J˜—J˜š
 œžœ
žœžœ
žœ˜AJšžœ
žœ
˜J˜#Jš
œY˜YJ˜—J˜š œžœ
ž
œ˜(Jšžœ
žœ
˜J˜Jšœžœ
˜Jš
œ˜šžœ žœžœ
ž˜3Jšžœžœžœa˜š
Jš
ž˜—Jšžœžœ
žœ
žœ
˜šžœžœžœ
ž˜.Jšœž
˜Jš
ž˜—š
œ-˜-Jš
œ/˜/—J˜Jšžœ2žœ
žœ!˜]J˜——™J˜š œž	œžœžœ˜?Jš
ž˜š
ž˜Jšžœ'ž	˜6Jš
ž˜J˜—šžœžœ
ž˜Jš
œL˜LJ˜<J˜—Jš
œ$˜$Jšžœ	žœ
žœK˜^Jš
œ˜—J˜J˜Jš œžœ
žœžœ
˜—š
œ™Jš 
œ2˜?J˜š œ8œ˜išžœ(žœž˜5Jšžœžœ˜0—J˜J˜—š œ$˜4Jšœžœ(˜4Jš
žœžœ
žœžœ
žœ˜&šžœ
žœ
ž˜Jš
œD˜DJš
œ˜Jš
œ˜Jšœžœ
˜J˜—J˜J˜——š
œ™JšœSžœ˜ZJš
œ˜Jš
œ5˜5š
ž˜Jšœžœ˜2J˜—J˜J˜J˜—Jšžœ
˜J˜š
-™-Jš
ϊ™ϊJšœΟrœ¦
’Ο
™—J™J™J™J™J™—…—",7Ϊ