2012-07-25 14:42:15 +00:00
|
|
|
/*
|
|
|
|
* Copyright 2012 Google Inc.
|
|
|
|
*
|
|
|
|
* Use of this source code is governed by a BSD-style license that can be
|
|
|
|
* found in the LICENSE file.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef SkImage_DEFINED
|
|
|
|
#define SkImage_DEFINED
|
|
|
|
|
2013-11-13 19:09:13 +00:00
|
|
|
#include "SkImageInfo.h"
|
2013-05-31 14:00:10 +00:00
|
|
|
#include "SkImageEncoder.h"
|
2012-07-27 18:02:50 +00:00
|
|
|
#include "SkRefCnt.h"
|
|
|
|
#include "SkScalar.h"
|
|
|
|
|
|
|
|
class SkData;
|
|
|
|
class SkCanvas;
|
|
|
|
class SkPaint;
|
|
|
|
class SkShader;
|
2012-07-31 15:45:27 +00:00
|
|
|
class GrContext;
|
2012-10-31 14:58:16 +00:00
|
|
|
class GrTexture;
|
2012-07-27 18:02:50 +00:00
|
|
|
|
|
|
|
// need for TileMode
|
|
|
|
#include "SkShader.h"
|
2012-07-25 14:42:15 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* SkImage is an abstraction for drawing a rectagle of pixels, though the
|
|
|
|
* particular type of image could be actually storing its data on the GPU, or
|
|
|
|
* as drawing commands (picture or PDF or otherwise), ready to be played back
|
|
|
|
* into another canvas.
|
|
|
|
*
|
|
|
|
* The content of SkImage is always immutable, though the actual storage may
|
|
|
|
* change, if for example that image can be re-created via encoded data or
|
|
|
|
* other means.
|
|
|
|
*/
|
2013-04-18 13:28:19 +00:00
|
|
|
class SK_API SkImage : public SkRefCnt {
|
2012-07-25 14:42:15 +00:00
|
|
|
public:
|
2012-08-28 12:43:54 +00:00
|
|
|
SK_DECLARE_INST_COUNT(SkImage)
|
2012-08-16 14:58:06 +00:00
|
|
|
|
2013-11-01 13:46:54 +00:00
|
|
|
typedef SkImageInfo Info;
|
2012-07-25 14:42:15 +00:00
|
|
|
|
2012-11-15 02:37:45 +00:00
|
|
|
static SkImage* NewRasterCopy(const Info&, const void* pixels, size_t rowBytes);
|
|
|
|
static SkImage* NewRasterData(const Info&, SkData* pixels, size_t rowBytes);
|
2012-07-25 14:42:15 +00:00
|
|
|
static SkImage* NewEncodedData(SkData*);
|
2013-07-25 23:29:40 +00:00
|
|
|
|
|
|
|
/**
|
2013-07-26 07:00:58 +00:00
|
|
|
* GrTexture is a more logical parameter for this factory, but its
|
2013-07-25 23:29:40 +00:00
|
|
|
* interactions with scratch cache still has issues, so for now we take
|
|
|
|
* SkBitmap instead. This will be changed in the future. skbug.com/1449
|
|
|
|
*/
|
|
|
|
static SkImage* NewTexture(const SkBitmap&);
|
2012-07-25 14:42:15 +00:00
|
|
|
|
2012-07-27 18:02:50 +00:00
|
|
|
int width() const { return fWidth; }
|
|
|
|
int height() const { return fHeight; }
|
|
|
|
uint32_t uniqueID() const { return fUniqueID; }
|
|
|
|
|
2013-05-01 22:38:16 +00:00
|
|
|
/**
|
|
|
|
* Return the GrTexture that stores the image pixels. Calling getTexture
|
|
|
|
* does not affect the reference count of the GrTexture object.
|
|
|
|
* Will return NULL if the image does not use a texture.
|
|
|
|
*/
|
|
|
|
GrTexture* getTexture();
|
|
|
|
|
2012-07-25 14:42:15 +00:00
|
|
|
SkShader* newShaderClamp() const;
|
|
|
|
SkShader* newShader(SkShader::TileMode, SkShader::TileMode) const;
|
2012-07-27 18:02:50 +00:00
|
|
|
|
|
|
|
void draw(SkCanvas*, SkScalar x, SkScalar y, const SkPaint*);
|
|
|
|
|
2013-07-23 15:52:16 +00:00
|
|
|
/**
|
2013-07-24 07:01:12 +00:00
|
|
|
* Draw the image, cropped to the src rect, to the dst rect of a canvas.
|
|
|
|
* If src is larger than the bounds of the image, the rest of the image is
|
|
|
|
* filled with transparent black pixels.
|
2013-07-23 15:52:16 +00:00
|
|
|
*
|
|
|
|
* See SkCanvas::drawBitmapRectToRect for similar behavior.
|
|
|
|
*/
|
|
|
|
void draw(SkCanvas*, const SkRect* src, const SkRect& dst, const SkPaint*);
|
2013-07-24 07:01:12 +00:00
|
|
|
|
2013-05-20 16:33:41 +00:00
|
|
|
/**
|
|
|
|
* Encode the image's pixels and return the result as a new SkData, which
|
|
|
|
* the caller must manage (i.e. call unref() when they are done).
|
|
|
|
*
|
|
|
|
* If the image type cannot be encoded, or the requested encoder type is
|
|
|
|
* not supported, this will return NULL.
|
|
|
|
*/
|
2013-05-31 14:00:10 +00:00
|
|
|
SkData* encode(SkImageEncoder::Type t = SkImageEncoder::kPNG_Type,
|
|
|
|
int quality = 80) const;
|
2013-05-20 16:33:41 +00:00
|
|
|
|
2012-07-27 18:02:50 +00:00
|
|
|
protected:
|
|
|
|
SkImage(int width, int height) :
|
|
|
|
fWidth(width),
|
|
|
|
fHeight(height),
|
|
|
|
fUniqueID(NextUniqueID()) {
|
|
|
|
|
|
|
|
SkASSERT(width >= 0);
|
|
|
|
SkASSERT(height >= 0);
|
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
const int fWidth;
|
|
|
|
const int fHeight;
|
|
|
|
const uint32_t fUniqueID;
|
|
|
|
|
|
|
|
static uint32_t NextUniqueID();
|
2012-08-30 14:38:00 +00:00
|
|
|
|
2012-08-28 12:48:35 +00:00
|
|
|
typedef SkRefCnt INHERITED;
|
2012-07-25 14:42:15 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif
|