9bf11d9fd2
* fbt: assets builder for apps WIP * fbt: automatically building private fap assets * docs: details on how to use image assets * fbt: renamed fap_assets -> fap_icons * fbt: support for fap_extbuild field * docs: info on fap_extbuild * fbt: added --proxy-env parame ter * fbt: made firmware_cdb & updater_cdb targets always available * fbt: renamed fap_icons -> fap_icon_assets * fbt: deprecated firmware_* target names for faps; new alias is "fap_APPID" * fbt: changed intermediate file locations for external apps * fbt: support for fap_private_libs; docs: updates * restored mbedtls as global lib * scripts: lint.py: skip "lib" subfolder * fbt: Sanity checks for building advanced faps as part of fw * docs: info on fap_private_libs; fbt: optimized *.fam indexing * fbt: cleanup; samples: added sample_icons app * fbt: moved example app to applications/examples * linter fix * docs: readme fixes * added applications/examples/application.fam stub * docs: more info on private libs Co-authored-by: あく <alleteam@gmail.com> |
||
|---|---|---|
| .. | ||
| dolphin | ||
| icons | ||
| protobuf@6727eaf287 | ||
| resources | ||
| slideshow | ||
| unit_tests | ||
| .gitignore | ||
| ReadMe.md | ||
| SConscript | ||
Requirements
- Python3
- Python3 packages: Pillow & heatshrink2
Compiling
./fbt icons proto dolphin_internal dolphin_blocking dolphin_ext resources
Asset naming rules
Images and Animations
NAME_VARIANT_SIZE
NAME- mandatory - Asset name in CamelCase. [A-Za-z0-9], special symbols not allowedVARIANT- optional - icon variant: can relate to state or rendering conditions. Examples: active, inactive, inverted.SIZE- mandatory - size in px. Example square 10, 20, 24, etc. Example rectangular: 10x8, 19x5, etc.
Image names will be automatically prefixed with I_, animation names with A_.
Icons and Animations will be gathered into icon.h and icon.c.
Dolphin and Games assets
Rules are same as for Images and Animations plus assets are grouped by level and level prepends NAME.
Good starting point: https://docs.unrealengine.com/4.27/en-US/ProductionPipelines/AssetNaming/
Important notes
Don't include assets that you are not using, compiler is not going to strip unused assets.
Structure
compiled- Output folder made for compiled assets, after building project, inbuilddirectory.dolphin- Dolphin game assets sources. Goes tocompiledandresourcesfolders inbuilddirectory.icons- Icons sources. Goes tocompiledfolder inbuilddirectory.protobuf- Protobuf sources. Goes tocompiledfolder inbuilddirectory.resources- Assets that is going to be provisioned to SD card.slideshow- One-time slideshows for desktopunit_tests- Some pre-defined signals for testing purposes.