package: Lat-Long Media Viewer
author: Autodesk, Inc.
organization: Autodesk, Inc.
version: 1.2
requires: ''
rv: 6.0.1
openrv: 1.0.0
optional: true

modes: 
  - file: lat_long_viewer.py
    menu: ''
    shortcut: ''
    event: ''
    load: immediate

description: |

  <body class="article">
  <div id="header">
  <h1>LatLong Viewer (v1.0)</h1>
  </div>
  <div id="content">
  <div id="preamble">
  <div class="sectionbody">
  <style type="text/css">
      a:link {
          color: blue;
          color:#4444dd;
      }
      a:visited {
          color: darkgray;
          color: #666666;
      }
      a:hover {
          color: #ff5555;
      }
  </style>
  <div class="paragraph"><p>&#169; 2021 <a href="https://www.autodesk.com">Autodesk</a></p></div>
  </div>
  </div>
  <div class="sect2">
  <h3 id="_introduction">Introduction</h3>
  <div class="paragraph"><p>This experimental package provides a custom node that implements a "viewer" for lat-long or spherically-mapped media.  That is, the input to the node is considered to be suitable for mapping onto a sphere, where the x coordinate of the image is "latitude" and the y coordinate is "longitude".  The viewer then implements a perspective view of the sphere from a point in the center, with view direction and "focalLength" determined by properties on the node.</p></div>
  <div class="paragraph"><p><strong>NOTE</strong> LatLongViewer GLSL shader courtesy of The Mill!</p></div>
  </div>
  <div class="sect2">
  <h3 id="_menu_items">Menu Items</h3>
  <div class="paragraph"><p>Five menu items provide access to various functions of the package:</p></div>
  <div class="sect3">
  <h4 id="_em_image_stereo_latlong_viewer_add_to_source_em"><em>Image/LatLong Viewer-Add To Source</em></h4>
  <div class="paragraph"><p>Selecting this menu item will cause RV to examine the currently visible sources, and for each, if it does not already have a LatLongViewer node, add one.  Note that the node will be added "internally" (in the RVColorPipelineGroup within the Source), so the new node will not be visible in the Session Manager, and any view using this Source will see the output of the viewer node.</p></div>
  </div>
  <div class="sect3">
  <h4 id="_em_image_stereo_latlong_viewer_add_as_top_level_node_em"><em>Image/LatLong Viewer-Add As Top-Level Node</em></h4>
  <div class="paragraph"><p>Selecting this menu item will cause RV to add a LatLongViewer node at the "top level" where it <strong>will</strong> be visible in the Session Manager, and connect the current view as the Viewer&#8217;s input.</p></div>
  </div>
  <div class="sect3">
  <h4 id="_em_image_stereo_latlong_viewer_enabled_em"><em>Image/LatLong Viewer-Enabled</em></h4>
  <div class="paragraph"><p>This item will appear checked if there is one or more LatLongViewer node in the current evaluation path, and all such nodes are active.  Selecting this item will activate or deactivate all the LatLongViewer nodes in the current evaluation path.  When the viewer node is inactive, it has no effect.</p></div>
  </div>
  <div class="sect3">
  <h4 id="_em_image_stereo_latlong_viewer_adjust_focal_length_em"><em>Image/LatLong Viewer-Adjust Focal Length</em></h4>
  <div class="paragraph"><p>Selecting this item lets you change the focal length parameter to the LatLongViewer shader.  After you select the menu item, just mouse down and drag in view to adjust, like other RV "virtual sliders".</p></div>
  </div>
  <div class="sect3">
  <h4 id="_em_image_stereo_latlong_viewer_adjust_view_with_shift_drag_em"><em>Image/LatLong Viewer-Adjust View With Shift-Drag</em></h4>
  <div class="paragraph"><p>If this item is checked, holding the Shift key while click-dragging in the main view will change the "view direction" of the viewer.  Please note that the Pixel Inspector also uses shift-drag, so it cannot be used when this item is checked.  This item is stored as a preference.</p></div>
  </div>
  </div>
  </div>
  <div id="footnotes"><hr /></div>
  <div id="footer">
  <div id="footer-text">
  Last updated 2015-04-28 13:37:17 PDT
  </div>
  </div>
  </body>
  </html>
