123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167 |
- // Copyright 2018 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_GPU_COMMAND_BUFFER_HELPER_H_
- #define MEDIA_GPU_COMMAND_BUFFER_HELPER_H_
- #include "base/callback_forward.h"
- #include "base/memory/ref_counted_delete_on_sequence.h"
- #include "base/memory/scoped_refptr.h"
- #include "base/task/sequenced_task_runner.h"
- #include "base/task/sequenced_task_runner_helpers.h"
- #include "build/build_config.h"
- #include "gpu/command_buffer/common/mailbox.h"
- #include "gpu/command_buffer/common/sync_token.h"
- #include "media/gpu/media_gpu_export.h"
- #include "ui/gl/gl_bindings.h"
- namespace gpu {
- class CommandBufferStub;
- class DXGISharedHandleManager;
- class SharedImageBacking;
- class SharedImageRepresentationFactoryRef;
- class SharedImageStub;
- class TextureBase;
- } // namespace gpu
- namespace gl {
- class GLContext;
- class GLImage;
- } // namespace gl
- namespace media {
- // TODO(sandersd): CommandBufferHelper does not inherently need to be ref
- // counted, but some clients want that (VdaVideoDecoder and PictureBufferManager
- // both hold a ref to the same CommandBufferHelper). Consider making an owned
- // variant.
- class MEDIA_GPU_EXPORT CommandBufferHelper
- : public base::RefCountedDeleteOnSequence<CommandBufferHelper> {
- public:
- REQUIRE_ADOPTION_FOR_REFCOUNTED_TYPE();
- using WillDestroyStubCB = base::OnceCallback<void(bool have_context)>;
- // TODO(sandersd): Consider adding an Initialize(stub) method so that
- // CommandBufferHelpers can be created before a stub is available.
- static scoped_refptr<CommandBufferHelper> Create(
- gpu::CommandBufferStub* stub);
- CommandBufferHelper(const CommandBufferHelper&) = delete;
- CommandBufferHelper& operator=(const CommandBufferHelper&) = delete;
- // Gets the associated GLContext.
- //
- // Used by DXVAVDA to test for D3D11 support, and by V4L2VDA to create
- // EGLImages. New clients should use more specialized accessors instead.
- virtual gl::GLContext* GetGLContext() = 0;
- // Retrieve the interface through which to create shared images.
- virtual gpu::SharedImageStub* GetSharedImageStub() = 0;
- #if BUILDFLAG(IS_WIN)
- virtual gpu::DXGISharedHandleManager* GetDXGISharedHandleManager() = 0;
- #endif
- // Checks whether the stub has been destroyed.
- virtual bool HasStub() = 0;
- // Makes the GL context current.
- virtual bool MakeContextCurrent() = 0;
- // Register a shared image backing
- virtual std::unique_ptr<gpu::SharedImageRepresentationFactoryRef> Register(
- std::unique_ptr<gpu::SharedImageBacking> backing) = 0;
- virtual gpu::TextureBase* GetTexture(GLuint service_id) const = 0;
- // Creates a texture and returns its |service_id|.
- //
- // See glTexImage2D() for argument definitions.
- //
- // The texture will be configured as a video frame: linear filtering, clamp to
- // edge. If |target| is GL_TEXTURE_2D, storage will be allocated but not
- // initialized.
- //
- // It is up to the caller to initialize the texture before providing it to the
- // renderer, else the results are undefined.
- //
- // The context must be current.
- //
- // TODO(sandersd): Is really necessary to allocate storage? GpuVideoDecoder
- // does this, but it's not clear that any clients require it.
- virtual GLuint CreateTexture(GLenum target,
- GLenum internal_format,
- GLsizei width,
- GLsizei height,
- GLenum format,
- GLenum type) = 0;
- // Destroys a texture.
- //
- // The context must be current.
- virtual void DestroyTexture(GLuint service_id) = 0;
- // Sets the cleared flag on level 0 of the texture.
- virtual void SetCleared(GLuint service_id) = 0;
- // Binds level 0 of the texture to an image.
- //
- // If the sampler binding already exists, set |client_managed| to true.
- // Otherwise set it to false, and BindTexImage()/CopyTexImage() will be called
- // when the texture is used.
- virtual bool BindImage(GLuint service_id,
- gl::GLImage* image,
- bool client_managed) = 0;
- // Creates a mailbox for a texture.
- //
- // TODO(sandersd): Specify the behavior when the stub has been destroyed. The
- // current implementation returns an empty (zero) mailbox. One solution would
- // be to add a HasStub() method, and not define behavior when it is false.
- virtual gpu::Mailbox CreateMailbox(GLuint service_id) = 0;
- // Produce a texture into a mailbox. The context does not have to be current.
- // However, this will fail if the stub has been destroyed.
- virtual void ProduceTexture(const gpu::Mailbox& mailbox,
- GLuint service_id) = 0;
- // Waits for a SyncToken, then runs |done_cb|.
- //
- // |done_cb| may be destructed without running if the stub is destroyed.
- //
- // TODO(sandersd): Currently it is possible to lose the stub while
- // PictureBufferManager is waiting for all picture buffers, which results in a
- // decoding softlock. Notification of wait failure (or just context/stub lost)
- // is probably necessary.
- virtual void WaitForSyncToken(gpu::SyncToken sync_token,
- base::OnceClosure done_cb) = 0;
- // Set the callback to be called when our stub is destroyed. This callback
- // may not change the current context.
- virtual void SetWillDestroyStubCB(WillDestroyStubCB will_destroy_stub_cb) = 0;
- // Is the backing command buffer passthrough (versus validating).
- virtual bool IsPassthrough() const = 0;
- // Does this command buffer support ARB_texture_rectangle.
- virtual bool SupportsTextureRectangle() const = 0;
- protected:
- explicit CommandBufferHelper(
- scoped_refptr<base::SequencedTaskRunner> task_runner);
- // TODO(sandersd): Deleting remaining textures upon destruction requires
- // making the context current, which may be undesireable. Consider adding an
- // explicit DestroyWithContext() API.
- virtual ~CommandBufferHelper() = default;
- private:
- friend class base::DeleteHelper<CommandBufferHelper>;
- friend class base::RefCountedDeleteOnSequence<CommandBufferHelper>;
- };
- } // namespace media
- #endif // MEDIA_GPU_COMMAND_BUFFER_HELPER_H_
|