Logo Search packages:      
Sourcecode: openexr version File versions  Download package

ImfTiledRgbaFile.h

///////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2004, Industrial Light & Magic, a division of Lucas
// Digital Ltd. LLC
// 
// All rights reserved.
// 
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
// *       Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// *       Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// *       Neither the name of Industrial Light & Magic nor the names of
// its contributors may be used to endorse or promote products derived
// from this software without specific prior written permission. 
// 
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
//
///////////////////////////////////////////////////////////////////////////


#ifndef INCLUDED_IMF_TILED_RGBA_FILE_H
#define INCLUDED_IMF_TILED_RGBA_FILE_H

//-----------------------------------------------------------------------------
//
//    Simplified RGBA image I/O for tiled files
//
//    class TiledRgbaOutputFile
//    class TiledRgbaInputFile
//
//-----------------------------------------------------------------------------

#include <ImfHeader.h>
#include <ImfFrameBuffer.h>
#include <ImathVec.h>
#include <ImathBox.h>
#include <half.h>
#include <ImfTileDescription.h>
#include <ImfRgba.h>

namespace Imf {

class TiledOutputFile;
class TiledInputFile;
struct PreviewRgba;


//
// Tiled RGBA output file.
//

00067 class TiledRgbaOutputFile
{
  public:

    //---------------------------------------------------
    // Constructor -- rgbaChannels, tileXSize, tileYSize,
    // levelMode, and levelRoundingMode overwrite the
    // channel list and tile description attribute in the
    // header that is passed as an argument to the
    // constructor.
    //---------------------------------------------------

    TiledRgbaOutputFile (const char name[],
                   const Header &header,
                   RgbaChannels rgbaChannels,
                   int tileXSize,
                   int tileYSize,
                   LevelMode mode,
                   LevelRoundingMode rmode = ROUND_DOWN);


    //---------------------------------------------------
    // Constructor -- like the previous one, but the new
    // TiledRgbaOutputFile is attached to a file that has
    // already been opened by the caller.  Destroying
    // TiledRgbaOutputFileObjects constructed with this
    // constructor does not automatically close the
    // corresponding files.
    //---------------------------------------------------

    TiledRgbaOutputFile (OStream &os,
                   const Header &header,
                   RgbaChannels rgbaChannels,
                   int tileXSize,
                   int tileYSize,
                   LevelMode mode,
                   LevelRoundingMode rmode = ROUND_DOWN);


    //------------------------------------------------------
    // Constructor -- header data are explicitly specified
    // as function call arguments (an empty dataWindow means
    // "same as displayWindow")
    //------------------------------------------------------

    TiledRgbaOutputFile (const char name[],
                   int tileXSize,
                   int tileYSize,
                   LevelMode mode,
                   LevelRoundingMode rmode,
                   const Imath::Box2i &displayWindow,
                   const Imath::Box2i &dataWindow = Imath::Box2i(),
                   RgbaChannels rgbaChannels = WRITE_RGBA,
                   float pixelAspectRatio = 1,
                   const Imath::V2f screenWindowCenter =
                                        Imath::V2f (0, 0),
                   float screenWindowWidth = 1,
                   LineOrder lineOrder = INCREASING_Y,
                   Compression compression = ZIP_COMPRESSION);


    //-----------------------------------------------
    // Constructor -- like the previous one, but both
    // the display window and the data window are
    // Box2i (V2i (0, 0), V2i (width - 1, height -1))
    //-----------------------------------------------

    TiledRgbaOutputFile (const char name[],
                   int width,
                   int height,
                   int tileXSize,
                   int tileYSize,
                   LevelMode mode,
                   LevelRoundingMode rmode = ROUND_DOWN,
                   RgbaChannels rgbaChannels = WRITE_RGBA,
                   float pixelAspectRatio = 1,
                   const Imath::V2f screenWindowCenter =
                                        Imath::V2f (0, 0),
                   float screenWindowWidth = 1,
                   LineOrder lineOrder = INCREASING_Y,
                   Compression compression = ZIP_COMPRESSION);


    virtual ~TiledRgbaOutputFile ();


    //------------------------------------------------
    // Define a frame buffer as the pixel data source:
    // Pixel (x, y) is at address
    //
    //  base + x * xStride + y * yStride
    //
    //------------------------------------------------

    void          setFrameBuffer (const Rgba *base,
                              size_t xStride,
                              size_t yStride);

    //--------------------------
    // Access to the file header
    //--------------------------

    const Header &            header () const;
    const FrameBuffer &       frameBuffer () const;
    const Imath::Box2i &      displayWindow () const;
    const Imath::Box2i &      dataWindow () const;
    float               pixelAspectRatio () const;
    const Imath::V2f          screenWindowCenter () const;
    float               screenWindowWidth () const;
    LineOrder                 lineOrder () const;
    Compression               compression () const;
    RgbaChannels        channels () const;


    //----------------------------------------------------
    // Utility functions (same as in Imf::TiledOutputFile)
    //----------------------------------------------------

    unsigned int  tileXSize () const;
    unsigned int  tileYSize () const;
    LevelMode           levelMode () const;
    LevelRoundingMode   levelRoundingMode () const;

    int                 numLevels () const;
    int                 numXLevels () const;
    int                 numYLevels () const;
    bool          isValidLevel (int lx, int ly) const;

    int                 levelWidth  (int lx) const;
    int                 levelHeight (int ly) const;

    int                 numXTiles (int lx = 0) const;
    int                 numYTiles (int ly = 0) const;

    Imath::Box2i  dataWindowForLevel (int l = 0) const;
    Imath::Box2i  dataWindowForLevel (int lx, int ly) const;

    Imath::Box2i  dataWindowForTile (int dx, int dy,
                                 int l = 0) const;

    Imath::Box2i  dataWindowForTile (int dx, int dy,
                                 int lx, int ly) const;

    //------------------------------------------------------------------
    // Write pixel data:
    //
    // writeTile(dx, dy, lx, ly) writes the tile with tile
    // coordinates (dx, dy), and level number (lx, ly) to
    // the file.
    //
    //   dx must lie in the interval [0, numXTiles(lx)-1]
    //   dy must lie in the interval [0, numYTiles(ly)-1]
    //
    //   lx must lie in the interval [0, numXLevels()-1]
    //   ly must lie in the inverval [0, numYLevels()-1]
    //
    // writeTile(dx, dy, level) is a convenience function
    // used for ONE_LEVEL and MIPMAP_LEVEL files.  It calls
    // writeTile(dx, dy, level, level).
    //
    // Pixels that are outside the pixel coordinate range for the tile's
    // level, are never accessed by writeTile().
    //
    // Each tile in the file must be written exactly once.
    //
    //------------------------------------------------------------------

    void                writeTile (int dx, int dy, int l = 0);
    void                writeTile (int dx, int dy, int lx, int ly);


    // -------------------------------------------------------------------------
    // Update the preview image (see Imf::TiledOutputFile::updatePreviewImage())
    // -------------------------------------------------------------------------

    void                updatePreviewImage (const PreviewRgba[]);

  private:

    //
    // Copy constructor and assignment are not implemented
    //

    TiledRgbaOutputFile (const TiledRgbaOutputFile &);      
    TiledRgbaOutputFile & operator = (const TiledRgbaOutputFile &);

    class ToYa;

    TiledOutputFile *            _outputFile;
    ToYa *              _toYa;
};



//
// Tiled RGBA input file
//

00265 class TiledRgbaInputFile
{
  public:

    //--------------------------------------------------------
    // Constructor -- opens the file with the specified name.
    // Destroying TiledRgbaInputFile objects constructed with
    // this constructor automatically closes the corresponding
    // files.
    //--------------------------------------------------------

    TiledRgbaInputFile (const char name[]);


    //-------------------------------------------------------
    // Constructor -- attaches the new TiledRgbaInputFile
    // object to a file that has already been opened by the
    // caller.
    // Destroying TiledRgbaInputFile objects constructed with
    // this constructor does not automatically close the
    // corresponding files.
    //-------------------------------------------------------

    TiledRgbaInputFile (IStream &is);


    //-----------
    // Destructor
    //-----------

    virtual ~TiledRgbaInputFile ();


    //-----------------------------------------------------
    // Define a frame buffer as the pixel data destination:
    // Pixel (x, y) is at address
    //
    //  base + x * xStride + y * yStride
    //
    //-----------------------------------------------------

    void                setFrameBuffer (Rgba *base,
                                    size_t xStride,
                                    size_t yStride);

    //--------------------------
    // Access to the file header
    //--------------------------

    const Header &            header () const;
    const FrameBuffer &       frameBuffer () const;
    const Imath::Box2i &      displayWindow () const;
    const Imath::Box2i &      dataWindow () const;
    float               pixelAspectRatio () const;
    const Imath::V2f          screenWindowCenter () const;
    float               screenWindowWidth () const;
    LineOrder                 lineOrder () const;
    Compression               compression () const;
    RgbaChannels        channels () const;
    const char *                fileName () const;
    bool                isComplete () const;

    //----------------------------------
    // Access to the file format version
    //----------------------------------

    int                       version () const;


    //---------------------------------------------------
    // Utility functions (same as in Imf::TiledInputFile)
    //---------------------------------------------------

    unsigned int  tileXSize () const;
    unsigned int  tileYSize () const;
    LevelMode           levelMode () const;
    LevelRoundingMode   levelRoundingMode () const;

    int                 numLevels () const;
    int                 numXLevels () const;
    int                 numYLevels () const;
    bool          isValidLevel (int lx, int ly) const;

    int                 levelWidth  (int lx) const;
    int                 levelHeight (int ly) const;

    int                 numXTiles (int lx = 0) const;
    int                 numYTiles (int ly = 0) const;

    Imath::Box2i  dataWindowForLevel (int l = 0) const;
    Imath::Box2i  dataWindowForLevel (int lx, int ly) const;

    Imath::Box2i  dataWindowForTile (int dx, int dy,
                                 int l = 0) const;

    Imath::Box2i  dataWindowForTile (int dx, int dy,
                                 int lx, int ly) const;
                                 

    //----------------------------------------------------------------
    // Read pixel data:
    //
    // readTile(dx, dy, lx, ly) reads the tile with tile
    // coordinates (dx, dy), and level number (lx, ly),
    // and stores it in the current frame buffer.
    //
    //   dx must lie in the interval [0, numXTiles(lx)-1]
    //   dy must lie in the interval [0, numYTiles(ly)-1]
    //
    //   lx must lie in the interval [0, numXLevels()-1]
    //   ly must lie in the inverval [0, numYLevels()-1]
    //
    // readTile(dx, dy, level) is a convenience function used
    // for ONE_LEVEL and MIPMAP_LEVELS files.  It calls
    // readTile(dx, dy, level, level).
    //
    // Pixels that are outside the pixel coordinate range for the
    // tile's level, are never accessed by readTile().
    //
    // Attempting to access a tile that is not present in the file
    // throws an InputExc exception.
    //
    //----------------------------------------------------------------

    void                 readTile (int dx, int dy, int l = 0);
    void                 readTile (int dx, int dy, int lx, int ly);

  private:

    //
    // Copy constructor and assignment are not implemented
    //

    TiledRgbaInputFile (const TiledRgbaInputFile &);
    TiledRgbaInputFile & operator = (const TiledRgbaInputFile &);

    class FromYa;

    TiledInputFile *    _inputFile;
    FromYa *            _fromYa;
};


} // namespace Imf

#endif

Generated by  Doxygen 1.6.0   Back to index