• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1XXX - incomplete
2
3Name
4
5    SGIX_ir_instrument1
6
7Name Strings
8
9    GL_SGIX_ir_instrument1
10
11Version
12
13    $Date: 1997/09/18 01:12:44 $ $Revision: 1.4 $
14
15Number
16
17    81
18
19Dependencies
20
21    SGIX_instruments is required
22
23Overview
24
25New Procedures and Functions
26
27    None
28
29New Tokens
30
31    Accepted by the <cap> parameter of Enable, Disable and IsEnabled:
32
33        IR_INSTRUMENT1_SGIX
34
35Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
36
37    None
38
39Additions to Chapter 3 of the 1.0 Specification (Rasterization)
40
41    None
42
43Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations
44and the Frame Buffer)
45
46    None
47
48Additions to Chapter 5 of the 1.0 Specification (Special Functions)
49
50    Add to section 5.X entitled  Instruments:
51
52    Each implementation may require its own set of instruments.  An
53    enum for the instrument must be passed to Enable to enable
54    measurements of that instrument.
55
56    The format of any instrument measurement in the buffer should obey
57    some conventions. The first word of the measurement should be the
58    enum for the instrument itself. The second word of the measurement
59    should be the size in words of the entire measurement so that any
60    parser can step over measurements with which it is unfamiliar.
61
62    The IR_INSTRUMENT1_SGIX measurement uses 10 words of the buffer.
63    The first (index 0) will be the IR_INSTRUMENT1_SGIX enum itself,
64    the second word (index 1) will be 10. The following words are
65
66    COUNTEMPTY (index 2)
67    Increments each time a datum such as a word of screen-space
68    geometry, or word of a pixel or texel could have been written to
69    next stage of the GL pipeline, but wasn't because there was no
70    data to write. This is an indication of back-end starvation.  The
71    counter is set to zero as a result of calling StartInstrumentsSGIX
72    and set to zero by ReadInstrumentsSGIX after the value has been
73    read and written back to the buffer.
74
75    COUNTDRAW (index 3)
76    Increments each time a datam such as a word of screen-space
77    geometry, or word of a pixel is written to the next stage of the
78    geometry pipeline.  The counter is set to zero as a result of
79    calling StartInstrumentsSGIX and set to zero by
80    ReadInstrumentsSGIX after the value has been read and written back
81    to the buffer.
82
83    COUNTLOAD (index 4)
84    Increments each time a texture load datum is written to the
85    texture memory.  The counter is set to zero as a result of calling
86    StartInstrumentsSGIX and set to zero by ReadInstrumentsSGIX after
87    the value has been read and written back to the buffer.
88
89    MAILBOX_TIMESTAMP (index 5)
90    Holds the value of COUNTALL at the time MAILBOX is written as a
91    result of calling StartInstrumentsSGIX or ReadInstrumentsSGIX.
92
93    COUNTALL (index 6)
94    Increments every 50mhz clock cycle. No effort to prevent wrapping
95    is made.
96
97    PAD (index 7)
98    Unused
99
100    MARKER (index 8)
101    Holds the value of marker passed to StopInstrumentsSGIX or
102    ReadInstrumentsSGIX for this measurement.
103
104    MAILBOX (index 9)
105    Holds a value that is used by the implementation. Typically a
106    sequence identifier, set after the buffer as been reset, starting
107    at 1 with the first measurement and incrementing by 1 for each
108    successive measurement.
109
110Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
111
112    None
113
114Additions to the GLX Specification
115
116    None
117
118GLX Protocol
119
120    None
121
122Errors
123
124    None
125
126New Implementation Dependent State
127
128    None
129
130