Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 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 | |
| 17 | package android.renderscript; |
| 18 | |
Artur Satayev | 2ebb31c | 2020-01-08 12:24:36 +0000 | [diff] [blame] | 19 | import android.compat.annotation.UnsupportedAppUsage; |
| 20 | |
Yang Ni | eb4dd08 | 2016-03-24 09:40:32 -0700 | [diff] [blame] | 21 | import dalvik.system.CloseGuard; |
Artur Satayev | 2ebb31c | 2020-01-08 12:24:36 +0000 | [diff] [blame] | 22 | |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 23 | import java.util.concurrent.locks.ReentrantReadWriteLock; |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 24 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 25 | /** |
Tim Murray | c11e25c | 2013-04-09 11:01:01 -0700 | [diff] [blame] | 26 | * BaseObj is the base class for all RenderScript objects owned by a RS context. |
| 27 | * It is responsible for lifetime management and resource tracking. This class |
| 28 | * should not be used by a user application. |
Jason Sams | 06d69de | 2010-11-09 17:11:40 -0800 | [diff] [blame] | 29 | * |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 30 | **/ |
Stephen Hines | ef353dd | 2011-03-31 14:45:36 -0700 | [diff] [blame] | 31 | public class BaseObj { |
Tim Murray | 7a629fa | 2013-11-19 12:45:54 -0800 | [diff] [blame] | 32 | BaseObj(long id, RenderScript rs) { |
Jason Sams | 718cd1f | 2009-12-23 14:35:29 -0800 | [diff] [blame] | 33 | rs.validate(); |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 34 | mRS = rs; |
Alex Sakhartchouk | 0de9444 | 2010-08-11 14:41:28 -0700 | [diff] [blame] | 35 | mID = id; |
Jason Sams | 1bada8c | 2009-08-09 17:01:55 -0700 | [diff] [blame] | 36 | mDestroyed = false; |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 37 | } |
| 38 | |
Ashok Bhat | 0e0c088 | 2014-02-04 14:57:58 +0000 | [diff] [blame] | 39 | void setID(long id) { |
Jason Sams | 06d69de | 2010-11-09 17:11:40 -0800 | [diff] [blame] | 40 | if (mID != 0) { |
| 41 | throw new RSRuntimeException("Internal Error, reset of object ID."); |
| 42 | } |
| 43 | mID = id; |
| 44 | } |
| 45 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 46 | /** |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 47 | * Lookup the native object ID for this object. Primarily used by the |
| 48 | * generated reflected code. |
| 49 | * |
Jason Sams | e07694b | 2012-04-03 15:36:36 -0700 | [diff] [blame] | 50 | * @param rs Context to verify against internal context for |
| 51 | * match. |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 52 | * |
Tim Murray | 7a629fa | 2013-11-19 12:45:54 -0800 | [diff] [blame] | 53 | * @return long |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 54 | */ |
Tim Murray | 7a629fa | 2013-11-19 12:45:54 -0800 | [diff] [blame] | 55 | long getID(RenderScript rs) { |
Jason Sams | e07694b | 2012-04-03 15:36:36 -0700 | [diff] [blame] | 56 | mRS.validate(); |
Jason Sams | 7aa150c | 2010-09-21 14:47:22 -0700 | [diff] [blame] | 57 | if (mDestroyed) { |
Jason Sams | c1d6210 | 2010-11-04 14:32:19 -0700 | [diff] [blame] | 58 | throw new RSInvalidStateException("using a destroyed object."); |
Jason Sams | 7aa150c | 2010-09-21 14:47:22 -0700 | [diff] [blame] | 59 | } |
Jason Sams | 5476b45 | 2010-12-08 16:14:36 -0800 | [diff] [blame] | 60 | if (mID == 0) { |
| 61 | throw new RSRuntimeException("Internal error: Object id 0."); |
| 62 | } |
Jason Sams | e07694b | 2012-04-03 15:36:36 -0700 | [diff] [blame] | 63 | if ((rs != null) && (rs != mRS)) { |
| 64 | throw new RSInvalidStateException("using object with mismatched context."); |
| 65 | } |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 66 | return mID; |
| 67 | } |
| 68 | |
Jason Sams | bf6ef8d | 2010-12-06 15:59:59 -0800 | [diff] [blame] | 69 | void checkValid() { |
| 70 | if (mID == 0) { |
| 71 | throw new RSIllegalArgumentException("Invalid object."); |
| 72 | } |
| 73 | } |
| 74 | |
Tim Murray | 7a629fa | 2013-11-19 12:45:54 -0800 | [diff] [blame] | 75 | private long mID; |
Yang Ni | eb4dd08 | 2016-03-24 09:40:32 -0700 | [diff] [blame] | 76 | final CloseGuard guard = CloseGuard.get(); |
Jason Sams | 06d69de | 2010-11-09 17:11:40 -0800 | [diff] [blame] | 77 | private boolean mDestroyed; |
| 78 | private String mName; |
Mathew Inwood | 1532447 | 2018-08-06 11:18:49 +0100 | [diff] [blame] | 79 | @UnsupportedAppUsage |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 80 | RenderScript mRS; |
| 81 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 82 | /** |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 83 | * setName assigns a name to an object. This object can later be looked up |
Tim Murray | c11e25c | 2013-04-09 11:01:01 -0700 | [diff] [blame] | 84 | * by this name. |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 85 | * |
| 86 | * @param name The name to assign to the object. |
| 87 | */ |
| 88 | public void setName(String name) { |
Stephen Hines | 84a97ca | 2011-03-15 21:05:54 -0700 | [diff] [blame] | 89 | if (name == null) { |
| 90 | throw new RSIllegalArgumentException( |
| 91 | "setName requires a string of non-zero length."); |
| 92 | } |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 93 | if(name.length() < 1) { |
Stephen Hines | 84a97ca | 2011-03-15 21:05:54 -0700 | [diff] [blame] | 94 | throw new RSIllegalArgumentException( |
| 95 | "setName does not accept a zero length string."); |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 96 | } |
| 97 | if(mName != null) { |
Stephen Hines | 84a97ca | 2011-03-15 21:05:54 -0700 | [diff] [blame] | 98 | throw new RSIllegalArgumentException( |
| 99 | "setName object already has a name."); |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 100 | } |
| 101 | |
| 102 | try { |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 103 | byte[] bytes = name.getBytes("UTF-8"); |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 104 | mRS.nAssignName(mID, bytes); |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 105 | mName = name; |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 106 | } catch (java.io.UnsupportedEncodingException e) { |
| 107 | throw new RuntimeException(e); |
| 108 | } |
| 109 | } |
| 110 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 111 | /** |
Alex Sakhartchouk | 0400b07 | 2011-07-26 14:13:32 -0700 | [diff] [blame] | 112 | * @return name of the renderscript object |
| 113 | */ |
| 114 | public String getName() { |
| 115 | return mName; |
| 116 | } |
| 117 | |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 118 | private void helpDestroy() { |
| 119 | boolean shouldDestroy = false; |
| 120 | synchronized(this) { |
| 121 | if (!mDestroyed) { |
| 122 | shouldDestroy = true; |
| 123 | mDestroyed = true; |
| 124 | } |
| 125 | } |
| 126 | |
| 127 | if (shouldDestroy) { |
Yang Ni | eb4dd08 | 2016-03-24 09:40:32 -0700 | [diff] [blame] | 128 | guard.close(); |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 129 | // must include nObjDestroy in the critical section |
| 130 | ReentrantReadWriteLock.ReadLock rlock = mRS.mRWLock.readLock(); |
| 131 | rlock.lock(); |
Tim Murray | 6d63c84 | 2014-02-12 11:16:17 -0800 | [diff] [blame] | 132 | // AllocationAdapters are BaseObjs with an ID of 0 but should not be passed to nObjDestroy |
| 133 | if(mRS.isAlive() && mID != 0) { |
Jason Sams | d78be37 | 2010-08-17 19:28:29 -0700 | [diff] [blame] | 134 | mRS.nObjDestroy(mID); |
Jason Sams | 730ee65 | 2009-08-18 17:07:09 -0700 | [diff] [blame] | 135 | } |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 136 | rlock.unlock(); |
Jason Sams | a9e7a05 | 2009-09-25 14:51:22 -0700 | [diff] [blame] | 137 | mRS = null; |
Jason Sams | 730ee65 | 2009-08-18 17:07:09 -0700 | [diff] [blame] | 138 | mID = 0; |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 139 | } |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 140 | } |
| 141 | |
| 142 | protected void finalize() throws Throwable { |
Yang Ni | eb4dd08 | 2016-03-24 09:40:32 -0700 | [diff] [blame] | 143 | try { |
| 144 | if (guard != null) { |
| 145 | guard.warnIfOpen(); |
| 146 | } |
| 147 | helpDestroy(); |
| 148 | } finally { |
| 149 | super.finalize(); |
| 150 | } |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 151 | } |
Jason Sams | 7ce033d | 2009-08-18 14:14:24 -0700 | [diff] [blame] | 152 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 153 | /** |
Tim Murray | c11e25c | 2013-04-09 11:01:01 -0700 | [diff] [blame] | 154 | * Frees any native resources associated with this object. The |
| 155 | * primary use is to force immediate cleanup of resources when it is |
| 156 | * believed the GC will not respond quickly enough. |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 157 | */ |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 158 | public void destroy() { |
Jason Sams | 7ce033d | 2009-08-18 14:14:24 -0700 | [diff] [blame] | 159 | if(mDestroyed) { |
Jason Sams | c1d6210 | 2010-11-04 14:32:19 -0700 | [diff] [blame] | 160 | throw new RSInvalidStateException("Object already destroyed."); |
Jason Sams | 7ce033d | 2009-08-18 14:14:24 -0700 | [diff] [blame] | 161 | } |
Tim Murray | 504abb3 | 2014-01-07 11:13:56 -0800 | [diff] [blame] | 162 | helpDestroy(); |
Jason Sams | 7ce033d | 2009-08-18 14:14:24 -0700 | [diff] [blame] | 163 | } |
| 164 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 165 | /** |
Jason Sams | 27676fe | 2010-11-10 17:00:59 -0800 | [diff] [blame] | 166 | * If an object came from an a3d file, java fields need to be |
| 167 | * created with objects from the native layer |
| 168 | */ |
Alex Sakhartchouk | 80a4c2c | 2010-07-12 15:50:32 -0700 | [diff] [blame] | 169 | void updateFromNative() { |
Jason Sams | 06d69de | 2010-11-09 17:11:40 -0800 | [diff] [blame] | 170 | mRS.validate(); |
Jason Sams | e07694b | 2012-04-03 15:36:36 -0700 | [diff] [blame] | 171 | mName = mRS.nGetName(getID(mRS)); |
Alex Sakhartchouk | 80a4c2c | 2010-07-12 15:50:32 -0700 | [diff] [blame] | 172 | } |
| 173 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 174 | /** |
Stephen Hines | 705d2ea | 2011-06-09 10:11:54 -0700 | [diff] [blame] | 175 | * Calculates the hash code value for a BaseObj. |
| 176 | * |
| 177 | * @return int |
| 178 | */ |
| 179 | @Override |
| 180 | public int hashCode() { |
Tim Murray | 7a629fa | 2013-11-19 12:45:54 -0800 | [diff] [blame] | 181 | return (int)((mID & 0xfffffff) ^ (mID >> 32)); |
Stephen Hines | 705d2ea | 2011-06-09 10:11:54 -0700 | [diff] [blame] | 182 | } |
| 183 | |
Stephen Hines | 9c9ad3f8c2 | 2012-05-07 15:34:29 -0700 | [diff] [blame] | 184 | /** |
Stephen Hines | 705d2ea | 2011-06-09 10:11:54 -0700 | [diff] [blame] | 185 | * Compare the current BaseObj with another BaseObj for equality. |
| 186 | * |
| 187 | * @param obj The object to check equality with. |
| 188 | * |
| 189 | * @return boolean |
| 190 | */ |
| 191 | @Override |
| 192 | public boolean equals(Object obj) { |
| 193 | // Early-out check to see if both BaseObjs are actually the same |
| 194 | if (this == obj) |
| 195 | return true; |
| 196 | |
Tim Murray | 78214c95 | 2014-02-28 16:57:47 -0800 | [diff] [blame] | 197 | if (obj == null) { |
| 198 | return false; |
| 199 | } |
| 200 | |
Stephen Hines | 705d2ea | 2011-06-09 10:11:54 -0700 | [diff] [blame] | 201 | if (getClass() != obj.getClass()) { |
| 202 | return false; |
| 203 | } |
| 204 | |
| 205 | BaseObj b = (BaseObj) obj; |
| 206 | return mID == b.mID; |
| 207 | } |
Jason Sams | 36e612a | 2009-07-31 16:26:13 -0700 | [diff] [blame] | 208 | } |
| 209 | |