<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->

<c74object name="el.player~">
    
	<digest>
		Click-driven buffer playback
	</digest>
	<description>
		<o>el.player~</o>is a reentrant, click-triggered soundfile player. A note is triggered by a non-zero click in the left inlet. There are two modes of play. In static mode, the increment received in the right inlet at the time of the click trigger will be the increment for the duration of the note. In dynamic mode the increment can be continuously varied in the left inlet. The playback mode is an attribute.
    </description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Eric Lyon
		</metadata>
		<metadata name="tag">
			MSP
		</metadata>
		<metadata name="tag">
			LyonPotpourri
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="buffer name" type="symbol" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				The buffer to read from. It may have any number of channels.
			</description>
		</objarg>
		<objarg name="channel count" type="symbol" optional="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				Number of channels in target buffer. Default is 2.
			</description>
		</objarg>
		<objarg name="maximum overlaps" type="int" optional="1">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				Number of simultaneous playbacks allowed. As long as this is not exceeded by the attempted number of active notes, there will be no clicks when a new note starts; all currently active notes will play to the end of the buffer. Default is 2. This should be set much larger if you want a lot of overlaps, for example, through playing a drum sample repeatedly in a flam.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
        
		<method name="paranoia">
			<arglist>
                <arg name="toggle" type="int" optional="0" id="1" />
                
			</arglist>
			<digest>
				TEXT_HERE
			</digest>
			<description>
				Tries to make the external a bit safer when switching buffers at the cost of about double the CPU. Off by default.
            </description>
		</method>
        
		<method name="setbuf">
			<arglist>
                <arg name="new buffer name" type="symbol" optional="0" id="1" />
                
			</arglist>
			<digest>
				TEXT_HERE
			</digest>
			<description>
				Switch buffers.
            </description>
		</method>
        
		<method name="stop">
			<arglist>
                <!--arg name="new buffer name" type="symbol" optional="0" id="1" /-->
                
			</arglist>
			<digest>
				TEXT_HERE
			</digest>
			<description>
				Immediately stop all currently playing notes.
            </description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
        <attribute name="Static Increment" get="1" set="1" type="int" size="1">
            <digest/>
			<description>
				When this attribute is on, the increment is set for each note at the outset (in the right inlet) and remains constant for the duration of the note. When the attribute is off, the increment can be continuously manipulated, but is the same for all active notes.
            </description>
        </attribute>
	</attributelist>
	<!--SEEALSO-->
	<seealsolist>
        <seealso name="el.samm~"/>
        <seealso name="click~"/>
        <seealso name="buffer~"/>
		<seealso name="groove~"/>
        <seealso name="wave~"/>
	</seealsolist>
    
</c74object>
