Difference between revisions of "Osiris/API/ItemToTransform"
From Divinity Engine Wiki
(Add docs for ItemToTransform) |
m |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
* 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 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). | * 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'''. | + | * To clear the ownership of an item, '''NULL_00000000-0000-0000-0000-000000000000''' may be passed as '''_Owner'''. |
===== Example ===== | ===== Example ===== | ||
| 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]] | ||
| Line 41: | Line 43: | ||
* [[Osiris/API/ItemRotateToAngleY|ItemRotateToAngleY]] | * [[Osiris/API/ItemRotateToAngleY|ItemRotateToAngleY]] | ||
* [[Osiris/API/ItemSetOwner|ItemSetOwner]] | * [[Osiris/API/ItemSetOwner|ItemSetOwner]] | ||
| + | * [[Osiris/API/ItemToInventory|ItemToInventory]] | ||
* [[Osiris/API/TeleportTo|TeleportTo]] | * [[Osiris/API/TeleportTo|TeleportTo]] | ||
* [[Osiris/API/TeleportToPosition|TeleportToPosition]] | * [[Osiris/API/TeleportToPosition|TeleportToPosition]] | ||
[[Category:Osiris Calls|ItemToTransform]] | [[Category:Osiris Calls|ItemToTransform]] | ||
Latest revision as of 08:22, 11 March 2019
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);
