a few more docs

Author: nmwsharp

cpp/source/basics/interactive_UIs_and_animation.md

@@ -189,6 +189,11 @@ We will not reproduce the ImGui documentation here, visit the ImGui github page
 
 ![callback ui demo]([[url.prefix]]/media/imgui_py_demo.png)
 
+
+### 2D Plots with ImPlot
+
+Polyscope also provides [ImPlot](https://github.com/epezent/implot) for creating little inline 2D plots like line plots, scatter plots, and histograms in the UI panes. As with ImGui, please see ImPlot's pages for documentation.
+
 ## Mouse Interactions
 
 You can implement custom mouse behaviors on clicks and other actions within your per-frame callback function. `ImGui` exposes the state of the mouse and whether a click occurred via `ImGui::GetIO()`.

cpp/source/features/screenshots.md

@@ -45,6 +45,11 @@ struct ScreenshotOptions {
 - If `transparentBG` is `true`, the background will be rendered as transparent, and set as transparency alpha in the saved image if the file format supports it.
 - If `includeUI` is `true`, the screenshot will be captured with the ImGui UI elements (panels, buttons, etc) visible.
 
+!!! warning "includeUI may not match"
+
+    The screenshot `includeUI` setting is imperfect, the UI will be visible, but may be in a different state compared to what you see in your own window. This is a known bug, and we hope to fix it in future version.
+
+
 ???+ func "`#!cpp void screenshot(const ScreenshotOptions& options)`"
 
     ##### numbered screenshot

py/source/basics/interactive_UIs_and_animation.md

@@ -188,13 +188,23 @@ The Polyscope python package includes bindings to a significant subset of ImGui
 
 These bindings are not yet exhaustively documented, but they follow the naming conventions of ImGui as closely as possible for simplicity. Documentation of ImGui functions and parameters lives [here](https://github.com/ocornut/imgui/blob/master/imgui.h), and  you can find the list of bound functions, types, and enums [here](https://github.com/nmwsharp/polyscope-py/blob/master/src/cpp/imgui.cpp). Common usage should be covered by the example below.
 
+### 2D Plots with ImPlot
+
+Polyscope also provides [ImPlot](https://github.com/epezent/implot) for creating little inline 2D plots like line plots, scatter plots, and histograms in the UI panes. As with ImGui, please see ImPlot's pages for documentation. 
+
+Bindings are defined in the `polyscope.implot` submodule, and again attempt to follow the original ImPlot naming exactly. Many but not all functions are bound, please file an issue for any missed functionality.
+
+### Sample Custom UI
+
 **Example:** Create the following UI in a Python callback
 
 ![callback ui demo]([[url.prefix]]/media/imgui_py_demo.png)
 
 ```python
 import polyscope as ps
 import polyscope.imgui as psim
+import polyscope.implot as psimplot
+import numpy as np
 
 # A bunch of parameters which we will manipulate via the UI defined below.
 # There is nothing special about these variables, you could manipulate any other 
@@ -336,6 +346,13 @@ def callback():
     psim.PopItemWidth()
 
 
+    # Add a plot            
+    if psimplot.BeginPlot("test line plot"):
+        psimplot.PlotLine("line plot", np.random.rand(10))
+        psimplot.PlotInfLines("horizontal lines", np.random.rand(3), psimplot.ImPlotInfLinesFlags_Horizontal)
+        psimplot.EndPlot()
+
+
 ps.init() 
 ps.set_user_callback(callback)
 ps.show()

py/source/features/screenshots.md

@@ -30,6 +30,10 @@ ps.screenshot()
 img = ps.screenshot_to_buffer()
 ```
 
+!!! warning "include_UI may not match"
+
+    The screenshot `include_UI=True` setting is imperfect, the UI will be visible, but may be in a different state compared to what you see in your own window. This is a known bug, and we hope to fix it in future version.
+
 ???+ func "`#!python screenshot(filename=None, transparent_bg=True, include_UI=False)`"
 
     Saves a screenshot to the path given as `filename`, with format inferred from the file extension.