GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
vpTranspose(3) FreeBSD Library Functions Manual vpTranspose(3)

vpTranspose - transpose a volume

#include <volpack.h>
vpResult
vpTranspose(vpc, axis)
vpContext *vpc;
int axis;

vpc
VolPack context from vpCreateContext.
axis
Axis which should have the smallest stride after transposing (VP_X_AXIS, VP_Y_AXIS or VP_Z_AXIS).

vpTranspose is used to transpose the 3D voxel array to optimize the memory stride for a particular principal viewing axis. The intended way to use this function is to set the viewing transformation, call vpGeti with the VP_VIEW_AXIS argument to find the corresponding viewing axis, and then call vpTranspose with that axis. Transposing the data changes the arrangement of the data stored in the 3D voxel array. The voxel stride state variables are updated to reflect this change, so the viewing transformation does not need to be changed after transposing. If the volume is already transposed for the requested axis then it returns immediately without modifying the voxel array.
This function is useful only for rendering large 3D voxel arrays. This function has no affect on the preclassified volume data.

Relevant variables may be retrieved with the following state variable codes (see vpGeti(3)): VP_VIEW_AXIS, VP_VOXEL_XSTRIDE, VP_VOXEL_YSTRIDE, VP_VOXEL_ZSTRIDE.

The normal return value is VP_OK. The following error return values are possible:
VPERROR_BAD_OPTION
The axis argument is invalid.
VPERROR_BAD_VOLUME
The 3D voxel array is missing or invalid.
VPERROR_BAD_VOXEL
The voxel fields are incorrectly specified.

VolPack(3), vpCreateContext(3)
VolPack

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.