svg2many 0.3.0__tar.gz

svg2many-0.3.0/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025, Alexander Iurovetski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

svg2many-0.3.0/MANIFEST.in

@@ -0,0 +1,5 @@
+graft examples
+include LICENSE.txt
+include README.md
+
+prune tests

svg2many-0.3.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: svg2many
+Version: 0.3.0
+Summary: Export a single SVG to raster images of multiple resolutions
+Author-email: Alexander Iurovetski <aiurovet@gmail.com>
+Maintainer-email: Alexander Iurovetski <aiurovet@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/aiurovet/svg2many
+Project-URL: Repository, https://github.com/aiurovet/svg2many.git
+Project-URL: Documentation, https://github.com/aiurovet/svg2many/blob/main/README.md
+Project-URL: Changelog, https://github.com/aiurovet/svg2many/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/aiurovet/svg2many/issues
+Keywords: image,svg,raster,svg2many,png,webp
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: envara>=0.5.1
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-mock; extra == "dev"
+Requires-Dist: coverage; extra == "dev"
+Dynamic: license-file
+
+# svg2many (C) Alexander Iurovetski 2025
+
+## Convert an SVG file to raster images of multiple sizes, optionally splitting into background and foreground images
+
+This application allows to produce all raster images you need (`.png`, `.webp`, or others) from a single `.svg` file. It is based on search-and-replace of the width, height and the presence of foreground and background in the content of the source file. The main idea is that since the `SVG` format is text (XML), there is a rational way to find spots where the default width, height, scale, offset and visibility should be substituted with required ones.
+
+Dependencies: `envara`.
+
+Pre-requisites (external dependencies):
+
+1. An exporter from an `.svg` to a raster image file (`.png`, `.webp`, or others). This could be even your browser running in the headless mode, like _Chromium_-based one (Google Chrome, Microsoft Edge, Opera, Vivaldi, etc.) or _Firefox-based_ (Firefox, Tor, LibreWolf, etc.). The preferred exporter, however, is `rsvg-convert` from the GNOME's `librsvg2`. Depending on the OS you are running, it can be installed via `apt`, `yum`, `brew` or `chocolatey`. This exporter is faster than any headless browser or tools like `ImageMagick` or `Inkscape`, and produces images of good quality.
+
+2. A converter from a set of raster images to `.ico` if you need to generate Windows native icons. Preferred converter is ImageMagick's `magick` (see the examples). You'll use that in the `after` attribute of configuration file.
+
+3. There is no converter from a set of raster image files to a single `.icns` one, as the latter is deprecated by Apple (still supported for the sake of legacy though). That's why the examples for Flutter and macOS application icons do not utilise that. You are welcome to utilise that in your configuration files if you like. Please note however, that I had issues adding a 64x64 image to `.icns` using `png2icns` on Linux, and decided it is not worth the effort.
+
+### Usage
+
+This example can be used to generate all launcher icons for a _Flutter_ project. See also: _How Do I Use It_ at the end of this document
+
+1. Install `svg2many` from _PyPI_
+
+2. Create your beautiful SVG image. It is highly recommended NOT to use percentages as co-ordinates or sizes: those are getting scaled inconsistently, and so far, I have no solution that does not attempt a full-scale to parseing of an SVG. You can define a 100x100 pixel image that will essentially express the same. Example:
+
+   ```xml
+   <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+     <g class="background" display="" transform="scale(1, 1) translate(0, 0)">
+       <!--Place your actual background drawing here-->
+     </g>
+     <g class="foreground" display="" transform="scale(1, 1) translate(0, 0)">
+       <!--Place your actual foreground drawing here-->
+     </g>
+   </svg>
+   ```
+
+3. Create configuration file or take that from `examples/` in the application bundle or from the [repo's examples](https://github.com/aiurovet/svg2many/tree/main/examples)
+
+4. Create `.env` file(s) or take those from `examples/` if you need. You can skip this step and make decision later.
+
+5. Ensure the installation directory for `svg2many` is listed in `PATH` (or use an explicit path inside a wrapper script).
+
+6. Run with options in any order:
+
+   ```
+   svg2many -c (your-config-file) [-r (top-dir)] [-i (input-svg)]
+   ```
+
+All options:
+
+- `-h, --help`
+
+   Help screen (similar to this list)
+
+- `-c, --config CONFIG`
+
+   A file in JSON format that holds rules of conversion (see full description below). This setting is mandatory.
+
+- `-d, --delete`
+
+   Delete all generated files, but not directories.
+
+- `-e, --env ENV`
+
+   A text file containing lines in the `name = value` format with any number of spaces in between: `CMD_RSVG="rsvg-convert"`, then `CMD_RSVG_OUT_FILE="$CMD_RSVG --output {o}"`. It allows you to define extra environment variables to use in different configuration files. You can put there comments as well (starting with #). The application will load the content from `.env`, then `any.env`, then `posix.env` on POSIX-compatible OSes (Linux, BSD, macOS, AIX), then `bsd.env` (for FreeBSD, NetBSD, etc.), then `<OS>.env` (\<OS\> is what Python's `platform.system()` call returns, or also `macos.env` on macOS). On Windows, it would be `.env`, `windows.env`, Then, if this option is specified, that particular file. The order is important: from generic to more and more specific ones, having the later similar value overriding the earlier one. All these files will be scanned and taken from either the directory of the specified ENV or the config file's one otherwise. You do not have to have them all: the application will pick only those that are present without any warning or error that some are missing. This approach allows you to make portable (OS-independent) conversions if you need. For instance, generating images under GitHub actions, you have a luxury of automatic choice: $HOME on UNIX-like systems, $USERPROFILE on Windows, speciific paths to exporters on macOS like _"Applications/Google Chrome.app/Contents/MacOS/Google Chrome"_, and _google-chrome_ on Linux.
+
+- `-i, --input INPUT`
+
+   An `.svg` file to convert. If INPUT is a mere - (dash), the SVG content will be read from `stdin`. Overrides `inpFile` in the configuration file.
+
+- `-q, --quiet`
+
+   Do not print any information to the console. Mutually exclusive with `-v, --verbose`.
+
+- `-r, --root ROOT`
+
+   Project top directory for all relative paths. Overrides `rootDir` in the configuration file.
+
+- `-v, --verbose`
+
+   Detailed logging, primarily, to trace issues. Mutually exclusive with `-q` or `--quiet`.
+
+The default SVG-to-raster exporter is `rsvg-convert` (to PNG), created and maintained by the GNOME project. This is the fastest and accurate way to create raster images. If you need to export to another raster image format, there is a good chance you can do that by directing the output to `stdout`, then reading into the next exporter via `stdin` (piping). See the `export` attribute in th sample configuration files.
+
+ImageMagick and Inkscape are less performant, and also earlier, were producing images of lower quality. It looks like this area was improved. However, when I tried to use ImageMagick's `convert`, it failed. After I installed Inkscape, it suddenly started working. Please verify yourself if you would like to use it. My own preference, though, is `rsvg-convert`
+
+Headless Chrome is another option: it supports more SVG features, but runs slower. More importantly, it is frequently broken (and it is now, as of December 2025, on Kubuntu 25.04), and the fix might take a while to come. To my memory, it was broken at least twice within a few years. The issues, in fact, were in Chromium, which is even worse, as it impacts a wider range of browsers.
+
+Last but not least comes headless Firefox. As of December 2025, on Kubuntu 25.04, it seems to have an issue similar to Chromium. It is by far the slowest one, as it is not cached like the Chromium-based browsers. It will fail when another instance is open (e.g. you are viewing a website with it). Also, it will fail to export when SVG content is sent via stdin rather than a file, so you must use `{i}` in the command.
+
+Please note that most of these exporters convert SVG to PNG only
+
+## JSON Configuration File Format
+
+### Nodes
+
+- `$.after`, `$.targets.target.after`
+
+  Default command to run upon completion of all exports in a target (like `convert` for Windows icons). The latter overrides the former.
+
+- `$.export`, `$.targets.target.export`
+
+  Command to export an input SVG image to an output raster image file. The latter overrides the former. Might be useful to generate `webp` icons for `Android` icons specifically.
+
+- `$.rootDir`
+
+  Top directory for the input and output files. Can be overridden by the `-r ROOT` option with argument
+
+- `$.inpFile`
+
+  Input SVG file. Can be overridden by the `-i INPUT` option with argument
+
+- `$.bkgClass`, `$.targets.target.bkgClass`
+
+  CSS class to detect background. Default for the former: "background". The latter overrides the former.
+
+- `$.frgClass`, `$.targets.target.frgClass`
+
+  CSS class to detect foreground. Default for the former: "foreground". The latter overrides the former.
+
+- `$.outType`, `$.targets.target.outType`
+
+  The output file type (no leading dot): png, webp, etc. The latter overrides the former.
+
+- `$.targets`
+
+  Array of rules for each output image file defined as follows:
+
+- `$.targets.target.title`
+
+  Plain text to log the progress
+
+- `$.targets.target.delete`
+
+  If `true`, delete all files listed under the target (useful if, for instance, all images have been converted to a single `.ico` file)
+
+- `$.targets.target.outDir`
+
+  Output sub-directory (relative to the top-level `rootDir`) or an absolute path
+
+- `$.targets.target.output`
+
+  Array of the output dimensions and filenames (under `outDir` or a path)
+
+- `$.targets.target.output.size`
+
+  Dimensions in pixels of the background as a single number (square) or `WxH` (rectangle).It migt be followed by dimensions of the foreground. Use space(s) to separate foreground size from the background one.
+
+- `$.targets.target.output.file`
+
+  Name of the output image file (sub-path relative to `outDir`)
+
+### Placeholders to use in commands
+
+Do not wrap those in quotes unless necessary, and not for being "safe" with possible spaces inside:
+
+- `{i}`
+
+  Input (SVG) file path as passed to the utility, if not present in the full command, the content will be fed to the respective application via pipe
+
+- `{n}`
+
+  Input filename without type (extension). When having multiple, without any: up to the first dot.
+
+- `{o}`
+
+  Current output file path.
+
+- `{t}`
+
+  Current output file type defined in `outType`.
+
+- `{w}`
+
+  Current output image width: largest of two widths (background and foreground).
+
+- `{h}`
+
+  Current output image height: largest of two heights (background and foreground).
+
+### Extra Expansions
+
+References to the environment variables will be expanded:
+
+- Portable: `$ABC`, `${ABC:-$DEF}`.
+- Windows: `%ABC%`.
+
+References to the arguments passed to the script will be also expanded:
+
+- Portable: `$1`, `${2:-abc}`.
+- Windows: `%1`, `%2`.
+
+## __Good Luck!__

svg2many-0.3.0/README.md

@@ -0,0 +1,192 @@
+# svg2many (C) Alexander Iurovetski 2025
+
+## Convert an SVG file to raster images of multiple sizes, optionally splitting into background and foreground images
+
+This application allows to produce all raster images you need (`.png`, `.webp`, or others) from a single `.svg` file. It is based on search-and-replace of the width, height and the presence of foreground and background in the content of the source file. The main idea is that since the `SVG` format is text (XML), there is a rational way to find spots where the default width, height, scale, offset and visibility should be substituted with required ones.
+
+Dependencies: `envara`.
+
+Pre-requisites (external dependencies):
+
+1. An exporter from an `.svg` to a raster image file (`.png`, `.webp`, or others). This could be even your browser running in the headless mode, like _Chromium_-based one (Google Chrome, Microsoft Edge, Opera, Vivaldi, etc.) or _Firefox-based_ (Firefox, Tor, LibreWolf, etc.). The preferred exporter, however, is `rsvg-convert` from the GNOME's `librsvg2`. Depending on the OS you are running, it can be installed via `apt`, `yum`, `brew` or `chocolatey`. This exporter is faster than any headless browser or tools like `ImageMagick` or `Inkscape`, and produces images of good quality.
+
+2. A converter from a set of raster images to `.ico` if you need to generate Windows native icons. Preferred converter is ImageMagick's `magick` (see the examples). You'll use that in the `after` attribute of configuration file.
+
+3. There is no converter from a set of raster image files to a single `.icns` one, as the latter is deprecated by Apple (still supported for the sake of legacy though). That's why the examples for Flutter and macOS application icons do not utilise that. You are welcome to utilise that in your configuration files if you like. Please note however, that I had issues adding a 64x64 image to `.icns` using `png2icns` on Linux, and decided it is not worth the effort.
+
+### Usage
+
+This example can be used to generate all launcher icons for a _Flutter_ project. See also: _How Do I Use It_ at the end of this document
+
+1. Install `svg2many` from _PyPI_
+
+2. Create your beautiful SVG image. It is highly recommended NOT to use percentages as co-ordinates or sizes: those are getting scaled inconsistently, and so far, I have no solution that does not attempt a full-scale to parseing of an SVG. You can define a 100x100 pixel image that will essentially express the same. Example:
+
+   ```xml
+   <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100">
+     <g class="background" display="" transform="scale(1, 1) translate(0, 0)">
+       <!--Place your actual background drawing here-->
+     </g>
+     <g class="foreground" display="" transform="scale(1, 1) translate(0, 0)">
+       <!--Place your actual foreground drawing here-->
+     </g>
+   </svg>
+   ```
+
+3. Create configuration file or take that from `examples/` in the application bundle or from the [repo's examples](https://github.com/aiurovet/svg2many/tree/main/examples)
+
+4. Create `.env` file(s) or take those from `examples/` if you need. You can skip this step and make decision later.
+
+5. Ensure the installation directory for `svg2many` is listed in `PATH` (or use an explicit path inside a wrapper script).
+
+6. Run with options in any order:
+
+   ```
+   svg2many -c (your-config-file) [-r (top-dir)] [-i (input-svg)]
+   ```
+
+All options:
+
+- `-h, --help`
+
+   Help screen (similar to this list)
+
+- `-c, --config CONFIG`
+
+   A file in JSON format that holds rules of conversion (see full description below). This setting is mandatory.
+
+- `-d, --delete`
+
+   Delete all generated files, but not directories.
+
+- `-e, --env ENV`
+
+   A text file containing lines in the `name = value` format with any number of spaces in between: `CMD_RSVG="rsvg-convert"`, then `CMD_RSVG_OUT_FILE="$CMD_RSVG --output {o}"`. It allows you to define extra environment variables to use in different configuration files. You can put there comments as well (starting with #). The application will load the content from `.env`, then `any.env`, then `posix.env` on POSIX-compatible OSes (Linux, BSD, macOS, AIX), then `bsd.env` (for FreeBSD, NetBSD, etc.), then `<OS>.env` (\<OS\> is what Python's `platform.system()` call returns, or also `macos.env` on macOS). On Windows, it would be `.env`, `windows.env`, Then, if this option is specified, that particular file. The order is important: from generic to more and more specific ones, having the later similar value overriding the earlier one. All these files will be scanned and taken from either the directory of the specified ENV or the config file's one otherwise. You do not have to have them all: the application will pick only those that are present without any warning or error that some are missing. This approach allows you to make portable (OS-independent) conversions if you need. For instance, generating images under GitHub actions, you have a luxury of automatic choice: $HOME on UNIX-like systems, $USERPROFILE on Windows, speciific paths to exporters on macOS like _"Applications/Google Chrome.app/Contents/MacOS/Google Chrome"_, and _google-chrome_ on Linux.
+
+- `-i, --input INPUT`
+
+   An `.svg` file to convert. If INPUT is a mere - (dash), the SVG content will be read from `stdin`. Overrides `inpFile` in the configuration file.
+
+- `-q, --quiet`
+
+   Do not print any information to the console. Mutually exclusive with `-v, --verbose`.
+
+- `-r, --root ROOT`
+
+   Project top directory for all relative paths. Overrides `rootDir` in the configuration file.
+
+- `-v, --verbose`
+
+   Detailed logging, primarily, to trace issues. Mutually exclusive with `-q` or `--quiet`.
+
+The default SVG-to-raster exporter is `rsvg-convert` (to PNG), created and maintained by the GNOME project. This is the fastest and accurate way to create raster images. If you need to export to another raster image format, there is a good chance you can do that by directing the output to `stdout`, then reading into the next exporter via `stdin` (piping). See the `export` attribute in th sample configuration files.
+
+ImageMagick and Inkscape are less performant, and also earlier, were producing images of lower quality. It looks like this area was improved. However, when I tried to use ImageMagick's `convert`, it failed. After I installed Inkscape, it suddenly started working. Please verify yourself if you would like to use it. My own preference, though, is `rsvg-convert`
+
+Headless Chrome is another option: it supports more SVG features, but runs slower. More importantly, it is frequently broken (and it is now, as of December 2025, on Kubuntu 25.04), and the fix might take a while to come. To my memory, it was broken at least twice within a few years. The issues, in fact, were in Chromium, which is even worse, as it impacts a wider range of browsers.
+
+Last but not least comes headless Firefox. As of December 2025, on Kubuntu 25.04, it seems to have an issue similar to Chromium. It is by far the slowest one, as it is not cached like the Chromium-based browsers. It will fail when another instance is open (e.g. you are viewing a website with it). Also, it will fail to export when SVG content is sent via stdin rather than a file, so you must use `{i}` in the command.
+
+Please note that most of these exporters convert SVG to PNG only
+
+## JSON Configuration File Format
+
+### Nodes
+
+- `$.after`, `$.targets.target.after`
+
+  Default command to run upon completion of all exports in a target (like `convert` for Windows icons). The latter overrides the former.
+
+- `$.export`, `$.targets.target.export`
+
+  Command to export an input SVG image to an output raster image file. The latter overrides the former. Might be useful to generate `webp` icons for `Android` icons specifically.
+
+- `$.rootDir`
+
+  Top directory for the input and output files. Can be overridden by the `-r ROOT` option with argument
+
+- `$.inpFile`
+
+  Input SVG file. Can be overridden by the `-i INPUT` option with argument
+
+- `$.bkgClass`, `$.targets.target.bkgClass`
+
+  CSS class to detect background. Default for the former: "background". The latter overrides the former.
+
+- `$.frgClass`, `$.targets.target.frgClass`
+
+  CSS class to detect foreground. Default for the former: "foreground". The latter overrides the former.
+
+- `$.outType`, `$.targets.target.outType`
+
+  The output file type (no leading dot): png, webp, etc. The latter overrides the former.
+
+- `$.targets`
+
+  Array of rules for each output image file defined as follows:
+
+- `$.targets.target.title`
+
+  Plain text to log the progress
+
+- `$.targets.target.delete`
+
+  If `true`, delete all files listed under the target (useful if, for instance, all images have been converted to a single `.ico` file)
+
+- `$.targets.target.outDir`
+
+  Output sub-directory (relative to the top-level `rootDir`) or an absolute path
+
+- `$.targets.target.output`
+
+  Array of the output dimensions and filenames (under `outDir` or a path)
+
+- `$.targets.target.output.size`
+
+  Dimensions in pixels of the background as a single number (square) or `WxH` (rectangle).It migt be followed by dimensions of the foreground. Use space(s) to separate foreground size from the background one.
+
+- `$.targets.target.output.file`
+
+  Name of the output image file (sub-path relative to `outDir`)
+
+### Placeholders to use in commands
+
+Do not wrap those in quotes unless necessary, and not for being "safe" with possible spaces inside:
+
+- `{i}`
+
+  Input (SVG) file path as passed to the utility, if not present in the full command, the content will be fed to the respective application via pipe
+
+- `{n}`
+
+  Input filename without type (extension). When having multiple, without any: up to the first dot.
+
+- `{o}`
+
+  Current output file path.
+
+- `{t}`
+
+  Current output file type defined in `outType`.
+
+- `{w}`
+
+  Current output image width: largest of two widths (background and foreground).
+
+- `{h}`
+
+  Current output image height: largest of two heights (background and foreground).
+
+### Extra Expansions
+
+References to the environment variables will be expanded:
+
+- Portable: `$ABC`, `${ABC:-$DEF}`.
+- Windows: `%ABC%`.
+
+References to the arguments passed to the script will be also expanded:
+
+- Portable: `$1`, `${2:-abc}`.
+- Windows: `%1`, `%2`.
+
+## __Good Luck!__

svg2many-0.3.0/examples/.env

@@ -0,0 +1,13 @@
+#
+# Common-base env file for portablility
+#
+# Defines common environment variables like HOME for the user home directory
+# Uses POSIX rules for the environment variables and CLI arguments expansion
+#
+
+HOME=${HOME:-${USERPROFILE:-${SYS\$LOGIN:-${UnixEnv\$HOME}}}}
+
+ARG_HEADLESS="--headless --disable-gpu --default-background-color=00000000 --window-size={w},{h} --screenshot={o} file://{i}"
+CMD_MAGICK="magick {i} {o}"
+CMD_RSVG="rsvg-convert"
+CMD_RSVG_TO_FILE="$CMD_RSVG --output {o}"

svg2many-0.3.0/examples/app-icons-android.json

@@ -0,0 +1,36 @@
+{
+  "help": [
+    "See app-icons-flutter.json"
+  ],
+  "envType": "POSIX",
+  "export": "$CMD_RSVG_TO_FILE",
+  "rootDir": "examples",
+  "inpFile": "assets/images/app_icon.svg",
+  "outType": "png",
+  "frgClass": null,
+  "bkgClass": null,
+  "targets": [{
+    "export": "$CMD_RSVG | cwebp -q 80 -o {o} -quiet -- -",
+    "outType": "webp",
+    "title": "Android app icons",
+    "outDir": "android/app/src/main/res",
+    "output": [
+      {"size": "     0       48", "file": "drawable-mdpi/ic_launcher_foreground.{t}"},
+      {"size": " 48x48        0", "file": "drawable-mdpi/ic_launcher_background.{t}"},
+      {"size": "     0       72", "file": "drawable-hdpi/ic_launcher_foreground.{t}"},
+      {"size": "    72      0x0", "file": "drawable-hdpi/ic_launcher_background.{t}"},
+      {"size": "   0x0       96", "file": "drawable-xhdpi/ic_launcher_foreground.{t}"},
+      {"size": "    96        0", "file": "drawable-xhdpi/ic_launcher_background.{t}"},
+      {"size": "     0      144", "file": "drawable-xxhdpi/ic_launcher_foreground.{t}"},
+      {"size": "   144        0", "file": "drawable-xxhdpi/ic_launcher_background.{t}"},
+      {"size": "     0  192x192", "file": "drawable-xxxhdpi/ic_launcher_foreground.{t}"},
+      {"size": "   192        0", "file": "drawable-xxxhdpi/ic_launcher_background.{t}"},
+
+      {"size": "   48", "file": "mipmap-mdpi/ic_launcher.{t}"},
+      {"size": "   72", "file": "mipmap-hdpi/ic_launcher.{t}"},
+      {"size": "96x96", "file": "mipmap-xhdpi/ic_launcher.{t}"},
+      {"size": "  144", "file": "mipmap-xxhdpi/ic_launcher.{t}"},
+      {"size": "  192", "file": "mipmap-xxxhdpi/ic_launcher.{t}"}
+    ]
+  }]
+}

svg2many-0.3.0/examples/app-icons-flutter.json

@@ -0,0 +1,137 @@
+{
+  "help": [
+    "",
+    "Nodes",
+    "",
+    "export    - default command to export an input SVG image to an output raster image file",
+    "after     - default command to run upon completion of all exports in a target (like conversion to .ico)",
+    "rootDir   - top directory for the input and output files (absolute or relative to the current one)",
+    "inpFile   - input SVG file (optional, might be passed explicitly as an arg)",
+    "bkgClass  - class to detect background (default: \"background\")",
+    "frgClass  - class to detect foreground (default: \"foreground\")",
+    "outType   - default output file type (no leading dot): png, webp, etc.",
+    "targets   - array of rules for each output image file defined as follows:",
+    "  export  - command to export an input SVG image to an output raster image file",
+    "  after   - command to run upon completion of all exports in a target (like conversion to .ico)",
+    "  title   - title of the current target (plain text to display)",
+    "  outDir  - output sub-directory of rootDir or an absolute path",
+    "  outType - the output file type (no leading dot): png, webp, etc.",
+    "  output  - array of the output dimensions and filenames (under outDir or a path)",
+    "  delete  - if 'true', delete all files listed under this target (useful if, for",
+    "            instance, all images have been converted to a single .ico file)",
+    "  size    - dimensions in pixels of the background as a single number (square) or",
+    "            WxH (rectangle); optionally followed by dimensions of the foreground;",
+    "            use space(s) to separate foreground size from the background one",
+    "  file    - name of the output image file, may contain a (sub-)directory",
+    "",
+    "Placeholders",
+    "",
+    "(do not wrap those in quotes unless necessary, and not for being \"safe\" with possible spaces inside)",
+    "",
+    "{i} - input (SVG) file path as passed to the utility, if not present in the full",
+    "      command, the SVG content will be fed to the respective application via pipe",
+    "{n} - input filename without type (extension), when having multiple, without any",
+    "{o} - current output file path",
+    "{t} - current output file type defined in outType",
+    "{w} - current output image width: largest of two widths",
+    "{h} - current output image height: largest of two heights",
+    "",
+    "Environment variables can be used in the UNIX format",
+    "Arguments passed to the script will be also expanded: use numbers in curly brackets",
+    ""
+  ],
+  "envType": "POSIX",
+  "export": "$CMD_RSVG_TO_FILE",
+  "rootDir": "~/Projects/$1/examples",
+  "inpFile": "assets/images/app_icon.svg",
+  "outType": "png",
+  "frgClass": null,
+  "bkgClass": null,
+  "targets": [{
+    "export": "$CMD_RSVG | cwebp -q 80 -o {o} -quiet -- -",
+    "outType": "webp",
+    "title": "Android app icons",
+    "outDir": "android/app/src/main/res",
+    "output": [
+      {"size": "     0       48", "file": "drawable-mdpi/ic_launcher_foreground.{t}"},
+      {"size": " 48x48        0", "file": "drawable-mdpi/ic_launcher_background.{t}"},
+      {"size": "     0       72", "file": "drawable-hdpi/ic_launcher_foreground.{t}"},
+      {"size": "    72      0x0", "file": "drawable-hdpi/ic_launcher_background.{t}"},
+      {"size": "   0x0       96", "file": "drawable-xhdpi/ic_launcher_foreground.{t}"},
+      {"size": "    96        0", "file": "drawable-xhdpi/ic_launcher_background.{t}"},
+      {"size": "     0      144", "file": "drawable-xxhdpi/ic_launcher_foreground.{t}"},
+      {"size": "   144        0", "file": "drawable-xxhdpi/ic_launcher_background.{t}"},
+      {"size": "     0  192x192", "file": "drawable-xxxhdpi/ic_launcher_foreground.{t}"},
+      {"size": "   192        0", "file": "drawable-xxxhdpi/ic_launcher_background.{t}"},
+
+      {"size": "   48", "file": "mipmap-mdpi/ic_launcher.{t}"},
+      {"size": "   72", "file": "mipmap-hdpi/ic_launcher.{t}"},
+      {"size": "96x96", "file": "mipmap-xhdpi/ic_launcher.{t}"},
+      {"size": "  144", "file": "mipmap-xxhdpi/ic_launcher.{t}"},
+      {"size": "  192", "file": "mipmap-xxxhdpi/ic_launcher.{t}"}
+    ]
+  }, {
+    "title": "iOS/iPadOS app icons",
+    "outDir": "ios/Runner/Assets.xcassets/AppIcon.appiconset",
+    "output": [
+      {"size": "   20", "file": "Icon-20x20@1x.{t}"},
+      {"size": "   40", "file": "Icon-20x20@2x.{t}"},
+      {"size": "   60", "file": "Icon-20x20@3x.{t}"},
+      {"size": "29x29", "file": "Icon-20x20@1x.{t}"},
+      {"size": "   58", "file": "Icon-29x29@2x.{t}"},
+      {"size": "   87", "file": "Icon-29x29@3x.{t}"},
+      {"size": "   80", "file": "Icon-40x40@2x.{t}"},
+      {"size": "  120", "file": "Icon-60x60@2x.{t}"},
+      {"size": "  180", "file": "Icon-60x60@3x.{t}"},
+      {"size": "   76", "file": "Icon-76x76@1x.{t}"},
+      {"size": "  152", "file": "Icon-76x76@2x.{t}"},
+      {"size": "  167", "file": "Icon-83.5x83.5@2x.{t}"},
+      {"size": " 1024", "file": "Icon-1024x1024@1x.{t}"}
+    ]
+  }, {
+    "title": "Linux app icon",
+    "outDir": "assets/images",
+    "output": [
+      {"size": "192", "file": "{n}.{t}"}
+    ]
+  }, {
+    "title": "macOS app icons",
+    "outDir": "macos/Runner/Assets.xcassets/AppIcon.appiconset",
+    "output": [
+      {"size": "  16", "file": "Icon-{w}x{h}.{t}"},
+      {"size": "  32", "file": "Icon-{w}x{h}.{t}"},
+      {"size": "  64", "file": "Icon-{w}x{h}.{t}"},
+      {"size": " 128", "file": "Icon-{w}x{h}.{t}"},
+      {"size": " 256", "file": "Icon-{w}x{h}.{t}"},
+      {"size": " 512", "file": "Icon-{w}x{h}.{t}"},
+      {"size": "1024", "file": "Icon-{w}x{h}.{t}"}
+    ]
+  }, {
+    "title": "Website icons",
+    "outDir": "web/icons",
+    "output": [
+      {"size": "16", "file": "../favicon.{t}"},
+
+      {"size": "  16x16", "file": "favicon-{w}x{h}.{t}"},
+      {"size": "     32", "file": "favicon-{w}x{h}.{t}"},
+      {"size": "192x192", "file": "{n}-{w}.{t}"},
+      {"size": "    512", "file": "{n}-{w}.{t}"},
+
+      {"size": "    192  154x154", "file": "{n}-maskable-{w}.{t}"},
+      {"size": "512x512      410", "file": "{n}-maskable-{w}.{t}"}
+    ]
+  }, {
+    "title": "Windows app icon",
+    "outDir": "windows/runner/resources",
+    "after": "magick {n}-16x16.{t} {n}-24x24.{t} {n}-32x32.{t} {n}-48x48.{t} {n}-64x64.{t} {n}-256x256.{t} {n}.ico",
+    "delete": "true",
+    "output": [
+      {"size": " 16", "file": "{n}-{w}x{h}.{t}"},
+      {"size": " 24", "file": "{n}-{w}x{h}.{t}"},
+      {"size": " 32", "file": "{n}-{w}x{h}.{t}"},
+      {"size": " 48", "file": "{n}-{w}x{h}.{t}"},
+      {"size": " 64", "file": "{n}-{w}x{h}.{t}"},
+      {"size": "256", "file": "{n}-{w}x{h}.{t}"}
+    ]
+  }]
+}

svg2many-0.3.0/examples/app-icons-ios.json

@@ -0,0 +1,31 @@
+{
+  "help": [
+    "See app-icons-flutter.json"
+  ],
+  "envType": "POSIX",
+  "export": "$CMD_RSVG_TO_FILE",
+  "rootDir": "examples",
+  "inpFile": "assets/images/app_icon.svg",
+  "outType": "png",
+  "frgClass": null,
+  "bkgClass": null,
+  "targets": [{
+    "title": "iOS/iPadOS app icons",
+    "outDir": "ios/Runner/Assets.xcassets/AppIcon.appiconset",
+    "output": [
+      {"size": "   20", "file": "Icon-20x20@1x.{t}"},
+      {"size": "   40", "file": "Icon-20x20@2x.{t}"},
+      {"size": "   60", "file": "Icon-20x20@3x.{t}"},
+      {"size": "29x29", "file": "Icon-20x20@1x.{t}"},
+      {"size": "   58", "file": "Icon-29x29@2x.{t}"},
+      {"size": "   87", "file": "Icon-29x29@3x.{t}"},
+      {"size": "   80", "file": "Icon-40x40@2x.{t}"},
+      {"size": "  120", "file": "Icon-60x60@2x.{t}"},
+      {"size": "  180", "file": "Icon-60x60@3x.{t}"},
+      {"size": "   76", "file": "Icon-76x76@1x.{t}"},
+      {"size": "  152", "file": "Icon-76x76@2x.{t}"},
+      {"size": "  167", "file": "Icon-83.5x83.5@2x.{t}"},
+      {"size": " 1024", "file": "Icon-1024x1024@1x.{t}"}
+    ]
+  }]
+}