class_copytransformmodifier3d.rst 35 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595
  1. :github_url: hide
  2. .. DO NOT EDIT THIS FILE!!!
  3. .. Generated automatically from Godot engine sources.
  4. .. Generator: https://github.com/godotengine/godot/tree/master/doc/tools/make_rst.py.
  5. .. XML source: https://github.com/godotengine/godot/tree/master/doc/classes/CopyTransformModifier3D.xml.
  6. .. _class_CopyTransformModifier3D:
  7. CopyTransformModifier3D
  8. =======================
  9. **Inherits:** :ref:`BoneConstraint3D<class_BoneConstraint3D>` **<** :ref:`SkeletonModifier3D<class_SkeletonModifier3D>` **<** :ref:`Node3D<class_Node3D>` **<** :ref:`Node<class_Node>` **<** :ref:`Object<class_Object>`
  10. A :ref:`SkeletonModifier3D<class_SkeletonModifier3D>` that apply transform to the bone which copied from reference.
  11. .. rst-class:: classref-introduction-group
  12. Description
  13. -----------
  14. Apply the copied transform of the bone set by :ref:`BoneConstraint3D.set_reference_bone()<class_BoneConstraint3D_method_set_reference_bone>` to the bone set by :ref:`BoneConstraint3D.set_apply_bone()<class_BoneConstraint3D_method_set_apply_bone>` with processing it with some masks and options.
  15. There are 4 ways to apply the transform, depending on the combination of :ref:`set_relative()<class_CopyTransformModifier3D_method_set_relative>` and :ref:`set_additive()<class_CopyTransformModifier3D_method_set_additive>`.
  16. \ **Relative + Additive:**\
  17. - Extract reference pose relative to the rest and add it to the apply bone's pose.
  18. \ **Relative + Not Additive:**\
  19. - Extract reference pose relative to the rest and add it to the apply bone's rest.
  20. \ **Not Relative + Additive:**\
  21. - Extract reference pose absolutely and add it to the apply bone's pose.
  22. \ **Not Relative + Not Additive:**\
  23. - Extract reference pose absolutely and the apply bone's pose is replaced with it.
  24. .. rst-class:: classref-reftable-group
  25. Properties
  26. ----------
  27. .. table::
  28. :widths: auto
  29. +-----------------------+----------------------------------------------------------------------------+-------+
  30. | :ref:`int<class_int>` | :ref:`setting_count<class_CopyTransformModifier3D_property_setting_count>` | ``0`` |
  31. +-----------------------+----------------------------------------------------------------------------+-------+
  32. .. rst-class:: classref-reftable-group
  33. Methods
  34. -------
  35. .. table::
  36. :widths: auto
  37. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  38. | |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\] | :ref:`get_axis_flags<class_CopyTransformModifier3D_method_get_axis_flags>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  39. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  40. | |bitfield|\[:ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>`\] | :ref:`get_copy_flags<class_CopyTransformModifier3D_method_get_copy_flags>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  41. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  42. | |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\] | :ref:`get_invert_flags<class_CopyTransformModifier3D_method_get_invert_flags>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  43. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  44. | :ref:`bool<class_bool>` | :ref:`is_additive<class_CopyTransformModifier3D_method_is_additive>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  45. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  46. | :ref:`bool<class_bool>` | :ref:`is_axis_x_enabled<class_CopyTransformModifier3D_method_is_axis_x_enabled>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  47. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  48. | :ref:`bool<class_bool>` | :ref:`is_axis_x_inverted<class_CopyTransformModifier3D_method_is_axis_x_inverted>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  49. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  50. | :ref:`bool<class_bool>` | :ref:`is_axis_y_enabled<class_CopyTransformModifier3D_method_is_axis_y_enabled>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  51. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  52. | :ref:`bool<class_bool>` | :ref:`is_axis_y_inverted<class_CopyTransformModifier3D_method_is_axis_y_inverted>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  53. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  54. | :ref:`bool<class_bool>` | :ref:`is_axis_z_enabled<class_CopyTransformModifier3D_method_is_axis_z_enabled>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  55. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  56. | :ref:`bool<class_bool>` | :ref:`is_axis_z_inverted<class_CopyTransformModifier3D_method_is_axis_z_inverted>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  57. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  58. | :ref:`bool<class_bool>` | :ref:`is_position_copying<class_CopyTransformModifier3D_method_is_position_copying>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  59. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  60. | :ref:`bool<class_bool>` | :ref:`is_relative<class_CopyTransformModifier3D_method_is_relative>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  61. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  62. | :ref:`bool<class_bool>` | :ref:`is_rotation_copying<class_CopyTransformModifier3D_method_is_rotation_copying>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  63. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  64. | :ref:`bool<class_bool>` | :ref:`is_scale_copying<class_CopyTransformModifier3D_method_is_scale_copying>`\ (\ index\: :ref:`int<class_int>`\ ) |const| |
  65. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  66. | |void| | :ref:`set_additive<class_CopyTransformModifier3D_method_set_additive>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  67. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  68. | |void| | :ref:`set_axis_flags<class_CopyTransformModifier3D_method_set_axis_flags>`\ (\ index\: :ref:`int<class_int>`, axis_flags\: |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\]\ ) |
  69. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  70. | |void| | :ref:`set_axis_x_enabled<class_CopyTransformModifier3D_method_set_axis_x_enabled>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  71. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  72. | |void| | :ref:`set_axis_x_inverted<class_CopyTransformModifier3D_method_set_axis_x_inverted>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  73. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  74. | |void| | :ref:`set_axis_y_enabled<class_CopyTransformModifier3D_method_set_axis_y_enabled>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  75. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  76. | |void| | :ref:`set_axis_y_inverted<class_CopyTransformModifier3D_method_set_axis_y_inverted>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  77. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  78. | |void| | :ref:`set_axis_z_enabled<class_CopyTransformModifier3D_method_set_axis_z_enabled>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  79. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  80. | |void| | :ref:`set_axis_z_inverted<class_CopyTransformModifier3D_method_set_axis_z_inverted>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  81. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  82. | |void| | :ref:`set_copy_flags<class_CopyTransformModifier3D_method_set_copy_flags>`\ (\ index\: :ref:`int<class_int>`, copy_flags\: |bitfield|\[:ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>`\]\ ) |
  83. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  84. | |void| | :ref:`set_copy_position<class_CopyTransformModifier3D_method_set_copy_position>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  85. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  86. | |void| | :ref:`set_copy_rotation<class_CopyTransformModifier3D_method_set_copy_rotation>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  87. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  88. | |void| | :ref:`set_copy_scale<class_CopyTransformModifier3D_method_set_copy_scale>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  89. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  90. | |void| | :ref:`set_invert_flags<class_CopyTransformModifier3D_method_set_invert_flags>`\ (\ index\: :ref:`int<class_int>`, axis_flags\: |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\]\ ) |
  91. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  92. | |void| | :ref:`set_relative<class_CopyTransformModifier3D_method_set_relative>`\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) |
  93. +--------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  94. .. rst-class:: classref-section-separator
  95. ----
  96. .. rst-class:: classref-descriptions-group
  97. Enumerations
  98. ------------
  99. .. _enum_CopyTransformModifier3D_TransformFlag:
  100. .. rst-class:: classref-enumeration
  101. flags **TransformFlag**: :ref:`🔗<enum_CopyTransformModifier3D_TransformFlag>`
  102. .. _class_CopyTransformModifier3D_constant_TRANSFORM_FLAG_POSITION:
  103. .. rst-class:: classref-enumeration-constant
  104. :ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>` **TRANSFORM_FLAG_POSITION** = ``1``
  105. If set, allows to copy the position.
  106. .. _class_CopyTransformModifier3D_constant_TRANSFORM_FLAG_ROTATION:
  107. .. rst-class:: classref-enumeration-constant
  108. :ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>` **TRANSFORM_FLAG_ROTATION** = ``2``
  109. If set, allows to copy the rotation.
  110. .. _class_CopyTransformModifier3D_constant_TRANSFORM_FLAG_SCALE:
  111. .. rst-class:: classref-enumeration-constant
  112. :ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>` **TRANSFORM_FLAG_SCALE** = ``4``
  113. If set, allows to copy the scale.
  114. .. _class_CopyTransformModifier3D_constant_TRANSFORM_FLAG_ALL:
  115. .. rst-class:: classref-enumeration-constant
  116. :ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>` **TRANSFORM_FLAG_ALL** = ``7``
  117. If set, allows to copy the position/rotation/scale.
  118. .. rst-class:: classref-item-separator
  119. ----
  120. .. _enum_CopyTransformModifier3D_AxisFlag:
  121. .. rst-class:: classref-enumeration
  122. flags **AxisFlag**: :ref:`🔗<enum_CopyTransformModifier3D_AxisFlag>`
  123. .. _class_CopyTransformModifier3D_constant_AXIS_FLAG_X:
  124. .. rst-class:: classref-enumeration-constant
  125. :ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>` **AXIS_FLAG_X** = ``1``
  126. If set, allows to process the X-axis.
  127. .. _class_CopyTransformModifier3D_constant_AXIS_FLAG_Y:
  128. .. rst-class:: classref-enumeration-constant
  129. :ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>` **AXIS_FLAG_Y** = ``2``
  130. If set, allows to process the Y-axis.
  131. .. _class_CopyTransformModifier3D_constant_AXIS_FLAG_Z:
  132. .. rst-class:: classref-enumeration-constant
  133. :ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>` **AXIS_FLAG_Z** = ``4``
  134. If set, allows to process the Z-axis.
  135. .. _class_CopyTransformModifier3D_constant_AXIS_FLAG_ALL:
  136. .. rst-class:: classref-enumeration-constant
  137. :ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>` **AXIS_FLAG_ALL** = ``7``
  138. If set, allows to process the all axes.
  139. .. rst-class:: classref-section-separator
  140. ----
  141. .. rst-class:: classref-descriptions-group
  142. Property Descriptions
  143. ---------------------
  144. .. _class_CopyTransformModifier3D_property_setting_count:
  145. .. rst-class:: classref-property
  146. :ref:`int<class_int>` **setting_count** = ``0`` :ref:`🔗<class_CopyTransformModifier3D_property_setting_count>`
  147. .. rst-class:: classref-property-setget
  148. - |void| **set_setting_count**\ (\ value\: :ref:`int<class_int>`\ )
  149. - :ref:`int<class_int>` **get_setting_count**\ (\ )
  150. The number of settings in the modifier.
  151. .. rst-class:: classref-section-separator
  152. ----
  153. .. rst-class:: classref-descriptions-group
  154. Method Descriptions
  155. -------------------
  156. .. _class_CopyTransformModifier3D_method_get_axis_flags:
  157. .. rst-class:: classref-method
  158. |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\] **get_axis_flags**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_get_axis_flags>`
  159. Returns the axis flags of the setting at ``index``.
  160. .. rst-class:: classref-item-separator
  161. ----
  162. .. _class_CopyTransformModifier3D_method_get_copy_flags:
  163. .. rst-class:: classref-method
  164. |bitfield|\[:ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>`\] **get_copy_flags**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_get_copy_flags>`
  165. Returns the copy flags of the setting at ``index``.
  166. .. rst-class:: classref-item-separator
  167. ----
  168. .. _class_CopyTransformModifier3D_method_get_invert_flags:
  169. .. rst-class:: classref-method
  170. |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\] **get_invert_flags**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_get_invert_flags>`
  171. Returns the invert flags of the setting at ``index``.
  172. .. rst-class:: classref-item-separator
  173. ----
  174. .. _class_CopyTransformModifier3D_method_is_additive:
  175. .. rst-class:: classref-method
  176. :ref:`bool<class_bool>` **is_additive**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_additive>`
  177. Returns ``true`` if the additive option is enabled in the setting at ``index``.
  178. .. rst-class:: classref-item-separator
  179. ----
  180. .. _class_CopyTransformModifier3D_method_is_axis_x_enabled:
  181. .. rst-class:: classref-method
  182. :ref:`bool<class_bool>` **is_axis_x_enabled**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_x_enabled>`
  183. Returns ``true`` if the enable flags has the flag for the X-axis in the setting at ``index``. See also :ref:`set_axis_flags()<class_CopyTransformModifier3D_method_set_axis_flags>`.
  184. .. rst-class:: classref-item-separator
  185. ----
  186. .. _class_CopyTransformModifier3D_method_is_axis_x_inverted:
  187. .. rst-class:: classref-method
  188. :ref:`bool<class_bool>` **is_axis_x_inverted**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_x_inverted>`
  189. Returns ``true`` if the invert flags has the flag for the X-axis in the setting at ``index``. See also :ref:`set_invert_flags()<class_CopyTransformModifier3D_method_set_invert_flags>`.
  190. .. rst-class:: classref-item-separator
  191. ----
  192. .. _class_CopyTransformModifier3D_method_is_axis_y_enabled:
  193. .. rst-class:: classref-method
  194. :ref:`bool<class_bool>` **is_axis_y_enabled**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_y_enabled>`
  195. Returns ``true`` if the enable flags has the flag for the Y-axis in the setting at ``index``. See also :ref:`set_axis_flags()<class_CopyTransformModifier3D_method_set_axis_flags>`.
  196. .. rst-class:: classref-item-separator
  197. ----
  198. .. _class_CopyTransformModifier3D_method_is_axis_y_inverted:
  199. .. rst-class:: classref-method
  200. :ref:`bool<class_bool>` **is_axis_y_inverted**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_y_inverted>`
  201. Returns ``true`` if the invert flags has the flag for the Y-axis in the setting at ``index``. See also :ref:`set_invert_flags()<class_CopyTransformModifier3D_method_set_invert_flags>`.
  202. .. rst-class:: classref-item-separator
  203. ----
  204. .. _class_CopyTransformModifier3D_method_is_axis_z_enabled:
  205. .. rst-class:: classref-method
  206. :ref:`bool<class_bool>` **is_axis_z_enabled**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_z_enabled>`
  207. Returns ``true`` if the enable flags has the flag for the Z-axis in the setting at ``index``. See also :ref:`set_axis_flags()<class_CopyTransformModifier3D_method_set_axis_flags>`.
  208. .. rst-class:: classref-item-separator
  209. ----
  210. .. _class_CopyTransformModifier3D_method_is_axis_z_inverted:
  211. .. rst-class:: classref-method
  212. :ref:`bool<class_bool>` **is_axis_z_inverted**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_axis_z_inverted>`
  213. Returns ``true`` if the invert flags has the flag for the Z-axis in the setting at ``index``. See also :ref:`set_invert_flags()<class_CopyTransformModifier3D_method_set_invert_flags>`.
  214. .. rst-class:: classref-item-separator
  215. ----
  216. .. _class_CopyTransformModifier3D_method_is_position_copying:
  217. .. rst-class:: classref-method
  218. :ref:`bool<class_bool>` **is_position_copying**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_position_copying>`
  219. Returns ``true`` if the copy flags has the flag for the position in the setting at ``index``. See also :ref:`set_copy_flags()<class_CopyTransformModifier3D_method_set_copy_flags>`.
  220. .. rst-class:: classref-item-separator
  221. ----
  222. .. _class_CopyTransformModifier3D_method_is_relative:
  223. .. rst-class:: classref-method
  224. :ref:`bool<class_bool>` **is_relative**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_relative>`
  225. Returns ``true`` if the relative option is enabled in the setting at ``index``.
  226. .. rst-class:: classref-item-separator
  227. ----
  228. .. _class_CopyTransformModifier3D_method_is_rotation_copying:
  229. .. rst-class:: classref-method
  230. :ref:`bool<class_bool>` **is_rotation_copying**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_rotation_copying>`
  231. Returns ``true`` if the copy flags has the flag for the rotation in the setting at ``index``. See also :ref:`set_copy_flags()<class_CopyTransformModifier3D_method_set_copy_flags>`.
  232. .. rst-class:: classref-item-separator
  233. ----
  234. .. _class_CopyTransformModifier3D_method_is_scale_copying:
  235. .. rst-class:: classref-method
  236. :ref:`bool<class_bool>` **is_scale_copying**\ (\ index\: :ref:`int<class_int>`\ ) |const| :ref:`🔗<class_CopyTransformModifier3D_method_is_scale_copying>`
  237. Returns ``true`` if the copy flags has the flag for the scale in the setting at ``index``. See also :ref:`set_copy_flags()<class_CopyTransformModifier3D_method_set_copy_flags>`.
  238. .. rst-class:: classref-item-separator
  239. ----
  240. .. _class_CopyTransformModifier3D_method_set_additive:
  241. .. rst-class:: classref-method
  242. |void| **set_additive**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_additive>`
  243. Sets additive option in the setting at ``index`` to ``enabled``. This mainly affects the process of applying transform to the :ref:`BoneConstraint3D.set_apply_bone()<class_BoneConstraint3D_method_set_apply_bone>`.
  244. If sets ``enabled`` to ``true``, the processed transform is added to the pose of the current apply bone.
  245. If sets ``enabled`` to ``false``, the pose of the current apply bone is replaced with the processed transform. However, if set :ref:`set_relative()<class_CopyTransformModifier3D_method_set_relative>` to ``true``, the transform is relative to rest.
  246. .. rst-class:: classref-item-separator
  247. ----
  248. .. _class_CopyTransformModifier3D_method_set_axis_flags:
  249. .. rst-class:: classref-method
  250. |void| **set_axis_flags**\ (\ index\: :ref:`int<class_int>`, axis_flags\: |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\]\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_flags>`
  251. Sets the flags to copy axes. If the flag is valid, the axis is copied.
  252. .. rst-class:: classref-item-separator
  253. ----
  254. .. _class_CopyTransformModifier3D_method_set_axis_x_enabled:
  255. .. rst-class:: classref-method
  256. |void| **set_axis_x_enabled**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_x_enabled>`
  257. If sets ``enabled`` to ``true``, the X-axis will be copied.
  258. .. rst-class:: classref-item-separator
  259. ----
  260. .. _class_CopyTransformModifier3D_method_set_axis_x_inverted:
  261. .. rst-class:: classref-method
  262. |void| **set_axis_x_inverted**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_x_inverted>`
  263. If sets ``enabled`` to ``true``, the X-axis will be inverted.
  264. .. rst-class:: classref-item-separator
  265. ----
  266. .. _class_CopyTransformModifier3D_method_set_axis_y_enabled:
  267. .. rst-class:: classref-method
  268. |void| **set_axis_y_enabled**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_y_enabled>`
  269. If sets ``enabled`` to ``true``, the Y-axis will be copied.
  270. .. rst-class:: classref-item-separator
  271. ----
  272. .. _class_CopyTransformModifier3D_method_set_axis_y_inverted:
  273. .. rst-class:: classref-method
  274. |void| **set_axis_y_inverted**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_y_inverted>`
  275. If sets ``enabled`` to ``true``, the Y-axis will be inverted.
  276. .. rst-class:: classref-item-separator
  277. ----
  278. .. _class_CopyTransformModifier3D_method_set_axis_z_enabled:
  279. .. rst-class:: classref-method
  280. |void| **set_axis_z_enabled**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_z_enabled>`
  281. If sets ``enabled`` to ``true``, the Z-axis will be copied.
  282. .. rst-class:: classref-item-separator
  283. ----
  284. .. _class_CopyTransformModifier3D_method_set_axis_z_inverted:
  285. .. rst-class:: classref-method
  286. |void| **set_axis_z_inverted**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_axis_z_inverted>`
  287. If sets ``enabled`` to ``true``, the Z-axis will be inverted.
  288. .. rst-class:: classref-item-separator
  289. ----
  290. .. _class_CopyTransformModifier3D_method_set_copy_flags:
  291. .. rst-class:: classref-method
  292. |void| **set_copy_flags**\ (\ index\: :ref:`int<class_int>`, copy_flags\: |bitfield|\[:ref:`TransformFlag<enum_CopyTransformModifier3D_TransformFlag>`\]\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_copy_flags>`
  293. Sets the flags to process the transform operations. If the flag is valid, the transform operation is processed.
  294. \ **Note:** If the rotation is valid for only one axis, it respects the roll of the valid axis. If the rotation is valid for two axes, it discards the roll of the invalid axis.
  295. .. rst-class:: classref-item-separator
  296. ----
  297. .. _class_CopyTransformModifier3D_method_set_copy_position:
  298. .. rst-class:: classref-method
  299. |void| **set_copy_position**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_copy_position>`
  300. If sets ``enabled`` to ``true``, the position will be copied.
  301. .. rst-class:: classref-item-separator
  302. ----
  303. .. _class_CopyTransformModifier3D_method_set_copy_rotation:
  304. .. rst-class:: classref-method
  305. |void| **set_copy_rotation**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_copy_rotation>`
  306. If sets ``enabled`` to ``true``, the rotation will be copied.
  307. .. rst-class:: classref-item-separator
  308. ----
  309. .. _class_CopyTransformModifier3D_method_set_copy_scale:
  310. .. rst-class:: classref-method
  311. |void| **set_copy_scale**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_copy_scale>`
  312. If sets ``enabled`` to ``true``, the scale will be copied.
  313. .. rst-class:: classref-item-separator
  314. ----
  315. .. _class_CopyTransformModifier3D_method_set_invert_flags:
  316. .. rst-class:: classref-method
  317. |void| **set_invert_flags**\ (\ index\: :ref:`int<class_int>`, axis_flags\: |bitfield|\[:ref:`AxisFlag<enum_CopyTransformModifier3D_AxisFlag>`\]\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_invert_flags>`
  318. Sets the flags to inverte axes. If the flag is valid, the axis is copied.
  319. \ **Note:** An inverted scale means an inverse number, not a negative scale. For example, inverting ``2.0`` means ``0.5``.
  320. \ **Note:** An inverted rotation flips the elements of the quaternion. For example, a two-axis inversion will flip the roll of each axis, and a three-axis inversion will flip the final orientation. However, be aware that flipping only one axis may cause unintended rotation by the unflipped axes, due to the characteristics of the quaternion.
  321. .. rst-class:: classref-item-separator
  322. ----
  323. .. _class_CopyTransformModifier3D_method_set_relative:
  324. .. rst-class:: classref-method
  325. |void| **set_relative**\ (\ index\: :ref:`int<class_int>`, enabled\: :ref:`bool<class_bool>`\ ) :ref:`🔗<class_CopyTransformModifier3D_method_set_relative>`
  326. Sets relative option in the setting at ``index`` to ``enabled``.
  327. If sets ``enabled`` to ``true``, the extracted and applying transform is relative to the rest.
  328. If sets ``enabled`` to ``false``, the extracted transform is absolute.
  329. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  330. .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
  331. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  332. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  333. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  334. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  335. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`
  336. .. |bitfield| replace:: :abbr:`BitField (This value is an integer composed as a bitmask of the following flags.)`
  337. .. |void| replace:: :abbr:`void (No return value.)`