Difference between revisions of "NiAVObjectSetLocalRotation"

From the Oblivion ConstructionSet Wiki
Jump to navigation Jump to search
imported>DragoonWraith
imported>DragoonWraith
Line 27: Line 27:
   
   
   let locRot := MatrixMultiply R locRot ; order matters
   let locRot := MatrixMultiply R locRot ; order matters
 
   ; for clarity, using NiAVObjectSetLocalRotation.
   ; for clarity, using NiAVObjectSetLocalRotation.
   ; as noted below, this function does not yet exist,
   ; as noted below, this function does not yet exist,

Revision as of 14:52, 29 August 2010

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.

See Also


External Links