Minecraft Map to PNG Converter

This Rust application transforms Minecraft map data from NBT format into a visual PNG image. Additionally, a WebAssembly module is available for converting images on the client side.

Features

Convert compressed Minecraft map NBT files to PNG images.
Direct memory-based image processing suitable for web assembly integration.
Efficient error handling and informative error messages.

Demo Site

I provide a web interface that allows users to convert Minecraft NBT files to PNG images directly within their browser.

The website is built using HTML and Tailwind CSS for styling. It features a simple drag-and-drop interface for file upload, a convert button, and displays the resulting PNG image which can then be downloaded. The site runs entirely client-side, leveraging WebAssembly to perform image conversion.

WebAssembly Usage

To use the WebAssembly module, include the following steps in your web application:

Initialize the WASM Module: First, ensure that the WASM module is loaded and initialized correctly. This is done by importing the initialization function and the specific functions you need from the generated WASM package.
```
import init, { process_image_from_memory } from './path_to_wasm_package/mc_map2png.js';

await init();
```

File Processing: Convert user-uploaded files by reading them into an ArrayBuffer, then passing this buffer to the WASM function:

const fileInput = document.getElementById('fileInput');
const file = fileInput.files[0];
const arrayBuffer = await file.arrayBuffer();
const result = await process_image_from_memory(new Uint8Array(arrayBuffer));

Displaying the Image: Upon successful conversion, display the image or handle errors appropriately:

if (result instanceof Uint8Array) {
    const blob = new Blob([result], {type: 'image/png'});
    const url = URL.createObjectURL(blob);
    document.getElementById('outputImage').src = url;
} else {
    console.error('Conversion failed.');
}

Download Option: Provide users with the option to download the generated PNG:

const downloadButton = document.getElementById('downloadButton');
downloadButton.onclick = () => {
    const link = document.createElement('a');
    link.href = URL.createObjectURL(new Blob([result], {type: 'image/png'}));
    link.download = 'converted-image.png';
    link.click();
};

Installation

Clone the repository to your local machine:

git clone https://github.com/masaishi/mc_map2png.git
cd mc_map2png

Build the project using Cargo:

cargo build --release

Usage

To convert an NBT file to a PNG image, run:

cargo run --release -- <input_path> <output_path>

Where: