WebCore/ImageBuffer.h

   1 /*
   2  * Copyright (C) 2006 Nikolas Zimmermann <zimmermann@kde.org>
   3  * Copyright (C) 2007, 2008 Apple Inc. All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
  15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
  18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26
  27 #ifndef ImageBuffer_h
  28 #define ImageBuffer_h
  29
  30 #include "TransformationMatrix.h"
  31 #include "Image.h"
  32 #include "IntSize.h"
  33 #include "ImageBufferData.h"
  34 #include <wtf/OwnPtr.h>
  35 #include <wtf/PassRefPtr.h>
  36 #include <memory>
  37
  38 namespace WebCore {
  39
  40     class GraphicsContext;
  41     class ImageData;
  42     class IntPoint;
  43     class IntRect;
  44     class String;
  45
  46     class ImageBuffer : Noncopyable {
  47     public:
  48         // Will return a null pointer on allocation failure.
  49         static std::auto_ptr<ImageBuffer> create(const IntSize& size, bool grayScale)
  50         {
  51             bool success = false;
  52             std::auto_ptr<ImageBuffer> buf(new ImageBuffer(size, grayScale, success));
  53             if (success)
  54                 return buf;
  55             return std::auto_ptr<ImageBuffer>();
  56         }
  57
  58         ~ImageBuffer();
  59
  60         const IntSize& size() const { return m_size; }
  61         GraphicsContext* context() const;
  62
  63         Image* image() const;
  64
  65         void clearImage() { m_image.clear(); }
  66
  67         PassRefPtr<ImageData> getImageData(const IntRect& rect) const;
  68         void putImageData(ImageData* source, const IntRect& sourceRect, const IntPoint& destPoint);
  69
  70         String toDataURL(const String& mimeType) const;
  71 #if !PLATFORM(CG)
  72         TransformationMatrix baseTransform() const { return TransformationMatrix(); }
  73 #else
  74         TransformationMatrix baseTransform() const { return TransformationMatrix(1, 0, 0, -1, 0, m_size.height()); }
  75 #endif
  76     private:
  77         ImageBufferData m_data;
  78
  79         IntSize m_size;
  80         OwnPtr<GraphicsContext> m_context;
  81         mutable RefPtr<Image> m_image;
  82
  83         // This constructor will place its succes into the given out-variable
  84         // so that create() knows when it should return failure.
  85         ImageBuffer(const IntSize&, bool grayScale, bool& success);
  86     };
  87
  88 } // namespace WebCore
  89
  90 #endif // ImageBuffer_h