diff options
author | Campbell Barton <campbell@blender.org> | 2022-09-23 08:03:15 +0300 |
---|---|---|
committer | Campbell Barton <campbell@blender.org> | 2022-09-23 08:04:02 +0300 |
commit | 0f6d5c9a9d4abd672ecce4812da69564d918b2fc (patch) | |
tree | ba92c5a698b2bde3be345fc6509a5aebb51e2e76 /doc | |
parent | c1725220609ecc790b957ba88c3027d3c1082f70 (diff) |
Docs: minor improvements to info_advanced_blender_as_bpy wording
Diffstat (limited to 'doc')
-rw-r--r-- | doc/python_api/rst/info_advanced_blender_as_bpy.rst | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/python_api/rst/info_advanced_blender_as_bpy.rst b/doc/python_api/rst/info_advanced_blender_as_bpy.rst index b3fbfd2fe6d..9d2861ff627 100644 --- a/doc/python_api/rst/info_advanced_blender_as_bpy.rst +++ b/doc/python_api/rst/info_advanced_blender_as_bpy.rst @@ -78,9 +78,10 @@ Signal Handlers to cancel a render and a crash log is not written in the event of a crash. Startup and Preferences - When the ``bpy`` module loads, the file is not empty as you might expect, - there is a default cube, camera and light. If you wish to start from a blank file use: - ``bpy.ops.wm.read_factory_settings(use_empty=True)``. + When the ``bpy`` module loads it contains the default startup scene + (instead of an "empty" blend-file as you might expect), so there is a default cube, camera and light. + + If you wish to start from an empty file use: ``bpy.ops.wm.read_factory_settings(use_empty=True)``. The users startup and preferences are ignored to prevent your local configuration from impacting scripts behavior. The Python module behaves as if ``--factory-startup`` was passed as a command line argument. @@ -101,9 +102,10 @@ Limitations Most constraints of Blender as an application still apply: Reloading Unsupported - Reloading via ``importlib.reload`` will raise an exception instead of reloading and resetting the module. + Reloading the ``bpy`` module via ``importlib.reload`` will raise an exception + instead of reloading and resetting the module. - The operator ``bpy.ops.wm.read_factory_settings()`` can be used to reset the internal state. + Instead, the operator ``bpy.ops.wm.read_factory_settings()`` can be used to reset the internal state. Single Blend File Restriction Only a single ``.blend`` file can be edited at a time. |