rsObjectBase.h revision 48ecf6a5e85a9a832f41393ed2802385bb8b5db8
1326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams/* 2326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * Copyright (C) 2009 The Android Open Source Project 3326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * 4326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * Licensed under the Apache License, Version 2.0 (the "License"); 5326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * you may not use this file except in compliance with the License. 6326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * You may obtain a copy of the License at 7326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * 8326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * http://www.apache.org/licenses/LICENSE-2.0 9326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * 10326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * Unless required by applicable law or agreed to in writing, software 11326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * distributed under the License is distributed on an "AS IS" BASIS, 12326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * See the License for the specific language governing permissions and 14326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams * limitations under the License. 15326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams */ 16326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 17326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams#ifndef ANDROID_RS_OBJECT_BASE_H 18326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams#define ANDROID_RS_OBJECT_BASE_H 19326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 20326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams#include "rsUtils.h" 21e23d239828a229eb7d4d33c9630070f0a87833e1Alex Sakhartchouk#include "rsDefines.h" 22d216dafa216f3329577ab624cdc5a5d1860ec035Stephen Hines#include "rsDebugHelper.h" 23326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 24326e0ddf89e8df2837752fbfd7a014814b32082cJason Samsnamespace android { 25326e0ddf89e8df2837752fbfd7a014814b32082cJason Samsnamespace renderscript { 26326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 27e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Samsclass Context; 28fb6b614bcea88a587a7ea4530be45ff0ffa0210eAlex Sakhartchoukclass OStream; 29e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams 30326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams// An element is a group of Components that occupies one cell in a structure. 31afb743aca56c18beb7ab924e75cb6e070ef3e55aAlex Sakhartchoukclass ObjectBase { 32326e0ddf89e8df2837752fbfd7a014814b32082cJason Samspublic: 33e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams ObjectBase(Context *rsc); 34326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 359397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams void incSysRef() const; 36e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams bool decSysRef() const; 379397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams 389397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams void incUserRef() const; 39e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams bool decUserRef() const; 40e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams bool zeroUserRef() const; 41225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams 42225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams static bool checkDelete(const ObjectBase *); 43326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 44a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams const char * getName() const { 45b0934b67b95cc27e2358c2aa4db5f7c1067c8f9bStephen Hines return mName; 46a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams } 4748ecf6a5e85a9a832f41393ed2802385bb8b5db8Jason Sams void assignName(const char *s) {mName = s;} 48a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams void setName(const char *); 49a4a54e42fc710a62b47cbcb9d64c34a190429d9eJason Sams void setName(const char *, uint32_t len); 50a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams 51e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams Context * getContext() const {return mRSC;} 52c7cec1e3577cc77a5a73d5bd5a82733b1b9936a1Jason Sams virtual bool freeChildren(); 53e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams 54e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams static void zeroAllUserRef(Context *rsc); 55c7cec1e3577cc77a5a73d5bd5a82733b1b9936a1Jason Sams static void freeAllChildren(Context *rsc); 56c21cf40f6ae69091bf24f87b5eeabc95e73dd271Jason Sams static void dumpAll(Context *rsc); 57e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams 58e12c1c591b4219e80f29c6c0e0c62c9578b75450Jason Sams virtual void dumpLOGV(const char *prefix) const; 59e3150cfb3edb028407669e4a65e087eae77e718cJason Sams virtual void serialize(Context *rsc, OStream *stream) const = 0; 60b825f67adb5d1e1751fe108e6dbf9c6f2555c283Alex Sakhartchouk virtual RsA3DClassID getClassId() const = 0; 61f2649a961db2995e9e24a6c98f8a419f1496c1b7Jason Sams 62605048a9f9af925782f6c90bc1cdc5af59e337d8Jason Sams static bool isValid(const Context *rsc, const ObjectBase *obj); 63605048a9f9af925782f6c90bc1cdc5af59e337d8Jason Sams 64225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams // The async lock is taken during object creation in non-rs threads 65225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams // and object deletion in the rs thread. 66225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams static void asyncLock(); 67225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams static void asyncUnlock(); 682353ae303868d04e3a26002b2f2dc456c15e8170Jason Sams 69f2649a961db2995e9e24a6c98f8a419f1496c1b7Jason Samsprotected: 70225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams // Called inside the async lock for any object list management that is 71225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams // necessary in derived classes. 72225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams virtual void preDestroy() const; 73225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams 748154954868694e1f233d87d4933a474518b1cb81Jason Sams Context *mRSC; 75225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams virtual ~ObjectBase(); 76f2649a961db2995e9e24a6c98f8a419f1496c1b7Jason Sams 77326e0ddf89e8df2837752fbfd7a014814b32082cJason Samsprivate: 782353ae303868d04e3a26002b2f2dc456c15e8170Jason Sams static pthread_mutex_t gObjectInitMutex; 792353ae303868d04e3a26002b2f2dc456c15e8170Jason Sams 80e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams void add() const; 81e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams void remove() const; 82e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams 83b0934b67b95cc27e2358c2aa4db5f7c1067c8f9bStephen Hines const char* mName; 849397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams mutable int32_t mSysRefCount; 859397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams mutable int32_t mUserRefCount; 86326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 87e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams mutable const ObjectBase * mPrev; 88e514b45de8561fbc6ef6770845102ca10b0a69d7Jason Sams mutable const ObjectBase * mNext; 89225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams 90d216dafa216f3329577ab624cdc5a5d1860ec035Stephen Hines DebugHelper *mDH; 91326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams}; 92326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 939397e30ce5fe3f6af9212a93b490836b04fdfffaJason Samstemplate<class T> 94afb743aca56c18beb7ab924e75cb6e070ef3e55aAlex Sakhartchoukclass ObjectBaseRef { 95326e0ddf89e8df2837752fbfd7a014814b32082cJason Samspublic: 96326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams ObjectBaseRef() { 97326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams mRef = NULL; 98326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 99326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 1001030893d9b99b72468034da13df025bda479bb97Jason Sams ObjectBaseRef(const ObjectBaseRef &ref) { 1011030893d9b99b72468034da13df025bda479bb97Jason Sams mRef = ref.get(); 102a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams if (mRef) { 1039397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams mRef->incSysRef(); 104a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams } 1051030893d9b99b72468034da13df025bda479bb97Jason Sams } 1061030893d9b99b72468034da13df025bda479bb97Jason Sams 1071030893d9b99b72468034da13df025bda479bb97Jason Sams ObjectBaseRef(T *ref) { 1081030893d9b99b72468034da13df025bda479bb97Jason Sams mRef = ref; 109a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams if (mRef) { 1109397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams ref->incSysRef(); 111a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams } 1121030893d9b99b72468034da13df025bda479bb97Jason Sams } 1131030893d9b99b72468034da13df025bda479bb97Jason Sams 114225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams ObjectBaseRef & operator= (const ObjectBaseRef &ref) { 115c700e649ca44d0dcff8b271e42d949ea72fe3c63Alex Sakhartchouk if (&ref != this) { 116c700e649ca44d0dcff8b271e42d949ea72fe3c63Alex Sakhartchouk set(ref); 117c700e649ca44d0dcff8b271e42d949ea72fe3c63Alex Sakhartchouk } 118c700e649ca44d0dcff8b271e42d949ea72fe3c63Alex Sakhartchouk return *this; 119225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams } 120225afd317e101a7be5fe02c0a86361146ea89f05Jason Sams 121326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams ~ObjectBaseRef() { 122326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams clear(); 123326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 124326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 125326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams void set(T *ref) { 126326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams if (mRef != ref) { 127326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams clear(); 128326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams mRef = ref; 129a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams if (mRef) { 1309397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams ref->incSysRef(); 131a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams } 132326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 133326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 134326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 135a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams void set(const ObjectBaseRef &ref) { 136a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams set(ref.mRef); 137a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams } 138a0a1b6fbece2eb8d72d788422ab3e5f58d5a9216Jason Sams 139326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams void clear() { 140326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams if (mRef) { 1419397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams mRef->decSysRef(); 142326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 143326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams mRef = NULL; 144326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 145326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 146326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams inline T * get() const { 147326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams return mRef; 148326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 149326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 1509397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams inline T * operator-> () const { 1519397e30ce5fe3f6af9212a93b490836b04fdfffaJason Sams return mRef; 152326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams } 153326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 154326e0ddf89e8df2837752fbfd7a014814b32082cJason Samsprotected: 155326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams T * mRef; 156326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams}; 157326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 158326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams} 159326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams} 160326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 161326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams#endif //ANDROID_RS_OBJECT_BASE_H 162326e0ddf89e8df2837752fbfd7a014814b32082cJason Sams 163