From 4c40a4dc245f7715f4891ed02d71475628e7a959 Mon Sep 17 00:00:00 2001 From: stkhan Date: Mon, 20 Jun 2022 19:54:29 +0000 Subject: new directory structure --- utils/nsxiv/icon/README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 utils/nsxiv/icon/README.md (limited to 'utils/nsxiv/icon/README.md') diff --git a/utils/nsxiv/icon/README.md b/utils/nsxiv/icon/README.md new file mode 100644 index 0000000..3ddd7f8 --- /dev/null +++ b/utils/nsxiv/icon/README.md @@ -0,0 +1,43 @@ +img2data +-------- + +img2data is a helper program to convert images to binary data for embedding in +software. The generated data is used in nsxiv to set the window icons. + + +How It Works +------------ + +Each given image is compressed using run-length encoding and a data array is +generated. In these arrays, the four high bits of each byte are the run length +minus one and the lowest four bits are the data, which are indices for the +color array. + +See `data.gen.h` or the output of img2data for a better understanding. + + +Dependencies +------------ + +img2data requires Imlib2 to be installed. + + +Building +-------- + +img2data is built using the command: + + $ CC -Wall -std=c89 -pedantic -lImlib2 img2data.c -o img2data + +where `CC` is a C compiler such as `gcc`. + + +Usage +----- + +img2data is used as the following: + + $ ./img2data 16x16.png 32x32.png 48x48.png 64x64.png 128x128.png + +You may replace or omit any image, but you must have a `data.gen.h` with at +least 1 image for nsxiv to compile. -- cgit v1.2.3