IIDX ICON GENERATOR version 1.0 by Taren N. 2004 December 28 What this does: This program generates PPM-format images for use in an animated GIF icon that resembles IIDX game play, or anything else you might want images of gameplay for. Input is taken from properly formatted BMS and BME files, or text files of a special format. ----- OPTION SETTINGS ----- Display length factor: this is how many hundreds of pixels tall the output image will be. This is not a stretch factor- it really does vary the length of the lanes. Default is 1, which will provide a 100x100 image. Decimals are allowed. Zero and negative numbers are not allowed. High Speed factor: default is 1. This scales the spacing out of the notes. A value of 2 will make the notes scroll twice as fast; a '3', three times, etc. Decimals and positive values <1 are allowed. Zero and below are not allowed. 1P Layout: Type 'y', 'Y', or '1' to enable left-side scratch. Type 'n', 'N', or '0' to enable right-side scratch. You can type an entire string into this entry, but it only looks at the first character. Scroll tempo: How fast the notes scroll. Positive, non-zero decimals and integers are allowed. Framerate(/sec): How many frames you plan to have per second. Positive, non-zero integers are allowed. ----- TARGET SETTINGS ----- Target file: Provide the file name of the text/bms/bme file you plan to use, including the extension. Is BMS: Same as 1P Layout option. If you have a BMS: First/Last measure to cut: decide which bars of the song are to be used in your animation. Input for the last measure extends to the very end of the measure and stops before the downbeat of the next. WARNING: Altered-length measures and tempo changes are NOT SUPPORTED. If you have a text file: Song length in measures: Tell the program how long the loop cycle is on your note data. If you get a warning "A subdirectory or file ___ already exists.", ignore it. It only means that files will be overwritten in the folder created. Note that when this happens, only the frames needed will be overwritten; extras will not be deleted or altered. ----- INPUT FORMAT ----- Input from BMS/BME file: Make sure there are no spaces or newlines in the note data lines. If you haven't altered the BMS, you shouldn't have to worry about this. Input from text file: You shouldn't even waste your time with this, but in case you want to, here's how it works. (Note: this format is autogenerated to a *.temp file during program execution, and is deleted before termination.) For each line of the file, there are two main fields: position and note data. Position is a decimal or integer, defining how many measures from the beginning of the song the notes occur. Whitespace separates this from note data. Note data consists of the rest of the line, and can include whitespace. All of the notes here will occur at the position defined. Use numbers 1-7 to define notes and 0 or 8 to define a scratch. All other characters are ignored, and notes need not be in any particular order. Lines need not be arranged by position. See the included notes.txt for an example of this format. ----- TIPS WITH ANIMATING ----- Open all of the images generated in the {input file}_images folder in sequential order, and for time between frames, use 100 divided by the framerate you provided earlier. I suggest using either 50, 25, or 20 for framerate, as 100 is a multiple of all of those. Using 50, 25, or 20 fps, your notes will scroll at the tempo you specified in the file. ----- CONTACT ----- IIDX icon generator program was written by Taren N. tarennauxen at gmail.com. AIM: X12x300X Aaroninjapan forums username: Taren