<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="_c74_vig.xsl" type="text/xsl"?>
<vignette name="Search" package="Max" rankfactor="3">

  <h1>Sidebar Search</h1>
  <p>
    The search system in Max 8 combines information from the internal database
    with online sources to provide useful integrated results. By combining help
    and reference information with options from examples, packages, and even the
    Max forum, the search system offers a deeper view into the tools available to
    solve problems.
  </p>

  <p>
    <h2>Activate Search</h2>
    <ul>
      <li>
        Click on the Show Search Sidebar icon on the right patcher window toolbar.
      </li>
      <p>
        <img width="32" src="images/sch-01srchbutton.png"></img>
      </p>
      <li>
        Enter an object name, function or other search text into the entry
        box; the results will be shown in the sidebar.
      </li>
      <p>
        <img width="162" src="images/sch-02srchentry.png"></img>
      </p>
      <li>
        Click the Search icon again (or click the Close button) to close the Search pane.
      </li>
      <p>
        <img width="22" src="images/sch-03closebutton.png"></img>
      </p>
      <li>
        Results are grouped by the content type; the list includes information from
        the application and the cycling74.com website.
      </li>
      <p>
        <img width="414" src="images/sch-04srchresults.png"></img>
      </p>
      <li>
        If there is more information available for any content type, a ‘Show
        more results’ link will allow this content to be loaded. When this
        link is selected, the pane will show only content of that type, and will
        display as many results as possible.
      </li>
      <p>
        <img width="414" src="images/sch-05showmore.png"></img>
      </p>
      <li>
        You can see more information about any entity in the Details Pane at
        the bottom of the Search Pane.
      </li>
      <p>
        <img width="413" src="images/sch-06details.png"></img>
      </p>
      <li>
        Toggle the Details Pane using the button at the bottom-left of
        the Search Pane.
      </li>
      <p>
        <img width="32" src="images/sch-07panetoggle.png"></img>
      </p>
    </ul>
  </p>

  <p>
    <h2>Using Search Content</h2>
    <ul>
      <li>
        Drag an object from the search pane to instantiate it in your
        patcher.
      </li>
      <li>
        Double-click on a documentation entry to reveal it in the documentation
        browser.
      </li>
      <li>
        Drag a patcher or snippet into your patcher to create a subpatcher
        with that content. Dragging and dropping while holding down the option key expands options.
      </li>
      <li>
        Drag an audio file onto your patcher to create a playlist~ object
        containing that file. Dragging and dropping while holding down the option key expands options.
      </li>
      <li>
        Drag an image onto your patcher to create an fpic object containing
        that image. Dragging and dropping while holding down the option key expands options.
      </li>
      <li>
        Drag a movie file onto your patcher to create a jit.playlist object
        containing that movie. Dragging and dropping while holding down the option key expands options.
      </li>
      <li>
        Drag a plug-in file onto your patcher to instantiate a vst~ or amxd~
        object with the selected plug-in.
      </li>
      <li>
        Double-click on a forum post or website article to open it in a web
        browser.
      </li>
    </ul>
    <br />
  </p>

  <bluebox>
    <h2>Where does search look?</h2>
    <p>
      Search text is gathered from the following locations:
      <ul>
        <li>Files in the Max Search Path,</li>
        <li>Files active in the Max Package Manager,</li>
        <li>The Cycling ‘74 Website (articles and forum posts)</li>
      </ul>
    </p>
    <p>
      Text is retrieved from the following content:
      <ul>
        <li>Object textual information and reference files,</li>
        <li>In-app documentation, including guides, topics and tutorials,</li>
        <li>Gen objects and textual information,</li>
        <li>Patches, clippings, projects and snippets,</li>
        <li>VST, AudioUnit and AMXD plug-ins,</li>
        <li>Scripts (javascript and lua), program, data and media files,</li>
        <li>Available packages (from the Package Manager Server),</li>
        <li>The cycling74.com forum and articles</li>
      </ul>
    </p>
  </bluebox>

</vignette>
