PICDAT(1) General Commands Manual
NAME
picdat — Tool for converting (raw) data to a pixmap image (“[pic]ture[dat]a”) and extracting raw (pixmap) data from an image.
SYNOPSIS
| picdat | { -c --width <width> --height <height> [ --color-depth <colorDepth> ] [ --offset <offset> ] | -e } -i <inputFile> -o <outputFile> [ -v ] |
| picdat | { -c --width <width> --height <height> [ --color-depth <colorDepth> ] [ --offset <offset> ] | -e } { -i <inputFile> | -o <outputFile> [ -v ] } |
| picdat | -h | --sysinfo [ -v ] |
DESCRIPTION
This manual page documents the picdat command: The picdat command extracts --extract
raw (pixel) data from a pixmap (image) --input-file to a file --output-file
or converts --convert (raw) data --input-file into a pixmap (image) file
--output-file with a given width --width and height --height and color
depth --color-depth.
This can be helpful when analyzing cryptographic algorithms’ quality by encrypting
an image’s raw (pixel) data --extract and converting --convert the encrypted
result back into an image (using a blank image or an image with few basic geometric
shapes can provide a first impression of the resulting randomness).
Depending on the executable’s flavor the command might also be named picdat-x.y.z.jar, picdat-bundle-x86_64-x.y.z.elf, picdat-bundle-x86_64-x.y.z.exe, picdat-installer-x86_64-x.y.z.msi, picdat-launcher-x.y.z.sh, picdat-launcher-x86_64-x.y.z.elf, picdat-launcher-x86_64-x.y.z.exe, picdat-native-x86_64-x.y.z.elf where x.y.z stands for the version of the picdat command. The according executable’s name will be referenced to in this manual as picdat.
OPTIONS
| --color-depth <colorDepth>: | The color depth of the targeted image: { MONOCHROME_1_BIT, GRAYSCALE_8_BIT, MSX_8_BIT, HIGH_COLOR_16_BIT, TRUE_COLOR_24_BIT, AWT_COLOR_24_BIT, TRUE_COLOR_32_BIT } |
| -c --convert: | Converts given data into an image. |
| -e --extract: | Extracts pixel data from an image. |
| -h --help: | Shows this help. |
| --height <height>: | The height for the targeted image. |
| --offset <offset>: | The offset where to start interpreting the data as image data (e.g. the number of bytes to skip, first byte is at offset 0). |
| -i --input-file <inputFile>: | The input file which to process from. |
| -o --output-file <outputFile>: | The output file which to process to. |
| --sysinfo: | Shows some system information for debugging purposes. |
| -v --verbose: | Enables the verbose mode with additional (human readable) informational output. |
| --width <width>: | The width for the targeted image. |
EXAMPLES
Extract a pixmap (image) file’s (raw) data to a file:
- picdat -e -i <inputFile> -o <outputFile> -v
Convert a data file to a pixmap:
- picdat -c -i <inputFile> -o <outputFile> --width <width> --height <height> -v
Convert a data file to a pixmap with given color depth:
- picdat -c -i <inputFile> -o <outputFile> --width <width> --height <height> --color-depth <colorDepth> -v
Convert a data file starting at given offset to a pixmap:
- picdat -c -i <inputFile> -o <outputFile> --width <width> --height <height> --offset <offset> -v
To show the help text:
- picdat -h
To print the system info:
- picdat --sysinfo
BUGS
See BitBucket issues at <https://bitbucket.org/funcodez/funcodes-picdat/issues>
AUTHOR
Siegfried Steiner steiner@refcodes.org