https://github.com/m7a/bp-bin2bmp
Convert binary files to bitmaps for visual inspection
https://github.com/m7a/bp-bin2bmp
Last synced: 11 months ago
JSON representation
Convert binary files to bitmaps for visual inspection
- Host: GitHub
- URL: https://github.com/m7a/bp-bin2bmp
- Owner: m7a
- Created: 2020-12-24T00:28:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-28T19:34:07.000Z (about 2 years ago)
- Last Synced: 2025-06-02T13:17:34.475Z (about 1 year ago)
- Language: Python
- Size: 14.6 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
---
section: 11
x-masysma-name: bin2bmp
title: bin2bmp
date: 2020/12/23 00:18:14
lang: en-US
author: ["Linux-Fan, Ma_Sys.ma (Ma_Sys.ma@web.de)"]
keywords: ["mdvl", "python", "script", "binary", "image", "bitmap"]
x-masysma-version: 1.0.0
x-masysma-website: https://masysma.net/11/bin2bmp.xhtml
x-masysma-repository: https://www.github.com/m7a/bp-bin2bmp
x-masysma-owned: 1
x-masysma-copyright: |
Copyright (c) 2020 Ma_Sys.ma.
For further info send an e-mail to Ma_Sys.ma@web.de.
---
Name
====
`bin2bmp` -- Convert binary files to bitmaps for visual inspection
Synopsis
========
bin2bmp <-i INPUT-FILE> [-w WIDTH] [-o OUTPUT-FILE] [-d DEPTH]
[-v] [-r] [-t] [-T]
Description
===========
This script converts arbitrary files to bitmap images by encoding the binary
data in the pixel values. This can be used for visual inspection of small and
medium-sized (up to a few megabytes) files. Additionally, it is possible to
reverse the encoding by means of the `-r` option.
Technically, larger files will work, too. Although there does not seem to be
a good usecase for it, check section _Issues with Large Files_ if interested.
Options
=======
---- ----------- -------------------------------------------------
`-i` INPUT-FILE Input filename (required)
`-w` WIDTH Width of output image (default is 1200)
`-o` OUTPUT-FILE Output filename (default is `input_filename.png`)
`-d` DEPTH Set color depth (24 default, 32 also possible)
`-v` Display version and license information
`-r` Restore input file a to binary file
`-t` Write TGA instead of PNG images
`-T` Write TIFF instead of PNG images
---- ----------- -------------------------------------------------
Examples
========
## Display the source code as image
./bin2bmp -i bin2bmp -w 60 -o bin2bmp.png
Bugs
====
## Issues with Large Files
* The whole input and output file is loaded into memory.
Processing thus requires about two times the size of the input file of
memory + overhead (for instance: 4 GiB input file needs 10 GiB RAM).
* The program is entirely single-threaded (hence slow)
* Large files may exceed the formats' capabilities. Use option `-T` to produce
TIFF files which can accomodate for large bitmaps. In case other programs
reject opening the files, consider using a GIS (despite that not being
its original function, it works well as a viewer for extra-large TIFF files).
* A better workaround for performance issues is to use `split` to make multiple
small input files from a single file and then process these files with
`bin2bmp` in parallel.
## Other
* Monochrome mode does not work
See Also
========
* An older version of the bin2bmp source code is available on Pastebin:
* [BinVis](https://binvis.io)
([Source](https://github.com/cortesi/scurve/blob/master/binvis))