home *** CD-ROM | disk | FTP | other *** search
/ Dr. CD ROM (Annual Premium Edition) / premium.zip / premium / MUSICLAB / GTSMAIN.ZIP / GTS.DOC < prev    next >
Text File  |  1992-11-06  |  17KB  |  435 lines
  1.                     GTS & GTSDMA v0.9 Manual(summary)
  2.                             (The important are marked * at the 1st column)
  3.                                                    First created in Sep.1992
  4.                                                    Last modified in Nov.1992
  5.  
  6.  .Description: A kind of DAC Music Traker(Tracker) and Graphical Editor
  7.  
  8. *.Requirements: SuperVGA(above 512k),Sound Blaster,Mouse
  9.  
  10.  .Notice
  11.     Copyright belongs to the author from when it is made.
  12.      Name) Kim Young Jae
  13.      Tel ) (02) 887-9304
  14.      Addr) 151-061  Kwan-Ak Gu,Bong-Cheon 11 Dong 1641-5, 18/1
  15.                                                 Seoul,Korea
  16.  
  17.      I want something like postcard rather than feedback through E-mail.
  18.      For those who insist E-mail....
  19.  
  20.      Bitnet)   87272039@KRSNUCC1
  21.      Internet) I don't remember
  22.  
  23.      (This is account of my friend who is at military service now,
  24.       so it will be expired soon.)
  25.  
  26.  
  27.     At this time,this(v0.9) is a kind of shareware.
  28.     I suggest you should
  29.       either report me program bugs,and testing results,or your own opinion,
  30.       or remake this clumsy English manual summary
  31.         into full refined manual of your own language,and distribute it.
  32.       or send me money ($50).
  33.     Maybe 99% of you want to select the first, 0.98% for the second,
  34.       and 0.01% who doesn't know what is money,
  35.       and another 0.01% who is most conscientious,  for the third.
  36. *   These are your duty for using this program,
  37.      and the duty is not only moral but legal.
  38.  
  39.   .Legal Stuff
  40.      GTS can be distributed to any place without author's permission,
  41.       in the condition that copyright message is kept together.
  42.  
  43.      Some of songs included here are converted from
  44.           Mac XSNG song,Amiga Module or PC Scream Tracker.
  45.       and samples included here are collected or extracted from
  46.           various source(Mac,Amiga,Sun,Next).
  47.  
  48.      But I couldn't keep nor trace all of source of them.
  49.  
  50. **   If original composer of songs,creator of module and XSNG
  51.        and those who record samples originally
  52.        want to extract out their works from GTS archives,
  53.      I will do as demanded with sincere apology.
  54.  
  55.  
  56.   .Acknowledgement
  57.  
  58.       John Bridges' VGAKIT 4.1 (SuperVGA Chipset information and bank switch)
  59.       Bogas production's SuperStudioSession (first inspiration and samples)
  60.       FTP servers(sumex,saffron,plaza,nic)  (collection of samples and modules)
  61.  
  62.  
  63.  
  64.                      ----- Introduction -----
  65.  
  66.     Have you ever tried Amiga Module Traker or PC Scream traker?
  67.     These programs make sound by sending out digitized sample
  68.      at diffenrent pitch ( i.e. Digital -> Analogue Convert )
  69.     Trakers are different essencially from FM synth (such as ROL,CMF),
  70.      because it produces sounds of real world.
  71.  
  72.     GTS has the same function,but there is some differences.
  73. *   First,you can input your own music graphically.
  74.       this idea is mainly from Macintosh programs
  75.         such as Super studio session,Finale,Delux Music.
  76.        Well,I'm much inspired by "Super studio session".
  77.         and many of samples are from it.
  78. *   Second,the music itself is seperated from samples.
  79.       Above modules have musical sequence and samples all in 1 file,
  80.        and therefore have big size.
  81.       But If you have some samples statically,
  82.         your music can be created more easily with very small size
  83.           (like scream tracker STS).
  84. *   Third,GTS can manage .VOC as sample.
  85.       You can record your own voice (sampling), -- Analogue -> Digital
  86.         and produce music from that sample.     -- Digital  -> Analogue
  87.  
  88. *   If your music card has DMA feature,use GTSDMA.
  89.     GTS(direct version) works variably as to machine speed.
  90.  
  91.  
  92.  .Install(refer to GTSINST.BAT)
  93.     1. Make a subdirectory
  94. *   2. Unzip it with -d option to make sample subdirectories
  95.          i.e  PKUNZIP -d GTS____.ZIP
  96.     3. It doesn't need to load sound driver (sound.com,sbfmdrv.com)
  97.  
  98.  
  99.  
  100.                      ----- Help Summary -----
  101.  
  102.  .MOUSE Function
  103.    .Pulldown menu
  104.      .File
  105.        .New
  106.        .Open
  107.        .Save
  108.        .Save as
  109.        .Quit
  110. *    .Edit  : First,you must select target area by marking ,(execpt Paste)
  111.        .Copy
  112.        .Paste
  113.        .Cut
  114.        .Delete    : * (you may know well about all above this)
  115.        .Repeat    : repeat 2 times
  116.        .Repeats   : repeat many times
  117.        .Tie_untie : Tie selected notes,
  118.                     Untie if the selected are tied.
  119.                     If bugs found with this function,
  120.                      Redraw screen by scrolling.
  121.      .Insert      : Insert following special notes into
  122.                       where mark positioned(purple vertical line),
  123.                        or where mouse cursor positioned.
  124.                     Changes(key,measure...) in a trak NEVER affect
  125.                       the other trak,execpt tempo,
  126. **                      that is, tempo change affects all trak.
  127.        .Sample
  128.        .Key
  129.        .Tempo
  130.        .Measure
  131. *      .Ending    : this area is skiped when music is last repeated
  132.          ex)                               __
  133.                                           |1.
  134.              ||.     |      |      |      |      |     .||     |     |
  135.              ||.  1  |  2   |  3   |  4   |  5   |  6  .||  7  |  8  |
  136.              ||      |      |      |      |      |      ||     |     |
  137.              3x                                         x3
  138.  
  139.            playing_sequence: 1-2-3-4-5-6 - 1-2-3-4-5-6 - 1-2-3-4 - 7-8
  140.  
  141.  
  142.        .Anchor    : drop anchors.
  143.                     when the second anchor is dropped,
  144.                       the area between the first and the second is Marked.
  145.                     this is used to mark wide range.
  146.      .Etc
  147.        .Replace
  148.          Replace one sample,that is to change all the occurrence of
  149.            the sample in the music.
  150. *        note:Screen is not updated until draw sample box again next.
  151.        .about
  152.        .config(GTSDMA)
  153. *        .DAC Timer Value
  154.             Slow machines may have to reduce this value to get proper sound.
  155.             If this value is too high for your machine and playing trak,
  156.               music is not played continuously.
  157.             In this case , reduce this value.
  158.             Falling of hardware pitch and tempo can be compensated by adjusting
  159.                 software pitch and tempo.
  160.          .Sound Blaster DMA Channel Number ( the mosts are 1 )
  161.        .config(GTS)
  162. *        .TimerTick Value
  163.             You should adjust this value to get good quality of sound,
  164.                as to speed of your machine and number of playing trak,
  165.                and whether oscillograph is on or off.
  166.               see below(tuning up).
  167.          .Oscillograph value
  168.             This is a value for changing colors.
  169. *           Slow machine may have to turn off it by entering 0.
  170.             All other values have same effect on music itself,
  171.                but only diffenence in color change.
  172.               see below(tuning up).
  173.  
  174.  
  175.    .Edit screen
  176.      Notes Inserted  if put on blank area
  177.            Replaced  if put on the place already occupied
  178.            Deleted   if click eraser
  179.    .Status Area
  180.      Display current trak info(key,measure,tempo sample)
  181.    .Screen scroll line : Scroll current trak horizantally
  182.    .Trak change button : Change traks        vertically
  183.    .Note selection menu:
  184.      Arrow(marking tool),Eraser,Notes and Rests  \  Each item in the same line
  185.      Dot (1/2), 3 (1/3)                           }  is selected exclusively.
  186.      Sharp,Flat                                  /
  187.  
  188.    .Play & Stop button
  189.      Begin to play music from the current screen.
  190.        through DMA channel(GTSDMA)
  191.          or    Directly   (GTS)
  192.      Stop music and scroll to where is stopped.
  193.    .Volume,Pitch,Tempo
  194.      Vol1-Vol8  : Volume of each trak
  195.      Vol(main)  : Volume of Total trak
  196. *    Pitch      : \ this 2 values should be adjusted
  197. *    Tempo      : /      as to machine speed
  198.    .Sample test piano
  199.      Play current selected sample (Direct DAC mode)
  200.    .Sample selection menu
  201.      Select sample in SAMPLE directory
  202. **   Samples MUST be in the SAMPLE subdirectoy just below main program
  203. **   SAMPLE subdirectory can have one-deep child directory
  204.        such as PERCUSS,GUITAR,SYNTH,VOICE....
  205.      To return to the sample root directory,click the head of this menu.
  206.  
  207.  
  208.  
  209.  .Keyboard function
  210.  
  211.     F1,F2,F4,F8,F6,F3 : insert note(1,1/2,1/4,1/8,1/16,1/32)
  212.     SHFF1,SHFF2,SHFF4,SHFF8,SHFF6,SHFF3 : insert rests
  213.     ALT_1-ALT_8,UP,DOWN : change trak vertically
  214.     ALT_I,ALT_K,ALT_T,ALT_M,ALT_E : Insert Instrument(Sample),key,tempo
  215.                                                          ,measue,ending
  216.     ALT_C,ALT_V,ALT_X,ALT_D : copy,cut,paste,delete
  217.     ALT_N,ALT_O,ALT_S,CTRL_Q : new,open,save,quit
  218.     LEFT,RIGHT,PGUP,PGDN,HOME,END : scroll trak horizantally
  219.     ALT_R  : Repeat
  220.     CTRL_T : Tie_untie
  221.     ALT_A  : Drop Anchor
  222.     CTRL_P : Play
  223.  
  224.  .During the music playing
  225.    GTS    : User can do nothing but stop music
  226. *  GTSDMA : User can change volume and pitch,tempo
  227. *           The trak tured off from the first is not affected.
  228.  
  229.    Wanna stop music?
  230.            Esc : stop music and not scroll screen
  231.            other key : stop music and scroll to where stopped
  232.  
  233.  
  234.                      ----- Tuning Up -----
  235. ****                     (The most important part of this manual)
  236.  
  237. <Table> Relation of Timer value and Pitch,Tempo
  238.  
  239. =============================================================================
  240.  Machine speed       |          Fast             |         Slow
  241.  Number of trak      |           1               |          8
  242.  Oscillograph        |          off              |         on
  243. ---------------------+---------------------------+---------------------------
  244.  DAC timer(GTSDMA)   |  (can be) high            |  (should be) low
  245.  TimerTick(GTS)      |  (can be) low             |  (should be) high
  246. ---------------------+---------------------------+---------------------------
  247.  Pitch & Tempo       |  (becomes) high,fast      |  (becomes) low,slow
  248.                      |  (so,adjust) low,slow     |  (so,adjust) high,fast
  249. ---------------------+---------------------------+---------------------------
  250.  Sound quality       |         good              |         bad
  251. =============================================================================
  252.  
  253.  
  254. *  Maximun value of DAC Timer(GTSDMA.EXE) is
  255.      the value when all 8 trak is on,music plays continuously.
  256.     If music plays trembling or stop a bit,
  257.        then decrease DAC timer value,and up picth,tempo.
  258.  
  259. *  Minimun value of TimerTick(GTS.EXE) is
  260.      the value when all 8 trak sound is not different from
  261.         1-more-trak-off sound(7 trak).
  262.     If pitch and tempo varies as to the number of trak currently being played,
  263.      or music plays trembling,
  264.        then increase the TimerTick value,and up pitch.tempo.
  265.  
  266.    For my 286 AT
  267.      when 4 trak  DAC timer 80 , TimerTick 300
  268.           8                  0             400
  269.  
  270. *.To get good quality of sound
  271.     DAC requires fast speed at least above 12Mhz,
  272.     So, slow machine users must adjust timer values(DMA),pitch,tempo,
  273.        and may have to turn off oscillograph
  274.          as to the machine speed and the number of playing trak.
  275.  
  276.     For Fast machine users(above 386),I recommend,
  277.       you'd better have constant values
  278.         at the state of maximun number of trak(8).
  279.       In other words,do not change values frequently,
  280.         for your good hearing sense.
  281.  
  282.  
  283.  
  284.                      ----- File Format -----
  285.  
  286. offset 0                   : number of sample
  287. offset 1   - offset aaa    : sample name(each has 12 byte DOS filename)
  288. offset aaa - offset aaa+16 : length of traks(1-8) in words
  289.  
  290. next comes music data,
  291.  each data has word(2 byte) value.
  292.  
  293. X X X X X X X X    X X X X X X X X
  294. |_____| |_____|    |_| |_________|
  295.  
  296.  length   type    temp    note
  297.  
  298. type 0   musical note
  299.      1   sample
  300.      2   key
  301.      3   tempo
  302.      4   measure
  303.      5   repeat
  304.      6   tie
  305.      7   ending
  306.    8 - 15  reserved for later use.
  307.  
  308.  
  309.  
  310. Simple outline routine to read
  311.  
  312.         fi = fopen(fn,"rb");
  313.         num_sample = fgetc(fi);
  314.         for(c = 0 ; c < num_sample ; c++)
  315.            fread(sample_table[c],1,12,fi);
  316.         fread(length_trak,2,8,fi);
  317.         for(c = 0 ; c < 8 ; c++)
  318.         {
  319.            musicdata[c]=farmalloc(length_trak[c]*2);
  320.            fread(music_data[c],2,length_trak[c],fi);
  321.         }
  322.         fclose(fi);
  323.  
  324.  
  325.  
  326.  
  327.                      ----- Sample Files -----
  328.  
  329. *   Sample files larger than 64k is truncated.
  330.  
  331.     GTS treats samples as unsigned 8-bit raw file of 8000hz.
  332.     But .VOC(unpacked format) file which has sampling rate in itself
  333.        can be used by GTS.
  334.  
  335.     Other files(.au , .iff) must converted to
  336.       VOC or 8000hz 8-bit raw file by removing header.
  337.  
  338. **  But Raw file can have special header.
  339.       RATExx     xx is sampling rate of word(2 byte) in 80x86 reverse mode
  340.       LOOPxxyy   xx is begin of loop
  341.                  yy is end of loop
  342.  
  343.       Sample file can have either of the 2 informations,
  344.         or both of them,
  345.       But the order is RATE first.
  346.  
  347.       ex) RATExxLOOPyyzz$$$$$$^^^^^^^^
  348.  
  349.           --> 14 byte is header and real sound data begins from '$'
  350.  
  351.  
  352.  
  353. .How to make raw file header
  354.     1.make a 14 byte dummy header file "SAMPLE1.HED"
  355.     2.use binary editor to input hex values,
  356. *        Remember 80x80 reverse word mode,
  357.           so, 8000(0x1F40) must be entered as 401F
  358.     3.now combine header file and sample file
  359.       "COPY/B  SAMPLE1.HED+SAMPLE1.RAW  SAMPLE1.SAM"
  360.     4.ok,you made it "SAMPLE1.SAM"
  361.  
  362.                      ----- Converters -----
  363.  
  364.    .MOD2GTS : Amiga Modules --> GTS song file
  365.               its 7-bit sample --> 8-bit raw files with LOOP header.
  366.  
  367.       you can creat your own music by using that samples extracted.
  368.       The song itself doesn't tranlate perfectly,
  369. *       all effects including tempo,break   are ignored,
  370.           so you may have to insert appropriate tempo with your hand.
  371.  
  372.  
  373.    .VOC2RAW : VOC(unpacked) --> Raw file with RATE header.
  374.       VOC file are assumed to carry only sound data(01),
  375.         other informations(such as silence data,loop) are ignored.
  376.  
  377.  
  378.                      ----- Fix Rate (FIXRATE.EXE) -----
  379.  
  380. **  Some samples(extracted from Amiga Module)
  381.        may have not correct sampling rate,
  382.      then,Fix it with your own good hearing sense.
  383.  
  384.  
  385.  
  386.                      ----- Bugs -----
  387.  
  388.    I've tested this program only in my 20Mhz AT
  389.      with Sound Blaster compatible(Sound Master of Sung Il comp.)
  390.        and ATI VGA wonder.( I used 640x480x256 mode to draw oscilograph)
  391.    The lack of full test prevent me from naming this as Ver 1.00,
  392.    I'm very sorry for that.
  393. ** Anyway,in other system (386 or 486) this may not work properly.
  394.    In this case please report me.
  395.  
  396.  
  397.    These bugs are known to author,but not yet fixed in this version.
  398.  
  399.     1.Skip bar caluculation when draw current screen.
  400.     2.A bug When insert or delete between tie and bar.
  401.     3.Screen is not updated when replace sample.
  402.  
  403.     Semi-bugs
  404.  
  405.     1.Inefficient management of loaded sample in memory
  406.        --> Use Cache program.
  407.     2.Incorrect sampling rate of samples
  408.        --> Fix it with your own sense and FIXRATE.EXE
  409.  
  410.  
  411.  
  412.  
  413.                      ----- Author Comment (Future)-----
  414.  
  415.    I started this work in the job of
  416.       making assembly function for SVGA mode graphic.
  417.    At first,I planned to make playing routine also with full assembly code.
  418.     and made a schematic code(outline of assembly code) in Turbo-C,
  419.     tested and get a little good quality of sounds
  420.       to my exclamation of Speed of C language.
  421.    I am not a computer major nor have relations with computer,
  422.      so have other immedient works pending to do.
  423.    I've got to put off the work for the next version.
  424.    It's a pity I have no time for version up at the right now.
  425.  
  426.    But Later versions will include
  427.      complete assembly feature of DAC,
  428.      player version with various graphical display.
  429.      special notes treatment(allegro,adagio, p,mp,mf,f, stacatto,tremolo....)
  430.      full use of memory(Extended memory) for large samples,
  431.      more trak than 8 trak now,
  432.      automatic chord accompany,
  433.      and converters for .ROL .CMF .MID,if necessary and requested
  434.    All these jobs,It seems,I will start at Sep.1993.
  435.