Skip to content

Assets: blur key of an image's .ini, SVG images by default #327

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JohnAmadis merged 1 commit into from
Oct 5, 2026
Merged

Assets: blur key of an image's .ini, SVG images by default #327

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/cmake-functions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -337,7 +337,7 @@ The following variables should be set before calling `dmod_add_executable` or `d
- `DMOD_COMPRESSION_METHOD` - Compression method for DMFC files (default: "fastlz")
- `DMOD_ASSETS_PATHS` - List of directories with the sources of a module's assets (views, images, fonts). When set, they are converted into `DMOD_VIEWS_DIR` (default: `<build>/views`) by the `dmod_assets` target, which the module depends on - with tools `dmf-get` downloads at configure time, only for the kinds of files found:
- `*.dmvs` views - `todmv` - `<name>.dmv`;
- images (`DMOD_IMAGE_EXTENSIONS`, default `png jpg jpeg jpe jfif bmp qoi gif tif tiff`) - `todmvi` with the `dmimg` decoder of each extension (`dmimg_png`, `dmimg_jpeg` for `.jpg`, ...; `DMOD_IMAGE_DECODERS` overrides the list) - `<name>.dmvi`, next to the views, so a view finds them by name. An optional `<image>.ini` next to an image (`logo.png.ini`) sets its conversion: `format` (`auto`, `rgb565`, `rgb565a8`, `argb8888`, `i8`, `a8`, `a4`), `size` (`WIDTHxHEIGHT`, scaled down to fit), `compression` (`fastlz`, `none`), `dither` (`on`/`off`). Keys before any section apply to every output; each `[section]` is an output `<section>.dmvi` of its own (e.g. `[logo]` and `[logo-mask]` from one image).
- images (`DMOD_IMAGE_EXTENSIONS`, default `png jpg jpeg jpe jfif bmp qoi gif tif tiff svg`) - `todmvi` with the `dmimg` decoder of each extension (`dmimg_png`, `dmimg_jpeg` for `.jpg`, ...; `DMOD_IMAGE_DECODERS` overrides the list) - `<name>.dmvi`, next to the views, so a view finds them by name. An optional `<image>.ini` next to an image (`logo.png.ini`) sets its conversion: `format` (`auto`, `rgb565`, `rgb565a8`, `argb8888`, `i8`, `a8`, `a4`), `size` (`WIDTHxHEIGHT`, scaled down to fit), `compression` (`fastlz`, `none`), `dither` (`on`/`off`), `blur` (pixels: a Gaussian blur of that standard deviation, after scaling). Keys before any section apply to every output; each `[section]` is an output `<section>.dmvi` of its own (e.g. `[logo]` and `[logo-mask]` from one image).
- fonts (`DMOD_FONT_EXTENSIONS`, default `ttf otf ttc`) - `todmvf` - `.dmvf`, next to the views. A font needs its `<font>.ini` (`Roboto-Regular.ttf.ini`), as a font is made for one pixel size: each `[section]` is an output `<section>.dmvf` with its `size` (pixel size, `4` ... `127`, required) and optional `chars` (codepoint ranges, e.g. `0x20-0x7E,0x104`; default: printable ASCII, Latin-1, Latin Extended-A) and `tracking` (letter spacing added to every advance, in pixels, e.g. `-2.4`, like CSS `letter-spacing`). A font without an `.ini` is left out with a warning.

Two sources of one output name are a configuration error.
Expand Down
12 changes: 9 additions & 3 deletions scripts/CMakeLists.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,6 +209,7 @@ endfunction()
# size = WIDTHxHEIGHT (scaled down to fit), WIDTHx, xHEIGHT
# compression = fastlz | ... | none
# dither = on | off
# blur = pixels - a Gaussian blur of that standard deviation, after scaling
#
# A font needs its <font>.ini (e.g. Roboto-Regular.ttf.ini), the same way:
# a font is made for one pixel size, so each output has one - each
Expand All @@ -228,7 +229,7 @@ endfunction()
# DMOD_LOADER dmod_loader executable that runs the tools
# (default: searched in tools dir and PATH)
# DMOD_IMAGE_EXTENSIONS image file extensions (default: png jpg jpeg jpe
# jfif bmp qoi gif tif tiff)
# jfif bmp qoi gif tif tiff svg)
# DMOD_IMAGE_DECODERS decoder modules to download (default:
# dmimg_<format> of each extension found)
# DMOD_FONT_EXTENSIONS font file extensions (default: ttf otf ttc)
Expand Down Expand Up @@ -285,6 +286,11 @@ function(_dmod_image_option iniPath key value outVar)
set(ARGS -s ${value})
elseif(key STREQUAL "compression")
set(ARGS -c ${value})
elseif(key STREQUAL "blur")
if(NOT value MATCHES "^[0-9]+$")
message(SEND_ERROR "${iniPath}: blur is a number of pixels, e.g. 8 (got '${value}')")
endif()
set(ARGS -b ${value})
elseif(key STREQUAL "dither")
string(TOLOWER "${value}" V)
if(V MATCHES "^(off|no|false|0)$")
Expand All @@ -293,7 +299,7 @@ function(_dmod_image_option iniPath key value outVar)
message(SEND_ERROR "${iniPath}: dither is on or off, not '${value}'")
endif()
else()
message(SEND_ERROR "${iniPath}: unknown key '${key}' (format, size, compression, dither)")
message(SEND_ERROR "${iniPath}: unknown key '${key}' (format, size, compression, dither, blur)")
endif()
set(${outVar} "${ARGS}" PARENT_SCOPE)
endfunction()
Expand Down Expand Up @@ -415,7 +421,7 @@ function(dmod_setup_assets moduleName)
set(DMOD_VIEWS_TOOLS_NAME "arch/x86_64")
endif()
if(NOT DEFINED DMOD_IMAGE_EXTENSIONS OR "${DMOD_IMAGE_EXTENSIONS}" STREQUAL "")
set(DMOD_IMAGE_EXTENSIONS png jpg jpeg jpe jfif bmp qoi gif tif tiff)
set(DMOD_IMAGE_EXTENSIONS png jpg jpeg jpe jfif bmp qoi gif tif tiff svg)
endif()
if(NOT DEFINED DMOD_FONT_EXTENSIONS OR "${DMOD_FONT_EXTENSIONS}" STREQUAL "")
set(DMOD_FONT_EXTENSIONS ttf otf ttc)
Expand Down
Loading