SM_SCGEN.EXE
Written by Taren

2005/02/26

This program generates a stepchart image in PPM format from any SM (Stepmania) file. To run, simply type in the filename of the SM file you wish to read in from, then select the number according to which stepchart you want to view. In a few seconds, the program will end and you will have a stepchart ready for viewing.

This program can handle Single as well as Double charts, and comes with many useful features:
-customizable color coding for step timing
-customizable arrow/mine images
-high speed settings

---
DOCUMENTATION
---

How to customize your output: open up metrics.txt and change the values that come after the colons (:).

"bars per column"- this is how many four-beat groups will appear in each column in the final image.
"objectsize"- number of pixels-square your arrows and mines will appear. Do not change this value unless you have edited arrow.txt and mine.txt.
"markings"- number of digits to be displayed before and after the decimal point in the margins. "X.Y" is the format, where X is the number of digits before, and Y is the number of digits after. Hence, "3.3" will display xxx.yyy in the margin left of the arrows.
"barcounter digits"- determines how many digits should be used to display the current measure at the top of each column. If left at 3, it will start at "001" and increase as it progresses right.
"freeze-end markers"- controls whether arrows are displayed or not at the end of a hold. A setting of "1" turns them on, and "0" turns them off. If disabled, freezes will terminate in the same color as the body of the freeze.
"high speed"- spaces out the notes. Acceptable values are 0, 1, 2, and 3. A HS of 0 will display the notes at x1 speed. "1" will space them out to x2 their normal position; "2" spaces them out x4; and "3", x8.
"arrow image"- defines the file in which the program expects to find the definition for an arrow. (see below for details)
"mine image"- defines the file for a mine.
"digit font"- same, except tells where to find the small font used for tempo markings in the margin. The width/length definitions for this and the large font are found inside this file.
"big font"- font used for the title and song data along the top of the image.
--series of numbers--: these are the RRR GGG BBB color definitions for each type of data written out to the final image. All numbers must range from 000 to 255, and be written using three digits. See the comments for details. Comments can be added or deleted along the line, as long as the appropriate digits remain in columns 1-3, 5-7, and 9-11.

Image definitions:
Arrow and Mine definitions are as follows: these are simple text files that use the digits 0 through 9 to define a pixel's intensity. Each digit represents one pixel. The image must be the same width and length as defined in metrics.txt. A "0" will set the pixel as transparent. A "1" tells the program to use 1/9 the RGB values defined for a note of that timing. For example, a 1/4 note that is defined to be 255-0-0 will appear as 28-0-0. A "2" tells the program to make the pixel 2/9 the brightness, all the way up to 9, which uses the normal color defined in metrics.txt.

Digit/Big fonts:
The same format as arrow definitions, except the only valid values are "0" and "1". Zero is transparent, and One is opaque, which uses the color defined in Metrics.txt. Each line should have "width" pixels, and each character should be "height" pixels tall. All of the characters are concatenated vertically, leaving no empty lines between characters. The extra variable, decimal width in digits.txt, defines how wide ONLY the decimal point character should be. Big font contains the following characters in order: 0-9, space, capital A-Z, slash. Digits.txt contains only 0-9, followed by the decimal point.

Written by Taren
tarennauxen at gmail · com
AIM: x12x300x
http://superwailingbonus.com