fcam 0.2.0

Convert binary files to images.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# fCam

fCam is a fast, command-line utility for converting a raw stream of bytes into a square PNG image. It processes an input file as consecutive 8-bit RGB color channels without any header or formatting data.

## Usage

```bash
fcam <input_file> <output_file> <size> [--loop-y]
```

### Arguments

- `<input_file>`: Path to the raw binary file you want to visualize.
- `<output_file>`: Path where the resulting image will be saved (e.g., `output.png`).
- `<size>`: The width and height of the generated square image in pixels.
- `[--loop-y]`: (Optional) By default, fCam generates pixels in a column-major order (X-axis first). If `--loop-y` is specified anywhere in the arguments, it will generate pixels in a row-major order (Y-axis first).

## Building 

```bash
cargo build --release
```

## Example

The accompanying `example.png` was generated from random data using `fcam`:

```bash
# Generate exactly 512 * 512 * 3 (786,432) bytes of random data
head -c 786432 </dev/urandom > random.bin

# Run fcam
fcam random.bin example.png 512
```

### Result

![Example showing fCam's output on random noise](example.png)

## Web Version

An interactive web version of `fCam` is also available in the `web/` directory. It accurately replicates the behavior of the Rust CLI tool entirely in your browser using JavaScript and the HTML `<canvas>` API.

### Usage

1. Open `web/index.html` in any modern web browser.
2. Click **Choose File** to upload your raw binary file.
3. Enter the desired **Image Size** (width and height).
4. Optionally toggle `--loop-y` for row-major pixel rendering.
5. Click **Generate Image** to view the output instantly without the need for an external server.
6. Click **Download Image** to save the generated PNG.