1 /****************************************************************************
2  * Copyright (C) 2014-2015 Intel Corporation.   All Rights Reserved.
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  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * 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 NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
21  * IN THE SOFTWARE.
22  *
23  * @file jit_api.h
24  *
25  * @brief Platform independent JIT interface
26  *
27  * Notes:
28  *
29  ******************************************************************************/
30 #pragma once
31 #include "common/os.h"
32 #include "core/utils.h"
33 
34 #include "fetch_jit.h"
35 #include "streamout_jit.h"
36 #include "blend_jit.h"
37 
38 #include <stdlib.h>
39 
40 #if defined(_WIN32)
41 #define EXCEPTION_PRINT_STACK(ret) ret
42 #endif // _WIN32
43 
44 #if defined(_WIN32)
45 #define JITCALL __stdcall
46 #else
47 #define JITCALL
48 #endif
49 
50 
51 struct ShaderInfo;
52 
53 //////////////////////////////////////////////////////////////////////////
54 /// Jit Compile Info Input
55 //////////////////////////////////////////////////////////////////////////
56 struct JIT_COMPILE_INPUT
57 {
58     SWR_SHADER_TYPE type;
59     uint32_t        crc;
60 
61     const void* pIR; ///< Pointer to LLVM IR text.
62     size_t      irLength;
63 
64     bool enableJitSampler;
65 
66 };
67 
68 
69 extern "C" {
70 
71 //////////////////////////////////////////////////////////////////////////
72 /// @brief Create JIT context.
73 HANDLE JITCALL JitCreateContext(uint32_t targetSimdWidth, const char* arch, const char* core);
74 
75 //////////////////////////////////////////////////////////////////////////
76 /// @brief Destroy JIT context.
77 void JITCALL JitDestroyContext(HANDLE hJitContext);
78 
79 //////////////////////////////////////////////////////////////////////////
80 /// @brief JIT compile shader.
81 /// @param hJitContext - Jit Context
82 /// @param input  - Input containing LLVM IR and other information
83 /// @param output - Output containing information about JIT shader
84 ShaderInfo* JITCALL JitCompileShader(HANDLE hJitContext, const JIT_COMPILE_INPUT& input);
85 
86 ShaderInfo* JITCALL JitGetShader(HANDLE hJitContext, const char* name);
87 
88 //////////////////////////////////////////////////////////////////////////
89 /// @brief JIT destroy shader.
90 /// @param hJitContext - Jit Context
91 /// @param pShaderInfo  - pointer to shader object.
92 void JITCALL JitDestroyShader(HANDLE hJitContext, ShaderInfo*& pShaderInfo);
93 
94 //////////////////////////////////////////////////////////////////////////
95 /// @brief JIT compiles fetch shader
96 /// @param hJitContext - Jit Context
97 /// @param state   - Fetch state to build function from
98 PFN_FETCH_FUNC JITCALL JitCompileFetch(HANDLE hJitContext, const FETCH_COMPILE_STATE& state);
99 
100 //////////////////////////////////////////////////////////////////////////
101 /// @brief JIT compiles streamout shader
102 /// @param hJitContext - Jit Context
103 /// @param state   - SO state to build function from
104 PFN_SO_FUNC JITCALL JitCompileStreamout(HANDLE hJitContext, const STREAMOUT_COMPILE_STATE& state);
105 
106 //////////////////////////////////////////////////////////////////////////
107 /// @brief JIT compiles blend shader
108 /// @param hJitContext - Jit Context
109 /// @param state   - blend state to build function from
110 PFN_BLEND_JIT_FUNC JITCALL JitCompileBlend(HANDLE hJitContext, const BLEND_COMPILE_STATE& state);
111 
112 }
113 
114