6aaad1a27a
- no more color tables - explicitly mention that MakeAllocate does not initialize the pixels Change-Id: I98b9ef1fecc36ea5d9acbae66ccd8979810c2760 Reviewed-on: https://skia-review.googlesource.com/c/skia/+/206265 Auto-Submit: Mike Klein <mtklein@google.com> Reviewed-by: Mike Reed <reed@google.com> Commit-Queue: Mike Klein <mtklein@google.com>
91 lines
3.1 KiB
C++
91 lines
3.1 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 SkMallocPixelRef_DEFINED
|
|
#define SkMallocPixelRef_DEFINED
|
|
|
|
#include "SkPixelRef.h"
|
|
#include "SkRefCnt.h"
|
|
#include "SkTypes.h"
|
|
class SkData;
|
|
struct SkImageInfo;
|
|
|
|
/** We explicitly use the same allocator for our pixels that SkMask does,
|
|
so that we can freely assign memory allocated by one class to the other.
|
|
*/
|
|
class SK_API SkMallocPixelRef : public SkPixelRef {
|
|
public:
|
|
/**
|
|
* Return a new SkMallocPixelRef with the provided pixel storage and
|
|
* rowBytes. The caller is responsible for managing the lifetime of the
|
|
* pixel storage buffer, as this pixelref will not try to delete it.
|
|
*
|
|
* Returns NULL on failure.
|
|
*/
|
|
static sk_sp<SkPixelRef> MakeDirect(const SkImageInfo&, void* addr, size_t rowBytes);
|
|
|
|
/**
|
|
* Return a new SkMallocPixelRef, automatically allocating storage for the
|
|
* pixels. If rowBytes are 0, an optimal value will be chosen automatically.
|
|
* If rowBytes is > 0, then it will be respected, or NULL will be returned
|
|
* if rowBytes is invalid for the specified info.
|
|
*
|
|
* All pixel bytes are left uninitialized.
|
|
*
|
|
* Returns NULL on failure.
|
|
*/
|
|
static sk_sp<SkPixelRef> MakeAllocate(const SkImageInfo&, size_t rowBytes);
|
|
|
|
/**
|
|
* Identical to MakeAllocate, except all pixel bytes are zeroed.
|
|
*/
|
|
static sk_sp<SkPixelRef> MakeZeroed(const SkImageInfo&, size_t rowBytes);
|
|
|
|
/**
|
|
* Return a new SkMallocPixelRef with the provided pixel storage and
|
|
* rowBytes. On destruction, ReleaseProc will be called.
|
|
*
|
|
* If ReleaseProc is NULL, the pixels will never be released. This
|
|
* can be useful if the pixels were stack allocated. However, such an
|
|
* SkMallocPixelRef must not live beyond its pixels (e.g. by copying
|
|
* an SkBitmap pointing to it, or drawing to an SkPicture).
|
|
*
|
|
* Returns NULL on failure.
|
|
*/
|
|
typedef void (*ReleaseProc)(void* addr, void* context);
|
|
static sk_sp<SkPixelRef> MakeWithProc(const SkImageInfo& info, size_t rowBytes, void* addr,
|
|
ReleaseProc proc, void* context);
|
|
|
|
/**
|
|
* Return a new SkMallocPixelRef that will use the provided SkData and
|
|
* rowBytes as pixel storage. The SkData will be ref()ed and on
|
|
* destruction of the PixelRef, the SkData will be unref()ed.
|
|
*
|
|
* Returns NULL on failure.
|
|
*/
|
|
static sk_sp<SkPixelRef> MakeWithData(const SkImageInfo&, size_t rowBytes, sk_sp<SkData> data);
|
|
|
|
protected:
|
|
~SkMallocPixelRef() override;
|
|
|
|
private:
|
|
// Uses alloc to implement NewAllocate or NewZeroed.
|
|
static sk_sp<SkPixelRef> MakeUsing(void*(*alloc)(size_t),
|
|
const SkImageInfo&,
|
|
size_t rowBytes);
|
|
|
|
ReleaseProc fReleaseProc;
|
|
void* fReleaseProcContext;
|
|
|
|
SkMallocPixelRef(const SkImageInfo&, void* addr, size_t rb, ReleaseProc proc, void* context);
|
|
|
|
typedef SkPixelRef INHERITED;
|
|
};
|
|
|
|
|
|
#endif
|