change help text , README

This commit is contained in:
Marcus 2024-01-02 03:34:25 +01:00
parent 9ee1945b76
commit 504c795e02

View file

@ -5,28 +5,30 @@ Origin: https://git.la10cy.net/DeltaLima/pixelfloot
an very simple and dirty pixelflut client to draw images, written in bash.
pixelfloot was built during the 37c3. in its actual state, its just a mess. I hope i will find time to put it in a more usable and readable format.
## image format
you need an uncompress ppm image at first. it is not allowed to be larger then 200px.
convert it like so: `convert lol.jpg -compress none -resize 200x200 lol.ppm`
after you have converted it to ppm, you need to convert it to a "pixel-list".
do it with `./pixelfloot_bash.sh convertimg lol`
Have a look to the example .pixlist files
## examples
Display image: `./pixelfloot_bash.sh floot lol`
Display image: `./pixelfloot_bash.sh floot images/lucky-cat.jpg`
image random position: `./pixelfloot_bash.sh floot images/lucky-cat.jpg chaos`
wider "chaos-radio": `W=1000 H=600 ./pixelfloot_bash.sh floot images/lucky-cat.jpg chaos`
image shake position: `SHUFMODE=shake ./pixelfloot_bash.sh floot images/lucky-cat.jpg shake`
image shake position: `./pixelfloot_bash.sh floot images/lucky-cat.jpg shake`
set the position : `W=420 H=420 ./pixelfloot_bash.sh floot images/lucky-cat.jpg shake`
move image with your cursor (needs `xdotool`): `./pixelfloot_bash.sh floot images/lucky-cat.jpg cursor`
Use a color as "alpha" (remove background): `ALPHACOLOR=FF00FF ./pixelfloot_bash.sh floot images/cursor.ppm cursor`
increase No of cuncurrent connections: `FLOOTFORKS=8 ./pixelfloot_bash.sh floot images/lucky-cat.jpg`
```shell
$ ./pixelfloot_bash.sh help
./pixelfloot_bash.sh [floot|convertimg] [FILENAME|fill] ([MODE])
MODE: static (env $H and $W for position)
chaos (env $H and $W for position range)
shake (env $H and $W for position range)
cursor
available env vars to configure:
RESIZE(int), ALPHACOLOR(hex), FLOOTFORKS(int), H(int), W(int)
```