]> git.cworth.org Git - apitrace/blob - trace_write.hpp
More efficient bitmask representation.
[apitrace] / trace_write.hpp
1 /**************************************************************************
2  *
3  * Copyright 2007-2010 VMware, Inc.
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to deal
8  * in the Software without restriction, including without limitation the rights
9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10  * copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22  * THE SOFTWARE.
23  *
24  **************************************************************************/
25
26 #ifndef _TRACE_WRITE_HPP_
27 #define _TRACE_WRITE_HPP_
28
29 namespace Trace {
30
31     typedef unsigned Id;
32
33     struct BitmaskVal {
34         const char *name;
35         unsigned long long value;
36     };
37
38     struct BitmaskSig {
39         Id id;
40         unsigned count;
41         const BitmaskVal *values;
42     };
43
44     void Open(void);
45     void Close(void);
46     
47     unsigned BeginEnter(const char *function);
48     void EndEnter(void);
49     
50     void BeginLeave(unsigned call);
51     void EndLeave(void);
52     
53     void BeginArg(unsigned index, const char *name);
54     inline void EndArg(void) {}
55
56     void BeginReturn(void);
57     inline void EndReturn(void) {}
58
59     void BeginArray(size_t length);
60     inline void EndArray(void) {}
61
62     inline void BeginElement(void) {}
63     inline void EndElement(void) {}
64
65     void BeginStruct(size_t length);
66     inline void EndStruct(void) {}
67
68     void BeginMember(const char *name);
69     inline void EndMember(void) {}
70
71     void LiteralBool(bool value);
72     void LiteralSInt(signed long long value);
73     void LiteralUInt(unsigned long long value);
74     void LiteralFloat(float value);
75     void LiteralFloat(double value);
76     void LiteralString(const char *str);
77     void LiteralString(const char *str, size_t size);
78     void LiteralWString(const wchar_t *str);
79     void LiteralBlob(const void *data, size_t size);
80     void LiteralNamedConstant(const char *name, long long value);
81     void LiteralBitmask(const BitmaskSig &bitmask, unsigned long long value);
82     void LiteralNull(void);
83     void LiteralOpaque(const void *ptr);
84
85     void Abort(void);
86 }
87
88 #endif /* _TRACE_WRITE_HPP_ */