mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-19 16:25:38 +00:00
839048be74
Please contact Bas Schouten <bschouten@mozilla.com>, Nicolas Silva <nsilva@mozilla.com> or Nicholas Cameron <ncameron@mozilla.com> with general questions. Below is a rough list of authors to contact with specific questions. Authors: gfx/layers/Compositor.* gfx/layers/Effects.h - Compositor Interface - bas,nrc,nical gfx/layers/d3d* - D3D9/D3D10 - bas gfx/layers/ThebesLayer* - ThebesLayers - nrc,bas gfx/layers/composite/* - CompositeLayers - nrc,nical gfx/layers/client/* - Client - nrc,nical,bas gfx/layers/*Image* - nical gfx/layers/ipc ipc - IPC - nical gfx/layers/opengl - CompositorOGL - nrc,nical gfx/2d - bas,nrc gfx/gl - GLContext - bjacob dom/* layout/* - DOM - mattwoodrow
129 lines
4.4 KiB
C++
129 lines
4.4 KiB
C++
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#ifndef MOZILLA_LAYERS_COMPOSITABLEFORWARDER
|
|
#define MOZILLA_LAYERS_COMPOSITABLEFORWARDER
|
|
|
|
#include "mozilla/StandardInteger.h"
|
|
#include "gfxASurface.h"
|
|
#include "GLDefs.h"
|
|
#include "mozilla/layers/ISurfaceAllocator.h"
|
|
|
|
namespace mozilla {
|
|
namespace layers {
|
|
|
|
class CompositableClient;
|
|
class TextureFactoryIdentifier;
|
|
class SurfaceDescriptor;
|
|
class ThebesBufferData;
|
|
class TextureClient;
|
|
|
|
/**
|
|
* A transaction is a set of changes that happenned on the content side, that
|
|
* should be sent to the compositor side.
|
|
* CompositableForwarder is an interface to manage a transaction of
|
|
* compositable objetcs.
|
|
*
|
|
* ShadowLayerForwarder is an example of a CompositableForwarder (that can
|
|
* additionally forward modifications of the Layer tree).
|
|
* ImageBridgeChild is another CompositableForwarder.
|
|
*/
|
|
class CompositableForwarder : public ISurfaceAllocator
|
|
{
|
|
friend class AutoOpenSurface;
|
|
friend class TextureClientShmem;
|
|
public:
|
|
CompositableForwarder()
|
|
: mMaxTextureSize(0), mCompositorBackend(layers::LAYERS_NONE)
|
|
{}
|
|
|
|
/**
|
|
* Setup the IPDL actor for aCompositable to be part of layers
|
|
* transactions.
|
|
*/
|
|
virtual void Connect(CompositableClient* aCompositable) = 0;
|
|
|
|
/**
|
|
* When using the Thebes layer pattern of swapping or updating
|
|
* TextureClient/Host pairs without sending SurfaceDescriptors,
|
|
* use these messages to assign the single or double buffer
|
|
* (TextureClient/Host pairs) to the CompositableHost.
|
|
* We expect the textures to already have been created.
|
|
* With these messages, the ownership of the SurfaceDescriptor(s)
|
|
* moves to the compositor.
|
|
*/
|
|
virtual void CreatedSingleBuffer(CompositableClient* aCompositable,
|
|
TextureClient* aBuffer) = 0;
|
|
virtual void CreatedDoubleBuffer(CompositableClient* aCompositable,
|
|
TextureClient* aFront,
|
|
TextureClient* aBack) = 0;
|
|
|
|
/**
|
|
* Tell the compositor that a Compositable is killing its buffer(s),
|
|
* that is TextureClient/Hosts.
|
|
*/
|
|
virtual void DestroyThebesBuffer(CompositableClient* aCompositable) = 0;
|
|
|
|
/**
|
|
* Communicate to the compositor that the texture identified by aLayer
|
|
* and aIdentifier has been updated to aImage.
|
|
*/
|
|
virtual void UpdateTexture(TextureClient* aTexture,
|
|
const SurfaceDescriptor& aImage) = 0;
|
|
|
|
/**
|
|
* Communicate to the compositor that aRegion in the texture identified by aLayer
|
|
* and aIdentifier has been updated to aThebesBuffer.
|
|
*/
|
|
virtual void UpdateTextureRegion(CompositableClient* aCompositable,
|
|
const ThebesBufferData& aThebesBufferData,
|
|
const nsIntRegion& aUpdatedRegion) = 0;
|
|
|
|
/**
|
|
* Communicate the picture rect of a YUV image in aLayer to the compositor
|
|
*/
|
|
virtual void UpdatePictureRect(CompositableClient* aCompositable,
|
|
const nsIntRect& aRect) = 0;
|
|
|
|
/**
|
|
* The specified layer is destroying its buffers.
|
|
* |aBackBufferToDestroy| is deallocated when this transaction is
|
|
* posted to the parent. During the parent-side transaction, the
|
|
* shadow is told to destroy its front buffer. This can happen when
|
|
* a new front/back buffer pair have been created because of a layer
|
|
* resize, e.g.
|
|
*/
|
|
virtual void DestroyedThebesBuffer(const SurfaceDescriptor& aBackBufferToDestroy) = 0;
|
|
|
|
void IdentifyTextureHost(const TextureFactoryIdentifier& aIdentifier);
|
|
|
|
/**
|
|
* Returns the maximum texture size supported by the compositor.
|
|
*/
|
|
virtual int32_t GetMaxTextureSize() const { return mMaxTextureSize; }
|
|
|
|
bool IsOnCompositorSide() const MOZ_OVERRIDE { return false; }
|
|
|
|
/**
|
|
* Returns the type of backend that is used off the main thread.
|
|
* We only don't allow changing the backend type at runtime so this value can
|
|
* be queried once and will not change until Gecko is restarted.
|
|
*/
|
|
LayersBackend GetCompositorBackendType() const
|
|
{
|
|
return mCompositorBackend;
|
|
}
|
|
|
|
protected:
|
|
uint32_t mMaxTextureSize;
|
|
LayersBackend mCompositorBackend;
|
|
};
|
|
|
|
} // namespace
|
|
} // namespace
|
|
|
|
#endif
|