Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 1 | /* |
Stephen Hines | 2980f07 | 2012-04-09 18:26:29 -0700 | [diff] [blame] | 2 | * Copyright (C) 2011-2012 The Android Open Source Project |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 3 | * |
| 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 5 | * you may not use this file except in compliance with the License. |
| 6 | * You may obtain a copy of the License at |
| 7 | * |
| 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 9 | * |
| 10 | * Unless required by applicable law or agreed to in writing, software |
| 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 13 | * See the License for the specific language governing permissions and |
| 14 | * limitations under the License. |
| 15 | */ |
| 16 | |
| 17 | #ifndef RS_HAL_H |
| 18 | #define RS_HAL_H |
| 19 | |
Jason Sams | 3715b00 | 2012-02-16 16:07:49 -0800 | [diff] [blame] | 20 | #include <rsDefines.h> |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 21 | |
Jason Sams | 7ac2a4d | 2012-02-15 12:04:24 -0800 | [diff] [blame] | 22 | struct ANativeWindow; |
| 23 | |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 24 | namespace android { |
| 25 | namespace renderscript { |
| 26 | |
| 27 | class Context; |
| 28 | class ObjectBase; |
| 29 | class Element; |
| 30 | class Type; |
| 31 | class Allocation; |
| 32 | class Script; |
Jason Sams | dbe66d6 | 2012-09-17 13:54:41 -0700 | [diff] [blame] | 33 | class ScriptKernelID; |
| 34 | class ScriptFieldID; |
| 35 | class ScriptMethodID; |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 36 | class ScriptC; |
Jason Sams | dbe66d6 | 2012-09-17 13:54:41 -0700 | [diff] [blame] | 37 | class ScriptGroup; |
Jason Sams | 9e0afb5 | 2011-10-31 13:23:43 -0700 | [diff] [blame] | 38 | class Path; |
Alex Sakhartchouk | 7f126c7 | 2011-05-05 16:56:27 -0700 | [diff] [blame] | 39 | class Program; |
Jason Sams | 8feea4e | 2011-03-18 15:03:25 -0700 | [diff] [blame] | 40 | class ProgramStore; |
Jason Sams | 721acc4 | 2011-04-06 11:23:54 -0700 | [diff] [blame] | 41 | class ProgramRaster; |
Alex Sakhartchouk | a04e30d | 2011-04-29 16:49:08 -0700 | [diff] [blame] | 42 | class ProgramVertex; |
| 43 | class ProgramFragment; |
| 44 | class Mesh; |
Alex Sakhartchouk | 7f126c7 | 2011-05-05 16:56:27 -0700 | [diff] [blame] | 45 | class Sampler; |
Alex Sakhartchouk | da6d34a | 2011-05-13 14:53:34 -0700 | [diff] [blame] | 46 | class FBOCache; |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 47 | |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 48 | typedef void *(*RsHalSymbolLookupFunc)(void *usrptr, char const *symbolName); |
| 49 | |
Jason Sams | 451cf2e | 2011-08-17 13:46:46 -0700 | [diff] [blame] | 50 | typedef struct { |
| 51 | const void *in; |
| 52 | void *out; |
| 53 | const void *usr; |
Jason Sams | 8eaba4f | 2012-08-14 14:38:05 -0700 | [diff] [blame] | 54 | size_t usrLen; |
Jason Sams | 451cf2e | 2011-08-17 13:46:46 -0700 | [diff] [blame] | 55 | uint32_t x; |
| 56 | uint32_t y; |
| 57 | uint32_t z; |
| 58 | uint32_t lod; |
| 59 | RsAllocationCubemapFace face; |
| 60 | uint32_t ar[16]; |
Jason Sams | bee28c6 | 2012-10-25 18:15:54 -0700 | [diff] [blame] | 61 | uint32_t lid; |
Jason Sams | 8eaba4f | 2012-08-14 14:38:05 -0700 | [diff] [blame] | 62 | |
| 63 | uint32_t dimX; |
| 64 | uint32_t dimY; |
| 65 | uint32_t dimZ; |
| 66 | uint32_t dimArray; |
| 67 | |
| 68 | const uint8_t *ptrIn; |
| 69 | uint8_t *ptrOut; |
| 70 | uint32_t eStrideIn; |
| 71 | uint32_t eStrideOut; |
| 72 | uint32_t yStrideIn; |
| 73 | uint32_t yStrideOut; |
Jason Sams | cf9ea9f | 2012-09-23 17:00:54 -0700 | [diff] [blame] | 74 | uint32_t slot; |
Jason Sams | 451cf2e | 2011-08-17 13:46:46 -0700 | [diff] [blame] | 75 | } RsForEachStubParamStruct; |
| 76 | |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 77 | /** |
| 78 | * Script management functions |
| 79 | */ |
| 80 | typedef struct { |
Jason Sams | 4b3de47 | 2011-04-06 17:52:23 -0700 | [diff] [blame] | 81 | bool (*initGraphics)(const Context *); |
| 82 | void (*shutdownGraphics)(const Context *); |
Alex Sakhartchouk | 7257c7e | 2011-05-17 12:32:47 -0700 | [diff] [blame] | 83 | bool (*setSurface)(const Context *, uint32_t w, uint32_t h, RsNativeWindow); |
Jason Sams | 4b3de47 | 2011-04-06 17:52:23 -0700 | [diff] [blame] | 84 | void (*swap)(const Context *); |
| 85 | |
Jason Sams | cdfdb8f | 2011-03-17 16:12:47 -0700 | [diff] [blame] | 86 | void (*shutdownDriver)(Context *); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 87 | void (*getVersion)(unsigned int *major, unsigned int *minor); |
Jason Sams | cdfdb8f | 2011-03-17 16:12:47 -0700 | [diff] [blame] | 88 | void (*setPriority)(const Context *, int32_t priority); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 89 | |
| 90 | |
| 91 | |
| 92 | struct { |
Jason Sams | 8feea4e | 2011-03-18 15:03:25 -0700 | [diff] [blame] | 93 | bool (*init)(const Context *rsc, ScriptC *s, |
| 94 | char const *resName, |
| 95 | char const *cacheDir, |
| 96 | uint8_t const *bitcode, |
| 97 | size_t bitcodeSize, |
Jason Sams | 87fe59a | 2011-04-20 15:09:01 -0700 | [diff] [blame] | 98 | uint32_t flags); |
Jason Sams | 8eaba4f | 2012-08-14 14:38:05 -0700 | [diff] [blame] | 99 | bool (*initIntrinsic)(const Context *rsc, Script *s, |
Stephen Hines | 41d6c76 | 2012-08-21 17:07:38 -0700 | [diff] [blame] | 100 | RsScriptIntrinsicID iid, |
Jason Sams | 8eaba4f | 2012-08-14 14:38:05 -0700 | [diff] [blame] | 101 | Element *e); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 102 | |
Jason Sams | cdfdb8f | 2011-03-17 16:12:47 -0700 | [diff] [blame] | 103 | void (*invokeFunction)(const Context *rsc, Script *s, |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 104 | uint32_t slot, |
| 105 | const void *params, |
| 106 | size_t paramLength); |
Jason Sams | cdfdb8f | 2011-03-17 16:12:47 -0700 | [diff] [blame] | 107 | int (*invokeRoot)(const Context *rsc, Script *s); |
| 108 | void (*invokeForEach)(const Context *rsc, |
| 109 | Script *s, |
Jason Sams | 35e429e | 2011-07-13 11:26:26 -0700 | [diff] [blame] | 110 | uint32_t slot, |
Jason Sams | cdfdb8f | 2011-03-17 16:12:47 -0700 | [diff] [blame] | 111 | const Allocation * ain, |
| 112 | Allocation * aout, |
| 113 | const void * usr, |
| 114 | uint32_t usrLen, |
| 115 | const RsScriptCall *sc); |
| 116 | void (*invokeInit)(const Context *rsc, Script *s); |
Stephen Hines | 4ee16ff | 2011-08-31 17:41:39 -0700 | [diff] [blame] | 117 | void (*invokeFreeChildren)(const Context *rsc, Script *s); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 118 | |
| 119 | void (*setGlobalVar)(const Context *rsc, const Script *s, |
| 120 | uint32_t slot, |
| 121 | void *data, |
| 122 | size_t dataLength); |
Stephen Hines | 2980f07 | 2012-04-09 18:26:29 -0700 | [diff] [blame] | 123 | void (*setGlobalVarWithElemDims)(const Context *rsc, const Script *s, |
| 124 | uint32_t slot, |
| 125 | void *data, |
| 126 | size_t dataLength, |
| 127 | const Element *e, |
| 128 | const size_t *dims, |
| 129 | size_t dimLength); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 130 | void (*setGlobalBind)(const Context *rsc, const Script *s, |
| 131 | uint32_t slot, |
Jason Sams | 807fdc4 | 2012-07-25 17:55:39 -0700 | [diff] [blame] | 132 | Allocation *data); |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 133 | void (*setGlobalObj)(const Context *rsc, const Script *s, |
| 134 | uint32_t slot, |
| 135 | ObjectBase *data); |
| 136 | |
| 137 | void (*destroy)(const Context *rsc, Script *s); |
| 138 | } script; |
| 139 | |
Jason Sams | 8feea4e | 2011-03-18 15:03:25 -0700 | [diff] [blame] | 140 | struct { |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 141 | bool (*init)(const Context *rsc, Allocation *alloc, bool forceZero); |
| 142 | void (*destroy)(const Context *rsc, Allocation *alloc); |
| 143 | |
| 144 | void (*resize)(const Context *rsc, const Allocation *alloc, const Type *newType, |
| 145 | bool zeroNew); |
| 146 | void (*syncAll)(const Context *rsc, const Allocation *alloc, RsAllocationUsageType src); |
| 147 | void (*markDirty)(const Context *rsc, const Allocation *alloc); |
Jason Sams | 7ac2a4d | 2012-02-15 12:04:24 -0800 | [diff] [blame] | 148 | |
Jason Sams | 41e373d | 2012-01-13 14:01:20 -0800 | [diff] [blame] | 149 | int32_t (*initSurfaceTexture)(const Context *rsc, const Allocation *alloc); |
Jason Sams | 7ac2a4d | 2012-02-15 12:04:24 -0800 | [diff] [blame] | 150 | void (*setSurfaceTexture)(const Context *rsc, Allocation *alloc, ANativeWindow *sur); |
| 151 | void (*ioSend)(const Context *rsc, Allocation *alloc); |
| 152 | void (*ioReceive)(const Context *rsc, Allocation *alloc); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 153 | |
| 154 | void (*data1D)(const Context *rsc, const Allocation *alloc, |
| 155 | uint32_t xoff, uint32_t lod, uint32_t count, |
Alex Sakhartchouk | c794cd5 | 2012-02-13 11:57:32 -0800 | [diff] [blame] | 156 | const void *data, size_t sizeBytes); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 157 | void (*data2D)(const Context *rsc, const Allocation *alloc, |
| 158 | uint32_t xoff, uint32_t yoff, uint32_t lod, |
| 159 | RsAllocationCubemapFace face, uint32_t w, uint32_t h, |
Tim Murray | 358747a | 2012-11-26 13:52:04 -0800 | [diff] [blame] | 160 | const void *data, size_t sizeBytes, size_t stride); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 161 | void (*data3D)(const Context *rsc, const Allocation *alloc, |
| 162 | uint32_t xoff, uint32_t yoff, uint32_t zoff, |
| 163 | uint32_t lod, RsAllocationCubemapFace face, |
Alex Sakhartchouk | c794cd5 | 2012-02-13 11:57:32 -0800 | [diff] [blame] | 164 | uint32_t w, uint32_t h, uint32_t d, const void *data, size_t sizeBytes); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 165 | |
Jason Sams | 807fdc4 | 2012-07-25 17:55:39 -0700 | [diff] [blame] | 166 | void (*read1D)(const Context *rsc, const Allocation *alloc, |
| 167 | uint32_t xoff, uint32_t lod, uint32_t count, |
| 168 | void *data, size_t sizeBytes); |
| 169 | void (*read2D)(const Context *rsc, const Allocation *alloc, |
| 170 | uint32_t xoff, uint32_t yoff, uint32_t lod, |
| 171 | RsAllocationCubemapFace face, uint32_t w, uint32_t h, |
Tim Murray | 358747a | 2012-11-26 13:52:04 -0800 | [diff] [blame] | 172 | void *data, size_t sizeBytes, size_t stride); |
Jason Sams | 807fdc4 | 2012-07-25 17:55:39 -0700 | [diff] [blame] | 173 | void (*read3D)(const Context *rsc, const Allocation *alloc, |
| 174 | uint32_t xoff, uint32_t yoff, uint32_t zoff, |
| 175 | uint32_t lod, RsAllocationCubemapFace face, |
| 176 | uint32_t w, uint32_t h, uint32_t d, void *data, size_t sizeBytes); |
| 177 | |
| 178 | // Lock and unlock make a 1D region of memory available to the CPU |
| 179 | // for direct access by pointer. Once unlock is called control is |
| 180 | // returned to the SOC driver. |
| 181 | void * (*lock1D)(const Context *rsc, const Allocation *alloc); |
| 182 | void (*unlock1D)(const Context *rsc, const Allocation *alloc); |
| 183 | |
Alex Sakhartchouk | 74a8279 | 2011-06-14 11:13:19 -0700 | [diff] [blame] | 184 | // Allocation to allocation copies |
| 185 | void (*allocData1D)(const Context *rsc, |
| 186 | const Allocation *dstAlloc, |
| 187 | uint32_t dstXoff, uint32_t dstLod, uint32_t count, |
| 188 | const Allocation *srcAlloc, uint32_t srcXoff, uint32_t srcLod); |
| 189 | void (*allocData2D)(const Context *rsc, |
| 190 | const Allocation *dstAlloc, |
| 191 | uint32_t dstXoff, uint32_t dstYoff, uint32_t dstLod, |
| 192 | RsAllocationCubemapFace dstFace, uint32_t w, uint32_t h, |
| 193 | const Allocation *srcAlloc, |
| 194 | uint32_t srcXoff, uint32_t srcYoff, uint32_t srcLod, |
| 195 | RsAllocationCubemapFace srcFace); |
| 196 | void (*allocData3D)(const Context *rsc, |
| 197 | const Allocation *dstAlloc, |
| 198 | uint32_t dstXoff, uint32_t dstYoff, uint32_t dstZoff, |
| 199 | uint32_t dstLod, RsAllocationCubemapFace dstFace, |
| 200 | uint32_t w, uint32_t h, uint32_t d, |
| 201 | const Allocation *srcAlloc, |
| 202 | uint32_t srcXoff, uint32_t srcYoff, uint32_t srcZoff, |
| 203 | uint32_t srcLod, RsAllocationCubemapFace srcFace); |
| 204 | |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 205 | void (*elementData1D)(const Context *rsc, const Allocation *alloc, uint32_t x, |
Alex Sakhartchouk | c794cd5 | 2012-02-13 11:57:32 -0800 | [diff] [blame] | 206 | const void *data, uint32_t elementOff, size_t sizeBytes); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 207 | void (*elementData2D)(const Context *rsc, const Allocation *alloc, uint32_t x, uint32_t y, |
Alex Sakhartchouk | c794cd5 | 2012-02-13 11:57:32 -0800 | [diff] [blame] | 208 | const void *data, uint32_t elementOff, size_t sizeBytes); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 209 | |
Jason Sams | 61a4bb7 | 2012-07-25 19:33:43 -0700 | [diff] [blame] | 210 | void (*generateMipmaps)(const Context *rsc, const Allocation *alloc); |
Jason Sams | eb4fe18 | 2011-05-26 16:33:01 -0700 | [diff] [blame] | 211 | } allocation; |
| 212 | |
| 213 | struct { |
Jason Sams | 8feea4e | 2011-03-18 15:03:25 -0700 | [diff] [blame] | 214 | bool (*init)(const Context *rsc, const ProgramStore *ps); |
| 215 | void (*setActive)(const Context *rsc, const ProgramStore *ps); |
| 216 | void (*destroy)(const Context *rsc, const ProgramStore *ps); |
| 217 | } store; |
| 218 | |
Jason Sams | 721acc4 | 2011-04-06 11:23:54 -0700 | [diff] [blame] | 219 | struct { |
| 220 | bool (*init)(const Context *rsc, const ProgramRaster *ps); |
| 221 | void (*setActive)(const Context *rsc, const ProgramRaster *ps); |
| 222 | void (*destroy)(const Context *rsc, const ProgramRaster *ps); |
| 223 | } raster; |
Jason Sams | 8feea4e | 2011-03-18 15:03:25 -0700 | [diff] [blame] | 224 | |
Alex Sakhartchouk | a04e30d | 2011-04-29 16:49:08 -0700 | [diff] [blame] | 225 | struct { |
| 226 | bool (*init)(const Context *rsc, const ProgramVertex *pv, |
Alex Sakhartchouk | 748eb07 | 2012-02-15 16:21:46 -0800 | [diff] [blame] | 227 | const char* shader, size_t shaderLen, |
| 228 | const char** textureNames, size_t textureNamesCount, |
| 229 | const size_t *textureNamesLength); |
Alex Sakhartchouk | a04e30d | 2011-04-29 16:49:08 -0700 | [diff] [blame] | 230 | void (*setActive)(const Context *rsc, const ProgramVertex *pv); |
| 231 | void (*destroy)(const Context *rsc, const ProgramVertex *pv); |
| 232 | } vertex; |
| 233 | |
| 234 | struct { |
| 235 | bool (*init)(const Context *rsc, const ProgramFragment *pf, |
Alex Sakhartchouk | 748eb07 | 2012-02-15 16:21:46 -0800 | [diff] [blame] | 236 | const char* shader, size_t shaderLen, |
| 237 | const char** textureNames, size_t textureNamesCount, |
| 238 | const size_t *textureNamesLength); |
Alex Sakhartchouk | a04e30d | 2011-04-29 16:49:08 -0700 | [diff] [blame] | 239 | void (*setActive)(const Context *rsc, const ProgramFragment *pf); |
| 240 | void (*destroy)(const Context *rsc, const ProgramFragment *pf); |
| 241 | } fragment; |
| 242 | |
| 243 | struct { |
| 244 | bool (*init)(const Context *rsc, const Mesh *m); |
| 245 | void (*draw)(const Context *rsc, const Mesh *m, uint32_t primIndex, uint32_t start, uint32_t len); |
| 246 | void (*destroy)(const Context *rsc, const Mesh *m); |
| 247 | } mesh; |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 248 | |
Alex Sakhartchouk | 7f126c7 | 2011-05-05 16:56:27 -0700 | [diff] [blame] | 249 | struct { |
Jason Sams | 9e0afb5 | 2011-10-31 13:23:43 -0700 | [diff] [blame] | 250 | bool (*initStatic)(const Context *rsc, const Path *m, const Allocation *vtx, const Allocation *loops); |
| 251 | bool (*initDynamic)(const Context *rsc, const Path *m); |
| 252 | void (*draw)(const Context *rsc, const Path *m); |
| 253 | void (*destroy)(const Context *rsc, const Path *m); |
| 254 | } path; |
| 255 | |
| 256 | struct { |
Alex Sakhartchouk | 7f126c7 | 2011-05-05 16:56:27 -0700 | [diff] [blame] | 257 | bool (*init)(const Context *rsc, const Sampler *m); |
| 258 | void (*destroy)(const Context *rsc, const Sampler *m); |
| 259 | } sampler; |
| 260 | |
Alex Sakhartchouk | da6d34a | 2011-05-13 14:53:34 -0700 | [diff] [blame] | 261 | struct { |
| 262 | bool (*init)(const Context *rsc, const FBOCache *fb); |
| 263 | void (*setActive)(const Context *rsc, const FBOCache *fb); |
| 264 | void (*destroy)(const Context *rsc, const FBOCache *fb); |
| 265 | } framebuffer; |
| 266 | |
Jason Sams | dbe66d6 | 2012-09-17 13:54:41 -0700 | [diff] [blame] | 267 | struct { |
Jason Sams | 709a097 | 2012-11-15 18:18:04 -0800 | [diff] [blame] | 268 | bool (*init)(const Context *rsc, ScriptGroup *sg); |
Jason Sams | dbe66d6 | 2012-09-17 13:54:41 -0700 | [diff] [blame] | 269 | void (*setInput)(const Context *rsc, const ScriptGroup *sg, |
| 270 | const ScriptKernelID *kid, Allocation *); |
| 271 | void (*setOutput)(const Context *rsc, const ScriptGroup *sg, |
| 272 | const ScriptKernelID *kid, Allocation *); |
| 273 | void (*execute)(const Context *rsc, const ScriptGroup *sg); |
| 274 | void (*destroy)(const Context *rsc, const ScriptGroup *sg); |
| 275 | } scriptgroup; |
| 276 | |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 277 | } RsdHalFunctions; |
| 278 | |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 279 | |
| 280 | } |
| 281 | } |
| 282 | |
Stephen Hines | 414a461 | 2012-09-05 18:05:08 -0700 | [diff] [blame] | 283 | #ifdef __cplusplus |
| 284 | extern "C" { |
| 285 | #endif |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 286 | |
Stephen Hines | 414a461 | 2012-09-05 18:05:08 -0700 | [diff] [blame] | 287 | bool rsdHalInit(RsContext, uint32_t version_major, uint32_t version_minor); |
| 288 | |
| 289 | #ifdef __cplusplus |
| 290 | } |
| 291 | #endif |
Jason Sams | bad8074 | 2011-03-16 16:29:28 -0700 | [diff] [blame] | 292 | |
| 293 | #endif |
| 294 | |