Skip to content

Commit

Permalink
JoshUgens: help: update to SCDoc
Browse files Browse the repository at this point in the history
Converted more of the old html help files to SCDoc format.
  • Loading branch information
dotinspace committed Jun 16, 2016
1 parent 43d0361 commit f996574
Show file tree
Hide file tree
Showing 23 changed files with 1,826 additions and 1,706 deletions.
73 changes: 73 additions & 0 deletions source/JoshUGens/sc/HelpSource/Classes/PanX.schelp
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
TITLE:: PanX
summary:: Equal power pan across an array of speakers
categories:: Libraries>JoshUGens, Classes, UGens>Multichannel>Panners
keyword:: JoshUGens

DESCRIPTION::
Multichannel equal power panner.


CLASSMETHODS::

METHOD:: kr


ARGUMENT:: numChans
Number of output channels.

ARGUMENT:: in
Input signal.

ARGUMENT:: pos
A value between 0 and 1. 0 is first speaker, 1 is the last. Values < 0 fade out sound from the first speakers, and values > 1 fade out sound from the last speakers. Sound does NOT wrap.

ARGUMENT:: level
A control rate level input.

ARGUMENT:: width
The width of the panning envelope. Nominally this is 2.0 which pans between pairs of adjacent speakers. Width values greater than two will spread the pan over greater numbers of speakers. Width values less than one will leave silent gaps between speakers.


METHOD:: ar

ARGUMENT:: numChans
Number of output channels.

ARGUMENT:: in
Input signal.

ARGUMENT:: pos
A value between 0 and 1. 0 is first speaker, 1 is the last. Values < 0 fade out sound from the first speakers, and values > 1 fade out sound from the last speakers. Sound does NOT wrap.

ARGUMENT:: level
A control rate level input.

ARGUMENT:: width
The width of the panning envelope. Nominally this is 2.0 which pans between pairs of adjacent speakers. Width values greater than two will spread the pan over greater numbers of speakers. Width values less than one will leave silent gaps between speakers.


INSTANCEMETHODS::

METHOD:: init


EXAMPLES::

code::
// five channel panning across an array
s.boot;
(
a = {
PanX.ar(
5, // numChans
ClipNoise.ar, // in
MouseX.kr(-0.5, 1.5), // pos
0.5, // level
MouseY.kr(1, 3) // width
);
}.play(s);
s.scope(5);
)

a.free;
::
159 changes: 159 additions & 0 deletions source/JoshUGens/sc/HelpSource/Classes/Player.schelp
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
TITLE:: Player
summary:: A soundfile player and BFormat Decoder
categories:: Libraries>JoshUgens, Classes
related:: Classes/BFDecode1, Classes/BFEncode1, Classes/BFEncodeSter, Classes/BFManipulate

DESCRIPTION::


CLASSMETHODS::

METHOD:: new
note:: All arguments are optional.::

ARGUMENT:: soundfilepath
The path (complete or relative) to a soundfile

ARGUMENT:: formatOut
A string. defaults to \straight which simply plays the soundfile directly to the output. If your file is a BFormat file (3 or 4 channel) you can choose:
list::
## \stereo
## \uhj
## \quad
## \hex
::

ARGUMENT:: starttime
An initial starttime for playback.

ARGUMENT:: outbus
The starting outbus for playback.

ARGUMENT:: amp
An initial amplitude value.

ARGUMENT:: xywz
Expects true or false. This will decode Ambsonic files recorded for middle side monitoring. (default is false)

ARGUMENT:: env
Any fixed duration envelope (Env, InterplEnv, InterplXYC) to be played over the soundfiles duration.


METHOD:: initClass


INSTANCEMETHODS::

METHOD:: play
Plays the soundfile.

METHOD:: pause
Pauses the soundfile. Playback resumes where the file was paused.

METHOD:: stop
Stops the soundfile. Playback begins from starttime.

METHOD:: formatOut
Changes the output format

METHOD:: starttime
Change the starttime.

METHOD:: endtime
Change the endtime.

METHOD:: gui
Create a GUI controller with optional scope.


METHOD:: isScope

METHOD:: mute_w

METHOD:: mute_y

METHOD:: pausedplay

METHOD:: initendtime

METHOD:: env

METHOD:: bufnum

METHOD:: player

METHOD:: close

METHOD:: amp

METHOD:: group

METHOD:: mute_x

METHOD:: clock

METHOD:: outarray

METHOD:: filename

METHOD:: isGui

METHOD:: init

METHOD:: sf

METHOD:: soundfilepath

METHOD:: window

METHOD:: soundfile

METHOD:: scopebuf

METHOD:: initstarttime

METHOD:: server

METHOD:: curtime

METHOD:: mute_z

METHOD:: outbus

METHOD:: scopeID

METHOD:: xywz

METHOD:: numchan

METHOD:: reset

METHOD:: nodeID

METHOD:: isPlaying

METHOD:: playfunc

METHOD:: tempoclock

EXAMPLES::

code::
// create a new player
a = Player.new(Platform.resourceDir +/+ "sounds/a11wlk01-44_1.aiff")

// play it
a.play;

// pause it
a.pause;

// play it again
a.play;

// stop it
a.stop;

// create a GUI
a.gui;
::
Loading

0 comments on commit f996574

Please sign in to comment.