The binding of a sample or an envelope to an instrument.
An attachment is the item to binds a sample or an envelope to a particular instrument.
An Attachment is associated with precisely one Envelope and one Instrument, or one Sample and one Instrument. An Attachment is said to be an Envelope Attachment if it is attached to an Envelope, or a Sample Attachment if attached to a Sample.
Sample attachments actually come in two flavors: one for input FIFOs and another for output FIFOs, defined by the Hook to which the Sample is attached. Both kinds are considered Sample Attachments and no distinction is made between them.
A single Instrument can have one Envelope Attachment per Envelope hook and one Sample Attachment per Output FIFO. A single Instrument can have multiple Sample Attachments per Input FIFO, but only one will be selected to be played when the instrument is started. This is useful for creating multi-sample instruments, where the sample selected to be played depends on the pitch to be played.
A single Sample or Envelope can have multiple Attachments made to it.
audio
AUDIO_ATTACHMENT_NODE
SetAudioItemInfo()
''%%LinkAttachments%%''(), MonitorAttachment(), ReleaseAttachment(), StartAttachment(), StopAttachment(), WhereAttachment()
StartAttachment()
or StartInstrument()
)
.For sample attachments, specifies a sample frame number in the sample at which to begin playback.
For envelopes, attachments specifies the segment index at which to start.
StartInstrument()
to not automatically start this attachment. This allows later starting of the attachment by using StartAttachment()
. Defaults to cleared (attachment defaults to starting when instrument is started).