This is the barswrapper,a plugin for hd-rec that allow the use of
Bars&Pipes Plugins and the SuperJam (a automatic band) accessory.
Some tools are add from the original Bars&Pipes package for easy use

It stand under GPL and special B&P License.
;
;
;(c) Copyright 1988-1994 Microsoft Corporation.

;Microsoft Bars&Pipes Professional Source Code License
;@@1

;This License governs Use of the accompanying Software.
;Microsoft hopes you find this Software useful.

;You are licensed To do anything you want with the Software.

;In Return, we simply require that you agree:

;1.      NOT To remove any copyright notices from the Software.

;2.      That the Software comes "as is", with no warranties.
;        None whatsoever. This means no implied warranty of merchantability OR
;        fitness For a particular purpose OR any warranty of NOn-infringement.
;        Also, you must pass this disclaimer On whenever you distribute the Software.

;3.      That we will NOT be liable For any of those types of damages known as indirect,
;        special, consequential, OR incidental related To the Software OR this License,
;        To the Maximum extent the law permits. Also, you must pass this limitation of
;        liability On whenever you distribute the Software.

;4.      That If you sue anyone over patents that you think may apply To the Software
;        For that persons Use of the Software, your license To the Software ends automatically.

;5.      That the patent rights Microsoft is licensing only apply To the Software,
;        NOT To any derivatives you make.

;6.      That your rights under the License End automatically If you breach this in any way.


1 use of Bars Wrapper is using the Sampler and Bars&Pipes plugins
(Sampler with 24 db Realtime reso Filter and freeform envelopes in this archive)

2. layer sounds or tools and load them from library.a quick start is:

Copy whoole dir barswrapper in the hd-rec plugin Folder.

Make sure midi is activate in HD-Rec prefs Page
Start the VM49 Keyboard.(Menu plugins VM49->start)
klick on channel 1 and choose port 5 from menu of VM49
Start barswrapper(Menu plugins barswrapper->start)
(left upper button active by default is Channel 1)
Click library button
Now choose a sound from the listview and doubleclick
Play a few notes with the VM49 Keyboard.If you are unhappy with that sound
choose next/prev (numpad + or -)

Layer Sounds

Now click on 2. button.
Again choose a sound.Now if 1 note is play both sounds are play.
You see you are able to layer sounds very easy.Double click a tool
and go to the patch page to modify the velocity/transpose/cutoff/reso/pan
Mixerchannel/envspeed if you wish,
or go to other pages and modify the rest of paramters.

If you are happy with your sound insert a name in the stringgad in library
and press save.
If you want save whole layer create a macro Tool,double click on it
Now insert the sounds in the tools slot.
If you are in a macro you are ask then if you want save
single sound or whole macro

You can also use the library to manage your Hd-rec Elements
It work with Audio Data and midi Data.Press elements in the browser

If no Element is select in hd-rec a new element is add.
If a Element is select this Element is replace.

Note: Make sure your replace Element is not larger then your selectet element

Try out in directory drums_element the example patterns.

If you experiment with that more you see that simple Note Sequences
sound very great when you layer sounds.This layer sounds can save in macros
or single voices to the libray without a banklimit.You can add own directories
can add to each sound a 85 Char comment to explain the sound more
can compare sound easy.

You can also copy original B&P Tools you want to the
hd-rec/plugins/barswrapper/ptools folder.

I know no bugs.If you find some please report.Tools i test and work

transpose
arpeggi8
arpeggiator
echo
A_List (the midi data watchout tool)
guitar
Velocity Modifier
Doctor of velocity
Pitch Modfier
Keyboard Splitter
Velocity Splitter
Mu80 Tools

Other tools may work or not,i not test them all.The Bars&Pipes API
have over 200 functions,maybe there are bugs still in

If you find any problem it is important that you report the
tool and bug,or it stay maybe forever in.

I have no time/knowledge how tools work to test them all.
So its good,if you mail me the name of working tools to add them to working list
or report nonworking tools

Limits: because B&P is a Soft from Kick1.3 age
        that is topaz 8 based and use a diffrent
        Palette than AmigaOS 2.0 for 3D look,the Tools look not very nice
        when they use selfcode graphic icons.When a tool use the B&P API
        to create a button or slider all colors look ok
        If you want another backgroundpattern you can replace the pattern file in the dir

Real nice look can only give if the Tool too support fontsizes amd scale
the positions depend on fonts.All layout stuff buildin in
Bars&Pipes is in bars wrapper full fontsensitive and have full >OS2 3D look

If you change first P to be uppercase your tool is not load in
so its easy to handle what tools are load

Example: test.Ptool,dont load test.ptool

Also if someone have time to write better docu is welcome

Some Hints for things thats not clear

If no tool is in this slot you can double click to choose a tool to add here.

If you want copy a tool from normal to a macrotool you need select the tool
click button copy.Then hold shift and click on macrotool.Now the macropage
open and you can click on the place to what it copied.

Branches can done when you double click on branch tool
and choose the sender tool.

If you have questions please ask,or send your feedback,suggestions

;Under GPL Author: Bernd Roesch <nospamname@web.de>

