| /* |
| * 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 "include/core/SkPixelRef.h" |
| #include "include/core/SkRefCnt.h" |
| #include "include/core/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 zeroed. |
| * |
| * Returns NULL on failure. |
| */ |
| static sk_sp<SkPixelRef> MakeAllocate(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: |
| ReleaseProc fReleaseProc; |
| void* fReleaseProcContext; |
| |
| SkMallocPixelRef(const SkImageInfo&, void* addr, size_t rb, ReleaseProc proc, void* context); |
| |
| typedef SkPixelRef INHERITED; |
| }; |
| |
| |
| #endif |