<instrDef>

(instrument definition) – MIDI instrument declaration.
14.5.2 Recording General MIDI Instrumentation
Module
MEI.midi
Attributes
azimuth, class, copyof, corresp, decls, elevation, follows, label, midi.channel, midi.duty, midi.instrname, midi.instrnum, midi.pan, midi.patchname, midi.patchnum, midi.port, midi.track, midi.volume, n, next, precedes, prev, resp, sameas, synch, type, xml:base, xml:id
azimuth(optional)The lateral or left-to-right plane. Value conforms to data.DEGREES.
<instrDef>att.instrDef.gesatt.soundLocation@azimuth
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
<instrDef>att.typedatt.classed@class
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
<instrDef>att.linking@copyof
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@corresp
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
<instrDef>att.metadataPointing@decls
elevation(optional)The above-to-below axis. Value conforms to data.DEGREES.
<instrDef>att.instrDef.gesatt.soundLocation@elevation
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@follows
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
<instrDef>att.labelled@label
midi.channel(optional)Records a MIDI channel value. Value conforms to data.MIDICHANNEL.
<instrDef>att.instrDef.gesatt.channelized@midi.channel
midi.duty(optional)Specifies the 'on' part of the duty cycle as a percentage of a note’s duration. Value conforms to data.PERCENT.LIMITED.
<instrDef>att.instrDef.gesatt.channelized@midi.duty
midi.instrname(optional)Provides a General MIDI label for the MIDI instrument. Value conforms to data.MIDINAMES.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.instrname
midi.instrnum(optional)Captures the General MIDI instrument number. Use an integer for a 0-based value. An integer preceded by "in" indicates a 1-based value. Value conforms to data.MIDIVALUE.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.instrnum
midi.pan(optional)Sets the instrument’s position in a stereo field. MIDI values of 0 and 1 both pan left, 127 or 128 pans right, and 63 or 64 pans to the center. Positve percentage values pan to the right, negative ones to the left. 0% is centered. Value conforms to data.MIDIVALUE_PAN.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.pan
midi.patchname(optional)Records a non-General MIDI patch/instrument name. Value is a NMTOKEN.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.patchname
midi.patchnum(optional)Records a non-General MIDI patch/instrument number. Value conforms to data.MIDIVALUE.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.patchnum
midi.port(optional)Sets the MIDI port value. Value conforms to data.MIDIVALUE_NAME.
<instrDef>att.instrDef.gesatt.channelized@midi.port
midi.track(optional)Sets the MIDI track. Value is a positive integer.
<instrDef>att.instrDef.gesatt.channelized@midi.track
midi.volume(optional)Sets the instrument’s volume. Value conforms to data.MIDIVALUE_PERCENT.
<instrDef>att.instrDef.gesatt.midiInstrument@midi.volume
n(optional)Provides a numeric designation that indicates an element’s position in a sequence of similar elements. Its value must be a non-negative integer. Value is a positive integer, including 0.
<instrDef>att.nInteger@n
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@next
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@precedes
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@prev
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
<instrDef>att.responsibility@resp
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@sameas
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
<instrDef>att.linking@synch
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
<instrDef>att.typed@type
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
<instrDef>att.basic@xml:base
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
<instrDef>att.basicatt.id@xml:id
(MEI.shared) Attributes that form the basis of the att.common class.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
(MEI.shared) Attributes that uniquely identify an element.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
(MEI.shared)
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
(MEI.shared) Attributes that specify element-to-element relationships.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
(MEI.shared) Provides attributes for elements which may be associated with particular contextual elements within the header.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes used to supply an integer number designation for an element.
n(optional)Provides a numeric designation that indicates an element’s position in a sequence of similar elements. Its value must be a non-negative integer. Value is a positive integer, including 0.
(MEI.shared) Attributes capturing information regarding responsibility for some aspect of the text's creation, transcription, editing, or encoding.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
(MEI.shared) Attributes which can be used to classify features.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
(MEI.analytical) Analytical domain attributes.
(MEI.gestural) Gestural domain attributes.
(MEI.midi) Attributes that record MIDI channel information.
midi.channel(optional)Records a MIDI channel value. Value conforms to data.MIDICHANNEL.
midi.duty(optional)Specifies the 'on' part of the duty cycle as a percentage of a note’s duration. Value conforms to data.PERCENT.LIMITED.
midi.port(optional)Sets the MIDI port value. Value conforms to data.MIDIVALUE_NAME.
midi.track(optional)Sets the MIDI track. Value is a positive integer.
(MEI.midi) Attributes that record MIDI instrument information.
midi.instrnum(optional)Captures the General MIDI instrument number. Use an integer for a 0-based value. An integer preceded by "in" indicates a 1-based value. Value conforms to data.MIDIVALUE.
midi.instrname(optional)Provides a General MIDI label for the MIDI instrument. Value conforms to data.MIDINAMES.
midi.pan(optional)Sets the instrument’s position in a stereo field. MIDI values of 0 and 1 both pan left, 127 or 128 pans right, and 63 or 64 pans to the center. Positve percentage values pan to the right, negative ones to the left. 0% is centered. Value conforms to data.MIDIVALUE_PAN.
midi.patchname(optional)Records a non-General MIDI patch/instrument name. Value is a NMTOKEN.
midi.patchnum(optional)Records a non-General MIDI patch/instrument number. Value conforms to data.MIDIVALUE.
midi.volume(optional)Sets the instrument’s volume. Value conforms to data.MIDIVALUE_PERCENT.
(MEI.gestural) Attributes that locate a sound source within 3-D space.
azimuth(optional)The lateral or left-to-right plane. Value conforms to data.DEGREES.
elevation(optional)The above-to-below axis. Value conforms to data.DEGREES.
(MEI.midi) Logical domain attributes.
(MEI.visual) Visual domain attributes.
Gestural component declarations.
azimuth(optional)The lateral or left-to-right plane. Value conforms to data.DEGREES.
elevation(optional)The above-to-below axis. Value conforms to data.DEGREES.
MIDI component declarations.
midi.channel(optional)Records a MIDI channel value. Value conforms to data.MIDICHANNEL.
midi.duty(optional)Specifies the 'on' part of the duty cycle as a percentage of a note’s duration. Value conforms to data.PERCENT.LIMITED.
midi.instrname(optional)Provides a General MIDI label for the MIDI instrument. Value conforms to data.MIDINAMES.
midi.instrnum(optional)Captures the General MIDI instrument number. Use an integer for a 0-based value. An integer preceded by "in" indicates a 1-based value. Value conforms to data.MIDIVALUE.
midi.pan(optional)Sets the instrument’s position in a stereo field. MIDI values of 0 and 1 both pan left, 127 or 128 pans right, and 63 or 64 pans to the center. Positve percentage values pan to the right, negative ones to the left. 0% is centered. Value conforms to data.MIDIVALUE_PAN.
midi.patchname(optional)Records a non-General MIDI patch/instrument name. Value is a NMTOKEN.
midi.patchnum(optional)Records a non-General MIDI patch/instrument number. Value conforms to data.MIDIVALUE.
midi.port(optional)Sets the MIDI port value. Value conforms to data.MIDIVALUE_NAME.
midi.track(optional)Sets the MIDI track. Value is a positive integer.
midi.volume(optional)Sets the instrument’s volume. Value conforms to data.MIDIVALUE_PERCENT.
Component declarations that are shared between two or more modules.
class(optional)Contains one or more URIs which denote classification terms that apply to the entity bearing this attribute. One or more values from data.URI, separated by spaces.
copyof(optional)Points to an element of which the current element is a copy. Value conforms to data.URI.
corresp(optional)Used to point to other elements that correspond to this one in a generic fashion. One or more values from data.URI, separated by spaces.
decls(optional)Identifies one or more metadata elements (other than classification terms) within the header, which are understood to apply to the element bearing this attribute and its content. One or more values from data.URI, separated by spaces.
follows(optional)points to one or more events in a user-defined collection that are known to be predecessors of the current element. One or more values from data.URI, separated by spaces.
label(optional)Captures text to be used to generate a label for the element to which it’s attached, a "tool tip" or prefatory text, for example. Should not be used to record document content. Value is plain text.
n(optional)Provides a numeric designation that indicates an element’s position in a sequence of similar elements. Its value must be a non-negative integer. Value is a positive integer, including 0.
next(optional)Used to point to the next event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
precedes(optional)Points to one or more events in a user-defined collection that are known to be successors of the current element. One or more values from data.URI, separated by spaces.
prev(optional)Points to the previous event(s) in a user-defined collection. One or more values from data.URI, separated by spaces.
resp(optional)Indicates the agent(s) responsible for some aspect of the text’s transcription, editing, or encoding. Its value must point to one or more identifiers declared in the document header. One or more values from data.URI, separated by spaces.
sameas(optional)Points to an element that is the same as the current element but is not a literal copy of the current element. One or more values from data.URI, separated by spaces.
synch(optional)Points to elements that are synchronous with the current element. One or more values from data.URI, separated by spaces.
type(optional)Designation which characterizes the element in some sense, using any convenient classification scheme or typology that employs single-token labels. One or more values of datatype NMTOKEN, separated by spaces.
xml:base(optional)Provides a base URI reference with which applications can resolve relative URI references into absolute URI references. Value conforms to data.URI.
xml:id(optional)Regularizes the naming of an element and thus facilitates building links between it and other resources. Each id attribute within a document must have a unique value. Value is a valid xml:id.
Member of
model.instrDefLikeGroups elements used to declare a MIDI instrument.
Contained By
(MEI.shared) Groups elements used to declare a MIDI instrument.
instrGrpCollects MIDI instrument definitions.
layerDefContainer for layer meta-information.
staffDefContainer for staff meta-information.
staffGrpA group of bracketed or braced staves.
MIDI component declarations.
instrGrpCollects MIDI instrument definitions.
Component declarations that are shared between two or more modules.
layerDefContainer for layer meta-information.
staffDefContainer for staff meta-information.
staffGrpA group of bracketed or braced staves.
May Contain
– (<instrDef> may not have child elements)
Remarks

This element provides a starting or default instrument declaration for a staff, a group of staves, or a layer. Following scoreDef, staffDef, layerDef, or MIDI prog elements may then change the instrument as necessary.

Declaration
<elementSpec ident="instrDef" module="MEI.midi">
<gloss versionDate="2022-05-18" xml:lang="en">instrument definition</gloss>
<desc xml:lang="en">MIDI instrument declaration.</desc>
<classes>
<memberOf key="att.basic"/>
<memberOf key="att.labelled"/>
<memberOf key="att.linking"/>
<memberOf key="att.metadataPointing"/>
<memberOf key="att.nInteger"/>
<memberOf key="att.responsibility"/>
<memberOf key="att.typed"/>
<memberOf key="att.instrDef.anl"/>
<memberOf key="att.instrDef.ges"/>
<memberOf key="att.instrDef.log"/>
<memberOf key="att.instrDef.vis"/>
<memberOf key="model.instrDefLike"/>
</classes>
<content>
<rng:empty/>
</content>
<remarks xml:lang="en">
<p>This element provides a starting or default instrument declaration for a staff, a group of staves, or a layer. Following scoreDef, staffDef, layerDef, or MIDI prog elements may then change the instrument as necessary.</p>
</remarks>
</elementSpec>
MEI Version: 5.0(#eb14650)