SkPicturePriv Class Reference

#include <SkPicturePriv.h>

Public Types
enum	Version {   kPictureShaderFilterParam_Version = 82 , kMatrixImageFilterSampling_Version = 83 , kImageFilterImageSampling_Version = 84 , kNoFilterQualityShaders_Version = 85 ,   kVerticesRemoveCustomData_Version = 86 , kSkBlenderInSkPaint = 87 , kBlenderInEffects = 88 , kNoExpandingClipOps = 89 ,   kBackdropScaleFactor = 90 , kRawImageShaders = 91 , kAnisotropicFilter = 92 , kBlend4fColorFilter = 93 ,   kNoShaderLocalMatrix = 94 , kShaderImageFilterSerializeShader = 95 , kRevampMagnifierFilter = 96 , kRuntimeImageFilterSampleRadius = 97 ,   kCombineBlendArithmeticFilters = 98 , kRemoveLegacyMagnifierFilter = 99 , kDropShadowImageFilterComposition = 100 , kCropImageFilterSupportsTiling = 101 ,   kConvolutionImageFilterTilingUpdate = 102 , kRemoveDeprecatedCropRect = 103 , kMultipleFiltersOnSaveLayer = 104 , kMin_Version = kPictureShaderFilterParam_Version ,   kCurrent_Version = kMultipleFiltersOnSaveLayer }

Static Public Member Functions
static sk_sp< SkPicture >	MakeFromBuffer (SkReadBuffer &buffer)
static void	Flatten (const sk_sp< const SkPicture >, SkWriteBuffer &buffer)
static const SkBigPicture *	AsSkBigPicture (const sk_sp< const SkPicture > &picture)
static uint64_t	MakeSharedID (uint32_t pictureID)
static void	AddedToCache (const SkPicture *pic)

Detailed Description

Definition at line 18 of file SkPicturePriv.h.

Member Enumeration Documentation

Version

enum SkPicturePriv::Version

Enumerator
kPictureShaderFilterParam_Version
kMatrixImageFilterSampling_Version
kImageFilterImageSampling_Version
kNoFilterQualityShaders_Version
kVerticesRemoveCustomData_Version
kSkBlenderInSkPaint
kBlenderInEffects
kNoExpandingClipOps
kBackdropScaleFactor
kRawImageShaders
kAnisotropicFilter
kBlend4fColorFilter
kNoShaderLocalMatrix
kShaderImageFilterSerializeShader
kRevampMagnifierFilter
kRuntimeImageFilterSampleRadius
kCombineBlendArithmeticFilters
kRemoveLegacyMagnifierFilter
kDropShadowImageFilterComposition
kCropImageFilterSupportsTiling
kConvolutionImageFilterTilingUpdate
kRemoveDeprecatedCropRect
kMultipleFiltersOnSaveLayer
kMin_Version
kCurrent_Version

Definition at line 119 of file SkPicturePriv.h.

                 {
        kPictureShaderFilterParam_Version   = 82,
        kMatrixImageFilterSampling_Version  = 83,
        kImageFilterImageSampling_Version   = 84,
        kNoFilterQualityShaders_Version     = 85,
        kVerticesRemoveCustomData_Version   = 86,
        kSkBlenderInSkPaint                 = 87,
        kBlenderInEffects                   = 88,
        kNoExpandingClipOps                 = 89,
        kBackdropScaleFactor                = 90,
        kRawImageShaders                    = 91,
        kAnisotropicFilter                  = 92,
        kBlend4fColorFilter                 = 93,
        kNoShaderLocalMatrix                = 94,
        kShaderImageFilterSerializeShader   = 95,
        kRevampMagnifierFilter              = 96,
        kRuntimeImageFilterSampleRadius     = 97,
        kCombineBlendArithmeticFilters      = 98,
        kRemoveLegacyMagnifierFilter        = 99,
        kDropShadowImageFilterComposition   = 100,
        kCropImageFilterSupportsTiling      = 101,
        kConvolutionImageFilterTilingUpdate = 102,
        kRemoveDeprecatedCropRect           = 103,
        kMultipleFiltersOnSaveLayer         = 104,
 
        // Only SKPs within the min/current picture version range (inclusive) can be read.
        //
        // When updating kMin_Version also update oldestSupportedSkpVersion in
        // infra/bots/gen_tasks_logic/gen_tasks_logic.go
        //
        // Steps on how to find which oldestSupportedSkpVersion to use:
        // 1) Find the git hash when the desired kMin_Version was the kCurrent_Version from the
        //    git logs: https://skia.googlesource.com/skia/+log/main/src/core/SkPicturePriv.h
        //    Eg: https://skia.googlesource.com/skia/+/bfd330d081952424a93d51715653e4d1314d4822%5E%21/#F1
        //
        // 2) Use that git hash to find the SKP asset version number at that time here:
        //    https://skia.googlesource.com/skia/+/bfd330d081952424a93d51715653e4d1314d4822/infra/bots/assets/skp/VERSION
        //
        // 3) [Optional] Increment the SKP asset version number from step 3 and verify that it has
        //    the expected version number by downloading the asset and running skpinfo on it.
        //
        // 4) Use the incremented SKP asset version number as the oldestSupportedSkpVersion in
        //    infra/bots/gen_tasks_logic/gen_tasks_logic.go
        //
        // 5) Run `make -C infra/bots train`
        //
        // Contact the Infra Gardener if the above steps do not work for you.
        kMin_Version     = kPictureShaderFilterParam_Version,
        kCurrent_Version = kMultipleFiltersOnSaveLayer
    };

Member Function Documentation

AddedToCache()

static void SkPicturePriv::AddedToCache ( const SkPicture *  pic )

inlinestatic

Definition at line 45 of file SkPicturePriv.h.

                                                   {
        pic->fAddedToCache.store(true);
    }

AsSkBigPicture()

static const SkBigPicture * SkPicturePriv::AsSkBigPicture ( const sk_sp< const SkPicture > &  picture )

inlinestatic

Definition at line 36 of file SkPicturePriv.h.

                                                                                     {
        return picture->asSkBigPicture();
    }

Flatten()

void SkPicturePriv::Flatten ( const sk_sp< const SkPicture >  picture, SkWriteBuffer &  buffer  )

static

Serialize to a buffer.

Definition at line 314 of file SkPicture.cpp.

                                                                                       {
    SkPictInfo info = picture->createHeader();
    std::unique_ptr<SkPictureData> data(picture->backport());
 
    buffer.writeByteArray(&info.fMagic, sizeof(info.fMagic));
    buffer.writeUInt(info.getVersion());
    buffer.writeRect(info.fCullRect);
 
    if (auto custom = custom_serialize(picture.get(), buffer.serialProcs())) {
        int32_t size = SkToS32(custom->size());
        buffer.write32(-size);    // negative for custom format
        buffer.writePad32(custom->data(), size);
        return;
    }
 
    if (data) {
        buffer.write32(1); // special size meaning SkPictureData
        data->flatten(buffer);
    } else {
        buffer.write32(0); // signal no content
    }
}

MakeFromBuffer()

sk_sp< SkPicture > SkPicturePriv::MakeFromBuffer ( SkReadBuffer &  buffer )

static

Recreate a picture that was serialized into a buffer. If the creation requires bitmap decoding, the decoder must be set on the SkReadBuffer parameter by calling SkReadBuffer::setBitmapDecoder() before calling SkPicture::MakeFromBuffer().

Parameters

buffer

Serialized picture data.

Returns

A new SkPicture representing the serialized data, or NULL if the buffer is invalid.

Definition at line 213 of file SkPicture.cpp.

                                                                   {
    SkPictInfo info;
    if (!SkPicture::BufferIsSKP(&buffer, &info)) {
        return nullptr;
    }
    // size should be 0, 1, or negative
    int32_t ssize = buffer.read32();
    if (ssize < 0) {
        const SkDeserialProcs& procs = buffer.getDeserialProcs();
        if (!procs.fPictureProc) {
            return nullptr;
        }
        size_t size = sk_negate_to_size_t(ssize);
        return procs.fPictureProc(buffer.skip(size), size, procs.fPictureCtx);
    }
    if (ssize != 1) {
        // 1 is the magic 'size' that means SkPictureData follows
        return nullptr;
    }
   std::unique_ptr<SkPictureData> data(SkPictureData::CreateFromBuffer(buffer, info));
    return SkPicture::Forwardport(info, data.get(), &buffer);
}

MakeSharedID()

static uint64_t SkPicturePriv::MakeSharedID ( uint32_t  pictureID )

inlinestatic

Definition at line 40 of file SkPicturePriv.h.

                                                     {
        uint64_t sharedID = SkSetFourByteTag('p', 'i', 'c', 't');
        return (sharedID << 32) | pictureID;
    }

---

The documentation for this class was generated from the following files:

• third_party/skia/src/core/SkPicturePriv.h
• third_party/skia/src/core/SkPicture.cpp