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

2018-06-28T20:49:42Z

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

wiki>Ansimionescu: /* Members */

2012-06-14T13:27:16Z

‎Members

新規ページ

==Architecture: operators==
Operators (wmOperatorType*) manage tools, so by defining a new wmOperatorType you create a new tool. Check out [1] for more info (and conventions) and [2] for a tutorial/more details.
* Example 1: http://pastebin.com/uMfBNvZj
* Example 2: http://pastebin.com/XUutURAc

==Members==
<source lang="c">ot->name = "(De)select All" </source>
''name'': Human readable name for the UI. Capitalized.

<source lang="c">ot->idname = "MESH_OT_select_all"</source>
''idname'': unique identifier.

Set it identical to the method name

Format: <PREFIX>_OT_<action>_<details> (e.g. MESH_OT_select_all)

<source lang="c">ot->description = "(De)select all vertices, edges or faces";</source>
''description'': Tooltip?

<source lang="c">PropertyRNA *prop = RNA_def_int(ot->srna, ...)</source>
''srna'': RNA propery defining the way the operator behaves

<source lang="c">ot->exec = edbm_select_all_exec</source>
''exec'', ''invoke'', ''modal'', ''cancel'': callbacks

Every operator must define either ''exec'' or ''invoke''.
* ''exec''
** Provided to run the operator without user interaction.
** Only if this is provided can the ot be recorded for a macro.
* ''invoke''
** Will execute after an event (e.g. getting mouse coordinates).
* ''modal''
** From the invoke callback, the ot can add itself as a handler, and receive further events in the modal callback.
* ''cancel''
** If the operator is cancelled (e.g. program quitting), this callback is called.
Return for ''exec'', ''invoke'' and ''cancel'':
* ''pass through'': Means the operator passes on the event to other operators, as if the callback did not run.
* ''running modal'': Indicates that the ot is still running and has registered itself to receive modal callbacks.
* ''cancelled'', ''finished'': Mean the execution of the ot has ended, successfully or not. The operator will be registered only for 'finished'.

<source lang="c">ot->poll= ED_operator_editmesh
[...]
int ED_operator_editmesh(bContext *C)
{
Object *obedit= CTX_data_edit_object(C);
if(obedit && obedit->type==OB_MESH)
return NULL != ((Mesh *)obedit->data)->edit_mesh;
return 0;
}</source>
''poll'': Used to verify the ot can be executed in the current context. It's often shared for multiple operators. It's always called before executing the operator, so it may be used to gray out or hide UI elements that use this ot automatically.

==Caveats==
* Note the distinction between RNA properties and customdata. The properties should only store public parameters as seen by the user, these are saved as part of macro's and written to file. The customdata is an arbitrary pointer, typically to a C struct, that should only exist while the operator is running, an so it is not written to file.
* The invoke callback also takes properties as inputs and should take those into account. For example a transform operator might have a mode=rotate input, and should then start in rotation mode.

Home:

[0] http://wiki.blender.org/index.php/User:Ansimionescu

Reference:

[1] http://wiki.blender.org/index.php/Dev:2.5/Source/Architecture/Operators

[2] http://wiki.blender.org/index.php/Dev:2.5/Source/Architecture/Operators/Tutorial

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

利用者:Ansimionescu/Notes/1 - 版の履歴

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

wiki>Ansimionescu: /* Members */

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