<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<c74object name="sdt.bubble~">

	<digest>
		[liquids] Bubble popping sound.
	</digest>

	<description>
		<o>sdt.bubble~</o> simulates a single spherical bubble collapsing. Indeed an exponentially decaying sinusoidal oscillator.
		It takes two control parameters: the bubble <i>radius</i> and the pitch <i>rise factor</i>.
	</description>

	<!--METADATA-->
	<metadatalist>
		<metadata name="tag">Sound Design Toolkit</metadata>
	</metadatalist>

	<!--INLETS
	<inletlist>
		<inlet id="0" type="messages to the bubble object">
			<digest>Messages to the bubble object.</digest>
			<description>Messages to the bubble object, bang triggers the process.</description>
		</inlet>
	</inletlist>
	-->

	<!--OUTLETS
	<outletlist>
		<outlet id="0" type="signal">
			<digest>Audio signal: Bubble sound.</digest>
		</outlet>
	</outletlist>
	-->

	<!--ARGUMENTS
	<objarglist>
		<objarg name="" optional="" type="">
			<digest></digest>
		</objarg>
	</objarglist>-->

	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
		<!--	<arglist>
				<arg name="bubble trigger" optional="0" type="bang" />
			</arglist>-->
			<digest>
				Inlet 0: Bang triggers a bubble event.
			</digest>
			<description></description>
		</method>
	</methodlist>

	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="radius" get="1" set="1" type="float" size="1" >
		    <digest>Bubble radius (mm) [0.15, 150.].</digest>
		    <description></description>
	  </attribute>

		<attribute name="riseFactor" get="1" set="1" type="float" size="1">
		    <digest>Pitch rise factor [0., 3.]. Simulates the rise in pitch occurring when a bubble shrinks before collapsing.</digest>
		    <description></description>
	  </attribute>
	</attributelist>

	<!--SEEALSO-->
	<seealsolist>
		<seealso name="sdt.fluidflow~"/>
	</seealsolist>

</c74object>
