• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright 2009 Nicolai Hähnle <nhaehnle@gmail.com>
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * on the rights to use, copy, modify, merge, publish, distribute, sub
8  * license, and/or sell copies of the Software, and to permit persons to whom
9  * the Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
18  * THE AUTHOR(S) AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
19  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
20  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
21  * USE OR OTHER DEALINGS IN THE SOFTWARE. */
22 
23 #ifndef RADEON_COMPILER_H
24 #define RADEON_COMPILER_H
25 
26 #include <stdbool.h>
27 
28 #include "memory_pool.h"
29 #include "radeon_code.h"
30 #include "radeon_program.h"
31 
32 #define RC_DBG_LOG        (1 << 0)
33 
34 struct rc_swizzle_caps;
35 
36 enum rc_program_type {
37 	RC_VERTEX_PROGRAM,
38 	RC_FRAGMENT_PROGRAM,
39 	RC_NUM_PROGRAM_TYPES
40 };
41 
42 struct radeon_compiler {
43 	struct memory_pool Pool;
44 	struct rc_program Program;
45 	const struct rc_regalloc_state *regalloc_state;
46 	struct util_debug_callback *debug;
47 	enum rc_program_type type;
48 	unsigned Debug:2;
49 	unsigned Error:1;
50 	char * ErrorMsg;
51 
52 	/* Hardware specification. */
53 	unsigned is_r400:1;
54 	unsigned is_r500:1;
55 	unsigned has_half_swizzles:1;
56 	unsigned has_presub:1;
57 	unsigned has_omod:1;
58 	unsigned disable_optimizations:1;
59 	unsigned max_temp_regs;
60 	unsigned max_constants;
61 	int max_alu_insts;
62 	unsigned max_tex_insts;
63 
64 	int max_temp_index;
65 
66 	/* Whether to remove unused constants and empty holes in constant space. */
67 	unsigned remove_unused_constants:1;
68 
69 	/**
70 	 * Variables used internally, not be touched by callers
71 	 * of the compiler
72 	 */
73 	/*@{*/
74 	const struct rc_swizzle_caps * SwizzleCaps;
75 	/*@}*/
76 };
77 
78 void rc_init(struct radeon_compiler * c, const struct rc_regalloc_state *rs);
79 void rc_destroy(struct radeon_compiler * c);
80 
81 void rc_debug(struct radeon_compiler * c, const char * fmt, ...);
82 void rc_error(struct radeon_compiler * c, const char * fmt, ...);
83 
84 int rc_if_fail_helper(struct radeon_compiler * c, const char * file, int line, const char * assertion);
85 
86 /**
87  * This macro acts like an if-statement that can be used to implement
88  * non-aborting assertions in the compiler.
89  *
90  * It checks whether \p cond is true. If not, an internal compiler error is
91  * flagged and the if-clause is run.
92  *
93  * A typical use-case would be:
94  *
95  *  if (rc_assert(c, condition-that-must-be-true))
96  *  	return;
97  */
98 #define rc_assert(c, cond) \
99 	(!(cond) && rc_if_fail_helper(c, __FILE__, __LINE__, #cond))
100 
101 void rc_mark_unused_channels(struct radeon_compiler * c, void *user);
102 void rc_calculate_inputs_outputs(struct radeon_compiler * c);
103 void rc_copy_output(struct radeon_compiler * c, unsigned output, unsigned dup_output);
104 void rc_transform_fragment_wpos(struct radeon_compiler * c, unsigned wpos, unsigned new_input,
105                                 int full_vtransform);
106 void rc_transform_fragment_face(struct radeon_compiler *c, unsigned face);
107 
108 struct r300_fragment_program_compiler {
109 	struct radeon_compiler Base;
110 	struct rX00_fragment_program_code *code;
111 	/* Optional transformations and features. */
112 	struct r300_fragment_program_external_state state;
113 	/* Register corresponding to the depthbuffer. */
114 	unsigned OutputDepth;
115 	/* Registers corresponding to the four colorbuffers. */
116 	unsigned OutputColor[4];
117 
118 	void * UserData;
119 	void (*AllocateHwInputs)(
120 		struct r300_fragment_program_compiler * c,
121 		void (*allocate)(void * data, unsigned input, unsigned hwreg),
122 		void * mydata);
123 };
124 
125 void r3xx_compile_fragment_program(struct r300_fragment_program_compiler* c);
126 
127 struct r300_vertex_program_compiler {
128 	struct radeon_compiler Base;
129 	struct r300_vertex_program_code *code;
130 	uint32_t RequiredOutputs;
131 
132 	void * UserData;
133 	void (*SetHwInputOutput)(struct r300_vertex_program_compiler * c);
134 
135 };
136 
137 void r3xx_compile_vertex_program(struct r300_vertex_program_compiler* c);
138 void rc_vert_fc(struct radeon_compiler *compiler, void *user);
139 void r300_vertex_program_dump(struct radeon_compiler *compiler, void *user);
140 
141 struct radeon_compiler_pass {
142 	const char *name;	/* Name of the pass. */
143 	int dump;		/* Dump the program if Debug == 1? */
144 	int predicate;		/* Run this pass? */
145 	void (*run)(struct radeon_compiler *c, void *user); /* The main entrypoint. */
146 	void *user;		/* Optional parameter which is passed to the run function. */
147 };
148 
149 struct rc_program_stats {
150 	unsigned num_cycles;
151 	unsigned num_consts;
152 	unsigned num_insts;
153 	unsigned num_fc_insts;
154 	unsigned num_tex_insts;
155 	unsigned num_rgb_insts;
156 	unsigned num_alpha_insts;
157 	unsigned num_pred_insts;
158 	unsigned num_presub_ops;
159 	unsigned num_temp_regs;
160 	unsigned num_omod_ops;
161 	unsigned num_inline_literals;
162 	unsigned num_loops;
163 };
164 
165 void rc_get_stats(struct radeon_compiler *c, struct rc_program_stats *s);
166 
167 /* Executes a list of compiler passes given in the parameter 'list'. */
168 bool rc_run_compiler_passes(struct radeon_compiler *c, struct radeon_compiler_pass *list);
169 void rc_run_compiler(struct radeon_compiler *c, struct radeon_compiler_pass *list);
170 void rc_validate_final_shader(struct radeon_compiler *c, void *user);
171 
172 #endif /* RADEON_COMPILER_H */
173