Yamyam: 1版をインポートしました

2018-06-28T20:56:48Z

1版をインポートしました

wiki>Olson: /* Scripting & Security */ corrected typo

2013-09-03T21:02:52Z

‎Scripting & Security: corrected typo

新規ページ

= Scripting & Security =

The ability to include Python scripts within blend files is valuable for advanced tasks such as rigging, automation and using the game-engine, however it poses a security risk since Python doesn't restrict what a script can do.

Therefore, you should only run scripts from sources you know and trust.

Automatic execution is disabled by default, however some blend files need this to function properly.

When a blend file tries to execute a script and is not allowed, a message will appear in the header with the option to '''Reload Trusted''' or '''Ignore''' the message.

[[File:Python_Script_AutoExec_Header.png|800px|center]]

== Scripts in Blend Files ==

=== Auto Execution ===

Here are the different ways blend files may automatically run scripts.

* Registered Text-Blocks<br>''A text block can have its '''Register''' option enabled which means it will load on start.''
* Animation Drivers<br>''Python expressions can be used to '''drive''' values and are often used in more advanced rigs and animations.''
* Game Engine Auto-Start<br>''scripts are often used for game logic, blend files can have auto-start enabled with runs the game on load.''

=== Manual Execution ===

There are other ways scripts in a <tt>blend</tt> file may execute that require user interaction (therefor will run even when auto-execution is off),<br>but you should be aware that this is the case since it's not necessarily obvious.

* Running a script in the text editor ''(ok, this is obvious!)''.
* Rendering with FreeStyle - ''FreeStyle uses scripts to control line styles''
* Running the Game-Engine.

== Controlling Script Execution ==

Blender provides a number of ways to control whether scripts from a blend file are allowed to automatically execute.

First of all, the file-selector has the option '''Trusted Source''' which you can use on a case-by-case basis to control auto-execution.

However you may forget to set this, or open a file without going through the file selector - so you can change the default (described next).

=== Setting Defaults ===

In the '''File''' section of the user-preferences there is the toggle '''Auto-Run Python Scripts'''.

This means the '''Trusted Source''' option in the file-selector will be enabled by default, and scripts can run when blend files are loaded without using the file selector.

Once enabled you have the option to exclude certain directories, a typical configuration would be to trust all paths except for the download directory.

[[File:Python_Script_AutoExec_Configure.png‎|600px|center]]

=== Command Line ===

You may want to perform batch rendering or some other task from the command line - running Blender without an interface.

In this case the user-preferences are still used but you may want to override them.
* Enable with <tt>-y</tt> or <tt>--enable-autoexec</tt>
* Disable with <tt>-Y</tt> or <tt>--disable-autoexec</tt>

Example - rendering an animation in background mode, allowing drivers and other scripts to run:
<source lang=bash>
blender --background --enable-autoexec my_movie.blend --render-anim
</source>

Note: these command line arguments can be used to start a regular blender instance and will still override the user-preferences.

← 古い版	2018年6月28日 (木) 20:56時点における版
(相違点なし)

Doc:2.6/Manual/Extensions/Python/Security - 版の履歴

Yamyam: 1版 をインポートしました

wiki>Olson: /* Scripting & Security */ corrected typo

Yamyam: 1版をインポートしました