/src/FreeImage/Source/OpenEXR/IlmImf/ImfOutputFile.h
https://bitbucket.org/cabalistic/ogredeps/ · C++ Header · 241 lines · 34 code · 53 blank · 154 comment · 0 complexity · 718629cebaec7b04057c6de1e9921e60 MD5 · raw file
- ///////////////////////////////////////////////////////////////////////////
- //
- // 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_OUTPUT_FILE_H
- #define INCLUDED_IMF_OUTPUT_FILE_H
- //-----------------------------------------------------------------------------
- //
- // class OutputFile
- //
- //-----------------------------------------------------------------------------
- #include <ImfHeader.h>
- #include <ImfFrameBuffer.h>
- #include <ImfThreading.h>
- namespace Imf {
- class InputFile;
- struct PreviewRgba;
- class OutputFile
- {
- public:
- //-----------------------------------------------------------
- // Constructor -- opens the file and writes the file header.
- // The file header is also copied into the OutputFile object,
- // and can later be accessed via the header() method.
- // Destroying this OutputFile object automatically closes
- // the file.
- //
- // numThreads determines the number of threads that will be
- // used to write the file (see ImfThreading.h).
- //-----------------------------------------------------------
- OutputFile (const char fileName[], const Header &header,
- int numThreads = globalThreadCount());
- //------------------------------------------------------------
- // Constructor -- attaches the new OutputFile object to a file
- // that has already been opened, and writes the file header.
- // The file header is also copied into the OutputFile object,
- // and can later be accessed via the header() method.
- // Destroying this OutputFile object does not automatically
- // close the file.
- //
- // numThreads determines the number of threads that will be
- // used to write the file (see ImfThreading.h).
- //------------------------------------------------------------
- OutputFile (OStream &os, const Header &header,
- int numThreads = globalThreadCount());
- //-------------------------------------------------
- // Destructor
- //
- // Destroying the OutputFile object before writing
- // all scan lines within the data window results in
- // an incomplete file.
- //-------------------------------------------------
- virtual ~OutputFile ();
- //------------------------
- // Access to the file name
- //------------------------
- const char * fileName () const;
- //--------------------------
- // Access to the file header
- //--------------------------
- const Header & header () const;
- //-------------------------------------------------------
- // Set the current frame buffer -- copies the FrameBuffer
- // object into the OutputFile object.
- //
- // The current frame buffer is the source of the pixel
- // data written to the file. The current frame buffer
- // must be set at least once before writePixels() is
- // called. The current frame buffer can be changed
- // after each call to writePixels.
- //-------------------------------------------------------
- void setFrameBuffer (const FrameBuffer &frameBuffer);
- //-----------------------------------
- // Access to the current frame buffer
- //-----------------------------------
- const FrameBuffer & frameBuffer () const;
- //-------------------------------------------------------------------
- // Write pixel data:
- //
- // writePixels(n) retrieves the next n scan lines worth of data from
- // the current frame buffer, starting with the scan line indicated by
- // currentScanLine(), and stores the data in the output file, and
- // progressing in the direction indicated by header.lineOrder().
- //
- // To produce a complete and correct file, exactly m scan lines must
- // be written, where m is equal to
- // header().dataWindow().max.y - header().dataWindow().min.y + 1.
- //-------------------------------------------------------------------
- void writePixels (int numScanLines = 1);
- //------------------------------------------------------------------
- // Access to the current scan line:
- //
- // currentScanLine() returns the y coordinate of the first scan line
- // that will be read from the current frame buffer during the next
- // call to writePixels().
- //
- // If header.lineOrder() == INCREASING_Y:
- //
- // The current scan line before the first call to writePixels()
- // is header().dataWindow().min.y. After writing each scan line,
- // the current scan line is incremented by 1.
- //
- // If header.lineOrder() == DECREASING_Y:
- //
- // The current scan line before the first call to writePixels()
- // is header().dataWindow().max.y. After writing each scan line,
- // the current scan line is decremented by 1.
- //
- //------------------------------------------------------------------
- int currentScanLine () const;
- //--------------------------------------------------------------
- // Shortcut to copy all pixels from an InputFile into this file,
- // without uncompressing and then recompressing the pixel data.
- // This file's header must be compatible with the InputFile's
- // header: The two header's "dataWindow", "compression",
- // "lineOrder" and "channels" attributes must be the same.
- //--------------------------------------------------------------
- void copyPixels (InputFile &in);
- //--------------------------------------------------------------
- // Updating the preview image:
- //
- // updatePreviewImage() supplies a new set of pixels for the
- // preview image attribute in the file's header. If the header
- // does not contain a preview image, updatePreviewImage() throws
- // an Iex::LogicExc.
- //
- // Note: updatePreviewImage() is necessary because images are
- // often stored in a file incrementally, a few scan lines at a
- // time, while the image is being generated. Since the preview
- // image is an attribute in the file's header, it gets stored in
- // the file as soon as the file is opened, but we may not know
- // what the preview image should look like until we have written
- // the last scan line of the main image.
- //
- //--------------------------------------------------------------
- void updatePreviewImage (const PreviewRgba newPixels[]);
- //---------------------------------------------------------
- // Break a scan line -- for testing and debugging only:
- //
- // breakScanLine(y,p,n,c) introduces an error into the
- // output file by writing n copies of character c, starting
- // p bytes from the beginning of the pixel data block that
- // contains scan line y.
- //
- // Warning: Calling this function usually results in a
- // broken image file. The file or parts of it may not
- // be readable, or the file may contain bad data.
- //
- //---------------------------------------------------------
- void breakScanLine (int y, int offset, int length, char c);
- struct Data;
- private:
- OutputFile (const OutputFile &); // not implemented
- OutputFile & operator = (const OutputFile &); // not implemented
- void initialize (const Header &header);
- Data * _data;
- };
- } // namespace Imf
- #endif