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 | { convert --width <width> --height <height> [ --color-depth <colorDepth> ] [ --offset <offset> ] | extract } -i <inputFile> -o <outputFile> [ -v ] |
| picdat | extract [ --color-depth <colorDepth> ] { -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.
The command-line help follows the effective message locale. Set the Java system property org.refcodes.messages.locale or the environment variable ORG_REFCODES_MESSAGES_LOCALE to de to explicitly select German output; otherwise the JVM’s default display locale is used, with English as the fallback when no localized bundle is available.
The option --tui opens a text form with localized action and field labels, while command names and aliases remain unchanged. Supplied arguments prefill the form and are not executed automatically, and commands requiring additional terminal input must be invoked through the regular command line instead.
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 } |
| convert convert: | Converts given data into an image. |
| extract 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 extract -i <inputFile> -o <outputFile> -v
Convert a data file to a pixmap:
- picdat convert -i <inputFile> -o <outputFile> --width <width> --height <height> -v
Convert a data file to a pixmap with given color depth:
- picdat convert -i <inputFile> -o <outputFile> --width <width> --height <height> --color-depth <colorDepth> -v
Convert a data file starting at given offset to a pixmap:
- picdat convert -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