1bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard/* 2bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * Copyright 2011-2012 Advanced Micro Devices, Inc. 3bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * All Rights Reserved. 4bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 5bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * Permission is hereby granted, free of charge, to any person obtaining a 6bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * copy of this software and associated documentation files (the 7bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * "Software"), to deal in the Software without restriction, including 8bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * without limitation the rights to use, copy, modify, merge, publish, 9bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * distribute, sub license, and/or sell copies of the Software, and to 10bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * permit persons to whom the Software is furnished to do so, subject to 11bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * the following conditions: 12bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 13bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * The above copyright notice and this permission notice (including the 14bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * next paragraph) shall be included in all copies or substantial portions 15bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * of the Software. 16bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 17bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 18bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 19bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 20bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR 21bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 22bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 23bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 24bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 25bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard **************************************************************************/ 26bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 27bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard/** 28bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 29bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * @author Tom Stellard <thomas.stellard@amd.com> 30bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 31bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 32bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 33bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 34bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard#ifndef LP_BLD_TGSI_ACTION_H 35bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard#define LP_BLD_TGSI_ACTION_H 36bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 37bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard#include <llvm-c/Core.h> 38bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 39bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardstruct lp_build_tgsi_context; 40bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 41bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardstruct lp_build_emit_data { 42bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** Arguments that are passed to lp_build_tgsi_action::emit. The 43bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * order of the arguments should be as follows: 44bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * SOA: s0.x, s0.y, s0.z, s0.w, s1.x, s1.y, s1.z, s1.w, s2.x, s2.y, s2.x, s2.w 45bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * AOS: s0.xyzw, s1.xyzw, s2.xyzw 46bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * TEXTURE Instructions: coord.xyzw 47bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 48bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * Arguments should be packed into the args array. For example an SOA 49bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * instructions that reads s0.x and s1.x args should look like this: 50bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * args[0] = s0.x; 51bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * args[1] = s1.x; 52bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 53bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard LLVMValueRef args[12]; 54bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 55bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 56bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * Number of arguments in the args array. 57bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 58bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard unsigned arg_count; 59bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 60bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 61bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * The type output type of the opcode. This should be set in the 62bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * lp_build_tgsi_action::fetch_args function. 63bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 64bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard LLVMTypeRef dst_type; 65bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 66bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** This is used by the lp_build_tgsi_action::fetch_args function to 67bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * determine which channel to read from the opcode arguments. It also 68bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * specifies which index of the output array should be written to by 69bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * the lp_build_tgsi_action::emit function. However, this value is 70bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * usually ignored by any opcodes that are not TGSI_OUTPUT_COMPONENTWISE. 71bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 72bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard unsigned chan; 73bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 74bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** The lp_build_tgsi_action::emit 'executes' the opcode and writes the 75bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * results to this array. 76bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 77bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard LLVMValueRef output[4]; 78bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 79bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 80bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * The current instruction that is being 'executed'. 81bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 82bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard const struct tgsi_full_instruction * inst; 83bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard const struct tgsi_opcode_info * info; 84bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard}; 85bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 86bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardstruct lp_build_tgsi_action 87bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard{ 88bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 89bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 90bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * This function is responsible for doing 2-3 things: 91bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 1. Fetching the instruction arguments into the emit_data->args array. 92bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 2. Setting the number of arguments in emit_data->arg_count. 93bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * 3. Setting the destination type in emit_data->dst_type (usually only 94bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * necessary for opcodes that are TGSI_OUTPUT_COMPONENTWISE). 95bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 96bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard void (*fetch_args)(struct lp_build_tgsi_context *, 97bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard struct lp_build_emit_data *); 98bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 99bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 100bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 101bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * This function is responsible for emitting LLVM IR for a TGSI opcode. 102bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * It should store the values it generates in the emit_data->output array 103bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * and for TGSI_OUTPUT_COMPONENTWISE and TGSI_OUTPUT_REPLICATE instructions 104bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * (and possibly others depending on the specific implementation), it should 105bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * make sure to store the values in the array slot indexed by emit_data->chan. 106bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 107bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard void (*emit)(const struct lp_build_tgsi_action *, 108bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard struct lp_build_tgsi_context *, 109bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard struct lp_build_emit_data *); 110bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 111bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard /** 112bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * This variable can be used to store an intrinsic name, in case the TGSI 113bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * opcode will be replaced by a target specific intrinsic. (There is a 114bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * convenience function in lp_bld_tgsi.c called lp_build_tgsi_intrinsic() 115bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * that can be assigned to lp_build_tgsi_action::emit and used for 116bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * generating intrinsics). 117bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 118bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard const char * intr_name; 119bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard}; 120bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 121bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard/** 122bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * This function initializes the bld_base->op_actions array with some 123bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * generic operand actions. 124bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 125bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardvoid 126bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardlp_set_default_actions( 127bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard struct lp_build_tgsi_context * bld_base); 128bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 129bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard/* 130bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * This function initialize the bld_base->op_actions array with some 131bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * operand actions that are intended only for use when generating 132bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard * instructions to be executed on a CPU. 133bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard */ 134bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardvoid 135bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellardlp_set_default_actions_cpu( 136bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard struct lp_build_tgsi_context * bld_base); 137bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard 138bc2875aa483a0fef7f6e32c1886f6e2edaba7694Tom Stellard#endif /* LP_BLD_TGSI_ACTION_H */ 139