@database BSP.guide
@$VER: BlaBla Sample Player 2.9 Dokumentacja
@author "Szczepan/BlaBla"
@(c) Marcin Juszkiewicz

@node "MAIN" "BlaBla Sample Player 2.9"

               __________ _  _                 _  _ __________
  _  _ _______/ ._______       _______._______   ._______     \_______ _  _
  ._______      |      /___.___\_____ |      /___|      /___.  ___________.
  |      /______|__.  /    | _______  |     /___ |     /    |__\_________ |
  |     /_________ |-------'----------'----------'----------'__________   |
  `----------------' -  - ------- pRESENTs ------- -  -  `-------------tF!'

                           @{b}BlaBla Sample Player 2.9@{ub}
                            autor : Szczepan/BlaBla

                               @{b}Contents : @{ub}

            1. @{" Copyrights and distribution.           " link Prawa}

            2. @{" Introduction.                          " link intro}
            3. @{" System requirements.                   " link req}
            4. @{" Instalation.                           " link installation}
            5. @{" Running.                               " link usage}
            6. @{" GUI usage.                             " link GUI}
            6. @{" History of program.                    " link History}

            7. @{" BlaBla? What's that?                   " link BlaBlainfo}
            8. @{" Something about Author                 " link Author}
            9. @{" Few words to translators               " link translators}


@endnode

@node Prawa "Copyright and distribution"

                              @{b}Copyrights@{ub}

This program is subordinated to @{"Standard Amiga FD-Software Copyright Note" link AFD-COPYRIGHT/main 167}.

This program is GiftWare, which is specified in item @{" 4g " link AFD-COPYRIGHT/main 91}.

For more informations you should read  @{"AFD-COPYRIGHT" link AFD-COPYRIGHT/main 1}
(version 1 or newer).


      @{" Copyright       " link AFD-COPYRIGHT/main 28}
      @{" Distribution    " link AFD-COPYRIGHT/main 42}
      @{" Disclaimer      " link AFD-COPYRIGHT/main 60}
      @{" Return Service  " link AFD-COPYRIGHT/main 76}

@endnode

@node "intro" "Introduction"

  On Intel Outside IV party Def/Floppy asked me about writing program to
playing samples. I said OK - and wrote BSP 1.0 which played only RAW samples
without allocating audio.device. But I'm member of @{"BlaBla" link blablainfo} group so program
must be 100% system compatible - it is version 2.0 which plays samples using
datatypes.

@endnode

@node "Installation" "Installation"

  Copy BSP to C: and use it.

@endnode

@node "req" "Requirements"

  Because datatypes program needs OS 3.0 and :

      Asl.library        v.37+
      DataTypes.library  v.39+
      Sound.datatype

@endnode

@node "Usage" "Running"

@{b} Running From Cli/Shell@{ub}

      BSP FILE/A

          - FILE - sample to play (not needed)

@{b} Running From Workbench@{ub}

      No parameters are taken when running from WB.

  When BSP is ready you can drop samples on it's window - it's AppWindow.

@endnode

@node "Author" "Author"


 Contacting the author

@{b} Snail :@{ub}

             Marcin Juszkiewicz
             ul. Wojska Polskiego 15/7
             19-400 Olecko
             Poland

@{b} E-Mail :@{ub}

             szczepan@student.man.bialystok.pl

@{b}    WWW :@{ub}

             http://student.man.bialystok.pl/szczepan/

@endnode

@node "History" "History"

  1.0 - first working version

  2.0 - from now only datatypes are used

  2.1->2.7 - big changes :
      - disabling sliders when ProTracker modules are selected
      - corrected errors handling
      - removed start and stop gadgets

  2.8 - new corrects

  2.9 - shortcut "q" now works

@endnode

@node "BlaBlaInfo" "What is BlaBla"

   @{b}@{fg shine}BlaBla@{ub}@{fg text} is a Polish biggest system programmers group. We make the system
friendly programms. We guarantee that our programs will run on almost every
machine (@{fg fill}Amiga@{fg text} of course), including future ones. All our programs are
running in multitasking, and all of them are PD, Freeware, or Shareware.

   Our organisation has a few members (we "absorb" only good programmers),
an own e-mail address. Our newest productions you can find in Aminet
(search for 2b_ files) and in our PD library called "@{b}Polware@{ub}".
Our texts, articles you can also find in our disk-mag "@{b}Izviestia@{ub}" (sorry, in Polish!).

   @{b}@{fg shine}BlaBla@{ub}@{fg text}  group  is  well-known  in Poland, and programs signed with
"Blabla"  are  for  sure very good. We made many productions, we help many
young  programmers, we write articles to Polish edition of @{b}Amiga Magazine@{ub},
@{i}we try to do all, for our beloved computer - Amiga!@{ui}

Our InterNet HomePage     : @{b}http://www.gliwice.pl/~thufor/@{ub}
Our contact email address : @{b}blabla@zskl.p.lodz.pl@{ub}

@endnode

@node Translators "Some words to translators"

  If you want translate this documentation for any other language DO IT and
send me translation.

@endnode

@node gui "How to use GUI"

  File   - filename
  Load   - loading new sample (shortcut "l")
  Lenght - lenght of sample data (16-bit samples -> data = ~0.5* filelenght)
  Type   - sample type

  End    - slider for setting end of data to playing (shortcut "e" and "E")
         - place for writing end of data

  Freq   - slider for setting playing frequency (shortcut "f" and "F")
         - place for writing frequency

  Volume - slider for setting playing volume (shortcut "v" and "V")
         - place for writing volume

  Play   - let's play (shortcut "p")
  Quit   - simply quit (shortcut "q" - not working)

@endnode