<html>
<HEAD>
<TITLE>MusicWeaver README</TITLE>
</HEAD>
<BODY>
<center><H1>
MusicWeaver README
</H1>
<h3>Release 1.3 --  for  BeOS R4 --PPC and Intel</h3>
<h3>August 1999</h3>
</center>
This release 1.3 embodies an extensive upgrade of the central Weaver program,
but as far as the modules go there are only small changes since 1.2.1 (May '99).
<P>
<CENTER>====================</CENTER>
<BR>
Release Notes are below.  All other docs are in the Documentation folder.
These links will take you there:
<P>
<FONT SIZE=+1><B>
<A HREF="Documentation/Weaver.html">Main Weaver Documentation</A>
</B></FONT>
-- The basic concepts
<H3>Module Descriptions:</H3>
<A HREF="Documentation/MIDI.html">MIDI Modules</A>
-- the MusicWeaver suite
<P>
<B>Other Module Sets:</B>
<BR>
&nbsp;&nbsp;&nbsp;<A HREF="Documentation/Universal.html">Universal Modules</A>
-- useable in all suites
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="Documentation/TestModules.html">"Test" Modules</A>
-- used in the Tutorial
<BR>
&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="Documentation/MWExtras.html">"Extras"</A>
-- Midi Event Monitoring (MidiMon &amp; StreamView)
<P>
<FONT SIZE=+1><B>
<A HREF="Documentation/MWExamples.html">Example MusicWeaver Configurations</A>
</B></FONT>
<P>
<BR> 

<CENTER>====================</CENTER>
The MusicWeaver is  ShareWare.  This distributed package has no means of recording MIDI, but a module for this will be provided to registered users.  For details, please refer to 
<A HREF="Documentation/MIDI.html#Distribution">Copyright and Distribution</A>
<BR><BR>
<H2>Release Notes </H2>
Release 1.3 of the MusicWeaver is mainly a major upgrade of the Main Weaver
program itself -- now designated 'v3.0'.  The modules have been updated to
add on-line help, a couple have been enhanced, and one new one has been added.
<P>
The new Weaver adds 'Composite Elements' (hierarchical diagrams), direct
replacement of elements in diagrams, routing of data paths between elements,
on-line help, and so on.
<P>
One minor but probably welcome change is that elements like 'Program', that
send their initial state when loaded by a configuration file, now do this
when loading is entirely complete (rather than when their state is set) so
that the rest of the diagram state, like paths and channels, has already
been set up properly.
<P>
The VelAdjust module has had a 'threshold' slider added, giving better control
of its results.
<P>
The VelMarker now remembers when it marks a Note-On, and marks the corresponding
Note-Off the same way, making it much easier to use effectively.
<P>
A NoteOffType module has been added, to convert 'zero-velocity-note-ons' to
true note-off events, or vice versa. Whether any hardware will actually
need this is an open question, but it might just come in handy for something.
<P>
Also included are a couple of modules for monitoring MIDI events.  One is
just StreamView, imported from StreamWeaver -- and in that subfolder --,
and to feed it there is MidiMon.  See MWExtras.html in the documentation.
<P>
<B>
Important note: The 4.0 BeOS drivers for MPU-401 compatible cards (such as the AWE64)
on Intel machines
have a bug that severely restricts the capabilities of the MusicWeaver.
If you try to duplicate events (as in the '2 Chan MIDI' example) you will get
very confused output -- stuck, missing, even wrong notes.
This is fixed in BeOS 4.5.  The problem does not exist on PPC machines.
</B>
<P>

<CENTER>====================</CENTER>


<BR><BR><I>
The documentation, the Weaver program, and all associated modules,
are Copyright 1997-1999 by Peter J. Goodeve.  All rights are reserved.
For details, see:
<A HREF="Documentation/MIDI.html#Distribution">Copyright and Distribution</A></I>
<P>

<CENTER>====================</CENTER>
<h3>
Previous version release notes:
</h3>
In 1.2.1 -- a minor update -- the MidiConn module was updated to fix problems
on x86 systems.  A much improved MidiPlay module replaced the earlier one.
<P>
Release 1.2 was a major update, for Release 4 and later of the BeOS.
It was the first to run on both PPC and Intel machines, and had several new modules.
(The Weaver main program functions themselves were virtually unchanged.)
<P>
New to 1.2 was a set of modules to control
the enabling and disabling of paths within a diagram via 'director' messages.
Redirection is triggered by specific MIDI events, or by mouse-click.
<P>
Element control panels are now all "first click": in other words a panel
does not have to be the focus window before you can work with its controls.
<P>
The  directory organization was altered slightly from the previous (1.1) release.
The top level folder is now 'Weaver', with 'MusicWeaver' below it now holding
the MIDI modules.  This makes it easier to add in other module suites such as
StreamWeaver without confusion.
<P>
The 'Audio' module set included in previous releases has been omitted,
because these were written for the soon-to-be-obsolete old AudioKit.
They may re-emerge for the new MediaKit later.
<P>
<P>
<P><BR>

</body>
</html>
