94 lines
2.5 KiB
Markdown
94 lines
2.5 KiB
Markdown
[](https://git.klemek.fr/klemek/margen/actions?workflow=lint.yml) [](https://git.klemek.fr/klemek/margen/actions?workflow=build.yml)
|
|
|
|
# margen
|
|
|
|
> generate a marble-like pattern bitmap image, blazing fast.
|
|
|
|
<p align="center">
|
|
<img width="960" height="360" src="./images/sample.gif">
|
|
</p>
|
|
|
|
Written in pure C without librairies.
|
|
|
|
## Install
|
|
|
|
### From release
|
|
|
|
See [Releases](https://git.klemek.fr/klemek/margen/releases)
|
|
|
|
```sh
|
|
tar xvzf margen-x.y.z.tar.gz
|
|
cd margen-x.y.z
|
|
./configure
|
|
make
|
|
make install
|
|
```
|
|
|
|
### From repository (PKGBUILD)
|
|
|
|
```sh
|
|
git clone https://git.klemek.fr/klemek/margen
|
|
cd margen
|
|
makepkg -si
|
|
```
|
|
|
|
|
|
### From repository (dev version)
|
|
|
|
```sh
|
|
git clone https://git.klemek.fr/klemek/margen
|
|
cd margen
|
|
aclocal
|
|
autoconf
|
|
automake --add-missing
|
|
./configure
|
|
make
|
|
make install
|
|
```
|
|
|
|
## CLI arguments
|
|
|
|
```txt
|
|
usage: margen [--help] [-v] [-q] [-w=WIDTH] [-h=HEIGHT] [-o=PATH] [--seed=SEED][-p=PIXEL_SIZE] [-s=SLOPE] [-c=R,G,B] [-va=R,G,B] [-vr=VAR_RANGE] [-r=ROTATION] [-m]
|
|
|
|
generate a marble-like pattern bitmap image, blazing fast.
|
|
|
|
options:
|
|
--help show this help message and exit
|
|
-v, --version print version
|
|
-q, --quiet do not print to console
|
|
-w, --width image width (default: 1920)
|
|
-h, --height image height (default: 1080)
|
|
-o, --output output file (default: output.bmp)
|
|
--seed random seed (default: time based)
|
|
-p, --pixel pixel size (default: random)
|
|
-s, --slope slope [0-255] (default: random)
|
|
-c, --color base color [0-255,0-255,0-255] (default: random)
|
|
-va, --variation fixed variation [0-255,0-255,0-255] (default: random)
|
|
-vr, --var-range random variation range [0-255] (default: 30)
|
|
-r, --rotation start corner rotation [0-3] (default: random)
|
|
-m, --monochrome grayscale generation
|
|
```
|
|
|
|
## Release guide
|
|
|
|
```bash
|
|
# get latest version
|
|
git pull origin master
|
|
# update configure.ac with new version
|
|
$EDITOR configure.ac
|
|
# make full build
|
|
make -f Makefile.dev release
|
|
# update PKGBUILD with new version and sha256 sum
|
|
sha256sum build/margen-x.y.z.tar.gz
|
|
$EDITOR PKGBUILD
|
|
# push to repo
|
|
git commit -am "margen vX.Y.Z"
|
|
git tag vX.Y.Z -m "margen vX.Y.Z"
|
|
git push origin master --tags
|
|
# create release from tag on github
|
|
# attach .tar.gz to the github release
|
|
make -f Makefile.dev release-arch
|
|
# attach .pkg.tar.zst to the github release
|
|
```
|