class_copytransformmodifier3d.rst 35 KB

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