BTDSys Peer Library Documentation

Introduction

BTDSys Peer Library is a library for programming peer machines for Buzz.

Completely rewritten, no pointer hacks whatsoever. Incompatible with all Buzz builds before 1042, especially the October 2000 one.
There is no longer any need to call CPeerCtrl::CheckMachine() at regular intervals. Indeed, there's no such thing as CPeerCtrl::CheckMachine() now.
However, you must use CPeerCtrl's handlers for add and delete machine events. See CPeerCtrl::SetEventHandlers().
There is a new form of constructor which takes no arguments -- you can instead provide the arguments via CPeerCtrl::Init(). So you no longer need to allocate all your CPeerCtrl objects on the heap using the "new" operator (although that way still works, so no need to change old code).
Better handling of target tracks. You can specify a track number in CPeerCtrl::AssignParameter(), and it becomes the default for control changes and is stored in the song file.
CPeerCtrl::ControlChange_NextTick() is deprecated, although it is still available if you add PEERLIB_NEXTTICK to your project's C++ preprocessor definitions.
Batch mode for ControlChange_Immediate, intended for controlling multiple parameters on the same target machine. See CPeerCtrl::BeginImmediateBatch().
Automatically interfaces with a new version of BTDSys PAL (Peer Assignment List). Unlike the old version of PAL, no extra code or "palpal" DLLs are required.

"Porting" old machines to PeerLib2 should be relatively simple:

Include the new peerctrl.h, remove peerctrl.lib from your linker options, and add peerctrl.cpp to your project.
Remove all calls to CPeerCtrl::CheckMachine() (consider using CPeerCtrl::GotParam() if the call was a condition for an if statement).
Add this to your Init or MDKInit function:
```
 CPeerCtrl::SetEventHandlers(pCB); 
```
or if you have your own event handlers for gAddMachine and gDeleteMachine, call CPeerCtrl::OnAddMachine() and CPeerCtrl::OnDeleteMachine() from there.
Remove all calls to CPeerCtrl::ControlChange_NextTick(), and make sure you only call CPeerCtrl::ControlChange_Immediate() from your machine's Work() function (i.e. not from Tick()). Optionally, you may wish to enclose all calls to CPeerCtrl::ControlChange_Immediate() in a given Work() call between CPeerCtrl::BeginImmediateBatch() and CPeerCtrl::EndImmediateBatch().
(Optional but recommended) Give each CPeerCtrl instance a label to be displayed by PAL, using CPeerCtrl::SetLabel() or CPeerCtrl::SetLabelAsTrackNumber().
(Optional but recommended) Add a new menu command, "Show PAL...", whose handler calls
```
 CPeerCtrl::ShowPAL(); 
```

And it's as simple as that :)