NAME

       icetPhysicalRenderSize -- set the size of images that are rendered

Synopsis

       #include <IceT.h>

       void icetPhysicalRenderSize(   IceTInt   width,
                                      IceTInt   height  );

Description

       Specify the size of images that are rendered with icetPhysicalRenderSize.  This is the size of image that
       is  expected to be rendered by the draw callback (specified with icetDrawCallback).  The width and height
       are captured in the ICET_PHYSICAL_RENDER_WIDTH and ICET_PHYSICAL_RENDER_HEIGHT state variables.

       The size of images that are rendered do not have to be the same size as the tile they  are  rendering  so
       long  as  they are not smaller in any dimension. In fact, when rendering multiple tiles it can often save
       time to render larger images. Nevertheless, by default the physical render size is set to the size of the
       tiles in icetAddTile because this is the most common use case.

       When using the OpenGL rendering layer, the physical rendering size is  overridden  to  the  size  of  the
       OpenGL viewport in each call to icetGLDrawFrame.

Errors

       None.

Warnings

       ICET_INVALID_VALUE
               The width or height specified is smaller than that for the largest tile.

Bugs

       None known.

Copyright

       Copyright (C)2010 Sandia Corporation

       Under  the  terms  of  Contract  DE-AC04-94AL85000  with  Sandia Corporation, the U.S. Government retains
       certain rights in this software.

       This source code is released under the New BSD License.

See Also

       icetAddTile(3)

IceT Reference                                   August  9, 2010                       icetPhysicalRenderSize(3)