src/gallium/auxiliary/gallivm/lp_bld_tgsi_action.h

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