RenderScript.java revision 260c77a4f741c3db76057cc4ea2ee54fe335ecf9
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.os.Process; 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 = false; 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 int nContextGetUserMessage(int con, int[] data); 73 native String nContextGetErrorMessage(int con); 74 native int nContextPeekMessage(int con, int[] subID); 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 rsnScriptForEach(int con, int id, int slot, int ain, int aout, byte[] params); 425 native void rsnScriptForEach(int con, int id, int slot, int ain, int aout); 426 synchronized void nScriptForEach(int id, int slot, int ain, int aout, byte[] params) { 427 validate(); 428 if (params == null) { 429 rsnScriptForEach(mContext, id, slot, ain, aout); 430 } else { 431 rsnScriptForEach(mContext, id, slot, ain, aout, params); 432 } 433 } 434 native void rsnScriptInvokeV(int con, int id, int slot, byte[] params); 435 synchronized void nScriptInvokeV(int id, int slot, byte[] params) { 436 validate(); 437 rsnScriptInvokeV(mContext, id, slot, params); 438 } 439 native void rsnScriptSetVarI(int con, int id, int slot, int val); 440 synchronized void nScriptSetVarI(int id, int slot, int val) { 441 validate(); 442 rsnScriptSetVarI(mContext, id, slot, val); 443 } 444 native void rsnScriptSetVarJ(int con, int id, int slot, long val); 445 synchronized void nScriptSetVarJ(int id, int slot, long val) { 446 validate(); 447 rsnScriptSetVarJ(mContext, id, slot, val); 448 } 449 native void rsnScriptSetVarF(int con, int id, int slot, float val); 450 synchronized void nScriptSetVarF(int id, int slot, float val) { 451 validate(); 452 rsnScriptSetVarF(mContext, id, slot, val); 453 } 454 native void rsnScriptSetVarD(int con, int id, int slot, double val); 455 synchronized void nScriptSetVarD(int id, int slot, double val) { 456 validate(); 457 rsnScriptSetVarD(mContext, id, slot, val); 458 } 459 native void rsnScriptSetVarV(int con, int id, int slot, byte[] val); 460 synchronized void nScriptSetVarV(int id, int slot, byte[] val) { 461 validate(); 462 rsnScriptSetVarV(mContext, id, slot, val); 463 } 464 native void rsnScriptSetVarObj(int con, int id, int slot, int val); 465 synchronized void nScriptSetVarObj(int id, int slot, int val) { 466 validate(); 467 rsnScriptSetVarObj(mContext, id, slot, val); 468 } 469 470 native int rsnScriptCCreate(int con, String resName, String cacheDir, 471 byte[] script, int length); 472 synchronized int nScriptCCreate(String resName, String cacheDir, byte[] script, int length) { 473 validate(); 474 return rsnScriptCCreate(mContext, resName, cacheDir, script, length); 475 } 476 477 native int rsnSamplerCreate(int con, int magFilter, int minFilter, 478 int wrapS, int wrapT, int wrapR, float aniso); 479 synchronized int nSamplerCreate(int magFilter, int minFilter, 480 int wrapS, int wrapT, int wrapR, float aniso) { 481 validate(); 482 return rsnSamplerCreate(mContext, magFilter, minFilter, wrapS, wrapT, wrapR, aniso); 483 } 484 485 native int rsnProgramStoreCreate(int con, boolean r, boolean g, boolean b, boolean a, 486 boolean depthMask, boolean dither, 487 int srcMode, int dstMode, int depthFunc); 488 synchronized int nProgramStoreCreate(boolean r, boolean g, boolean b, boolean a, 489 boolean depthMask, boolean dither, 490 int srcMode, int dstMode, int depthFunc) { 491 validate(); 492 return rsnProgramStoreCreate(mContext, r, g, b, a, depthMask, dither, srcMode, 493 dstMode, depthFunc); 494 } 495 496 native int rsnProgramRasterCreate(int con, boolean pointSmooth, boolean lineSmooth, 497 boolean pointSprite, float lineWidth, int cullMode); 498 synchronized int nProgramRasterCreate(boolean pointSmooth, boolean lineSmooth, 499 boolean pointSprite, float lineWidth, int cullMode) { 500 validate(); 501 return rsnProgramRasterCreate(mContext, pointSmooth, lineSmooth, pointSprite, lineWidth, 502 cullMode); 503 } 504 505 native void rsnProgramBindConstants(int con, int pv, int slot, int mID); 506 synchronized void nProgramBindConstants(int pv, int slot, int mID) { 507 validate(); 508 rsnProgramBindConstants(mContext, pv, slot, mID); 509 } 510 native void rsnProgramBindTexture(int con, int vpf, int slot, int a); 511 synchronized void nProgramBindTexture(int vpf, int slot, int a) { 512 validate(); 513 rsnProgramBindTexture(mContext, vpf, slot, a); 514 } 515 native void rsnProgramBindSampler(int con, int vpf, int slot, int s); 516 synchronized void nProgramBindSampler(int vpf, int slot, int s) { 517 validate(); 518 rsnProgramBindSampler(mContext, vpf, slot, s); 519 } 520 native int rsnProgramFragmentCreate(int con, String shader, int[] params); 521 synchronized int nProgramFragmentCreate(String shader, int[] params) { 522 validate(); 523 return rsnProgramFragmentCreate(mContext, shader, params); 524 } 525 native int rsnProgramVertexCreate(int con, String shader, int[] params); 526 synchronized int nProgramVertexCreate(String shader, int[] params) { 527 validate(); 528 return rsnProgramVertexCreate(mContext, shader, params); 529 } 530 531 native int rsnMeshCreate(int con, int[] vtx, int[] idx, int[] prim); 532 synchronized int nMeshCreate(int[] vtx, int[] idx, int[] prim) { 533 validate(); 534 return rsnMeshCreate(mContext, vtx, idx, prim); 535 } 536 native int rsnMeshGetVertexBufferCount(int con, int id); 537 synchronized int nMeshGetVertexBufferCount(int id) { 538 validate(); 539 return rsnMeshGetVertexBufferCount(mContext, id); 540 } 541 native int rsnMeshGetIndexCount(int con, int id); 542 synchronized int nMeshGetIndexCount(int id) { 543 validate(); 544 return rsnMeshGetIndexCount(mContext, id); 545 } 546 native void rsnMeshGetVertices(int con, int id, int[] vtxIds, int vtxIdCount); 547 synchronized void nMeshGetVertices(int id, int[] vtxIds, int vtxIdCount) { 548 validate(); 549 rsnMeshGetVertices(mContext, id, vtxIds, vtxIdCount); 550 } 551 native void rsnMeshGetIndices(int con, int id, int[] idxIds, int[] primitives, int vtxIdCount); 552 synchronized void nMeshGetIndices(int id, int[] idxIds, int[] primitives, int vtxIdCount) { 553 validate(); 554 rsnMeshGetIndices(mContext, id, idxIds, primitives, vtxIdCount); 555 } 556 557 558 int mDev; 559 int mContext; 560 @SuppressWarnings({"FieldCanBeLocal"}) 561 MessageThread mMessageThread; 562 563 Element mElement_U8; 564 Element mElement_I8; 565 Element mElement_U16; 566 Element mElement_I16; 567 Element mElement_U32; 568 Element mElement_I32; 569 Element mElement_U64; 570 Element mElement_I64; 571 Element mElement_F32; 572 Element mElement_F64; 573 Element mElement_BOOLEAN; 574 575 Element mElement_ELEMENT; 576 Element mElement_TYPE; 577 Element mElement_ALLOCATION; 578 Element mElement_SAMPLER; 579 Element mElement_SCRIPT; 580 Element mElement_MESH; 581 Element mElement_PROGRAM_FRAGMENT; 582 Element mElement_PROGRAM_VERTEX; 583 Element mElement_PROGRAM_RASTER; 584 Element mElement_PROGRAM_STORE; 585 586 Element mElement_A_8; 587 Element mElement_RGB_565; 588 Element mElement_RGB_888; 589 Element mElement_RGBA_5551; 590 Element mElement_RGBA_4444; 591 Element mElement_RGBA_8888; 592 593 Element mElement_FLOAT_2; 594 Element mElement_FLOAT_3; 595 Element mElement_FLOAT_4; 596 Element mElement_UCHAR_4; 597 598 Element mElement_MATRIX_4X4; 599 Element mElement_MATRIX_3X3; 600 Element mElement_MATRIX_2X2; 601 602 Sampler mSampler_CLAMP_NEAREST; 603 Sampler mSampler_CLAMP_LINEAR; 604 Sampler mSampler_CLAMP_LINEAR_MIP_LINEAR; 605 Sampler mSampler_WRAP_NEAREST; 606 Sampler mSampler_WRAP_LINEAR; 607 Sampler mSampler_WRAP_LINEAR_MIP_LINEAR; 608 609 ProgramStore mProgramStore_BLEND_NONE_DEPTH_TEST; 610 ProgramStore mProgramStore_BLEND_NONE_DEPTH_NO_DEPTH; 611 ProgramStore mProgramStore_BLEND_ALPHA_DEPTH_TEST; 612 ProgramStore mProgramStore_BLEND_ALPHA_DEPTH_NO_DEPTH; 613 614 ProgramRaster mProgramRaster_CULL_BACK; 615 ProgramRaster mProgramRaster_CULL_FRONT; 616 ProgramRaster mProgramRaster_CULL_NONE; 617 618 /////////////////////////////////////////////////////////////////////////////////// 619 // 620 621 /** 622 * Base class application should derive from for handling RS messages 623 * coming from their scripts. When a script calls sendToClient the data 624 * fields will be filled in and then the run method called by a message 625 * handling thread. This will occur some time after sendToClient completes 626 * in the script. 627 * 628 */ 629 public static class RSMessageHandler implements Runnable { 630 protected int[] mData; 631 protected int mID; 632 protected int mLength; 633 public void run() { 634 } 635 } 636 /** 637 * If an application is expecting messages it should set this field to an 638 * instance of RSMessage. This instance will receive all the user messages 639 * sent from sendToClient by scripts from this context. 640 * 641 */ 642 RSMessageHandler mMessageCallback = null; 643 644 public void setMessageHandler(RSMessageHandler msg) { 645 mMessageCallback = msg; 646 } 647 public RSMessageHandler getMessageHandler() { 648 return mMessageCallback; 649 } 650 651 /** 652 * Runtime error base class. An application should derive from this class 653 * if it wishes to install an error handler. When errors occur at runtime 654 * the fields in this class will be filled and the run method called. 655 * 656 */ 657 public static class RSErrorHandler implements Runnable { 658 protected String mErrorMessage; 659 protected int mErrorNum; 660 public void run() { 661 } 662 } 663 664 /** 665 * Application Error handler. All runtime errors will be dispatched to the 666 * instance of RSAsyncError set here. If this field is null a 667 * RSRuntimeException will instead be thrown with details about the error. 668 * This will cause program termaination. 669 * 670 */ 671 RSErrorHandler mErrorCallback = null; 672 673 public void setErrorHandler(RSErrorHandler msg) { 674 mErrorCallback = msg; 675 } 676 public RSErrorHandler getErrorHandler() { 677 return mErrorCallback; 678 } 679 680 /** 681 * RenderScript worker threads priority enumeration. The default value is 682 * NORMAL. Applications wishing to do background processing such as 683 * wallpapers should set their priority to LOW to avoid starving forground 684 * processes. 685 */ 686 public enum Priority { 687 LOW (Process.THREAD_PRIORITY_BACKGROUND + (5 * Process.THREAD_PRIORITY_LESS_FAVORABLE)), 688 NORMAL (Process.THREAD_PRIORITY_DISPLAY); 689 690 int mID; 691 Priority(int id) { 692 mID = id; 693 } 694 } 695 696 void validate() { 697 if (mContext == 0) { 698 throw new RSInvalidStateException("Calling RS with no Context active."); 699 } 700 } 701 702 703 /** 704 * Change the priority of the worker threads for this context. 705 * 706 * @param p New priority to be set. 707 */ 708 public void setPriority(Priority p) { 709 validate(); 710 nContextSetPriority(p.mID); 711 } 712 713 static class MessageThread extends Thread { 714 RenderScript mRS; 715 boolean mRun = true; 716 int[] mAuxData = new int[2]; 717 718 static final int RS_MESSAGE_TO_CLIENT_NONE = 0; 719 static final int RS_MESSAGE_TO_CLIENT_EXCEPTION = 1; 720 static final int RS_MESSAGE_TO_CLIENT_RESIZE = 2; 721 static final int RS_MESSAGE_TO_CLIENT_ERROR = 3; 722 static final int RS_MESSAGE_TO_CLIENT_USER = 4; 723 724 static final int RS_ERROR_FATAL_UNKNOWN = 0x1000; 725 726 MessageThread(RenderScript rs) { 727 super("RSMessageThread"); 728 mRS = rs; 729 730 } 731 732 public void run() { 733 // This function is a temporary solution. The final solution will 734 // used typed allocations where the message id is the type indicator. 735 int[] rbuf = new int[16]; 736 mRS.nContextInitToClient(mRS.mContext); 737 while(mRun) { 738 rbuf[0] = 0; 739 int msg = mRS.nContextPeekMessage(mRS.mContext, mAuxData); 740 int size = mAuxData[1]; 741 int subID = mAuxData[0]; 742 743 if (msg == RS_MESSAGE_TO_CLIENT_USER) { 744 if ((size>>2) >= rbuf.length) { 745 rbuf = new int[(size + 3) >> 2]; 746 } 747 if (mRS.nContextGetUserMessage(mRS.mContext, rbuf) != 748 RS_MESSAGE_TO_CLIENT_USER) { 749 throw new RSDriverException("Error processing message from Renderscript."); 750 } 751 752 if(mRS.mMessageCallback != null) { 753 mRS.mMessageCallback.mData = rbuf; 754 mRS.mMessageCallback.mID = subID; 755 mRS.mMessageCallback.mLength = size; 756 mRS.mMessageCallback.run(); 757 } else { 758 throw new RSInvalidStateException("Received a message from the script with no message handler installed."); 759 } 760 continue; 761 } 762 763 if (msg == RS_MESSAGE_TO_CLIENT_ERROR) { 764 String e = mRS.nContextGetErrorMessage(mRS.mContext); 765 766 if (subID >= RS_ERROR_FATAL_UNKNOWN) { 767 throw new RSRuntimeException("Fatal error " + subID + ", details: " + e); 768 } 769 770 if(mRS.mErrorCallback != null) { 771 mRS.mErrorCallback.mErrorMessage = e; 772 mRS.mErrorCallback.mErrorNum = subID; 773 mRS.mErrorCallback.run(); 774 } else { 775 //throw new RSRuntimeException("Received error num " + subID + ", details: " + e); 776 } 777 continue; 778 } 779 780 // 2: teardown. 781 // But we want to avoid starving other threads during 782 // teardown by yielding until the next line in the destructor 783 // can execute to set mRun = false 784 try { 785 sleep(1, 0); 786 } catch(InterruptedException e) { 787 } 788 } 789 Log.d(LOG_TAG, "MessageThread exiting."); 790 } 791 } 792 793 RenderScript(Context ctx) { 794 mApplicationContext = ctx.getApplicationContext(); 795 } 796 797 /** 798 * Gets the application context associated with the RenderScript context. 799 * 800 * @return The application context. 801 */ 802 public final Context getApplicationContext() { 803 return mApplicationContext; 804 } 805 806 /** 807 * Create a basic RenderScript context. 808 * 809 * @param ctx The context. 810 * @return RenderScript 811 */ 812 public static RenderScript create(Context ctx) { 813 RenderScript rs = new RenderScript(ctx); 814 815 rs.mDev = rs.nDeviceCreate(); 816 rs.mContext = rs.nContextCreate(rs.mDev, 0); 817 if (rs.mContext == 0) { 818 throw new RSDriverException("Failed to create RS context."); 819 } 820 rs.mMessageThread = new MessageThread(rs); 821 rs.mMessageThread.start(); 822 return rs; 823 } 824 825 /** 826 * Print the currently available debugging information about the state of 827 * the RS context to the log. 828 * 829 */ 830 public void contextDump() { 831 validate(); 832 nContextDump(0); 833 } 834 835 /** 836 * Wait for any commands in the fifo between the java bindings and native to 837 * be processed. 838 * 839 */ 840 public void finish() { 841 nContextFinish(); 842 } 843 844 /** 845 * Destroy this renderscript context. Once this function is called its no 846 * longer legal to use this or any objects created by this context. 847 * 848 */ 849 public void destroy() { 850 validate(); 851 nContextDeinitToClient(mContext); 852 mMessageThread.mRun = false; 853 try { 854 mMessageThread.join(); 855 } catch(InterruptedException e) { 856 } 857 858 nContextDestroy(); 859 mContext = 0; 860 861 nDeviceDestroy(mDev); 862 mDev = 0; 863 } 864 865 boolean isAlive() { 866 return mContext != 0; 867 } 868 869 int safeID(BaseObj o) { 870 if(o != null) { 871 return o.getID(); 872 } 873 return 0; 874 } 875} 876