4fee323522
This should let getTypeName() and serialization work even when deserialization factories haven't been registered. I've made getTypeName() pure virtual like getFactory(), and moved all the overrides into SK_FLATTENABLE_HOOKS, cleaning up all the various ways we've done it before. All the subclasses override getTypeName() and getFactory() privately, so there should be no need to document them? Change-Id: I723cb20099d250c2f2a10be266e3aacc6a061937 Reviewed-on: https://skia-review.googlesource.com/c/163543 Reviewed-by: Cary Clark <caryclark@google.com> Reviewed-by: Mike Reed <reed@google.com> Commit-Queue: Mike Klein <mtklein@google.com>
112 lines
3.3 KiB
C++
112 lines
3.3 KiB
C++
/*
|
|
* Copyright 2006 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 SkFlattenable_DEFINED
|
|
#define SkFlattenable_DEFINED
|
|
|
|
#include "SkRefCnt.h"
|
|
|
|
class SkData;
|
|
class SkReadBuffer;
|
|
class SkWriteBuffer;
|
|
|
|
struct SkSerialProcs;
|
|
struct SkDeserialProcs;
|
|
|
|
/** \class SkFlattenable
|
|
|
|
SkFlattenable is the base class for objects that need to be flattened
|
|
into a data stream for either transport or as part of the key to the
|
|
font cache.
|
|
*/
|
|
class SK_API SkFlattenable : public SkRefCnt {
|
|
public:
|
|
enum Type {
|
|
kSkColorFilter_Type,
|
|
kSkDrawable_Type,
|
|
kSkDrawLooper_Type,
|
|
kSkImageFilter_Type,
|
|
kSkMaskFilter_Type,
|
|
kSkPathEffect_Type,
|
|
kSkPixelRef_Type,
|
|
kSkUnused_Type4, // used to be SkRasterizer
|
|
kSkShaderBase_Type,
|
|
kSkUnused_Type, // used to be SkUnitMapper
|
|
kSkUnused_Type2,
|
|
kSkNormalSource_Type,
|
|
};
|
|
|
|
typedef sk_sp<SkFlattenable> (*Factory)(SkReadBuffer&);
|
|
|
|
SkFlattenable() {}
|
|
|
|
/** Implement this to return a factory function pointer that can be called
|
|
to recreate your class given a buffer (previously written to by your
|
|
override of flatten().
|
|
*/
|
|
virtual Factory getFactory() const = 0;
|
|
|
|
/**
|
|
* Returns the name of the object's class.
|
|
*/
|
|
virtual const char* getTypeName() const = 0;
|
|
|
|
static Factory NameToFactory(const char name[]);
|
|
static const char* FactoryToName(Factory);
|
|
static bool NameToType(const char name[], Type* type);
|
|
|
|
static void Register(const char name[], Factory, Type);
|
|
|
|
/**
|
|
* Override this if your subclass needs to record data that it will need to recreate itself
|
|
* from its CreateProc (returned by getFactory()).
|
|
*
|
|
* DEPRECATED public : will move to protected ... use serialize() instead
|
|
*/
|
|
virtual void flatten(SkWriteBuffer&) const {}
|
|
|
|
virtual Type getFlattenableType() const = 0;
|
|
|
|
//
|
|
// public ways to serialize / deserialize
|
|
//
|
|
sk_sp<SkData> serialize(const SkSerialProcs* = nullptr) const;
|
|
size_t serialize(void* memory, size_t memory_size,
|
|
const SkSerialProcs* = nullptr) const;
|
|
static sk_sp<SkFlattenable> Deserialize(Type, const void* data, size_t length,
|
|
const SkDeserialProcs* procs = nullptr);
|
|
|
|
protected:
|
|
class PrivateInitializer {
|
|
public:
|
|
static void InitCore();
|
|
static void InitEffects();
|
|
static void InitImageFilters();
|
|
};
|
|
|
|
private:
|
|
static void InitializeFlattenablesIfNeeded();
|
|
static void Finalize();
|
|
|
|
friend class SkGraphics;
|
|
|
|
typedef SkRefCnt INHERITED;
|
|
};
|
|
|
|
#define SK_DEFINE_FLATTENABLE_REGISTRAR_ENTRY(type) \
|
|
SkFlattenable::Register(#type, \
|
|
type::CreateProc, \
|
|
type::GetFlattenableType());
|
|
|
|
#define SK_FLATTENABLE_HOOKS(type) \
|
|
static sk_sp<SkFlattenable> CreateProc(SkReadBuffer&); \
|
|
friend class SkFlattenable::PrivateInitializer; \
|
|
Factory getFactory() const override { return type::CreateProc; } \
|
|
const char* getTypeName() const override { return #type; }
|
|
|
|
#endif
|