Windows Media Encoder SDK banner art

Embedded and Referenced Components

Any component that appears within another component in the project tree is embedded in that component. It is saved in the run-time file for the component and doesn't need to be distributed separately. For example, if you create an audiopath component and then copy or move it to a segment by dragging in the project tree, that audiopath is now part of the segment, and you don't need to save or distribute the run-time audiopath (.aud) file. Audiopaths, bands, and containers are usually embedded in segments and don't need to be distributed as separate files.

Note   Files in the Reference Runtime folder of a script are exceptions to the rule that components are embedded when they appear within other components in the project tree. See Embedding and Referencing Files in a Script.

Bands in the Band Track are saved with the segment. The following tracks, however, contain only references to components, and the components themselves must be distributed separately:

For example, you can drag a wave from the project tree onto the Wave Track in Segment Designer. Although the wave now appears graphically in the editing window, it is not shown as part of the segment in the project tree, and it is not saved in the run-time segment file except as a reference to the original wave file. You must distribute the run-time wave (.wav) file along with the segment (.sgt) file, or else include the wave in a container within the segment.

DLS collections are also referenced rather than embedded. It's not enough to distribute a band as part of a segment file; you also need to distribute the run-time DLS collection (.dls) file containing the instruments referenced by that band. This is not necessary, however, if the band uses only the standard instruments in the Gm.dls collection, which is available on every system that has DirectMusic installed.


© 2000-2001 Microsoft Corporation. All rights reserved.