https://github.com/mrcook/scrconv

CLI app to convert ZX Spectrum 8-bit SCR images to PNG/GIF/JPG
https://github.com/mrcook/scrconv

8bit cli converter gif golang jpg png scr zx-spectrum

Last synced: 12 days ago
JSON representation

CLI app to convert ZX Spectrum 8-bit SCR images to PNG/GIF/JPG

• Host: GitHub
• URL: https://github.com/mrcook/scrconv
• Owner: mrcook
• License: mit
• Created: 2021-09-08T11:22:59.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2023-12-27T19:39:48.000Z (about 1 year ago)
• Last Synced: 2024-11-21T21:38:49.862Z (2 months ago)
• Topics: 8bit, cli, converter, gif, golang, jpg, png, scr, zx-spectrum
• Language: Go
• Homepage:
• Size: 26.4 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# scrconv - ZX Spectrum SCR converter

A CLI program for converting ZX Spectrum SCR files to normal image formats

such as PNG, GIF, and JPG.

## Usage

Once the program is installed (see below) a SCR file can be converted with

the following command:

    ./scrconv -scr="/path/to/game.scr"

By default `format=png`, `scale=1` and `border=true`, so a 320x240 PNG image is

created in the same directory as the SCR file, with the filename `game.png`.

    Usage of ./scrconv:

      -scr string

            Input .SCR filename

      -format string

            Image format: gif, jpg, png (default "png")

      -scale int

            Scale factor, max: 4 (default 1)

      -border

            Add a border to the image (default true)

      -border-colour int

            Border Colour, values: 0 - 15 (default: 0)

      -auto-border

            EXPERIMENTAL: Auto Detect Border Colour

      -v	Show version number

### Scale

The scaling generates an image in one of the following resolutions:

    scale |   size   | + border

    ------+----------+----------

      1   |  256x192 |  320x240 (default)

      2   |  512x384 |  640x480

      3   |  768x576 |  960x720

      4   | 1024x768 | 1280x960

### Border Colour

When the `border` option is enabled, setting a `border-colour` will change

the colour of the border. The value should be one of the 16 ZX Spectrum

normal/bright colours; a value between 0-15. The default colour is black.

     # | Colour     |  #  | Colour

    ---+------------+-----+---------------

     0 | Black      |   8 | Black

     1 | Blue       |   9 | Bright Blue

     2 | Red        |  10 | Bright Red

     3 | Magenta    |  11 | Bright Magenta

     4 | Green      |  12 | Bright Green

     5 | Cyan       |  13 | Bright Cyan

     6 | Yellow     |  14 | Bright Yellow

     7 | White      |  15 | Bright White

**EXPERIMENTAL**

When setting the `auto-border` the border colour will be auto-detected based on

the most common colour in the image. This setting overrides any value given in

the `border-colour`.

## Installation

    go install github.com/mrcook/scrconv/cmd/scrconv@latest

To install the program after manually cloning the repository:

    cd scrconv

    go install ./cmd/scrconv

## LICENSE

Copyright (c) 2021-2023 Michael R. Cook. All rights reserved.

This work is licensed under the terms of the MIT license.

For a copy, see .