kc3-lang/angle/util/test_utils.h

Branch : - branch - main - tag -

• Show log

  Commit

• Author : Jamie Madill
  Date : 2020-06-11 13:32:10
  Hash : 11e26fa0
  Message : Allow running Samples against native GL. Useful for perf testing/comparison. Bug: angleproject:4729 Change-Id: Ic46424570dcef0a30d506962f546910ba7440595 Reviewed-on: https://chromium-review.googlesource.com/c/angle/angle/+/2241620 Reviewed-by: Jonah Ryan-Davis <jonahr@google.com> Reviewed-by: Geoff Lang <geofflang@chromium.org> Commit-Queue: Jamie Madill <jmadill@chromium.org>

• util/test_utils.h

• //
  // Copyright 2014 The ANGLE Project Authors. All rights reserved.
  // Use of this source code is governed by a BSD-style license that can be
  // found in the LICENSE file.
  //
  
  // test_utils.h: declaration of OS-specific utility functions
  
  #ifndef UTIL_TEST_UTILS_H_
  #define UTIL_TEST_UTILS_H_
  
  #include <functional>
  #include <string>
  #include <vector>
  
  #include "common/angleutils.h"
  #include "util/Timer.h"
  
  // DeleteFile is defined in the Windows headers to either DeleteFileA or DeleteFileW. Make sure
  // there are no conflicts.
  #undef DeleteFile
  
  namespace angle
  {
  // Cross platform equivalent of the Windows Sleep function
  void Sleep(unsigned int milliseconds);
  
  void SetLowPriorityProcess();
  
  // Write a debug message, either to a standard output or Debug window.
  void WriteDebugMessage(const char *format, ...);
  
  // Set thread affinity and priority.
  bool StabilizeCPUForBenchmarking();
  
  // Set a crash handler to print stack traces.
  using CrashCallback = std::function<void()>;
  void InitCrashHandler(CrashCallback *callback);
  void TerminateCrashHandler();
  
  // Print a stack back trace.
  void PrintStackBacktrace();
  
  // Get temporary directory.
  bool GetTempDir(char *tempDirOut, uint32_t maxDirNameLen);
  
  // Creates a temporary file. The full path is placed in |path|, and the
  // function returns true if was successful in creating the file. The file will
  // be empty and all handles closed after this function returns.
  bool CreateTemporaryFile(char *tempFileNameOut, uint32_t maxFileNameLen);
  
  // Same as CreateTemporaryFile but the file is created in |dir|.
  bool CreateTemporaryFileInDir(const char *dir, char *tempFileNameOut, uint32_t maxFileNameLen);
  
  // Deletes a file or directory.
  bool DeleteFile(const char *path);
  
  // Reads a file contents into a string.
  bool ReadEntireFileToString(const char *filePath, char *contentsOut, uint32_t maxLen);
  
  // Compute a file's size.
  bool GetFileSize(const char *filePath, uint32_t *sizeOut);
  
  class ProcessHandle;
  
  class Process : angle::NonCopyable
  {
    public:
      virtual bool started()    = 0;
      virtual bool finished()   = 0;
      virtual bool finish()     = 0;
      virtual bool kill()       = 0;
      virtual int getExitCode() = 0;
  
      double getElapsedTimeSeconds() const { return mTimer.getElapsedTime(); }
      const std::string &getStdout() const { return mStdout; }
      const std::string &getStderr() const { return mStderr; }
  
    protected:
      friend class ProcessHandle;
      virtual ~Process();
  
      Timer mTimer;
      std::string mStdout;
      std::string mStderr;
  };
  
  class ProcessHandle final : angle::NonCopyable
  {
    public:
      ProcessHandle();
      ProcessHandle(Process *process);
      ProcessHandle(const std::vector<const char *> &args, bool captureStdout, bool captureStderr);
      ~ProcessHandle();
      ProcessHandle(ProcessHandle &&other);
      ProcessHandle &operator=(ProcessHandle &&rhs);
  
      Process *operator->() { return mProcess; }
      const Process *operator->() const { return mProcess; }
  
      operator bool() const { return mProcess != nullptr; }
  
      void reset();
  
    private:
      Process *mProcess;
  };
  
  // Launch a process and optionally get the output. Uses a vector of c strings as command line
  // arguments to the child process. Returns a Process handle which can be used to retrieve
  // the stdout and stderr outputs as well as the exit code.
  //
  // Pass false for stdoutOut/stderrOut if you don't need to capture them.
  //
  // On success, returns a Process pointer with started() == true.
  // On failure, returns a Process pointer with started() == false.
  Process *LaunchProcess(const std::vector<const char *> &args,
                         bool captureStdout,
                         bool captureStderr);
  
  int NumberOfProcessors();
  
  const char *GetNativeEGLLibraryNameWithExtension();
  }  // namespace angle
  
  #endif  // UTIL_TEST_UTILS_H_