Copyright (c) 2012-2016 Hyperion Entertainment and contributors.

Bars & Pipes Professional

From AmigaOS Documentation Wiki
Jump to: navigation, search

Author and Copyright

This documentation is based on the original copyrighted manual.
Copyright (c) 1993 The Blue Ribbon SoundWorks, Ltd.

The original documentation has been modified and enhanced where needed to reflect the changes made to the AmigaOS 4 specific port.

All changes and modifications are
Copyright (c) 2013 Lyle Hazelwood and Steven Solie.

Explicit written permission to copy and edit the original manuals has been secured.

Welcome Aboard!

These documents are for the AmigaOS 4 port of Bars & Pipes Professional. A few notes may be useful: The original program will be referred to as Bars & Pipes Professional, the AmigaOS specific port will be called Bars & Pipes Professional for AmigaOS instead.

This port is based on Bars&Pipes Professional version 2.5c. The AmigaOS 4 version was provided by Alfred von Faust, and he worked for many years to keep it alive. Lyle Hazelwood has recently taken the port over and is continuing to keep the program current.

Thank you for downloading Bars & Pipes Professional. In the pages to come, you will understand why you've made an important choice. With Bars & Pipes Professional, you're truly bound only by the limits of your own creativity. We encourage you to read this manual, since it contains thorough explanations of Bars & Pipes Professional's wide array of features. Bars & Pipes Professional is a high-end MIDI sequencing and composition package. In order to use it, you must have a MIDI sound module or keyboard connected to your Amiga via a CAMD supported MIDI interface.

Note
If you would like to use the Amiga's Internal sounds instead of MIDI, we suggest SoftSyn available at OS4Depot.

Everyone at The Blue Ribbon SoundWorks is dedicated to producing the highest quality software and software support in the industry. We have invested thousands of hours of research and development in our products. Much of that time is spent in listening to and learning from people like you. Blue Ribbon products are designed to be affordable, ongoing investments that are improved and expanded over time. We've provided expansion through program updates and add-on software, such as the Creativity Kit and the Pro Studio Kit. If you are a C programmer, with the Rules For Tools add-on, you can even create your own enhancements to Bars & Pipes Professional!

Installation

Quick Installation

Bars&Pipes Professional is easy to install on your AmigaOS computer.

To install Bars&Pipes Professional:

  1. Make sure that you have at least two megabytes of space left on your hard disk.
  2. Unarc the Bars&Pipes Professional archive to wherever you'd like to keep the program.
  3. You'll also need camd.library which is already included with AmigaOS.
  4. Run Bars&Pipes Professional from the drawer on your hard disk.

On the first run, Bars&Pipes will ask you to select a screen mode. Please select an ARGB mode for best results. Once the program is open, under the "Preferences" menu, select "Environment" and then "Save" to save your screen choice.

Touring the MIDI setup

Overview

Bars&Pipes Professional works with any CAMD-compatible synthesizer, sound module or application. Let's look at some standard ways to connect MIDI instruments to your Amiga computer.

The MIDI Interface

In order to use Bars&Pipes Professional, you must first own a MIDI interface. The MIDI interface serves as a translator between your MIDI instrument(s) and your Amiga.

Before using Bars&Pipes Professional, first connect your MIDI interface to your Amiga. It may connect to a sound board joystick port, or to USB.

MIDI Interface Ports

Most MIDI interfaces feature one MIDI in, one MIDI out, and possibly one MIDI thru port. The MIDI in and MIDI out ports are the most important aspects of a MIDI interface.

Multiple MIDI In Ports

CAMD supports any number of MIDI Inputs and Outputs. While it is possible to set the input and output individually for each track, you can (and should) set a default input and output that will be used as defaults for every track that does not have an input or output specified. These are set and saved from the Preferences/Environment window.

Connecting MIDI Devices
Connect the MIDI OUT from your interface to the MIDI IN on your synth or sound module.

Connect the MIDI OUT from your keyboard or other instrument to MIDI IN on your interface.

If your MIDI gear has a USB port, CAMD may be able to access it directly by using the USB Driver

(is the usb MIDI driver part of the OS??)

A Quick Tour

Introduction

Bars&Pipes Professional is an innovative composition environment with an extensive arsenal of features and options. Before exploring it in depth, let's take a quick tour!

Note
If you need help connecting your MIDI equipment to your Amiga, please read Touring The MIDI Setup.

Running Bars&Pipes Professional

Before you run Bars&Pipes Professional, you must first install it. If you have not yet done so, please see Installation.

Running From The Workbench Icon

You can run Bars&Pipes Professional from Workbench by double-clicking on its program icon.

Doing so opens Bars&Pipes Professional with an empty Song. Alternatively, you can double-click on a Bars&Pipes Song icon. Doing this opens Bars&Pipes Professional with the selected Song already loaded.

Running From A Shell

You can also run Bars&Pipes Professional from a shell. Make sure your stack size is at least 100,000 bytes when running the program this way.

The Default Screen Setup

When Bars&Pipes Professional first starts up, you'll see the Tracks window and a group of icons along the right side of the screen. These icons represent various unopened windows.

Double-click on any icon to open its associated window. Click on the close button in the top left corner of an open window to revert it to its associated icon.

The Tracks Window

Tracks.png

The Tracks window represents the heart and soul of Bars&Pipes Professional. It is where multi-track recording takes place. It is also the primary place for organizing the PipeLines and Tools which give Bars&Pipes Professional so much of its power and flexibility. Let's take a brief look:

The PipeLine

PipeLine.png

The Tracks window contains individual Tracks, into which you will record your music. These Tracks run from left to right in rows, with measure and beat lines drawn from top to bottom.

Starting from left to right, each Track contains the following components:

  • The Track Name, which identifies a particular Track;
  • The Input Selector box, or Input Arrow, which selects which Track(s) are to receive incoming music;
  • The Input PipeLine, which holds Tools that process the music as it flows into the Sequencer;
Note
When first running Bars&Pipes Professional, you will most likely see a MIDI In Tool in the Input PipeLine. This acts as the source for the Track's PipeLine, and, hence, the Track. This is further explained in Basic Recording.
  • The Play/Merge/Record Selector, which displays a blue letter P while the Track is in Play mode, a red letter M while the Track is in Merge mode, and a red letter R while the Track is in Record Mode;
  • The Sequencer area, which holds and displays the MIDI events, or Sequence, that make up the recording;
  • The Thru/Play Only/Mute Selector, or faucet, which switches the Track between Thru, Play Only, and Mute modes;
  • The Output PipeLine, which holds Tools such as the MIDI Out Tool that process the music as it flows out of the Sequencer; and
  • The MIDI Channel Selector, or Output channel, which displays the MIDI channel over which the final MIDI Out Tool sends.
Note
This selector is used by the standard MIDI Out Tool. Non MIDI-specific output Tools, such as most Multi-Media Tools, do not need MIDI channels.

The Flags Area

Flags.png

Above the Tracks area is the Flags area.

Bars&Pipes Professional uses these flags to mark specific points in music time for certain operations, such as punch in and auto-locate. It also displays the current time signature and measure numbers in this area.

Bars&Pipes Professional displays twelve Flag icons across the top of the Tracks. You can grab these with the mouse and drag them from left to right. Use the Flags to set positions in your music for editing, recording, looping, and more.

A Flag appearing during the displayed section has an attached vertical stem intersecting all of the Tracks. If you've placed the Flag in a measure which precedes the displayed section, it appears on the left side of the Sequencer. If you've placed it in a measure that follows the displayed section, it appears on the right.

To relocate a Flag, first scroll the Sequencer so that the desired location shows in the Sequencer. Then drag the Flag to its position. To move a Flag to the beginning of the Song, drag it all the way to the left side of the screen. To move it to the end of the Song, drag it all the way to the right. Flags snap to the alignment specified in the Align with... option in the Preferences menu.

The following Flags are found in the Flags area:

  • The Position Marker Flag or Song Position Flag (the red triangle with the blue border) which shows the current position in your Song;
Note
If you press the Play button, your Song starts at this point.
  • The two Edit Flags (solid purple triangles), which determine the part of your Song that is affected by Cut, Paste, and other editing operations;

The Auto-Locate Flags (blue rectangles marked M1 through M4), which mark important points in your composition;

Note
You can immediately move to these points by using the corresponding M1 through M4 buttons in the Transport Controls window.
  • The Punch In and Punch Out flags (yellow rectangles marked IN and OUT), which allow you to record over a restricted part of your Song;
  • The Loop Flags (red rectangles containing curved lines with arrows), which mark sections for use with Loop-Mode editing and the Loop Tool; and
  • The Stop Sign (the red hexagon with the white border), which marks the point at which Bars&Pipes Professional is to stop playback.
Note
This feature is useful when you want to sit back and listen to part of a Song while you're away from the keyboard, or if you're performing live or recording a sequence to tape and want the Song to stop upon completion.

Control Buttons

ControlButtons.png

The Tracks Window's control buttons are above the Flags area.

From left to right are the following buttons:

  • The Solo button, which both chooses and displays whether the highlighted Track is soloed, muted, or neither;
  • The ToolPad, which holds up to sixteen Tools to be used with the Toolize feature;
  • The Group selector buttons, which identify combinations of Tracks;
  • The Group button, which determines if clicking on a Track adds to a group or not;
  • The Up/Down arrows, which move the highlighted Track up or down in the list of Tracks;
  • The Tempo button, which chooses and displays the current tempo;
  • The Start button, which starts the Sequencer from the beginning of your composition;
  • The Play button, which starts the Sequencer from the current Song position, denoted by the red and blue triangular Song Position Flag, found in the Flags Area;
  • The Rewind button, which moves the Song Position Flag to the left, toward the beginning of the piece;
  • The Fast Forward button, which moves the Song Position Flag to the right, toward the end;
  • The Measure display, which shows the measure number in which the Song Position Flag currently resides; and
  • The Record button, which chooses and displays whether the Sequencer is in record or playback mode.
  • Sizing And Scrolling The Tracks

Use the scroll bar and arrows on the right side of the Tracks window to scroll through the Tracks, in order to view those which don't fit in the display.

At the bottom of the Tracks window, you'll find a set of scroll bars, single arrows, and double arrows. Use the scroll bar and single arrows to search forward and backward. For example, to scroll the Track names from left to right, use the scroll bar and single arrows below the list of Track names.

Use the double arrows to resize sections of the display by dragging the arrows from left to right. With the double arrows, you can resize your display to show only what you want to view.

Note
You can control how much space is available by using different screen resolutions. Lower resolutions like 800X600 will make everything large and easy to read, while higher resolutions will provides plenty of room for additional Tracks.

The Main Menu

As you may know, in the Amiga's windowing environment each window can have a different menu. Some of the windows in Bars&Pipes Professional do have their own menus, however, most share one menu, the Main menu.

To access the Main menu, click on the Tracks window or the background with the left mouse button. Then, to select one of the Main menu options, click and hold the right mouse button, while moving the mouse pointer to your desired selection.

Window Icons and the Windows Menu

Several windows in Bars&Pipes Professional are accessible from both icons, located at the right side of the screen, and menu commands, located in the Windows menu found in the Main menu set.

Window Icons

To the right of the Tracks window, you'll see a column of icons. These icons represent various windows. Double-clicking on an icon opens the window, while clicking on the close gadget of a window turns it back into an icon.

Note
The Tracks window itself can be closed and turned into an icon. To do so, click on the close gadget in the upper left hand corner of the Tracks window. The close gadget looks like a square with a smaller square inside of it. Notice that the Tracks window turns into an icon of railroad Tracks. Double-click on the Tracks icon to reopen the window.

The Windows Menu

Each window can also be accessed from the Windows menu in the Main menu. This includes many additional windows that do not have icons. Let's take a quick tour of all the windows in the Windows menu. As we do this, we'll get a quick glimpse of the various capabilities of Bars&Pipes Professional. Open each window by selecting it in the Windows menu. If a window has an Icon, notice that the icon disappears. Close the window by clicking on its close button (top left.) You might also experiment with double-clicking on the window icons to become familiar with each.

WindowsMenu.png
Accessories
Accessories are separate modules that add new features to Bars&Pipes Professional. Use the Accessories window to install, use and remove your Accessories. The Accessory window may also be opened by double-clicking on its icon.
ClipBoard
When the ClipBoard window is open, cut copy and paste editing operations store and retrieve from it. Use this to move music around between different parts of the program. The ClipBoard window may also be opened by double-clicking on its icon.
Define...
You can define your own Scales, Chords, Rhythms, and Patch Lists using the four Define windows opened from the submenu.
Edit PadTool Controls
If you have a Tool in the ToolPad, the Edit PadTool Controls command opens the Control window for that Tool.
Icons
The Icons window allows you to keep all of the window icons in their own separate window. Opening the Icons window automatically collects the window icons and places them inside the Icons window. Closing the Icons window causes the window Icons to return to their previous positions.
Information
The Information window provides useful information about the state of your project and computer. The Information window may also be opened by double-clicking on its icon.
Master Parameters
The Master Parameters window accesses a special master Track where you may set up global Time Signature, Lyrics, Scales, Chords, Dynamics, and Rhythm changes. The Master Parameters window may also be opened by double-clicking on its icon.
Media Madness
The Media Madness window brings multi-media production to Bars&Pipes Professional. With this window, you can place Multi-Media Tools in each Track, and edit a complete Multi-Media presentation. The Media Madness window can also be opened by double-clicking on its icon.
Metronome
Use the Metronome window to set up your metronome click - internal Amiga audio, MIDI or visual. The Metronome can also be opened by double-clicking on its icon.
Mini Transport
The Mini Transport window provides a subset of the main Transport Controls window (see below.) It's designed to be small and innocuous. You can open it from anywhere simply by pressing the 'M' key on your keyboard.
Mix Maestro
Use Mix Maestro to do a complete automated mixdown of your performance. Mix Maestro provides a volume slider and pan pot for each Track. As the Song plays, drag the slider to lower or raise the volume and turn the knob to rotate the sound left or right. Mix Maestro memorizes your moves and plays them back faithfully. The Mix Maestro window can also be opened by double-clicking on its icon.
Record Activation
By default, when Bars&Pipes Professional's Sequencer records into a Track, it erases all MIDI event types (note, pitch bend, etc.) and replaces them with the new. However, with the Record Activation window you can tell the Sequencer to ignore specific MIDI types. For example, you can set it to record over pitch bend while leaving notes intact. The Record Activation window may also be opened by double-clicking on its icon.
Set Flags
The Set Flags window allows you to position any Flag in the Track's window by typing in the location you want for the Flag, either in music or SMPTE time. Open the Set Flags window by choosing Set Flags from the Main menu's Windows menu, or double-click on the Set Flags icon.
To determine music time or SMPTE time, click on the SMPTE/Music Time button. To change the Flag, click on the numbers to the right of the Flag representation.
Song Construction
Edit your music at the highest level with the Song Construction window. Create, drag, duplicate and erase everything from individual measures to entire sections. The Song Construction window can also be opened by double-clicking on its icon.
Tempo Map
Use the Tempo Map window to create a graphical Tempo Map for your performance. With a Tempo Map, you can tell Bars&Pipes Professional when to speed up and slow down as it plays your music. The Tempo Map window can also be opened by double-clicking on its icon.
Tempo Palette
You may set four preset Tempos in the Tempo Palette window, and then switch instantly to anyone at any time. The Tempo Palette can also be opened by double-clicking on its icon.
Time Line Scoring
Connect several Songs into one performance on a SMPTE time line using the Time Line Scoring window. This is useful for laying out an extended piece where different Songs occur at different times. The Time Line Scoring window can also be opened by double-clicking on its icon.
ToolBox
The ToolBox window displays several rows of square icons. These represent Tools. Each Tool can be placed in a Track's PipeLine where it performs a specific task to the MIDI music as it flows through the pipe. To place a Tool in a PipeLine, click on the Tool with the left mouse button, and, while holding the button down, drag the Tool to the destination Track's PipeLine. Although the ToolBox displays a palette of available Tools, you may install more Tools, create your own Tools, as well as remove Tools from Bars&Pipes Professional, thereby changing the collection of available Tools in the ToolBox. The ToolBox can also be opened by double-clicking on its icon.
Tracks
This command opens the main Tracks window, which is also accessed by double-clicking on its icon.
Transport
This window provides the complete set of commands to control the movement of Bars&Pipes Professional's Sequencer. Notice that the Transport window duplicates many of the commands found in the top of the Tracks window as well as all the commands in the Mini Transport. You may click on identical buttons to achieve identical results. The Transport Controls window displays the current time in music time (Measures, Beats and Clocks) as well as SMPTE time (Hours, Minutes, Seconds and Frames.) It also adds additional buttons for using the Punch and Loop Flags as well as setting and using all of the Flags. The Transport window can also be opened by double-clicking on its icon.

Sections

Bars & Pipes Professional: Playing a Demo Song File

Bars & Pipes Professional: Recording

Bars & Pipes Professional: Tools

Bars & Pipes Professional: Note Editing

Bars & Pipes Professional: MIDI Event Editing

Bars & Pipes Professional: Editing Song Parameters

Bars & Pipes Professional: Printing Notation

Bars & Pipes Professional: The List Editor

Bars & Pipes Professional: System Exclusive

Bars & Pipes Professional: The Metronome

Bars & Pipes Professional: The Transport Controls

Bars & Pipes Professional: Timing, Syncing and Tempo

Bars & Pipes Professional: Tempo Mapping

Bars & Pipes Professional: Advanced Sequencing

Bars & Pipes Professional: Multi-Track Editing

Bars & Pipes Professional: Song Construction

Bars & Pipes Professional: Mix Maestro

Bars & Pipes Professional: Time Line Scoring

Bars & Pipes Professional: Create-a-Tool

Bars & Pipes Professional: Tool Trays

Bars & Pipes Professional: Scales, Chords, Rythms and Patches

Bars & Pipes Professional: Customizing Your Environment

Accessories

Accessories can be loaded by openeing the accessories window and selecting "load" from the menu. At this time SmerFF is the only accessory available. It allows loading and saving MIDI files.