<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../../support/xsl/i2html.xsl" ?>
<?file-path ref_panes_chopview.xml?>
<topic xmlns:ink="http://sidefx.com/doc/ns/ink/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://sidefx.com/doc/ns/ink/1.1" id="ref_panes_chopview" status="unfinished" xsi:schemaLocation="http://sidefx.com/doc/ns/ink/1.1 ../../support/schema/ink/1.1/ink.xsd"><title>CHOP viewer</title><body>
            <p>A CHOP viewer pane is a Viewer pane with its Network menu set to Motion and Audio (CHOPs). The viewer shows you the sample data passing through channel operators.</p>

            <p>TBD.</p>

            <tasklist>
                <taskname>Scope a CHOP node in the network view.</taskname>

                <steps>
                    <li>Click the node's graph flag. Shift-click to add/remove the node to/from the scope.</li>
                </steps>

                <taskname>Select channels to scope from a list.</taskname>

                <steps>
                    <li>Open the <menu>Options</menu> menu in the toolbar and turn on <menu>Scoping Tools</menu>.</li>

                    <li>To add channels, choose them from the + pop-up menu. To remove channels, choose them from the - pop-up menu. To set channels, choose from the = pop-up menu.</li>
                </steps>

                <taskname>Edit sample data</taskname>

                <steps>
                    <li>See <link to="ref_panes_chopview_rawedit">edit raw samples</link>.</li>
                </steps>

                <taskname>Add a text note to the graph</taskname>

                <steps>
                    <li>Click the Frame Indicator icon in the toolbar to show the blue vertical "current frame" line.</li>

                    <li>Drag the blue frame line to the frame you want to annotate.</li>

                    <li>Click the Toggle Options icon in the toolbar to switch to the annotation toolbar.</li>

                    <li>Choose the CHOP you want to annotate from the pop-up menu.</li>

                    <li>Type the note in the text box and press <key>Enter</key>. The text will appear on the graph at the current frame.</li>
                </steps>
            </tasklist>

            <section>
                <title>Mouse shortcuts in the graph</title>

                <table>
                    <tr>
                        <td>
                            <keycombo>
                                <key>Shift</key>

                                <key>LMB</key>
                            </keycombo>
                        </td>

                        <td>Set the current CHOP.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Ctrl</key>

                                <key>LMB</key>
                            </keycombo>
                        </td>

                        <td>Set the current frame.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Alt</key>

                                <key>LMB</key>
                            </keycombo>
                        </td>

                        <td>Set the current CHOP and frame to the nearest sample.</td>
                    </tr>

                    <tr>
                        <td>
                            <key>MMB</key>
                        </td>

                        <td>Scale the graph.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Shift</key>

                                <key>MMB</key>
                            </keycombo>
                        </td>

                        <td>Scale all graphs simultaneously.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Ctrl</key>

                                <key>MMB</key>
                            </keycombo>
                        </td>

                        <td>Constrain scaling to vertical or horizontal only.</td>
                    </tr>

                    <tr>
                        <td>
                            <key>RMB</key>
                        </td>

                        <td>Pans across the graph.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Shift</key>

                                <key>RMB</key>
                            </keycombo>
                        </td>

                        <td>Pans across all graphs simultaneously.</td>
                    </tr>

                    <tr>
                        <td>
                            <keycombo>
                                <key>Ctrl</key>

                                <key>MMB</key>
                            </keycombo>
                        </td>

                        <td>Constrain panning to vertical or horizontal only.</td>
                    </tr>
                </table>
            </section>

            <section>
                <title>Toolbar</title>

                <dl>
                    <dt>Frame indicator</dt>

                    <dd>Click to show/hide a blue line indicating the current frame.</dd>

                    <dt>Auto scroll</dt>

                    <dd>Turn this on to have the viewer automatically follow the current frame during playback.</dd>

                    <dt>Options menu</dt>

                    <dd>See <link to="ref_panes_chopview_options">options toolbar menu</link>.</dd>

                    <dt>Graphs menu</dt>

                    <dd>Lets you arrange the scoped parameters in separate graphs.</dd>

                    <dt>Horizontal/Vertical adapt</dt>

                    <dd>When these options are on, the viewer automatically pans and zooms to show all intervals and ranges of the scoped parameters.</dd>

                    <dt>Home graph</dt>

                    <dd>Pans and zooms the view to show all intervals and ranges of the scoped parameters.</dd>

                    <dt>Vertical adapt options menu</dt>

                    <dd>Controls which vertical range to use for homing the Graph or the Vertical Adapt button. <menu>Auto</menu> (the default) uses the minimum and maximum values on the graph. Choose <menu>Other</menu> to set the range explicitly. The other choices specify common range presets.</dd>

                    <dt>Disable graph</dt>

                    <dd>When this option is on, the graph does not update. Use this to speed up Houdini when you don't need the CHOP graph.</dd>

                    <dt>Toggle options</dt>

                    <dd>Switches between the toolbar and a text box you can use to annotate the current frame of a CHOP graph.</dd>

                    <dt>Curve/Bar display switch</dt>

                    <dd>Switches between displaying curves and sample bars.</dd>
                </dl>
            </section>

            <section>
                <title>Options toolbar menu</title>

                <dl>
                    <dt>Labels</dt>

                    <dd>Show channel names.</dd>

                    <dt>Handles</dt>

                    <dd>Show handles on the channel data, allowing you to edit it directly.</dd>

                    <dt>Dots</dt>

                    <dd>Show dots at each sample point. This is useful for finding sampling errors by visually examining the individual channel values.</dd>

                    <dt>Extend Regions</dt>

                    <dd>Shows the values obtained when sampling the channels outside the CHOP's range.</dd>

                    <dt>Raw Edit Tools</dt>

                    <dd>See <link to="ref_panes_chopview_rawedit">editing raw samples</link>.</dd>

                    <dt>Scope Tools</dt>

                    <dd>Show menus for choosing scoped parameters.</dd>

                    <dt>Frames, Samples, Seconds</dt>

                    <dd>Sets the time unit used for the horizontal scale of the graph.</dd>

                    <dt>Grid Low, Grid Medium, Grid High</dt>

                    <dd>Sets the density of grid lines.</dd>
                </dl>
            </section>

            <section id="ref_panes_chopview_rawedit">
                <title>Edit raw samples</title>

                <p>You can use the "raw edit" tools to directly set the values of sample data. This is sometimes faster and simpler than the alternative of fitting the data through smooth spline approximations, and then editing them in the Channel Editor.</p>

                <p>First, set up the viewer for editing:</p>

                <steps>
                    <li>Open the <menu>Options</menu> menu in the toolbar and turn on <menu>Raw Edit Tools</menu> to show the editing tools under the graph.</li>

                    <li>Turn on <menu>Options &gt; Dots</menu> and <menu>Options &gt; Handles</menu> as well.</li>
                </steps>

                <p>Then, you can use various tools to edit samples:</p>

                <ul>
                    <li>
                        <p>Click, Shift-click, and/or drag a marquee around samples to select them.</p>
                    </li>

                    <li>
                        <p>Drag a sample handle to change its value.</p>
                    </li>

                    <li>
                        <p>Use the buttons in the raw edit toolbar:</p>

                        <dl>
                            <dt>Group</dt>

                            <dd>Shift all selected samples by the same vertical amount as the selected sample.</dd>

                            <dt>Span Drop Off</dt>

                            <dd>Shift neighboring selected samples by an amount relative to the selected sample. Samples nearest the selected sample move the most.</dd>

                            <dt>Ease, Ease Out, Ease In, Cubic, Linear, Constant</dt>

                            <dd>Interpolate the selected span with the corresponding function. The location of the currently selected sample determines the path of the interpolation.</dd>

                            <dt>Copy Absolute</dt>

                            <dd>The selected samples can be shifted horizontally to create duplicates of the selection. The shifted samples replace the original underlying samples.</dd>

                            <dt>Copy Relative</dt>

                            <dd>The selected samples can be shifted horizontally to create duplicates of the selection. The shifted samples are added to the original underlying samples.</dd>

                            <dt>Copy Unconstrained</dt>

                            <dd>The selected samples can be shifted horizontally as well as vertically to create duplicates of the selection.</dd>

                            <dt>Quaternion</dt>

                            <dd>TBD.</dd>

                            <dt>Col Select</dt>

                            <dd>When this checkbox is on, any selection made in one channel is mirrored to all other displayed channels.</dd>
                        </dl>
                    </li>
                </ul>

                <section>
                    <title>Example</title>

                    <steps>
                        <li>Display three default Wave chops (one graph per CHOP). Turn on Dots, and click the Cubic icon. Turn on <button>Col Select</button>.</li>

                        <li>Marquee select the first fifty frames of the first channel. The range is resampled as a cubic spline for all three channels.</li>

                        <li>Drag a selected sample vertically, modifying the shape of the interpolation on all channels.</li>

                        <li>Click the Copy Relative icon.</li>

                        <li>Drag the selection to frame 100.</li>

                        <li>Click an empty area of the graph to deselect. Click the Span Cubic icon again.</li>

                        <li>Marquee select any area which appears to have a kink in it, and it will reinterpolate as a cubic shape.</li>
                    </steps>
                </section>
            </section>
        </body></topic>