revert commit, run black on just the text graphic, regenerate the docs

Caitlin Lewis · Caitlin Lewis · commit 583370beb408 · 2023-10-27T11:39:52.000-04:00
diff --git a/docs/source/api/graphic_features/CmapFeature.rst b/docs/source/api/graphic_features/CmapFeature.rst
@@ -21,6 +21,7 @@ Properties
     :toctree: CmapFeature_api
 
     CmapFeature.buffer
+    CmapFeature.name
     CmapFeature.values
 
 Methods
diff --git a/docs/source/api/graphic_features/HeatmapCmapFeature.rst b/docs/source/api/graphic_features/HeatmapCmapFeature.rst
@@ -20,6 +20,7 @@ Properties
 .. autosummary::
     :toctree: HeatmapCmapFeature_api
 
+    HeatmapCmapFeature.name
     HeatmapCmapFeature.vmax
     HeatmapCmapFeature.vmin
 
@@ -32,4 +33,5 @@ Methods
     HeatmapCmapFeature.block_events
     HeatmapCmapFeature.clear_event_handlers
     HeatmapCmapFeature.remove_event_handler
+    HeatmapCmapFeature.reset_vmin_vmax
 
diff --git a/docs/source/api/graphic_features/ImageCmapFeature.rst b/docs/source/api/graphic_features/ImageCmapFeature.rst
@@ -20,6 +20,7 @@ Properties
 .. autosummary::
     :toctree: ImageCmapFeature_api
 
+    ImageCmapFeature.name
     ImageCmapFeature.vmax
     ImageCmapFeature.vmin
 
@@ -32,4 +33,5 @@ Methods
     ImageCmapFeature.block_events
     ImageCmapFeature.clear_event_handlers
     ImageCmapFeature.remove_event_handler
+    ImageCmapFeature.reset_vmin_vmax
 
diff --git a/docs/source/api/graphic_features/PointsSizesFeature.rst b/docs/source/api/graphic_features/PointsSizesFeature.rst
@@ -0,0 +1,34 @@
+.. _api.PointsSizesFeature:
+
+PointsSizesFeature
+******************
+
+==================
+PointsSizesFeature
+==================
+.. currentmodule:: fastplotlib.graphics._features
+
+Constructor
+~~~~~~~~~~~
+.. autosummary::
+    :toctree: PointsSizesFeature_api
+
+    PointsSizesFeature
+
+Properties
+~~~~~~~~~~
+.. autosummary::
+    :toctree: PointsSizesFeature_api
+
+    PointsSizesFeature.buffer
+
+Methods
+~~~~~~~
+.. autosummary::
+    :toctree: PointsSizesFeature_api
+
+    PointsSizesFeature.add_event_handler
+    PointsSizesFeature.block_events
+    PointsSizesFeature.clear_event_handlers
+    PointsSizesFeature.remove_event_handler
+
diff --git a/docs/source/api/graphic_features/index.rst b/docs/source/api/graphic_features/index.rst
@@ -9,6 +9,7 @@ Graphic Features
     ImageCmapFeature
     HeatmapCmapFeature
     PointsDataFeature
+    PointsSizesFeature
     ImageDataFeature
     HeatmapDataFeature
     PresentFeature
diff --git a/docs/source/api/graphics/HeatmapGraphic.rst b/docs/source/api/graphics/HeatmapGraphic.rst
@@ -38,4 +38,6 @@ Methods
     HeatmapGraphic.add_linear_region_selector
     HeatmapGraphic.add_linear_selector
     HeatmapGraphic.link
+    HeatmapGraphic.reset_feature
+    HeatmapGraphic.set_feature
 
diff --git a/docs/source/api/graphics/ImageGraphic.rst b/docs/source/api/graphics/ImageGraphic.rst
@@ -36,4 +36,6 @@ Methods
     ImageGraphic.add_linear_region_selector
     ImageGraphic.add_linear_selector
     ImageGraphic.link
+    ImageGraphic.reset_feature
+    ImageGraphic.set_feature
 
diff --git a/docs/source/api/graphics/LineCollection.rst b/docs/source/api/graphics/LineCollection.rst
@@ -41,4 +41,6 @@ Methods
     LineCollection.add_linear_selector
     LineCollection.link
     LineCollection.remove_graphic
+    LineCollection.reset_feature
+    LineCollection.set_feature
 
diff --git a/docs/source/api/graphics/LineGraphic.rst b/docs/source/api/graphics/LineGraphic.rst
@@ -36,4 +36,6 @@ Methods
     LineGraphic.add_linear_region_selector
     LineGraphic.add_linear_selector
     LineGraphic.link
+    LineGraphic.reset_feature
+    LineGraphic.set_feature
 
diff --git a/docs/source/api/graphics/LineStack.rst b/docs/source/api/graphics/LineStack.rst
@@ -41,4 +41,6 @@ Methods
     LineStack.add_linear_selector
     LineStack.link
     LineStack.remove_graphic
+    LineStack.reset_feature
+    LineStack.set_feature
 
diff --git a/docs/source/api/graphics/TextGraphic.rst b/docs/source/api/graphics/TextGraphic.rst
@@ -21,10 +21,16 @@ Properties
     :toctree: TextGraphic_api
 
     TextGraphic.children
+    TextGraphic.face_color
+    TextGraphic.outline_color
+    TextGraphic.outline_size
     TextGraphic.position
     TextGraphic.position_x
     TextGraphic.position_y
     TextGraphic.position_z
+    TextGraphic.text
+    TextGraphic.text_position
+    TextGraphic.text_size
     TextGraphic.visible
     TextGraphic.world_object
 
@@ -33,10 +39,4 @@ Methods
 .. autosummary::
     :toctree: TextGraphic_api
 
-    TextGraphic.update_face_color
-    TextGraphic.update_outline_color
-    TextGraphic.update_outline_size
-    TextGraphic.update_position
-    TextGraphic.update_size
-    TextGraphic.update_text
 
diff --git a/docs/source/api/selectors/LinearRegionSelector.rst b/docs/source/api/selectors/LinearRegionSelector.rst
@@ -21,6 +21,7 @@ Properties
     :toctree: LinearRegionSelector_api
 
     LinearRegionSelector.children
+    LinearRegionSelector.limits
     LinearRegionSelector.position
     LinearRegionSelector.position_x
     LinearRegionSelector.position_y
@@ -33,7 +34,9 @@ Methods
 .. autosummary::
     :toctree: LinearRegionSelector_api
 
+    LinearRegionSelector.add_ipywidget_handler
     LinearRegionSelector.get_selected_data
     LinearRegionSelector.get_selected_index
     LinearRegionSelector.get_selected_indices
+    LinearRegionSelector.make_ipywidget_slider
 
diff --git a/docs/source/api/selectors/LinearSelector.rst b/docs/source/api/selectors/LinearSelector.rst
@@ -21,6 +21,7 @@ Properties
     :toctree: LinearSelector_api
 
     LinearSelector.children
+    LinearSelector.limits
     LinearSelector.position
     LinearSelector.position_x
     LinearSelector.position_y
@@ -33,6 +34,7 @@ Methods
 .. autosummary::
     :toctree: LinearSelector_api
 
+    LinearSelector.add_ipywidget_handler
     LinearSelector.get_selected_data
     LinearSelector.get_selected_index
     LinearSelector.get_selected_indices
diff --git a/docs/source/api/selectors/PolygonSelector.rst b/docs/source/api/selectors/PolygonSelector.rst
@@ -0,0 +1,40 @@
+.. _api.PolygonSelector:
+
+PolygonSelector
+***************
+
+===============
+PolygonSelector
+===============
+.. currentmodule:: fastplotlib
+
+Constructor
+~~~~~~~~~~~
+.. autosummary::
+    :toctree: PolygonSelector_api
+
+    PolygonSelector
+
+Properties
+~~~~~~~~~~
+.. autosummary::
+    :toctree: PolygonSelector_api
+
+    PolygonSelector.children
+    PolygonSelector.position
+    PolygonSelector.position_x
+    PolygonSelector.position_y
+    PolygonSelector.position_z
+    PolygonSelector.visible
+    PolygonSelector.world_object
+
+Methods
+~~~~~~~
+.. autosummary::
+    :toctree: PolygonSelector_api
+
+    PolygonSelector.get_selected_data
+    PolygonSelector.get_selected_index
+    PolygonSelector.get_selected_indices
+    PolygonSelector.get_vertices
+
diff --git a/docs/source/api/selectors/index.rst b/docs/source/api/selectors/index.rst
@@ -6,4 +6,5 @@ Selectors
 
     LinearSelector
     LinearRegionSelector
+    PolygonSelector
     Synchronizer
diff --git a/docs/source/api/widgets/ImageWidget.rst b/docs/source/api/widgets/ImageWidget.rst
@@ -20,6 +20,7 @@ Properties
 .. autosummary::
     :toctree: ImageWidget_api
 
+    ImageWidget.cmap
     ImageWidget.current_index
     ImageWidget.data
     ImageWidget.dims_order
@@ -35,6 +36,7 @@ Methods
 .. autosummary::
     :toctree: ImageWidget_api
 
+    ImageWidget.close
     ImageWidget.reset_vmin_vmax
     ImageWidget.set_data
     ImageWidget.show
diff --git a/fastplotlib/graphics/text.py b/fastplotlib/graphics/text.py
@@ -14,6 +14,8 @@ def __init__(
         face_color: Union[str, np.ndarray] = "w",
         outline_color: Union[str, np.ndarray] = "w",
         outline_thickness=0,
+        screen_space: bool = True,
+        anchor: str = "middle-center",
         *args,
         **kwargs
     ):
@@ -40,20 +42,30 @@ def __init__(
         outline_thickness: int, default 0
             text outline thickness
 
+        screen_space: bool = True
+            whether the text is rendered in screen space, in contrast to world space
+
         name: str, optional
             name of graphic, passed to Graphic
 
+        anchor: str, default "middle-center"
+            position of the origin of the text
+            a string representing the vertical and horizontal anchors, separated by a dash
+
+            * Vertical values: "top", "middle", "baseline", "bottom"
+            * Horizontal values: "left", "center", "right"
         """
         super(TextGraphic, self).__init__(*args, **kwargs)
 
         self._text = text
 
         world_object = pygfx.Text(
-            pygfx.TextGeometry(text=str(text),
-                               font_size=size,
-                               screen_space=True,
-                               anchor="middle-center"
-                               ),
+            pygfx.TextGeometry(
+                text=str(text),
+                font_size=size,
+                screen_space=screen_space,
+                anchor=anchor,
+            ),
             pygfx.TextMaterial(
                 color=face_color,
                 outline_color=outline_color,
@@ -103,6 +115,8 @@ def face_color(self, color: Union[str, np.ndarray]):
         if not (isinstance(color, str) or isinstance(color, np.ndarray)):
             raise ValueError("Face color must be of type str or np.ndarray")
 
+        color = pygfx.Color(color)
+
         self.world_object.material.color = color
 
     @property
