Python库 | FoxDot-0.7.39.tar.gz

FoxDot - Live Coding with Python v0.7 ===================================== FoxDot is a Python programming environment that provides a fast and user-friendly abstraction to SuperCollider. It also comes with its own IDE, which means it can be used straight out of the box; all you need is Python and SuperCollider and you're ready to go! ## Important If you are having trouble installing using `pip install FoxDot`, try updating Python's `setuptools` and `wheel` libraries using the following code and trying again. ``` pip install -U setuptools pip install -U wheel ``` ### v0.7 fixes and updates - Add `.reload()` method for `loop` player to reload the file used, in case it has been overwritten. - Update `PlayerKey` class (things like `p1.degree` etc) to behave better with `map` and `transform` - Added `transform` method to Patterns - Fixed `.pyc` files showing in the tutorials menu - you may have to uninstall and reinstall to see the benefit - Improved in-house synchronisation between FoxDot instances. - Add `PDelta` pattern; user supplies the step sizes between each value. - Negative `offbeat` fix (thanks zdbm). --- ## Installation and startup #### Prerequisites - [Python 2 or 3](https://www.python.org/) - add Python to your path and install "pip" when prompted during the install. - [SuperCollider 3.8 and above](http://supercollider.github.io/download) #### Recommended - [sc3 plugins](http://sc3-plugins.sourceforge.net/) #### Installing FoxDot - Open up a command prompt and type `pip install --user FoxDot`. This will download and install the latest stable version of FoxDot from the Python Package Index if you have properly configured Python. - You can update FoxDot to the latest version if it's already installed by adding `-U` or `--upgrade` flag to this command. - Alternatively, you can build from source from directly from this repository: ``` bash $ git clone https://github.com/Qirky/FoxDot.git $ cd FoxDot $ python setup.py install ``` - Open SuperCollder and install the FoxDot Quark and its dependencies (this allows FoxDot to communicate with SuperCollider) by entering the following and pressing `Ctrl+Return` (Note: this requires [Git to be installed](http://git-scm.com/) on your machine if it is not already): ```supercollider Quarks.install("FoxDot") ``` - Recompile the SuperCollider class library by going to `Language -> Recompile Class Library` or pressing `Ctrl+Shift+L` #### Startup 1. Open SuperCollider and type in `FoxDot.start` and evaluate this line. SuperCollider is now listening for messages from FoxDot. 2. Start FoxDot by entering `FoxDot` at the command line. If that doesn't work, try `python -m FoxDot`. 3. If you have installed the SC3 Plugins, use the "Code" drop-down menu to select "Use SC3 Plugins". Restart FoxDot and you'll have access to classes found in the SC3 Plugins. 4. Keep up to date with the latest verion of FoxDot by running `pip install FoxDot --upgrade` every few weeks. 5. Check out the [YouTube tutorials](https://www.youtube.com/channel/UCRyrNX07lFcfRSymZEWwl6w) for some in-depth tutorial videos on getting to grips with FoxDot #### Installing with SuperCollider 3.7 or earlier If you are having trouble installing the FoxDot Quark in SuperCollider, it is usually because the version of SuperCollider you are installing doesn’t have the functionality for installing Quarks or it doesn’t work properly. If this is the case, you can download the contents of the following SuperCollider script: [foxdot.scd](http://foxdot.org/wp-content/uploads/foxdot.scd). Once downloaded, open the file in SuperCollider and press Ctrl+Return to run it. This will make SuperCollider start listening for messages from FoxDot. #### Frequently Asked Questions You can find answers to many frequently asked questions on the [FAQ post on the FoxDot discussion forum](http://foxdot.org/forum/?view=thread&id=1). ## Basics ### Executing Code A 'block' of code in FoxDot is made up of consecutive lines of code with no empty lines. Pressing `Ctrl+Return` (or `Cmd+Return` on a Mac) will execute the block of code that the cursor is currently in. Try `print(1 + 1)` to see what happens! ### Player Objects Python supports many different programming paradigms, including procedural and functional, but FoxDot implements a traditional object orientated approach with a little bit of cheating to make it easier to live code. A player object is what FoxDot uses to make music by assigning it a synth (the 'instrument' it will play) and some instructions, such as note pitches. All one and two character variable names are reserved for player objects at startup so, by default, the variables `a`, `bd`, and `p1` are 'empty' player objects. If you use one of these variables to store something else but want to use it as a player object again, or you want to use a variable with more than two characters, you just have to reserve it by creating a `Player` and assigning it like so: ``` python p1 = Player("p1") # The string name is optional ``` To stop a Player, use the `stop` method e.g. `p1.stop()`. If you want to stop all players, you can use the command `Clock.clear()` or the keyboard short-cut `Ctrl+.`, which executes this command. Assigning synths and instructions to a player object is done using the double-arrow operator `>>`. So if you wanted to assign a synth to `p1` called 'pads' (execute `print(SynthDefs)` to see all available synths) you would use the following code: ``` python p1 >> pads([0,1,2,3]) ``` The empty player object, `p1` is now assigned a the 'pads' synth and some playback instructions. `p1` will play the first four notes of the default scale using a SuperCollider `SynthDef` with the name `\pads`. By default, each note lasts for 1 beat at 120 bpm. These defaults can be changed by specifying keyword arguments: ```python p1 >> pads([0,1,2,3], dur=[1/4,3/4], sus=1, vib=4, scale=Scale.minor) ``` The keyword arguments `dur`, `oct`, and `scale` apply to all player objects - any others, such as `vib` in the above example, refer to keyword arguments in the corresponding `SynthDef`. The first argument, `degree`, does not have to be stated explicitly. Notes can be grouped together so that they are played simultaneously using round brackets, `()`. The sequence `[(0,2,4),1,2,3]` will play the the the first harmonic triad of the default scale followed by the next three notes. ### 'Sample Player' Objects In FoxDot, sound files can be played through using a specific SynthDef called `play`. A player object that uses this SynthDef is referred to as a Sample Player object. Instead of specifying a list of numbers to generate notes, the Sample Player takes a string of characters (known as a "PlayString") as its first argument. To see a list of what samples are associated to what characters, use `print(Samples)`. To create a basic drum beat, you can execute the following line of code: ``` python d1 >> play("x-o-") ``` To have samples play simultaneously, you can create a new 'Sample Player' object for some more complex patterns. ``` python bd >> play("x( x) ") hh >> play("---[--]") sn >> play(" o ") ``` Alternatively, you can do this in one line using `<>` arrows to separate patterns you want to play together like so: ```python d1 >> play("<x( x) ><---[--]>< o >") ``` Or you can use `PZip`, the `zip` method, or the `&` sign to create one pattern that does this. This can be useful if you want to perform some function on individual layers later on: ``` python d1 >> play(P["x( x) "].palindrome().zip("---[--]").zip(P[" o "].amen())) # The first item must be a P[] pattern, not a string. d1 >> play(P["x( x) "].palindrome() & "---[--]" & P[" o "].amen()) ``` Grouping characters in round brackets laces the pattern so that on each play through of the sequence of samples, the next character in the group's sample i