GitHunt
HU

HugoSmits86/dreamcast-vms-icondata-tool

Tool to encode and decode icondata.vms files for the Dreamcast VMS

License: MIT
GoDoc
Go Report Card
Build Status
codecov

Introduction

Icondata is a Go package for decoding and encoding ICONDATA.VMS file format.

I suspect that most users of this project are likely hobbyists instead of full-blown programmers.
For them I have included a command-line tool in the form of main.go. This is a stand-alone
program that lets users encode and decode ICONDATA.VMS files from the command-line.

Currently only the black and white icons are supported.

Install package

The package includes a make file that can install the package for multiple platforms.

#compile and install package for Windows
make install-windows
#compile and install package for MacOs
make install-macos
#compile and install package for Linux
make install-linux

Usage package

Encoding image into ICONDATA.VMS file example:

err = icondata.Encode(file, img)
if err != nil {
    log.Fatal(err)
}

Decoding ICONDATA.VMS file example:

desc, img, err := icondata.Decode(file)
if err != nil {
    log.Fatal(err)
}

Build tool

The command-line tool includes a make file that can build the tool for multiple platforms.

#compile and install package for Windows
make install-windows
#compile and install package for MacOs
make install-macos
#compile and install package for Linux
make install-linux

Usage tool

The tool program can be used from the command-line. Here is an example:

./icontool_macos -i test.vms -o test.png

⚠️ NOTE: Currently only the PNG image format is supported.

Todo

  • Support color icons.
  • Generate VMI file for VMS file.

Disclaimer

THIS PROJECT IS OFFERED ON A "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
EITHER EXPRESS OR IMPLIED. USAGE AND RELIANCE IS ENTIRELY AT YOUR OWN RISK.

Languages

Go79.5%Makefile20.5%

Contributors

MIT License
Created February 27, 2020
Updated August 25, 2023