linked-rolls
    Preparing search index...

    Interface TrackerBar

    Describes a tracker bar. Track numbers are 1-based and count from the bass edge of the roll, which is the numbering used throughout the edition: a feature's vertical.from is a track in this sense.

    This is the only place where track numbers are given a meaning. Anything that needs to know where the note block ends, which side an expression belongs to, or how a track maps to a pitch, should ask the tracker bar rather than repeat the boundaries.

    interface TrackerBar {
        accents: readonly (readonly string[])[];
        areas: readonly TrackArea[];
        expressionTypes: readonly string[];
        id: string;
        name: string;
        paperSpeed?: SpeedMeasure;
        rewindTrack: Track;
        trackCount: number;
        width: Millimeters;
        endsAt(features: readonly PlacedOnBar[]): RollEnd | undefined;
        meaningOf(position: Track): TrackMeaning | undefined;
        meaningsOf(span: OnBar): readonly TrackMeaning[];
        operationOf(expressionType: string): Operation | undefined;
        positionOf(meaning: TrackMeaning): Track | undefined;
        positionsIn(span: OnBar): readonly Track[];
        roleOf(position: Track): TrackRole | undefined;
    }
    Index
    accents: readonly (readonly string[])[]

    How the system spells a single added accent, each spelling a sequence of its expression types: a latched system turns a valve on and off again, a held one holds one perforation for the accent.

    areas: readonly TrackArea[]

    The blocks of positions, from the bass edge upwards.

    expressionTypes: readonly string[]

    The expression types the bar reads, each a term of the system.

    id: string

    Names the reproducing system in the type vocabulary: the system is https://w3id.org/reo/type/system/<id> and its expression types live under https://w3id.org/reo/type/<id>/.

    name: string
    paperSpeed?: SpeedMeasure

    The paper speed the system runs its rolls at, where the literature states one. A system whose rolls each carry a tempo of their own, as the Licensee's do, states none.

    rewindTrack: Track

    The position carrying the rewind perforation, which runs at the very end of a roll and is the usual landmark for calibrating a scan against the bar.

    trackCount: number

    Number of positions on the bar. Tracks run from 1 to this.

    Width of the roll the bar reads.

    • Where the roll's own content ends, from its perforations alone, or undefined where nothing on the paper says. A copy that reads undefined runs to the end of whatever was scanned, which is a fact about the scan rather than about the roll and should be reported as one.

      Takes anything with a place and a position, so a reader can ask it of a copy's features before there are symbols, and a collation can ask it of the symbols afterwards.

      Parameters

      Returns RollEnd | undefined

    • undefined for a position the bar does not read. A measured place is snapped to the nearest position: perforations sit on the grid and measurements of them scatter around it.

      Parameters

      Returns TrackMeaning | undefined

    • What the bar reads off a feature, which may lie across more than one position. A perforation lifts every valve whose bar hole it uncovers, so an opening across two positions reads as two commands; one on a single position reads as the one meaningOf gives, and one on positions the bar does not read as none at all.

      Parameters

      Returns readonly TrackMeaning[]

    • What the expression type operates, or undefined for one the bar does not read or whose function has no counterpart in another scale.

      Parameters

      • expressionType: string

      Returns Operation | undefined

    • meaningOf inverted: the position this bar reads the meaning on, or undefined where it does not read it at all. A symbol's track is this rather than anything measured, since a note of one pitch sits on exactly one position of a given bar.

      Parameters

      Returns Track | undefined