gallium: add shadow 1D and 2D array samplers to TGSI
[mesa.git] / src / gallium / include / pipe / p_shader_tokens.h
1 /**************************************************************************
2 *
3 * Copyright 2008 Tungsten Graphics, Inc., Cedar Park, Texas.
4 * Copyright 2009-2010 VMware, Inc.
5 * All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the
9 * "Software"), to deal in the Software without restriction, including
10 * without limitation the rights to use, copy, modify, merge, publish,
11 * distribute, sub license, and/or sell copies of the Software, and to
12 * permit persons to whom the Software is furnished to do so, subject to
13 * the following conditions:
14 *
15 * The above copyright notice and this permission notice (including the
16 * next paragraph) shall be included in all copies or substantial portions
17 * of the Software.
18 *
19 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
21 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
22 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
23 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
24 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
25 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 *
27 **************************************************************************/
28
29 #ifndef P_SHADER_TOKENS_H
30 #define P_SHADER_TOKENS_H
31
32 #ifdef __cplusplus
33 extern "C" {
34 #endif
35
36
37 struct tgsi_header
38 {
39 unsigned HeaderSize : 8;
40 unsigned BodySize : 24;
41 };
42
43 #define TGSI_PROCESSOR_FRAGMENT 0
44 #define TGSI_PROCESSOR_VERTEX 1
45 #define TGSI_PROCESSOR_GEOMETRY 2
46
47 struct tgsi_processor
48 {
49 unsigned Processor : 4; /* TGSI_PROCESSOR_ */
50 unsigned Padding : 28;
51 };
52
53 #define TGSI_TOKEN_TYPE_DECLARATION 0
54 #define TGSI_TOKEN_TYPE_IMMEDIATE 1
55 #define TGSI_TOKEN_TYPE_INSTRUCTION 2
56 #define TGSI_TOKEN_TYPE_PROPERTY 3
57
58 struct tgsi_token
59 {
60 unsigned Type : 4; /**< TGSI_TOKEN_TYPE_x */
61 unsigned NrTokens : 8; /**< UINT */
62 unsigned Padding : 20;
63 };
64
65 enum tgsi_file_type {
66 TGSI_FILE_NULL =0,
67 TGSI_FILE_CONSTANT =1,
68 TGSI_FILE_INPUT =2,
69 TGSI_FILE_OUTPUT =3,
70 TGSI_FILE_TEMPORARY =4,
71 TGSI_FILE_SAMPLER =5,
72 TGSI_FILE_ADDRESS =6,
73 TGSI_FILE_IMMEDIATE =7,
74 TGSI_FILE_PREDICATE =8,
75 TGSI_FILE_SYSTEM_VALUE =9,
76 TGSI_FILE_IMMEDIATE_ARRAY =10,
77 TGSI_FILE_TEMPORARY_ARRAY =11,
78 TGSI_FILE_RESOURCE =12,
79 TGSI_FILE_COUNT /**< how many TGSI_FILE_ types */
80 };
81
82
83 #define TGSI_WRITEMASK_NONE 0x00
84 #define TGSI_WRITEMASK_X 0x01
85 #define TGSI_WRITEMASK_Y 0x02
86 #define TGSI_WRITEMASK_XY 0x03
87 #define TGSI_WRITEMASK_Z 0x04
88 #define TGSI_WRITEMASK_XZ 0x05
89 #define TGSI_WRITEMASK_YZ 0x06
90 #define TGSI_WRITEMASK_XYZ 0x07
91 #define TGSI_WRITEMASK_W 0x08
92 #define TGSI_WRITEMASK_XW 0x09
93 #define TGSI_WRITEMASK_YW 0x0A
94 #define TGSI_WRITEMASK_XYW 0x0B
95 #define TGSI_WRITEMASK_ZW 0x0C
96 #define TGSI_WRITEMASK_XZW 0x0D
97 #define TGSI_WRITEMASK_YZW 0x0E
98 #define TGSI_WRITEMASK_XYZW 0x0F
99
100 #define TGSI_INTERPOLATE_CONSTANT 0
101 #define TGSI_INTERPOLATE_LINEAR 1
102 #define TGSI_INTERPOLATE_PERSPECTIVE 2
103 #define TGSI_INTERPOLATE_COUNT 3
104
105 #define TGSI_CYLINDRICAL_WRAP_X (1 << 0)
106 #define TGSI_CYLINDRICAL_WRAP_Y (1 << 1)
107 #define TGSI_CYLINDRICAL_WRAP_Z (1 << 2)
108 #define TGSI_CYLINDRICAL_WRAP_W (1 << 3)
109
110 struct tgsi_declaration
111 {
112 unsigned Type : 4; /**< TGSI_TOKEN_TYPE_DECLARATION */
113 unsigned NrTokens : 8; /**< UINT */
114 unsigned File : 4; /**< one of TGSI_FILE_x */
115 unsigned UsageMask : 4; /**< bitmask of TGSI_WRITEMASK_x flags */
116 unsigned Interpolate : 4; /**< one of TGSI_INTERPOLATE_x */
117 unsigned Dimension : 1; /**< any extra dimension info? */
118 unsigned Semantic : 1; /**< BOOL, any semantic info? */
119 unsigned Centroid : 1; /**< centroid sampling? */
120 unsigned Invariant : 1; /**< invariant optimization? */
121 unsigned CylindricalWrap:4; /**< TGSI_CYLINDRICAL_WRAP_x flags */
122 };
123
124 struct tgsi_declaration_range
125 {
126 unsigned First : 16; /**< UINT */
127 unsigned Last : 16; /**< UINT */
128 };
129
130 struct tgsi_declaration_dimension
131 {
132 unsigned Index2D:16; /**< UINT */
133 unsigned Padding:16;
134 };
135
136 #define TGSI_SEMANTIC_POSITION 0
137 #define TGSI_SEMANTIC_COLOR 1
138 #define TGSI_SEMANTIC_BCOLOR 2 /**< back-face color */
139 #define TGSI_SEMANTIC_FOG 3
140 #define TGSI_SEMANTIC_PSIZE 4
141 #define TGSI_SEMANTIC_GENERIC 5
142 #define TGSI_SEMANTIC_NORMAL 6
143 #define TGSI_SEMANTIC_FACE 7
144 #define TGSI_SEMANTIC_EDGEFLAG 8
145 #define TGSI_SEMANTIC_PRIMID 9
146 #define TGSI_SEMANTIC_INSTANCEID 10
147 #define TGSI_SEMANTIC_STENCIL 11
148 #define TGSI_SEMANTIC_COUNT 12 /**< number of semantic values */
149
150 struct tgsi_declaration_semantic
151 {
152 unsigned Name : 8; /**< one of TGSI_SEMANTIC_x */
153 unsigned Index : 16; /**< UINT */
154 unsigned Padding : 8;
155 };
156
157 struct tgsi_declaration_resource {
158 unsigned Resource : 8; /**< one of TGSI_TEXTURE_ */
159 unsigned ReturnTypeX : 6; /**< one of enum pipe_type */
160 unsigned ReturnTypeY : 6; /**< one of enum pipe_type */
161 unsigned ReturnTypeZ : 6; /**< one of enum pipe_type */
162 unsigned ReturnTypeW : 6; /**< one of enum pipe_type */
163 };
164
165 #define TGSI_IMM_FLOAT32 0
166 #define TGSI_IMM_UINT32 1
167 #define TGSI_IMM_INT32 2
168
169 struct tgsi_immediate
170 {
171 unsigned Type : 4; /**< TGSI_TOKEN_TYPE_IMMEDIATE */
172 unsigned NrTokens : 14; /**< UINT */
173 unsigned DataType : 4; /**< one of TGSI_IMM_x */
174 unsigned Padding : 10;
175 };
176
177 union tgsi_immediate_data
178 {
179 float Float;
180 unsigned Uint;
181 int Int;
182 };
183
184 #define TGSI_PROPERTY_GS_INPUT_PRIM 0
185 #define TGSI_PROPERTY_GS_OUTPUT_PRIM 1
186 #define TGSI_PROPERTY_GS_MAX_OUTPUT_VERTICES 2
187 #define TGSI_PROPERTY_FS_COORD_ORIGIN 3
188 #define TGSI_PROPERTY_FS_COORD_PIXEL_CENTER 4
189 #define TGSI_PROPERTY_FS_COLOR0_WRITES_ALL_CBUFS 5
190 #define TGSI_PROPERTY_COUNT 6
191
192 struct tgsi_property {
193 unsigned Type : 4; /**< TGSI_TOKEN_TYPE_PROPERTY */
194 unsigned NrTokens : 8; /**< UINT */
195 unsigned PropertyName : 8; /**< one of TGSI_PROPERTY */
196 unsigned Padding : 12;
197 };
198
199 #define TGSI_FS_COORD_ORIGIN_UPPER_LEFT 0
200 #define TGSI_FS_COORD_ORIGIN_LOWER_LEFT 1
201
202 #define TGSI_FS_COORD_PIXEL_CENTER_HALF_INTEGER 0
203 #define TGSI_FS_COORD_PIXEL_CENTER_INTEGER 1
204
205 struct tgsi_property_data {
206 unsigned Data;
207 };
208
209 /* TGSI opcodes.
210 *
211 * For more information on semantics of opcodes and
212 * which APIs are known to use which opcodes, see
213 * gallium/docs/source/tgsi.rst
214 */
215 #define TGSI_OPCODE_ARL 0
216 #define TGSI_OPCODE_MOV 1
217 #define TGSI_OPCODE_LIT 2
218 #define TGSI_OPCODE_RCP 3
219 #define TGSI_OPCODE_RSQ 4
220 #define TGSI_OPCODE_EXP 5
221 #define TGSI_OPCODE_LOG 6
222 #define TGSI_OPCODE_MUL 7
223 #define TGSI_OPCODE_ADD 8
224 #define TGSI_OPCODE_DP3 9
225 #define TGSI_OPCODE_DP4 10
226 #define TGSI_OPCODE_DST 11
227 #define TGSI_OPCODE_MIN 12
228 #define TGSI_OPCODE_MAX 13
229 #define TGSI_OPCODE_SLT 14
230 #define TGSI_OPCODE_SGE 15
231 #define TGSI_OPCODE_MAD 16
232 #define TGSI_OPCODE_SUB 17
233 #define TGSI_OPCODE_LRP 18
234 #define TGSI_OPCODE_CND 19
235 /* gap */
236 #define TGSI_OPCODE_DP2A 21
237 /* gap */
238 #define TGSI_OPCODE_FRC 24
239 #define TGSI_OPCODE_CLAMP 25
240 #define TGSI_OPCODE_FLR 26
241 #define TGSI_OPCODE_ROUND 27
242 #define TGSI_OPCODE_EX2 28
243 #define TGSI_OPCODE_LG2 29
244 #define TGSI_OPCODE_POW 30
245 #define TGSI_OPCODE_XPD 31
246 /* gap */
247 #define TGSI_OPCODE_ABS 33
248 #define TGSI_OPCODE_RCC 34
249 #define TGSI_OPCODE_DPH 35
250 #define TGSI_OPCODE_COS 36
251 #define TGSI_OPCODE_DDX 37
252 #define TGSI_OPCODE_DDY 38
253 #define TGSI_OPCODE_KILP 39 /* predicated kill */
254 #define TGSI_OPCODE_PK2H 40
255 #define TGSI_OPCODE_PK2US 41
256 #define TGSI_OPCODE_PK4B 42
257 #define TGSI_OPCODE_PK4UB 43
258 #define TGSI_OPCODE_RFL 44
259 #define TGSI_OPCODE_SEQ 45
260 #define TGSI_OPCODE_SFL 46
261 #define TGSI_OPCODE_SGT 47
262 #define TGSI_OPCODE_SIN 48
263 #define TGSI_OPCODE_SLE 49
264 #define TGSI_OPCODE_SNE 50
265 #define TGSI_OPCODE_STR 51
266 #define TGSI_OPCODE_TEX 52
267 #define TGSI_OPCODE_TXD 53
268 #define TGSI_OPCODE_TXP 54
269 #define TGSI_OPCODE_UP2H 55
270 #define TGSI_OPCODE_UP2US 56
271 #define TGSI_OPCODE_UP4B 57
272 #define TGSI_OPCODE_UP4UB 58
273 #define TGSI_OPCODE_X2D 59
274 #define TGSI_OPCODE_ARA 60
275 #define TGSI_OPCODE_ARR 61
276 #define TGSI_OPCODE_BRA 62
277 #define TGSI_OPCODE_CAL 63
278 #define TGSI_OPCODE_RET 64
279 #define TGSI_OPCODE_SSG 65 /* SGN */
280 #define TGSI_OPCODE_CMP 66
281 #define TGSI_OPCODE_SCS 67
282 #define TGSI_OPCODE_TXB 68
283 #define TGSI_OPCODE_NRM 69
284 #define TGSI_OPCODE_DIV 70
285 #define TGSI_OPCODE_DP2 71
286 #define TGSI_OPCODE_TXL 72
287 #define TGSI_OPCODE_BRK 73
288 #define TGSI_OPCODE_IF 74
289 /* gap */
290 #define TGSI_OPCODE_ELSE 77
291 #define TGSI_OPCODE_ENDIF 78
292 /* gap */
293 #define TGSI_OPCODE_PUSHA 81
294 #define TGSI_OPCODE_POPA 82
295 #define TGSI_OPCODE_CEIL 83
296 #define TGSI_OPCODE_I2F 84
297 #define TGSI_OPCODE_NOT 85
298 #define TGSI_OPCODE_TRUNC 86
299 #define TGSI_OPCODE_SHL 87
300 /* gap */
301 #define TGSI_OPCODE_AND 89
302 #define TGSI_OPCODE_OR 90
303 #define TGSI_OPCODE_MOD 91
304 #define TGSI_OPCODE_XOR 92
305 #define TGSI_OPCODE_SAD 93
306 #define TGSI_OPCODE_TXF 94
307 #define TGSI_OPCODE_TXQ 95
308 #define TGSI_OPCODE_CONT 96
309 #define TGSI_OPCODE_EMIT 97
310 #define TGSI_OPCODE_ENDPRIM 98
311 #define TGSI_OPCODE_BGNLOOP 99
312 #define TGSI_OPCODE_BGNSUB 100
313 #define TGSI_OPCODE_ENDLOOP 101
314 #define TGSI_OPCODE_ENDSUB 102
315 /* gap */
316 #define TGSI_OPCODE_NOP 107
317 /* gap */
318 #define TGSI_OPCODE_NRM4 112
319 #define TGSI_OPCODE_CALLNZ 113
320 #define TGSI_OPCODE_IFC 114
321 #define TGSI_OPCODE_BREAKC 115
322 #define TGSI_OPCODE_KIL 116 /* conditional kill */
323 #define TGSI_OPCODE_END 117 /* aka HALT */
324 /* gap */
325 #define TGSI_OPCODE_F2I 119
326 #define TGSI_OPCODE_IDIV 120
327 #define TGSI_OPCODE_IMAX 121
328 #define TGSI_OPCODE_IMIN 122
329 #define TGSI_OPCODE_INEG 123
330 #define TGSI_OPCODE_ISGE 124
331 #define TGSI_OPCODE_ISHR 125
332 #define TGSI_OPCODE_ISLT 126
333 #define TGSI_OPCODE_F2U 127
334 #define TGSI_OPCODE_U2F 128
335 #define TGSI_OPCODE_UADD 129
336 #define TGSI_OPCODE_UDIV 130
337 #define TGSI_OPCODE_UMAD 131
338 #define TGSI_OPCODE_UMAX 132
339 #define TGSI_OPCODE_UMIN 133
340 #define TGSI_OPCODE_UMOD 134
341 #define TGSI_OPCODE_UMUL 135
342 #define TGSI_OPCODE_USEQ 136
343 #define TGSI_OPCODE_USGE 137
344 #define TGSI_OPCODE_USHR 138
345 #define TGSI_OPCODE_USLT 139
346 #define TGSI_OPCODE_USNE 140
347 #define TGSI_OPCODE_SWITCH 141
348 #define TGSI_OPCODE_CASE 142
349 #define TGSI_OPCODE_DEFAULT 143
350 #define TGSI_OPCODE_ENDSWITCH 144
351
352 /* resource related opcodes */
353 #define TGSI_OPCODE_LOAD 145
354 #define TGSI_OPCODE_LOAD_MS 146
355 #define TGSI_OPCODE_SAMPLE 147
356 #define TGSI_OPCODE_SAMPLE_B 148
357 #define TGSI_OPCODE_SAMPLE_C 149
358 #define TGSI_OPCODE_SAMPLE_C_LZ 150
359 #define TGSI_OPCODE_SAMPLE_D 151
360 #define TGSI_OPCODE_SAMPLE_L 152
361 #define TGSI_OPCODE_GATHER4 153
362 #define TGSI_OPCODE_RESINFO 154
363 #define TGSI_OPCODE_SAMPLE_POS 155
364 #define TGSI_OPCODE_SAMPLE_INFO 156
365
366 #define TGSI_OPCODE_LAST 157
367
368 #define TGSI_SAT_NONE 0 /* do not saturate */
369 #define TGSI_SAT_ZERO_ONE 1 /* clamp to [0,1] */
370 #define TGSI_SAT_MINUS_PLUS_ONE 2 /* clamp to [-1,1] */
371
372 /**
373 * Opcode is the operation code to execute. A given operation defines the
374 * semantics how the source registers (if any) are interpreted and what is
375 * written to the destination registers (if any) as a result of execution.
376 *
377 * NumDstRegs and NumSrcRegs is the number of destination and source registers,
378 * respectively. For a given operation code, those numbers are fixed and are
379 * present here only for convenience.
380 *
381 * If Predicate is TRUE, tgsi_instruction_predicate token immediately follows.
382 *
383 * Saturate controls how are final results in destination registers modified.
384 */
385
386 struct tgsi_instruction
387 {
388 unsigned Type : 4; /* TGSI_TOKEN_TYPE_INSTRUCTION */
389 unsigned NrTokens : 8; /* UINT */
390 unsigned Opcode : 8; /* TGSI_OPCODE_ */
391 unsigned Saturate : 2; /* TGSI_SAT_ */
392 unsigned NumDstRegs : 2; /* UINT */
393 unsigned NumSrcRegs : 4; /* UINT */
394 unsigned Predicate : 1; /* BOOL */
395 unsigned Label : 1;
396 unsigned Texture : 1;
397 unsigned Padding : 1;
398 };
399
400 /*
401 * If tgsi_instruction::Label is TRUE, tgsi_instruction_label follows.
402 *
403 * If tgsi_instruction::Texture is TRUE, tgsi_instruction_texture follows.
404 * if texture instruction has a number of offsets,
405 * then tgsi_instruction::Texture::NumOffset of tgsi_texture_offset follow.
406 *
407 * Then, tgsi_instruction::NumDstRegs of tgsi_dst_register follow.
408 *
409 * Then, tgsi_instruction::NumSrcRegs of tgsi_src_register follow.
410 *
411 * tgsi_instruction::NrTokens contains the total number of words that make the
412 * instruction, including the instruction word.
413 */
414
415 #define TGSI_SWIZZLE_X 0
416 #define TGSI_SWIZZLE_Y 1
417 #define TGSI_SWIZZLE_Z 2
418 #define TGSI_SWIZZLE_W 3
419
420 struct tgsi_instruction_label
421 {
422 unsigned Label : 24; /* UINT */
423 unsigned Padding : 8;
424 };
425
426 #define TGSI_TEXTURE_UNKNOWN 0
427 #define TGSI_TEXTURE_1D 1
428 #define TGSI_TEXTURE_2D 2
429 #define TGSI_TEXTURE_3D 3
430 #define TGSI_TEXTURE_CUBE 4
431 #define TGSI_TEXTURE_RECT 5
432 #define TGSI_TEXTURE_SHADOW1D 6
433 #define TGSI_TEXTURE_SHADOW2D 7
434 #define TGSI_TEXTURE_SHADOWRECT 8
435 #define TGSI_TEXTURE_1D_ARRAY 9
436 #define TGSI_TEXTURE_2D_ARRAY 10
437 #define TGSI_TEXTURE_SHADOW1D_ARRAY 11
438 #define TGSI_TEXTURE_SHADOW2D_ARRAY 12
439 #define TGSI_TEXTURE_COUNT 13
440
441 struct tgsi_instruction_texture
442 {
443 unsigned Texture : 8; /* TGSI_TEXTURE_ */
444 unsigned NumOffsets : 4;
445 unsigned Padding : 20;
446 };
447
448 /* for texture offsets in GLSL and DirectX.
449 * Generally these always come from TGSI_FILE_IMMEDIATE,
450 * however DX11 appears to have the capability to do
451 * non-constant texture offsets.
452 */
453 struct tgsi_texture_offset
454 {
455 int Index : 16;
456 unsigned File : 4; /**< one of TGSI_FILE_x */
457 unsigned SwizzleX : 2; /* TGSI_SWIZZLE_x */
458 unsigned SwizzleY : 2; /* TGSI_SWIZZLE_x */
459 unsigned SwizzleZ : 2; /* TGSI_SWIZZLE_x */
460 unsigned Padding : 6;
461 };
462
463 /*
464 * For SM3, the following constraint applies.
465 * - Swizzle is either set to identity or replicate.
466 */
467 struct tgsi_instruction_predicate
468 {
469 int Index : 16; /* SINT */
470 unsigned SwizzleX : 2; /* TGSI_SWIZZLE_x */
471 unsigned SwizzleY : 2; /* TGSI_SWIZZLE_x */
472 unsigned SwizzleZ : 2; /* TGSI_SWIZZLE_x */
473 unsigned SwizzleW : 2; /* TGSI_SWIZZLE_x */
474 unsigned Negate : 1; /* BOOL */
475 unsigned Padding : 7;
476 };
477
478 /**
479 * File specifies the register array to access.
480 *
481 * Index specifies the element number of a register in the register file.
482 *
483 * If Indirect is TRUE, Index should be offset by the X component of a source
484 * register that follows. The register can be now fetched into local storage
485 * for further processing.
486 *
487 * If Negate is TRUE, all components of the fetched register are negated.
488 *
489 * The fetched register components are swizzled according to SwizzleX, SwizzleY,
490 * SwizzleZ and SwizzleW.
491 *
492 */
493
494 struct tgsi_src_register
495 {
496 unsigned File : 4; /* TGSI_FILE_ */
497 unsigned Indirect : 1; /* BOOL */
498 unsigned Dimension : 1; /* BOOL */
499 int Index : 16; /* SINT */
500 unsigned SwizzleX : 2; /* TGSI_SWIZZLE_ */
501 unsigned SwizzleY : 2; /* TGSI_SWIZZLE_ */
502 unsigned SwizzleZ : 2; /* TGSI_SWIZZLE_ */
503 unsigned SwizzleW : 2; /* TGSI_SWIZZLE_ */
504 unsigned Absolute : 1; /* BOOL */
505 unsigned Negate : 1; /* BOOL */
506 };
507
508 /**
509 * If tgsi_src_register::Modifier is TRUE, tgsi_src_register_modifier follows.
510 *
511 * Then, if tgsi_src_register::Indirect is TRUE, another tgsi_src_register
512 * follows.
513 *
514 * Then, if tgsi_src_register::Dimension is TRUE, tgsi_dimension follows.
515 */
516
517
518 struct tgsi_dimension
519 {
520 unsigned Indirect : 1; /* BOOL */
521 unsigned Dimension : 1; /* BOOL */
522 unsigned Padding : 14;
523 int Index : 16; /* SINT */
524 };
525
526 struct tgsi_dst_register
527 {
528 unsigned File : 4; /* TGSI_FILE_ */
529 unsigned WriteMask : 4; /* TGSI_WRITEMASK_ */
530 unsigned Indirect : 1; /* BOOL */
531 unsigned Dimension : 1; /* BOOL */
532 int Index : 16; /* SINT */
533 unsigned Padding : 6;
534 };
535
536
537 #ifdef __cplusplus
538 }
539 #endif
540
541 #endif /* P_SHADER_TOKENS_H */