tools/skqp/src/skqp.h

/*
 * Copyright 2018 Google Inc.
 *
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */

#ifndef skqp_DEFINED
#define skqp_DEFINED

#include <cstdint>
#include <memory>
#include <string>
#include <vector>

class SkData;
template <typename T> class sk_sp;

namespace skiagm {
class GM;
}  // namespace skiagm

namespace skiatest {
struct Test;
}  // namespace skiatest

class SkStreamAsset;

////////////////////////////////////////////////////////////////////////////////
class SkQPAssetManager {
public:
    SkQPAssetManager() {}
    virtual ~SkQPAssetManager() {}
    virtual sk_sp<SkData> open(const char* path) = 0;
    virtual std::vector<std::string> iterateDir(const char* directory, const char* extension) = 0;

private:
    SkQPAssetManager(const SkQPAssetManager&) = delete;
    SkQPAssetManager& operator=(const SkQPAssetManager&) = delete;
};

class SkQP {
public:
    using UnitTest = const skiatest::Test*;

    struct SkSLErrorTest {
        std::string name;
        std::string shaderText;
    };

    ////////////////////////////////////////////////////////////////////////////

    /** These functions provide a descriptive name for the given value.*/
    static const char* GetUnitTestName(UnitTest);

    SkQP();
    ~SkQP();

    /**
        Initialize Skia and the SkQP.  Should be executed only once.

        @param assetManager - provides assets for the models.  Does not take ownership.
        @param reportDirectory - where to write out report.
    */
    void init(SkQPAssetManager* assetManager, const char* reportDirectory);

    /** @return a (hopefully empty) list of errors produced by this unit test.  */
    std::vector<std::string> executeTest(UnitTest);

    /** Call this after running all checks to write a report into the given report directory. */
    void makeReport();

    /** @return a sorted list of all Skia GPU unit tests */
    const std::vector<UnitTest>& getUnitTests() const { return fUnitTests; }

    /** @return a sorted list of all SkSL error tests */
    const std::vector<SkSLErrorTest>& getSkSLErrorTests() const { return fSkSLErrorTests; }

    ////////////////////////////////////////////////////////////////////////////

private:
    struct TestResult {
        std::string name;
        std::vector<std::string> errors;
    };
    std::vector<TestResult> fTestResults;
    std::string fReportDirectory;
    std::vector<UnitTest> fUnitTests;
    std::vector<SkSLErrorTest> fSkSLErrorTests;

    // Defaults to zero since most checks care if it is greater than a specific value. So this will
    // just default to it being less.
    int fEnforcedAndroidAPILevel = 0;

    SkQP(const SkQP&) = delete;
    SkQP& operator=(const SkQP&) = delete;
    void printBackendInfo(const char* dstPath);
};
#endif  // skqp_DEFINED