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

<c74object name='spectrogram.colorbar'>

	<digest>
		Colorbar displaying magnitude-to-color mappings used in a connected <o>spectrogram~</o> object
	</digest>
	<description>
		Use the <o>spectrogram.colorbar</o> object to display for how magnitudes map to colors in an attached <o>spectrogram~</o> object.
		<br />
		<br />
		<a href="https://www.youtube.com/playlist?list=PLHc927eu2oKYhvWtMZ7XhzYrs3WBCVVWj">Tutorial Videos on YouTube</a>
	</description>


	<!--METADATA-->
	<metadatalist>
		<metadata name='author'>Zachary Seldess</metadata>
		<metadata name='tag'>MSP</metadata>
		<metadata name='tag'>MSP U/I</metadata>
	</metadatalist>


	<!--INLETS-->
	<inletlist>
	</inletlist>


	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="anything">
			<digest>Connect to inlet of <o>spectrogram~</o> object</digest>
		</outlet>
	</outletlist>


	<!--ARGUMENTS-->
	<objarglist>
	</objarglist>


	<!--MESSAGES-->
	<methodlist>
		<method name="write">
			<arglist />
			<digest>
				Save colorbar as custom-resolution PNG file.
			</digest>
			<description>
				Save colorbar as custom-resolution PNG file.
				<br />
				Optional arguments:
				<ul>
					<li>
						<b>Version 1</b> - Width Height DPI (will open file chooser)
					</li>
					<li>
						<b>Version 2</b> - Filename Width Height DPI
					</li>
					Defaults:
					<ul>
						- Width = Object width in patcher. Range 1 - 100000.
						<br />
						- Height = Object height in patcher. Range 1 - 100000.
						<br />
						- DPI = 72. Range 1 - 10000.
					</ul>
					Providing a Width or Height of &lt;= 0 will fall back to object dimensions.
				</ul>
			</description>
		</method>
	</methodlist>


	<!--ATTRIBUTES-->
	<attributelist>
		<!--Display Category-->
		<attribute name='textsize' get='1' set='1' type='int' size='1'>
			<digest>
				Text size.
			</digest>
			<description>
				Text size. Range 1 - 72. (default 12)
			</description>
		</attribute>

		<attribute name='textjustification' get='1' set='1' type='int' size='1'>
			<digest>
				Text justification.
			</digest>
			<description>
				Text justification:
				<ul>
					<li>
						<b>left (0)</b> - Left justified
					</li>
					<li>
						<b>center (1)</b> - Center justified (default)
					</li>
					<li>
						<b>right (2)</b> - Right justified
					</li>
				</ul>
			</description>
		</attribute>

		<!--Color Category-->
		<attribute name='textcolor' get='1' set='1' type='rgba' size='1'>
			<digest>
				Text color.
			</digest>
			<description>
				Text color. (default 0.4 0.6 0.4 1.)
			</description>
		</attribute>
	</attributelist>


	<!--RELATED-->
	<seealsolist>
		<seealso name="spectrogram~"/>
		<seealso name="buffer~"/>
		<seealso name="waveform~"/>
	</seealsolist>


	<misc name="Input">
	</misc>

	<misc name="Output">
		<entry name="anything">
			<description>
				1st outlet: Connect to inlet of <o>spectrogram~</o> object.
			</description>
		</entry>
	</misc>
</c74object>
