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

2018-06-28T17:52:02Z

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

wiki>Jaggz: /* Adding a modifier type */

2017-04-14T02:59:31Z

‎Adding a modifier type

新規ページ

=Overview=
== ModifierTypeInfo ==
The modifier stack accesses modifiers through a standard interface. The interface for each modifier is stored as a set of callback function pointers in a <code>ModifierTypeInfo</code> structure (defined in ''BKE_modifier.h''). There is a static array of these structures (one for each modifier type) accessible through the <code>modifierType_getInfo</code> function defined in ''modifier.c''.

== ModifierData ==
The data for a specific instance of a certain modifier type is stored in a <code><type>ModifierData</code> structure (e.g. <code>MirrorModifierData</code> for the Mirror modifier), defined in ''DNA_modifier_types.h''. Each <code><type>ModifierData</code> structure must include, as its first field, a <code>ModifierData</code> structure which contains a type identifier. This type identifier is passed to the <code>modifierType_getInfo</code> function to retrieve a <code>ModifierTypeInfo</code> structure describing the modifier type. Since the <code>ModifierData</code> structure is the first field, any <code><type>ModifierData</code> pointer can be cast to a <code>ModifierData</code> pointer and used to directly retrieve the type identifier.

== Required vs. Optional functions ==
Some callback functions in <code>ModifierTypeInfo</code> are '''required''', others are '''optional''' (these should be set to NULL if not implemented). Additionally, modifiers can be classified as either deforming or non-deforming, which affects which callback functions they are required to implement.

== Adding a modifier type ==
To add a modifier type, the following things must be done (where <code><type></code> is the one-word name of the modifier):
* Add an <code>eModifierType_<type></code> entry at the end of the <code>ModifierType</code> enum in ''DNA_modifier_types.h'' (just before <code>NUM_MODIFIER_TYPES</code> - the position is important to make sure all the other type values stay the same)
* Add a <code><type>ModifierData</code> structure definition to ''DNA_modifier_types.h'' (following the example of the existing structures and the guidelines in [[Dev:Source/Data Structures/DNAStructs|BlenderDev/DNAStructs]])
* Add function definitions to ''modifier.c''. The current convention is to name them <code><type>Modifier_<functionName></code>, where <code><type></code> is spelt starting with a lowercase letter (e.g. <code>curveModifier_deformVerts</code>).
* Add a section to the <code>modifierType_getInfo</code> function in ''modifier.c'' initialising the <code>ModifierTypeInfo</code> structure for the new modifier (using the <code>INIT_TYPE</code> macro and following the example of the existing sections)
* RNA wrap the modifier in ''rna_modifier.c'', by adding a function <code>static void rna_def_modifier_<type>(BlenderRNA *brna)</code> similar to other modifiers.
* Add <code>def <type>(self, layout, ob, md, wide_ui):</code> sections to the <code>DATA_PT_modifiers</code> class in ''properties_data_modifier.py'', following the example of the existing sections.

= Required functions =
== All Modifiers ==
=== copyData ===
<source lang="cpp">
void copyData(ModifierData *''md'', ModifierData *''target'')
</source>
:Copy instance data for this modifier type. Should copy all user level settings to the target modifier.

== Deforming modifiers ==
=== deformVerts ===
<source lang="cpp">
void deformVerts(ModifierData *''md'', struct Object *''ob'',
struct DerivedMesh *''derivedData'', float (*''vertexCos'')[3],
int ''numVerts'')
</source>
:Should apply the deformation to the given vertex array.
:* If the deformer requires information from the object it can obtain it from the derivedData argument if non-NULL, and otherwise the ob argument. The derivedData argument should not be changed.

=== deformVertsEM ===
<source lang="cpp">
void deformVertsEM(ModifierData *''md'', struct Object *''ob'',
struct EditMesh *''editData'', struct DerivedMesh *''derivedData'',
float (*''vertexCos'')[3], int ''numVerts'')
</source>
:Like deformVerts but called during editmode (for modifiers which support editmode).

== Non-deforming modifiers ==
=== applyModifier ===
<source lang="cpp">
DerivedMesh *applyModifier(ModifierData *''md'', struct Object *''ob'',
struct DerivedMesh *''derivedData'',
int ''useRenderParams'', int ''isFinalCalc'')
</source>
:Should apply the modifier and return a DerivedMesh object (type is dependent on object type).
:* The derivedData argument will always be non-NULL; the modifier should read the mesh data from derivedData instead of the actual object data.
:* The useRenderParams argument indicates if the modifier is being applied in the service of the renderer (which may alter quality settings).
:* The isFinalCalc parameter indicates if the modifier is being calculated for a final result or for something temporary (like orcos). This is a hack at the moment, it is meant so subsurf can know if it is safe to reuse its internal cache.
:* The modifier may reuse the derivedData argument (i.e. return it in modified form), but must not release it.

=== applyModifierEM ===
<source lang="cpp">
DerivedMesh *applyModifierEM(ModifierData *''md'', struct Object *''ob'',
struct EditMesh *''editData'', struct DerivedMesh *''derivedData'')
</source>
:Like applyModifier but called during editmode (for modifiers which support editmode).
:* The DerivedMesh that is returned must support the operations that are expected from editmode objects. The same qualifications regarding derivedData apply as for applyModifier.

= Optional functions =
== All Modifiers ==
=== initData ===
<source lang="cpp">
void initData(ModifierData *''md'')
</source>
:Initialize new instance data for this modifier type. This function should set modifier variables to their default values.

=== freeData ===
<source lang="cpp">
void freeData(ModifierData *''md'')
</source>
:Should free internal modifier data variables. This function should not free the md variable itself.

=== requiredDataMask ===
<source lang="cpp">
CustomDataMask requiredDataMask(struct ModifierData *''md'')
</source>
:Should return a CustomDataMask indicating what data this modifier needs. If (mask & (1 << (layer type))) != 0, this modifier needs that custom data layer. This function's return value can change depending on the modifier's settings.
:* Note that this means extra data (e.g. vertex groups) - it is assumed that all modifiers need mesh data and deform modifiers need vertex coordinates.
:* If this function is not present or it returns 0, it is assumed that no extra data is needed.

=== isDisabled ===
<source lang="cpp">
int isDisabled(ModifierData *''md'')
</source>
:Should return a boolean value indicating if this modifier is able to be calculated based on the modifier data. This is *not* regarding md->flag (that is tested by the system); this just tests if the data validates (for example, a lattice will return false if the lattice object is not defined). If this function is not present, the modifier is assumed to never be disabled.

=== updateDepgraph ===
<source lang="cpp">
void updateDepgraph(ModifierData *''md'', struct DagForest *''forest'',
struct Object *''ob'', struct DagNode *''obNode'')
</source>
:Should add the appropriate relations to the [[Dev:Source/Data System/DependancyGraph|dependancy graph]] depending on the modifier data. These relations are used by Blender to determine when the modifier stack needs to be re-evaluated.

=== dependsOnTime ===
<source lang="cpp">
int dependsOnTime(ModifierData *''md'')
</source>
:Should return true if the modifier needs to be recalculated on time changes. This function is assumed to return false if not present.

=== foreachObjectLink ===
<source lang="cpp">
void foreachObjectLink(ModifierData *''md'', struct Object *''ob'',
ObjectWalkFunc ''walk'', void *''userData'')
</source>
:Should call the given walk function with a pointer to each Object pointer that the modifier data stores. This is used for unlinking objects or forwarding object references, and for linking on file load if foreachIDLink is not present.
:* If a modifier stores Object pointers, it should probably implement this function.

=== foreachIDLink ===
<source lang="cpp">
void foreachIDLink(ModifierData *''md'', struct Object *''ob'',
IDWalkFunc ''walk'', void *''userData'')
</source>
:Should call the given walk function with a pointer to each ID pointer (i.e. each datablock pointer) that the modifier data stores. This is used for linking on file load and for unlinking datablocks or forwarding datablock references.
:* If this function is not present and foreachObjectLink is, foreachObjectLink will be used.
:* If a modifier stores datablock pointers (including Object pointers), it should probably implement this function.

= Enumerations =
== ModifierTypeType ==
=== eModifierTypeType_None ===
:Should not be used, only for None modifier type

=== eModifierTypeType_OnlyDeform ===
:Modifier only does deformation, implies that modifier type should have a valid deformVerts function. OnlyDeform style modifiers implicitly accept either mesh or CV input but should still declare flags appropriately.

=== eModifierTypeType_Constructive ===

=== eModifierTypeType_Nonconstructive ===

== ModifierTypeFlag ==
=== eModifierTypeFlag_AcceptsMesh ===

=== eModifierTypeFlag_AcceptsCVs ===

=== eModifierTypeFlag_SupportsMapping ===

=== eModifierTypeFlag_SupportsEditmode ===

=== eModifierTypeFlag_EnableInEditmode ===
:For modifiers that support editmode this determines if the modifier should be enabled by default in editmode. This should only be used by modifiers that are relatively speedy and also generally used in editmode, otherwise let the user enable it by hand.

=== eModifierTypeFlag_RequiresOriginalData ===
:For modifiers that require original data and so cannot be placed after any non-deformative modifier.

= Data types =
== ObjectWalkFunc ==
<source lang="cpp">
typedef void (*ObjectWalkFunc)(void *userData, Object *ob, Object **obpoin)
</source>
:A pointer to a function to be called on each object pointer in the modifier data; passed to <code>forEachObjectLink</code>

== IDWalkFunc ==
<source lang="cpp">
typedef void (*IDWalkFunc)(void *userData, Object *ob, ID **idpoin)
</source>
:A pointer to a function to be called on each ID pointer in the modifier data; passed to <code>forEachIDLink</code>

[[Category:Script]]

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

Dev:Source/Modifiers/Stack/API Reference - 版の履歴

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

wiki>Jaggz: /* Adding a modifier type */

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