o3de / o3de.org

The O3DE website
Other
86 stars 161 forks source link

[ISSUE][DOCS] Asset types list is incomplete #1317

Open AMZN-stankowi opened 2 years ago

AMZN-stankowi commented 2 years ago

Describe the issue

The asset types page here https://o3de.org/docs/user-guide/assets/asset-types/ is incomplete

Here is a more complete list of source assets supported by the engine and gems:

Note that this list will change. You can generate an updated list by looking at all patterns matched by all asset builders, and the list of copy jobs.

Impacted page(s)

https://o3de.org/docs/user-guide/assets/asset-types/

Expected experience

The asset types page lists all assets.

AMZN-stankowi commented 2 years ago

You can find all asset builders by searching for usage of AssetBuilderSDK::AssetBuilderDesc. This is the structure used to register each builder, and includes the pattern(s) to register that builder against.

Here's an example: https://github.com/o3de/o3de/blob/development/Gems/EMotionFX/Code/EMotionFX/Pipeline/EMotionFXBuilder/AnimGraphBuilderWorker.cpp#L27

You can find most of the copy jobs in AssetProcessorPlatformConfig.setreg. There are probably others that I missed in generating the above list. Here's where mp4's copy job is defined https://github.com/o3de/o3de/blob/development/Registry/AssetProcessorPlatformConfig.setreg#L277

willihay commented 2 years ago

Per discussion with @AMZN-stankowi, also add breakdowns for the assets that have misleading extensions: xml, json, etc, where the extension doesn't actually properly describe what data is stored there.

willihay commented 2 years ago

Also be sure to add info on how to use the product assets, where applicable.