Description

This is a vocabulary for precisely describing a position in time and the passage of time itself, in both real and musical terms.

In addition to real time (e.g. seconds), two units of time are used: frames and beats. A frame is a numbered quantum of time. Frame time is related to real-time by the frame rate or sample rate, time:framesPerSecond. A beat is a single pulse of musical time. Beat time is related to real-time by the tempo, time:beatsPerMinute.

Musical time additionally has a meter which describes passage of time in terms of musical bars. A bar is a higher level grouping of beats. The meter describes how many beats are in one bar.

Index

Classes
Properties
bar, barBeat, beat, beatUnit, beatsPerBar, beatsPerMinute, frame, framesPerSecond, position, speed

Reference

Class time:Position

Position

A point in time and/or the speed at which time is passing. A position is both a point and a speed, which precisely defines a time within a timeline.

In range oftime:position

Class time:Rate

Rate

The rate of passage of time in terms of one unit with respect to another.

Sub-class oftime:Position
In domain oftime:beatUnit
time:beatsPerBar
time:beatsPerMinute
time:speed
time:framesPerSecond

Class time:Time

Time

A point in time in some unit/dimension.

Sub-class oftime:Position
In domain oftime:frame
time:beat
time:barBeat
time:bar

Property time:bar

bar
OWL TypeDatatype Property
Domaintime:Time
Rangexsd:long

Property time:barBeat

beat within bar

The beat number within the bar, from 0 to beatsPerBar.

OWL TypeDatatype Property
Domaintime:Time
Rangexsd:float

Property time:beat

beat
OWL TypeDatatype Property
Domaintime:Time
Rangexsd:double

Property time:beatUnit

Beat unit, the note value that counts as one beat. This is the bottom number in a time signature: 2 for half note, 4 for quarter note, and so on.

OWL TypeDatatype Property
Domaintime:Rate
Rangexsd:nonNegativeInteger

Property time:beatsPerBar

beats per bar
OWL TypeDatatype Property
Domaintime:Rate
Rangexsd:float

Property time:beatsPerMinute

beats per minute

Tempo in beats per minute.

OWL TypeDatatype Property
Domaintime:Rate
Rangexsd:float

Property time:frame

frame
OWL TypeDatatype Property
Domaintime:Time
Rangexsd:long

Property time:framesPerSecond

frames per second

Frame rate in frames per second.

OWL TypeDatatype Property
Domaintime:Rate
Rangexsd:float

Property time:position

position
OWL TypeObject Property
Rangetime:Position

Property time:speed

speed

The rate of the progress of time as a fraction of normal speed. For example, a rate of 0.0 is stopped, 1.0 is rolling at normal speed, 0.5 is rolling at half speed, -1.0 is reverse, and so on.

OWL TypeDatatype Property
Domaintime:Rate
Rangexsd:float

History

Version 2.2 (2014-08-08)
  • Add patch:sequenceNumber for associating replies with requests.
Version 2.2 (2014-01-04)
  • Add missing include string.h to logger.h for memset.
Version 1.6 (2013-05-26)
  • Fix crash in forge.h when pushing atoms to a full buffer.
Version 1.4 (2013-01-27)
  • Fix lv2_atom_sequence_end().
  • Remove atom:stringType in favour of owl:onDatatype so generic tools can understand and validate atom literals.
  • Improve atom documentation.
Version 2.0 (2013-01-16)
  • Add state:loadDefaultState feature so plugins can have their default state loaded without hard-coding default state as a special case.
Version 1.10 (2013-01-13)
  • Fix incorrect return type in lv2_event_get().
Version 2.0 (2013-01-10)
  • Make patch:Set a compact message for setting one property.
  • Add patch:readable and patch:writable for describing available properties.
Version 2.0 (2013-01-08)
  • Add logger convenience API.
Version 1.2 (2012-12-21)
  • Fix typo in bufsz:sequenceSize label.
Version 1.2 (2012-10-14)
  • Use consistent label style.
Version 1.0 (2012-04-17)
  • Initial release.
Version 2.2 (2011-11-21)
  • Update packaging.
  • Improve documentation.
Version 1.4 (2011-11-21)
  • Improve documentation.
  • Update packaging.
Version 1.4 (2011-11-21)
  • Improve documentation.
  • Update packaging.
Version 1.4 (2011-11-21)
  • Update packaging.
Version 1.4 (2011-11-21)
  • Improve documentation.
  • Update packaging.
Version 1.2 (2011-05-26)
  • Switch to ISC license.
  • Add build system for installation.
Version 1.2 (2011-05-26)
  • Switch to ISC license.
  • Add build system for installation.
Version 1.2 (2011-05-26)
  • Use lv2:Specification to be discovered as an extension.
  • Add build system (for installation).
  • Convert documentation to HTML and use lv2:documentation.
Version 1.2 (2011-05-26)
  • Switch to ISC license.
  • Add build system for installation.
Version 1.0 (2010-11-24)
  • Initial release.
Version 2.0 (2010-10-04)
  • Initial release.
Version 1.0 (2010-10-04)
  • Initial release.
Version 1.0 (2010-10-04)
  • Initial release.
Version 1.0 (2010-10-04)
  • Initial release.