wxErlang

Reference Manual

Version 1.9

Table of Contents

glu

Module

glu

Module Summary

A part of the standard OpenGL Utility api.

Description

A part of the standard OpenGL Utility api. See www.khronos.org

Booleans are represented by integers 0 and 1.

DATA TYPES

enum() = non_neg_integer()

See wx/include/gl.hrl or glu.hrl

matrix() = matrix12() | matrix16()

matrix12() = {float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float()}

matrix16() = {float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float(), float()}

mem() = binary() | tuple()

Memory block

vertex() = {float(), float(), float()}

Exports

Types

Normal = vertex()
Vs = vertex()
Triangles = [integer()]
VertexPos = binary()

General purpose polygon triangulation. The first argument is the normal and the second a list of vertex positions. Returned is a list of indecies of the vertices and a binary (64bit native float) containing an array of vertex positions, it starts with the vertices in Vs and may contain newly created vertices in the end.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Format = enum()
Type = enum()
Level = integer()
Base = integer()
Max = integer()
Data = binary()

Builds a subset of one-dimensional mipmap levels

glu:build1DMipmapLevels builds a subset of prefiltered one-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture mapped primitives.

See external documentation.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Format = enum()
Type = enum()
Data = binary()

Builds a one-dimensional mipmap

glu:build1DMipmaps builds a series of prefiltered one-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture mapped primitives.

See external documentation.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Height = integer()
Format = enum()
Type = enum()
Level = integer()
Base = integer()
Max = integer()
Data = binary()

Builds a subset of two-dimensional mipmap levels

glu:build2DMipmapLevels builds a subset of prefiltered two-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture mapped primitives.

See external documentation.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Height = integer()
Format = enum()
Type = enum()
Data = binary()

Builds a two-dimensional mipmap

glu:build2DMipmaps builds a series of prefiltered two-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture-mapped primitives.

See external documentation.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Height = integer()
Depth = integer()
Format = enum()
Type = enum()
Level = integer()
Base = integer()
Max = integer()
Data = binary()

Builds a subset of three-dimensional mipmap levels

glu:build3DMipmapLevels builds a subset of prefiltered three-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture mapped primitives.

See external documentation.

Types

Target = enum()
InternalFormat = integer()
Width = integer()
Height = integer()
Depth = integer()
Format = enum()
Type = enum()
Data = binary()

Builds a three-dimensional mipmap

glu:build3DMipmaps builds a series of prefiltered three-dimensional texture maps of decreasing resolutions called a mipmap. This is used for the antialiasing of texture-mapped primitives.

See external documentation.

Types

ExtName = string()
ExtString = string()

Determines if an extension name is supported

glu:checkExtension returns ?GLU_TRUE if ExtName is supported otherwise ?GLU_FALSE is returned.

See external documentation.

Types

Quad = integer()
Base = float()
Top = float()
Height = float()
Slices = integer()
Stacks = integer()

Draw a cylinder

glu:cylinder draws a cylinder oriented along the z axis. The base of the cylinder is placed at z = 0 and the top at z=height. Like a sphere, a cylinder is subdivided around the z axis into slices and along the z axis into stacks.

See external documentation.

Types

Quad = integer()

Destroy a quadrics object

glu:deleteQuadric destroys the quadrics object (created with glu:newQuadric/0 ) and frees any memory it uses. Once glu:deleteQuadric has been called, Quad cannot be used again.

See external documentation.

Types

Quad = integer()
Inner = float()
Outer = float()
Slices = integer()
Loops = integer()

Draw a disk

glu:disk renders a disk on the z = 0 plane. The disk has a radius of Outer and contains a concentric circular hole with a radius of Inner . If Inner is 0, then no hole is generated. The disk is subdivided around the z axis into slices (like pizza slices) and also about the z axis into rings (as specified by Slices and Loops , respectively).

See external documentation.

Types

Error = enum()

Produce an error string from a GL or GLU error code

glu:errorString produces an error string from a GL or GLU error code. The string is in ISO Latin 1 format. For example, glu:errorString(?GLU_OUT_OF_MEMORY) returns the string out of memory.

See external documentation.

Types

Name = enum()

Return a string describing the GLU version or GLU extensions

glu:getString returns a pointer to a static string describing the GLU version or the GLU extensions that are supported.

See external documentation.

Types

EyeX = float()
EyeY = float()
EyeZ = float()
CenterX = float()
CenterY = float()
CenterZ = float()
UpX = float()
UpY = float()
UpZ = float()

Define a viewing transformation

glu:lookAt creates a viewing matrix derived from an eye point, a reference point indicating the center of the scene, and an UP vector.

See external documentation.

Create a quadrics object

glu:newQuadric creates and returns a pointer to a new quadrics object. This object must be referred to when calling quadrics rendering and control functions. A return value of 0 means that there is not enough memory to allocate the object.

See external documentation.

Types

Left = float()
Right = float()
Bottom = float()
Top = float()

Define a 2D orthographic projection matrix

glu:ortho2D sets up a two-dimensional orthographic viewing region. This is equivalent to calling gl:ortho/6 with near=-1 and far=1.

See external documentation.

Types

Quad = integer()
Inner = float()
Outer = float()
Slices = integer()
Loops = integer()
Start = float()
Sweep = float()

Draw an arc of a disk

glu:partialDisk renders a partial disk on the z=0 plane. A partial disk is similar to a full disk, except that only the subset of the disk from Start through Start + Sweep is included (where 0 degrees is along the +f2yf axis, 90 degrees along the +x axis, 180 degrees along the -y axis, and 270 degrees along the -x axis).

See external documentation.

Types

Fovy = float()
Aspect = float()
ZNear = float()
ZFar = float()

Set up a perspective projection matrix

glu:perspective specifies a viewing frustum into the world coordinate system. In general, the aspect ratio in glu:perspective should match the aspect ratio of the associated viewport. For example, aspect=2.0 means the viewer's angle of view is twice as wide in x as it is in y. If the viewport is twice as wide as it is tall, it displays the image without distortion.

See external documentation.

Types

X = float()
Y = float()
DelX = float()
DelY = float()
Viewport = {integer(), integer(), integer(), integer()}

Define a picking region

glu:pickMatrix creates a projection matrix that can be used to restrict drawing to a small region of the viewport. This is typically useful to determine what objects are being drawn near the cursor. Use glu:pickMatrix to restrict drawing to a small region around the cursor. Then, enter selection mode (with gl:renderMode/1 ) and rerender the scene. All primitives that would have been drawn near the cursor are identified and stored in the selection buffer.

See external documentation.

Types

ObjX = float()
ObjY = float()
ObjZ = float()
Model = matrix()
Proj = matrix()
View = {integer(), integer(), integer(), integer()}

Map object coordinates to window coordinates

glu:project transforms the specified object coordinates into window coordinates using Model , Proj , and View . The result is stored in WinX , WinY , and WinZ . A return value of ?GLU_TRUE indicates success, a return value of ?GLU_FALSE indicates failure.

See external documentation.

Types

Quad = integer()
Draw = enum()

Specify the draw style desired for quadrics

glu:quadricDrawStyle specifies the draw style for quadrics rendered with Quad . The legal values are as follows:

See external documentation.

Types

Quad = integer()
Normal = enum()

Specify what kind of normals are desired for quadrics

glu:quadricNormals specifies what kind of normals are desired for quadrics rendered with Quad . The legal values are as follows:

See external documentation.

Types

Quad = integer()
Orientation = enum()

Specify inside/outside orientation for quadrics

glu:quadricOrientation specifies what kind of orientation is desired for quadrics rendered with Quad . The Orientation values are as follows:

See external documentation.

Types

Quad = integer()
Texture = 0 | 1

Specify if texturing is desired for quadrics

glu:quadricTexture specifies if texture coordinates should be generated for quadrics rendered with Quad . If the value of Texture is ?GLU_TRUE, then texture coordinates are generated, and if Texture is ?GLU_FALSE, they are not. The initial value is ?GLU_FALSE.

See external documentation.

Types

Format = enum()
WIn = integer()
HIn = integer()
TypeIn = enum()
DataIn = binary()
WOut = integer()
HOut = integer()
TypeOut = enum()
DataOut = mem()

Scale an image to an arbitrary size

glu:scaleImage scales a pixel image using the appropriate pixel store modes to unpack data from the source image and pack data into the destination image.

See external documentation.

Types

Quad = integer()
Radius = float()
Slices = integer()
Stacks = integer()

Draw a sphere

glu:sphere draws a sphere of the given radius centered around the origin. The sphere is subdivided around the z axis into slices and along the z axis into stacks (similar to lines of longitude and latitude).

See external documentation.

Types

WinX = float()
WinY = float()
WinZ = float()
Model = matrix()
Proj = matrix()
View = {integer(), integer(), integer(), integer()}

Map window coordinates to object coordinates

glu:unProject maps the specified window coordinates into object coordinates using Model , Proj , and View . The result is stored in ObjX , ObjY , and ObjZ . A return value of ?GLU_TRUE indicates success; a return value of ?GLU_FALSE indicates failure.

See external documentation.

Types

WinX = float()
WinY = float()
WinZ = float()
ClipW = float()
Model = matrix()
Proj = matrix()
View = {integer(), integer(), integer(), integer()}
NearVal = float()
FarVal = float()