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)