Bash scripts to automate and extend the process of using SVG as Android image asset.
This project is also used by zhanghai/MaterialColdStart.
- inkscape: For PNG genration
- gcalccmd (shsvgdpi.sh): For (friendly) mathematical calculation.
Usage: svgdpi.sh SVG_FILE [DIR_PREFIX [DIR_SUFFIX]]
This script can automatically generate PNG asset of different Dips from SVG arranged properly for direct usage in Android application.
For instance:
./svgdpi.sh path/to/your/file.avg
Will output the following files:
drawable-mdpi/file.png
drawable-hdpi/file.png
drawable-xhdpi/file.png
drawable-xxhdpi/file.png
drawable-xxxhdpi/file.png
You can also add prefix and suffix to the drawable directory name with command line arguments. See the script source for more detail.
Usage: shsvgdpi.sh SHSVG_FILE [DIR_PREFIX [DIR_SUFFIX]]
This script implemented a powerful new file format called ShellSVG (.shsvg
), which allows you to embed any shell command/parameter substitution inside your SVG file.
dp
(Device-independent Pixel) is supported as an exported function dp()
, and mathematical expression is supported as an exported function calc()
. You need to wrap dp()
inside a calc()
if it is used.
This makes drawing Nine-patch bitmaps where the surrounding lines are always 1px
while the content must be drawn in dp
easy.
What's more, you can now use parameters inside your SVG, a dimension, a color, a filter, everything is OK. Just do it as in shell, for instance ${SOME_PARAMETER}
. Parameter definitions can be written in a .conf
file which will be source
-ed before generation of a standard SVG file, which means this file can have all the shell semantics apart from regular key-value pair, such as source
-ing another .conf
.
This script has taken rounding on HDPI (with scaling factor 1.5) into account, so that nine-patch bitmaps won't have an anti-aliased border. It is recommended that you call dp()
for every single dp
dimension separately to avoid accumulated rounding inconsistency.
The usage of this script is just like svgdpi.sh
.
For a detailed example, see the sample/ directory.
Copyright (c) 2015 Zhang Hai <[email protected]>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.