Class:            TimeSequenceView

Environment:      Siren
 Superclass:         Siren.DisplayListView
 Category:         MusicUI-Editors
 Instance variables:   clefForm xScaleDefault xScale xColor yColor headColor
               clefColor itemAccessors

Instances of SequenceView (and its subclasses) are time-line oriented DisplayListViews.
Time may run horizontally (default) or vertically, depending on the layout manager.

Instance Variables:
   clefForm   

the view's clef form or axes (optional), may be staff or scale/grid/ruler
   xScale    the time-to-x-coordinate scale
   xColor    the color of the lines for note duration
   yColor    the color of the lines for note amplitude
   headColor    the note head color
   clefColor    the clef color
   itemAccessors    Symbol)> the item accessor(s) to use to generate the display list items for the notes

This implementation is MODE 1.1, STEIM, Amsterdam, May/June 1990; updated at the Lagoon in Palo Alto, July, 1991-May, 1992.

The entirety of this software is Copyright (c) 1990, Stephen Travis Pope, Nomad Object Design/Nomad Computer Music Research.
All Rights Reserved.

displaying

displayOn: aGC
   Display the receiver on the argument.

displayOnImage
   Display the receiver on its cached form.

highlightFrom: pt1 to: pt2
   Show selection of the range pt1--pt2.

highlightTime: value
   Show selection of the time value value.

reallyDisplayOn: gc
   Display the receiver on its cached form.

zoom: aPoint
   Set the receiver's 'zoom' to be aPoint.

accessing

cachedPixmap
   Answer the receiver's cached pixmap.

clefColor
   Answer the receiver's 'clefColor'.

clefColor: anObject
   Set the receiver's 'clefColor' to be anObject.

clefForm
   Answer the receiver's clef form.

clefWidth
   Answer the receiver's clef form width.

headColor
   Answer the receiver's 'headColor'.

headColor: anObject
   Set the receiver's 'headColor' to be anObject.

xColor
   Answer the receiver's 'xColor'.

xColor: anObject
   Set the receiver's 'xColor' to be anObject.

xScale
   Answer the receiver's 'xScale'.

xScale: anObject
   Set the receiver's 'xScale' to be anObject.

yColor
   Answer the receiver's 'yColor'.

yColor: anObject
   Set the receiver's 'yColor' to be anObject.

transforming

formXFromTime: aTime
   take a note's time and return a display point x coordinate relative to the form.

timeFromX: aNumber
   Answer an event list time from the argument.

layout manager access

generateItemFor: anAss
   Answer the correct visual item for the given assoc. (sent from layoutManagers).

itemFor: anAss
   Answer the correct visual item for the given assoc. (sent from layoutManagers).

layoutManager
   Answer a default layout manager for the receiver.

initialize-release

initialize
   Initialize the instance variables of the receiver.

controller access

defaultControllerClass
   Answer the class of the default controller for the receiver.

updating

update: ignored
   Redraw the display

MetaClass:         TimeSequenceView class

examples

randomExample
   Open a sequence view on a random event list.

instance creation

openOnEventList: anEventList
   Open the receiver on the given event list.

constant access

defaultCacheExtent
   Answer the default extent of the receiver's instances' cache.

inset
   Answer the default display inset.