/usr/include/globjects/Query.h is in libglobjects-dev 1.1.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 | #pragma once
#include <chrono>
#include <glbinding/gl/types.h>
#include <globjects/globjects_api.h>
#include <globjects/Object.h>
namespace globjects
{
/** \brief Encapsulates a GL Query object
A Query object is used to query different aspects of the rendering
pipeline, such as passed samples, generated primitives, written transform
feedback primitives or elapsed time. With begin() and end(), the scope of
the measurements could be specified. As a Query object queries the GPU
asynchroneously, the result won't be available right after the end()
invokation. The resultAvailable() method indicates whether the calling of
get()/get64() will return the final result. To wait until the result is
available, the wait() method can be used. Alternatively there are
waitAndGet() and waitAndGet64() to query the result in one invokation.
There is a convenience method to create a Query object which answeres with
the current timestamp on the GPU named timestamp() (see example below).
An example time measurement:
\code{.cpp}
Query * query = new Query(gl::GL_TIME_ELAPSED);
query->begin();
// more GL calls
query->end();
query->wait();
gl::GLuint timeElapsed = query->get();
// Note: sometimes it's important to use the 64 bit equivalent, because the 32 bit version can only capture time up to 4 seconds.
\endcode
An example timestamp access:
\code{.cpp}
// GL calls
Query * query = Query::timestamp();
// even more GL calls
query->wait();
gl::GLuint64 timestamp = query->get64();
// Note: the result is the timestamp on the GPU right after the first GL calls finished and before the second calls started.
\endcode
\see http://www.opengl.org/wiki/Query_Object
\see http://www.opengl.org/registry/specs/ARB/timer_query.txt
*/
class GLOBJECTS_API Query : public Object
{
public:
Query();
static Query * fromId(gl::GLuint id);
static Query * current(gl::GLenum target);
static Query * timestamp();
static gl::GLint get(gl::GLenum target, gl::GLenum pname);
static gl::GLint getIndexed(gl::GLenum target, gl::GLuint index, gl::GLenum pname);
static gl::GLint getCounterBits(gl::GLenum target);
virtual void accept(ObjectVisitor& visitor) override;
void begin(gl::GLenum target) const;
void end(gl::GLenum target) const;
void beginIndexed(gl::GLenum target, gl::GLuint index) const;
void endIndexed(gl::GLenum target, gl::GLuint index) const;
static bool isQuery(gl::GLuint id);
gl::GLuint get(gl::GLenum pname) const;
gl::GLuint64 get64(gl::GLenum pname) const;
bool resultAvailable() const;
void wait() const;
void wait(const std::chrono::duration<int, std::nano> & timeout) const;
gl::GLuint waitAndGet(gl::GLenum pname) const;
gl::GLuint64 waitAndGet64(gl::GLenum pname) const;
gl::GLuint waitAndGet(const std::chrono::duration<int, std::nano> & timeout, gl::GLenum pname) const;
gl::GLuint64 waitAndGet64(const std::chrono::duration<int, std::nano> & timeout, gl::GLenum pname) const;
gl::GLuint waitAndGet(gl::GLenum pname, const std::chrono::duration<int, std::nano> & timeout) const;
gl::GLuint64 waitAndGet64(gl::GLenum pname, const std::chrono::duration<int, std::nano> & timeout) const;
void counter() const;
virtual gl::GLenum objectType() const override;
protected:
Query(IDResource * resource);
virtual ~Query();
static gl::GLuint genQuery();
void counter(gl::GLenum target) const;
};
} // namespace globjects
|