139 lines
2.8 KiB
Markdown
139 lines
2.8 KiB
Markdown
|
Impulse Tracker
|
|||
|
|
===============
|
|||
|
|
|
|||
|
|
Full source code for Impulse Tracker, including sound drivers, network drivers,
|
|||
|
|
and some supporting documentation
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Pre-Requisite Software
|
|||
|
|
----------------------
|
|||
|
|
|
|||
|
|
To build Impulse Tracker, you will need:
|
|||
|
|
|
|||
|
|
- Turbo Assembler v4.1
|
|||
|
|
|
|||
|
|
- Turbo Link v3.01
|
|||
|
|
|
|||
|
|
- Borland MAKE v4.0
|
|||
|
|
|
|||
|
|
- A DOS environment
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Once you have these, building IT.EXE should be just a single call to `MAKE`
|
|||
|
|
|
|||
|
|
|
|||
|
|
Sound drivers are build individually via M\*.BAT files inside the SoundDrivers
|
|||
|
|
subdirectory
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Quick File Overview
|
|||
|
|
-------------------
|
|||
|
|
|
|||
|
|
- IT.ASM:
|
|||
|
|
Startup routines
|
|||
|
|
|
|||
|
|
- IT\_DISK.ASM:
|
|||
|
|
Disk IO Routines. Uses IT\_D\_\*.INC files
|
|||
|
|
|
|||
|
|
- IT\_DISPL.ASM:
|
|||
|
|
Display routines for the Playback Screen (F5)
|
|||
|
|
|
|||
|
|
- IT\_EMS.ASM:
|
|||
|
|
EMS memory handling routines
|
|||
|
|
|
|||
|
|
- IT\_F.ASM:
|
|||
|
|
Collection of functions used by the object model
|
|||
|
|
|
|||
|
|
- IT\_FOUR.ASM:
|
|||
|
|
Fast Fourier routines. Used by the graphic equalizer (Alt-F12).
|
|||
|
|
Not available on all all sound cards
|
|||
|
|
|
|||
|
|
- IT\_G.ASM:
|
|||
|
|
Global key handler functions
|
|||
|
|
|
|||
|
|
- IT\_H.ASM:
|
|||
|
|
Help Module (F1)
|
|||
|
|
|
|||
|
|
- IT\_I.ASM:
|
|||
|
|
Sample list (F3) and Instrument list (F4) module
|
|||
|
|
|
|||
|
|
- IT\_K.ASM:
|
|||
|
|
Keyboard module
|
|||
|
|
|
|||
|
|
- IT\_L.ASM:
|
|||
|
|
Information line code
|
|||
|
|
|
|||
|
|
- IT\_M.ASM:
|
|||
|
|
Main message loop/dispatcher
|
|||
|
|
|
|||
|
|
- IT\_MDATA.ASM:
|
|||
|
|
Global music variable data
|
|||
|
|
|
|||
|
|
- IT\_MMTSR.ASM:
|
|||
|
|
Sample compression/decompression routines
|
|||
|
|
|
|||
|
|
- IT\_MOUSE.ASM:
|
|||
|
|
Mouse handling code
|
|||
|
|
|
|||
|
|
- IT\_MSG.ASM:
|
|||
|
|
Message editor module (Shift-F9)
|
|||
|
|
|
|||
|
|
- IT\_MUSIC.ASM:
|
|||
|
|
Module playback code. Also uses IT\_M\_EFF.INC
|
|||
|
|
|
|||
|
|
- IT\_NET.ASM:
|
|||
|
|
Network code
|
|||
|
|
|
|||
|
|
- IT\_OBJ1.ASM:
|
|||
|
|
UI object definitions
|
|||
|
|
|
|||
|
|
- IT\_PE.ASM:
|
|||
|
|
Pattern Editor module (F2)
|
|||
|
|
|
|||
|
|
- IT\_S.ASM:
|
|||
|
|
Screen functions, including character generation
|
|||
|
|
|
|||
|
|
- IT\_TUTE.ASM:
|
|||
|
|
Interactive Tutorial module
|
|||
|
|
|
|||
|
|
- IT\_VESA.ASM:
|
|||
|
|
VESA code for graphic equalizer
|
|||
|
|
|
|||
|
|
- SWITCH.INC:
|
|||
|
|
High level switches for the program
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
Frequently Asked Questions
|
|||
|
|
--------------------------
|
|||
|
|
|
|||
|
|
Q: "What are all those funny characters in the source code?"
|
|||
|
|
|
|||
|
|
A: I wrote the original source code using DOS characters, with characters drawing borders/boxes in
|
|||
|
|
comments in the source code. In the interests of posterity, I have left the code intact as it was.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Q: "Why didn't you use STRUCs or ENUMs" in your ASM source?
|
|||
|
|
|
|||
|
|
A: Simply because I didn't know about them at the time. I wish I did. There's a InternalDocumentation
|
|||
|
|
folder that I've included in the repository that details what some of the magic numbers appearing
|
|||
|
|
through the code might mean.
|
|||
|
|
|
|||
|
|
|
|||
|
|
Q: "Flow in some functions seems to jump all over the place. Why?"
|
|||
|
|
|
|||
|
|
A: The original code was compatible all the way back to an 8086 machine. 8086 would allow you to do
|
|||
|
|
conditional jumps only within +/-128 bytes, so I spent too much time shuffling code around to meet
|
|||
|
|
this restriction. When I shifted away from this 8086 restriction, I never went back to update the
|
|||
|
|
code that was mutilated by it.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
License
|
|||
|
|
-------
|
|||
|
|
|
|||
|
|
License for this source code is pending.
|