class_skeletonmodification2dphysicalbones.rst 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112
  1. :github_url: hide
  2. .. Generated automatically by doc/tools/make_rst.py in Godot's source tree.
  3. .. DO NOT EDIT THIS FILE, but the SkeletonModification2DPhysicalBones.xml source instead.
  4. .. The source is found in doc/classes or modules/<name>/doc_classes.
  5. .. _class_SkeletonModification2DPhysicalBones:
  6. SkeletonModification2DPhysicalBones
  7. ===================================
  8. **Inherits:** :ref:`SkeletonModification2D<class_SkeletonModification2D>` **<** :ref:`Resource<class_Resource>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
  9. A modification that applies the transforms of :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes to :ref:`Bone2D<class_Bone2D>` nodes.
  10. Description
  11. -----------
  12. This modification takes the transforms of :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes and applies them to :ref:`Bone2D<class_Bone2D>` nodes. This allows the :ref:`Bone2D<class_Bone2D>` nodes to react to physics thanks to the linked :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes.
  13. Properties
  14. ----------
  15. +-----------------------+------------------------------------------------------------------------------------------------------------------+-------+
  16. | :ref:`int<class_int>` | :ref:`physical_bone_chain_length<class_SkeletonModification2DPhysicalBones_property_physical_bone_chain_length>` | ``0`` |
  17. +-----------------------+------------------------------------------------------------------------------------------------------------------+-------+
  18. Methods
  19. -------
  20. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  21. | void | :ref:`fetch_physical_bones<class_SkeletonModification2DPhysicalBones_method_fetch_physical_bones>` **(** **)** |
  22. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`NodePath<class_NodePath>` | :ref:`get_physical_bone_node<class_SkeletonModification2DPhysicalBones_method_get_physical_bone_node>` **(** :ref:`int<class_int>` joint_idx **)** |const| |
  24. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  25. | void | :ref:`set_physical_bone_node<class_SkeletonModification2DPhysicalBones_method_set_physical_bone_node>` **(** :ref:`int<class_int>` joint_idx, :ref:`NodePath<class_NodePath>` physicalbone2d_node **)** |
  26. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  27. | void | :ref:`start_simulation<class_SkeletonModification2DPhysicalBones_method_start_simulation>` **(** :ref:`StringName[]<class_StringName>` bones=[] **)** |
  28. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  29. | void | :ref:`stop_simulation<class_SkeletonModification2DPhysicalBones_method_stop_simulation>` **(** :ref:`StringName[]<class_StringName>` bones=[] **)** |
  30. +---------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
  31. Property Descriptions
  32. ---------------------
  33. .. _class_SkeletonModification2DPhysicalBones_property_physical_bone_chain_length:
  34. - :ref:`int<class_int>` **physical_bone_chain_length**
  35. +-----------+---------------------------------------+
  36. | *Default* | ``0`` |
  37. +-----------+---------------------------------------+
  38. | *Setter* | set_physical_bone_chain_length(value) |
  39. +-----------+---------------------------------------+
  40. | *Getter* | get_physical_bone_chain_length() |
  41. +-----------+---------------------------------------+
  42. The amount of :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes linked in this modification.
  43. Method Descriptions
  44. -------------------
  45. .. _class_SkeletonModification2DPhysicalBones_method_fetch_physical_bones:
  46. - void **fetch_physical_bones** **(** **)**
  47. Empties the list of :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes and populates it will all :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes that are children of the :ref:`Skeleton2D<class_Skeleton2D>`.
  48. ----
  49. .. _class_SkeletonModification2DPhysicalBones_method_get_physical_bone_node:
  50. - :ref:`NodePath<class_NodePath>` **get_physical_bone_node** **(** :ref:`int<class_int>` joint_idx **)** |const|
  51. Returns the :ref:`PhysicalBone2D<class_PhysicalBone2D>` node at ``joint_idx``.
  52. ----
  53. .. _class_SkeletonModification2DPhysicalBones_method_set_physical_bone_node:
  54. - void **set_physical_bone_node** **(** :ref:`int<class_int>` joint_idx, :ref:`NodePath<class_NodePath>` physicalbone2d_node **)**
  55. Sets the :ref:`PhysicalBone2D<class_PhysicalBone2D>` node at ``joint_idx``.
  56. \ **Note:** This is just the index used for this modification, not the bone index used in the :ref:`Skeleton2D<class_Skeleton2D>`.
  57. ----
  58. .. _class_SkeletonModification2DPhysicalBones_method_start_simulation:
  59. - void **start_simulation** **(** :ref:`StringName[]<class_StringName>` bones=[] **)**
  60. Tell the :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes to start simulating and interacting with the physics world.
  61. Optionally, an array of bone names can be passed to this function, and that will cause only :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes with those names to start simulating.
  62. ----
  63. .. _class_SkeletonModification2DPhysicalBones_method_stop_simulation:
  64. - void **stop_simulation** **(** :ref:`StringName[]<class_StringName>` bones=[] **)**
  65. Tell the :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes to stop simulating and interacting with the physics world.
  66. Optionally, an array of bone names can be passed to this function, and that will cause only :ref:`PhysicalBone2D<class_PhysicalBone2D>` nodes with those names to stop simulating.
  67. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
  68. .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
  69. .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
  70. .. |constructor| replace:: :abbr:`constructor (This method is used to construct a type.)`
  71. .. |static| replace:: :abbr:`static (This method doesn't need an instance to be called, so it can be called directly using the class name.)`
  72. .. |operator| replace:: :abbr:`operator (This method describes a valid operator to use with this type as left-hand operand.)`