icetEnable/Disable(3)

NAME
icetEnable, icetDisable - enable/disable an ICE-T feature.

SYNOPSIS
#include <GL/ice-t.h>

void icetEnable(GLenum pname);
void icetDisable(GLenum pname);

DESCRIPTION
The icetEnable and icetDisable functions turn various ICE-T features on and off. pname is a symbolic constant representing the feature to be turned on or off. Valid values for pname are:

ICET_CORRECT_COLORED_BACKGROUND
    Colored backgrounds are problematic when performing color blended compositing in that the background color will be additively blended from each image. Enabling this flag will internally cause the color to be reset to black and then cause the color to be blended back into the resulting images. This flag is disabled by default.

ICET_DISPLAY
    If enabled, the final, composited image for each tile is written back to the frame buffer before the return of icetDrawFrame. This flag is enabled by default.

ICET_DISPLAY_COLORED_BACKGROUND
    If this and ICET_DISPLAY are enabled, uses OpenGL blending to ensure that all background is set to the correct color. This flag is disabled by default. This option does not affect the images returned from icetGetColorBuffer or icetGetDepthBuffer; it only affects the image in the OpenGL color buffer.

ICET_DISPLAY_INFLATE
    If this and ICET_DISPLAY are enabled and the renderable window is larger then the displayed tile (as determined by the current OpenGL viewport), then resample the image to fit within the renderable window before writing back to frame buffer. This flag is disabled by default. This option does not affect the images returned from icetGetColorBuffer or icetGetDepthBuffer; it only affects the image in the OpenGL color buffer.

ICET_DISPLAY_INFLATE_WITH_HARDWARE
    This option determines how images are inflated. When enabled (the default), images are inflated by creating a texture and allowing the hardware the inflate the image. When disabled, images are inflated on the CPU. This option has no effect unless both ICET_DISPLAY and ICET_DISPLAY_INFLATE are also enabled.

ICET_FLOATING_VIEWPORT
    If enabled, the projection will be shifted such that the geometry will be rendered in one shot whenever possible, even if the geometry straddles up to four tiles. This flag is enabled by default.

ICET_ORDERED_COMPOSITE
    If enabled, the image composition will be performed in the order specified by the last call to icetCompositeOrder, assuming the current strategy (specified by a call to icetStrategy) supports ordered composition. Generally, you want to enable ordered compositing if doing color blending and disable if you are doing z-buffer comparisons. If enabled, you should call icetCompositeOrder between each frame to update the image order as camera angles change. This flag is disabled by default.

ERRORS

ICET_INVALID_VALUE
    If pname is not a feature to be enabled or disabled.

WARNINGS
None.

BUGS
The check for a valid pname is not thorough, and thus the ICET_INVALID_VALUE error may not always be raised.

COPYRIGHT
Copyright © 2003 Sandia Corporation
Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive license for use of this work by or on behalf of the U.S. Government. Redistribution and use in source and binary forms, with or without modification, are permitted provided that this Notice and any statement of authorship are reproduced on all copies.

SEE ALSO
icetIsEnabled