VoiceMarkersImpl.mesa
module to handle markers in voice, of two types
i) a special character which the user can place at a selection and remove using button-pushes
ii) annotation of voice with text [if I get round to it]
Ades, May 1, 1986 10:39:24 am PDT
Swinehart, March 23, 1987 2:46:04 pm PST
DIRECTORY
Convert USING [RopeFromInt, IntFromRope],
ImagerFont USING [Find, Font, Escapement],
Menus USING [MenuProc],
MessageWindow USING [Append, Blink],
Real USING [Fix],
Rope USING [ROPE, Length, Substr, Concat, Fetch, Cat, Find],
SoundList USING [SoundChars],
TextEdit USING [PutCharProp],
TextNode USING [Ref],
TiogaButtons USING [TextNodeRef],
TiogaOps USING [GetSelection, FirstChild, ViewerDoc, CallWithLocks],
TiogaOpsDefs USING [Location, Ref],
ViewerClasses USING [Viewer],
ViewerOps USING [FetchProp, PaintViewer],
VoicePlayBack USING [RedrawViewer],
VoiceViewers USING [VoiceViewerInfo, GetVoiceLock, SetVoiceViewerEditStatus, TextMarkEntry, TextMarkRec, SoundInterval, soundRopeCharLength],
VoiceMarkers;
VoiceMarkersImpl: CEDAR PROGRAM IMPORTS Convert, ImagerFont, MessageWindow, Real, Rope, SoundList, TextEdit, TiogaButtons, TiogaOps, ViewerOps, VoicePlayBack, VoiceViewers, VoiceMarkers EXPORTS VoiceMarkers = BEGIN
at present, when selections are used to delete/add markers, selections do not change - fix!
[char marks manually before calling VoicePlayback.Redraw, text marks manually]
---- routines to do with character markers: these are transitory and do not form part of the contents of the viewer
AddCharMark: PUBLIC Menus.MenuProc = {
adds marks to the selected voice viewer at each end of the selection if pending delete, otherwise at the position of the caret
viewer: ViewerClasses.Viewer;
start, end: TiogaOpsDefs.Location;
pendingDelete, caretBefore: BOOLEAN;
viewerInfo: VoiceViewers.VoiceViewerInfo;
[viewer: viewer, start: start, end: end, pendingDelete: pendingDelete, caretBefore: caretBefore] ←
TiogaOps.GetSelection[];
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF viewerInfo = NIL
THEN
{ MessageWindow.Append["Make a selection in a voice viewer first",
TRUE];
MessageWindow.Blink[];
RETURN
};
IF VoiceViewers.GetVoiceLock[viewerInfo] THEN
{
IF ~ (start.node = end.node AND start.node = TiogaOps.FirstChild[TiogaOps.ViewerDoc[viewer]]) THEN ERROR;
IF pendingDelete OR caretBefore THEN MarkChar[viewerInfo, start.where];
IF pendingDelete OR ~caretBefore THEN MarkChar[viewerInfo, end.where];
{ trueContents: Rope.
ROPE ← SoundList.SoundChars[viewerInfo].soundRope;
[] ← VoicePlayBack.RedrawViewer[viewer, trueContents, 0, 0, 0, viewerInfo.remnant, FALSE, unAltered];
VoiceViewers.SetVoiceViewerEditStatus[viewer];
viewerInfo.editInProgress ← FALSE
}
}
};
MarkChar:
PROC [viewerInfo: VoiceViewers.VoiceViewerInfo, position:
INT] = {
restOfList: LIST OF INT;
IF viewerInfo.charMarkList = NIL THEN viewerInfo.charMarkList ← CONS [position, NIL]
ELSE
{
IF viewerInfo.charMarkList.first >= position
THEN
{ IF viewerInfo.charMarkList.first > position THEN viewerInfo.charMarkList ← CONS [position, viewerInfo.charMarkList] }
ELSE
{
FOR restOfList ← viewerInfo.charMarkList, restOfList.rest
WHILE restOfList.rest #
NIL
DO
IF restOfList.rest.first >= position
THEN
{
IF restOfList.rest.first > position THEN restOfList.rest ← CONS [position, restOfList.rest];
RETURN
}
ENDLOOP;
restOfList.rest ← CONS [position, NIL]
}
}
LockedAddCharMark: PUBLIC PROC [viewer: ViewerClasses.Viewer, position: INT] = {
called when a viewer is known to be a voice viewer with at least position+1 characters in it: the caller should aready hold the VoiceLock
viewerInfo: VoiceViewers.VoiceViewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF viewerInfo = NIL THEN ERROR;
MarkChar[viewerInfo, position];
{ trueContents: Rope.
ROPE ← SoundList.SoundChars[viewerInfo].soundRope;
[] ← VoicePlayBack.RedrawViewer[viewer, trueContents, 0, 0, 0, viewerInfo.remnant, FALSE, unAltered];
VoiceViewers.SetVoiceViewerEditStatus[viewer];
}
};
DeleteCharMarks:
PUBLIC Menus.MenuProc = {
viewer: ViewerClasses.Viewer;
start, end: TiogaOpsDefs.Location;
viewerInfo: VoiceViewers.VoiceViewerInfo;
RemoveMarkChars:
PROC [from, to:
INT] = {
WHILE viewerInfo.charMarkList # NIL AND viewerInfo.charMarkList.first IN [from..to] DO viewerInfo.charMarkList ← viewerInfo.charMarkList.rest ENDLOOP;
IF viewerInfo.charMarkList # NIL THEN FOR l: LIST OF INT ← viewerInfo.charMarkList, l.rest WHILE l # NIL AND l.rest # NIL DO IF l.rest.first IN [from..to] THEN l.rest ← l.rest.rest ENDLOOP -- the dual WHILE condition is because we can delete the next entry and it could be the last
};
IF mouseButton = blue THEN -- right click means delete all marks in the viewer
{ viewer ←
NARROW[parent, ViewerClasses.Viewer];
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF VoiceViewers.GetVoiceLock[viewerInfo] THEN
{ viewerInfo.charMarkList ←
NIL;
{ trueContents: Rope.
ROPE ← SoundList.SoundChars[viewerInfo].soundRope;
[] ← VoicePlayBack.RedrawViewer[viewer, trueContents, 0, 0, 0, viewerInfo.remnant, FALSE, unAltered];
VoiceViewers.SetVoiceViewerEditStatus[viewer];
viewerInfo.editInProgress ← FALSE
}
}
}
ELSE -- both other clicks mean delete all marks from selection
{ [viewer: viewer, start: start, end: end] ← TiogaOps.GetSelection[];
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF viewerInfo = NIL
THEN
{ MessageWindow.Append["Make a selection in a voice viewer first",
TRUE];
MessageWindow.Blink[];
RETURN
};
IF VoiceViewers.GetVoiceLock[viewerInfo] THEN
{
IF ~ (start.node = end.node AND start.node = TiogaOps.FirstChild[TiogaOps.ViewerDoc[viewer]]) THEN ERROR;
RemoveMarkChars[start.where, end.where];
{ trueContents: Rope.
ROPE ← SoundList.SoundChars[viewerInfo].soundRope;
[] ← VoicePlayBack.RedrawViewer[viewer, trueContents, 0, 0, 0, viewerInfo.remnant, FALSE, unAltered];
VoiceViewers.SetVoiceViewerEditStatus[viewer];
viewerInfo.editInProgress ← FALSE
}
}
}
};
DisplayCharMarks:
PUBLIC
PROC [unMarkedRope: Rope.
ROPE, charMarkList:
LIST
OF
INT, skipChars:
INT]
RETURNS [markedRope: Rope.
ROPE] = {
this gets called by SoundList.SoundChars, which has been called to build the viewer contents corresponding to some soundlist, the first skipChars omitted: takes that rope and replaces normal characters with marker characters as appropriate
endChar: INT ← unMarkedRope.Length - 1;
lastMark: INT ← -1;
nextMark: INT;
markedRope ← NIL;
WHILE charMarkList # NIL AND charMarkList.first < skipChars DO charMarkList ← charMarkList.rest ENDLOOP;
DO
nextMark ← IF charMarkList = NIL THEN endChar + 1 ELSE charMarkList.first - skipChars;
markedRope ← markedRope.Concat[unMarkedRope.Substr[lastMark+1, nextMark-lastMark-1]];
IF nextMark = endChar + 1 THEN RETURN;
markedRope ← markedRope.Concat["@"]; -- the marker character
lastMark ← nextMark;
charMarkList ← charMarkList.rest
ENDLOOP
ExtractCharMarks: PUBLIC PROC [viewerInfo: VoiceViewers.VoiceViewerInfo, soundInterval: VoiceViewers.SoundInterval] = {
return as selection.charMarkList a copy [n.b.] of the section of the character mark list in viewerInfo falling in to the region of selection.ropeInterval
currLastInList: LIST OF INT;
soughtStart: INT ← soundInterval.ropeInterval.start/VoiceViewers.soundRopeCharLength;
soughtEnd: INT ← (soundInterval.ropeInterval.start + soundInterval.ropeInterval.length)/VoiceViewers.soundRopeCharLength;
soundInterval.charMarkList ← NIL; -- should be already so, but . . .
FOR l:
LIST
OF
INT ← viewerInfo.charMarkList, l.rest
WHILE l #
NIL
AND l.first < soughtEnd
DO
IF l.first >= soughtStart THEN
{
IF soundInterval.charMarkList =
NIL
THEN
{ soundInterval.charMarkList ←
CONS [l.first - soughtStart,
NIL];
currLastInList ← soundInterval.charMarkList;
}
ELSE
{ currLastInList.rest ←
CONS [l.first - soughtStart,
NIL];
currLastInList ← currLastInList.rest
}
}
ENDLOOP
EditCharMarks:
PUBLIC
PROC [viewerInfo: VoiceViewers.VoiceViewerInfo, unchangedHead, deleteChars, insertChars:
INT, soundInterval: VoiceViewers.SoundInterval] = {
this gets called when an edit is made to the contents of the viewer: it keeps the charMarkList in step with the edit
it is not a very efficient implementation - better ones are an exercise for the reader
atHead: BOOLEAN ← TRUE;
l: LIST OF INT;
WHILE atHead
AND viewerInfo.charMarkList #
NIL
DO
SELECT viewerInfo.charMarkList.first
FROM
>= unchangedHead+deleteChars => {viewerInfo.charMarkList.first ← viewerInfo.charMarkList.first + insertChars - deleteChars; atHead ← FALSE};
>= unchangedHead => viewerInfo.charMarkList ← viewerInfo.charMarkList.rest;
ENDCASE => atHead ← FALSE;
ENDLOOP;
IF viewerInfo.charMarkList # NIL THEN
{ l ← viewerInfo.charMarkList;
WHILE l #
NIL
AND l.rest #
NIL
DO
--the dual WHILE condition is because we can delete the next entry and it could be the last
SELECT l.rest.first
FROM
>= unchangedHead+deleteChars =>
{l.rest.first ← l.rest.first + insertChars - deleteChars;
l ← l.rest};
>= unchangedHead => l.rest ← l.rest.rest;
ENDCASE => l ← l.rest
ENDLOOP
};
IF soundInterval # NIL AND soundInterval.charMarkList # NIL
THEN -- now put the character marks from the soundInterval into the list at the appropriate point
{
beforeInsert, afterInsert: LIST OF INT ← NIL;
newSection, endNewSection: LIST OF INT;
IF viewerInfo.charMarkList # NIL THEN
{
IF viewerInfo.charMarkList.first >= unchangedHead
THEN afterInsert ← viewerInfo.charMarkList
ELSE
{ l ← viewerInfo.charMarkList;
WHILE l.rest # NIL AND l.rest.first < unchangedHead DO l ← l.rest ENDLOOP;
beforeInsert ← l; afterInsert ← l.rest
}
};
{ insertMarks:
LIST
OF
INT ← soundInterval.charMarkList.rest;
newSection ← CONS [soundInterval.charMarkList.first + unchangedHead, NIL];
endNewSection ← newSection;
WHILE insertMarks #
NIL
DO
endNewSection.rest ← CONS [soundInterval.charMarkList.first + unchangedHead, NIL];
endNewSection ← endNewSection.rest;
insertMarks ← insertMarks.rest
ENDLOOP
};
endNewSection.rest ← afterInsert;
IF beforeInsert = NIL THEN viewerInfo.charMarkList ← newSection ELSE beforeInsert.rest ← newSection
}
};
---- routines to do with textual markers: these markers are really a part of the viewer contents. They are saved when the voice is saved and altering them makes the window status 'edited'
TextInput:
PUBLIC
PROC [viewer: ViewerClasses.Viewer, input: Rope.
ROPE] = {
node: TextNode.Ref;
textEntry: VoiceViewers.TextMarkEntry;
AddArtwork:
PROC [root: TiogaOpsDefs.Ref] = {
TextEdit.PutCharProp[node, textEntry.position, $Artwork, NARROW["VoiceMarker", Rope.ROPE]]; -- the NARROW prevents a REF TEXT being created
TextEdit.PutCharProp[node, textEntry.position, $VoiceMark, textEntry.text.Substr[0, textEntry.displayChars]];
};
selectionViewer: ViewerClasses.Viewer;
start, end, char: TiogaOpsDefs.Location;
insertPosition: INT;
caretBefore: BOOLEAN;
viewerInfo: VoiceViewers.VoiceViewerInfo;
charsAlreadyDisplayed: INT ← 0;
redraw: BOOLEAN ← FALSE;
[viewer: selectionViewer, start: start, end: end, caretBefore: caretBefore] ← TiogaOps.GetSelection[];
IF selectionViewer # viewer THEN ERROR;
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF ~VoiceViewers.GetVoiceLock[viewerInfo] THEN RETURN;
char ← IF caretBefore THEN start ELSE end;
node ← TiogaButtons.TextNodeRef[char.node];
insertPosition ← char.where;
IF viewerInfo.textMarkList = NIL OR viewerInfo.textMarkList.first.position > insertPosition
THEN
{ textEntry ←
NEW [VoiceViewers.TextMarkRec ← [insertPosition, input, 0, 0]];
viewerInfo.textMarkList ← CONS [textEntry, viewerInfo.textMarkList];
LimitText[textEntry, IF viewerInfo.textMarkList.rest = NIL THEN LAST[INT] ELSE viewerInfo.textMarkList.rest.first.position - insertPosition];
TiogaOps.CallWithLocks[AddArtwork];
redraw ← TRUE
}
ELSE
{
IF viewerInfo.textMarkList.first.position = insertPosition
THEN
{ textEntry ← viewerInfo.textMarkList.first;
charsAlreadyDisplayed ← textEntry.displayChars;
textEntry.text ← textEntry.text.Concat[input];
LimitText[textEntry, IF viewerInfo.textMarkList.rest = NIL THEN LAST[INT] ELSE viewerInfo.textMarkList.rest.first.position - insertPosition];
IF textEntry.displayChars # charsAlreadyDisplayed
THEN {TiogaOps.CallWithLocks[AddArtwork]; redraw ← TRUE}
}
ELSE
{ l:
LIST
OF VoiceViewers.TextMarkEntry ← viewerInfo.textMarkList;
WHILE l.rest # NIL AND l.rest.first.position < insertPosition DO l ← l.rest ENDLOOP;
IF l.rest = NIL OR l.rest.first.position > insertPosition
THEN -- insert a new entry: previous entry may need trimming
{ oldWidth:
INT ← l.first.width;
textEntry ← l.first;
LimitText[textEntry, insertPosition - textEntry.position];
IF textEntry.width # oldWidth THEN {TiogaOps.CallWithLocks[AddArtwork]; redraw ← TRUE};
textEntry ← NEW [VoiceViewers.TextMarkRec ← [insertPosition, input, 0, 0]];
l.rest ← CONS [textEntry, l.rest]
}
ELSE -- appending text to an entry already there
{ textEntry ← l.rest.first;
textEntry.text ← textEntry.text.Concat[input];
charsAlreadyDisplayed ← textEntry.displayChars
};
l ← l.rest; -- point at the new/modified entry
LimitText[textEntry, IF l.rest = NIL THEN LAST[INT] ELSE l.rest.first.position - insertPosition];
IF textEntry.displayChars # charsAlreadyDisplayed
THEN {TiogaOps.CallWithLocks[AddArtwork]; redraw ← TRUE}
}
};
**** a Plass-bug: shouldn't be necessary and he says he'll have a look at it
IF redraw THEN ViewerOps.PaintViewer[viewer: viewer, hint: client, clearClient: TRUE, whatChanged: NIL];
viewerInfo.edited ← TRUE;
IF ~redraw THEN VoiceViewers.SetVoiceViewerEditStatus[viewer]; -- not needed if the redraw was performed, as viewer's displayed status will be `edited' already
viewerInfo.editInProgress ← FALSE
};
LimitText: PROC [entry: VoiceViewers.TextMarkEntry, maxLength: INT] = {
entry potentially contains the supplied entry.text: this may only extend over maxLength voice characters, so it may not be possible to display all of it. Set entry.displayChars appropriately and set entry.width to say how much space is taken up by the text actually on display
maxEscapement: REAL ← REAL[maxLength]*VoiceMarkers.voiceCharWidth;
textLength: INT ← entry.text.Length;
currPos: INT ← 0;
currEscapement: REAL ← 0.0;
WHILE currPos < textLength
DO
newEscapement: REAL ← currEscapement + ImagerFont.Escapement[VoiceMarkers.voiceMarkerFont, [VoiceMarkers.voiceCharSet, entry.text.Fetch[currPos]-'\000]].x;
IF newEscapement > maxEscapement THEN EXIT;
currPos ← currPos + 1;
currEscapement ← newEscapement
ENDLOOP;
text limiting is currently accomplished by preserving all the text but only displaying that part which can be displayed: this means that when text obscuring other text is deleted the obscured text reappears for example. It could be arranged that the obscured text was actually eradicated: this would be done by inserting the following line and deleting the displayChars field of the TextMarkEntry and all the code that accesses it
IF currPos # textLength THEN entry.text ← entry.text.Substr[0, currPos];
entry.width ← Real.Fix[(currEscapement+VoiceMarkers.voiceCharWidth-1.0)/ VoiceMarkers.voiceCharWidth];
entry.displayChars ← currPos;
BackSpace:
PUBLIC
PROC [viewer: ViewerClasses.Viewer] = {
if there is a textual marker at the selection then remove its last character
node: TextNode.Ref;
textEntry: VoiceViewers.TextMarkEntry;
AddArtwork:
PROC [root: TiogaOpsDefs.Ref] = {
TextEdit.PutCharProp[node, textEntry.position, $Artwork, NARROW["VoiceMarker", Rope.ROPE]]; -- the NARROW prevents a REF TEXT being created
TextEdit.PutCharProp[node, textEntry.position, $VoiceMark, textEntry.text.Substr[0, textEntry.displayChars]];
};
selectionViewer: ViewerClasses.Viewer;
start, end, char: TiogaOpsDefs.Location;
deletePosition, charsToNextPosition: INT;
caretBefore: BOOLEAN;
viewerInfo: VoiceViewers.VoiceViewerInfo;
[viewer: selectionViewer, start: start, end: end, caretBefore: caretBefore] ← TiogaOps.GetSelection[];
IF selectionViewer # viewer THEN ERROR;
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
IF ~VoiceViewers.GetVoiceLock[viewerInfo] THEN RETURN;
char ← IF caretBefore THEN start ELSE end;
node ← TiogaButtons.TextNodeRef[char.node];
deletePosition ← char.where;
textEntry ← NIL;
FOR l:
LIST
OF VoiceViewers.TextMarkEntry ← viewerInfo.textMarkList, l.rest
WHILE l #
NIL
DO
IF l.first.position >= deletePosition THEN
{
IF l.first.position = deletePosition
THEN
{ textEntry ← l.first;
charsToNextPosition ← IF l.rest = NIL THEN LAST[INT] ELSE l.rest.first.position - deletePosition
};
EXIT
}
ENDLOOP;
IF textEntry = NIL
THEN MessageWindow.Append["No textual annotation at point of selection", TRUE]
ELSE
{ charsOnDisplay:
INT ← textEntry.displayChars;
textEntry.text ← textEntry.text.Substr[0, textEntry.text.Length -1];
LimitText[textEntry, charsToNextPosition];
viewerInfo.edited ← TRUE;
IF charsOnDisplay # textEntry.displayChars
THEN
{ TiogaOps.CallWithLocks[AddArtwork];
**** a Plass-bug: shouldn't be necessary and he says he'll have a look at it
ViewerOps.PaintViewer[viewer: viewer, hint: client, clearClient: TRUE, whatChanged: NIL]
}
ELSE VoiceViewers.SetVoiceViewerEditStatus[selectionViewer]
};
viewerInfo.editInProgress ← FALSE
};
BackWord:
PUBLIC
PROC [viewer: ViewerClasses.Viewer] = {
if there are textual markers within the selection then remove them completely - perhaps a rather odd interpretation of BackWord?
node: TextNode.Ref;
textEntry: VoiceViewers.TextMarkEntry;
AddArtwork:
PROC [root: TiogaOpsDefs.Ref] = {
TextEdit.PutCharProp[node, textEntry.position, $Artwork, IF textEntry.text = NIL THEN NIL ELSE NARROW["VoiceMarker", Rope.ROPE]]; -- the NARROW prevents a REF TEXT being created
TextEdit.PutCharProp[node, textEntry.position, $VoiceMark, IF textEntry.text = NIL THEN NIL ELSE textEntry.text.Substr[0, textEntry.displayChars]];
};
selectionViewer: ViewerClasses.Viewer;
start, end: TiogaOpsDefs.Location;
textRemoved: BOOLEAN ← FALSE;
viewerInfo: VoiceViewers.VoiceViewerInfo;
[viewer: selectionViewer, start: start, end: end] ← TiogaOps.GetSelection[];
IF selectionViewer # viewer THEN ERROR;
IF start.node # end.node THEN ERROR;
viewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
node ← TiogaButtons.TextNodeRef[start.node];
IF ~VoiceViewers.GetVoiceLock[viewerInfo] THEN RETURN;
IF viewerInfo.textMarkList = NIL THEN
{ viewerInfo.editInProgress ←
FALSE;
RETURN
};
IF viewerInfo.textMarkList.first.position >= start.where
THEN
-- any text to removed is at the head of the list
WHILE viewerInfo.textMarkList #
NIL
AND viewerInfo.textMarkList.first.position <= end.where
DO
textEntry ← viewerInfo.textMarkList.first;
textEntry.text ← NIL;
TiogaOps.CallWithLocks[AddArtwork];
textRemoved ← TRUE;
viewerInfo.textMarkList ← viewerInfo.textMarkList.rest
ENDLOOP
ELSE
{ l:
LIST
OF VoiceViewers.TextMarkEntry ← viewerInfo.textMarkList;
WHILE l.rest # NIL AND l.rest.first.position < start.where DO l ← l.rest ENDLOOP;
WHILE l.rest #
NIL
AND l.rest.first.position <= end.where
DO
textEntry ← l.rest.first;
textEntry.text ← NIL;
TiogaOps.CallWithLocks[AddArtwork];
textRemoved ← TRUE;
l.rest ← l.rest.rest
ENDLOOP;
IF textRemoved THEN
{ currChars:
INT;
textEntry ← l.first;
currChars ← textEntry.displayChars;
LimitText[textEntry, IF l.rest = NIL THEN LAST[INT] ELSE l.rest.first.position - textEntry.position];
IF currChars # textEntry.displayChars THEN TiogaOps.CallWithLocks[AddArtwork]
}
};
IF textRemoved THEN
{ viewerInfo.edited ←
TRUE;
**** a Plass-bug: shouldn't be necessary and he says he'll have a look at it
ViewerOps.PaintViewer[viewer: viewer, hint: client, clearClient: TRUE, whatChanged: NIL]
viewerInfo.editInProgress ← FALSE
};
RedrawTextMarkers: PUBLIC PROC [viewer: ViewerClasses.Viewer, voiceCharNode: TiogaOpsDefs.Ref] = {
called by voicePlayBack's redraw procedure [under a voice lock] to place all the textual markers back in a voice viewer
AddArtwork:
PROC [root: TiogaOpsDefs.Ref] = {
textEntry: VoiceViewers.TextMarkEntry ← l.first;
TextEdit.PutCharProp[node, textEntry.position, $Artwork, NARROW["VoiceMarker", Rope.ROPE]]; -- the NARROW prevents a REF TEXT being created
TextEdit.PutCharProp[node, textEntry.position, $VoiceMark, textEntry.text.Substr[0, textEntry.displayChars]];
};
node: TextNode.Ref ← TiogaButtons.TextNodeRef[voiceCharNode];
viewerInfo: VoiceViewers.VoiceViewerInfo ← NARROW[ViewerOps.FetchProp[viewer, $voiceViewerInfo], VoiceViewers.VoiceViewerInfo];
l: LIST OF VoiceViewers.TextMarkEntry;
FOR l ← viewerInfo.textMarkList, l.rest WHILE l # NIL DO TiogaOps.CallWithLocks[AddArtwork] ENDLOOP
};
ExtractTextMarks: PUBLIC PROC [viewerInfo: VoiceViewers.VoiceViewerInfo, soundInterval: VoiceViewers.SoundInterval] = {
return as selection.textMarkList a copy [n.b.] of the section of the textual mark list in viewerInfo falling in to the region of selection.ropeInterval
currLastInList: LIST OF VoiceViewers.TextMarkEntry;
soughtStart: INT ← soundInterval.ropeInterval.start/VoiceViewers.soundRopeCharLength;
soughtEnd: INT ← (soundInterval.ropeInterval.start + soundInterval.ropeInterval.length)/VoiceViewers.soundRopeCharLength;
soundInterval.textMarkList ← NIL; -- should be already so, but . . .
FOR l:
LIST
OF VoiceViewers.TextMarkEntry ← viewerInfo.textMarkList, l.rest
WHILE l #
NIL
AND l.first.position < soughtEnd
DO
IF l.first.position >= soughtStart THEN
{ newEntry: VoiceViewers.TextMarkEntry ←
NEW [VoiceViewers.TextMarkRec ← l.first^];
newEntry.position ← newEntry.position - soughtStart;
IF soundInterval.textMarkList = NIL
THEN
{ soundInterval.textMarkList ←
CONS [newEntry,
NIL];
currLastInList ← soundInterval.textMarkList;
}
ELSE
{ currLastInList.rest ←
CONS [newEntry,
NIL];
currLastInList ← currLastInList.rest
}
}
ENDLOOP
};
EditTextMarks:
PUBLIC
PROC [viewerInfo: VoiceViewers.VoiceViewerInfo, unchangedHead, deleteChars, insertChars:
INT, soundInterval: VoiceViewers.SoundInterval] = {
this gets called when an edit is made to the contents of the viewer: it keeps the textMarkList in step with the edit
it is not a very efficient implementation - better ones are an exercise for the reader
atHead: BOOLEAN ← TRUE;
l: LIST OF VoiceViewers.TextMarkEntry;
first alter the old list to remove the text in the deleted area and move text after that area
WHILE atHead
AND viewerInfo.textMarkList #
NIL
DO
SELECT viewerInfo.textMarkList.first.position
FROM
>= unchangedHead+deleteChars =>
{viewerInfo.textMarkList.first.position ← viewerInfo.textMarkList.first.position + insertChars - deleteChars; atHead ← FALSE};
>= unchangedHead => viewerInfo.textMarkList ← viewerInfo.textMarkList.rest;
ENDCASE => atHead ← FALSE;
ENDLOOP;
IF viewerInfo.textMarkList # NIL THEN
{ l ← viewerInfo.textMarkList;
WHILE l #
NIL
AND l.rest #
NIL
DO
--the dual WHILE condition is because we can delete the next entry and it could be the last
SELECT l.rest.first.position
FROM
>= unchangedHead+deleteChars =>
{l.rest.first.position ← l.rest.first.position + insertChars - deleteChars;
l ← l.rest};
>= unchangedHead => l.rest ← l.rest.rest;
ENDCASE => l ← l.rest
ENDLOOP
};
IF soundInterval # NIL AND soundInterval.textMarkList # NIL
THEN -- now put the textual marks from the soundInterval into the list at the appropriate point
{
beforeInsert, afterInsert: LIST OF VoiceViewers.TextMarkEntry ← NIL;
newSection, endNewSection: LIST OF VoiceViewers.TextMarkEntry;
IF viewerInfo.textMarkList # NIL THEN
{
IF viewerInfo.textMarkList.first.position >= unchangedHead
THEN afterInsert ← viewerInfo.textMarkList
ELSE
{ l ← viewerInfo.textMarkList;
WHILE l.rest # NIL AND l.rest.first.position < unchangedHead DO l ← l.rest ENDLOOP;
beforeInsert ← l; afterInsert ← l.rest
}
};
{ insertMarks:
LIST
OF VoiceViewers.TextMarkEntry ← soundInterval.textMarkList.rest;
newSection ← CONS [NEW [VoiceViewers.TextMarkRec ← soundInterval.textMarkList.first^], NIL];
newSection.first.position ← newSection.first.position + unchangedHead;
endNewSection ← newSection;
WHILE insertMarks #
NIL
DO
endNewSection.rest ← CONS [NEW [VoiceViewers.TextMarkRec ← soundInterval.textMarkList.first^], NIL];
endNewSection ← endNewSection.rest;
insertMarks ← insertMarks.rest;
endNewSection.first.position ← endNewSection.first.position + unchangedHead
ENDLOOP
};
endNewSection.rest ← afterInsert;
LimitText[endNewSection.first, IF endNewSection.rest = NIL THEN LAST[INT] ELSE endNewSection.rest.first.position - endNewSection.first.position];
IF beforeInsert = NIL
THEN viewerInfo.textMarkList ← newSection
ELSE
{ beforeInsert.rest ← newSection;
LimitText[beforeInsert.first, newSection.first.position - beforeInsert.first.position]
}
}
ELSE -- no new entries to be inserted, but we must LimitText on the entry previous to the cut
{
IF viewerInfo.textMarkList #
NIL
AND viewerInfo.textMarkList.first.position < unchangedHead
THEN
{ beforeCut:
LIST
OF VoiceViewers.TextMarkEntry ← viewerInfo.textMarkList;
WHILE beforeCut.rest # NIL AND beforeCut.rest.first.position < unchangedHead DO beforeCut ← beforeCut.rest ENDLOOP;
LimitText[beforeCut.first, IF beforeCut.rest = NIL THEN LAST[INT] ELSE beforeCut.rest.first.position - beforeCut.first.position]
}
}
};
RopeFromTextList:
PUBLIC
PROC [l:
LIST
OF VoiceViewers.TextMarkEntry]
RETURNS [r: Rope.
ROPE ←
NIL] = {
convert the list of text markers in a voice viewer into a rope suitable for saving in a textual document at the position of a talks bubble
WHILE l #
NIL
DO
textEntry: Rope.ROPE ← l.first.text;
positionInSamples: INT ← l.first.position*VoiceViewers.soundRopeCharLength;
r ← r.Cat[Convert.RopeFromInt[positionInSamples], ":", Convert.RopeFromInt[textEntry.Length], ":"];
r ← r.Concat[textEntry];
l ← l.rest
ENDLOOP
};
TextListFromRope:
PUBLIC
PROC [r: Rope.
ROPE]
RETURNS [l:
LIST
OF VoiceViewers.TextMarkEntry ←
NIL] = {
and go the other way
endOfList: LIST OF VoiceViewers.TextMarkEntry;
WHILE r.Length > 0
DO
nextColon: INT ← r.Find[":"];
newEntry: VoiceViewers.TextMarkEntry ← NEW [VoiceViewers.TextMarkRec ← [Convert.IntFromRope[r.Substr[0, nextColon]]/VoiceViewers.soundRopeCharLength, NIL, 0, 0]];
textLength: INT;
r ← r.Substr[nextColon+1];
nextColon ← r.Find[":"];
textLength ← Convert.IntFromRope[r.Substr[0, nextColon]];
r ← r.Substr[nextColon+1];
newEntry.text ← r.Substr[0, textLength];
r ← r.Substr[textLength];
IF l = NIL
THEN
{ l ←
CONS [newEntry,
NIL];
endOfList ← l
}
ELSE
{ endOfList.rest ←
CONS [newEntry,
NIL];
endOfList ← endOfList.rest
}
ENDLOOP;
FOR list:
LIST
OF VoiceViewers.TextMarkEntry ← l, list.rest
WHILE list #
NIL
DO
LimitText[list.first, IF list.rest = NIL THEN LAST[INT] ELSE list.rest.first.position - list.first.position]
ENDLOOP
voiceMarkerFont: PUBLIC ImagerFont.Font ← ImagerFont.Find["xerox/tiogafonts/tioga10"];
END.