home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 1: Collection A / 17Bit_Collection_A.iso / files / 785.dms / 785.adf / Pseted.doc / Pseted.doc
Text File  |  1997-10-19  |  8KB  |  249 lines
  1.  
  2.         PRESET LIST CREATOR INSTRUCTIONS
  3.         --------------------------------
  4.  
  5.     General Information:
  6.  
  7.         This program was written by Noyce of Phantastix Oftware Crew
  8.         after several hateful encounters with the previous preset
  9.         list editors.
  10.  
  11.         The program may be spread without any restrictions (which it
  12.         probably will if I want it or not) BUT this Instruction
  13.         file must be with it, cos' there is nothing I hate more than
  14.         a program which you could have the instructions to but some
  15.         slack person omitted it when he copied the program.
  16.  
  17.         To contact me regarding ideas to improve the program, or if
  18.         you find a bug (I'm sure it's not free of it since it's only
  19.         a couple of weeks old), then contact PXO at the following
  20.         address:
  21.  
  22.         Phantastix Oftware Crew
  23.         Skylvagen 5
  24.         S-175 43 Jarfalla
  25.         SWEDEN
  26.  
  27.  
  28.     Helpful Hints:
  29.  
  30.         When you add a disk or convert a disk with iff-samples, all
  31.         directories, info and the hateful '.fastdir' files are
  32.         omitted. There are also many shortcuts to the menu functions
  33.         if you use the right Amiga button and a key.
  34.  
  35.         The '<--' shows wich instrument is marked.
  36.  
  37.         Some functions can be canceled by pressing the 'ALT' key.
  38.  
  39.         The small figures under the string-gadgets are used to move
  40.         the wiew position of the preset-list. Starting from the upp-
  41.         er leftmost corner of the eight gadgets, they do this:
  42.         Up 5   instr
  43.         Up 24  instr (one page)
  44.         Up 100 instr
  45.         Up to start of list
  46.  
  47.         The lower gadgets have the same functions but go downwards.
  48.  
  49. -----------------------------------------------------------------------------
  50.  
  51.  
  52.     (1)        THE PROJECT MENU
  53.             ----------------
  54.  
  55.     1.1    Load
  56.  
  57.         Simply loads the preset list which is specified in the PLST
  58.         NAME gadget. The previous list will be destroyed.
  59.         The preset list    can have any name within the specified
  60.         filename length.
  61.  
  62.     1.2    Join
  63.  
  64.         Joins the preset list in memory with the preset list
  65.         file named in PLST NAME.
  66.         No checks are made to avoid duplicates.
  67.  
  68.     1.3    Display
  69.  
  70.         Displays the preset-list from the last position you were at.
  71.  
  72.     1.4    Write
  73.  
  74.         Saves preset list to the name in PLST NAME.
  75.  
  76.     1.5    New
  77.  
  78.         Clears the preset list in memory, there is no way to
  79.         get it back.
  80.  
  81.     1.6    Quit
  82.  
  83.         Leaves the Preset List Creator, and the list in memory will
  84.         be lost.
  85.  
  86.  
  87.  
  88.     (2)        THE EDIT MENU
  89.             -------------
  90.  
  91.     2.1    Add
  92.  
  93.         This entry has a sub-menu which allows the user to add either
  94.         a whole disk with samples or only a single sound which is
  95.         specified in the INSTRUMENT, DISK, LENGTH, REPEAT and
  96.         REPLEN gadgets.
  97.         The size of the sample is limited to 131070 bytes, since that
  98.         is the limit of the sample length in the DocSoundtracker 2.2
  99.         The previous limitations of sample length has been up to the
  100.         program that creates the preset-list.
  101.         The disk-name gadget defines the name of the sample-disk, and
  102.         even here the restriction from previous preset-list editors
  103.         has been removed. The disk-name can be anything that follows
  104.         the rules of AmigaDos and is 6 (six) letters long including
  105.         the colon (':').  The DocST 2.2 accepts this as well as the 
  106.         standard ST-XX disk-names.
  107.  
  108.         The REPEAT value is bounded within the limits of 0 to 65535,
  109.         and this is the value that decides the start of the loop.
  110.  
  111.         And finally the REPLEN gadget, this decides the length of
  112.         the loop, this can be up to 131070 bytes.
  113.  
  114.         If no loop is desired, the values 0 for REPEAT and 2 for
  115.         REPLEN should be entered. (This is also the default value.)
  116.         NOTE! The Add function doesn't check for duplicates in the
  117.         preset list.
  118.  
  119.  
  120.     2.2    Sub
  121.  
  122.         This function removes samples from the preset list, either
  123.         you specify the disk and choose the Sub Disk function or you
  124.         use the Sub Instr function after entering the instrument name
  125.         and disk name.
  126.  
  127.         The preset list editor will ask if you want to start removing
  128.         instruments form the mark. The mark is located at the instr-
  129.         ument that was found when the find fuction was last used.
  130.  
  131.     2.3    Replace
  132.  
  133.         This function should be used if you already have a sound in
  134.         the preset list that doesn't have a loop, and you want to
  135.         assign a loop to it.
  136.  
  137.         First enter the instrument and disk name.
  138.  
  139.         Then use the Find function (se 2.4) to see if the instrument
  140.         exists in the list.
  141.  
  142.         If it does exist, enter the correct length and the repeat
  143.         values in the appropriate gadgets and use the Replace
  144.         function.
  145.  
  146.         Your instrument now has the new repeat points.
  147.  
  148.         Be sure to use the find function before you use replace since
  149.         it removes the instrument which is marked in the list.
  150.  
  151.     2.4    Find
  152.  
  153.         You use this function to find a instrument in the preset
  154.         list. To use it, enter the name and disk and then use the
  155.         Find function. If you want to use the wildcard option, then
  156.         enter the first letters you want to look for followed by an
  157.         asterisc (*) in INSTRUMENT and the disk in DISK NAME. After
  158.         that, use the Find First option and then for each new
  159.         search the Find Next command.
  160.  
  161.         The numbers displayed after the Instrument are the following:
  162.  
  163.         The first is the length of the sample in bytes.
  164.         The second the repeat start value.
  165.         And the last one is the repeat length.
  166.  
  167.     2.5    Trace
  168.  
  169.         Displays the preset list from the instrument that was last
  170.         found (the marked instrument).
  171.  
  172.     2.6    Sort
  173.  
  174.         This function will sort the preset list either regarding the
  175.         disk name or not. If you use the Sort On Disk function, all
  176.         ST-01: samples will appear first in alphabetical order (or
  177.         whatever disk comes first in the ascii table).
  178.  
  179.         At this stage the sort routine is pretty slow but it will
  180.         soon be changed, so watch out for upgrades.
  181.  
  182.  
  183.  
  184.             THE CONVERT MENU
  185.             ----------------
  186.  
  187.     3.1    Iff
  188.  
  189.         This unique function lets you convert iff samples (or whole
  190.         disks with iff-sounds) to raw data. It checks out if the
  191.         sound is looped or not and gives you the right numbers to
  192.         enter in the preset list. If a sound on the disk is not an
  193.         Iff-file it will be ignored. The program reads the file,
  194.         checks repeat points and saves back the raw data file to disk
  195.         so be sure to have a backup of your disk if you want to keep
  196.         the looped iff-sounds.
  197.  
  198.         If you wish, the program adds the instruments automatically to
  199.         the preset list, and if you want to pause the display of a
  200.         sample,    just hold down the LEFT mouse button and the program
  201.         will wait until you let go of it.
  202.  
  203.         When only one sample is to be converted, enter the name in
  204.         the INSTRUMENT gadget and disk in DISK NAME, and use the Iff
  205.         Instr function.
  206.  
  207.     3.1    16 bit
  208.  
  209.         Yet another feature which you won't find in any other preset-
  210.         list editor.
  211.  
  212.         This feature lets you convert 16-bit samples to 8-bit Amiga
  213.         samples. It works in the same manner as the Iff-conversion,
  214.         but as you understand, only raw-format samples can be con-
  215.         verted and the old samples will be overwritten.
  216.  
  217.  
  218.  
  219. -----------------------------------------------------------------------------
  220.  
  221.  
  222. Quick overview:
  223. ---------------
  224.  
  225.    PROJECT
  226. 1.1    Load    -   Loads the preset list
  227. 1.2    Join    -   Joins two preset lists
  228. 1.3    Display -   Shows the preset list
  229. 1.4    Write   -   Saves preset list
  230. 1.5    New     -   Clears preset list
  231. 1.6    Quit    -   Leaves the program
  232.  
  233.    EDIT
  234. 2.1    Add     -   Adds instruments to preset list
  235. 2.2    Sub     -   Subs instruments from preset list
  236. 2.3    Replace -   Substitutes the instruments parameter with those entered
  237. 2.4    Find    -   Looks up the specified file and shows instrument data
  238. 2.5    Trace   -   Shows the list, starting at mark
  239. 2.6    Sort    -   Sorts the preset list
  240.  
  241.    CONVERT
  242. 3.1    Iff     -   Converts iff-files to raw data
  243. 3.2    16 bit  -   Converts 16-bit sounds to 8-bit
  244.  
  245.  
  246.                     Noyce of PXO crew 890328
  247.  
  248.  
  249.