<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="_c74_vig.xsl" type="text/xsl"?>
<vignette name="Annotations" package="Max" rankfactor="1">
  <h1>
	Annotations
	</h1>
  <p><i>Annotations</i> are explanatory text associated with a
			specific object. Annotations are viewable when patches are
			locked or unlocked, and the annotated text is displayed in the
			Patcher window's
			<link module="core" name="clue_window" type="vignette">Clue Window</link>.
		</p>
  <br/>
  <bluebox>
    <h2>
	Adding an annotation to an object
	</h2>
    <ul>
      <li>
			Select an object and open its
			<link module="core" name="inspector" type="vignette">Inspector</link>.
		</li>
      <li>
			Double-click on the Annotation attribute under the Description heading. A text box will
			appear for entering some text (The annotation marker is only visible when a
			patch is unlocked).
		</li>
      <li>
			When you enter the text, an <i>annotation marker</i> will appear in the upper right-hand
			corner of the selected object.
		</li>
    </ul>
    <p>
      <img src="images/annotations1.png"/>
    </p>
    <ul>
      <li>
			When you move the mouse over the object you have annotated, your text will be
			shown in the patchers <link module="core" name="clue_window" type="vignette">Clue Window</link>, the
			Clue Window will change color to indicate that the text refers to an annotation
			you've made.
		</li>
    </ul>
    <p>
      <img src="images/annotations2.png"/>
    </p>
  </bluebox>
  <br/>
  <space/>
  <bluebox>
    <h2>
	Removing an annotation from an object
	</h2>
    <ul>
      <li>
			Select an object and open its
			<link module="core" name="inspector" type="vignette">Inspector</link>.
		</li>
      <li>
			Double-click in the Value column for the Annotation attribute. Remove
			the text. After you do so the annotation marker will disappear from the
			selected object.
		</li>
    </ul>
  </bluebox>

  <!--
  <br/>
  <p>
			If you are using the
			<link module="core" name="clue_window" type="vignette">Clue Window</link>
			rather than the Status Bar, you can set its background and text color
			when you're displaying an annotation you've added to your patch.
		</p>
  <br/>
  <bluebox>
    <h2>
	Assigning an annotation color for the Clue Window
	</h2>
    <ul>
      <li>
			Choose <b>Preferences</b> from the Max menu (Mac) or the Options menu (Windows) and
			locate the Clue category.
		</li>
      <li>
			Use the
			<link module="core" name="color_picker" type="vignette">Color Picker</link>
			to change the color of the Clue Window Background Color setting. When you move
			the mouse over an object with annotation, the Patcher window's
			<link module="core" name="clue_window" type="vignette">Clue Window</link>
			will change to the color you've assigned.
		</li>
      <li>
			You may also want to change the color of the Clue Window Text Color setting so
			that the text contrasts with the background color you've chosen.
		</li>
    </ul>
  </bluebox>
-->
</vignette>
