Difference between revisions of "Osiris/API/ItemToTransform"
From Divinity Engine Wiki
(Add docs for ItemToTransform) |
|||
| Line 34: | Line 34: | ||
===== See Also ===== | ===== See Also ===== | ||
| + | * [[Osiris/API/GetPosition|GetPosition]] | ||
| + | * [[Osiris/API/GetRotation|GetRotation]] | ||
* [[Osiris/API/ItemDragToPosition|ItemDragToPosition]] | * [[Osiris/API/ItemDragToPosition|ItemDragToPosition]] | ||
* [[Osiris/API/ItemDragToTrigger|ItemDragToTrigger]] | * [[Osiris/API/ItemDragToTrigger|ItemDragToTrigger]] | ||
Revision as of 23:29, 20 July 2018
Full Definition(s)
- call ItemToTransform((GUIDSTRING)_UUID, (REAL)_X, (REAL)_Y, (REAL)_Z, (REAL)_Pitch, (REAL)_Yaw, (REAL)_Roll, (INTEGER)_Amount, (CHARACTERGUID)_Owner)
Description
Moves, rotates and changes the amount and ownership of the item with the _UUID. The position and rotation are updated instantly and without animation.
Notes
- This call requires _Pitch, _Yaw and _Roll to be given in radians while all other calls and queries use degrees to measure angles. Degrees can be converted to radians by multiplying them by 0.0174533.
- This is the only call that can change the amount of an existing item in the world (e.g. a gold pile).
- To clear the ownership of an item NULL_00000000-0000-0000-0000-000000000000 may be passed as _Owner.
Example
This example creates an overload that only requires _X, _Y and _Z to be set.
PROC ItemToTransform((ITEMGUID)_Item, (REAL)_X, (REAL)_Y, (REAL)_Z) AND GetRotation(_Item, (REAL)_PitchDegree, (REAL)_YawDegree, (REAL)_RollDegree) AND RealProduct(_PitchDegree, 0.0174533, (REAL)_Pitch) AND RealProduct(_YawDegree, 0.0174533, (REAL)_Yaw) AND RealProduct(_RollDegree, 0.0174533, (REAL)_Roll) AND ItemGetAmount(_Item, (INTEGER)_Amount) AND ItemGetOwner(_Item, (CHARACTERGUID)_Owner) THEN ItemToTransform(_Item, _X, _Y, _Z, _Pitch, _Yaw, _Roll, _Amount, _Owner);
