2021-06-23 14:58:44 +00:00
|
|
|
# Requirements
|
|
|
|
|
|
|
|
- Python3
|
2022-06-26 12:00:03 +00:00
|
|
|
- Python3 packages: Pillow & heatshrink2
|
2021-06-23 14:58:44 +00:00
|
|
|
|
|
|
|
# Compiling
|
|
|
|
|
2021-08-17 10:38:47 +00:00
|
|
|
```bash
|
2022-06-26 12:00:03 +00:00
|
|
|
./fbt icons proto dolphin_internal dolphin_blocking dolphin_ext resources
|
2021-08-17 10:38:47 +00:00
|
|
|
```
|
2021-06-23 14:58:44 +00:00
|
|
|
|
2020-10-26 17:00:17 +00:00
|
|
|
# Asset naming rules
|
|
|
|
|
|
|
|
## Images and Animations
|
|
|
|
|
|
|
|
`NAME_VARIANT_SIZE`
|
|
|
|
|
|
|
|
- `NAME` - mandatory - Asset name in CamelCase. [A-Za-z0-9], special symbols not allowed
|
|
|
|
- `VARIANT` - optional - icon variant: can relate to state or rendering conditions. Examples: active, inactive, inverted.
|
2021-11-30 23:53:53 +00:00
|
|
|
- `SIZE` - mandatory - size in px. Example square 10, 20, 24, etc. Example rectangular: 10x8, 19x5, etc.
|
2020-10-26 17:00:17 +00:00
|
|
|
|
|
|
|
Image names will be automatically prefixed with `I_`, animation names with `A_`.
|
|
|
|
Icons and Animations will be gathered into `icon.h` and `icon.c`.
|
|
|
|
|
2022-01-02 21:39:56 +00:00
|
|
|
## 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/
|
|
|
|
|
2020-10-26 17:00:17 +00:00
|
|
|
# Important notes
|
|
|
|
|
2021-11-30 23:53:53 +00:00
|
|
|
Don't include assets that you are not using, compiler is not going to strip unused assets.
|
2020-10-26 17:00:17 +00:00
|
|
|
|
2022-01-10 19:46:20 +00:00
|
|
|
# Structure
|
2022-08-05 15:12:13 +00:00
|
|
|
- `compiled` - Output folder made for compiled assets, after building project, in `build` directory.
|
|
|
|
- `dolphin` - Dolphin game assets sources. Goes to `compiled` and `resources` folders in `build` directory.
|
|
|
|
- `icons` - Icons sources. Goes to `compiled` folder in `build` directory.
|
|
|
|
- `protobuf` - Protobuf sources. Goes to `compiled` folder in `build` directory.
|
2022-01-10 19:46:20 +00:00
|
|
|
- `resources` - Assets that is going to be provisioned to SD card.
|
2022-08-05 15:12:13 +00:00
|
|
|
- `slideshow` - One-time slideshows for desktop
|
|
|
|
- `unit_tests` - Some pre-defined signals for testing purposes.
|