Source code
Revision control
Copy as Markdown
Other Tools
/* -*- 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
#ifndef MOZILLA_LAYERS_COMPOSITORTYPES_H
#define MOZILLA_LAYERS_COMPOSITORTYPES_H
#include <iosfwd>
#include <stdint.h> // for uint32_t
#include <sys/types.h> // for int32_t
#include "LayersTypes.h" // for LayersBackend, etc
#include "nsXULAppAPI.h" // for GeckoProcessType, etc
#include "mozilla/gfx/Types.h"
#include "mozilla/layers/SyncObject.h"
#include "mozilla/EnumSet.h"
#include "mozilla/TypedEnumBits.h"
namespace mozilla {
namespace layers {
/**
* Flags used by texture clients and texture hosts. These are passed from client
* side to host side when textures and compositables are created. Usually set
* by the compositableCient, they may be modified by either the compositable or
* texture clients.
*/
enum class TextureFlags : uint32_t {
NO_FLAGS = 0,
// Use nearest-neighbour texture filtering (as opposed to linear filtering).
USE_NEAREST_FILTER = 1 << 0,
// The compositor assumes everything is origin-top-left by default.
ORIGIN_BOTTOM_LEFT = 1 << 1,
// Force the texture to be represented using a single tile (note that this
// means tiled textures, not tiled layers).
DISALLOW_BIGIMAGE = 1 << 2,
// The buffer will be treated as if the RB bytes are swapped.
// This is useful for rendering using Cairo/Thebes, because there is no
// BGRX Android pixel format, and so we have to do byte swapping.
//
// For example, if the GraphicBuffer has an Android pixel format of
// PIXEL_FORMAT_RGBA_8888 and isRBSwapped is true, when it is sampled
// (for example, with GL), a BGRA shader should be used.
RB_SWAPPED = 1 << 3,
// Data in this texture has not been alpha-premultiplied.
// XXX - Apparently only used with ImageClient/Host
NON_PREMULTIPLIED = 1 << 4,
// The TextureClient should be recycled with recycle callback when no longer
// in used. When the texture is used in host side, ref count of TextureClient
// is transparently added by ShadowLayerForwarder or ImageBridgeChild.
RECYCLE = 1 << 5,
// If DEALLOCATE_CLIENT is set, the shared data is deallocated on the
// client side and requires some extra synchronizaion to ensure race-free
// deallocation.
// The default behaviour is to deallocate on the host side.
DEALLOCATE_CLIENT = 1 << 6,
DEALLOCATE_SYNC = 1 << 6, // XXX - make it a separate flag.
// After being shared ith the compositor side, an immutable texture is never
// modified, it can only be read. It is safe to not Lock/Unlock immutable
// textures.
IMMUTABLE = 1 << 9,
// The contents of the texture must be uploaded or copied immediately
// during the transaction, because the producer may want to write
// to it again.
IMMEDIATE_UPLOAD = 1 << 10,
// The texture is part of a component-alpha pair
COMPONENT_ALPHA = 1 << 11,
// The texture is being allocated for a compositor that no longer exists.
// This flag is only used in the parent process.
INVALID_COMPOSITOR = 1 << 12,
// The texture was created by converting from YCBCR to RGB
RGB_FROM_YCBCR = 1 << 13,
// The texture is used for snapshot.
SNAPSHOT = 1 << 14,
// Enable a non blocking read lock.
NON_BLOCKING_READ_LOCK = 1 << 15,
// Enable a blocking read lock.
BLOCKING_READ_LOCK = 1 << 16,
// Keep TextureClient alive when host side is used
WAIT_HOST_USAGE_END = 1 << 17,
// The texture is guaranteed to have alpha 1.0 everywhere; some backends
// have trouble with RGBX/BGRX formats, so we use RGBA/BGRA but set this
// hint when we know alpha is opaque (eg. WebGL)
IS_OPAQUE = 1 << 18,
// The ExternalImageId bound to the texture is borrowed and should not be
// explicitly released when the texture is freed. This is meant to be used
// with WebRenderTextureHost wrapping another TextureHost which was
// initialized with its own external image ID.
BORROWED_EXTERNAL_ID = 1 << 19,
// The texture is used for remote texture.
REMOTE_TEXTURE = 1 << 20,
// The texture is from a DRM source.
DRM_SOURCE = 1 << 21,
// The texture is dummy texture
DUMMY_TEXTURE = 1 << 22,
// Software decoded video
SOFTWARE_DECODED_VIDEO = 1 << 23,
// Whether the remote texture must wait for its owner to be created.
WAIT_FOR_REMOTE_TEXTURE_OWNER = 1 << 24,
// OR union of all valid bits
ALL_BITS = (1 << 25) - 1,
// the default flags
DEFAULT = NO_FLAGS
};
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(TextureFlags)
std::ostream& operator<<(std::ostream& aStream, const TextureFlags& aFlags);
static inline bool TextureRequiresLocking(TextureFlags aFlags) {
// If we're not double buffered, or uploading
// within a transaction, then we need to support
// locking correctly.
return !(aFlags & TextureFlags::IMMUTABLE);
}
/**
* The type of debug diagnostic to enable.
*/
enum class DiagnosticTypes : uint8_t {
NO_DIAGNOSTIC = 0,
TILE_BORDERS = 1 << 0,
LAYER_BORDERS = 1 << 1,
BIGIMAGE_BORDERS = 1 << 2,
FLASH_BORDERS = 1 << 3,
ALL_BITS = (1 << 4) - 1
};
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(DiagnosticTypes)
/**
* See gfx/layers/Effects.h
*/
enum class EffectTypes : uint8_t {
RGB,
YCBCR,
NV12,
MAX // sentinel for the count of all effect types
};
/**
* How the Compositable should manage textures.
*/
enum class CompositableType : uint8_t {
UNKNOWN,
IMAGE, // image with single buffering
COUNT
};
enum class ImageUsageType : uint8_t {
UNKNOWN,
WebRenderImageData,
WebRenderFallbackData,
Canvas,
OffscreenCanvas,
VideoFrameContainer,
RemoteVideoDecoder,
BlackImage,
Webrtc,
WebCodecs,
COUNT
};
/**
* Sent from the compositor to the content-side LayerManager, includes
* properties of the compositor and should (in the future) include information
* about what kinds of buffer and texture clients to create.
*/
struct TextureFactoryIdentifier {
LayersBackend mParentBackend;
WebRenderBackend mWebRenderBackend;
WebRenderCompositor mWebRenderCompositor;
GeckoProcessType mParentProcessType;
int32_t mMaxTextureSize;
bool mCompositorUseANGLE;
bool mCompositorUseDComp;
bool mUseCompositorWnd;
bool mSupportsTextureBlitting;
bool mSupportsPartialUploads;
bool mSupportsComponentAlpha;
bool mSupportsD3D11NV12;
SyncHandle mSyncHandle;
explicit TextureFactoryIdentifier(
LayersBackend aLayersBackend = LayersBackend::LAYERS_NONE,
GeckoProcessType aParentProcessType = GeckoProcessType_Default,
int32_t aMaxTextureSize = 4096, bool aCompositorUseANGLE = false,
bool aCompositorUseDComp = false, bool aUseCompositorWnd = false,
bool aSupportsTextureBlitting = false,
bool aSupportsPartialUploads = false, bool aSupportsComponentAlpha = true,
bool aSupportsD3D11NV12 = false, SyncHandle aSyncHandle = {})
: mParentBackend(aLayersBackend),
mWebRenderBackend(WebRenderBackend::HARDWARE),
mWebRenderCompositor(WebRenderCompositor::DRAW),
mParentProcessType(aParentProcessType),
mMaxTextureSize(aMaxTextureSize),
mCompositorUseANGLE(aCompositorUseANGLE),
mCompositorUseDComp(aCompositorUseDComp),
mUseCompositorWnd(aUseCompositorWnd),
mSupportsTextureBlitting(aSupportsTextureBlitting),
mSupportsPartialUploads(aSupportsPartialUploads),
mSupportsComponentAlpha(aSupportsComponentAlpha),
mSupportsD3D11NV12(aSupportsD3D11NV12),
mSyncHandle(aSyncHandle) {}
explicit TextureFactoryIdentifier(
WebRenderBackend aWebRenderBackend,
WebRenderCompositor aWebRenderCompositor,
GeckoProcessType aParentProcessType = GeckoProcessType_Default,
int32_t aMaxTextureSize = 4096, bool aCompositorUseANGLE = false,
bool aCompositorUseDComp = false, bool aUseCompositorWnd = false,
bool aSupportsTextureBlitting = false,
bool aSupportsPartialUploads = false, bool aSupportsComponentAlpha = true,
bool aSupportsD3D11NV12 = false, SyncHandle aSyncHandle = {})
: mParentBackend(LayersBackend::LAYERS_WR),
mWebRenderBackend(aWebRenderBackend),
mWebRenderCompositor(aWebRenderCompositor),
mParentProcessType(aParentProcessType),
mMaxTextureSize(aMaxTextureSize),
mCompositorUseANGLE(aCompositorUseANGLE),
mCompositorUseDComp(aCompositorUseDComp),
mUseCompositorWnd(aUseCompositorWnd),
mSupportsTextureBlitting(aSupportsTextureBlitting),
mSupportsPartialUploads(aSupportsPartialUploads),
mSupportsComponentAlpha(aSupportsComponentAlpha),
mSupportsD3D11NV12(aSupportsD3D11NV12),
mSyncHandle(aSyncHandle) {}
};
/**
* Information required by the compositor from the content-side for creating or
* using compositables and textures.
* XXX - TextureInfo is a bad name: this information is useful for the
* compositable, not the Texture. And ith new Textures, only the compositable
* type is really useful. This may (should) be removed in the near future.
*/
struct TextureInfo {
CompositableType mCompositableType;
ImageUsageType mUsageType;
TextureFlags mTextureFlags;
TextureInfo()
: mCompositableType(CompositableType::UNKNOWN),
mUsageType(ImageUsageType::UNKNOWN),
mTextureFlags(TextureFlags::NO_FLAGS) {}
TextureInfo(CompositableType aType, ImageUsageType aUsageType,
TextureFlags aTextureFlags)
: mCompositableType(aType),
mUsageType(aUsageType),
mTextureFlags(aTextureFlags) {}
bool operator==(const TextureInfo& aOther) const {
return mCompositableType == aOther.mCompositableType &&
mTextureFlags == aOther.mTextureFlags;
}
};
/**
* How a SurfaceDescriptor will be opened.
*
* See ShadowLayerForwarder::OpenDescriptor for example.
*/
enum class OpenMode : uint8_t {
OPEN_NONE = 0,
OPEN_READ = 0x1,
OPEN_WRITE = 0x2,
// This is only used in conjunction with OMTP to indicate that the DrawTarget
// that is being borrowed will be painted asynchronously, and so will outlive
// the write lock.
OPEN_ASYNC = 0x04,
OPEN_READ_WRITE = OPEN_READ | OPEN_WRITE,
OPEN_READ_WRITE_ASYNC = OPEN_READ | OPEN_WRITE | OPEN_ASYNC,
OPEN_READ_ASYNC = OPEN_READ | OPEN_ASYNC,
OPEN_READ_ONLY = OPEN_READ,
OPEN_WRITE_ONLY = OPEN_WRITE,
};
MOZ_MAKE_ENUM_CLASS_BITWISE_OPERATORS(OpenMode)
// The kinds of mask texture a shader can support
// We rely on the items in this enum being sequential
enum class MaskType : uint8_t {
MaskNone = 0, // no mask layer
Mask, // mask layer
NumMaskTypes
};
} // namespace layers
} // namespace mozilla
#endif