2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
27 * \file prog_instruction.h
29 * Vertex/fragment program instruction datatypes and constants.
32 * \author Keith Whitwell
33 * \author Ian Romanick <idr@us.ibm.com>
37 #ifndef PROG_INSTRUCTION_H
38 #define PROG_INSTRUCTION_H
41 #include "main/glheader.h"
53 #define SWIZZLE_ZERO 4 /**< For SWZ instruction only */
54 #define SWIZZLE_ONE 5 /**< For SWZ instruction only */
55 #define SWIZZLE_NIL 7 /**< used during shader code gen (undefined value) */
58 #define MAKE_SWIZZLE4(a,b,c,d) (((a)<<0) | ((b)<<3) | ((c)<<6) | ((d)<<9))
59 #define SWIZZLE_NOOP MAKE_SWIZZLE4(0,1,2,3)
60 #define GET_SWZ(swz, idx) (((swz) >> ((idx)*3)) & 0x7)
61 #define GET_BIT(msk, idx) (((msk) >> (idx)) & 0x1)
62 /** Determine if swz contains SWIZZLE_ZERO/ONE/NIL for any components. */
63 #define HAS_EXTENDED_SWIZZLE(swz) (swz & 0x924)
65 #define SWIZZLE_XYZW MAKE_SWIZZLE4(SWIZZLE_X, SWIZZLE_Y, SWIZZLE_Z, SWIZZLE_W)
66 #define SWIZZLE_XXXX MAKE_SWIZZLE4(SWIZZLE_X, SWIZZLE_X, SWIZZLE_X, SWIZZLE_X)
67 #define SWIZZLE_YYYY MAKE_SWIZZLE4(SWIZZLE_Y, SWIZZLE_Y, SWIZZLE_Y, SWIZZLE_Y)
68 #define SWIZZLE_ZZZZ MAKE_SWIZZLE4(SWIZZLE_Z, SWIZZLE_Z, SWIZZLE_Z, SWIZZLE_Z)
69 #define SWIZZLE_WWWW MAKE_SWIZZLE4(SWIZZLE_W, SWIZZLE_W, SWIZZLE_W, SWIZZLE_W)
73 * Writemask values, 1 bit per component.
76 #define WRITEMASK_X 0x1
77 #define WRITEMASK_Y 0x2
78 #define WRITEMASK_XY 0x3
79 #define WRITEMASK_Z 0x4
80 #define WRITEMASK_XZ 0x5
81 #define WRITEMASK_YZ 0x6
82 #define WRITEMASK_XYZ 0x7
83 #define WRITEMASK_W 0x8
84 #define WRITEMASK_XW 0x9
85 #define WRITEMASK_YW 0xa
86 #define WRITEMASK_XYW 0xb
87 #define WRITEMASK_ZW 0xc
88 #define WRITEMASK_XZW 0xd
89 #define WRITEMASK_YZW 0xe
90 #define WRITEMASK_XYZW 0xf
95 * Per-component negation masks
102 #define NEGATE_XYZ 0x7
103 #define NEGATE_XYZW 0xf
104 #define NEGATE_NONE 0x0
109 * Program instruction opcodes for vertex, fragment and geometry programs.
112 /* ARB_vp ARB_fp NV_vp NV_fp GLSL */
113 /*------------------------------------------*/
114 OPCODE_NOP
= 0, /* X */
115 OPCODE_ABS
, /* X X 1.1 X */
116 OPCODE_ADD
, /* X X X X X */
117 OPCODE_ARL
, /* X X X */
118 OPCODE_BGNLOOP
, /* opt */
119 OPCODE_BGNSUB
, /* opt */
120 OPCODE_BRK
, /* 2 opt */
121 OPCODE_CAL
, /* 2 2 opt */
122 OPCODE_CMP
, /* X X */
123 OPCODE_CONT
, /* opt */
124 OPCODE_COS
, /* X 2 X X */
125 OPCODE_DDX
, /* X X */
126 OPCODE_DDY
, /* X X */
127 OPCODE_DP2
, /* 2 X */
128 OPCODE_DP3
, /* X X X X X */
129 OPCODE_DP4
, /* X X X X X */
130 OPCODE_DPH
, /* X X 1.1 */
131 OPCODE_DST
, /* X X X X */
132 OPCODE_ELSE
, /* opt */
133 OPCODE_END
, /* X X X X opt */
134 OPCODE_ENDIF
, /* opt */
135 OPCODE_ENDLOOP
, /* opt */
136 OPCODE_ENDSUB
, /* opt */
137 OPCODE_EX2
, /* X X 2 X X */
138 OPCODE_EXP
, /* X X */
139 OPCODE_FLR
, /* X X 2 X X */
140 OPCODE_FRC
, /* X X 2 X X */
142 OPCODE_KIL
, /* X X */
143 OPCODE_LG2
, /* X X 2 X X */
144 OPCODE_LIT
, /* X X X X */
145 OPCODE_LOG
, /* X X */
146 OPCODE_LRP
, /* X X */
147 OPCODE_MAD
, /* X X X X X */
148 OPCODE_MAX
, /* X X X X X */
149 OPCODE_MIN
, /* X X X X X */
150 OPCODE_MOV
, /* X X X X X */
151 OPCODE_MUL
, /* X X X X X */
152 OPCODE_NOISE1
, /* X */
153 OPCODE_NOISE2
, /* X */
154 OPCODE_NOISE3
, /* X */
155 OPCODE_NOISE4
, /* X */
156 OPCODE_POW
, /* X X X X */
157 OPCODE_RCP
, /* X X X X X */
158 OPCODE_RET
, /* 2 2 opt */
159 OPCODE_RSQ
, /* X X X X X */
160 OPCODE_SCS
, /* X X */
161 OPCODE_SEQ
, /* 2 X X */
162 OPCODE_SGE
, /* X X X X X */
163 OPCODE_SGT
, /* 2 X X */
164 OPCODE_SIN
, /* X 2 X X */
165 OPCODE_SLE
, /* 2 X X */
166 OPCODE_SLT
, /* X X X X X */
167 OPCODE_SNE
, /* 2 X X */
168 OPCODE_SSG
, /* 2 X */
169 OPCODE_SUB
, /* X X 1.1 X X */
170 OPCODE_SWZ
, /* X X X */
171 OPCODE_TEX
, /* X 3 X X */
172 OPCODE_TXB
, /* X 3 X */
173 OPCODE_TXD
, /* X X */
174 OPCODE_TXL
, /* 3 2 X */
175 OPCODE_TXP
, /* X X */
176 OPCODE_TRUNC
, /* X */
177 OPCODE_XPD
, /* X X */
183 * Number of bits for the src/dst register Index field.
184 * This limits the size of temp/uniform register files.
186 #define INST_INDEX_BITS 12
190 * Instruction source register.
192 struct prog_src_register
194 GLuint File
:4; /**< One of the PROGRAM_* register file values. */
195 GLint Index
:(INST_INDEX_BITS
+1); /**< Extra bit here for sign bit.
196 * May be negative for relative addressing.
203 * This will either be NEGATE_NONE or NEGATE_XYZW, except for the SWZ
204 * instruction which allows per-component negation.
211 * Instruction destination register.
213 struct prog_dst_register
215 GLuint File
:4; /**< One of the PROGRAM_* register file values */
216 GLuint Index
:INST_INDEX_BITS
; /**< Unsigned, never negative */
223 * Vertex/fragment program instruction.
225 struct prog_instruction
227 enum prog_opcode Opcode
;
228 struct prog_src_register SrcReg
[3];
229 struct prog_dst_register DstReg
;
232 * Saturate each value of the vectored result to the range [0,1].
235 * ARB_fragment_program
240 * \name Extra fields for TEX, TXB, TXD, TXL, TXP instructions.
243 /** Source texture unit. */
246 /** Source texture target, one of TEXTURE_{1D,2D,3D,CUBE,RECT}_INDEX */
247 GLuint TexSrcTarget
:4;
249 /** True if tex instruction should do shadow comparison */
254 * For BRA and CAL instructions, the location to jump to.
255 * For BGNLOOP, points to ENDLOOP (and vice-versa).
256 * For BRK, points to ENDLOOP
257 * For IF, points to ELSE or ENDIF.
258 * For ELSE, points to ENDIF.
262 /** for debugging purposes */
272 _mesa_init_instructions(struct prog_instruction
*inst
, GLuint count
);
274 extern struct prog_instruction
*
275 _mesa_alloc_instructions(GLuint numInst
);
277 extern struct prog_instruction
*
278 _mesa_copy_instructions(struct prog_instruction
*dest
,
279 const struct prog_instruction
*src
, GLuint n
);
282 _mesa_free_instructions(struct prog_instruction
*inst
, GLuint count
);
285 _mesa_num_inst_src_regs(enum prog_opcode opcode
);
288 _mesa_num_inst_dst_regs(enum prog_opcode opcode
);
291 _mesa_is_tex_instruction(enum prog_opcode opcode
);
294 _mesa_check_soa_dependencies(const struct prog_instruction
*inst
);
297 _mesa_opcode_string(enum prog_opcode opcode
);
304 #endif /* PROG_INSTRUCTION_H */