:github_url: hide .. _class_AimModifier3D: AimModifier3D ============= **Hérite de :** :ref:`BoneConstraint3D` **<** :ref:`SkeletonModifier3D` **<** :ref:`Node3D` **<** :ref:`Node` **<** :ref:`Object` L'**AimModifier3D** pivote un os pour regarder vers un os de référence. .. rst-class:: classref-introduction-group Description ----------- Il s'agit d'une version simple de :ref:`LookAtModifier3D` qui permet seulement un os comme référence sans options avancées telles que la limitation d'angle ou l'interpolation temporelle. La fonctionnalité est simplifiée, mais elle est implémentée avec un suivi lisse sans Euler, voir :ref:`set_use_euler()`. .. rst-class:: classref-reftable-group Propriétés -------------------- .. table:: :widths: auto +-----------------------+------------------------------------------------------------------+-------+ | :ref:`int` | :ref:`setting_count` | ``0`` | +-----------------------+------------------------------------------------------------------+-------+ .. rst-class:: classref-reftable-group Méthodes ---------------- .. table:: :widths: auto +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`BoneAxis` | :ref:`get_forward_axis`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Axis` | :ref:`get_primary_rotation_axis`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_relative`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_euler`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bool` | :ref:`is_using_secondary_rotation`\ (\ index\: :ref:`int`\ ) |const| | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_forward_axis`\ (\ index\: :ref:`int`, axis\: :ref:`BoneAxis`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_primary_rotation_axis`\ (\ index\: :ref:`int`, axis\: :ref:`Axis`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_relative`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_euler`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | |void| | :ref:`set_use_secondary_rotation`\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) | +---------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------+ .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des propriétés ------------------------------------------------------ .. _class_AimModifier3D_property_setting_count: .. rst-class:: classref-property :ref:`int` **setting_count** = ``0`` :ref:`🔗` .. rst-class:: classref-property-setget - |void| **set_setting_count**\ (\ value\: :ref:`int`\ ) - :ref:`int` **get_setting_count**\ (\ ) Le nombre de réglages dans le modificateur. .. rst-class:: classref-section-separator ---- .. rst-class:: classref-descriptions-group Descriptions des méthodes -------------------------------------------------- .. _class_AimModifier3D_method_get_forward_axis: .. rst-class:: classref-method :ref:`BoneAxis` **get_forward_axis**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Renvoie l'axe avant de l'os. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_get_primary_rotation_axis: .. rst-class:: classref-method :ref:`Axis` **get_primary_rotation_axis**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Renvoie l'axe de la première rotation. Il est activé seulement si :ref:`is_using_euler()` vaut ``true``. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_is_relative: .. rst-class:: classref-method :ref:`bool` **is_relative**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Renvoie ``true`` si l'option Relative est activée dans le paramètre à l'index ``index``. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_is_using_euler: .. rst-class:: classref-method :ref:`bool` **is_using_euler**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Renvoie ``true`` si elle fournit la rotation en utilisant les angles d'Euler. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_is_using_secondary_rotation: .. rst-class:: classref-method :ref:`bool` **is_using_secondary_rotation**\ (\ index\: :ref:`int`\ ) |const| :ref:`🔗` Renvoie ``true`` s'il fournit une rotation à deux axes. C'est activé seulement si :ref:`is_using_euler()` vaut ``true``. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_set_forward_axis: .. rst-class:: classref-method |void| **set_forward_axis**\ (\ index\: :ref:`int`, axis\: :ref:`BoneAxis`\ ) :ref:`🔗` Définit l'axe avant de l'os. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_set_primary_rotation_axis: .. rst-class:: classref-method |void| **set_primary_rotation_axis**\ (\ index\: :ref:`int`, axis\: :ref:`Axis`\ ) :ref:`🔗` Définit l'axe de la première rotation. C'est activé seulement si :ref:`is_using_euler()` vaut ``true``. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_set_relative: .. rst-class:: classref-method |void| **set_relative**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` Sets relative option in the setting at ``index`` to ``enabled``. If sets ``enabled`` to ``true``, the rotation is applied relative to the pose. If sets ``enabled`` to ``false``, the rotation is applied relative to the rest. It means to replace the current pose with the **AimModifier3D**'s result. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_set_use_euler: .. rst-class:: classref-method |void| **set_use_euler**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` Si ``enabled`` vaut ``true``, il fournit la rotation en utilisant Euler. Si ``enabled`` vaut ``false``, il fournit la rotation en utilisant la rotation de l'arc généré par le vecteur de l'axe avant et le vecteur vers la référence. .. rst-class:: classref-item-separator ---- .. _class_AimModifier3D_method_set_use_secondary_rotation: .. rst-class:: classref-method |void| **set_use_secondary_rotation**\ (\ index\: :ref:`int`, enabled\: :ref:`bool`\ ) :ref:`🔗` Si ``enabled`` vaut ``true``, cela fournit une rotation par deux axes. C'est activé seulement si :ref:`is_using_euler()` vaut ``true``. .. |virtual| replace:: :abbr:`virtual (Cette méthode doit typiquement être redéfinie par l'utilisateur pour avoir un effet.)` .. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)` .. |const| replace:: :abbr:`const (Cette méthode n'a pas d'effets de bord. Elle ne modifie aucune des variables membres de l'instance.)` .. |vararg| replace:: :abbr:`vararg (Cette méthode accepte n'importe quel nombre d'arguments après ceux décris ici.)` .. |constructor| replace:: :abbr:`constructor (Cette méthode est utilisée pour construire un type.)` .. |static| replace:: :abbr:`static (Cette méthode n'a pas besoin d'instance pour être appelée, elle peut donc être directement appelée en utilisant le nom de la classe.)` .. |operator| replace:: :abbr:`operator (Cette méthode décrit un opérateur valide à utiliser avec ce type en tant qu'opérande gauche.)` .. |bitfield| replace:: :abbr:`BitField (Cette valeur est un nombre entier composé d'un masque de bits des options suivantes.)` .. |void| replace:: :abbr:`void (Aucune valeur de retour.)`