From 7c846bbe75af2be9124596d2c2ab26dad2023391 Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Wed, 24 Oct 2012 16:55:06 +0000 Subject: add section on how to run scripts in blender for the API intro, found there were no simple docs like this in the wiki. also set the window type to normal on start when -p argument is given, since the view could be maximized/fullscreen. --- doc/python_api/rst/info_quickstart.rst | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) (limited to 'doc') diff --git a/doc/python_api/rst/info_quickstart.rst b/doc/python_api/rst/info_quickstart.rst index 19ec8059aca..62ad4e9c4d8 100644 --- a/doc/python_api/rst/info_quickstart.rst +++ b/doc/python_api/rst/info_quickstart.rst @@ -2,8 +2,8 @@ Quickstart Introduction *********************** -Intro -===== +Preface +======= This API is generally stable but some areas are still being added and improved. @@ -58,6 +58,22 @@ A quick list of helpful things to know before starting: * To examine further scripts distributed with Blender, see ``~/.blender/scripts/startup/bl_ui`` for the user interface and ``~/.blender/scripts/startup/bl_op`` for operators. +Running Scripts +--------------- + +The two most common ways to execute python scripts are using the built-in text editor or entering commands in the python console. + +Both the **Text Editor** and **Python Console** are space types you can select from the view header. + +Rather then manually configuring your spaces for Python development, you may prefer to use the **Scripting** screen, included default with Blender, accessible from the top headers screen selector. + +From the text editor you can open ``.py`` files or paste then from the clipboard, then test using **Run Script**. + +The Python Console is typically used for typing in snippets and for testing to get immediate feedback, but can also have entire scripts pasted into it. + +Scripts can also run from the command line with Blender but to learn Blender/Python this isn't essential. + + Key Concepts ============ -- cgit v1.2.3