View source for HU/SetElementBoneQuaternion

__NOTOC__ 
{{Client function hu}}

{{New feature/item|3.0161|1.6.0|22741|
Ezzel a függvénnyel meghatározhatod, hogy egy adott csont hogyan forogjon az elemhez képest.<br/>
Ebben az esetben a [https://hu.wikipedia.org/wiki/Kvaterni%C3%B3k kvaterniók] használata hatékonyabb, és nem okoz olyan problémákat, mint például a gimbal zár, amely az [https://hu.wikipedia.org/wiki/Euler-sz%C3%B6gek Euler-szögekkel kapcsolatban felmerülhet], ezért előnyösebb választás a forgatáshoz.
}}

{{Tip|Ha egy elemet szeretnél egy csonthoz rögzíteni, nézd meg ezt a függvényt: [[attachElementToBone]].}}
{{Note|Ha alkalmazni szeretnéd a forgatást, akkor az [[updateElementRpHAnim]]-t meg kell hívni e függvény után.}}

==Szintaxis== 
<syntaxhighlight lang="lua">
bool setElementBoneQuaternion(element ped, int bone, float x, float y, float z, float w)
</syntaxhighlight> 

[[File:Cayley_Q8_multiplication_graph.png|thumb|[https://en.wikipedia.org/wiki/Cayley_graph Cayley-gráf] bemutatja a hat ciklussal való szorzást: <span style="color: red;">'''i'''</span>, <span style="color: green;">'''j'''</span> és <span style="color: blue;">'''k'''</span>.]]

===Argumentumok===
* '''ped:''' Az [[element]] (ped vagy játékos), amelyen a csont forgása be lesz állítva.
* '''bone:''' A csont azonosítója a forgatás beállításához.
:* A csontazonosító bizonyos testrészeknek felel meg, mint például a karok, lábak, gerinc, fej stb.
:* A csontok teljes listája a [[Bone IDs]] hivatkozásban található.
* '''x:''' Az 𝑖 komponens kvaterniójának együtthatója.
:* Az x tengely körüli elforgatást jelöli, és a kvaternió első képzeletbeli része.
* '''y:''' A 𝑗 komponens kvaterniójának együtthatója.
:* Az y tengely körüli forgást jelenti, és a kvaternió második képzeletbeli része.
* '''z:''' A 𝑘 komponens kvaterniójának együtthatója.
:* A z tengely körüli forgást jelenti, és a kvaternió harmadik képzeletbeli része.
* '''w:''' A kvaternió valódi eleme.
:* A kvaternió skaláris részét jelöli, amely a forgásszöghez kapcsolódik.
:* A '''w''' érték a teljes elforgatási szögként meghatározott elforgatási szög felének koszinuszából származik.

===Visszaadás===
''Igaz'' értéket ad vissza, ha a beállítás sikeres volt, ellenkező esetben hibaüzenetet ad vissza, és ''hamis'' értéket ad vissza.

==Példa== 
Ez a példa a játékos medencecsontját 180 fokkal elforgatja egy tetszőleges tengely körül.<br/>
Emellett az [[updateElementRpHAnim]] használata itt szükséges, mivel ez alkalmazza a forgatást.
<syntaxhighlight lang="lua">
local playerBone = 1
local playerBoneX, playerBoneY, playerBoneZ = 0.577, 0.577, 0.577
local playerBoneW = 0

addEventHandler("onClientPedsProcessed", root,
    function()
        setElementBoneQuaternion(localPlayer, playerBone, playerBoneX, playerBoneY, playerBoneZ, playerBoneW)
        updateElementRpHAnim(localPlayer)
    end
)
</syntaxhighlight>

==Követelmények==
{{Requirements|n/a|1.6.0-9.22741}}

==Lásd még==
{{Client_element_functions hu}}