NiAVObjectSetLocalRotation
Revision as of 14:52, 29 August 2010 by imported>DragoonWraith (→Example)
This is a command from NifSE.
Syntax
(bool:success) NiAVObjectSetLocalRotationTEMP float:a11 float:a12 float:a13 \
float:a21 float:a22 float:a23 \
float:a31 float:a32 float:a33 short:nifID short:blockID
(bool:success) NiAVObjSetLocRotT float:a11 float:a12 float:a13 \
float:a21 float:a22 float:a23 \
float:a31 float:a32 float:a33 short:nifID short:blockID
Sets the local rotation of the specified NiAVObject-derived block. Since blockID defaults to 0, the NIF's root NiNode, and NiNode is derived from NiAVObject, this function will change the local rotation of the NIF's root if called with no explicit blockID.
Example
This script will rotate each of the root's children, which are NiAVObject blocks, 180° about the X axis. This will effectively flip the NIF upside-down.
array_var R array_var children array_var child short nifID short blockID ... let R := GenerateRotationMatrix X 180 let children := NiNodeGetChildren nifID foreach child <- children let blockID := *child let locRot := NiAVObjectGetLocalRotation nifID blockID let locRot := MatrixMultiply R locRot ; order matters
; for clarity, using NiAVObjectSetLocalRotation. ; as noted below, this function does not yet exist, ; due to technical limitations in the OBSE Plugin API. NiAVObjectSetLocalRotation locRot nifID blockID loop
Notes
- Because OBSE Plug-Ins cannot currently accept arrays as arguments, NiAVObjectSetLocalRotation, as it would properly exist, cannot be implemented. NiAVObjectSetLocalRotationTEMP is provided as an alternative; it will be deprecated in favor of NiAVObjectSetLocalRotation when OBSE adds the ability to take array arguments, but backwards compatibility will be maintained.
- Due to Wiki software limitations, the syntax for NiAVObjectSetLocalRotationTEMP cannot be written on one line. Furthermore, it would be hideous to attempt to read that way in any case. However, the CS requires that all 11 arguments appear on a single line.