The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 1 | #ifndef GraphicsJNI_DEFINED |
| 2 | #define GraphicsJNI_DEFINED |
| 3 | |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 4 | #include "SkBitmap.h" |
| 5 | #include "SkDevice.h" |
| 6 | #include "SkPixelRef.h" |
| 7 | #include "SkMallocPixelRef.h" |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 8 | #include "SkPoint.h" |
| 9 | #include "SkRect.h" |
Derek Sollenberger | 5827cb5 | 2013-07-26 14:58:06 -0400 | [diff] [blame] | 10 | #include "SkImageDecoder.h" |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 11 | #include <jni.h> |
| 12 | |
Derek Sollenberger | 5827cb5 | 2013-07-26 14:58:06 -0400 | [diff] [blame] | 13 | class SkBitmapRegionDecoder; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 14 | class SkCanvas; |
| 15 | class SkPaint; |
| 16 | class SkPicture; |
| 17 | |
| 18 | class GraphicsJNI { |
| 19 | public: |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 20 | enum BitmapCreateFlags { |
| 21 | kBitmapCreateFlag_None = 0x0, |
| 22 | kBitmapCreateFlag_Mutable = 0x1, |
| 23 | kBitmapCreateFlag_Premultiplied = 0x2, |
| 24 | }; |
| 25 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 26 | // returns true if an exception is set (and dumps it out to the Log) |
| 27 | static bool hasException(JNIEnv*); |
| 28 | |
| 29 | static void get_jrect(JNIEnv*, jobject jrect, int* L, int* T, int* R, int* B); |
| 30 | static void set_jrect(JNIEnv*, jobject jrect, int L, int T, int R, int B); |
| 31 | |
| 32 | static SkIRect* jrect_to_irect(JNIEnv*, jobject jrect, SkIRect*); |
| 33 | static void irect_to_jrect(const SkIRect&, JNIEnv*, jobject jrect); |
| 34 | |
| 35 | static SkRect* jrectf_to_rect(JNIEnv*, jobject jrectf, SkRect*); |
| 36 | static SkRect* jrect_to_rect(JNIEnv*, jobject jrect, SkRect*); |
| 37 | static void rect_to_jrectf(const SkRect&, JNIEnv*, jobject jrectf); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 38 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 39 | static void set_jpoint(JNIEnv*, jobject jrect, int x, int y); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 40 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 41 | static SkIPoint* jpoint_to_ipoint(JNIEnv*, jobject jpoint, SkIPoint* point); |
| 42 | static void ipoint_to_jpoint(const SkIPoint& point, JNIEnv*, jobject jpoint); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 43 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 44 | static SkPoint* jpointf_to_point(JNIEnv*, jobject jpointf, SkPoint* point); |
| 45 | static void point_to_jpointf(const SkPoint& point, JNIEnv*, jobject jpointf); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 46 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 47 | static SkCanvas* getNativeCanvas(JNIEnv*, jobject canvas); |
| 48 | static SkPaint* getNativePaint(JNIEnv*, jobject paint); |
| 49 | static SkBitmap* getNativeBitmap(JNIEnv*, jobject bitmap); |
| 50 | static SkPicture* getNativePicture(JNIEnv*, jobject picture); |
| 51 | static SkRegion* getNativeRegion(JNIEnv*, jobject region); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 52 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 53 | /** Return the corresponding native config from the java Config enum, |
| 54 | or kNo_Config if the java object is null. |
| 55 | */ |
| 56 | static SkBitmap::Config getNativeBitmapConfig(JNIEnv*, jobject jconfig); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 57 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 58 | /** Create a java Bitmap object given the native bitmap (required) and optional |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 59 | storage array (may be null). |
Leon Scroggins III | 8790be6 | 2013-12-03 16:26:51 -0500 | [diff] [blame] | 60 | bitmap's SkAlphaType must already be in sync with bitmapCreateFlags. |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 61 | */ |
| 62 | static jobject createBitmap(JNIEnv* env, SkBitmap* bitmap, jbyteArray buffer, |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 63 | int bitmapCreateFlags, jbyteArray ninepatch, jintArray layoutbounds, int density = -1); |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 64 | |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 65 | static jobject createBitmap(JNIEnv* env, SkBitmap* bitmap, int bitmapCreateFlags, |
| 66 | jbyteArray ninepatch, int density = -1); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 67 | |
Leon Scroggins III | 8790be6 | 2013-12-03 16:26:51 -0500 | [diff] [blame] | 68 | /** Reinitialize a bitmap. bitmap must already have its SkAlphaType set in |
| 69 | sync with isPremultiplied |
| 70 | */ |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 71 | static void reinitBitmap(JNIEnv* env, jobject javaBitmap, SkBitmap* bitmap, |
| 72 | bool isPremultiplied); |
Chris Craik | 9f58361 | 2013-05-20 18:13:47 -0700 | [diff] [blame] | 73 | |
| 74 | static int getBitmapAllocationByteCount(JNIEnv* env, jobject javaBitmap); |
| 75 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 76 | static jobject createRegion(JNIEnv* env, SkRegion* region); |
| 77 | |
Wei-Ta Chen | 6b849e2 | 2010-09-07 17:32:18 +0800 | [diff] [blame] | 78 | static jobject createBitmapRegionDecoder(JNIEnv* env, SkBitmapRegionDecoder* bitmap); |
Joseph Wen | f1f48bc | 2010-07-19 16:59:51 +0800 | [diff] [blame] | 79 | |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 80 | static jbyteArray allocateJavaPixelRef(JNIEnv* env, SkBitmap* bitmap, |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 81 | SkColorTable* ctable); |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 82 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 83 | /** Copy the colors in colors[] to the bitmap, convert to the correct |
| 84 | format along the way. |
| 85 | */ |
| 86 | static bool SetPixels(JNIEnv* env, jintArray colors, int srcOffset, |
Chris Craik | 1abf5d6 | 2013-08-16 12:47:03 -0700 | [diff] [blame] | 87 | int srcStride, int x, int y, int width, int height, |
| 88 | const SkBitmap& dstBitmap, bool isPremultiplied); |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 89 | |
| 90 | static jbyteArray getBitmapStorageObj(SkPixelRef *pixref); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 91 | }; |
| 92 | |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 93 | class AndroidPixelRef : public SkMallocPixelRef { |
| 94 | public: |
Derek Sollenberger | b644a3b | 2014-01-17 15:45:10 -0500 | [diff] [blame] | 95 | AndroidPixelRef(JNIEnv* env, const SkImageInfo& info, void* storage, size_t rowBytes, |
| 96 | jbyteArray storageObj, SkColorTable* ctable); |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 97 | |
Chris Craik | cd0ba71 | 2013-09-06 14:40:30 -0700 | [diff] [blame] | 98 | /** |
| 99 | * Creates an AndroidPixelRef that wraps (and refs) another to reuse/share |
| 100 | * the same storage and java byte array refcounting, yet have a different |
| 101 | * color table. |
| 102 | */ |
Derek Sollenberger | b644a3b | 2014-01-17 15:45:10 -0500 | [diff] [blame] | 103 | AndroidPixelRef(AndroidPixelRef& wrappedPixelRef, const SkImageInfo& info, |
| 104 | size_t rowBytes, SkColorTable* ctable); |
Chris Craik | cd0ba71 | 2013-09-06 14:40:30 -0700 | [diff] [blame] | 105 | |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 106 | virtual ~AndroidPixelRef(); |
| 107 | |
Chris Craik | cd0ba71 | 2013-09-06 14:40:30 -0700 | [diff] [blame] | 108 | jbyteArray getStorageObj(); |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 109 | |
| 110 | void setLocalJNIRef(jbyteArray arr); |
| 111 | |
Patrick Dubroy | a2f0e2d | 2010-12-15 15:03:47 -0800 | [diff] [blame] | 112 | /** Used to hold a ref to the pixels when the Java bitmap may be collected. |
| 113 | * If specified, 'localref' is a valid JNI local reference to the byte array |
| 114 | * containing the pixel data. |
| 115 | * |
| 116 | * 'localref' may only be NULL if setLocalJNIRef() was already called with |
| 117 | * a JNI local ref that is still valid. |
| 118 | */ |
| 119 | virtual void globalRef(void* localref=NULL); |
| 120 | |
| 121 | /** Release a ref that was acquired using globalRef(). */ |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 122 | virtual void globalUnref(); |
| 123 | |
| 124 | private: |
Chris Craik | cd0ba71 | 2013-09-06 14:40:30 -0700 | [diff] [blame] | 125 | AndroidPixelRef* const fWrappedPixelRef; // if set, delegate memory management calls to this |
| 126 | |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 127 | JavaVM* fVM; |
| 128 | bool fOnJavaHeap; // If true, the memory was allocated on the Java heap |
| 129 | |
| 130 | jbyteArray fStorageObj; // The Java byte[] object used as the bitmap backing store |
| 131 | bool fHasGlobalRef; // If true, fStorageObj holds a JNI global ref |
| 132 | |
| 133 | mutable int32_t fGlobalRefCnt; |
| 134 | }; |
| 135 | |
| 136 | /** A helper class for accessing Java-heap-allocated bitmaps. |
| 137 | * This should be used when calling into a JNI method that retains a |
| 138 | * reference to the bitmap longer than the lifetime of the Java Bitmap. |
| 139 | * |
| 140 | * After creating an instance of this class, a call to |
| 141 | * AndroidPixelRef::globalRef() will allocate a JNI global reference |
| 142 | * to the backing buffer object. |
| 143 | */ |
| 144 | class JavaHeapBitmapRef { |
| 145 | public: |
| 146 | |
| 147 | JavaHeapBitmapRef(JNIEnv *env, SkBitmap* nativeBitmap, jbyteArray buffer); |
| 148 | ~JavaHeapBitmapRef(); |
| 149 | |
| 150 | private: |
| 151 | JNIEnv* fEnv; |
| 152 | SkBitmap* fNativeBitmap; |
| 153 | jbyteArray fBuffer; |
| 154 | }; |
| 155 | |
| 156 | /** Allocator which allocates the backing buffer in the Java heap. |
| 157 | * Instances can only be used to perform a single allocation, which helps |
| 158 | * ensure that the allocated buffer is properly accounted for with a |
| 159 | * reference in the heap (or a JNI global reference). |
| 160 | */ |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 161 | class JavaPixelAllocator : public SkBitmap::Allocator { |
| 162 | public: |
Carl Shapiro | 12d81c4 | 2010-12-17 18:36:48 -0800 | [diff] [blame] | 163 | JavaPixelAllocator(JNIEnv* env); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 164 | // overrides |
| 165 | virtual bool allocPixelRef(SkBitmap* bitmap, SkColorTable* ctable); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 166 | |
Patrick Dubroy | afde46e | 2010-12-15 11:52:01 -0800 | [diff] [blame] | 167 | /** Return the Java array object created for the last allocation. |
| 168 | * This returns a local JNI reference which the caller is responsible |
| 169 | * for storing appropriately (usually by passing it to the Bitmap |
| 170 | * constructor). |
| 171 | */ |
| 172 | jbyteArray getStorageObj() { return fStorageObj; } |
| 173 | |
| 174 | /** Same as getStorageObj(), but also resets the allocator so that it |
| 175 | * can allocate again. |
| 176 | */ |
| 177 | jbyteArray getStorageObjAndReset() { |
| 178 | jbyteArray result = fStorageObj; |
| 179 | fStorageObj = NULL; |
| 180 | fAllocCount = 0; |
| 181 | return result; |
| 182 | }; |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 183 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 184 | private: |
Wei-Ta Chen | 291303b | 2010-08-18 15:40:29 +0800 | [diff] [blame] | 185 | JavaVM* fVM; |
Patrick Dubroy | e4ac2d6 | 2010-12-01 11:23:13 -0800 | [diff] [blame] | 186 | bool fAllocateInJavaHeap; |
| 187 | jbyteArray fStorageObj; |
Patrick Dubroy | afde46e | 2010-12-15 11:52:01 -0800 | [diff] [blame] | 188 | int fAllocCount; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 189 | }; |
| 190 | |
Mike Reed | c04851f | 2009-10-28 15:09:45 -0400 | [diff] [blame] | 191 | enum JNIAccess { |
| 192 | kRO_JNIAccess, |
| 193 | kRW_JNIAccess |
| 194 | }; |
| 195 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 196 | class AutoJavaFloatArray { |
| 197 | public: |
Mike Reed | c04851f | 2009-10-28 15:09:45 -0400 | [diff] [blame] | 198 | AutoJavaFloatArray(JNIEnv* env, jfloatArray array, |
| 199 | int minLength = 0, JNIAccess = kRW_JNIAccess); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 200 | ~AutoJavaFloatArray(); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 201 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 202 | float* ptr() const { return fPtr; } |
| 203 | int length() const { return fLen; } |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 204 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 205 | private: |
| 206 | JNIEnv* fEnv; |
| 207 | jfloatArray fArray; |
| 208 | float* fPtr; |
| 209 | int fLen; |
Mike Reed | c04851f | 2009-10-28 15:09:45 -0400 | [diff] [blame] | 210 | int fReleaseMode; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 211 | }; |
| 212 | |
| 213 | class AutoJavaIntArray { |
| 214 | public: |
| 215 | AutoJavaIntArray(JNIEnv* env, jintArray array, int minLength = 0); |
| 216 | ~AutoJavaIntArray(); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 217 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 218 | jint* ptr() const { return fPtr; } |
| 219 | int length() const { return fLen; } |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 220 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 221 | private: |
| 222 | JNIEnv* fEnv; |
| 223 | jintArray fArray; |
| 224 | jint* fPtr; |
| 225 | int fLen; |
| 226 | }; |
| 227 | |
| 228 | class AutoJavaShortArray { |
| 229 | public: |
Mike Reed | c04851f | 2009-10-28 15:09:45 -0400 | [diff] [blame] | 230 | AutoJavaShortArray(JNIEnv* env, jshortArray array, |
| 231 | int minLength = 0, JNIAccess = kRW_JNIAccess); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 232 | ~AutoJavaShortArray(); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 233 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 234 | jshort* ptr() const { return fPtr; } |
| 235 | int length() const { return fLen; } |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 236 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 237 | private: |
| 238 | JNIEnv* fEnv; |
| 239 | jshortArray fArray; |
| 240 | jshort* fPtr; |
| 241 | int fLen; |
Mike Reed | c04851f | 2009-10-28 15:09:45 -0400 | [diff] [blame] | 242 | int fReleaseMode; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 243 | }; |
| 244 | |
| 245 | class AutoJavaByteArray { |
| 246 | public: |
| 247 | AutoJavaByteArray(JNIEnv* env, jbyteArray array, int minLength = 0); |
| 248 | ~AutoJavaByteArray(); |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 249 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 250 | jbyte* ptr() const { return fPtr; } |
| 251 | int length() const { return fLen; } |
Elliott Hughes | 8451b25 | 2011-04-07 19:17:57 -0700 | [diff] [blame] | 252 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 253 | private: |
| 254 | JNIEnv* fEnv; |
| 255 | jbyteArray fArray; |
| 256 | jbyte* fPtr; |
| 257 | int fLen; |
| 258 | }; |
| 259 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 260 | void doThrowNPE(JNIEnv* env); |
| 261 | void doThrowAIOOBE(JNIEnv* env); // Array Index Out Of Bounds Exception |
| 262 | void doThrowIAE(JNIEnv* env, const char* msg = NULL); // Illegal Argument |
| 263 | void doThrowRE(JNIEnv* env, const char* msg = NULL); // Runtime |
| 264 | void doThrowISE(JNIEnv* env, const char* msg = NULL); // Illegal State |
| 265 | void doThrowOOME(JNIEnv* env, const char* msg = NULL); // Out of memory |
Joseph Wen | f1f48bc | 2010-07-19 16:59:51 +0800 | [diff] [blame] | 266 | void doThrowIOE(JNIEnv* env, const char* msg = NULL); // IO Exception |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 267 | |
| 268 | #define NPE_CHECK_RETURN_ZERO(env, object) \ |
| 269 | do { if (NULL == (object)) { doThrowNPE(env); return 0; } } while (0) |
| 270 | |
| 271 | #define NPE_CHECK_RETURN_VOID(env, object) \ |
| 272 | do { if (NULL == (object)) { doThrowNPE(env); return; } } while (0) |
| 273 | |
| 274 | #endif |