54924243c1
The following changes were made by this CL: 1. Make flatten() a protected method as callers should use SkFlattenableWriteBuffer to flatten an object 2. Make flatten a const method (including subclasses) 3. Mark subclass implementation of flatten with SK_OVERRIDE 4. Ensure overridden flatten impls call their parent 5. Remove no-op implementations of flatten from subclasses Additionally, if necessary the unflattening constructor was also moved to the protected section of the subclasses header if it was not already there. git-svn-id: http://skia.googlecode.com/svn/trunk@3540 2bbb7eff-a529-9590-31e7-b0007b416f81
105 lines
3.5 KiB
C++
105 lines
3.5 KiB
C++
|
|
/*
|
|
* Copyright 2008 The Android Open Source Project
|
|
*
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
* found in the LICENSE file.
|
|
*/
|
|
|
|
|
|
#ifndef SkImageRef_DEFINED
|
|
#define SkImageRef_DEFINED
|
|
|
|
#include "SkPixelRef.h"
|
|
#include "SkBitmap.h"
|
|
#include "SkImageDecoder.h"
|
|
#include "SkString.h"
|
|
|
|
class SkImageRefPool;
|
|
class SkStream;
|
|
|
|
// define this to enable dumping whenever we add/remove/purge an imageref
|
|
//#define DUMP_IMAGEREF_LIFECYCLE
|
|
|
|
class SkImageRef : public SkPixelRef {
|
|
public:
|
|
/** Create a new imageref from a stream. NOTE: the stream is not copied, but
|
|
since it may be accessed from another thread, the caller must ensure
|
|
that this imageref is the only owner of the stream. i.e. - sole
|
|
ownership of the stream object is transferred to this imageref object.
|
|
|
|
@param stream The stream containing the encoded image data. This may be
|
|
retained (by calling ref()), so the caller should not
|
|
explicitly delete it.
|
|
@param config The preferred config of the decoded bitmap.
|
|
@param sampleSize Requested sampleSize for decoding. Defaults to 1.
|
|
*/
|
|
SkImageRef(SkStream*, SkBitmap::Config config, int sampleSize = 1);
|
|
virtual ~SkImageRef();
|
|
|
|
/** this value is passed onto the decoder. Default is true
|
|
*/
|
|
void setDitherImage(bool dither) { fDoDither = dither; }
|
|
|
|
/** Return true if the image can be decoded. If so, and bitmap is non-null,
|
|
call its setConfig() with the corresponding values, but explicitly will
|
|
not set its pixels or colortable. Use SkPixelRef::lockPixels() for that.
|
|
|
|
If there has been an error decoding the bitmap, this will return false
|
|
and ignore the bitmap parameter.
|
|
*/
|
|
bool getInfo(SkBitmap* bm);
|
|
|
|
/** Return true if the image can be decoded and is opaque. Calling this
|
|
method will decode and set the pixels in the specified bitmap and
|
|
sets the isOpaque flag.
|
|
*/
|
|
bool isOpaque(SkBitmap* bm);
|
|
|
|
SkImageDecoderFactory* getDecoderFactory() const { return fFactory; }
|
|
// returns the factory parameter
|
|
SkImageDecoderFactory* setDecoderFactory(SkImageDecoderFactory*);
|
|
|
|
protected:
|
|
/** Override if you want to install a custom allocator.
|
|
When this is called we will have already acquired the mutex!
|
|
*/
|
|
virtual bool onDecode(SkImageDecoder* codec, SkStream*, SkBitmap*,
|
|
SkBitmap::Config, SkImageDecoder::Mode);
|
|
|
|
/* Overrides from SkPixelRef
|
|
When these are called, we will have already acquired the mutex!
|
|
*/
|
|
|
|
virtual void* onLockPixels(SkColorTable**);
|
|
// override this in your subclass to clean up when we're unlocking pixels
|
|
virtual void onUnlockPixels();
|
|
|
|
SkImageRef(SkFlattenableReadBuffer&);
|
|
virtual void flatten(SkFlattenableWriteBuffer&) const SK_OVERRIDE;
|
|
|
|
SkBitmap fBitmap;
|
|
|
|
private:
|
|
SkStream* setStream(SkStream*);
|
|
// called with mutex already held. returns true if the bitmap is in the
|
|
// requested state (or further, i.e. has pixels)
|
|
bool prepareBitmap(SkImageDecoder::Mode);
|
|
|
|
SkImageDecoderFactory* fFactory; // may be null
|
|
SkStream* fStream;
|
|
SkBitmap::Config fConfig;
|
|
int fSampleSize;
|
|
bool fDoDither;
|
|
bool fErrorInDecoding;
|
|
|
|
friend class SkImageRefPool;
|
|
|
|
SkImageRef* fPrev, *fNext;
|
|
size_t ramUsed() const;
|
|
|
|
typedef SkPixelRef INHERITED;
|
|
};
|
|
|
|
#endif
|