RenderScript.java revision 331bf9b14b1c5c1e88f5c4092b6e24fae887fb3b
1/* 2 * Copyright (C) 2008 The Android Open Source Project 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 17package android.renderscript; 18 19import java.lang.reflect.Field; 20 21import android.content.Context; 22import android.content.res.AssetManager; 23import android.graphics.Bitmap; 24import android.graphics.BitmapFactory; 25import android.util.Config; 26import android.util.Log; 27import android.view.Surface; 28 29 30/** 31 * RenderScript base master class. An instance of this class creates native 32 * worker threads for processing commands from this object. This base class 33 * does not provide any extended capabilities beyond simple data processing. 34 * For extended capabilities use derived classes such as RenderScriptGL. 35 * 36 * 37 * 38 **/ 39public class RenderScript { 40 static final String LOG_TAG = "RenderScript_jni"; 41 static final boolean DEBUG = false; 42 @SuppressWarnings({"UnusedDeclaration", "deprecation"}) 43 static final boolean LOG_ENABLED = DEBUG ? Config.LOGD : Config.LOGV; 44 45 private Context mApplicationContext; 46 47 /* 48 * We use a class initializer to allow the native code to cache some 49 * field offsets. 50 */ 51 @SuppressWarnings({"FieldCanBeLocal", "UnusedDeclaration"}) 52 static boolean sInitialized; 53 native static void _nInit(); 54 55 56 static { 57 sInitialized = false; 58 try { 59 System.loadLibrary("rs_jni"); 60 _nInit(); 61 sInitialized = true; 62 } catch (UnsatisfiedLinkError e) { 63 Log.e(LOG_TAG, "Error loading RS jni library: " + e); 64 throw new RSRuntimeException("Error loading RS jni library: " + e); 65 } 66 } 67 68 // Non-threadsafe functions. 69 native int nDeviceCreate(); 70 native void nDeviceDestroy(int dev); 71 native void nDeviceSetConfig(int dev, int param, int value); 72 native void nContextGetUserMessage(int con, int[] data); 73 native String nContextGetErrorMessage(int con); 74 native int nContextPeekMessage(int con, int[] subID, boolean wait); 75 native void nContextInitToClient(int con); 76 native void nContextDeinitToClient(int con); 77 78 79 // Methods below are wrapped to protect the non-threadsafe 80 // lockless fifo. 81 native int rsnContextCreateGL(int dev, int ver, 82 int colorMin, int colorPref, 83 int alphaMin, int alphaPref, 84 int depthMin, int depthPref, 85 int stencilMin, int stencilPref, 86 int samplesMin, int samplesPref, float samplesQ, int dpi); 87 synchronized int nContextCreateGL(int dev, int ver, 88 int colorMin, int colorPref, 89 int alphaMin, int alphaPref, 90 int depthMin, int depthPref, 91 int stencilMin, int stencilPref, 92 int samplesMin, int samplesPref, float samplesQ, int dpi) { 93 return rsnContextCreateGL(dev, ver, colorMin, colorPref, 94 alphaMin, alphaPref, depthMin, depthPref, 95 stencilMin, stencilPref, 96 samplesMin, samplesPref, samplesQ, dpi); 97 } 98 native int rsnContextCreate(int dev, int ver); 99 synchronized int nContextCreate(int dev, int ver) { 100 return rsnContextCreate(dev, ver); 101 } 102 native void rsnContextDestroy(int con); 103 synchronized void nContextDestroy() { 104 validate(); 105 rsnContextDestroy(mContext); 106 } 107 native void rsnContextSetSurface(int con, int w, int h, Surface sur); 108 synchronized void nContextSetSurface(int w, int h, Surface sur) { 109 validate(); 110 rsnContextSetSurface(mContext, w, h, sur); 111 } 112 native void rsnContextSetPriority(int con, int p); 113 synchronized void nContextSetPriority(int p) { 114 validate(); 115 rsnContextSetPriority(mContext, p); 116 } 117 native void rsnContextDump(int con, int bits); 118 synchronized void nContextDump(int bits) { 119 validate(); 120 rsnContextDump(mContext, bits); 121 } 122 native void rsnContextFinish(int con); 123 synchronized void nContextFinish() { 124 validate(); 125 rsnContextFinish(mContext); 126 } 127 128 native void rsnContextBindRootScript(int con, int script); 129 synchronized void nContextBindRootScript(int script) { 130 validate(); 131 rsnContextBindRootScript(mContext, script); 132 } 133 native void rsnContextBindSampler(int con, int sampler, int slot); 134 synchronized void nContextBindSampler(int sampler, int slot) { 135 validate(); 136 rsnContextBindSampler(mContext, sampler, slot); 137 } 138 native void rsnContextBindProgramStore(int con, int pfs); 139 synchronized void nContextBindProgramStore(int pfs) { 140 validate(); 141 rsnContextBindProgramStore(mContext, pfs); 142 } 143 native void rsnContextBindProgramFragment(int con, int pf); 144 synchronized void nContextBindProgramFragment(int pf) { 145 validate(); 146 rsnContextBindProgramFragment(mContext, pf); 147 } 148 native void rsnContextBindProgramVertex(int con, int pv); 149 synchronized void nContextBindProgramVertex(int pv) { 150 validate(); 151 rsnContextBindProgramVertex(mContext, pv); 152 } 153 native void rsnContextBindProgramRaster(int con, int pr); 154 synchronized void nContextBindProgramRaster(int pr) { 155 validate(); 156 rsnContextBindProgramRaster(mContext, pr); 157 } 158 native void rsnContextPause(int con); 159 synchronized void nContextPause() { 160 validate(); 161 rsnContextPause(mContext); 162 } 163 native void rsnContextResume(int con); 164 synchronized void nContextResume() { 165 validate(); 166 rsnContextResume(mContext); 167 } 168 169 native void rsnAssignName(int con, int obj, byte[] name); 170 synchronized void nAssignName(int obj, byte[] name) { 171 validate(); 172 rsnAssignName(mContext, obj, name); 173 } 174 native String rsnGetName(int con, int obj); 175 synchronized String nGetName(int obj) { 176 validate(); 177 return rsnGetName(mContext, obj); 178 } 179 native void rsnObjDestroy(int con, int id); 180 synchronized void nObjDestroy(int id) { 181 // There is a race condition here. The calling code may be run 182 // by the gc while teardown is occuring. This protects againts 183 // deleting dead objects. 184 if (mContext != 0) { 185 rsnObjDestroy(mContext, id); 186 } 187 } 188 189 native int rsnElementCreate(int con, int type, int kind, boolean norm, int vecSize); 190 synchronized int nElementCreate(int type, int kind, boolean norm, int vecSize) { 191 validate(); 192 return rsnElementCreate(mContext, type, kind, norm, vecSize); 193 } 194 native int rsnElementCreate2(int con, int[] elements, String[] names, int[] arraySizes); 195 synchronized int nElementCreate2(int[] elements, String[] names, int[] arraySizes) { 196 validate(); 197 return rsnElementCreate2(mContext, elements, names, arraySizes); 198 } 199 native void rsnElementGetNativeData(int con, int id, int[] elementData); 200 synchronized void nElementGetNativeData(int id, int[] elementData) { 201 validate(); 202 rsnElementGetNativeData(mContext, id, elementData); 203 } 204 native void rsnElementGetSubElements(int con, int id, int[] IDs, String[] names); 205 synchronized void nElementGetSubElements(int id, int[] IDs, String[] names) { 206 validate(); 207 rsnElementGetSubElements(mContext, id, IDs, names); 208 } 209 210 native int rsnTypeCreate(int con, int eid, int x, int y, int z, boolean mips, boolean faces); 211 synchronized int nTypeCreate(int eid, int x, int y, int z, boolean mips, boolean faces) { 212 validate(); 213 return rsnTypeCreate(mContext, eid, x, y, z, mips, faces); 214 } 215 native void rsnTypeGetNativeData(int con, int id, int[] typeData); 216 synchronized void nTypeGetNativeData(int id, int[] typeData) { 217 validate(); 218 rsnTypeGetNativeData(mContext, id, typeData); 219 } 220 221 native int rsnAllocationCreateTyped(int con, int type, int mip, int usage); 222 synchronized int nAllocationCreateTyped(int type, int mip, int usage) { 223 validate(); 224 return rsnAllocationCreateTyped(mContext, type, mip, usage); 225 } 226 native int rsnAllocationCreateFromBitmap(int con, int type, int mip, Bitmap bmp, int usage); 227 synchronized int nAllocationCreateFromBitmap(int type, int mip, Bitmap bmp, int usage) { 228 validate(); 229 return rsnAllocationCreateFromBitmap(mContext, type, mip, bmp, usage); 230 } 231 native int rsnAllocationCubeCreateFromBitmap(int con, int type, int mip, Bitmap bmp, int usage); 232 synchronized int nAllocationCubeCreateFromBitmap(int type, int mip, Bitmap bmp, int usage) { 233 validate(); 234 return rsnAllocationCubeCreateFromBitmap(mContext, type, mip, bmp, usage); 235 } 236 native int rsnAllocationCreateBitmapRef(int con, int type, Bitmap bmp); 237 synchronized int nAllocationCreateBitmapRef(int type, Bitmap bmp) { 238 validate(); 239 return rsnAllocationCreateBitmapRef(mContext, type, bmp); 240 } 241 native int rsnAllocationCreateFromAssetStream(int con, int mips, int assetStream, int usage); 242 synchronized int nAllocationCreateFromAssetStream(int mips, int assetStream, int usage) { 243 validate(); 244 return rsnAllocationCreateFromAssetStream(mContext, mips, assetStream, usage); 245 } 246 247 native void rsnAllocationCopyToBitmap(int con, int alloc, Bitmap bmp); 248 synchronized void nAllocationCopyToBitmap(int alloc, Bitmap bmp) { 249 validate(); 250 rsnAllocationCopyToBitmap(mContext, alloc, bmp); 251 } 252 253 254 native void rsnAllocationSyncAll(int con, int alloc, int src); 255 synchronized void nAllocationSyncAll(int alloc, int src) { 256 validate(); 257 rsnAllocationSyncAll(mContext, alloc, src); 258 } 259 native void rsnAllocationGenerateMipmaps(int con, int alloc); 260 synchronized void nAllocationGenerateMipmaps(int alloc) { 261 validate(); 262 rsnAllocationGenerateMipmaps(mContext, alloc); 263 } 264 native void rsnAllocationCopyFromBitmap(int con, int alloc, Bitmap bmp); 265 synchronized void nAllocationCopyFromBitmap(int alloc, Bitmap bmp) { 266 validate(); 267 rsnAllocationCopyFromBitmap(mContext, alloc, bmp); 268 } 269 270 271 native void rsnAllocationData1D(int con, int id, int off, int mip, int count, int[] d, int sizeBytes); 272 synchronized void nAllocationData1D(int id, int off, int mip, int count, int[] d, int sizeBytes) { 273 validate(); 274 rsnAllocationData1D(mContext, id, off, mip, count, d, sizeBytes); 275 } 276 native void rsnAllocationData1D(int con, int id, int off, int mip, int count, short[] d, int sizeBytes); 277 synchronized void nAllocationData1D(int id, int off, int mip, int count, short[] d, int sizeBytes) { 278 validate(); 279 rsnAllocationData1D(mContext, id, off, mip, count, d, sizeBytes); 280 } 281 native void rsnAllocationData1D(int con, int id, int off, int mip, int count, byte[] d, int sizeBytes); 282 synchronized void nAllocationData1D(int id, int off, int mip, int count, byte[] d, int sizeBytes) { 283 validate(); 284 rsnAllocationData1D(mContext, id, off, mip, count, d, sizeBytes); 285 } 286 native void rsnAllocationData1D(int con, int id, int off, int mip, int count, float[] d, int sizeBytes); 287 synchronized void nAllocationData1D(int id, int off, int mip, int count, float[] d, int sizeBytes) { 288 validate(); 289 rsnAllocationData1D(mContext, id, off, mip, count, d, sizeBytes); 290 } 291 292 native void rsnAllocationElementData1D(int con, int id, int xoff, int mip, int compIdx, byte[] d, int sizeBytes); 293 synchronized void nAllocationElementData1D(int id, int xoff, int mip, int compIdx, byte[] d, int sizeBytes) { 294 validate(); 295 rsnAllocationElementData1D(mContext, id, xoff, mip, compIdx, d, sizeBytes); 296 } 297 298 native void rsnAllocationData2D(int con, int id, int xoff, int yoff, int mip, int face, int w, int h, byte[] d, int sizeBytes); 299 synchronized void nAllocationData2D(int id, int xoff, int yoff, int mip, int face, int w, int h, byte[] d, int sizeBytes) { 300 validate(); 301 rsnAllocationData2D(mContext, id, xoff, yoff, mip, face, w, h, d, sizeBytes); 302 } 303 native void rsnAllocationData2D(int con, int id, int xoff, int yoff, int mip, int face, int w, int h, short[] d, int sizeBytes); 304 synchronized void nAllocationData2D(int id, int xoff, int yoff, int mip, int face, int w, int h, short[] d, int sizeBytes) { 305 validate(); 306 rsnAllocationData2D(mContext, id, xoff, yoff, mip, face, w, h, d, sizeBytes); 307 } 308 native void rsnAllocationData2D(int con, int id, int xoff, int yoff, int mip, int face, int w, int h, int[] d, int sizeBytes); 309 synchronized void nAllocationData2D(int id, int xoff, int yoff, int mip, int face, int w, int h, int[] d, int sizeBytes) { 310 validate(); 311 rsnAllocationData2D(mContext, id, xoff, yoff, mip, face, w, h, d, sizeBytes); 312 } 313 native void rsnAllocationData2D(int con, int id, int xoff, int yoff, int mip, int face, int w, int h, float[] d, int sizeBytes); 314 synchronized void nAllocationData2D(int id, int xoff, int yoff, int mip, int face, int w, int h, float[] d, int sizeBytes) { 315 validate(); 316 rsnAllocationData2D(mContext, id, xoff, yoff, mip, face, w, h, d, sizeBytes); 317 } 318 native void rsnAllocationData2D(int con, int id, int xoff, int yoff, int mip, int face, Bitmap b); 319 synchronized void nAllocationData2D(int id, int xoff, int yoff, int mip, int face, Bitmap b) { 320 validate(); 321 rsnAllocationData2D(mContext, id, xoff, yoff, mip, face, b); 322 } 323 324 native void rsnAllocationRead(int con, int id, byte[] d); 325 synchronized void nAllocationRead(int id, byte[] d) { 326 validate(); 327 rsnAllocationRead(mContext, id, d); 328 } 329 native void rsnAllocationRead(int con, int id, short[] d); 330 synchronized void nAllocationRead(int id, short[] d) { 331 validate(); 332 rsnAllocationRead(mContext, id, d); 333 } 334 native void rsnAllocationRead(int con, int id, int[] d); 335 synchronized void nAllocationRead(int id, int[] d) { 336 validate(); 337 rsnAllocationRead(mContext, id, d); 338 } 339 native void rsnAllocationRead(int con, int id, float[] d); 340 synchronized void nAllocationRead(int id, float[] d) { 341 validate(); 342 rsnAllocationRead(mContext, id, d); 343 } 344 native int rsnAllocationGetType(int con, int id); 345 synchronized int nAllocationGetType(int id) { 346 validate(); 347 return rsnAllocationGetType(mContext, id); 348 } 349 350 native void rsnAllocationResize1D(int con, int id, int dimX); 351 synchronized void nAllocationResize1D(int id, int dimX) { 352 validate(); 353 rsnAllocationResize1D(mContext, id, dimX); 354 } 355 native void rsnAllocationResize2D(int con, int id, int dimX, int dimY); 356 synchronized void nAllocationResize2D(int id, int dimX, int dimY) { 357 validate(); 358 rsnAllocationResize2D(mContext, id, dimX, dimY); 359 } 360 361 native int rsnFileA3DCreateFromAssetStream(int con, int assetStream); 362 synchronized int nFileA3DCreateFromAssetStream(int assetStream) { 363 validate(); 364 return rsnFileA3DCreateFromAssetStream(mContext, assetStream); 365 } 366 native int rsnFileA3DCreateFromFile(int con, String path); 367 synchronized int nFileA3DCreateFromFile(String path) { 368 validate(); 369 return rsnFileA3DCreateFromFile(mContext, path); 370 } 371 native int rsnFileA3DCreateFromAsset(int con, AssetManager mgr, String path); 372 synchronized int nFileA3DCreateFromAsset(AssetManager mgr, String path) { 373 validate(); 374 return rsnFileA3DCreateFromAsset(mContext, mgr, path); 375 } 376 native int rsnFileA3DGetNumIndexEntries(int con, int fileA3D); 377 synchronized int nFileA3DGetNumIndexEntries(int fileA3D) { 378 validate(); 379 return rsnFileA3DGetNumIndexEntries(mContext, fileA3D); 380 } 381 native void rsnFileA3DGetIndexEntries(int con, int fileA3D, int numEntries, int[] IDs, String[] names); 382 synchronized void nFileA3DGetIndexEntries(int fileA3D, int numEntries, int[] IDs, String[] names) { 383 validate(); 384 rsnFileA3DGetIndexEntries(mContext, fileA3D, numEntries, IDs, names); 385 } 386 native int rsnFileA3DGetEntryByIndex(int con, int fileA3D, int index); 387 synchronized int nFileA3DGetEntryByIndex(int fileA3D, int index) { 388 validate(); 389 return rsnFileA3DGetEntryByIndex(mContext, fileA3D, index); 390 } 391 392 native int rsnFontCreateFromFile(int con, String fileName, float size, int dpi); 393 synchronized int nFontCreateFromFile(String fileName, float size, int dpi) { 394 validate(); 395 return rsnFontCreateFromFile(mContext, fileName, size, dpi); 396 } 397 native int rsnFontCreateFromAssetStream(int con, String name, float size, int dpi, int assetStream); 398 synchronized int nFontCreateFromAssetStream(String name, float size, int dpi, int assetStream) { 399 validate(); 400 return rsnFontCreateFromAssetStream(mContext, name, size, dpi, assetStream); 401 } 402 native int rsnFontCreateFromAsset(int con, AssetManager mgr, String path, float size, int dpi); 403 synchronized int nFontCreateFromAsset(AssetManager mgr, String path, float size, int dpi) { 404 validate(); 405 return rsnFontCreateFromAsset(mContext, mgr, path, size, dpi); 406 } 407 408 409 native void rsnScriptBindAllocation(int con, int script, int alloc, int slot); 410 synchronized void nScriptBindAllocation(int script, int alloc, int slot) { 411 validate(); 412 rsnScriptBindAllocation(mContext, script, alloc, slot); 413 } 414 native void rsnScriptSetTimeZone(int con, int script, byte[] timeZone); 415 synchronized void nScriptSetTimeZone(int script, byte[] timeZone) { 416 validate(); 417 rsnScriptSetTimeZone(mContext, script, timeZone); 418 } 419 native void rsnScriptInvoke(int con, int id, int slot); 420 synchronized void nScriptInvoke(int id, int slot) { 421 validate(); 422 rsnScriptInvoke(mContext, id, slot); 423 } 424 native void rsnScriptInvokeV(int con, int id, int slot, byte[] params); 425 synchronized void nScriptInvokeV(int id, int slot, byte[] params) { 426 validate(); 427 rsnScriptInvokeV(mContext, id, slot, params); 428 } 429 native void rsnScriptSetVarI(int con, int id, int slot, int val); 430 synchronized void nScriptSetVarI(int id, int slot, int val) { 431 validate(); 432 rsnScriptSetVarI(mContext, id, slot, val); 433 } 434 native void rsnScriptSetVarJ(int con, int id, int slot, long val); 435 synchronized void nScriptSetVarJ(int id, int slot, long val) { 436 validate(); 437 rsnScriptSetVarJ(mContext, id, slot, val); 438 } 439 native void rsnScriptSetVarF(int con, int id, int slot, float val); 440 synchronized void nScriptSetVarF(int id, int slot, float val) { 441 validate(); 442 rsnScriptSetVarF(mContext, id, slot, val); 443 } 444 native void rsnScriptSetVarD(int con, int id, int slot, double val); 445 synchronized void nScriptSetVarD(int id, int slot, double val) { 446 validate(); 447 rsnScriptSetVarD(mContext, id, slot, val); 448 } 449 native void rsnScriptSetVarV(int con, int id, int slot, byte[] val); 450 synchronized void nScriptSetVarV(int id, int slot, byte[] val) { 451 validate(); 452 rsnScriptSetVarV(mContext, id, slot, val); 453 } 454 native void rsnScriptSetVarObj(int con, int id, int slot, int val); 455 synchronized void nScriptSetVarObj(int id, int slot, int val) { 456 validate(); 457 rsnScriptSetVarObj(mContext, id, slot, val); 458 } 459 460 native int rsnScriptCCreate(int con, String resName, String cacheDir, 461 byte[] script, int length); 462 synchronized int nScriptCCreate(String resName, String cacheDir, byte[] script, int length) { 463 validate(); 464 return rsnScriptCCreate(mContext, resName, cacheDir, script, length); 465 } 466 467 native void rsnSamplerBegin(int con); 468 synchronized void nSamplerBegin() { 469 validate(); 470 rsnSamplerBegin(mContext); 471 } 472 native void rsnSamplerSet(int con, int param, int value); 473 synchronized void nSamplerSet(int param, int value) { 474 validate(); 475 rsnSamplerSet(mContext, param, value); 476 } 477 native void rsnSamplerSet2(int con, int param, float value); 478 synchronized void nSamplerSet2(int param, float value) { 479 validate(); 480 rsnSamplerSet2(mContext, param, value); 481 } 482 native int rsnSamplerCreate(int con); 483 synchronized int nSamplerCreate() { 484 validate(); 485 return rsnSamplerCreate(mContext); 486 } 487 488 native int rsnProgramStoreCreate(int con, boolean r, boolean g, boolean b, boolean a, 489 boolean depthMask, boolean dither, 490 int srcMode, int dstMode, int depthFunc); 491 synchronized int nProgramStoreCreate(boolean r, boolean g, boolean b, boolean a, 492 boolean depthMask, boolean dither, 493 int srcMode, int dstMode, int depthFunc) { 494 validate(); 495 return rsnProgramStoreCreate(mContext, r, g, b, a, depthMask, dither, srcMode, dstMode, depthFunc); 496 } 497 498 native int rsnProgramRasterCreate(int con, boolean pointSmooth, boolean lineSmooth, 499 boolean pointSprite, float lineWidth, int cullMode); 500 synchronized int nProgramRasterCreate(boolean pointSmooth, boolean lineSmooth, 501 boolean pointSprite, float lineWidth, int cullMode) { 502 validate(); 503 return rsnProgramRasterCreate(mContext, pointSmooth, lineSmooth, pointSprite, lineWidth, cullMode); 504 } 505 506 native void rsnProgramBindConstants(int con, int pv, int slot, int mID); 507 synchronized void nProgramBindConstants(int pv, int slot, int mID) { 508 validate(); 509 rsnProgramBindConstants(mContext, pv, slot, mID); 510 } 511 native void rsnProgramBindTexture(int con, int vpf, int slot, int a); 512 synchronized void nProgramBindTexture(int vpf, int slot, int a) { 513 validate(); 514 rsnProgramBindTexture(mContext, vpf, slot, a); 515 } 516 native void rsnProgramBindSampler(int con, int vpf, int slot, int s); 517 synchronized void nProgramBindSampler(int vpf, int slot, int s) { 518 validate(); 519 rsnProgramBindSampler(mContext, vpf, slot, s); 520 } 521 native int rsnProgramFragmentCreate(int con, String shader, int[] params); 522 synchronized int nProgramFragmentCreate(String shader, int[] params) { 523 validate(); 524 return rsnProgramFragmentCreate(mContext, shader, params); 525 } 526 native int rsnProgramVertexCreate(int con, String shader, int[] params); 527 synchronized int nProgramVertexCreate(String shader, int[] params) { 528 validate(); 529 return rsnProgramVertexCreate(mContext, shader, params); 530 } 531 532 native int rsnMeshCreate(int con, int vtxCount, int indexCount); 533 synchronized int nMeshCreate(int vtxCount, int indexCount) { 534 validate(); 535 return rsnMeshCreate(mContext, vtxCount, indexCount); 536 } 537 native void rsnMeshBindVertex(int con, int id, int alloc, int slot); 538 synchronized void nMeshBindVertex(int id, int alloc, int slot) { 539 validate(); 540 rsnMeshBindVertex(mContext, id, alloc, slot); 541 } 542 native void rsnMeshBindIndex(int con, int id, int alloc, int prim, int slot); 543 synchronized void nMeshBindIndex(int id, int alloc, int prim, int slot) { 544 validate(); 545 rsnMeshBindIndex(mContext, id, alloc, prim, slot); 546 } 547 native void rsnMeshInitVertexAttribs(int con, int id); 548 synchronized void nMeshInitVertexAttribs(int id) { 549 validate(); 550 rsnMeshInitVertexAttribs(mContext, id); 551 } 552 native int rsnMeshGetVertexBufferCount(int con, int id); 553 synchronized int nMeshGetVertexBufferCount(int id) { 554 validate(); 555 return rsnMeshGetVertexBufferCount(mContext, id); 556 } 557 native int rsnMeshGetIndexCount(int con, int id); 558 synchronized int nMeshGetIndexCount(int id) { 559 validate(); 560 return rsnMeshGetIndexCount(mContext, id); 561 } 562 native void rsnMeshGetVertices(int con, int id, int[] vtxIds, int vtxIdCount); 563 synchronized void nMeshGetVertices(int id, int[] vtxIds, int vtxIdCount) { 564 validate(); 565 rsnMeshGetVertices(mContext, id, vtxIds, vtxIdCount); 566 } 567 native void rsnMeshGetIndices(int con, int id, int[] idxIds, int[] primitives, int vtxIdCount); 568 synchronized void nMeshGetIndices(int id, int[] idxIds, int[] primitives, int vtxIdCount) { 569 validate(); 570 rsnMeshGetIndices(mContext, id, idxIds, primitives, vtxIdCount); 571 } 572 573 574 int mDev; 575 int mContext; 576 @SuppressWarnings({"FieldCanBeLocal"}) 577 MessageThread mMessageThread; 578 579 Element mElement_U8; 580 Element mElement_I8; 581 Element mElement_U16; 582 Element mElement_I16; 583 Element mElement_U32; 584 Element mElement_I32; 585 Element mElement_U64; 586 Element mElement_I64; 587 Element mElement_F32; 588 Element mElement_F64; 589 Element mElement_BOOLEAN; 590 591 Element mElement_ELEMENT; 592 Element mElement_TYPE; 593 Element mElement_ALLOCATION; 594 Element mElement_SAMPLER; 595 Element mElement_SCRIPT; 596 Element mElement_MESH; 597 Element mElement_PROGRAM_FRAGMENT; 598 Element mElement_PROGRAM_VERTEX; 599 Element mElement_PROGRAM_RASTER; 600 Element mElement_PROGRAM_STORE; 601 602 Element mElement_A_8; 603 Element mElement_RGB_565; 604 Element mElement_RGB_888; 605 Element mElement_RGBA_5551; 606 Element mElement_RGBA_4444; 607 Element mElement_RGBA_8888; 608 609 Element mElement_FLOAT_2; 610 Element mElement_FLOAT_3; 611 Element mElement_FLOAT_4; 612 Element mElement_UCHAR_4; 613 614 Element mElement_MATRIX_4X4; 615 Element mElement_MATRIX_3X3; 616 Element mElement_MATRIX_2X2; 617 618 Sampler mSampler_CLAMP_NEAREST; 619 Sampler mSampler_CLAMP_LINEAR; 620 Sampler mSampler_CLAMP_LINEAR_MIP_LINEAR; 621 Sampler mSampler_WRAP_NEAREST; 622 Sampler mSampler_WRAP_LINEAR; 623 Sampler mSampler_WRAP_LINEAR_MIP_LINEAR; 624 625 ProgramStore mProgramStore_BLEND_NONE_DEPTH_TEST; 626 ProgramStore mProgramStore_BLEND_NONE_DEPTH_NO_DEPTH; 627 ProgramStore mProgramStore_BLEND_ALPHA_DEPTH_TEST; 628 ProgramStore mProgramStore_BLEND_ALPHA_DEPTH_NO_DEPTH; 629 630 ProgramRaster mProgramRaster_CULL_BACK; 631 ProgramRaster mProgramRaster_CULL_FRONT; 632 ProgramRaster mProgramRaster_CULL_NONE; 633 634 /////////////////////////////////////////////////////////////////////////////////// 635 // 636 637 /** 638 * Base class application should derive from for handling RS messages 639 * coming from their scripts. When a script calls sendToClient the data 640 * fields will be filled in and then the run method called by a message 641 * handling thread. This will occur some time after sendToClient completes 642 * in the script. 643 * 644 */ 645 public static class RSMessageHandler implements Runnable { 646 protected int[] mData; 647 protected int mID; 648 protected int mLength; 649 public void run() { 650 } 651 } 652 /** 653 * If an application is expecting messages it should set this field to an 654 * instance of RSMessage. This instance will receive all the user messages 655 * sent from sendToClient by scripts from this context. 656 * 657 */ 658 RSMessageHandler mMessageCallback = null; 659 660 public void setMessageHandler(RSMessageHandler msg) { 661 mMessageCallback = msg; 662 } 663 public RSMessageHandler getMessageHandler() { 664 return mMessageCallback; 665 } 666 667 /** 668 * Runtime error base class. An application should derive from this class 669 * if it wishes to install an error handler. When errors occur at runtime 670 * the fields in this class will be filled and the run method called. 671 * 672 */ 673 public static class RSErrorHandler implements Runnable { 674 protected String mErrorMessage; 675 protected int mErrorNum; 676 public void run() { 677 } 678 } 679 680 /** 681 * Application Error handler. All runtime errors will be dispatched to the 682 * instance of RSAsyncError set here. If this field is null a 683 * RSRuntimeException will instead be thrown with details about the error. 684 * This will cause program termaination. 685 * 686 */ 687 RSErrorHandler mErrorCallback = null; 688 689 public void setErrorHandler(RSErrorHandler msg) { 690 mErrorCallback = msg; 691 } 692 public RSErrorHandler getErrorHandler() { 693 return mErrorCallback; 694 } 695 696 /** 697 * RenderScript worker threads priority enumeration. The default value is 698 * NORMAL. Applications wishing to do background processing such as 699 * wallpapers should set their priority to LOW to avoid starving forground 700 * processes. 701 */ 702 public enum Priority { 703 // Remap these numbers to opaque... 704 LOW (5), //ANDROID_PRIORITY_BACKGROUND + 5 705 NORMAL (-4); //ANDROID_PRIORITY_DISPLAY 706 707 int mID; 708 Priority(int id) { 709 mID = id; 710 } 711 } 712 713 void validate() { 714 if (mContext == 0) { 715 throw new RSInvalidStateException("Calling RS with no Context active."); 716 } 717 } 718 719 720 /** 721 * Change the priority of the worker threads for this context. 722 * 723 * @param p New priority to be set. 724 */ 725 public void setPriority(Priority p) { 726 validate(); 727 nContextSetPriority(p.mID); 728 } 729 730 static class MessageThread extends Thread { 731 RenderScript mRS; 732 boolean mRun = true; 733 int[] mAuxData = new int[2]; 734 735 static final int RS_MESSAGE_TO_CLIENT_NONE = 0; 736 static final int RS_MESSAGE_TO_CLIENT_EXCEPTION = 1; 737 static final int RS_MESSAGE_TO_CLIENT_RESIZE = 2; 738 static final int RS_MESSAGE_TO_CLIENT_ERROR = 3; 739 static final int RS_MESSAGE_TO_CLIENT_USER = 4; 740 741 static final int RS_ERROR_FATAL_UNKNOWN = 0x1000; 742 743 MessageThread(RenderScript rs) { 744 super("RSMessageThread"); 745 mRS = rs; 746 747 } 748 749 public void run() { 750 // This function is a temporary solution. The final solution will 751 // used typed allocations where the message id is the type indicator. 752 int[] rbuf = new int[16]; 753 mRS.nContextInitToClient(mRS.mContext); 754 while(mRun) { 755 rbuf[0] = 0; 756 int msg = mRS.nContextPeekMessage(mRS.mContext, mAuxData, true); 757 int size = mAuxData[1]; 758 int subID = mAuxData[0]; 759 760 if (msg == RS_MESSAGE_TO_CLIENT_USER) { 761 if ((size>>2) >= rbuf.length) { 762 rbuf = new int[(size + 3) >> 2]; 763 } 764 mRS.nContextGetUserMessage(mRS.mContext, rbuf); 765 766 if(mRS.mMessageCallback != null) { 767 mRS.mMessageCallback.mData = rbuf; 768 mRS.mMessageCallback.mID = subID; 769 mRS.mMessageCallback.mLength = size; 770 mRS.mMessageCallback.run(); 771 } else { 772 throw new RSInvalidStateException("Received a message from the script with no message handler installed."); 773 } 774 continue; 775 } 776 777 if (msg == RS_MESSAGE_TO_CLIENT_ERROR) { 778 String e = mRS.nContextGetErrorMessage(mRS.mContext); 779 780 if (subID >= RS_ERROR_FATAL_UNKNOWN) { 781 throw new RSRuntimeException("Fatal error " + subID + ", details: " + e); 782 } 783 784 if(mRS.mErrorCallback != null) { 785 mRS.mErrorCallback.mErrorMessage = e; 786 mRS.mErrorCallback.mErrorNum = subID; 787 mRS.mErrorCallback.run(); 788 } else { 789 //throw new RSRuntimeException("Received error num " + subID + ", details: " + e); 790 } 791 continue; 792 } 793 794 // 2: teardown. 795 // But we want to avoid starving other threads during 796 // teardown by yielding until the next line in the destructor 797 // can execute to set mRun = false 798 try { 799 sleep(1, 0); 800 } catch(InterruptedException e) { 801 } 802 } 803 Log.d(LOG_TAG, "MessageThread exiting."); 804 } 805 } 806 807 RenderScript(Context ctx) { 808 mApplicationContext = ctx.getApplicationContext(); 809 } 810 811 /** 812 * Gets the application context associated with the RenderScript context. 813 * 814 * @return The application context. 815 */ 816 public final Context getApplicationContext() { 817 return mApplicationContext; 818 } 819 820 /** 821 * Create a basic RenderScript context. 822 * 823 * @param ctx The context. 824 * @return RenderScript 825 */ 826 public static RenderScript create(Context ctx) { 827 RenderScript rs = new RenderScript(ctx); 828 829 rs.mDev = rs.nDeviceCreate(); 830 rs.mContext = rs.nContextCreate(rs.mDev, 0); 831 rs.mMessageThread = new MessageThread(rs); 832 rs.mMessageThread.start(); 833 return rs; 834 } 835 836 /** 837 * Print the currently available debugging information about the state of 838 * the RS context to the log. 839 * 840 */ 841 public void contextDump() { 842 validate(); 843 nContextDump(0); 844 } 845 846 /** 847 * Wait for any commands in the fifo between the java bindings and native to 848 * be processed. 849 * 850 */ 851 public void finish() { 852 nContextFinish(); 853 } 854 855 /** 856 * Destroy this renderscript context. Once this function is called its no 857 * longer legal to use this or any objects created by this context. 858 * 859 */ 860 public void destroy() { 861 validate(); 862 nContextDeinitToClient(mContext); 863 mMessageThread.mRun = false; 864 try { 865 mMessageThread.join(); 866 } catch(InterruptedException e) { 867 } 868 869 nContextDestroy(); 870 mContext = 0; 871 872 nDeviceDestroy(mDev); 873 mDev = 0; 874 } 875 876 boolean isAlive() { 877 return mContext != 0; 878 } 879 880 int safeID(BaseObj o) { 881 if(o != null) { 882 return o.getID(); 883 } 884 return 0; 885 } 886} 887