GEOMETRY commands


PROGRAM NAME

gresample - First-order resizing of value segment.

DESCRIPTION

gresample will perform a first-order (bi-,tri-,quad-linear) interpolation of the value segment of the data object. All other segments are copied over "as is." This may present a problem when a curvilinear grid is present. Linear interpolation of location data will appear in a future version of this code.

Note that we provide interpolation (in the value segment) only over width, height, depth and time. The value of elements remains unchanged by this operation.

The reason that one would use this routine is to size textures for use by the renderer. OpenGL requires that textures be an even power of two in size in both width, height (and depth if appropriate). This routine is the one you'll use to size the textures.

REQUIRED ARGUMENTS

-i
type: infile
desc: First Input data object
-o
type: outfile
desc: Resulting output data object

Mutually Exclusive Group; you must specify ONE of:

ALL OF the Mutually Inclusive Group:

-w_abs
type: float
desc: The size of the width dimension will be set to this amount, unless you specify zero, which means the output will be the same size as the input.
default: 0
bounds: no range checking
AND
-h_abs
type: float
desc: The size of the height dimension will be set to this amount, unless you specify zero, which means the output will be the same size as the input.
default: 0
bounds: no range checking
AND
-d_abs
type: float
desc: The size of the depth dimension will be set to this amount unless you specify zero, which means the output will be the same size as the input
default: 0
bounds: no range checking
AND
-t_abs
type: float
desc: The size of the time dimension will be set to this value (unless you specify a zero, which means the output will be the same size as the input).
default: 0
bounds: no range checking

ALL OF the Mutually Inclusive Group:

-w
type: float
desc: Width dimension will be scaled by this amount.
default: 1
bounds: no range checking
AND
-h
type: float
desc: Height dimension will be scaled by this amount.
default: 1
bounds: no range checking
AND
-d
type: float
desc: Depth dimension will be scaled by this amount.
default: 1
bounds: no range checking
AND
-t
type: float
desc: Time dimension will be scaled by this amount.
default: 1
bounds: no range checking

OPTIONAL ARGUMENTS

-cmode
type: list
desc: Will choose between either a data-services processing mode (slow, but for large objects) or an in-memory-mode (fast) for smaller objects.
default: 2 "(Fast) In-Memory, small objects."

EXAMPLES

SEE ALSO

RESTRICTIONS

This operator works ONLY on regular KDF files. It does NOT work on objects once they are turned into geometry texture objects.

REFERENCES

COPYRIGHT

Copyright (C) 1996,1997 , The Regents of the University of California. All rights reserved.