Load Asset¶
Requirements¶
Input Streams: None
Output Streams: Mesh Stream, Texture Stream, Animation Stream, Audio Stream, Stabilization Data (depending on contents of the source Clip)
Overview¶
The Load Asset Stage introduces new Clip data to the current Track as mesh and texture streams.
Load Asset intervals take an Asset ID for the Clip to be loaded, and an offset to determine when in the Composition the streams are played.
Load Asset Stages support a special workflow for adding Clips: New Tracks with Load asset Stages are created automatically when you click and drag a Clip from the Project View onto the Track Editor.
Additionally, you can add a configured Load Asset Interval by clicking and dragging a Clip onto the Timeline section adjacent to a Load Asset Stage, or you can add a new Load Asset Stage to an existing track by clicking and dragging onto the Track View.
Note
Because of the click and drag workflows, you typically won’t ever need to manually edit the Parameters in a Load Asset stage.
Standard Parameters¶
Excluded Streams: This dropdown allows you to choose one or more stream types from the clip to exclude from this Load Asset stage. This way, when you import multiple streams in a single clip (such as textures and audio in a single video, or meshes and textures in separate file sequences) you can choose to add only some of that data to the composition. To exclude a type of data, select an interval in your load asset stage, then expand the Excluded Streams dropdown to reveal each stream in the current clip. Select an item to exclude that data stream, or select an excluded item to include it. Multiple data streams can be excluded by selecting one after another.
Two additional parameters are provided for advanced configuration. Typically, Clips should be added to Load Asset Stages by dragging your Clip from the project view onto the Timeline or Track, rather than through setting these values directly
AssetID: This specifies the loaded Clip. To change the Asset ID, click and drag a Clip from the Project view into your load asset Stage’s asset ID field
Clip Offset: This sets the offset of the interval in Ticks. Each tick is one 200th of a frame.
Audio Parameters¶
Audio parameters are displayed at the bottom of the inspector. Audio parameters are only visible when an interval containing audio data is selected.
Volume (db): The volume in decibels of the audio track.
Fade In Length (s): Set a fade in length in seconds. Starting at the beginning of the interval, audio will linearly fade in for this many seconds. Accepts fractional inputs, like 0.05.
Fade Out Length (s): Set a fade out length in seconds. Starting this many seconds before the end of the interval, audio will linearly fade out until the end of the interval. Accepts fractional inputs, like 0.05.
Working with Load Asset¶
Each new Track in a composition will begin with a load asset Stage to load a new Clip for editing, and depending on the needs of your project you may use more load asset Stages later on to add in extra Clip data or re-introduce data that has been edited outside of HoloEdit, such as using a load asset Stage to update textures that were modified in external software.
If you need to manually configure a load Asset, keep in mind that new Load Asset stages have the ‘clip offset’ value set to 0. This means that if you add a clip to that load asset stage, any timing information in the clip will correspond directly to time duration of any individual interval.
For example, if your clip starts at frame 70, any interval frames 0-70 will not contain your data. Increasing the clip offset will shift the clip backwards, until at a value of 14000 the 70th clip-frame would be the first frame in the interval.
Note
Streams loaded from Load Asset Stages replace any existing samples of the same type present higher in a Track, but otherwise Load Asset stages are additive.
For example, to produce a textured mesh, you could load a clip containing both textures and meshes, or you could load two separate clips – one with meshes, and one with textures – via two load asset stages.
If you wish to pass through some data from earlier in the track that would typically be replaced by your Load Asset stage, take advantage of the Excluded Streams parameter to filter out certain data from your clip.