Skip to content

Tools and command line usage

Thomas Leathers edited this page Apr 17, 2017 · 2 revisions

List of command line tools incuded in SBTCVM Mark 2, as well as short usage.

SBTCVM-asm2.py

This is SBTCVM-asm2.py, SBTCVM Mark 2's assembler.

SBTCVM-asm2.py is the powerful tool that compiles Mark 2 *.tasm assembly source code files into *.trom programs that SBTCVM Mark 2 can run. more information can be found in the "programming-the-VM" section of the docs directory.

commands:
SBTCVM-asm2.py -h (--help): this text
SBTCVM-asm2.py -v (--version)
SBTCVM-asm2.py -a (--about): about SBTCVM-asm2.py
SBTCVM-asm2.py -c (--compile) [sourcefile]: build a tasm source into a trom
SBTCVM-asm2.py -t (--tracecompile) [sourcefile]: same as -c but logs the compiling process in detail in the CAP directory.
SBTCVM-asm2.py [sourcefile]: build a tasm source into a trom

MK2-GFX.py

This is SBTCVM Mark 2's GFX toolkit.

This is a graphics toolkit that will eventually feature a suite of conversion tools, but at the moment, it is limited to various conversion modes to translate 27x27 or smaller images into ready-into-compile *.tasm source code.

commands:
MK2-GFX.py -h (--help): this text
MK2-GFX.py -v (--version)
MK2-GFX.py -a (--about): about MK2-GFX.py
MK2-GFX.py -c (--colraster) [imagefile]: convert a 27x27 pixel or smaller image to color raster instrucions (exported as a *.tasm)
MK2-GFX.py -cg (--colraster_groupcolor) [imagefile]: same as -c, but groups colors together as a compression scheme.
MK2-GFX.py -cg2 (--colraster_groupcolor2) [imagefile]: same as -cg, but tracks the most common color and uses a single fill instruction to further compress the image.

MK2-RUN.py

This is MK2-RUN.py, a command line launcher for SBTCVM Mark 2
commands:
MK2-RUN.py -h (--help): this text
MK2-RUN.py -v (--version)
MK2-RUN.py -r (--run) [trom file]: run a trom as TROMA
MK2-RUN.py -a (--about): about MK2-RUN.py
MK2-RUN.py [trom file]: run a trom as TROMA

Clone this wiki locally