MediaBuffer.h revision 6a9da9fc558263548ebfbae2cbf177eb7454a41b
120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber/* 220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Copyright (C) 2009 The Android Open Source Project 320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Licensed under the Apache License, Version 2.0 (the "License"); 520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * you may not use this file except in compliance with the License. 620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * You may obtain a copy of the License at 720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * http://www.apache.org/licenses/LICENSE-2.0 920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * 1020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * Unless required by applicable law or agreed to in writing, software 1120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * distributed under the License is distributed on an "AS IS" BASIS, 1220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * See the License for the specific language governing permissions and 1420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber * limitations under the License. 1520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber */ 1620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 1720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#ifndef MEDIA_BUFFER_H_ 1820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 1920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#define MEDIA_BUFFER_H_ 2020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 2120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <pthread.h> 2220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 2320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/Errors.h> 2420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#include <utils/RefBase.h> 2520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 2620111aa043c5f404472bc63b90bc5aad906b1101Andreas Hubernamespace android { 2720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 286a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennisclass GraphicBuffer; 2920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass MediaBuffer; 3020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass MediaBufferObserver; 3120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass MetaData; 3220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 3320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass MediaBufferObserver { 3420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberpublic: 3520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBufferObserver() {} 3620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber virtual ~MediaBufferObserver() {} 3720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 3820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber virtual void signalBufferReturned(MediaBuffer *buffer) = 0; 3920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 4020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberprivate: 4120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBufferObserver(const MediaBufferObserver &); 4220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBufferObserver &operator=(const MediaBufferObserver &); 4320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber}; 4420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 4520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberclass MediaBuffer { 4620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberpublic: 4720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // The underlying data remains the responsibility of the caller! 4820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer(void *data, size_t size); 4920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 5020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer(size_t size); 5120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 526a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennis MediaBuffer(const sp<GraphicBuffer>& graphicBuffer); 536a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennis 5420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // Decrements the reference count and returns the buffer to its 5520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // associated MediaBufferGroup if the reference count drops to 0. 5620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void release(); 5720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 5820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // Increments the reference count. 5920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void add_ref(); 6020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 6120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void *data() const; 6220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber size_t size() const; 6320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 6420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber size_t range_offset() const; 6520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber size_t range_length() const; 6620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 6720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void set_range(size_t offset, size_t length); 6820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 696a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennis sp<GraphicBuffer> graphicBuffer() const; 706a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennis 7120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber sp<MetaData> meta_data(); 7220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 7320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // Clears meta data and resets the range to the full extent. 7420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void reset(); 7520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 7620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void setObserver(MediaBufferObserver *group); 7720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 7820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // Returns a clone of this MediaBuffer increasing its reference count. 7920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // The clone references the same data but has its own range and 8020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // MetaData. 8120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer *clone(); 8220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 83693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber int refcount() const; 84693d271e62a3726689ff68f4505ba49228eb94b2Andreas Huber 8520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberprotected: 8620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber virtual ~MediaBuffer(); 8720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 8820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huberprivate: 8920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber friend class MediaBufferGroup; 9020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber friend class OMXDecoder; 9120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 9220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // For use by OMXDecoder, reference count must be 1, drop reference 9320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber // count to 0 without signalling the observer. 9420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void claim(); 9520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 9620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBufferObserver *mObserver; 9720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer *mNextBuffer; 9820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber int mRefCount; 9920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 10020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void *mData; 10120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber size_t mSize, mRangeOffset, mRangeLength; 1026a9da9fc558263548ebfbae2cbf177eb7454a41bJamie Gennis sp<GraphicBuffer> mGraphicBuffer; 10320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 10420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber bool mOwnsData; 10520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 10620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber sp<MetaData> mMetaData; 10720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 10820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer *mOriginal; 10920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 11020111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber void setNextBuffer(MediaBuffer *buffer); 11120111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer *nextBuffer(); 11220111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 11320111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer(const MediaBuffer &); 11420111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber MediaBuffer &operator=(const MediaBuffer &); 11520111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber}; 11620111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 11720111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber} // namespace android 11820111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber 11920111aa043c5f404472bc63b90bc5aad906b1101Andreas Huber#endif // MEDIA_BUFFER_H_ 120