GS_MotionAsset

Abstract base for motion data assets — holds track definitions and creates runtime composites.
Categories:
Tags:

GS_MotionAsset is the abstract base class for motion data assets. Domain gems extend this with their own asset type and file extension — GS_UI creates UiAnimationMotionAsset (.uiam), GS_Juice creates FeedbackMotionAsset (.feedbackmotion). Assets are created and edited in the O3DE Asset Editor.

Extends AZ::Data::AssetData. All subclasses require GS_AssetReflectionIncludes.h in their header — see Serialization Helpers.

For usage guides and setup examples, see The Basics: GS_Core.

API Reference

MethodReturnsDescription
GetTrackInfosvector<GS_TrackInfo>Returns track UUID + label pairs for proxy list synchronization in the editor.
CreateRuntimeCompositeGS_MotionComposite*Factory — deep-copies all asset tracks into a new runtime GS_MotionComposite instance.

GS_TrackInfo

Lightweight struct used for proxy synchronization between asset tracks and instance proxy lists.

FieldTypeDescription
idAZ::UuidTrack identifier (matches the track’s m_id).
labelAZStd::stringTrack display name (from GetTypeName()).

Domain Extensions

DomainGemAsset ClassExtensionTracks
UI AnimationGS_UIUiAnimationMotionAsset.uiam8 LyShine-specific tracks
FeedbackGS_JuiceFeedbackMotionAsset.feedbackmotion2 feedback tracks

Extension Guide

To create a new domain asset type:

  1. Create class MyAsset : public GS_Core::GS_MotionAsset with vector<MyDomainTrack*> m_tracks. Include GS_AssetReflectionIncludes.h in your asset’s header — see Serialization Helpers.
  2. Implement GetTrackInfos() — iterate tracks and return UUID + label pairs.
  3. Implement CreateRuntimeComposite() — deep-copy tracks into a new GS_MotionComposite.
  4. Register the asset type in your gem’s DataAssetsSystemComponent.
  5. Add a .setreg entry for the asset processor to recognize your file extension.

Critical: Track vectors must use raw pointers (vector<MyTrack*>). O3DE SerializeContext requires raw pointers for polymorphic enumeration.

See Also

Get GS_Core

GS_Core — Explore this gem on the product page and add it to your project.