fake-bpy-module 20240516__py3-none-any.whl → 20240518__py3-none-any.whl

bl_ui/properties_paint_common/__init__.pyi

@@ -1,16 +1,12 @@
 import typing
+import bpy.types
 import bpy_types
 
 GenericType = typing.TypeVar("GenericType")
 
 class BrushAssetShelf:
-    """ """
-
     bl_default_preview_size: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def asset_poll(self, asset):
         """
@@ -27,12 +23,11 @@ class BrushAssetShelf:
         ...
 
 class UnifiedPaintPanel:
-    """ """
-
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -49,29 +44,30 @@ class UnifiedPaintPanel:
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -83,7 +79,7 @@ class UnifiedPaintPanel:
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -96,34 +92,40 @@ class UnifiedPaintPanel:
         ...
 
 class VIEW3D_MT_tools_projectpaint_clone(bpy_types.Menu, bpy_types._GenericUI):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_rna: typing.Any
-    """ """
-
     id_data: typing.Any
-    """ """
 
     def append(self, draw_func):
-        """
+        """Append a draw function to this menu,
+        takes the same arguments as the menus draw function
 
-        :param draw_func:
+                :param draw_func:
         """
         ...
 
-    def as_pointer(self):
-        """ """
+    def as_pointer(self) -> int:
+        """Returns the memory address which holds a pointer to Blender's internal data
+
+        :return: int (memory address).
+        :rtype: int
+        """
         ...
 
-    def bl_rna_get_subclass(self):
-        """ """
+    def bl_rna_get_subclass(self) -> bpy.types.Struct:
+        """
+
+        :return: The RNA type or default when not found.
+        :rtype: bpy.types.Struct
+        """
         ...
 
-    def bl_rna_get_subclass_py(self):
-        """ """
+    def bl_rna_get_subclass_py(self) -> typing.Any:
+        """
+
+        :return: The class or default when not found.
+        :rtype: typing.Any
+        """
         ...
 
     def draw(self, context):
@@ -142,147 +144,229 @@ class VIEW3D_MT_tools_projectpaint_clone(bpy_types.Menu, bpy_types._GenericUI):
         ...
 
     def draw_preset(self, _context):
-        """
+        """Define these on the subclass:
+        - preset_operator (string)
+        - preset_subdir (string)Optionally:
+        - preset_add_operator (string)
+        - preset_extensions (set of strings)
+        - preset_operator_defaults (dict of keyword args)
 
-        :param _context:
+                :param _context:
         """
         ...
 
-    def driver_add(self):
-        """ """
+    def driver_add(self) -> bpy.types.FCurve:
+        """Adds driver(s) to the given property
+
+        :return: The driver(s) added.
+        :rtype: bpy.types.FCurve
+        """
         ...
 
-    def driver_remove(self):
-        """ """
+    def driver_remove(self) -> bool:
+        """Remove driver(s) from the given property
+
+        :return: Success of driver removal.
+        :rtype: bool
+        """
         ...
 
     def get(self):
-        """ """
+        """Returns the value of the custom property assigned to key or default
+        when not found (matches Python's dictionary function of the same name).
+
+        """
         ...
 
     def id_properties_clear(self):
-        """ """
+        """
+
+        :return: Remove the parent group for an RNA struct's custom IDProperties.
+        """
         ...
 
     def id_properties_ensure(self):
-        """ """
+        """
+
+        :return: the parent group for an RNA struct's custom IDProperties.
+        """
         ...
 
     def id_properties_ui(self):
-        """ """
-        ...
+        """
 
-    def is_extended(self):
-        """ """
+        :return: Return an object used to manage an IDProperty's UI data.
+        """
         ...
 
-    def is_property_hidden(self):
-        """ """
+    def is_extended(self): ...
+    def is_property_hidden(self) -> bool:
+        """Check if a property is hidden.
+
+        :return: True when the property is hidden.
+        :rtype: bool
+        """
         ...
 
-    def is_property_overridable_library(self):
-        """ """
+    def is_property_overridable_library(self) -> bool:
+        """Check if a property is overridable.
+
+        :return: True when the property is overridable.
+        :rtype: bool
+        """
         ...
 
-    def is_property_readonly(self):
-        """ """
+    def is_property_readonly(self) -> bool:
+        """Check if a property is readonly.
+
+        :return: True when the property is readonly (not writable).
+        :rtype: bool
+        """
         ...
 
-    def is_property_set(self):
-        """ """
+    def is_property_set(self) -> bool:
+        """Check if a property is set, use for testing operator properties.
+
+        :return: True when the property has been set.
+        :rtype: bool
+        """
         ...
 
     def items(self):
-        """ """
+        """Returns the items of this objects custom properties (matches Python's
+        dictionary function of the same name).
+
+                :return: custom property key, value pairs.
+        """
         ...
 
-    def keyframe_delete(self):
-        """ """
+    def keyframe_delete(self) -> bool:
+        """Remove a keyframe from this properties fcurve.
+
+        :return: Success of keyframe deletion.
+        :rtype: bool
+        """
         ...
 
-    def keyframe_insert(self):
-        """ """
+    def keyframe_insert(self) -> bool:
+        """Insert a keyframe on the property given, adding fcurves and animation data when necessary.
+
+        :return: Success of keyframe insertion.
+        :rtype: bool
+        """
         ...
 
     def keys(self):
-        """ """
+        """Returns the keys of this objects custom properties (matches Python's
+        dictionary function of the same name).
+
+                :return: custom property keys.
+        """
         ...
 
-    def path_from_id(self):
-        """ """
+    def path_from_id(self) -> str:
+        """Returns the data path from the ID to this object (string).
+
+                :return: The path from `bpy.types.bpy_struct.id_data`
+        to this struct and property (when given).
+                :rtype: str
+        """
         ...
 
     def path_menu(
         self,
-        searchpaths,
-        operator,
-        props_default,
-        prop_filepath,
-        filter_ext,
-        filter_path,
-        display_name,
-        add_operator,
-        add_operator_props,
+        searchpaths: list[str],
+        operator: str,
+        props_default: dict = None,
+        prop_filepath: str = "filepath",
+        filter_ext: typing.Callable = None,
+        filter_path=None,
+        display_name: typing.Callable = None,
+        add_operator=None,
+        add_operator_props=None,
     ):
-        """
+        """Populate a menu from a list of paths.
 
-        :param searchpaths:
-        :param operator:
-        :param props_default:
-        :param prop_filepath:
-        :param filter_ext:
-        :param filter_path:
-        :param display_name:
-        :param add_operator:
-        :param add_operator_props:
+                :param searchpaths: Paths to scan.
+                :type searchpaths: list[str]
+                :param operator: The operator id to use with each file.
+                :type operator: str
+                :param props_default: Properties to assign to each operator.
+                :type props_default: dict
+                :param prop_filepath: Optional operator filepath property (defaults to "filepath").
+                :type prop_filepath: str
+                :param filter_ext: Optional callback that takes the file extensions.
+
+        Returning false excludes the file from the list.
+                :type filter_ext: typing.Callable
+                :param filter_path:
+                :param display_name: Optional callback that takes the full path, returns the name to display.
+                :type display_name: typing.Callable
+                :param add_operator:
+                :param add_operator_props:
         """
         ...
 
     def path_resolve(self):
-        """ """
+        """Returns the property from the path, raise an exception when not found."""
         ...
 
     def pop(self):
-        """ """
+        """Remove and return the value of the custom property assigned to key or default
+        when not found (matches Python's dictionary function of the same name).
+
+        """
         ...
 
     def prepend(self, draw_func):
-        """
+        """Prepend a draw function to this menu, takes the same arguments as
+        the menus draw function
 
-        :param draw_func:
+                :param draw_func:
         """
         ...
 
-    def property_overridable_library_set(self):
-        """ """
+    def property_overridable_library_set(self) -> bool:
+        """Define a property as overridable or not (only for custom properties!).
+
+        :return: True when the overridable status of the property was successfully set.
+        :rtype: bool
+        """
         ...
 
     def property_unset(self):
-        """ """
+        """Unset a property, will use default value afterward."""
         ...
 
     def remove(self, draw_func):
-        """
+        """Remove a draw function that has been added to this menu
 
         :param draw_func:
         """
         ...
 
     def type_recast(self):
-        """ """
+        """Return a new instance, this is needed because types
+        such as textures can be changed at runtime.
+
+                :return: a new instance of this object with the type initialized again.
+        """
         ...
 
     def values(self):
-        """ """
+        """Returns the values of this objects custom properties (matches Python's
+        dictionary function of the same name).
+
+                :return: custom property values.
+        """
         ...
 
 class BrushPanel(UnifiedPaintPanel):
-    """ """
-
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -306,29 +390,30 @@ class BrushPanel(UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -340,7 +425,7 @@ class BrushPanel(UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -353,10 +438,7 @@ class BrushPanel(UnifiedPaintPanel):
         ...
 
 class BrushSelectPanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -366,9 +448,10 @@ class BrushSelectPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -392,29 +475,30 @@ class BrushSelectPanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -426,7 +510,7 @@ class BrushSelectPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -439,13 +523,8 @@ class BrushSelectPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class ClonePanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -462,9 +541,10 @@ class ClonePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -488,29 +568,30 @@ class ClonePanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -522,7 +603,7 @@ class ClonePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -535,13 +616,8 @@ class ClonePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class ColorPalettePanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -551,9 +627,10 @@ class ColorPalettePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -577,29 +654,30 @@ class ColorPalettePanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -611,7 +689,7 @@ class ColorPalettePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -624,13 +702,8 @@ class ColorPalettePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class DisplayPanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -647,9 +720,10 @@ class DisplayPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -673,29 +747,30 @@ class DisplayPanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -707,7 +782,7 @@ class DisplayPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -720,13 +795,8 @@ class DisplayPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class FalloffPanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -736,9 +806,10 @@ class FalloffPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -762,29 +833,30 @@ class FalloffPanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -796,7 +868,7 @@ class FalloffPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -809,13 +881,8 @@ class FalloffPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class SmoothStrokePanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -832,9 +899,10 @@ class SmoothStrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -858,29 +926,30 @@ class SmoothStrokePanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -892,7 +961,7 @@ class SmoothStrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -905,16 +974,9 @@ class SmoothStrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class StrokePanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
-
     bl_ui_units_x: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -924,9 +986,10 @@ class StrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -950,29 +1013,30 @@ class StrokePanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -984,7 +1048,7 @@ class StrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -997,13 +1061,8 @@ class StrokePanel(BrushPanel, UnifiedPaintPanel):
         ...
 
 class TextureMaskPanel(BrushPanel, UnifiedPaintPanel):
-    """ """
-
     bl_label: typing.Any
-    """ """
-
     bl_options: typing.Any
-    """ """
 
     def draw(self, context):
         """
@@ -1013,9 +1072,10 @@ class TextureMaskPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def get_brush_mode(self, context):
-        """
+        """Get the correct mode for this context. For any context where this returns None,
+        no brush options should be displayed.
 
-        :param context:
+                :param context:
         """
         ...
 
@@ -1039,29 +1099,30 @@ class TextureMaskPanel(BrushPanel, UnifiedPaintPanel):
         context,
         brush,
         prop_name,
-        unified_name,
-        pressure_name,
-        icon,
-        text,
-        slider,
-        header,
+        unified_name=None,
+        pressure_name=None,
+        icon="NONE",
+        text=None,
+        slider=False,
+        header=False,
     ):
-        """
+        """Generalized way of adding brush options to the UI,
+        along with their pen pressure setting and global toggle, if they exist.
 
-        :param layout:
-        :param context:
-        :param brush:
-        :param prop_name:
-        :param unified_name:
-        :param pressure_name:
-        :param icon:
-        :param text:
-        :param slider:
-        :param header:
+                :param layout:
+                :param context:
+                :param brush:
+                :param prop_name:
+                :param unified_name:
+                :param pressure_name:
+                :param icon:
+                :param text:
+                :param slider:
+                :param header:
         """
         ...
 
-    def prop_unified_color(self, parent, context, brush, prop_name, text):
+    def prop_unified_color(self, parent, context, brush, prop_name, text=None):
         """
 
         :param parent:
@@ -1073,7 +1134,7 @@ class TextureMaskPanel(BrushPanel, UnifiedPaintPanel):
         ...
 
     def prop_unified_color_picker(
-        self, parent, context, brush, prop_name, value_slider
+        self, parent, context, brush, prop_name, value_slider=True
     ):
         """
 
@@ -1085,72 +1146,41 @@ class TextureMaskPanel(BrushPanel, UnifiedPaintPanel):
         """
         ...
 
-def brush_basic__draw_color_selector(context, layout, brush, gp_settings, props):
-    """ """
-
-    ...
-
-def brush_basic_gpencil_paint_settings(layout, context, brush, compact):
-    """ """
+def brush_basic__draw_color_selector(context, layout, brush, gp_settings, props): ...
+def brush_basic_gpencil_paint_settings(layout, context, brush, compact=False): ...
+def brush_basic_gpencil_sculpt_settings(layout, _context, brush, compact=False): ...
+def brush_basic_gpencil_vertex_settings(layout, _context, brush, compact=False): ...
+def brush_basic_gpencil_weight_settings(layout, _context, brush, compact=False): ...
+def brush_basic_grease_pencil_paint_settings(layout, context, brush, compact=False): ...
+def brush_basic_grease_pencil_weight_settings(
+    layout, context, brush, compact=False
+): ...
+def brush_basic_texpaint_settings(layout, context, brush, compact=False):
+    """Draw Tool Settings header for Vertex Paint and 2D and 3D Texture Paint modes."""
 
     ...
 
-def brush_basic_gpencil_sculpt_settings(layout, _context, brush, compact):
-    """ """
-
-    ...
-
-def brush_basic_gpencil_vertex_settings(layout, _context, brush, compact):
-    """ """
-
-    ...
-
-def brush_basic_gpencil_weight_settings(layout, _context, brush, compact):
-    """ """
-
-    ...
-
-def brush_basic_grease_pencil_paint_settings(layout, context, brush, compact):
-    """ """
-
-    ...
-
-def brush_basic_grease_pencil_weight_settings(layout, context, brush, compact):
-    """ """
-
-    ...
-
-def brush_basic_texpaint_settings(layout, context, brush, compact):
-    """ """
-
-    ...
-
-def brush_mask_texture_settings(layout, brush):
-    """ """
-
-    ...
-
-def brush_settings(layout, context, brush, popover):
-    """ """
-
-    ...
+def brush_mask_texture_settings(layout, brush): ...
+def brush_settings(layout, context, brush, popover=False):
+    """Draw simple brush settings for Sculpt,
+    Texture/Vertex/Weight Paint modes, or skip certain settings for the popover
 
-def brush_settings_advanced(layout, context, brush, popover):
-    """ """
+    """
 
     ...
 
-def brush_shared_settings(layout, context, brush, popover):
-    """ """
+def brush_settings_advanced(layout, context, brush, popover=False):
+    """Draw advanced brush settings for Sculpt, Texture/Vertex/Weight Paint modes."""
 
     ...
 
-def brush_texture_settings(layout, brush, sculpt):
-    """ """
+def brush_shared_settings(layout, context, brush, popover=False):
+    """Draw simple brush settings that are shared between different paint modes."""
 
     ...
 
-def draw_color_settings(context, layout, brush, color_type):
-    """ """
+def brush_texture_settings(layout, brush, sculpt): ...
+def draw_color_settings(context, layout, brush, color_type=False):
+    """Draw color wheel and gradient settings."""
 
     ...