Class SetTempoEvent
Represents a Set Tempo meta event.
Inherited Members
Namespace: Melanchall.DryWetMidi.Core
Assembly: Melanchall.DryWetMidi.dll
Syntax
public sealed class SetTempoEvent : MetaEvent
Remarks
The MIDI set tempo meta message sets the tempo of a MIDI sequence in terms
of microseconds per quarter note.
Constructors
SetTempoEvent()
Initializes a new instance of the SetTempoEvent.
Declaration
public SetTempoEvent()
SetTempoEvent(long)
Initializes a new instance of the SetTempoEvent with the
specified number of microseconds per quarter note.
Declaration
public SetTempoEvent(long microsecondsPerQuarterNote)
Parameters
Type | Name | Description |
---|---|---|
long | microsecondsPerQuarterNote | Number of microseconds per quarter note. |
Exceptions
Type | Condition |
---|---|
ArgumentOutOfRangeException | microsecondsPerQuarterNote is out of
[MinMicrosecondsPerQuarterNote; MaxMicrosecondsPerQuarterNote] range. |
Fields
DefaultMicrosecondsPerQuarterNote
Default tempo.
Declaration
public const long DefaultMicrosecondsPerQuarterNote = 500000
Field Value
Type | Description |
---|---|
long |
MaxMicrosecondsPerQuarterNote
Represents the largest possible microseconds-per-quarter-note value.
Declaration
public const long MaxMicrosecondsPerQuarterNote = 16777215
Field Value
Type | Description |
---|---|
long |
MinMicrosecondsPerQuarterNote
Represents the smallest possible microseconds-per-quarter-note value.
Declaration
public const long MinMicrosecondsPerQuarterNote = 1
Field Value
Type | Description |
---|---|
long |
Properties
MicrosecondsPerQuarterNote
Gets or sets number of microseconds per quarter note.
Declaration
public long MicrosecondsPerQuarterNote { get; set; }
Property Value
Type | Description |
---|---|
long |
Exceptions
Type | Condition |
---|---|
ArgumentOutOfRangeException | value is out of
[MinMicrosecondsPerQuarterNote; MaxMicrosecondsPerQuarterNote] range. |
Methods
CloneEvent()
Clones event by creating a copy of it.
Declaration
protected override MidiEvent CloneEvent()
Returns
Type | Description |
---|---|
MidiEvent | Copy of the event. |
Overrides
GetContentSize(WritingSettings)
Gets the size of the content of a MIDI meta event.
Declaration
protected override int GetContentSize(WritingSettings settings)
Parameters
Type | Name | Description |
---|---|---|
WritingSettings | settings | Settings according to which the event's content must be written. |
Returns
Type | Description |
---|---|
int | Size of the event's content. |
Overrides
ReadContent(MidiReader, ReadingSettings, int)
Reads content of a MIDI meta event.
Declaration
protected override void ReadContent(MidiReader reader, ReadingSettings settings, int size)
Parameters
Type | Name | Description |
---|---|---|
MidiReader | reader | Reader to read the content with. |
ReadingSettings | settings | Settings according to which the event's content must be read. |
int | size | Size of the event's content. |
Overrides
ToString()
Returns a string that represents the current object.
Declaration
public override string ToString()
Returns
Type | Description |
---|---|
string | A string that represents the current object. |
Overrides
WriteContent(MidiWriter, WritingSettings)
Writes content of a MIDI meta event.
Declaration
protected override void WriteContent(MidiWriter writer, WritingSettings settings)
Parameters
Type | Name | Description |
---|---|---|
MidiWriter | writer | Writer to write the content with. |
WritingSettings | settings | Settings according to which the event's content must be written. |