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

bl_ui/__init__.pyi

@@ -1,4 +1,5 @@
 import typing
+import bpy.types
 import bpy_types
 
 from . import anim
@@ -82,37 +83,46 @@ from . import utils
 GenericType = typing.TypeVar("GenericType")
 
 class UI_MT_button_context_menu(bpy_types.Menu, bpy_types._GenericUI):
-    """ """
+    """UI button context menu definition. Scripts can append/prepend this to
+    add own operators to the context menu. They must check context though, so
+    their items only draw in a valid context and for the correct buttons.
+    """
 
     bl_idname: typing.Any
-    """ """
-
     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):
@@ -131,172 +141,264 @@ class UI_MT_button_context_menu(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: 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.
 
-        :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:
+        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 UI_MT_list_item_context_menu(bpy_types.Menu, bpy_types._GenericUI):
-    """ """
+    """UI List item context menu definition. Scripts can append/prepend this to
+    add own operators to the context menu. They must check context though, so
+    their items only draw in a valid context and for the correct UI list.
+    """
 
     bl_idname: typing.Any
-    """ """
-
     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):
@@ -315,148 +417,226 @@ class UI_MT_list_item_context_menu(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: 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.
 
-        :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:
+        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 UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
-    """ """
-
     bl_rna: typing.Any
-    """ """
-
     id_data: typing.Any
-    """ """
 
     def append(self, draw_func):
         """
@@ -465,27 +645,14 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def as_pointer(self):
-        """ """
-        ...
-
-    def bl_rna_get_subclass(self):
-        """ """
-        ...
-
-    def bl_rna_get_subclass_py(self):
-        """ """
-        ...
-
-    def driver_add(self):
-        """ """
-        ...
-
-    def driver_remove(self):
-        """ """
-        ...
-
-    def filter_items_by_name(self, pattern, bitflag, items, propname, flags, reverse):
+    def as_pointer(self): ...
+    def bl_rna_get_subclass(self): ...
+    def bl_rna_get_subclass_py(self): ...
+    def driver_add(self): ...
+    def driver_remove(self): ...
+    def filter_items_by_name(
+        self, pattern, bitflag, items, propname="name", flags=None, reverse=False
+    ):
         """
 
         :param pattern:
@@ -497,70 +664,22 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def get(self):
-        """ """
-        ...
-
-    def id_properties_clear(self):
-        """ """
-        ...
-
-    def id_properties_ensure(self):
-        """ """
-        ...
-
-    def id_properties_ui(self):
-        """ """
-        ...
-
-    def is_extended(self):
-        """ """
-        ...
-
-    def is_property_hidden(self):
-        """ """
-        ...
-
-    def is_property_overridable_library(self):
-        """ """
-        ...
-
-    def is_property_readonly(self):
-        """ """
-        ...
-
-    def is_property_set(self):
-        """ """
-        ...
-
-    def items(self):
-        """ """
-        ...
-
-    def keyframe_delete(self):
-        """ """
-        ...
-
-    def keyframe_insert(self):
-        """ """
-        ...
-
-    def keys(self):
-        """ """
-        ...
-
-    def path_from_id(self):
-        """ """
-        ...
-
-    def path_resolve(self):
-        """ """
-        ...
-
-    def pop(self):
-        """ """
-        ...
-
+    def get(self): ...
+    def id_properties_clear(self): ...
+    def id_properties_ensure(self): ...
+    def id_properties_ui(self): ...
+    def is_extended(self): ...
+    def is_property_hidden(self): ...
+    def is_property_overridable_library(self): ...
+    def is_property_readonly(self): ...
+    def is_property_set(self): ...
+    def items(self): ...
+    def keyframe_delete(self): ...
+    def keyframe_insert(self): ...
+    def keys(self): ...
+    def path_from_id(self): ...
+    def path_resolve(self): ...
+    def pop(self): ...
     def prepend(self, draw_func):
         """
 
@@ -568,14 +687,8 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def property_overridable_library_set(self):
-        """ """
-        ...
-
-    def property_unset(self):
-        """ """
-        ...
-
+    def property_overridable_library_set(self): ...
+    def property_unset(self): ...
     def remove(self, draw_func):
         """
 
@@ -583,7 +696,7 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def sort_items_by_name(self, items, propname):
+    def sort_items_by_name(self, items, propname="name"):
         """
 
         :param items:
@@ -591,7 +704,7 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def sort_items_helper(self, sort_data, key, reverse):
+    def sort_items_helper(self, sort_data, key, reverse=False):
         """
 
         :param sort_data:
@@ -600,25 +713,9 @@ class UI_UL_list(bpy_types.UIList, bpy_types._GenericUI):
         """
         ...
 
-    def type_recast(self):
-        """ """
-        ...
-
-    def values(self):
-        """ """
-        ...
-
-def register():
-    """ """
-
-    ...
-
-def translation_update(_):
-    """ """
-
-    ...
-
-def unregister():
-    """ """
+    def type_recast(self): ...
+    def values(self): ...
 
-    ...
+def register(): ...
+def translation_update(_): ...
+def unregister(): ...