fake-bpy-module 20231205__py3-none-any.whl → 20231207__py3-none-any.whl

bmesh/utils/__init__.pyi

@@ -0,0 +1,207 @@
+import sys
+import typing
+import bmesh.types
+
+GenericType = typing.TypeVar("GenericType")
+
+
+def edge_rotate(edge: 'bmesh.types.BMEdge',
+                ccw: bool = False) -> 'bmesh.types.BMEdge':
+    ''' Rotate the edge and return the newly created edge. If rotating the edge fails, None will be returned.
+
+    :param edge: The edge to rotate.
+    :type edge: 'bmesh.types.BMEdge'
+    :param ccw: When True the edge will be rotated counter clockwise.
+    :type ccw: bool
+    :rtype: 'bmesh.types.BMEdge'
+    :return: The newly rotated edge.
+    '''
+
+    ...
+
+
+def edge_split(edge: 'bmesh.types.BMEdge', vert: 'bmesh.types.BMVert',
+               fac: float) -> typing.Tuple:
+    ''' Split an edge, return the newly created data.
+
+    :param edge: The edge to split.
+    :type edge: 'bmesh.types.BMEdge'
+    :param vert: One of the verts on the edge, defines the split direction.
+    :type vert: 'bmesh.types.BMVert'
+    :param fac: The point on the edge where the new vert will be created [0 - 1].
+    :type fac: float
+    :rtype: typing.Tuple
+    :return: The newly created (edge, vert) pair.
+    '''
+
+    ...
+
+
+def face_flip(faces):
+    ''' Flip the faces direction.
+
+    :param face: Face to flip.
+    :type face: 'bmesh.types.BMFace'
+    '''
+
+    ...
+
+
+def face_join(faces: 'bmesh.types.BMFace',
+              remove: bool = True) -> 'bmesh.types.BMFace':
+    ''' Joins a sequence of faces.
+
+    :param faces: Sequence of faces.
+    :type faces: 'bmesh.types.BMFace'
+    :param remove: Remove the edges and vertices between the faces.
+    :type remove: bool
+    :rtype: 'bmesh.types.BMFace'
+    :return: The newly created face or None on failure.
+    '''
+
+    ...
+
+
+def face_split(face: 'bmesh.types.BMFace',
+               vert_a: 'bmesh.types.BMVert',
+               vert_b: 'bmesh.types.BMVert',
+               coords: typing.List[float] = (),
+               use_exist: bool = True,
+               example: 'bmesh.types.BMEdge' = None
+               ) -> typing.Tuple['bmesh.types.BMFace', 'bmesh.types.BMLoop']:
+    ''' Face split with optional intermediate points.
+
+    :param face: The face to cut.
+    :type face: 'bmesh.types.BMFace'
+    :param vert_a: First vertex to cut in the face (face must contain the vert).
+    :type vert_a: 'bmesh.types.BMVert'
+    :param vert_b: Second vertex to cut in the face (face must contain the vert).
+    :type vert_b: 'bmesh.types.BMVert'
+    :param coords: Optional argument to define points in between *vert_a* and *vert_b*.
+    :type coords: typing.List[float]
+    :param use_exist: .Use an existing edge if it exists (Only used when *coords* argument is empty or omitted)
+    :type use_exist: bool
+    :param example: Newly created edge will copy settings from this one.
+    :type example: 'bmesh.types.BMEdge'
+    :rtype: typing.Tuple['bmesh.types.BMFace', 'bmesh.types.BMLoop']
+    :return: The newly created face or None on failure.
+    '''
+
+    ...
+
+
+def face_split_edgenet(face: 'bmesh.types.BMFace',
+                       edgenet: 'bmesh.types.BMEdge') -> typing.Tuple:
+    ''' Splits a face into any number of regions defined by an edgenet.
+
+    :param face: The face to split. The face to split.
+    :type face: 'bmesh.types.BMFace'
+    :param face: The face to split. The face to split.
+    :type face: 'bmesh.types.BMFace'
+    :param edgenet: Sequence of edges.
+    :type edgenet: 'bmesh.types.BMEdge'
+    :rtype: typing.Tuple
+    :return: The newly created faces.
+    '''
+
+    ...
+
+
+def face_vert_separate(face: 'bmesh.types.BMFace',
+                       vert: 'bmesh.types.BMVert') -> 'bmesh.types.BMVert':
+    ''' Rip a vertex in a face away and add a new vertex.
+
+    :param face: The face to separate.
+    :type face: 'bmesh.types.BMFace'
+    :param vert: A vertex in the face to separate.
+    :type vert: 'bmesh.types.BMVert'
+    :rtype: 'bmesh.types.BMVert'
+    :return: The newly created vertex or None on failure.
+    '''
+
+    ...
+
+
+def loop_separate(loop: 'bmesh.types.BMLoop') -> 'bmesh.types.BMVert':
+    ''' Rip a vertex in a face away and add a new vertex.
+
+    :param loop: The loop to separate.
+    :type loop: 'bmesh.types.BMLoop'
+    :rtype: 'bmesh.types.BMVert'
+    :return: The newly created vertex or None on failure.
+    '''
+
+    ...
+
+
+def vert_collapse_edge(vert: 'bmesh.types.BMVert',
+                       edge: 'bmesh.types.BMEdge') -> 'bmesh.types.BMEdge':
+    ''' Collapse a vertex into an edge.
+
+    :param vert: The vert that will be collapsed.
+    :type vert: 'bmesh.types.BMVert'
+    :param edge: The edge to collapse into.
+    :type edge: 'bmesh.types.BMEdge'
+    :rtype: 'bmesh.types.BMEdge'
+    :return: The resulting edge from the collapse operation.
+    '''
+
+    ...
+
+
+def vert_collapse_faces(vert: 'bmesh.types.BMVert', edge: 'bmesh.types.BMEdge',
+                        fac: float, join_faces: bool) -> 'bmesh.types.BMEdge':
+    ''' Collapses a vertex that has only two manifold edges onto a vertex it shares an edge with.
+
+    :param vert: The vert that will be collapsed.
+    :type vert: 'bmesh.types.BMVert'
+    :param edge: The edge to collapse into.
+    :type edge: 'bmesh.types.BMEdge'
+    :param fac: The factor to use when merging customdata [0 - 1].
+    :type fac: float
+    :param join_faces: When true the faces around the vertex will be joined otherwise collapse the vertex by merging the 2 edges this vertex connects to into one.
+    :type join_faces: bool
+    :rtype: 'bmesh.types.BMEdge'
+    :return: The resulting edge from the collapse operation.
+    '''
+
+    ...
+
+
+def vert_dissolve(vert: 'bmesh.types.BMVert') -> bool:
+    ''' Dissolve this vertex (will be removed).
+
+    :param vert: The vert to be dissolved.
+    :type vert: 'bmesh.types.BMVert'
+    :rtype: bool
+    :return: True when the vertex dissolve is successful.
+    '''
+
+    ...
+
+
+def vert_separate(vert: 'bmesh.types.BMVert', edges: 'bmesh.types.BMEdge'
+                  ) -> typing.Tuple['bmesh.types.BMVert']:
+    ''' Separate this vertex at every edge.
+
+    :param vert: The vert to be separated.
+    :type vert: 'bmesh.types.BMVert'
+    :param edges: The edges to separated.
+    :type edges: 'bmesh.types.BMEdge'
+    :rtype: typing.Tuple['bmesh.types.BMVert']
+    :return: The newly separated verts (including the vertex passed).
+    '''
+
+    ...
+
+
+def vert_splice(vert: 'bmesh.types.BMVert', vert_target: 'bmesh.types.BMVert'):
+    ''' Splice vert into vert_target.
+
+    :param vert: The vertex to be removed.
+    :type vert: 'bmesh.types.BMVert'
+    :param vert_target: The vertex to use.
+    :type vert_target: 'bmesh.types.BMVert'
+    '''
+
+    ...

bpy/__init__.pyi

@@ -0,0 +1,18 @@
+import sys
+import typing
+import bpy.types
+
+from . import types
+from . import ops
+from . import app
+from . import path
+from . import utils
+from . import msgbus
+from . import props
+
+GenericType = typing.TypeVar("GenericType")
+context: 'bpy.types.Context'
+
+data: 'bpy.types.BlendData'
+''' Access to Blender's internal data
+'''

bpy/app/__init__.pyi

@@ -0,0 +1,247 @@
+import sys
+import typing
+from . import icons
+from . import translations
+from . import timers
+from . import handlers
+
+GenericType = typing.TypeVar("GenericType")
+
+
+def help_text(all: typing.Optional[bool] = False):
+    ''' Return the help text as a string.
+
+    :param all: Return all arguments, even those which aren't available for the current platform.
+    :type all: typing.Optional[bool]
+    '''
+
+    ...
+
+
+def is_job_running(job_type: typing.Optional[str]) -> typing.Any:
+    ''' Check whether a job of the given type is running.
+
+    :param job_type: `rna_enum_wm_job_type_items`.
+    :type job_type: typing.Optional[str]
+    :rtype: typing.Any
+    :return: Whether a job of the given type is currently running.
+    '''
+
+    ...
+
+
+alembic: typing.Any
+''' Constant value bpy.app.alembic(supported=True, version=(1, 8, 3), version_string=' 1, 8, 3')
+'''
+
+autoexec_fail: typing.Any
+''' Undocumented, consider `contributing <https://developer.blender.org/>`__.
+'''
+
+autoexec_fail_message: typing.Any
+''' Undocumented, consider `contributing <https://developer.blender.org/>`__.
+'''
+
+autoexec_fail_quiet: typing.Any
+''' Undocumented, consider `contributing <https://developer.blender.org/>`__.
+'''
+
+background: typing.Any
+''' Boolean, True when blender is running without a user interface (started with -b)
+'''
+
+binary_path: typing.Any
+''' The location of Blender's executable, useful for utilities that open new instances. Read-only unless Blender is built as a Python module - in this case the value is an empty string which script authors may point to a Blender binary.
+'''
+
+build_branch: typing.Any
+''' The branch this blender instance was built from
+'''
+
+build_cflags: typing.Any
+''' C compiler flags
+'''
+
+build_commit_date: typing.Any
+''' The date of commit this blender instance was built
+'''
+
+build_commit_time: typing.Any
+''' The time of commit this blender instance was built
+'''
+
+build_commit_timestamp: typing.Any
+''' The unix timestamp of commit this blender instance was built
+'''
+
+build_cxxflags: typing.Any
+''' C++ compiler flags
+'''
+
+build_date: typing.Any
+''' The date this blender instance was built
+'''
+
+build_hash: typing.Any
+''' The commit hash this blender instance was built with
+'''
+
+build_linkflags: typing.Any
+''' Binary linking flags
+'''
+
+build_options: typing.Any
+''' Constant value bpy.app.build_options(bullet=True, codec_avi=True, codec_ffmpeg=True, codec_sndfile=True, compositor_cpu=True, cycles=True, cycles_osl=True, freestyle=True, image_cineon=True, image_dds=True, image_hdr=True, image_openexr=True, image_openjpeg=True, image_tiff=True, input_ndof=True, audaspace=True, international=True, openal=True, opensubdiv=True, sdl=True, sdl_dynload=False, coreaudio=False, jack=False, pulseaudio=False, wasapi=False, libmv=True, mod_oceansim=True, mod_remesh=True, collada=True, io_wavefront_obj=True, io_ply=True, io_stl=True, io_gpencil=True, opencolorio=True, openmp=True, openvdb=True, alembic=True, usd=True, fluid=True, xr_openxr=True, potrace=True, pugixml=True, haru=True)
+'''
+
+build_platform: typing.Any
+''' The platform this blender instance was built for
+'''
+
+build_system: typing.Any
+''' Build system used
+'''
+
+build_time: typing.Any
+''' The time this blender instance was built
+'''
+
+build_type: typing.Any
+''' The type of build (Release, Debug)
+'''
+
+debug: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph_build: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph_eval: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph_pretty: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph_tag: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_depsgraph_time: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_events: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_ffmpeg: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_freestyle: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_handlers: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_io: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_python: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_simdata: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+debug_value: typing.Any
+''' Short, number which can be set to non-zero values for testing purposes
+'''
+
+debug_wm: typing.Any
+''' Boolean, for debug info (started with ``--debug`` / ``--debug-*`` matching this attribute name)
+'''
+
+driver_namespace: typing.Any
+''' Dictionary for drivers namespace, editable in-place, reset on file load (read-only) File Loading & Order of Initialization Since drivers may be evaluated immediately after loading a blend-file it is necessary to ensure the driver name-space is initialized beforehand. This can be done by registering text data-blocks to execute on startup, which executes the scripts before drivers are evaluated. See *Text -> Register* from Blender's text editor. .. hint:: You may prefer to use external files instead of Blender's text-blocks. This can be done using a text-block which executes an external file. This example runs ``driver_namespace.py`` located in the same directory as the text-blocks blend-file: .. code-block:: import os import bpy blend_dir = os.path.normalize(os.path.join(__file__, "..", "..")) bpy.utils.execfile(os.path.join(blend_dir, "driver_namespace.py")) Using ``__file__`` ensures the text resolves to the expected path even when library-linked from another file. Other methods of populating the drivers name-space can be made to work but tend to be error prone: Using The ``--python`` command line argument to populate name-space often fails to achieve the desired goal because the initial evaluation will lookup a function that doesn't exist yet, marking the driver as invalid - preventing further evaluation. Populating the driver name-space before the blend-file loads also doesn't work since opening a file clears the name-space. It is possible to run a script via the ``--python`` command line argument, before the blend file. This can register a load-post handler (:mod:`bpy.app.handlers.load_post`) that initialized the name-space. While this works for background tasks it has the downside that opening the file from the file selector won't setup the name-space.
+'''
+
+factory_startup: typing.Any
+''' Boolean, True when blender is running with --factory-startup)
+'''
+
+ffmpeg: typing.Any
+''' Constant value bpy.app.ffmpeg(supported=True, avcodec_version=(60, 3, 100), avcodec_version_string='60, 3, 100', avdevice_version=(60, 1, 100), avdevice_version_string='60, 1, 100', avformat_version=(60, 3, 100), avformat_version_string='60, 3, 100', avutil_version=(58, 2, 100), avutil_version_string='58, 2, 100', swscale_version=(7, 1, 100), swscale_version_string=' 7, 1, 100')
+'''
+
+ocio: typing.Any
+''' Constant value bpy.app.ocio(supported=True, version=(2, 2, 0), version_string=' 2, 2, 0')
+'''
+
+oiio: typing.Any
+''' Constant value bpy.app.oiio(supported=True, version=(2, 4, 15), version_string=' 2, 4, 15')
+'''
+
+opensubdiv: typing.Any
+''' Constant value bpy.app.opensubdiv(supported=True, version=(3, 5, 0), version_string=' 3, 5, 0')
+'''
+
+openvdb: typing.Any
+''' Constant value bpy.app.openvdb(supported=True, version=(10, 0, 0), version_string='10, 0, 0')
+'''
+
+render_icon_size: typing.Any
+''' Reference size for icon/preview renders (read-only)
+'''
+
+render_preview_size: typing.Any
+''' Reference size for icon/preview renders (read-only)
+'''
+
+sdl: typing.Any
+''' Constant value bpy.app.sdl(supported=True, version=(2, 28, 2), version_string='2.28.2', available=True)
+'''
+
+tempdir: typing.Any
+''' String, the temp directory used by blender (read-only)
+'''
+
+usd: typing.Any
+''' Constant value bpy.app.usd(supported=True, version=(0, 23, 5), version_string=' 0, 23, 5')
+'''
+
+use_event_simulate: typing.Any
+''' Boolean, for application behavior (started with ``--enable-*`` matching this attribute name)
+'''
+
+use_userpref_skip_save_on_exit: typing.Any
+''' Boolean, for application behavior (started with ``--enable-*`` matching this attribute name)
+'''
+
+version: typing.Any
+''' The Blender version as a tuple of 3 numbers. eg. (2, 83, 1)
+'''
+
+version_cycle: typing.Any
+''' The release status of this build alpha/beta/rc/release
+'''
+
+version_file: typing.Any
+''' The Blender version, as a tuple, last used to save a .blend file, compatible with ``bpy.data.version``. This value should be used for handling compatibility changes between Blender versions
+'''
+
+version_string: typing.Any
+''' The Blender version formatted as a string
+'''

bpy/app/handlers/__init__.pyi

@@ -0,0 +1,151 @@
+import sys
+import typing
+import bpy.types
+
+GenericType = typing.TypeVar("GenericType")
+animation_playback_post: typing.List[typing.
+                                     Callable[['bpy.types.Scene'], None]]
+''' on ending animation playback
+'''
+
+animation_playback_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on starting animation playback
+'''
+
+annotation_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on drawing an annotation (after)
+'''
+
+annotation_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on drawing an annotation (before)
+'''
+
+composite_cancel: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on a compositing background job (cancel)
+'''
+
+composite_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on a compositing background job (after)
+'''
+
+composite_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on a compositing background job (before)
+'''
+
+depsgraph_update_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on depsgraph update (post)
+'''
+
+depsgraph_update_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on depsgraph update (pre)
+'''
+
+frame_change_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' Called after frame change for playback and rendering, after the data has been evaluated for the new frame.
+'''
+
+frame_change_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' Called after frame change for playback and rendering, before any data is evaluated for the new frame. This makes it possible to change data and relations (for example swap an object to another mesh) for the new frame. Note that this handler is **not** to be used as 'before the frame changes' event. The dependency graph is not available in this handler, as data and relations may have been altered and the dependency graph has not yet been updated for that.
+'''
+
+load_factory_preferences_post: typing.List[typing.
+                                           Callable[['bpy.types.Scene'], None]]
+''' on loading factory preferences (after)
+'''
+
+load_factory_startup_post: typing.List[typing.
+                                       Callable[['bpy.types.Scene'], None]]
+''' on loading factory startup (after)
+'''
+
+load_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading a new blend file (after). Accepts one argument: the file being loaded, an empty string for the startup-file.
+'''
+
+load_post_fail: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on failure to load a new blend file (after). Accepts one argument: the file being loaded, an empty string for the startup-file.
+'''
+
+load_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading a new blend file (before).Accepts one argument: the file being loaded, an empty string for the startup-file.
+'''
+
+object_bake_cancel: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on canceling a bake job; will be called in the main thread
+'''
+
+object_bake_complete: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on completing a bake job; will be called in the main thread
+'''
+
+object_bake_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' before starting a bake job
+'''
+
+persistent: typing.Any
+''' Function decorator for callback functions not to be removed when loading new files
+'''
+
+redo_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading a redo step (after)
+'''
+
+redo_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading a redo step (before)
+'''
+
+render_cancel: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on canceling a render job
+'''
+
+render_complete: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on completion of render job
+'''
+
+render_init: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on initialization of a render job
+'''
+
+render_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on render (after)
+'''
+
+render_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on render (before)
+'''
+
+render_stats: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on printing render statistics
+'''
+
+render_write: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on writing a render frame (directly after the frame is written)
+'''
+
+save_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on saving a blend file (after). Accepts one argument: the file being saved, an empty string for the startup-file.
+'''
+
+save_post_fail: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on failure to save a blend file (after). Accepts one argument: the file being saved, an empty string for the startup-file.
+'''
+
+save_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on saving a blend file (before). Accepts one argument: the file being saved, an empty string for the startup-file.
+'''
+
+undo_post: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading an undo step (after)
+'''
+
+undo_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on loading an undo step (before)
+'''
+
+version_update: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on ending the versioning code
+'''
+
+xr_session_start_pre: typing.List[typing.Callable[['bpy.types.Scene'], None]]
+''' on starting an xr session (before)
+'''

bpy/app/icons/__init__.pyi

@@ -0,0 +1,42 @@
+import sys
+import typing
+
+GenericType = typing.TypeVar("GenericType")
+
+
+def new_triangles(range: typing.Optional[typing.Tuple],
+                  coords: typing.Optional[typing.Sequence[bytes]],
+                  colors: typing.Optional[typing.Sequence[bytes]]) -> int:
+    ''' Create a new icon from triangle geometry.
+
+    :param range: Pair of ints.
+    :type range: typing.Optional[typing.Tuple]
+    :param coords: Sequence of bytes (6 floats for one triangle) for (X, Y) coordinates.
+    :type coords: typing.Optional[typing.Sequence[bytes]]
+    :param colors: Sequence of ints (12 for one triangles) for RGBA.
+    :type colors: typing.Optional[typing.Sequence[bytes]]
+    :rtype: int
+    :return: Unique icon value (pass to interface ``icon_value`` argument).
+    '''
+
+    ...
+
+
+def new_triangles_from_file(filepath: typing.Optional[str]) -> int:
+    ''' Create a new icon from triangle geometry.
+
+    :param filepath: File path.
+    :type filepath: typing.Optional[str]
+    :rtype: int
+    :return: Unique icon value (pass to interface ``icon_value`` argument).
+    '''
+
+    ...
+
+
+def release(icon_id):
+    ''' Release the icon.
+
+    '''
+
+    ...