jit.gl.texture Manages a GL texture

The jit.gl.texture object creates an OpenGL texture from a jit.matrix object with less than 4 planes and fewer than 3 dimensions. Multiple jit.gl.texture objects can be attached to any OB3D thru the OB3D texture method. If the texture is attached to an OB3D, the OB3D will automatically bind the jit.gl.texture object as needed. The jit.gl.texture object requires one argument: the name of a drawing context. A named drawing context is a named instance of a jit.window, jit.pwindow, or jit.matrix object that has an instance of the jit.gl.render object associated with it. This value may also be set via the OB3D drawto attribute.

GL Group

Attributes:
Name Type Description
dim long list[3] The dimensions for the jit.gl.texture object (default = 256 256 0)
type symbol The name of the datatype to use. (default = auto) Supported modes are:
auto (adapt to matrix datatype)
char (8bit unsigned byte)
long (32bit integer)
half (16bit float)
float (32bit float)
float16 (16bit float)
float32 (32bit float)
colormode symbol The colorspace mode to use. (default = auto) Supported modes are:
alpha
depth
intensity
luminance
lumalpha
rgb
argb
uyvy
auto
file symbol The image or movie file to load (default = none)
compress symbol The hardware accelerated compression codec to use. (default = none) Supported codecs are:
none
dxt1
dxt3
dxt5
mode symbol The update mode to use. (default = auto) Supported modes are:
dynamic
static
capture
apply symbol The apply mode to use. (default = auto) Supported modes are:
replace
decal
modulate
blend
combine
rectangle long Flag to enable or disable using a rectangular texture target (default = 1)
If enabled, certain texture attribute settings may not be available depending on the capabilities of your graphics hardware (eg wrap = repeat).
correction symbol The correction mode to use. (default = fastest) Supported modes are:
fastest
nicest
filter symbol The filter mode to use. (default = none) Supported modes are:
none
nearest
linear
mipmap symbol The mipmap interpolation mode to use. (default = none) Supported modes are:
none
nearest
linear
bilinear
trilinear
texgen symbol The texture coordinate generation mode to use. (default = none) Supported modes are:
none objectspace
eyespace
environment
projected
wrap symbol list[3] The wrap mode to use. (default = fastest) Supported modes are:
clamp
repeat
clampedge
clampborder
mirroredrepeat
function symbol list[2] The combine function to use for both source and destination textures (only when apply == combine). (default = fastest) Supported modes are:
replace
modulate
add
addsigned
subtract
interpolate
dot3rgb
dot3rgba
weight long list[2] The weight factors for combining both source and destination textures (only when apply == combine). (default = 1.0 1.0)
offset long list[3] The dimensional offsets for submitting texture data. (default = 0 0 0)
source symbol list[6] The source targets to use for both source and destination textures (only when apply == combine). (default = fastest) Supported modes are:
texture
color
constant
previous
operand symbol,6 list[6] The operand to use for both source and destination textures (only when apply == combine). (default = fastest) Supported modes are:
color
oneminuscolor
alpha
oneminusalpha
bordercolor float32 list[4] The rgba coefficients for the border color. (default = 0 0 0 0)
blendcolor float32 list[4] The rgba coefficients for the blend color. (default = 0 0 0 0)
anisotropy long list[4] The anisotropic filter width. (default = 0)
priority long list[4] The priority hint for informing the graphics driver how to manage the texture cache. (default = 0)
flip long list[4] Flag to enable or disable vertically flipping the texture data to account for the lower-left origin in OpenGL (default = 1).
debug long list[4] Flag to enable or disable debug mode to draw a textured quad (default = 0).
autoscale long list[4] Flag to enable or disable automatically scaling the texture coordinates for non-uniform texture targets (default = 1).
share long list[4] Flag to enable or disable sharing texture data across multiple OpenGL contexts (default = 1).
defaultimage symbol list[4] The default image to generate if a jit.matrix object is not attached to the left-most inlet. (default = checker) Supported modes are:
checker
black
white

Messages:
read [filename (symbol)]
Loads the given image or movie from disk.

bind
Manually binds the texture object.

unbind
Manually unbinds the texture object.

begin_capture
Manually forces the texture to start capturing the contents of the OpenGL framebuffer.

end_capture
Manually forces the texture to stop capturing the contents of the OpenGL framebuffer.

jit_matrix [name (symbol)]
Updates the texture to use the jit.matrix object with the given name.

tomatrix [name (symbol)]
Updates the jit.matrix object with the data contained inside the jit.gl.texture object.

Example:

See Also:
jit.gl.graph, jit.gl.gridshape, jit.gl.handle, jit.gl.isosurf, jit.gl.mesh, jit.gl.model, jit.gl.nurbs, jit.gl.plato, jit.gl.render, jit.gl.shader, jit.gl.sketch, jit.gl.slab, jit.gl.text2d, jit.gl.text3d, jit.gl.videoplane, jit.gl.volume