PICDAT manpage

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: https://bitbucket.org/funcodez/funcodes-picdat

AUTHOR

Siegfried Steiner steiner@refcodes.org

SEE ALSO