xref: /aosp_15_r20/external/mesa3d/src/gallium/auxiliary/gallivm/lp_bld_struct.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
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 type conversions.
31  *
32  * @author Jose Fonseca <[email protected]>
33  */
34 
35 
36 #ifndef LP_BLD_STRUCT_H
37 #define LP_BLD_STRUCT_H
38 
39 
40 #include "gallivm/lp_bld.h"
41 #include "gallivm/lp_bld_init.h"
42 
43 #include "util/u_debug.h"
44 #include "util/u_memory.h"
45 
46 
47 #define LP_CHECK_STRUCT_SIZE(_ctype, _ltarget, _ltype) \
48       assert(LLVMABISizeOfType(_ltarget, _ltype) == \
49              sizeof(_ctype))
50 
51 #define LP_CHECK_MEMBER_OFFSET(_ctype, _cmember, _ltarget, _ltype, _lindex) \
52       assert(LLVMOffsetOfElement(_ltarget, _ltype, _lindex) == \
53              offsetof(_ctype, _cmember))
54 
55 
56 /**
57  * Get value pointer to a structure member.
58  * This takes the explicit LLVM type of ptr, as required by LLVM-15 opaque-pointers.
59  */
60 LLVMValueRef
61 lp_build_struct_get_ptr2(struct gallivm_state *gallivm,
62                         LLVMTypeRef ptr_type,
63                         LLVMValueRef ptr,
64                         unsigned member,
65                         const char *name);
66 
67 /**
68  * Get the value of a structure member.
69  * This takes the explicit LLVM type of ptr, as required by LLVM-15 opaque-pointers.
70  */
71 LLVMValueRef
72 lp_build_struct_get2(struct gallivm_state *gallivm,
73                     LLVMTypeRef ptr_type,
74                     LLVMValueRef ptr,
75                     unsigned member,
76                     const char *name);
77 
78 LLVMValueRef
79 lp_build_array_get_ptr2(struct gallivm_state *gallivm,
80                         LLVMTypeRef array_type,
81                         LLVMValueRef ptr,
82                         LLVMValueRef index);
83 
84 LLVMValueRef
85 lp_build_array_get2(struct gallivm_state *gallivm,
86                     LLVMTypeRef array_type,
87                     LLVMValueRef ptr,
88                     LLVMValueRef index);
89 
90 /**
91  * Get the value of an array element.
92  * This takes the explicit LLVM type of ptr, as required by LLVM-15 opaque-pointers.
93  */
94 LLVMValueRef
95 lp_build_pointer_get2(LLVMBuilderRef builder,
96                       LLVMTypeRef ptr_type,
97                       LLVMValueRef ptr,
98                       LLVMValueRef index);
99 
100 /**
101  * Get the value of an array element, with explicit alignment, and explicit type,
102  * This takes the explicit LLVM type of ptr, as required by LLVM-15 opaque-pointers.
103  *
104  * If the element size is different from the alignment this will
105  * cause llvm to emit an unaligned load
106  */
107 LLVMValueRef
108 lp_build_pointer_get_unaligned2(LLVMBuilderRef builder,
109                                 LLVMTypeRef ptr_type,
110                                 LLVMValueRef ptr,
111                                 LLVMValueRef index,
112                                 unsigned alignment);
113 
114 /**
115  * Set the value of an array element.
116  */
117 void
118 lp_build_pointer_set(LLVMBuilderRef builder,
119                      LLVMValueRef ptr,
120                      LLVMValueRef index,
121                      LLVMValueRef value);
122 
123 /**
124  * Set the value of an array element, with explicit alignment.
125  *
126  * If the element size is different from the alignment this will
127  * cause llvm to emit an unaligned store
128  */
129 void
130 lp_build_pointer_set_unaligned(LLVMBuilderRef builder,
131                                LLVMValueRef ptr,
132                                LLVMValueRef index,
133                                LLVMValueRef value,
134                                unsigned alignment);
135 
136 #endif /* !LP_BLD_STRUCT_H */
137