Skottie.h

Go to the documentation of this file.

/*
 * Copyright 2017 Google Inc.
 *
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */
 
#ifndef Skottie_DEFINED
#define Skottie_DEFINED
 
#include "include/core/SkFontMgr.h"
#include "include/core/SkRefCnt.h"
#include "include/core/SkSize.h"
#include "include/core/SkString.h"
#include "include/core/SkTypes.h"
#include "modules/skottie/include/ExternalLayer.h"
#include "modules/skottie/include/SkottieProperty.h"
#include "modules/skottie/include/SlotManager.h"
#include "modules/skresources/include/SkResources.h"
 
#include <memory>
#include <vector>
 
class SkCanvas;
struct SkRect;
class SkStream;
 
namespace skjson { class ObjectValue; }
 
namespace sksg {
 
class InvalidationController;
class RenderNode;
 
} // namespace sksg
 
namespace skottie {
 
namespace internal { class Animator; }
 
using ImageAsset = skresources::ImageAsset;
using ResourceProvider = skresources::ResourceProvider;
 
class SK_API Logger : public SkRefCnt {
public:
    enum class Level {
        kWarning,
        kError,
    };
 
    virtual void log(Level, const char message[], const char* json = nullptr);
};
 
// Evaluates AE expressions.
template <class T>
class SK_API ExpressionEvaluator : public SkRefCnt {
public:
    // Evaluate the expression at the current time.
    virtual T evaluate(float t) = 0;
};
 
class SK_API ExpressionManager : public SkRefCnt {
public:
    virtual sk_sp<ExpressionEvaluator<float>> createNumberExpressionEvaluator(
        const char expression[]) = 0;
 
    virtual sk_sp<ExpressionEvaluator<SkString>> createStringExpressionEvaluator(
        const char expression[]) = 0;
 
    virtual sk_sp<ExpressionEvaluator<std::vector<float>>> createArrayExpressionEvaluator(
        const char expression[]) = 0;
};
 
class SK_API MarkerObserver : public SkRefCnt {
public:
    // t0,t1 are in the Animation::seek() domain.
    virtual void onMarker(const char name[], float t0, float t1) = 0;
};
 
class SK_API Animation : public SkNVRefCnt<Animation> {
public:
    class SK_API Builder final {
    public:
        enum Flags : uint32_t {
            kDeferImageLoading   = 0x01, // Normally, all static image frames are resolved at
                                         // load time via ImageAsset::getFrame(0).  With this flag,
                                         // frames are only resolved when needed, at seek() time.
            kPreferEmbeddedFonts = 0x02, // Attempt to use the embedded fonts (glyph paths,
                                         // normally used as fallback) over native Skia typefaces.
        };
 
        explicit Builder(uint32_t flags = 0);
        ~Builder();
 
        struct Stats {
            float  fTotalLoadTimeMS  = 0, // Total animation instantiation time.
                   fJsonParseTimeMS  = 0, // Time spent building a JSON DOM.
                   fSceneParseTimeMS = 0; // Time spent constructing the animation scene graph.
            size_t fJsonSize         = 0, // Input JSON size.
                   fAnimatorCount    = 0; // Number of dynamically animated properties.
        };
 
        const Stats& getStats() const { return fStats; }
 
        Builder& setResourceProvider(sk_sp<ResourceProvider>);
 
        Builder& setFontManager(sk_sp<SkFontMgr>);
 
        Builder& setPropertyObserver(sk_sp<PropertyObserver>);
 
        Builder& setLogger(sk_sp<Logger>);
 
        Builder& setMarkerObserver(sk_sp<MarkerObserver>);
 
        Builder& setPrecompInterceptor(sk_sp<PrecompInterceptor>);
 
        Builder& setExpressionManager(sk_sp<ExpressionManager>);
 
        sk_sp<Animation> make(SkStream*);
        sk_sp<Animation> make(const char* data, size_t length);
        sk_sp<Animation> makeFromFile(const char path[]);
 
        const sk_sp<SlotManager>& getSlotManager() const {return fSlotManager;}
 
    private:
        const uint32_t          fFlags;
 
        sk_sp<ResourceProvider>   fResourceProvider;
        sk_sp<SkFontMgr>          fFontMgr;
        sk_sp<PropertyObserver>   fPropertyObserver;
        sk_sp<Logger>             fLogger;
        sk_sp<MarkerObserver  >   fMarkerObserver;
        sk_sp<PrecompInterceptor> fPrecompInterceptor;
        sk_sp<ExpressionManager>  fExpressionManager;
        sk_sp<SlotManager>        fSlotManager;
        Stats                     fStats;
    };
 
    static sk_sp<Animation> Make(const char* data, size_t length);
    static sk_sp<Animation> Make(SkStream*);
    static sk_sp<Animation> MakeFromFile(const char path[]);
 
    ~Animation();
 
    enum RenderFlag : uint32_t {
        // When rendering into a known transparent buffer, clients can pass
        // this flag to avoid some unnecessary compositing overhead for
        // animations using layer blend modes.
        kSkipTopLevelIsolation   = 0x01,
        // By default, content is clipped to the intrinsic animation
        // bounds (as determined by its size).  If this flag is set,
        // then the animation can draw outside of the bounds.
        kDisableTopLevelClipping = 0x02,
    };
    using RenderFlags = uint32_t;
 
    void render(SkCanvas* canvas, const SkRect* dst = nullptr) const;
    void render(SkCanvas* canvas, const SkRect* dst, RenderFlags) const;
 
    void seek(SkScalar t, sksg::InvalidationController* ic = nullptr) {
        this->seekFrameTime(t * this->duration(), ic);
    }
 
    void seekFrame(double t, sksg::InvalidationController* ic = nullptr);
 
    void seekFrameTime(double t, sksg::InvalidationController* = nullptr);
 
    double duration() const { return fDuration; }
 
    double fps() const { return fFPS; }
 
    double inPoint()  const { return fInPoint;  }
 
    double outPoint() const { return fOutPoint; }
 
    const SkString& version() const { return fVersion; }
    const SkSize&      size() const { return fSize;    }
 
private:
    enum Flags : uint32_t {
        kRequiresTopLevelIsolation = 1 << 0, // Needs to draw into a layer due to layer blending.
    };
 
    Animation(sk_sp<sksg::RenderNode>,
              std::vector<sk_sp<internal::Animator>>&&,
              SkString ver, const SkSize& size,
              double inPoint, double outPoint, double duration, double fps, uint32_t flags);
 
    const sk_sp<sksg::RenderNode>                fSceneRoot;
    const std::vector<sk_sp<internal::Animator>> fAnimators;
    const SkString                               fVersion;
    const SkSize                                 fSize;
    const double                                 fInPoint,
                                                 fOutPoint,
                                                 fDuration,
                                                 fFPS;
    const uint32_t                               fFlags;
 
    using INHERITED = SkNVRefCnt<Animation>;
};
 
} // namespace skottie
 
#endif // Skottie_DEFINED