diff --git a/README.md b/README.md index 9ca52166c973fb95218e7335b13ee7e823299f12..e70086f9334acbf7e6b1f05e79af92402ab272b6 100644 --- a/README.md +++ b/README.md @@ -4,7 +4,7 @@ bf-pd is an implementation for PureData of the BOEUF framework, which enables advanced collaboration modes in spontaneous digital orchestras. -Help and tutorials can be found at https://gitlab.cristal.univ-lille.fr/boeuf/bf-pd/wikis/home +Help and tutorials can be found in the [documentation folder.](doc/README.md) ## Requires the following puredata libraries (Help->Find Externals) diff --git a/bf-instrument.pd b/bf-instrument.pd index f929b2cb9d81f98913c966d683bae106ef532b91..f2aac26bcaeee7587fda4982e778b5c86d67ef4f 100644 Binary files a/bf-instrument.pd and b/bf-instrument.pd differ diff --git a/bf-meter.pd b/bf-meter.pd index c71dc851f1c37b274a85c7cea1b2834c1e696523..2e401906c79836b1653508793554f6137c1847aa 100644 Binary files a/bf-meter.pd and b/bf-meter.pd differ diff --git a/bf-output.pd b/bf-output.pd index cf3dfb1029e96e3d2cfd53757ee7dea521b2f12a..495ba1e916e2e195407d4cb415a99e8148d72469 100644 Binary files a/bf-output.pd and b/bf-output.pd differ diff --git a/bf-param-help.pd b/bf-param-help.pd index b250c3383c5905e90185083d0e46e7f68f4263c8..c73196bf62f0b9d0c5aeedfbf00e032515fd9c82 100644 Binary files a/bf-param-help.pd and b/bf-param-help.pd differ diff --git a/bf-param.pd b/bf-param.pd index 57e51df5bb91816984d61e7b4a545f07c7e83f68..5a5eb47185d42a4940189dc7fb4ea329595150aa 100644 Binary files a/bf-param.pd and b/bf-param.pd differ diff --git a/bf-scowden.pd b/bf-scowden.pd new file mode 100644 index 0000000000000000000000000000000000000000..00d7681a0848f087798cacb2dfec90fa5b188b44 Binary files /dev/null and b/bf-scowden.pd differ diff --git a/bf-session-web.pd b/bf-session-web.pd new file mode 100644 index 0000000000000000000000000000000000000000..b131e929fb65dab8da5538f6a26bb9800085c43a Binary files /dev/null and b/bf-session-web.pd differ diff --git a/bf-session.pd b/bf-session.pd index e11f5c59fabf2803d2d16413c7c4a3c6a1dcbf46..d095373d07cdab6d991f7738a660fa61743e1be1 100644 Binary files a/bf-session.pd and b/bf-session.pd differ diff --git a/bf-util/bf-2osc.pd b/bf-util/bf-2osc.pd index 77cdf77c58569b510e99883166417003b4a785df..755f90426dbab4e04d08c684f4c6c4be069d9115 100644 Binary files a/bf-util/bf-2osc.pd and b/bf-util/bf-2osc.pd differ diff --git a/bf-util/bf-barkbands2.pd b/bf-util/bf-barkbands2.pd index c1757b4b4e309d40eee987fef253cdf1eeeccaac..bb708eb86b3a6ad0a14fc0914f668e0bac742580 100644 Binary files a/bf-util/bf-barkbands2.pd and b/bf-util/bf-barkbands2.pd differ diff --git a/bf-util/bf-connect-hello.pd b/bf-util/bf-connect-hello.pd new file mode 100644 index 0000000000000000000000000000000000000000..eb06305128c30ae35f17c1c7bcdb3b77946f2869 Binary files /dev/null and b/bf-util/bf-connect-hello.pd differ diff --git a/bf-util/bf-connect-log.pd b/bf-util/bf-connect-log.pd new file mode 100644 index 0000000000000000000000000000000000000000..59059b272af18694ca4f613854e7ff025f8343ad Binary files /dev/null and b/bf-util/bf-connect-log.pd differ diff --git a/bf-util/bf-connect-route.pd b/bf-util/bf-connect-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..825eae9e8583ed2d24b990ae39927ea876995174 Binary files /dev/null and b/bf-util/bf-connect-route.pd differ diff --git a/bf-util/bf-connect-visu.pd b/bf-util/bf-connect-visu.pd new file mode 100644 index 0000000000000000000000000000000000000000..7e77a4d59b9ac8c16da9b6e4c8027e92c070f2f7 Binary files /dev/null and b/bf-util/bf-connect-visu.pd differ diff --git a/bf-util/bf-connect.pd b/bf-util/bf-connect.pd index b96d7b0e459752c4f129b3ee4d1b083d4c83b8d2..c18ec941402f6b837301a5273794d74f5f9870b6 100644 Binary files a/bf-util/bf-connect.pd and b/bf-util/bf-connect.pd differ diff --git a/bf-util/bf-connection.pd b/bf-util/bf-connection.pd new file mode 100644 index 0000000000000000000000000000000000000000..8ceedc02c714ab94a74bc0efd3dbc9da12ead8ab Binary files /dev/null and b/bf-util/bf-connection.pd differ diff --git a/bf-util/bf-foreach.pd b/bf-util/bf-foreach.pd new file mode 100644 index 0000000000000000000000000000000000000000..71c8d28c500a81bcf5f099ab47bd5218a4683ee7 Binary files /dev/null and b/bf-util/bf-foreach.pd differ diff --git a/bf-util/bf-netreceive.pd b/bf-util/bf-netreceive.pd new file mode 100644 index 0000000000000000000000000000000000000000..9f3b3f53a428ff4e4bd827ecc88f389959e08775 Binary files /dev/null and b/bf-util/bf-netreceive.pd differ diff --git a/bf-util/bf-other-param-array-route.pd b/bf-util/bf-other-param-array-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..b4ca13b09cb345a4955681d2126e641ebf548f51 Binary files /dev/null and b/bf-util/bf-other-param-array-route.pd differ diff --git a/bf-util/bf-other-param-pair-route.pd b/bf-util/bf-other-param-pair-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..7474611d93283769b285dd02a9e4c160e16a14a5 Binary files /dev/null and b/bf-util/bf-other-param-pair-route.pd differ diff --git a/bf-util/bf-other-param-route.pd b/bf-util/bf-other-param-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..1c5d51b4af922f904ca7df396021eedd8b649d11 Binary files /dev/null and b/bf-util/bf-other-param-route.pd differ diff --git a/bf-util/bf-other-paramout.pd b/bf-util/bf-other-paramout.pd new file mode 100644 index 0000000000000000000000000000000000000000..e006e2b1d8f4b500a3747f1942362a0733ddb1ac Binary files /dev/null and b/bf-util/bf-other-paramout.pd differ diff --git a/bf-util/bf-others-meter.pd b/bf-util/bf-others-meter.pd index 7f49c028d7e5b27cdd1918fbb3c1a271e41e87cb..eb8c8439259a097b97a7cb55d77016a9df7db3e8 100644 Binary files a/bf-util/bf-others-meter.pd and b/bf-util/bf-others-meter.pd differ diff --git a/bf-util/bf-others-output.pd b/bf-util/bf-others-output.pd index 23da11fdb22b57ec9503968aa606d561075aa61d..3ec915f5edbf040ed29363ed935519b9fff83be9 100644 Binary files a/bf-util/bf-others-output.pd and b/bf-util/bf-others-output.pd differ diff --git a/bf-util/bf-others-parameter.pd b/bf-util/bf-others-parameter.pd index 8b34cb5e39263216e0455b80dcb1f0542dde961b..92614065bdb70bde7d59aa6295d59e615d6dcfdb 100644 Binary files a/bf-util/bf-others-parameter.pd and b/bf-util/bf-others-parameter.pd differ diff --git a/bf-util/bf-others-parser.pd b/bf-util/bf-others-parser.pd index 0c81133194a14093e33478a769d38b79b6ee7d86..3405cfd95baf962c844c2e3cb5ff9933b2865f3e 100644 Binary files a/bf-util/bf-others-parser.pd and b/bf-util/bf-others-parser.pd differ diff --git a/bf-util/bf-own-instrument.pd b/bf-util/bf-own-instrument.pd index 8975461b879aab344fc3bf56ded2f5c6d19dd987..aba8294a8be7df766ef7a25d8ec196e6444f8be1 100644 Binary files a/bf-util/bf-own-instrument.pd and b/bf-util/bf-own-instrument.pd differ diff --git a/bf-util/bf-own-meter.pd b/bf-util/bf-own-meter.pd index 47e58f2c2c1dd3ea47c51d823fa6e0bb1da3e784..7e3226ee66c052188196a2530b3f60b120ab12ef 100644 Binary files a/bf-util/bf-own-meter.pd and b/bf-util/bf-own-meter.pd differ diff --git a/bf-util/bf-own-output.pd b/bf-util/bf-own-output.pd index 6f2d29a83f09ca5de36fd6b27cd0f4c5809e113c..933d28ec80e4a4c241cf4e88ef997bd7b3da500d 100644 Binary files a/bf-util/bf-own-output.pd and b/bf-util/bf-own-output.pd differ diff --git a/bf-util/bf-own-parameter.pd b/bf-util/bf-own-parameter.pd index 4fc3c83734e407bb6e3aa5c9730708c7d68b1fee..d8be0f55ca8ccf86a607ec220a73049825532d5f 100644 Binary files a/bf-util/bf-own-parameter.pd and b/bf-util/bf-own-parameter.pd differ diff --git a/bf-util/bf-own-parser.pd b/bf-util/bf-own-parser.pd index f9e1377f940686a656d0bc22b9552cd0d033be79..ae79f220c2299b000cfd0646c12eaf40ce70aa25 100644 Binary files a/bf-util/bf-own-parser.pd and b/bf-util/bf-own-parser.pd differ diff --git a/bf-util/bf-param-array-route.pd b/bf-util/bf-param-array-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..60174999ab318cc7d3f602da343f51add6781ca5 Binary files /dev/null and b/bf-util/bf-param-array-route.pd differ diff --git a/bf-util/bf-param-pair-route.pd b/bf-util/bf-param-pair-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..17b4d5835ddfff5d355787f864fb65779c2a9d97 Binary files /dev/null and b/bf-util/bf-param-pair-route.pd differ diff --git a/bf-util/bf-param-route.pd b/bf-util/bf-param-route.pd new file mode 100644 index 0000000000000000000000000000000000000000..40859add27fda38886e2b2793953018d50939d4d Binary files /dev/null and b/bf-util/bf-param-route.pd differ diff --git a/bf-util/bf-util-array.pd b/bf-util/bf-util-array.pd index e84d369a209069f2777f904dd522334d1ca1ac7d..1b62bee2541bf773581d26c5e77353619102731b 100644 Binary files a/bf-util/bf-util-array.pd and b/bf-util/bf-util-array.pd differ diff --git a/bf-util/bf-util-bang.pd b/bf-util/bf-util-bang.pd index 80bd2ebb1d5912fe5236c4b5b6bda1fdd6df316c..2818340be08ca3a7555b029dee0a2b8c9fcacb9c 100644 Binary files a/bf-util/bf-util-bang.pd and b/bf-util/bf-util-bang.pd differ diff --git a/bf-util/bf-util-bool.pd b/bf-util/bf-util-bool.pd index 0542bc0c3f97c705ea9ef8acc02f3fbdc0e5342e..52cf031d303cae8c61556d7f02e4f720cbcf8ce9 100644 Binary files a/bf-util/bf-util-bool.pd and b/bf-util/bf-util-bool.pd differ diff --git a/bf-util/bf-util-cont.pd b/bf-util/bf-util-cont.pd index d1ee7d5616bab764b62a154e1e4f74e5f7e0ffab..869442f1553d9f1514b01345b8950c352f3ce399 100644 Binary files a/bf-util/bf-util-cont.pd and b/bf-util/bf-util-cont.pd differ diff --git a/bf-util/bf-util-hcont.pd b/bf-util/bf-util-hcont.pd index b1483513eefb049a4f6c3934b3f253cf71a1583c..d21dd9b3c9832564ce51b5d582638f4abff712b2 100644 Binary files a/bf-util/bf-util-hcont.pd and b/bf-util/bf-util-hcont.pd differ diff --git a/bf-util/bf-util-hmidi.pd b/bf-util/bf-util-hmidi.pd index 76544a26976fec368ce6a4c5fa25ad7f8d517635..65aa1887d6facc9985137bd2c83a75c4bcc95abc 100644 Binary files a/bf-util/bf-util-hmidi.pd and b/bf-util/bf-util-hmidi.pd differ diff --git a/bf-util/bf-util-makeinstrucompo.pd b/bf-util/bf-util-makeinstrucompo.pd index 5cbfadd24e73f24bf5d33355038a838ef6fc1751..bf06138a207d546bd8f963cd78e656916b2ffb31 100644 Binary files a/bf-util/bf-util-makeinstrucompo.pd and b/bf-util/bf-util-makeinstrucompo.pd differ diff --git a/bf-util/bf-util-makeinstrucompoout.pd b/bf-util/bf-util-makeinstrucompoout.pd index 95e9770a7ae617d10486c60816e7a46361cbf6e2..084dbfac5a156329f759291f608f4691eec7bc60 100644 Binary files a/bf-util/bf-util-makeinstrucompoout.pd and b/bf-util/bf-util-makeinstrucompoout.pd differ diff --git a/bf-util/bf-util-makeotherscompo.pd b/bf-util/bf-util-makeotherscompo.pd index a21ebf1f203a088fd1d89ed52c9f5d4ae8e5f851..2ec061b24c10cce482af7c89265dca455aedb57e 100644 Binary files a/bf-util/bf-util-makeotherscompo.pd and b/bf-util/bf-util-makeotherscompo.pd differ diff --git a/bf-util/bf-util-makeotherscompoout.pd b/bf-util/bf-util-makeotherscompoout.pd index bc22c313641894f2c50bb4236b450aacadacae92..56e401f43add1ac7ca4085c2ce42af6fcd509044 100644 Binary files a/bf-util/bf-util-makeotherscompoout.pd and b/bf-util/bf-util-makeotherscompoout.pd differ diff --git a/bf-util/bf-util-midi.pd b/bf-util/bf-util-midi.pd index 6558fb2b38564bba1fe58e9b39e3699253927b0c..61b2fad63d1b9ce85cc62a3bb0a94e81b153c511 100644 Binary files a/bf-util/bf-util-midi.pd and b/bf-util/bf-util-midi.pd differ diff --git a/bf-util/bf-util-symbolmap.pd b/bf-util/bf-util-symbolmap.pd index e4e53f26d7cc1b981231bc10cefdefe786dd26a8..1977cd402845ad2fda7866410fa573653a895e84 100644 Binary files a/bf-util/bf-util-symbolmap.pd and b/bf-util/bf-util-symbolmap.pd differ diff --git a/doc/.gitkeep b/doc/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/doc/README.md b/doc/README.md new file mode 100644 index 0000000000000000000000000000000000000000..95fd395ba8e2526292b08a7d871802b00d522691 --- /dev/null +++ b/doc/README.md @@ -0,0 +1,45 @@ + +# Introduction: What is bf-pd and why do you need it? + +Digital instruments allow us to do things that were not possible with purely acoustic instruments. For example musicians can share data between instruments in real-time, in effect creating distributed multi-musician super-instruments. Musicians such as The Hub have been doing this since at least the 1970s. Contemporary digital musicians often write their own software instruments to re-create these functionalities. + +Bf-pd is a library built in PureData (Pd) which enables communication and cooperation between digital instruments. Bf-pd can be integrated into any instrument built in Pd. It provides a *collaboration window* from which musicians can view each others’ activity and share control of instrument parameters and other musical data. + +The design of bf-pd is based on the BOEUF conceptual framework which consists of a classification of modes of collaboration used in collective music performance, and a set of components which affords them. More details on the BOEUF conceptual framework can be found +[on this wiki page](boeuf.md). + +# Installing bf-pd + +- Download and install Pure Data for your operating system from https://puredata.info/downloads/pure-data +- Install the **mrpeach** library using Deken (PD -> Help -> Find Externals) +- Install **bf-pd** using Deken + +# Getting started: Building your instrument + + + +- Create a declare object with -path bf-pd +- Create a bf-instrument object with your instrument name as argument +- Connect the sound output of your instrument to its inlet +- Create a bf-param object for each control you want to share with the others and insert it into your instrument +- Create a bf-session object with the name of the session you want to connect to + +# Performance: Making music together using bf-pd +### The collaboration window + +### Sharing parameters + +### Connecting parameters using ask and watch + + +### Video example + +<a href="https://vimeo.com/214380530">Video showing a simple session</a> + + +# More resources + +Documentation for each of the user objects in bf-pd can be found in [objects.md](objects.md). + +The *BOEUF conceptual framework* describes the *modes of collaboration* used in musical collaboration and describes a set of *components* for realizing these modes in a software framework. Bf-pd is based on this framework. More info can be found in [boeuf.md](boeuf.md). + diff --git a/doc/bf-pd_start.gif b/doc/bf-pd_start.gif new file mode 100644 index 0000000000000000000000000000000000000000..4890a66df6e01238f591293328acc11ea42a2b7b Binary files /dev/null and b/doc/bf-pd_start.gif differ diff --git a/doc/boeuf.md b/doc/boeuf.md new file mode 100644 index 0000000000000000000000000000000000000000..4cc7eaaddb5c4b00c762e9cc19cde106659b8048 --- /dev/null +++ b/doc/boeuf.md @@ -0,0 +1,40 @@ +# The BOEUF conceptual framework + +BOEUF is a conceptual framework for modeling and building orchestras of digital musical instruments. It consists of a classification of *modes of collaboration*, and a set of *components* which can be used to enable these modes in digital instruments. We developed this classification after conducting interviews with digital musicians who work in ensembles, as well as literature review of work on digital ensembles and collaborative instruments. The word “boeuf” is french slang for a jam session. + +## Modes of Collaboration + +The *modes of collaboration* are a categorization which is intended to describe all the ways that musicians collaborate and communicate during performance. This includes interactions which are *mediated* (i.e. take place through some technology) as well as *unmediated* interactions (which can occur through being in the same space together.) + +We propose that there are three modes of collaboration: *Cooperation*, *Communication*, and *Organisation* + +### Cooperation Modes +*Cooperation* describes the ways that musicians coordinate their actions with respect to their instruments. This cooperation can be: + +* **Independent:** Each musician controls their own instrument. For example, when two musicians begin to play their instruments at the same time this is *independent cooperation*. They are cooperating because they coordinated their musical gestures, but they act only on their own instrument. + +* **Complementary:** Multiple musicians can affect different aspects of the same musical process. For example, when one musician adds effects to a sound generated by another musician. + +* **Concurrent:** Multiple musicians can control the same aspect of the same musical musical process. For example, when two musicians can both control some parameter (e.g. filter cutoff frequency) on the same instrument. + +### Communication Modes +*Communication* describes how musicians exchange information which may then influence their actions. + +* **Awareness:** Awareness describes all non-intentional communication. For example being able to see the movements of other musicians. + +* **Indication:** Indications are intentional communicative acts. For example, cueing an entrance. Deliberate nods and glances between musicians may be indications. + +* **Exchanges:** Exchange is the transfer of musical data between musicians. For example, in a digital ensemble on musician might send a sequence of notes to another's instrument. Or in a jazz ensemble a soloist might use a motif from the previous soloist. + +### Organisation Modes + +*Organisation* describes the relationships between musicians. Organisation does not directly affect the sound production, but it impacts how the communication and cooperation modes operate. + +* **Nomination: ** Nomination is that act of de fining the roles of musicians within the group. For example one musician might be the conductor, another might be a soloist. + +* **Grouping** The act of grouping de fines a hierarchy of groups of instruments. For example a musician might be in the group "viola players" as well as in the group "string section." + +* **Selection** Selection is the act of choosing a group or instrument for cooperation or communication. For example, a conductor might gesture to the wind section (thereby selecting them) before cueing their entrance (indication.) + +## The Boeuf components +[TODO] \ No newline at end of file diff --git a/doc/img/.gitkeep b/doc/img/.gitkeep new file mode 100644 index 0000000000000000000000000000000000000000..e69de29bb2d1d6434b8b29ae775ad8c2e48c5391 diff --git a/doc/img/start.gif b/doc/img/start.gif new file mode 100644 index 0000000000000000000000000000000000000000..e96a5db8a01ec820e188e5fa3e776c202de77ac5 Binary files /dev/null and b/doc/img/start.gif differ diff --git a/doc/objects.md b/doc/objects.md new file mode 100644 index 0000000000000000000000000000000000000000..20575c20d9819b0190b0cfa843b7ea07539480d5 --- /dev/null +++ b/doc/objects.md @@ -0,0 +1,110 @@ +Bf-pd is a library of pd objects for enabling real-time collaboration. This page describes each of the objects in bf-pd, their arguments, inlets and outlets. + +## bf-session +A bf-session represents a group of musicians (as represented by their bf-instruments) making music together. Within the bf-pd system a bf-session works "behind the scenes" to coordinate the data exchanged between bf-instruments. + +To participate in a bf-session there must be at least one instance of bf-session instantiated somewhere. A bf-session has a name, e.g. "technoJam1", and this session would be instantiated as [bf-session technoJam1]. + +There can be more than one bf-session object with the same name within the patches running in Pd. So you can add the same bf-session to each bf-instrument. (However if you instantiate two different bf-sessions within pd, the second one will not work.) + +###### Arguments: +1. The name of the session. + +###### Outlets: +1. Outlet 1 sends all the session messages which are used "behind the scenes" by the bf-pd objects. + + +## bf-instrument +A bf-instrument represents a musical instrument within the bf-pd system. Each instrument joins a bf-session and can contain bf-params and bf-outputs. To create an instrument you should instantiate a bf-instrument with the name of your instrument, e.g. [bf-instrument myDrumMachine]. + +The audio output of your instrument should be connected to the first inlet of bf-instrument object. The interface for has an *activity monitor* which shows a simple representation of the changing spectrum of the instrument's sound, and the activity for each bf-instrument in the bf-session appears in the *collaboration window*. (Note: you must also send your audio to [dac~] in order to hear it!) + +The *collaboration window* can be opened with the toggle in the bf-instrument object. If musicians enter or leave the session you may need to close and re-open the collaboration window. + +###### Arguments: +1. The name of the instrument. + +###### Inlets: +1. The audio output of your instrument should be sent here. (It must also be sent to [dac~].) + + +## bf-param +A bf-param creates a user parameter within the bf-pd system. A bf-param can be controlled by the user of the bf-instrument it belongs to, and the bf-param will also be accessible to other instruments within the bf-session, via the collaboration window, if the user of the bf-instrument grants access. + +A bf-param object has a user interface within the instrument patch itself, and it creates a user interface in the collaboration window of each musician in the session. + +A bf-param can be one of four *types*: +* *cont* are numbers between 0.0 and 1.0. +* *midi* are numbers between 0.0 and 127.0. +* *bool* can take values of 0 or 1. +* *bang* are bang messages which are used to trigger actions. + +A bf-param can be a single instance of its type or it can be a multiple, which creates an array of values within a single bf-param object. For example, a bf-param "8 bool" creates an interface with 8 toggles, and might be used to represent 8 on/off values in a drum machine sequencers. + +###### Arguments: +1. The name of the instrument, e.g. "myDrumMachine". +2. The name of the parameter, e.g. "kickOnOff" +3. The dimensionality of the parameter, e.g. "8" +4. The type of the parameter, e.g. "bool" + +So a parameter to store 8 drum machine note triggers would be: +`[bf-param myDrumMachine kickOnOff 8 bool]` and creates this object within your patch: + + + +###### Inlets: +1. Sets the value of the parameter. If the parameter is a multiple, then *Inlet 1* sets the parameter at the index last received on *Inlet 2*. +2. Sets the index of the parameter which will be changed by sending values to *Inlet 1*. +3. An integer in *Inlet 3* will send the value of the parameter at that index to *Outlet 3*. + +(The first two inlets for bf-param operate similar to the first two inlets for [array set] in Pd.) + +###### Outlets: +1. The parameter value of the most recent change to the bf-param (whether that change came from the inlets, the UI, or via the collaboration window.) +2. A list of the parameter value of the most recent change, and the index of the parameter that was changed. +3. The parameter value for the index that was sent to *Inlet 3*. + + +## bf-output +An bf-output can be used to send some musical data from your bf-instrument to another instrument in the same bf-session. A bf-output can have the same types and multiplicity as a bf-param. + +Each bf-output in your bf-instrument will appear [TODO continue] + + is a musical attribute that is produced by a module or instrument. They can have the same types as parameters. Outputs can be retrieved and watched by other instruments, and function as a means for both awareness and exchange. + +###### Arguments: +1. arg1 + +###### Inlets: +1. blah + +###### Outlets: +1. blah + +## bf-watch +Bf-watch is used to get data from another bf-instrument into your bf-instrument. + +###### Arguments: +1. arg1 + +###### Inlets: +1. blah + +###### Outlets: +1. blah + + +## bf-ask +Description blah blah + +###### Arguments: +1. arg1 + +###### Inlets: +1. blah + +###### Outlets: +1. blah + + + diff --git a/examples/bfex_BassSequencer.pd b/examples/bfex_BassSequencer.pd index b0f9e7e144624bd3ff0014bcaf9439094f8cdb30..e90fe9d529d29250c92deb8c7541d9a97b51fa82 100644 Binary files a/examples/bfex_BassSequencer.pd and b/examples/bfex_BassSequencer.pd differ diff --git a/examples/bfex_DrumSequencer.pd b/examples/bfex_DrumSequencer.pd index c8ba91a5887968ffdf62597d8410d9fa3285ec56..85bf4db8c53f3dde66e8daa6400fd4434e138869 100644 Binary files a/examples/bfex_DrumSequencer.pd and b/examples/bfex_DrumSequencer.pd differ