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