2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2005 Brian Paul All Rights Reserved.
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 * \file prog_instruction.h
29 * Private vertex program types and constants only used by files
30 * related to vertex programs.
33 * \author Keith Whitwell
34 * \author Ian Romanick <idr@us.ibm.com>
38 #ifndef PROG_INSTRUCTION_H
39 #define PROG_INSTRUCTION_H
42 * Condition codes for GL_NV_fragment_program
45 #define COND_GT 1 /* greater than zero */
46 #define COND_EQ 2 /* equal to zero */
47 #define COND_LT 3 /* less than zero */
48 #define COND_UN 4 /* unordered (NaN) */
49 #define COND_GE 5 /* greater then or equal to zero */
50 #define COND_LE 6 /* less then or equal to zero */
51 #define COND_NE 7 /* not equal to zero */
52 #define COND_TR 8 /* always true */
53 #define COND_FL 9 /* always false */
58 * Instruction precision for GL_NV_fragment_program
68 * Program instruction opcodes, for both vertex and fragment programs.
69 * \note changes to this opcode list must be reflected in t_vb_arbprogram.c
71 /* ARB_vp ARB_fp NV_vp NV_fp */
72 enum prog_opcode
{ /*---------------------------------*/
73 OPCODE_ABS
, /* X 1.1 */
74 OPCODE_ADD
, /* X X X X */
80 OPCODE_DP3
, /* X X X X */
81 OPCODE_DP4
, /* X X X X */
82 OPCODE_DPH
, /* X X 1.1 */
83 OPCODE_DST
, /* X X X */
84 OPCODE_END
, /* X X X X */
85 OPCODE_EX2
, /* X X 2 X */
87 OPCODE_FLR
, /* X X 2 X */
88 OPCODE_FRC
, /* X X 2 X */
90 OPCODE_KIL_NV
, /* X */
91 OPCODE_LG2
, /* X X 2 X */
92 OPCODE_LIT
, /* X X X X */
93 OPCODE_LOG
, /* X X X */
95 OPCODE_MAD
, /* X X X X */
96 OPCODE_MAX
, /* X X X X */
97 OPCODE_MIN
, /* X X X X */
98 OPCODE_MOV
, /* X X X X */
99 OPCODE_MUL
, /* X X X X */
101 OPCODE_PK2US
, /* X */
103 OPCODE_PK4UB
, /* X */
104 OPCODE_POW
, /* X X X */
105 OPCODE_PRINT
, /* X X */
106 OPCODE_RCC
, /* 1.1 */
107 OPCODE_RCP
, /* X X X X */
108 OPCODE_RFL
, /* X X */
109 OPCODE_RSQ
, /* X X X X */
111 OPCODE_SEQ
, /* 2 X */
112 OPCODE_SFL
, /* 2 X */
113 OPCODE_SGE
, /* X X X X */
114 OPCODE_SGT
, /* 2 X */
115 OPCODE_SIN
, /* X 2 X */
116 OPCODE_SLE
, /* 2 X */
117 OPCODE_SLT
, /* X X X X */
118 OPCODE_SNE
, /* 2 X */
119 OPCODE_STR
, /* X 2 X */
120 OPCODE_SUB
, /* X X 1.1 X */
121 OPCODE_SWZ
, /* X X */
122 OPCODE_TEX
, /* X X */
124 OPCODE_TXD
, /* X X */
126 OPCODE_TXP_NV
, /* X */
128 OPCODE_UP2US
, /* X */
130 OPCODE_UP4UB
, /* X */
132 OPCODE_XPD
, /* X X */
134 OPCODE_ARA
, /* NV_vertex_program2 */
135 OPCODE_ARL_NV
, /* NV_vertex_program2 */
136 OPCODE_ARR
, /* NV_vertex_program2 */
138 OPCODE_SEQ
, /* NV_vertex_program2 */
139 OPCODE_SFL
, /* NV_vertex_program2 */
140 OPCODE_SGT
, /* NV_vertex_program2 */
141 OPCODE_SLE
, /* NV_vertex_program2 */
142 OPCODE_SNE
, /* NV_vertex_program2 */
143 OPCODE_STR
, /* NV_vertex_program2 */
145 OPCODE_SSG
, /* NV_vertex_program2 */
146 OPCODE_COS
, /* NV_vertex_program2 */
147 OPCODE_SIN
, /* NV_vertex_program2 */
149 OPCODE_BRA
, /* NV_vertex_program2 */
150 OPCODE_CAL
, /* NV_vertex_program2 */
151 OPCODE_RET
, /* NV_vertex_program2 */
153 OPCODE_PUSHA
, /* NV_vertex_program3 */
154 OPCODE_POPA
, /* NV_vertex_program3 */
156 OPCODE_TEX
, /* NV_vertex_program3 */
157 OPCODE_TXB
, /* NV_vertex_program3 */
158 OPCODE_TXL
, /* NV_vertex_program3 */
159 OPCODE_TXP
, /* NV_vertex_program3 */
166 * Instruction source register.
168 struct prog_src_register
170 GLuint File
:4; /**< One of the PROGRAM_* register file values. */
171 GLint Index
:9; /**< May be negative for relative addressing. */
176 * \name Source register "sign" control.
178 * The ARB and NV extensions allow varrying degrees of control over the
179 * sign of the source vector components. These values allow enough control
180 * for all flavors of the extensions.
184 * Per-component negation for the SWZ instruction.
187 * ARB_vertex_program, ARB_fragment_program
192 * Take the component-wise absolute value.
195 * NV_fragment_program, NV_fragment_program_option, NV_vertex_program2,
196 * NV_vertex_program2_option.
201 * Take the component-wise negation. The negation occurs \b after the
202 * (optional) absolute value operation.
210 * Instruction destination register.
212 struct prog_dst_register
215 * One of the PROGRAM_* register file values.
223 * \name Conditional destination update control.
226 * NV_fragment_program, NV_fragment_program_option, NV_vertex_program2,
227 * NV_vertex_program2_option.
231 * Takes one of the 9 possible condition values (EQ, FL, GT, GE, LE, LT,
232 * NE, TR, or UN). Destination update is enabled if the matching
233 * (swizzled) condition code value passes. When a conditional update mask
234 * is not specified, this will be \c COND_TR.
239 * Condition code swizzle value.
241 GLuint CondSwizzle
:12;
244 * Selects the condition code register to use for conditional destination
245 * update masking. In NV_fragmnet_program or NV_vertex_program2 mode, only
246 * condition code register 0 is available. In NV_vertex_program3 mode,
247 * condition code registers 0 and 1 are available.
257 * Vertex/fragment program instruction.
259 struct prog_instruction
261 enum prog_opcode Opcode
;
262 #if FEATURE_MESA_program_debug
266 * Arbitrary data. Used for the PRINT, CAL, and BRA instructions.
270 struct prog_src_register SrcReg
[3];
271 struct prog_dst_register DstReg
;
274 * Indicates that the instruction should update the condition code
278 * NV_fragment_program, NV_fragment_program_option, NV_vertex_program2,
279 * NV_vertex_program2_option.
284 * If prog_instruction::cc_update is \c GL_TRUE, this value selects the
285 * condition code register that is to be updated.
287 * In GL_NV_fragment_program or GL_NV_vertex_program2 mode, only condition
288 * code register 0 is available. In GL_NV_vertex_program3 mode, condition code registers
289 * 0 and 1 are available.
292 * NV_fragment_program, NV_fragment_program_option, NV_vertex_program2,
293 * NV_vertex_program2_option.
298 * Saturate each value of the vectored result to the range [0,1] or the
299 * range [-1,1]. \c SSAT mode (i.e., saturation to the range [-1,1]) is
300 * only available in NV_fragment_program2 mode.
303 * NV_fragment_program, NV_fragment_program_option, NV_vertex_program3.
308 * Per-instruction selectable precision.
311 * NV_fragment_program, NV_fragment_program_option.
316 * \name Texture source controls.
318 * The texture source controls are only used with the \c TEX, \c TXD,
319 * \c TXL, and \c TXP instructions.
322 * ARB_fragment_program, NV_fragment_program, NV_vertex_program3.
326 * Source texture unit. OpenGL supports a maximum of 32 texture
332 * Source texture target (e.g., GL_TEXTURE_1D, GL_TEXTURE_2D,
333 * GL_TEXTURE_3D, GL_TEXTURE_CUBE, GL_TEXTURE_RECTANGLE_ARB).
335 GLuint TexSrcTarget
:3;
341 _mesa_init_instruction(struct prog_instruction
*inst
);
344 _mesa_num_inst_src_regs(enum prog_opcode opcode
);
347 _mesa_opcode_string(enum prog_opcode opcode
);
350 _mesa_program_file_string(enum register_file f
);
352 #endif /* PROG_INSTRUCTION_H */