Difference between revisions of "Q3osc: works"

From CCRMA Wiki
Jump to: navigation, search
m (→‎Instructions)
m (→‎''nous sommes tous Fernando...'')
 
(48 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
 
+
==''nous sommes tous Fernando...'' ==
−
== ''Quintet: 5 for 4'' ==
+
  
 
<div style="vertical-align: top; float:right; margin:10px 0px 20px 30px;">http://ccrma.stanford.edu/~rob/q3osc/images/quintet_caps_400.png</div>
 
<div style="vertical-align: top; float:right; margin:10px 0px 20px 30px;">http://ccrma.stanford.edu/~rob/q3osc/images/quintet_caps_400.png</div>
  
−
''Quintet: 5 for 4'' by Robert Hamilton is an improvisatory etude written for the Stanford Laptop Orchestra using q3osc and ChucK. Four performers control avatars in a virtual environment, firing sound-projectiles which bounce or home-in on individual performers, creating sound events at every bounce/collision with a surface of the environment. Virtual sound sources are laid out in a "+" with hemispherical speakers in the real-world laid out in a similar configuration. Spatialization is correlated between virtual and real-environments, with various aspects of each sound-event (frequency, timbre, duration) mapped to various axis and relationships in the virtual environment. Additionally, each of the four performers has real-time control over one of four super-sets of global parameters controlling respectively Projectile-Speed, Homing-Speed, Client-Speed, and Gravity. These commands are bound to the keyboard (1-5) in increasing increments (0/10, 100, 500, 1000, 3000) and can be triggered at any time during the performance to affect all performers.
+
''nous sommes tous Fernando...'' by Robert Hamilton is an improvisatory work written for the [http://slork.stanford.edu Stanford Laptop Orchestra (SLOrk)] using [https://cm-wiki.stanford.edu/wiki/Q3osc q3osc] and [http://chuck.cs.princeton.edu ChucK]. Four performers control avatars in a virtual environment, firing sound-projectiles which bounce or home-in on individual performers, creating sound events with every bounce/collision with a surface of the environment. Virtual sound sources are laid out in a "+," represented by hemispherical structures in the virtual environment, with hemispherical speakers in the real-world laid out in a similar configuration. Spatialization is correlated between virtual and real-environments, with various aspects of each sound-event (frequency, timbre, duration) mapped to various axis and relationships in the virtual environment. Additionally, each of the four performers has real-time control over one of four super-sets of global parameters controlling respectively Projectile-Speed, Homing-Speed, Client-Speed, and Gravity. These commands are bound to the keyboard (1-5) in increasing increments (0/10, 100, 500, 1000, 3000) and can be triggered at any time during the performance to affect all performers.
 +
 
 +
Performers are encouraged to think of the work as a collaborative improvisation and to explore the environment searching for new performative gestures and sounds.
 +
 
 +
Some ideas:
 +
 
 +
* Repetitive/canonic gestures can be performed by firing multiple projectiles without moving or changing the view angle.
 +
* All projectiles can be destroyed by toggling off either the plasma persist toggle (Y), the bfg persist toggle (U), the plasma homing persist toggle (i) or the bfg homing persist toggle (O).
 +
* Homing projectiles create interesting auditory gestures. Changing the speed of homing projectiles (Client #3 - keys 1-5) can have interesting effects.
 +
 
 +
 
 +
==== Media ====
 +
 
 +
YouTube Video: http://www.youtube.com/watch?v=a3aZx0eWpx0
 +
 
 +
 
 +
==== Program Notes ====
 +
nous sommes tous Fernando...
 +
for 16 laptops and q3osc
 +
Robert Hamilton
 +
 
 +
Deep underground, located beneath the CCRMA courtyard lies a super-secret musical warfare laboratory funded by the United States Military, developed in conjunction with Guitar Center and Sweetwater.com. While details about the project are scarce to none, local legends usually mention high-powerd futuristic plasma weapons... and lizards.
 +
 
 +
nous sommes tous Fernando... by Robert Hamilton is an improvisatory work written for the Stanford Laptop Orchestra (SLOrk) using q3osc and ChucK. Performers control avatars in a virtual environment, firing sound-projectiles which bounce or home-in on individual performers, creating sound events with every bounce/collision with a surface of the environment. Virtual sound sources are represented by hemispherical structures in the virtual environment, with hemispherical speakers in the real-world laid out in a similar configuration. Spatialization is correlated between virtual and real-environments, with various aspects of each sound-event (frequency, timbre, duration) mapped to various axis and relationships in the virtual environment.  For more information: https://cm-wiki.stanford.edu/wiki/Q3osc
  
  
 
=== Files ===
 
=== Files ===
 
q3osc Installer: [http://ccrma.stanford.edu/~rob/q3osc/files/q3osc.zip q3osc.zip]
 
q3osc Installer: [http://ccrma.stanford.edu/~rob/q3osc/files/q3osc.zip q3osc.zip]
 +
 +
q3osc install dir: [http://ccrma.stanford.edu/~rob/q3osc/files/install/ install]
  
 
''Quintet'' ChucK script: [http://ccrma.stanford.edu/~rob/q3osc/quintet/quintet.ck quintet.ck]
 
''Quintet'' ChucK script: [http://ccrma.stanford.edu/~rob/q3osc/quintet/quintet.ck quintet.ck]
  
 
Large composite of screen-caps: [http://ccrma.stanford.edu/~rob/q3osc/images/quintet_caps.png quintet_caps.png]
 
Large composite of screen-caps: [http://ccrma.stanford.edu/~rob/q3osc/images/quintet_caps.png quintet_caps.png]
 +
 +
  
 
=== Instructions ===
 
=== Instructions ===
−
''Quintet'' was designed to be run using five slork hemispherical speakers arranged in a + shape with one speaker in the center and 1 speaker on each of the ends of the +.
+
<div style="vertical-align: top; float:right; margin:20px 50px 50px 70px;">http://ccrma.stanford.edu/~rob/q3osc/images/speakers.png</div>
  
−
Each user sits at a slork station next to a hemispherical speaker. The center speaker is left un-manned and is connected to a subwoofer.
+
''nous sommes tous Fernando...'' was designed to be run using five slork hemispherical speakers arranged in a + shape with one speaker in the center and 1 speaker on each of the ends of the +.  Each user sits at a slork station next to a hemispherical speaker. The center speaker is left un-manned and is connected to a subwoofer. Each physical speaker location has a unique number from 0-4 with 0 being the center speaker, being respectively - on a clock face - 1 being 12 o'clock, 2 being 3 o'clock, 3 being 6 o'clock, and 4 being 9 o'clock. These id's are used to identify each user's station to the software for correlation between virtual speaker placements and physical speaker placements  (see diagram => ). All performers should be facing inwards towards the center speaker so that they can make eye and gestural contact with one another.
  
−
Each physical speaker location has a unique number from 0-4 with 0 being the center speaker, being (on a clock face) 12 o'clock, 2 being 3 o'clock, 3 being 6 o'clock, and 4 being 9 o'clock. These id's are used to identify each user's station to the software for correlation between virtual speaker placements and physical speaker placements.
+
One computer running the q3osc game-server should be running and connected to the local network (preferably over ethernet for now). Currently q3osc has only been successfully compiled in linux so the server should be running linux (Fedora 8 works nicely). The server can be connected to a video projector to project an overall view of the environment to the audience. In this regard, when the server is started it can either be run as a client server (where the game itself appears on the screen of the server), or as a dedicated server, where a separate machine can login as a game client and be used with the projector. A fifth performer of the piece should be controlling this "spectator" client, "filming" the performance for display on the projector.
  
−
Coordinate diagram of virtual/physical speaker locations with virtual [x,y] coordinates:
+
Clients launch q3osc by opening an OS X terminal window and by launching the q3osc shell-script, passing in 3 parameters: and integer 1-4 for the speaker location at which they're sitting, an integer for the speaker-radius for which sounds will occur, and the ip-address of the game server. For example, the call below will launch q3osc, load the dirt_dome.bsp map (set by default), connect to the server 10.0.1.189, and will launch ChucK with parameters "-c8 quintet.ck:3:900" where quintet is the name of the ChucK script, -c8 sets multi-channel output to 8 channels, 3 specifies the speaker-set location (see diagram) and 900 sets the speaker-radius.
 +
 
 +
shabushabu:~ slork$ q3osc 3 900 10.0.1.189
 +
 
 +
 
 +
After the client is loaded into the game engine and the virtual-environment appears on-screen, the client should press fn+F1, F2, F3 or F4, matching the F# to the Speaker-set number they entered at the command line. With the above example, the client would press fn+F3. This loads a specific configuration file for that client, giving each client specific controls over different global game parameters.
 +
 +
Player 1: fn+F1    /bind F1 "exec pspeed.cfg"
 +
Player 2: fn+F2    /bind F2 "exec gspeed.cfg"
 +
Player 3: fn+F3    /bind F3 "exec hspeed.cfg"
 +
Player 4: fn+F4    /bind F4 "exec gravity.cfg"
 +
 
 +
Additional points:
 +
 
 +
* Each client should make sure a multi-channel interface is connected as default sound source in Mac OS X.
 +
* A mouse can be used with the laptop to make control of the system more natural.
 +
* When in the game engine, pressing the ~ key brings down the quake-terminal and returns Mouse-focus to the operating system.
 +
* Things like hot-corners on a mac should be disabled
 +
* Sound from the game client itself can be either completely disabled or set to the lowest possible setting, adding a bit of ambient noise for each client (note: these sounds are not spatialized but add an interesting element to the performance.
  
−
http://ccrma.stanford.edu/~rob/q3osc/images/speakers.png
 
  
  
Line 29: Line 72:
 
* download [http://ccrma.stanford.edu/~rob/q3osc/files/q3osc.zip q3osc.zip] and unzip the archive.
 
* download [http://ccrma.stanford.edu/~rob/q3osc/files/q3osc.zip q3osc.zip] and unzip the archive.
 
* run the ./install.sh shell script to install the q3osc mod of OpenArena, the q3osc maps and custom config files. Follow instructions listed in the terminal window at the end of the shell script.
 
* run the ./install.sh shell script to install the q3osc mod of OpenArena, the q3osc maps and custom config files. Follow instructions listed in the terminal window at the end of the shell script.
 +
  
  
Line 36: Line 80:
 
  TO LAUNCH:
 
  TO LAUNCH:
 
   
 
   
−
  Type "q3osc" to launch bash script in /Users/slork/slork/scripts/
+
  Type "fernando" to launch bash script in /Users/slork/slork/scripts/
 
   
 
   
−
  "q3osc <user-number> <sounding-radius> <host-ip>"
+
  "fernando <user-number: 1-20> <sounding-radius: ~900> <host-ip: 10.0.1.200>"
 
   
 
   
 
  e.g.:
 
  e.g.:
 
    
 
    
−
   shabushabu:~ slork$ q3osc 3 900 10.0.1.189
+
   shabushabu:~ slork$ fernando3 900 10.0.1.189
 
    
 
    
−
   - calls "chuck -c8 /Users/slork/slork/users/rob/q3osc/quintet.ck:3:900
+
   - calls "chuck -c8 /Users/slork/slork/users/rob/q3osc/fernando.ck:3:900
 
   - launches /Applications/OpenArena and connects to ip address 10.0.1.189 on default port 27660
 
   - launches /Applications/OpenArena and connects to ip address 10.0.1.189 on default port 27660
 
   - exec's a specific config file for each performer based on their user number:
 
   - exec's a specific config file for each performer based on their user number:
Line 55: Line 99:
  
  
−
==== Getting Started ====
+
 
−
After loading the software, press fn+F1-4 where # is the same as the number you enter on the command line:
+
−
+
−
Player 1: /bind F1 "exec pspeed.cfg"
+
−
Player 2: /bind F2 "exec gspeed.cfg"
+
−
Player 3: /bind F3 "exec hspeed.cfg"
+
−
Player 4: /bind F4 "exec gravity.cfg"
+
  
  
Line 77: Line 115:
 
  (SPACE) jump
 
  (SPACE) jump
 
  (c) crouch  
 
  (c) crouch  
 +
(SHIFT) run
 +
 +
(L) give more plasma ammo
 
   
 
   
 
  (8) select plasma gun
 
  (8) select plasma gun
Line 98: Line 139:
 
  Global Parameter Controls:
 
  Global Parameter Controls:
 
   
 
   
−
  Each client uses number keys 1-7 to control different attributes of the game world:
+
  Each client uses number keys 1-5 to control different global attributes of the game world:
 
   
 
   
 
  (1) Set Plasma speed to 10 /bind 1 rcon g_plasma_speed 10
 
  (1) Set Plasma speed to 10 /bind 1 rcon g_plasma_speed 10
Line 123: Line 164:
 
  (4) Set world gravity to 1000   /bind 4 rcon g_gravity 1000
 
  (4) Set world gravity to 1000   /bind 4 rcon g_gravity 1000
 
  (5) Set world gravity to 3000   /bind 5 rcon g_gravity 3000
 
  (5) Set world gravity to 3000   /bind 5 rcon g_gravity 3000
−
 
−
 
−
==== Server/Admin shortcuts ====
 
−
 
−
To copy updated files to clients:
 
−
-----------------------------------------------------------------------------
 
−
scp quintet.ck snickers.local:~/slork/users/rob/q3osc/
 
−
scp quintet.ck xiaolongbao.local:~/slork/users/rob/q3osc/
 
−
scp quintet.ck padthai.local:~/slork/users/rob/q3osc/
 
−
scp quintet.ck transfat.local:~/slork/users/rob/q3osc/
 
−
scp quintet.ck seventeen.local:~/slork/users/rob/q3osc/
 
−
 
−
Running clients:
 
−
-------------------------------------------------------------------------
 
−
NOTE: client 0 = center, clients 1-4 are respectively top, right, bottom, left
 
−
 
−
chuck -c8 ~/slork/users/rob/q3osc/quintet.ck:0:900
 
−
chuck -c8 ~/slork/users/rob/q3osc/quintet.ck:1:1000
 
−
chuck -c8 ~/slork/users/rob/q3osc/quintet.ck:2:1000
 
−
chuck -c8 ~/slork/users/rob/q3osc/quintet.ck:3:1000
 
−
chuck -c8 ~/slork/users/rob/q3osc/quintet.ck:4:1000
 

Latest revision as of 19:51, 13 June 2008

nous sommes tous Fernando...

quintet_caps_400.png

nous sommes tous Fernando... by Robert Hamilton is an improvisatory work written for the Stanford Laptop Orchestra (SLOrk) using q3osc and ChucK. Four performers control avatars in a virtual environment, firing sound-projectiles which bounce or home-in on individual performers, creating sound events with every bounce/collision with a surface of the environment. Virtual sound sources are laid out in a "+," represented by hemispherical structures in the virtual environment, with hemispherical speakers in the real-world laid out in a similar configuration. Spatialization is correlated between virtual and real-environments, with various aspects of each sound-event (frequency, timbre, duration) mapped to various axis and relationships in the virtual environment. Additionally, each of the four performers has real-time control over one of four super-sets of global parameters controlling respectively Projectile-Speed, Homing-Speed, Client-Speed, and Gravity. These commands are bound to the keyboard (1-5) in increasing increments (0/10, 100, 500, 1000, 3000) and can be triggered at any time during the performance to affect all performers.

Performers are encouraged to think of the work as a collaborative improvisation and to explore the environment searching for new performative gestures and sounds.

Some ideas:

  • Repetitive/canonic gestures can be performed by firing multiple projectiles without moving or changing the view angle.
  • All projectiles can be destroyed by toggling off either the plasma persist toggle (Y), the bfg persist toggle (U), the plasma homing persist toggle (i) or the bfg homing persist toggle (O).
  • Homing projectiles create interesting auditory gestures. Changing the speed of homing projectiles (Client #3 - keys 1-5) can have interesting effects.


Media

YouTube Video: http://www.youtube.com/watch?v=a3aZx0eWpx0


Program Notes

nous sommes tous Fernando... for 16 laptops and q3osc Robert Hamilton

Deep underground, located beneath the CCRMA courtyard lies a super-secret musical warfare laboratory funded by the United States Military, developed in conjunction with Guitar Center and Sweetwater.com. While details about the project are scarce to none, local legends usually mention high-powerd futuristic plasma weapons... and lizards.

nous sommes tous Fernando... by Robert Hamilton is an improvisatory work written for the Stanford Laptop Orchestra (SLOrk) using q3osc and ChucK. Performers control avatars in a virtual environment, firing sound-projectiles which bounce or home-in on individual performers, creating sound events with every bounce/collision with a surface of the environment. Virtual sound sources are represented by hemispherical structures in the virtual environment, with hemispherical speakers in the real-world laid out in a similar configuration. Spatialization is correlated between virtual and real-environments, with various aspects of each sound-event (frequency, timbre, duration) mapped to various axis and relationships in the virtual environment. For more information: https://cm-wiki.stanford.edu/wiki/Q3osc


Files

q3osc Installer: q3osc.zip

q3osc install dir: install

Quintet ChucK script: quintet.ck

Large composite of screen-caps: quintet_caps.png


Instructions

speakers.png

nous sommes tous Fernando... was designed to be run using five slork hemispherical speakers arranged in a + shape with one speaker in the center and 1 speaker on each of the ends of the +. Each user sits at a slork station next to a hemispherical speaker. The center speaker is left un-manned and is connected to a subwoofer. Each physical speaker location has a unique number from 0-4 with 0 being the center speaker, being respectively - on a clock face - 1 being 12 o'clock, 2 being 3 o'clock, 3 being 6 o'clock, and 4 being 9 o'clock. These id's are used to identify each user's station to the software for correlation between virtual speaker placements and physical speaker placements (see diagram => ). All performers should be facing inwards towards the center speaker so that they can make eye and gestural contact with one another.

One computer running the q3osc game-server should be running and connected to the local network (preferably over ethernet for now). Currently q3osc has only been successfully compiled in linux so the server should be running linux (Fedora 8 works nicely). The server can be connected to a video projector to project an overall view of the environment to the audience. In this regard, when the server is started it can either be run as a client server (where the game itself appears on the screen of the server), or as a dedicated server, where a separate machine can login as a game client and be used with the projector. A fifth performer of the piece should be controlling this "spectator" client, "filming" the performance for display on the projector.

Clients launch q3osc by opening an OS X terminal window and by launching the q3osc shell-script, passing in 3 parameters: and integer 1-4 for the speaker location at which they're sitting, an integer for the speaker-radius for which sounds will occur, and the ip-address of the game server. For example, the call below will launch q3osc, load the dirt_dome.bsp map (set by default), connect to the server 10.0.1.189, and will launch ChucK with parameters "-c8 quintet.ck:3:900" where quintet is the name of the ChucK script, -c8 sets multi-channel output to 8 channels, 3 specifies the speaker-set location (see diagram) and 900 sets the speaker-radius. 

shabushabu:~ slork$ q3osc 3 900 10.0.1.189


After the client is loaded into the game engine and the virtual-environment appears on-screen, the client should press fn+F1, F2, F3 or F4, matching the F# to the Speaker-set number they entered at the command line. With the above example, the client would press fn+F3. This loads a specific configuration file for that client, giving each client specific controls over different global game parameters. 

	Player 1:	 fn+F1    	/bind F1 "exec pspeed.cfg"
	Player 2:	 fn+F2    	/bind F2 "exec gspeed.cfg"
	Player 3:	 fn+F3    	/bind F3 "exec hspeed.cfg"
	Player 4:	 fn+F4    	/bind F4 "exec gravity.cfg"

Additional points:

  • Each client should make sure a multi-channel interface is connected as default sound source in Mac OS X.
  • A mouse can be used with the laptop to make control of the system more natural.
  • When in the game engine, pressing the ~ key brings down the quake-terminal and returns Mouse-focus to the operating system.
  • Things like hot-corners on a mac should be disabled
  • Sound from the game client itself can be either completely disabled or set to the lowest possible setting, adding a bit of ambient noise for each client (note: these sounds are not spatialized but add an interesting element to the performance.


Installation

  • download q3osc.zip and unzip the archive.
  • run the ./install.sh shell script to install the q3osc mod of OpenArena, the q3osc maps and custom config files. Follow instructions listed in the terminal window at the end of the shell script.


Run the program(s)

A custom bash script is installed by the installation process to the ~/slork/scripts/ directory: 

TO LAUNCH:

Type "fernando" to launch bash script in /Users/slork/slork/scripts/

	"fernando <user-number: 1-20> <sounding-radius: ~900> <host-ip: 10.0.1.200>"

e.g.:
 
 	shabushabu:~ slork$ fernando3 900 10.0.1.189
 
 		- calls "chuck -c8 /Users/slork/slork/users/rob/q3osc/fernando.ck:3:900
 		- launches /Applications/OpenArena and connects to ip address 10.0.1.189 on default port 27660
 		- exec's a specific config file for each performer based on their user number:
 			1:	pspeed.cfg
 			2:	gspeed.cfg
 			3:	hspeed.cfg
 			4:	gravity.cfg
 
 example call: /Applications/OpenArena.app/Contents/MacOS/ioquake3.ub connect 10.0.1.189:27660



In-Game Controls

Key-Commands 


Settings are stored in q3config.cfg file located in ~/slork/Application\ Support/OpenArena/ccrma/

(w) 		move forwards
(s)		move backwards
(a)		strafe left
(b)		strafe right
(SPACE)		jump
(c)		crouch 
(SHIFT)		run

(L)		give more plasma ammo

(8)		select plasma gun
(9)		select bfg 

(b)		toggle Plasma Bounce on/off
(n)		toggle BFG Bounce on/off
(y)		toggle Plasma Persist on/off 

(h)		toggle Homing on/off
(p)		toggle Parent Homing on/off
(j)		toggle Parent Homing Only on/off
(u)		toggle BFG Homing on/off
(i)		toggle Plasma Homing Persist on/off
(o)		toggle BFG Homing Persist on/off 

(v)		toggle client weapon damage on/off 

(')		Take snapshot (saves to ~/slork/Library/Application\ Support/OpenArena/ccrma/screenshots/) 

Global Parameter Controls:

Each client uses number keys 1-5 to control different global attributes of the game world:

(1)		Set Plasma speed to 10			/bind 1 rcon g_plasma_speed 10	
(2)		Set Plasma speed to 100			/bind 2 rcon g_plasma_speed 100	
(3)		Set Plasma speed to 500			/bind 3 rcon g_plasma_speed 500
(4)		Set Plasma speed to 1000			/bind 4 rcon g_plasma_speed 1000
(5)		Set Plasma speed to 3000			/bind 5 rcon g_plasma_speed 3000

(1)		Set Homing speed to 10			  /bind 1 rcon g_homing_speed 10			 
(2)		Set Homing speed to 100			  /bind 2 rcon g_homing_speed 100
(3)		Set Homing speed to 500			  /bind 3 rcon g_homing_speed 500
(4)		Set Homing speed to 1000		/bind 4 rcon g_homing_speed 1000
(5)		Set Homing speed to 3000		/bind 5 rcon g_homing_speed 3000

(1)		Set client speed to 10			          /bind 1 rcon g_speed 10
(2)		Set client speed to 100			  /bind 2 rcon g_speed 100
(3)		Set client speed to 500			  /bind 3 rcon g_speed 500
(4)		Set client speed to 1000			  /bind 4 rcon g_speed 1000
(5)		Set client speed to 3000 			  /bind 5 rcon g_speed 3000

(1)		Set world gravity to 10			  /bind 1 rcon g_gravity 10
(2)		Set world gravity to 100			  /bind 2 rcon g_gravity 100
(3)		Set world gravity to 500			  /bind 3 rcon g_gravity 500
(4)		Set world gravity to 1000			  /bind 4 rcon g_gravity 1000
(5)		Set world gravity to 3000			  /bind 5 rcon g_gravity 3000
Retrieved from "https://ccrma.stanford.edu/mediawiki/index.php?title=Q3osc:_works&oldid=5546"