rebuild

Author: nmwsharp

docs/404.html

@@ -650,6 +650,20 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="/structures/point_cloud/parameterization_quantities/" class="md-nav__link">
+        Parameterization Quantities
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
     <li class="md-nav__item">
       <a href="/structures/point_cloud/variable_radius/" class="md-nav__link">
         Variable Radius
@@ -763,6 +777,20 @@
 
 
 
+            
+              
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="/structures/curve_network/variable_radius/" class="md-nav__link">
+        Variable Radius
+      </a>
+    </li>
+  
+
+            
+          
         </ul>
       </nav>
     </li>

docs/FAQ/index.html

@@ -435,6 +435,13 @@
     Saving and restoring camera poses
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#centering-the-view-on-an-area-of-interest" class="md-nav__link">
+    Centering the view on an area of interest
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -494,8 +501,8 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#how-do-i-run-polyscope-on-a-remote-or-headless-server" class="md-nav__link">
-    How do I run Polyscope on a remote or headless server?
+  <a href="#how-do-i-run-polyscope-remotely-in-a-browser-via-a-notebook-or-on-headless-server" class="md-nav__link">
+    How do I run Polyscope remotely in a browser, via a notebook, or on headless server?
   </a>
 
 </li>
@@ -763,6 +770,20 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="../structures/point_cloud/parameterization_quantities/" class="md-nav__link">
+        Parameterization Quantities
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
     <li class="md-nav__item">
       <a href="../structures/point_cloud/variable_radius/" class="md-nav__link">
         Variable Radius
@@ -876,6 +897,20 @@
 
 
 
+            
+              
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../structures/curve_network/variable_radius/" class="md-nav__link">
+        Variable Radius
+      </a>
+    </li>
+  
+
+            
+          
         </ul>
       </nav>
     </li>
@@ -1654,6 +1689,13 @@
     Saving and restoring camera poses
   </a>
 
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#centering-the-view-on-an-area-of-interest" class="md-nav__link">
+    Centering the view on an area of interest
+  </a>
+  
 </li>
 
         <li class="md-nav__item">
@@ -1713,8 +1755,8 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#how-do-i-run-polyscope-on-a-remote-or-headless-server" class="md-nav__link">
-    How do I run Polyscope on a remote or headless server?
+  <a href="#how-do-i-run-polyscope-remotely-in-a-browser-via-a-notebook-or-on-headless-server" class="md-nav__link">
+    How do I run Polyscope remotely in a browser, via a notebook, or on headless server?
   </a>
 
 </li>
@@ -1738,9 +1780,10 @@ <h1>FAQ, Tips, and Tricks</h1>
 
 <ul>
 <li>
-<p><strong>Interface</strong></p>
+<p><strong>Interface and Camera Controls</strong></p>
 <ul>
 <li><a href="#saving-and-restoring-camera-poses">Saving and restoring camera poses</a></li>
+<li><a href="#centering-the-view-on-an-area-of-interest">Centering the view on an area of interest</a></li>
 <li><a href="#how-do-i-take-a-screenshot-save-an-image">How do I take a screenshot / save an image?</a></li>
 <li><a href="#positioning-objects-in-the-scene-and-reading-back-results">Positioning objects in the scene and reading back results</a></li>
 <li><a href="#managing-large-numbers-of-structures-and-quantities">Managing large numbers of structures and quantities</a></li>
@@ -1764,7 +1807,7 @@ <h1>FAQ, Tips, and Tricks</h1>
 <li>
 <p><strong>System</strong></p>
 <ul>
-<li><a href="#how-do-i-run-polyscope-on-a-remote-or-headless-server">How do I run Polyscope on a remote or headless server?</a></li>
+<li><a href="#how-do-i-run-polyscope-remotely-in-a-browser-via-a-notebook-or-on-headless-server">How do I run Polyscope remotely / on a headless server / in a notebook?</a></li>
 </ul>
 </li>
 </ul>
@@ -1784,39 +1827,39 @@ <h1>FAQ, Tips, and Tricks</h1>
 <!-- - give focus on show -->
 <!-- - implicits -->
 
-<h3 id="saving-and-restoring-camera-poses"><strong>Saving and restoring camera poses</strong></h3>
+<h3 id="saving-and-restoring-camera-poses"><strong>Saving and restoring camera poses</strong><a class="headerlink" href="#saving-and-restoring-camera-poses" title="Permanent link">&para;</a></h3>
 <p>Use <code>lookAt()</code> and <a href="/basics/camera_controls/">other functions</a> to manually specify the viewing camera pose. </p>
 <p>Or, you can interactively position the camera in the scene, <a href="/basics/camera_controls/#savingrestoring-views">copy it to your clipboard as a json string</a> with <code>ctrl-c</code>, then restore it from the clipboard with <code>ctrl-v</code>. These strings can also be saved and restored programmatically.</p>
-<h3 id="how-do-i-take-a-screenshot-save-an-image"><strong>How do I take a screenshot / save an image?</strong></h3>
+<h3 id="centering-the-view-on-an-area-of-interest"><strong>Centering the view on an area of interest</strong><a class="headerlink" href="#centering-the-view-on-an-area-of-interest" title="Permanent link">&para;</a></h3>
+<p>See <a href="/basics/camera_controls/#centering-the-view-on-scene-content">camera controls</a>. You can use ctrl+shift+click (cmd+shift+click on macOS) to orbit the view about a point of interest, as well as zooming in relative to that point.</p>
+<h3 id="how-do-i-take-a-screenshot-save-an-image"><strong>How do I take a screenshot / save an image?</strong><a class="headerlink" href="#how-do-i-take-a-screenshot-save-an-image" title="Permanent link">&para;</a></h3>
 <p>See <a href="/features/screenshots/">Screenshots</a>. Call <code>polyscope::screenshot()</code>, or click the <code>[screenshot]</code> button in the upper-left corner of the UI.</p>
-<h3 id="positioning-objects-in-the-scene-and-reading-back-results"><strong>Positioning objects in the scene and reading back results</strong></h3>
+<h3 id="positioning-objects-in-the-scene-and-reading-back-results"><strong>Positioning objects in the scene and reading back results</strong><a class="headerlink" href="#positioning-objects-in-the-scene-and-reading-back-results" title="Permanent link">&para;</a></h3>
 <p>See <a href="/structures/structure_management/#transforms">Transforms</a> for various options and to set and get per-structure transformations.
 In the GUI, you can use the <code>[Options] --&gt; [Transform]</code> menu to enable a widget to interactively transform each object within the scene.</p>
-<h3 id="managing-large-numbers-of-structures-and-quantities"><strong>Managing large numbers of structures and quantities</strong></h3>
+<h3 id="managing-large-numbers-of-structures-and-quantities"><strong>Managing large numbers of structures and quantities</strong><a class="headerlink" href="#managing-large-numbers-of-structures-and-quantities" title="Permanent link">&para;</a></h3>
 <p>Polyscope generally scales just fine with 100s or even 1000s of distinctly named structures in the scene. However, with this many structures, it may become difficult to select what you want in the UI. Polyscope has a few features which can help:</p>
 <p>Every structure has controls in its options UI menu under <code>Options --&gt; Structure Selection</code> and <code>Options --&gt; Quantity Selection</code> which can be used to enable/disable all structures and quantities, or isolate to viewing a single structure.</p>
 <p>Use <a href="/features/groups/">Groups</a> to group your structures in to categories which can be enabled/disabled all together. Notice the <code>hide descendants</code> and <code>show details</code> options on groups, which can totally hide structures from the UI while still offering some control via the group.</p>
 <p>You can always use the <a href="/features/callbacks_and_UIs/">Custom UIs</a> to create your own interface buttons and selectors which programmatically enable or disable registered objects or adjust their settings.</p>
-<h3 id="how-do-i-show-animated-data"><strong>How do I show animated data</strong></h3>
+<h3 id="how-do-i-show-animated-data"><strong>How do I show animated data</strong><a class="headerlink" href="#how-do-i-show-animated-data" title="Permanent link">&para;</a></h3>
 <p>There is no explicit built-in functionality for animated or time-series data, but it is easy and common to <a href="/basics/interactive_UIs_and_animation/">do it yourself with a per-frame callback function</a>.</p>
-<h3 id="how-do-i-create-custom-uis-with-buttons-sliders-text-boxes-etc"><strong>How do I create custom UIs with buttons, sliders, text boxes, etc</strong></h3>
+<h3 id="how-do-i-create-custom-uis-with-buttons-sliders-text-boxes-etc"><strong>How do I create custom UIs with buttons, sliders, text boxes, etc</strong><a class="headerlink" href="#how-do-i-create-custom-uis-with-buttons-sliders-text-boxes-etc" title="Permanent link">&para;</a></h3>
 <p>Polyscope integrates with the excellent <a href="https://github.com/ocornut/imgui">Dear ImGui</a> library for UI elements. See the <a href="/basics/interactive_UIs_and_animation/">interactions page</a> for how to use ImGui functions within polyscope, and see the ImGui docs for everything ImGui can do.</p>
-<h3 id="how-do-i-set-up-mouse-click-interactions-and-callbacks"><strong>How do I set up mouse click interactions and callbacks</strong></h3>
-<p>See <a href="/basics/interactive_UIs_and_animation/#mouse-interactions">Mouse Interactions</a>. There are no special callbacks for creating mouse events. Instead, you can implement almost any behavior you want via ImGui&rsquo;s built-in functions. There are also a few polyscope-specific functions to get information about scene at the location you clicked, such as constructing rays and querying depth.</p>
-<h3 id="rendering-figures-for-papers-and-presentations"><strong>Rendering figures for papers and presentations</strong></h3>
+<h3 id="how-do-i-set-up-mouse-click-interactions-and-callbacks"><strong>How do I set up mouse click interactions and callbacks</strong><a class="headerlink" href="#how-do-i-set-up-mouse-click-interactions-and-callbacks" title="Permanent link">&para;</a></h3>
+<p>See <a href="/basics/interactive_UIs_and_animation/#mouse-interactions">Mouse Interactions</a>. Polyscope follows an immediate-mode philosophy for interactions: rather than registering many callbacks for various IO events, you can test for mouse and keyboard state in your main loop, or in the per-frame callback (which is the only callback), to implement any behavior your would like. ImGui offers many functions for testing mouse/keyboard state, and there are also a few polyscope-specific functions to get information about scene at the location you clicked, such as constructing rays and querying depth.</p>
+<h3 id="rendering-figures-for-papers-and-presentations"><strong>Rendering figures for papers and presentations</strong><a class="headerlink" href="#rendering-figures-for-papers-and-presentations" title="Permanent link">&para;</a></h3>
 <p>Several settings can be customized to give a more polished appearance. Consider:</p>
 <ul>
 <li>Adjusting the <a href="/features/ground_and_shadows/">ground plane</a> to shadow-only for ground shadows </li>
 <li>Increasing <a href="/basics/program_options/#ssaa-anti-aliasing-factor">antialiasing</a> rate</li>
 <li>Saving <a href="/features/screenshots/">screenshots</a> with transparency for compositing</li>
 </ul>
-<h3 id="visualizing-colors-as-exact-rgb-values-without-any-shading-or-tonemapping"><strong>Visualizing colors as exact RGB values, without any shading or tonemapping</strong></h3>
+<h3 id="visualizing-colors-as-exact-rgb-values-without-any-shading-or-tonemapping"><strong>Visualizing colors as exact RGB values, without any shading or tonemapping</strong><a class="headerlink" href="#visualizing-colors-as-exact-rgb-values-without-any-shading-or-tonemapping" title="Permanent link">&para;</a></h3>
 <p>Normally, colors are shaded and tone-mapped for rendering, which means the colors and colormapped-values you specify are not exactly the colors Polyscope renders to the screen. Use the <a href="/features/materials/#preserving-colors-with-the-flat-material">flat material</a> to circumvent these effects, and ensure that colors are flat-shaded to the screen with exactly the RGB values specified.</p>
-<h3 id="how-do-i-run-polyscope-on-a-remote-or-headless-server"><strong>How do I run Polyscope on a remote or headless server?</strong></h3>
-<p>It may not not be possible to use Polyscope on a remote headless machine which does not have a physical monitor. </p>
-<p>If the machine <em>does</em> have a display attached, there should be no problem. You can run and initialize Polyscope, and even if you are working remotely via script or SSH you can programmatically capture screenshots of the rendered scene. </p>
-<p>However, Polyscope will only work if it can create an operating system-level display window, which generally means having a physical monitor attached. Various virtual windowing systems and X-servers exist as a hypothetical workaround, however users have reported limited success with these tools, usually because they use software openGL renderers which do not support the openGL features required by Polyscope.</p>
-<p>In implementation terms, this limitation comes from needing to initialize an OpenGL 3.3 core-profile context using <a href="https://www.glfw.org/">GLFW</a>. Currently, GLFW can only create an openGL context when a display is present. If you find a good workaround for Polyscope on headless machines, please share! One day, we hope to implement an alternate EGL backend, which would support headless machines.</p>
+<h3 id="how-do-i-run-polyscope-remotely-in-a-browser-via-a-notebook-or-on-headless-server"><strong>How do I run Polyscope remotely in a browser, via a notebook, or on headless server?</strong><a class="headerlink" href="#how-do-i-run-polyscope-remotely-in-a-browser-via-a-notebook-or-on-headless-server" title="Permanent link">&para;</a></h3>
+<p>See <a href="/features/headless_rendering/">headless rendering</a>. </p>
+<p>In short, Polyscope <em>does</em> support headless rendering: it can be used on remote serves with no display attached to render images and videos to files or buffers, by initializing with a special EGL backend. However, Polyscope <em>does not</em> currently support any kind of client-server mode, or execution in the browser from remote machines, etc. It must be executing locally on the machine which you are using it from.  </p>