diff options
| author | scherkus@chromium.org <scherkus@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> | 2008-12-01 21:51:40 +0000 |
|---|---|---|
| committer | scherkus@chromium.org <scherkus@chromium.org@0039d316-1c4b-4281-b951-d872f2087c98> | 2008-12-01 21:51:40 +0000 |
| commit | a70e6de55fc1739b76bab19f3b93aad682029c71 (patch) | |
| tree | 12db84a219b70ff30bcb261186516acd8ff636f2 /media/base/buffers.h | |
| parent | 3220b7b92a7f2d0c0e5b3693be9beea68de70312 (diff) | |
| download | chromium_src-a70e6de55fc1739b76bab19f3b93aad682029c71.zip chromium_src-a70e6de55fc1739b76bab19f3b93aad682029c71.tar.gz chromium_src-a70e6de55fc1739b76bab19f3b93aad682029c71.tar.bz2 | |
Checking in media common header file and buffer pure interfaces.
R=cpu,darin
Review URL: http://codereview.chromium.org/12701
git-svn-id: svn://svn.chromium.org/chrome/trunk/src@6167 0039d316-1c4b-4281-b951-d872f2087c98
Diffstat (limited to 'media/base/buffers.h')
| -rw-r--r-- | media/base/buffers.h | 152 |
1 files changed, 152 insertions, 0 deletions
diff --git a/media/base/buffers.h b/media/base/buffers.h new file mode 100644 index 0000000..2968791 --- /dev/null +++ b/media/base/buffers.h @@ -0,0 +1,152 @@ +// Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file.
+
+#ifndef MEDIA_BASE_BUFFERS_H_
+#define MEDIA_BASE_BUFFERS_H_
+
+#include "base/basictypes.h"
+#include "base/ref_counted.h"
+
+namespace media {
+
+// NOTE: this isn't a true interface since RefCountedThreadSafe has non-virtual
+// members, therefore implementors should NOT subclass RefCountedThreadSafe.
+//
+// If you do, AddRef/Release will have different outcomes depending on the
+// current type of the pointer (StreamSampleInterface vs. SomeImplementation).
+class StreamSampleInterface :
+ public base::RefCountedThreadSafe<StreamSampleInterface> {
+ public:
+ virtual ~StreamSampleInterface() {}
+
+ virtual int64 GetTimestamp() = 0;
+ virtual int64 GetDuration() = 0;
+ virtual void SetTimestamp(int64 timestamp) = 0;
+ virtual void SetDuration(int64 duration) = 0;
+};
+
+
+class BufferInterface : public StreamSampleInterface {
+ public:
+ virtual ~BufferInterface() {}
+
+ // Returns a read only pointer to the buffer data.
+ virtual const char* GetData() = 0;
+
+ // Returns the size of valid data in bytes.
+ virtual size_t GetDataSize() = 0;
+};
+
+
+class WritableBufferInterface : public BufferInterface {
+ public:
+ virtual ~WritableBufferInterface() {}
+
+ // Returns a read-write pointer to the buffer data.
+ virtual char* GetWritableData() = 0;
+
+ // Updates the size of valid data in bytes, which must be less than or equal
+ // to GetBufferSize.
+ virtual void SetDataSize(size_t data_size) = 0;
+
+ // Returns the maximum allocated size for this buffer.
+ virtual size_t GetBufferSize() = 0;
+};
+
+
+struct VideoSurface {
+ static const size_t kMaxPlanes = 3;
+
+ // Surface formats roughly based on FOURCC labels, see:
+ // http://www.fourcc.org/rgb.php
+ // http://www.fourcc.org/yuv.php
+ enum Format {
+ RGB555, // 16bpp RGB packed 5:5:5
+ RGB565, // 16bpp RGB packed 5:6:5
+ RGB24, // 24bpp RGB packed 8:8:8
+ RGB32, // 32bpp RGB packed with extra byte 8:8:8
+ RGBA, // 32bpp RGBA packed 8:8:8:8
+ YV12, // 12bpp YVU planar 1x1 Y, 2x2 VU samples
+ YV16, // 16bpp YVU planar 1x1 Y, 2x1 VU samples
+ };
+
+ // Surface format.
+ Format format;
+
+ // Width and height of surface.
+ size_t width;
+ size_t height;
+
+ // Number of planes, typically 1 for packed RGB formats and 3 for planar
+ // YUV formats.
+ size_t planes;
+
+ // Array of strides for each plane, typically greater or equal to the width
+ // of the surface divided by the horizontal sampling period.
+ size_t strides[kMaxPlanes];
+
+ // Array of data pointers to each plane.
+ char* data[kMaxPlanes];
+};
+
+
+class VideoFrameInterface : public StreamSampleInterface {
+ public:
+ virtual ~VideoFrameInterface() {}
+
+ // Locks the underlying surface and fills out the given VideoSurface and
+ // returns true if successful, false otherwise.
+ virtual bool Lock(VideoSurface* surface) = 0;
+
+ // Unlocks the underlying surface, any previous VideoSurfaces are no longer
+ // guaranteed to be valid.
+ virtual void Unlock() = 0;
+};
+
+
+template <class BufferType>
+class AssignableInterface {
+ public:
+ virtual ~AssignableInterface() {}
+
+ // Assigns a buffer to the owner.
+ virtual void SetBuffer(BufferType* buffer) = 0;
+
+ // Notifies the owner that an assignment has been completed.
+ virtual void OnAssignment() = 0;
+};
+
+
+// Template for easily creating AssignableInterface buffers. Pass in the
+// pointer of the object to receive the OnAssignment callback.
+template <class OwnerType, class BufferType>
+class AssignableBuffer : public AssignableInterface<BufferType>,
+ public base::RefCountedThreadSafe<AssignableBuffer<OwnerType, BufferType>> {
+ public:
+ explicit AssignableBuffer(OwnerType* owner)
+ : owner_(owner),
+ buffer_(NULL) {
+ DCHECK(owner_);
+ }
+ virtual ~AssignableBuffer() {}
+
+ // AssignableBufferInterface<BufferType>
+ virtual void SetBuffer(BufferType* buffer) {
+ buffer_ = buffer;
+ }
+
+ virtual void OnAssignment() {
+ owner_->OnAssignment(buffer_.get());
+ }
+
+ private:
+ OwnerType* owner_;
+ scoped_refptr<BufferType> buffer_;
+
+ DISALLOW_COPY_AND_ASSIGN(AssignableBuffer);
+};
+
+} // namespace media
+
+#endif // MEDIA_BASE_BUFFERS_H_
|