1 /**************************************************************************
2  *
3  * Copyright 2009 VMware, Inc.
4  * All Rights Reserved.
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a
7  * copy of this software and associated documentation files (the
8  * "Software"), to deal in the Software without restriction, including
9  * without limitation the rights to use, copy, modify, merge, publish,
10  * distribute, sub license, and/or sell copies of the Software, and to
11  * permit persons to whom the Software is furnished to do so, subject to
12  * the following conditions:
13  *
14  * The above copyright notice and this permission notice (including the
15  * next paragraph) shall be included in all copies or substantial portions
16  * of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21  * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25  *
26  **************************************************************************/
27 
28 /**
29  * @file
30  * Helper functions for swizzling/shuffling.
31  *
32  * @author Jose Fonseca <jfonseca@vmware.com>
33  */
34 
35 
36 #ifndef LP_BLD_SWIZZLE_H
37 #define LP_BLD_SWIZZLE_H
38 
39 
40 #include "gallivm/lp_bld.h"
41 
42 
43 struct lp_type;
44 struct lp_build_context;
45 
46 
47 #define LP_BLD_SWIZZLE_DONTCARE 0xFF
48 
49 
50 LLVMValueRef
51 lp_build_broadcast(struct gallivm_state *gallivm,
52                    LLVMTypeRef vec_type,
53                    LLVMValueRef scalar);
54 
55 
56 LLVMValueRef
57 lp_build_broadcast_scalar(struct lp_build_context *bld,
58                           LLVMValueRef scalar);
59 
60 
61 LLVMValueRef
62 lp_build_extract_broadcast(struct gallivm_state *gallivm,
63                            struct lp_type src_type,
64                            struct lp_type dst_type,
65                            LLVMValueRef vector,
66                            LLVMValueRef index);
67 
68 
69 /**
70  * Broadcast one channel of a vector composed of arrays of XYZW structures into
71  * all four channel.
72  */
73 LLVMValueRef
74 lp_build_swizzle_scalar_aos(struct lp_build_context *bld,
75                        LLVMValueRef a,
76                        unsigned channel);
77 
78 
79 /**
80  * Swizzle a vector consisting of an array of XYZW structs.
81  *
82  * @param swizzles is the in [0,4[ range.
83  */
84 LLVMValueRef
85 lp_build_swizzle_aos(struct lp_build_context *bld,
86                      LLVMValueRef a,
87                      const unsigned char swizzles[4]);
88 
89 
90 LLVMValueRef
91 lp_build_swizzle_soa_channel(struct lp_build_context *bld,
92                              const LLVMValueRef *unswizzled,
93                              unsigned swizzle);
94 
95 
96 void
97 lp_build_swizzle_soa(struct lp_build_context *bld,
98                      const LLVMValueRef *unswizzled,
99                      const unsigned char swizzles[4],
100                      LLVMValueRef *swizzled);
101 
102 
103 void
104 lp_build_swizzle_soa_inplace(struct lp_build_context *bld,
105                              LLVMValueRef *values,
106                              const unsigned char swizzles[4]);
107 
108 
109 void
110 lp_build_transpose_aos(struct gallivm_state *gallivm,
111                        struct lp_type type,
112                        const LLVMValueRef src[4],
113                        LLVMValueRef dst[4]);
114 
115 
116 LLVMValueRef
117 lp_build_pack_aos_scalars(struct gallivm_state *gallivm,
118                           struct lp_type src_type,
119                           struct lp_type dst_type,
120                           const LLVMValueRef src);
121 
122 
123 LLVMValueRef
124 lp_build_unpack_broadcast_aos_scalars(struct gallivm_state *gallivm,
125                                       struct lp_type src_type,
126                                       struct lp_type dst_type,
127                                       const LLVMValueRef src);
128 
129 
130 #endif /* !LP_BLD_SWIZZLE_H */
131