Updating Soundscapes

<= Previous Change | Next Change =>

Diff Summary
Title
Date	2009-01-15 20:29	2009-01-15 20:33
Editor	Andrew Plotkin (zarf)	Andrew Plotkin (zarf)

	2009-01-15 20:29 by Andrew Plotkin			2009-01-15 20:33 by Andrew Plotkin
	8			8
	9	- - Titles in Boodler start with a capital letter,		9	- - Titles in Boodler start with a capital letter,
	>	but do not capitalize each word after that.		>	but do not capitalize each word after that.
	10			10
	11	- Add these lines:		11	- Add these lines:
	12			12
n	13	from boopak.package import *	n	13	`from boopak.package import *`
	14	from boodle import agent, builtin		14	`from boodle import agent, builtin`
	15			15
	16	- Make sure your Agent classes are defined as		16	- Make sure your Agent classes are defined as
	17			17
n	18	class MyAgentName(agent.Agent):	n	18	class MyAgentName(agent.Agent):
	19			19
	20	- - If you really want to use the `class MyAgentNa		20	- - If you really want to use the `class MyAgentNa
	>	me(agent.Agent):` format, add an import line of th		>	me(agent.Agent):` format, add an import line of th
	>	e form `from boodle.agent import Agent`.		>	e form `from boodle.agent import Agent`.
	21			21
	22	- Call `bimport()` for each package you want to im		22	- Call `bimport()` for each package you want to im
	>	port.		>	port.
	23			23
	24	- - All sound sample files live in packages now, s		24	- - All sound sample files live in packages now, s
	>	o you'll have to import them this way.		>	o you'll have to import them this way.
	25			25
	26	- - Sounds that used to be in the Boodler sound li		26	- - Sounds that used to be in the Boodler sound li
	>	brary are now mostly in `org.boodler.old...` packa		>	brary are now mostly in `org.boodler.old...` packa
	>	ges. For example, you might do this:		>	ges. For example, you might do this:
	27			27
n	28	water = bimport('org.boodler.old.water')	n	28	water = bimport('org.boodler.old.water')
	29			29
	30	- Instead of referring to a sound as a string, ref		30	- Instead of referring to a sound as a string, ref
	>	er directly to the object in the imported package.		>	er directly to the object in the imported package.
	>	For example:		>	For example:
	31			31
n	32	# replace this:	n	32	\# replace this:
	33	self.sched_note('environ/rain-heavy.aiff')		33	self.sched_note('environ/rain-heavy.aiff')
				>
	34	# with this:		34	\# with this:
	35	self.sched_note(water.rain_heavy)		35	self.sched_note(water.rain_heavy)
	36			36
	37	- - No quotes, no `.aiff` suffix, and dashes have		37	- - No quotes, no `.aiff` suffix, and dashes have
	>	generally turned into underscores. Examine the pac		>	generally turned into underscores. Examine the pac
	>	kage contents to see the exact names of the sound		>	kage contents to see the exact names of the sound
	>	files.		>	files.
	38			38
	39	- Built-in agents like `FadeOutAgent`, `FadeInOutA		39	- Built-in agents like `FadeOutAgent`, `FadeInOutA
	>	gent`, `StopAgent` are now in the `builtin` module		>	gent`, `StopAgent` are now in the `builtin` module
	>	. You will have to say, for example:		>	. You will have to say, for example:
	40			40
n	41	self.sched_agent(builtin.StopAgent())	n	41	self.sched_agent(builtin.StopAgent())
	42			42
	43	- Change all `__init__()` functions in your agent		43	- Change all `__init__()` functions in your agent
	>	classes to `init()`. Remove this line wherever it		>	classes to `init()`. Remove this line wherever it
	>	appears:		>	appears:
	44			44
t	45	# no longer needed:	t	45	\# no longer needed:
	46	Agent.__init__(self)		46	Agent.__init__(self)
	47			47
	48	- Make sure the arguments to `init()` are the righ		48	- Make sure the arguments to `init()` are the righ
	>	t types. Don't use an integer for a default value		>	t types. Don't use an integer for a default value
	>	if you want the user to be able specify a float. F		>	if you want the user to be able specify a float. F
	>	or list arguments, you should declare an `_args` f		>	or list arguments, you should declare an `_args` f
	>	ield to specify the list type.		>	ield to specify the list type.
	49			49
	50	- Remove the `float(...)`, `int(...)`, etc casts f		50	- Remove the `float(...)`, `int(...)`, etc casts f
	>	rom your `init()` method. Those conversations now		>	rom your `init()` method. Those conversations now
	>	occur automatically.		>	occur automatically.
	51			51