зеркало из https://github.com/mozilla/gecko-dev.git
934 строки
30 KiB
C++
934 строки
30 KiB
C++
/* -*- Mode: C++; tab-width: 20; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
* 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 GFX_PLATFORM_H
|
|
#define GFX_PLATFORM_H
|
|
|
|
#include "mozilla/FontPropertyTypes.h"
|
|
#include "mozilla/Logging.h"
|
|
#include "mozilla/gfx/Types.h"
|
|
#include "nsTArray.h"
|
|
#include "nsString.h"
|
|
#include "nsCOMPtr.h"
|
|
#include "nsUnicodeScriptCodes.h"
|
|
|
|
#include "gfxTypes.h"
|
|
#include "gfxFontFamilyList.h"
|
|
#include "gfxBlur.h"
|
|
#include "gfxSkipChars.h"
|
|
#include "nsRect.h"
|
|
|
|
#include "qcms.h"
|
|
|
|
#include "mozilla/RefPtr.h"
|
|
#include "GfxInfoCollector.h"
|
|
|
|
#include "mozilla/layers/CompositorTypes.h"
|
|
#include "mozilla/layers/MemoryPressureObserver.h"
|
|
|
|
class gfxASurface;
|
|
class gfxFont;
|
|
class gfxFontGroup;
|
|
struct gfxFontStyle;
|
|
class gfxUserFontSet;
|
|
class gfxFontEntry;
|
|
class gfxPlatformFontList;
|
|
class gfxTextRun;
|
|
class nsIURI;
|
|
class nsAtom;
|
|
class nsIObserver;
|
|
class SRGBOverrideObserver;
|
|
class gfxTextPerfMetrics;
|
|
typedef struct FT_LibraryRec_* FT_Library;
|
|
|
|
namespace mozilla {
|
|
namespace layers {
|
|
class FrameStats;
|
|
}
|
|
namespace gfx {
|
|
class DrawTarget;
|
|
class SourceSurface;
|
|
class DataSourceSurface;
|
|
class ScaledFont;
|
|
class DrawEventRecorder;
|
|
class VsyncSource;
|
|
class ContentDeviceData;
|
|
class GPUDeviceData;
|
|
class FeatureState;
|
|
|
|
inline uint32_t BackendTypeBit(BackendType b) { return 1 << uint8_t(b); }
|
|
|
|
} // namespace gfx
|
|
namespace dom {
|
|
class SystemFontListEntry;
|
|
}
|
|
} // namespace mozilla
|
|
|
|
#define MOZ_PERFORMANCE_WARNING(module, ...) \
|
|
do { \
|
|
if (gfxPlatform::PerfWarnings()) { \
|
|
printf_stderr("[" module "] " __VA_ARGS__); \
|
|
} \
|
|
} while (0)
|
|
|
|
enum eCMSMode {
|
|
eCMSMode_Off = 0, // No color management
|
|
eCMSMode_All = 1, // Color manage everything
|
|
eCMSMode_TaggedOnly = 2, // Color manage tagged Images Only
|
|
eCMSMode_AllCount = 3
|
|
};
|
|
|
|
enum eGfxLog {
|
|
// all font enumerations, localized names, fullname/psnames, cmap loads
|
|
eGfxLog_fontlist = 0,
|
|
// timing info on font initialization
|
|
eGfxLog_fontinit = 1,
|
|
// dump text runs, font matching, system fallback for content
|
|
eGfxLog_textrun = 2,
|
|
// dump text runs, font matching, system fallback for chrome
|
|
eGfxLog_textrunui = 3,
|
|
// dump cmap coverage data as they are loaded
|
|
eGfxLog_cmapdata = 4,
|
|
// text perf data
|
|
eGfxLog_textperf = 5
|
|
};
|
|
|
|
// when searching through pref langs, max number of pref langs
|
|
const uint32_t kMaxLenPrefLangList = 32;
|
|
|
|
#define UNINITIALIZED_VALUE (-1)
|
|
|
|
inline const char* GetBackendName(mozilla::gfx::BackendType aBackend) {
|
|
switch (aBackend) {
|
|
case mozilla::gfx::BackendType::DIRECT2D:
|
|
return "direct2d";
|
|
case mozilla::gfx::BackendType::CAIRO:
|
|
return "cairo";
|
|
case mozilla::gfx::BackendType::SKIA:
|
|
return "skia";
|
|
case mozilla::gfx::BackendType::RECORDING:
|
|
return "recording";
|
|
case mozilla::gfx::BackendType::DIRECT2D1_1:
|
|
return "direct2d 1.1";
|
|
case mozilla::gfx::BackendType::WEBRENDER_TEXT:
|
|
return "webrender text";
|
|
case mozilla::gfx::BackendType::CAPTURE:
|
|
return "capture";
|
|
case mozilla::gfx::BackendType::NONE:
|
|
return "none";
|
|
case mozilla::gfx::BackendType::BACKEND_LAST:
|
|
return "invalid";
|
|
}
|
|
MOZ_CRASH("Incomplete switch");
|
|
}
|
|
|
|
enum class DeviceResetReason {
|
|
OK = 0,
|
|
HUNG,
|
|
REMOVED,
|
|
RESET,
|
|
DRIVER_ERROR,
|
|
INVALID_CALL,
|
|
OUT_OF_MEMORY,
|
|
FORCED_RESET,
|
|
UNKNOWN,
|
|
D3D9_RESET
|
|
};
|
|
|
|
enum class ForcedDeviceResetReason {
|
|
OPENSHAREDHANDLE = 0,
|
|
COMPOSITOR_UPDATED,
|
|
};
|
|
|
|
struct BackendPrefsData {
|
|
uint32_t mCanvasBitmask = 0;
|
|
mozilla::gfx::BackendType mCanvasDefault = mozilla::gfx::BackendType::NONE;
|
|
uint32_t mContentBitmask = 0;
|
|
mozilla::gfx::BackendType mContentDefault = mozilla::gfx::BackendType::NONE;
|
|
};
|
|
|
|
class gfxPlatform : public mozilla::layers::MemoryPressureListener {
|
|
friend class SRGBOverrideObserver;
|
|
|
|
public:
|
|
typedef mozilla::StretchRange StretchRange;
|
|
typedef mozilla::SlantStyleRange SlantStyleRange;
|
|
typedef mozilla::WeightRange WeightRange;
|
|
typedef mozilla::gfx::Color Color;
|
|
typedef mozilla::gfx::DataSourceSurface DataSourceSurface;
|
|
typedef mozilla::gfx::DrawTarget DrawTarget;
|
|
typedef mozilla::gfx::IntSize IntSize;
|
|
typedef mozilla::gfx::SourceSurface SourceSurface;
|
|
typedef mozilla::unicode::Script Script;
|
|
|
|
/**
|
|
* Return a pointer to the current active platform.
|
|
* This is a singleton; it contains mostly convenience
|
|
* functions to obtain platform-specific objects.
|
|
*/
|
|
static gfxPlatform* GetPlatform();
|
|
|
|
/**
|
|
* Returns whether or not graphics has been initialized yet. This is
|
|
* intended for Telemetry where we don't necessarily want to initialize
|
|
* graphics just to observe its state.
|
|
*/
|
|
static bool Initialized();
|
|
|
|
/**
|
|
* Shut down Thebes.
|
|
* Init() arranges for this to be called at an appropriate time.
|
|
*/
|
|
static void Shutdown();
|
|
|
|
/**
|
|
* Initialize gfxPlatform (if not already done) in a child process, with
|
|
* the provided ContentDeviceData.
|
|
*/
|
|
static void InitChild(const mozilla::gfx::ContentDeviceData& aData);
|
|
|
|
static void InitLayersIPC();
|
|
static void ShutdownLayersIPC();
|
|
|
|
/**
|
|
* Initialize ScrollMetadata statics. Does not depend on gfxPlatform.
|
|
*/
|
|
static void InitNullMetadata();
|
|
|
|
static int32_t MaxTextureSize();
|
|
static int32_t MaxAllocSize();
|
|
static void InitMoz2DLogging();
|
|
|
|
static bool IsHeadless();
|
|
|
|
static bool UseWebRender();
|
|
|
|
/**
|
|
* Create an offscreen surface of the given dimensions
|
|
* and image format.
|
|
*/
|
|
virtual already_AddRefed<gfxASurface> CreateOffscreenSurface(
|
|
const IntSize& aSize, gfxImageFormat aFormat) = 0;
|
|
|
|
/**
|
|
* Beware that this method may return DrawTargets which are not fully
|
|
* supported on the current platform and might fail silently in subtle ways.
|
|
* This is a massive potential footgun. You should only use these methods for
|
|
* canvas drawing really. Use extreme caution if you use them for content
|
|
* where you are not 100% sure we support the DrawTarget we get back. See
|
|
* SupportsAzureContentForDrawTarget.
|
|
*/
|
|
static already_AddRefed<DrawTarget> CreateDrawTargetForSurface(
|
|
gfxASurface* aSurface, const mozilla::gfx::IntSize& aSize);
|
|
|
|
/*
|
|
* Creates a SourceSurface for a gfxASurface. This function does no caching,
|
|
* so the caller should cache the gfxASurface if it will be used frequently.
|
|
* The returned surface keeps a reference to aTarget, so it is OK to keep the
|
|
* surface, even if aTarget changes.
|
|
* aTarget should not keep a reference to the returned surface because that
|
|
* will cause a cycle.
|
|
*
|
|
* This function is static so that it can be accessed from
|
|
* PluginInstanceChild (where we can't call gfxPlatform::GetPlatform()
|
|
* because the prefs service can only be accessed from the main process).
|
|
*
|
|
* aIsPlugin is used to tell the backend that they can optimize this surface
|
|
* specifically because it's used for a plugin. This is mostly for Skia.
|
|
*/
|
|
static already_AddRefed<SourceSurface> GetSourceSurfaceForSurface(
|
|
RefPtr<mozilla::gfx::DrawTarget> aTarget, gfxASurface* aSurface,
|
|
bool aIsPlugin = false);
|
|
|
|
static void ClearSourceSurfaceForSurface(gfxASurface* aSurface);
|
|
|
|
static already_AddRefed<DataSourceSurface> GetWrappedDataSourceSurface(
|
|
gfxASurface* aSurface);
|
|
|
|
already_AddRefed<DrawTarget> CreateOffscreenContentDrawTarget(
|
|
const mozilla::gfx::IntSize& aSize, mozilla::gfx::SurfaceFormat aFormat,
|
|
bool aFallback = false);
|
|
|
|
already_AddRefed<DrawTarget> CreateOffscreenCanvasDrawTarget(
|
|
const mozilla::gfx::IntSize& aSize, mozilla::gfx::SurfaceFormat aFormat);
|
|
|
|
already_AddRefed<DrawTarget> CreateSimilarSoftwareDrawTarget(
|
|
DrawTarget* aDT, const IntSize& aSize,
|
|
mozilla::gfx::SurfaceFormat aFormat);
|
|
|
|
static already_AddRefed<DrawTarget> CreateDrawTargetForData(
|
|
unsigned char* aData, const mozilla::gfx::IntSize& aSize, int32_t aStride,
|
|
mozilla::gfx::SurfaceFormat aFormat, bool aUninitialized = false);
|
|
|
|
/**
|
|
* Returns true if we should use Azure to render content with aTarget. For
|
|
* example, it is possible that we are using Direct2D for rendering and thus
|
|
* using Azure. But we want to render to a CairoDrawTarget, in which case
|
|
* SupportsAzureContent will return true but SupportsAzureContentForDrawTarget
|
|
* will return false.
|
|
*/
|
|
bool SupportsAzureContentForDrawTarget(mozilla::gfx::DrawTarget* aTarget);
|
|
|
|
bool SupportsAzureContentForType(mozilla::gfx::BackendType aType) {
|
|
return BackendTypeBit(aType) & mContentBackendBitmask;
|
|
}
|
|
|
|
static bool AsyncPanZoomEnabled();
|
|
|
|
virtual void GetAzureBackendInfo(mozilla::widget::InfoObject& aObj);
|
|
void GetApzSupportInfo(mozilla::widget::InfoObject& aObj);
|
|
void GetTilesSupportInfo(mozilla::widget::InfoObject& aObj);
|
|
void GetFrameStats(mozilla::widget::InfoObject& aObj);
|
|
void GetCMSSupportInfo(mozilla::widget::InfoObject& aObj);
|
|
|
|
// Get the default content backend that will be used with the default
|
|
// compositor. If the compositor is known when calling this function,
|
|
// GetContentBackendFor() should be called instead.
|
|
mozilla::gfx::BackendType GetDefaultContentBackend() const {
|
|
return mContentBackend;
|
|
}
|
|
|
|
/// Return the software backend to use by default.
|
|
mozilla::gfx::BackendType GetSoftwareBackend() { return mSoftwareBackend; }
|
|
|
|
// Return the best content backend available that is compatible with the
|
|
// given layers backend.
|
|
virtual mozilla::gfx::BackendType GetContentBackendFor(
|
|
mozilla::layers::LayersBackend aLayers) {
|
|
return mContentBackend;
|
|
}
|
|
|
|
virtual mozilla::gfx::BackendType GetPreferredCanvasBackend() {
|
|
return mPreferredCanvasBackend;
|
|
}
|
|
mozilla::gfx::BackendType GetFallbackCanvasBackend() {
|
|
return mFallbackCanvasBackend;
|
|
}
|
|
|
|
/*
|
|
* Font bits
|
|
*/
|
|
|
|
/**
|
|
* Fill aListOfFonts with the results of querying the list of font names
|
|
* that correspond to the given language group or generic font family
|
|
* (or both, or neither).
|
|
*/
|
|
virtual nsresult GetFontList(nsAtom* aLangGroup,
|
|
const nsACString& aGenericFamily,
|
|
nsTArray<nsString>& aListOfFonts);
|
|
|
|
/**
|
|
* Fill aFontList with a list of SystemFontListEntry records for the
|
|
* available fonts on the platform; used to pass the list from chrome to
|
|
* content process. Currently implemented only on MacOSX and Linux.
|
|
*/
|
|
virtual void ReadSystemFontList(
|
|
nsTArray<mozilla::dom::SystemFontListEntry>* aFontList) {}
|
|
|
|
/**
|
|
* Rebuilds the any cached system font lists
|
|
*/
|
|
virtual nsresult UpdateFontList();
|
|
|
|
/**
|
|
* Create the platform font-list object (gfxPlatformFontList concrete
|
|
* subclass). This function is responsible to create the appropriate subclass
|
|
* of gfxPlatformFontList *and* to call its InitFontList() method.
|
|
*/
|
|
virtual gfxPlatformFontList* CreatePlatformFontList() {
|
|
MOZ_ASSERT_UNREACHABLE(
|
|
"oops, this platform doesn't have a "
|
|
"gfxPlatformFontList implementation");
|
|
return nullptr;
|
|
}
|
|
|
|
/**
|
|
* Resolving a font name to family name. The result MUST be in the result of
|
|
* GetFontList(). If the name doesn't in the system, aFamilyName will be empty
|
|
* string, but not failed.
|
|
*/
|
|
void GetStandardFamilyName(const nsCString& aFontName,
|
|
nsACString& aFamilyName);
|
|
|
|
/**
|
|
* Returns default font name (localized family name) for aLangGroup and
|
|
* aGenericFamily. The result is typically the first font in
|
|
* font.name-list.<aGenericFamily>.<aLangGroup>. However, if it's not
|
|
* available in the system, this may return second or later font in the
|
|
* pref. If there are no available fonts in the pref, returns empty string.
|
|
*/
|
|
nsAutoCString GetDefaultFontName(const nsACString& aLangGroup,
|
|
const nsACString& aGenericFamily);
|
|
|
|
/**
|
|
* Create the appropriate platform font group
|
|
*/
|
|
virtual gfxFontGroup* CreateFontGroup(
|
|
const mozilla::FontFamilyList& aFontFamilyList,
|
|
const gfxFontStyle* aStyle, gfxTextPerfMetrics* aTextPerf,
|
|
gfxUserFontSet* aUserFontSet, gfxFloat aDevToCssSize) = 0;
|
|
|
|
/**
|
|
* Look up a local platform font using the full font face name.
|
|
* (Needed to support @font-face src local().)
|
|
* Ownership of the returned gfxFontEntry is passed to the caller,
|
|
* who must either AddRef() or delete.
|
|
*/
|
|
gfxFontEntry* LookupLocalFont(const nsACString& aFontName,
|
|
WeightRange aWeightForEntry,
|
|
StretchRange aStretchForEntry,
|
|
SlantStyleRange aStyleForEntry);
|
|
|
|
/**
|
|
* Activate a platform font. (Needed to support @font-face src url().)
|
|
* aFontData is a NS_Malloc'ed block that must be freed by this function
|
|
* (or responsibility passed on) when it is no longer needed; the caller
|
|
* will NOT free it.
|
|
* Ownership of the returned gfxFontEntry is passed to the caller,
|
|
* who must either AddRef() or delete.
|
|
*/
|
|
gfxFontEntry* MakePlatformFont(const nsACString& aFontName,
|
|
WeightRange aWeightForEntry,
|
|
StretchRange aStretchForEntry,
|
|
SlantStyleRange aStyleForEntry,
|
|
const uint8_t* aFontData, uint32_t aLength);
|
|
|
|
/**
|
|
* Whether to allow downloadable fonts via @font-face rules
|
|
*/
|
|
bool DownloadableFontsEnabled();
|
|
|
|
/**
|
|
* True when hinting should be enabled. This setting shouldn't
|
|
* change per gecko process, while the process is live. If so the
|
|
* results are not defined.
|
|
*
|
|
* NB: this bit is only honored by the FT2 backend, currently.
|
|
*/
|
|
virtual bool FontHintingEnabled() { return true; }
|
|
|
|
/**
|
|
* True when zooming should not require reflow, so glyph metrics and
|
|
* positioning should not be adjusted for device pixels.
|
|
* If this is TRUE, then FontHintingEnabled() should be FALSE,
|
|
* but the converse is not necessarily required;
|
|
*
|
|
* Like FontHintingEnabled (above), this setting shouldn't
|
|
* change per gecko process, while the process is live. If so the
|
|
* results are not defined.
|
|
*
|
|
* NB: this bit is only honored by the FT2 backend, currently.
|
|
*/
|
|
virtual bool RequiresLinearZoom() { return false; }
|
|
|
|
/**
|
|
* Whether the frame->StyleFont().mFont.smoothing field is respected by
|
|
* text rendering on this platform.
|
|
*/
|
|
virtual bool RespectsFontStyleSmoothing() const { return false; }
|
|
|
|
/**
|
|
* Whether to check all font cmaps during system font fallback
|
|
*/
|
|
bool UseCmapsDuringSystemFallback();
|
|
|
|
/**
|
|
* Whether to render SVG glyphs within an OpenType font wrapper
|
|
*/
|
|
bool OpenTypeSVGEnabled();
|
|
|
|
/**
|
|
* Max character length of words in the word cache
|
|
*/
|
|
uint32_t WordCacheCharLimit();
|
|
|
|
/**
|
|
* Max number of entries in word cache
|
|
*/
|
|
uint32_t WordCacheMaxEntries();
|
|
|
|
/**
|
|
* Whether to use the SIL Graphite rendering engine
|
|
* (for fonts that include Graphite tables)
|
|
*/
|
|
bool UseGraphiteShaping();
|
|
|
|
// Check whether format is supported on a platform (if unclear, returns true).
|
|
// Default implementation checks for "common" formats that we support across
|
|
// all platforms, but individual platform implementations may override.
|
|
virtual bool IsFontFormatSupported(uint32_t aFormatFlags);
|
|
|
|
virtual bool DidRenderingDeviceReset(
|
|
DeviceResetReason* aResetReason = nullptr) {
|
|
return false;
|
|
}
|
|
|
|
// returns a list of commonly used fonts for a given character
|
|
// these are *possible* matches, no cmap-checking is done at this level
|
|
virtual void GetCommonFallbackFonts(uint32_t /*aCh*/, uint32_t /*aNextCh*/,
|
|
Script /*aRunScript*/,
|
|
nsTArray<const char*>& /*aFontList*/) {
|
|
// platform-specific override, by default do nothing
|
|
}
|
|
|
|
// Are we in safe mode?
|
|
static bool InSafeMode();
|
|
|
|
static bool OffMainThreadCompositingEnabled();
|
|
|
|
void UpdateCanUseHardwareVideoDecoding();
|
|
|
|
// Returns a prioritized list of all available compositor backends.
|
|
void GetCompositorBackends(
|
|
bool useAcceleration,
|
|
nsTArray<mozilla::layers::LayersBackend>& aBackends);
|
|
|
|
/**
|
|
* Is it possible to use buffer rotation. Note that these
|
|
* check the preference, but also allow for the override to
|
|
* disable it using DisableBufferRotation.
|
|
*/
|
|
static bool BufferRotationEnabled();
|
|
static void DisableBufferRotation();
|
|
|
|
/**
|
|
* Are we going to try color management?
|
|
*/
|
|
static eCMSMode GetCMSMode();
|
|
|
|
/**
|
|
* Determines the rendering intent for color management.
|
|
*
|
|
* If the value in the pref gfx.color_management.rendering_intent is a
|
|
* valid rendering intent as defined in gfx/qcms/qcms.h, that
|
|
* value is returned. Otherwise, -1 is returned and the embedded intent
|
|
* should be used.
|
|
*
|
|
* See bug 444014 for details.
|
|
*/
|
|
static int GetRenderingIntent();
|
|
|
|
/**
|
|
* Convert a pixel using a cms transform in an endian-aware manner.
|
|
*
|
|
* Sets 'out' to 'in' if transform is nullptr.
|
|
*/
|
|
static void TransformPixel(const Color& in, Color& out,
|
|
qcms_transform* transform);
|
|
|
|
/**
|
|
* Return the output device ICC profile.
|
|
*/
|
|
static qcms_profile* GetCMSOutputProfile();
|
|
|
|
/**
|
|
* Return the sRGB ICC profile.
|
|
*/
|
|
static qcms_profile* GetCMSsRGBProfile();
|
|
|
|
/**
|
|
* Return sRGB -> output device transform.
|
|
*/
|
|
static qcms_transform* GetCMSRGBTransform();
|
|
|
|
/**
|
|
* Return output -> sRGB device transform.
|
|
*/
|
|
static qcms_transform* GetCMSInverseRGBTransform();
|
|
|
|
/**
|
|
* Return sRGBA -> output device transform.
|
|
*/
|
|
static qcms_transform* GetCMSRGBATransform();
|
|
|
|
/**
|
|
* Return sRGBA -> output device transform.
|
|
*/
|
|
static qcms_transform* GetCMSBGRATransform();
|
|
|
|
virtual void FontsPrefsChanged(const char* aPref);
|
|
|
|
int32_t GetBidiNumeralOption();
|
|
|
|
/**
|
|
* This is a bit ugly, but useful... force all presContexts to reflow,
|
|
* by toggling a preference that they observe. This is used when
|
|
* something about platform settings changes that might have an effect
|
|
* on layout, such as font rendering settings that influence metrics.
|
|
*/
|
|
static void ForceGlobalReflow();
|
|
|
|
static void FlushFontAndWordCaches();
|
|
|
|
/**
|
|
* Returns a 1x1 surface that can be used to create graphics contexts
|
|
* for measuring text etc as if they will be rendered to the screen
|
|
*/
|
|
gfxASurface* ScreenReferenceSurface() { return mScreenReferenceSurface; }
|
|
|
|
/**
|
|
* Returns a 1x1 DrawTarget that can be used for measuring text etc. as
|
|
* it would measure if rendered on-screen. Guaranteed to return a
|
|
* non-null and valid DrawTarget.
|
|
*/
|
|
RefPtr<mozilla::gfx::DrawTarget> ScreenReferenceDrawTarget();
|
|
|
|
virtual mozilla::gfx::SurfaceFormat Optimal2DFormatForContent(
|
|
gfxContentType aContent);
|
|
|
|
virtual gfxImageFormat OptimalFormatForContent(gfxContentType aContent);
|
|
|
|
virtual gfxImageFormat GetOffscreenFormat() {
|
|
return mozilla::gfx::SurfaceFormat::X8R8G8B8_UINT32;
|
|
}
|
|
|
|
/**
|
|
* Returns whether the current process should use tiling for layers.
|
|
*/
|
|
virtual bool UsesTiling() const;
|
|
|
|
/**
|
|
* Returns whether the content process will use tiling for layers. This is
|
|
* only used by about:support.
|
|
*/
|
|
virtual bool ContentUsesTiling() const;
|
|
|
|
/**
|
|
* Returns a logger if one is available and logging is enabled
|
|
*/
|
|
static mozilla::LogModule* GetLog(eGfxLog aWhichLog);
|
|
|
|
int GetScreenDepth() const { return mScreenDepth; }
|
|
mozilla::gfx::IntSize GetScreenSize() const { return mScreenSize; }
|
|
|
|
/**
|
|
* Return the layer debugging options to use browser-wide.
|
|
*/
|
|
mozilla::layers::DiagnosticTypes GetLayerDiagnosticTypes();
|
|
|
|
static void PurgeSkiaFontCache();
|
|
|
|
static bool UsesOffMainThreadCompositing();
|
|
|
|
/**
|
|
* Get the hardware vsync source for each platform.
|
|
* Should only exist and be valid on the parent process
|
|
*/
|
|
virtual mozilla::gfx::VsyncSource* GetHardwareVsync() {
|
|
MOZ_ASSERT(mVsyncSource != nullptr);
|
|
MOZ_ASSERT(XRE_IsParentProcess() ||
|
|
mozilla::recordreplay::IsRecordingOrReplaying());
|
|
return mVsyncSource;
|
|
}
|
|
|
|
/**
|
|
* True if layout rendering should use ASAP mode, which means
|
|
* the refresh driver and compositor should render ASAP.
|
|
* Used for talos testing purposes
|
|
*/
|
|
static bool IsInLayoutAsapMode();
|
|
|
|
/**
|
|
* Returns whether or not a custom vsync rate is set.
|
|
*/
|
|
static bool ForceSoftwareVsync();
|
|
|
|
/**
|
|
* Returns the software vsync rate to use.
|
|
*/
|
|
static int GetSoftwareVsyncRate();
|
|
|
|
/**
|
|
* Returns the default frame rate for the refresh driver / software vsync.
|
|
*/
|
|
static int GetDefaultFrameRate();
|
|
|
|
/**
|
|
* Update the frame rate (called e.g. after pref changes).
|
|
*/
|
|
static void ReInitFrameRate();
|
|
|
|
/**
|
|
* Used to test which input types are handled via APZ.
|
|
*/
|
|
virtual bool SupportsApzWheelInput() const { return false; }
|
|
bool SupportsApzTouchInput() const;
|
|
bool SupportsApzDragInput() const;
|
|
bool SupportsApzKeyboardInput() const;
|
|
bool SupportsApzAutoscrolling() const;
|
|
|
|
virtual void FlushContentDrawing() {}
|
|
|
|
// If a device reset has occurred, schedule any necessary paints in the
|
|
// widget. This should only be used within nsRefreshDriver.
|
|
virtual void SchedulePaintIfDeviceReset() {}
|
|
|
|
/**
|
|
* Helper method, creates a draw target for a specific Azure backend.
|
|
* Used by CreateOffscreenDrawTarget.
|
|
*/
|
|
already_AddRefed<DrawTarget> CreateDrawTargetForBackend(
|
|
mozilla::gfx::BackendType aBackend, const mozilla::gfx::IntSize& aSize,
|
|
mozilla::gfx::SurfaceFormat aFormat);
|
|
|
|
/**
|
|
* Wrapper around StaticPrefs::gfx_perf_warnings_enabled().
|
|
* Extracted into a function to avoid including StaticPrefs.h from this file.
|
|
*/
|
|
static bool PerfWarnings();
|
|
|
|
static void NotifyGPUProcessDisabled();
|
|
|
|
void NotifyCompositorCreated(mozilla::layers::LayersBackend aBackend);
|
|
mozilla::layers::LayersBackend GetCompositorBackend() const {
|
|
return mCompositorBackend;
|
|
}
|
|
|
|
virtual void CompositorUpdated() {}
|
|
|
|
// Plugin async drawing support.
|
|
virtual bool SupportsPluginDirectBitmapDrawing() { return false; }
|
|
|
|
// Some platforms don't support CompositorOGL in an unaccelerated OpenGL
|
|
// context. These platforms should return true here.
|
|
virtual bool RequiresAcceleratedGLContextForCompositorOGL() const {
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Check the blocklist for a feature. Returns false if the feature is blocked
|
|
* with an appropriate message and failure ID.
|
|
* */
|
|
static bool IsGfxInfoStatusOkay(int32_t aFeature, nsCString* aOutMessage,
|
|
nsCString& aFailureId);
|
|
|
|
const gfxSkipChars& EmptySkipChars() const { return kEmptySkipChars; }
|
|
|
|
/**
|
|
* Return information on how child processes should initialize graphics
|
|
* devices.
|
|
*/
|
|
virtual void BuildContentDeviceData(mozilla::gfx::ContentDeviceData* aOut);
|
|
|
|
/**
|
|
* Imports settings from the GPU process. This should only be called through
|
|
* GPUProcessManager, in the UI process.
|
|
*/
|
|
virtual void ImportGPUDeviceData(const mozilla::gfx::GPUDeviceData& aData);
|
|
|
|
virtual FT_Library GetFTLibrary() { return nullptr; }
|
|
|
|
bool HasVariationFontSupport() const { return mHasVariationFontSupport; }
|
|
|
|
bool HasNativeColrFontSupport() const { return mHasNativeColrFontSupport; }
|
|
|
|
// you probably want to use gfxVars::UseWebRender() instead of this
|
|
static bool WebRenderPrefEnabled();
|
|
// you probably want to use gfxVars::UseWebRender() instead of this
|
|
static bool WebRenderEnvvarEnabled();
|
|
|
|
void NotifyFrameStats(nsTArray<mozilla::layers::FrameStats>&& aFrameStats);
|
|
|
|
virtual void OnMemoryPressure(
|
|
mozilla::layers::MemoryPressureReason aWhy) override;
|
|
|
|
virtual void EnsureDevicesInitialized(){};
|
|
virtual bool DevicesInitialized() { return true; };
|
|
|
|
static uint32_t TargetFrameRate();
|
|
|
|
protected:
|
|
gfxPlatform();
|
|
virtual ~gfxPlatform();
|
|
|
|
virtual bool HasBattery() { return false; }
|
|
|
|
virtual void InitAcceleration();
|
|
virtual void InitWebRenderConfig();
|
|
|
|
/**
|
|
* Called immediately before deleting the gfxPlatform object.
|
|
*/
|
|
virtual void WillShutdown();
|
|
|
|
/**
|
|
* Initialized hardware vsync based on each platform.
|
|
*/
|
|
virtual already_AddRefed<mozilla::gfx::VsyncSource>
|
|
CreateHardwareVsyncSource();
|
|
|
|
// Returns whether or not layers should be accelerated by default on this
|
|
// platform.
|
|
virtual bool AccelerateLayersByDefault();
|
|
|
|
// Returns a prioritized list of available compositor backends for
|
|
// acceleration.
|
|
virtual void GetAcceleratedCompositorBackends(
|
|
nsTArray<mozilla::layers::LayersBackend>& aBackends);
|
|
|
|
// Returns preferences of canvas and content backends.
|
|
virtual BackendPrefsData GetBackendPrefs() const;
|
|
|
|
/**
|
|
* Initialise the preferred and fallback canvas backends
|
|
* aBackendBitmask specifies the backends which are acceptable to the caller.
|
|
* The backend used is determined by aBackendBitmask and the order specified
|
|
* by the gfx.canvas.azure.backends pref.
|
|
*/
|
|
void InitBackendPrefs(BackendPrefsData&& aPrefsData);
|
|
|
|
/**
|
|
* Content-process only. Requests device preferences from the parent process
|
|
* and updates any cached settings.
|
|
*/
|
|
void FetchAndImportContentDeviceData();
|
|
virtual void ImportContentDeviceData(
|
|
const mozilla::gfx::ContentDeviceData& aData);
|
|
|
|
/**
|
|
* Increase the global device counter after a device has been removed/reset.
|
|
*/
|
|
void BumpDeviceCounter();
|
|
|
|
/**
|
|
* returns the first backend named in the pref gfx.canvas.azure.backends
|
|
* which is a component of aBackendBitmask, a bitmask of backend types
|
|
*/
|
|
static mozilla::gfx::BackendType GetCanvasBackendPref(
|
|
uint32_t aBackendBitmask);
|
|
|
|
/**
|
|
* returns the first backend named in the pref gfx.content.azure.backend
|
|
* which is a component of aBackendBitmask, a bitmask of backend types
|
|
*/
|
|
static mozilla::gfx::BackendType GetContentBackendPref(
|
|
uint32_t& aBackendBitmask);
|
|
|
|
/**
|
|
* Will return the first backend named in aBackendPrefName
|
|
* allowed by aBackendBitmask, a bitmask of backend types.
|
|
* It also modifies aBackendBitmask to only include backends that are
|
|
* allowed given the prefs.
|
|
*/
|
|
static mozilla::gfx::BackendType GetBackendPref(const char* aBackendPrefName,
|
|
uint32_t& aBackendBitmask);
|
|
/**
|
|
* Decode the backend enumberation from a string.
|
|
*/
|
|
static mozilla::gfx::BackendType BackendTypeForName(const nsCString& aName);
|
|
|
|
virtual bool CanUseHardwareVideoDecoding();
|
|
|
|
virtual bool CheckVariationFontSupport() = 0;
|
|
|
|
int8_t mAllowDownloadableFonts;
|
|
int8_t mGraphiteShapingEnabled;
|
|
int8_t mOpenTypeSVGEnabled;
|
|
|
|
int8_t mBidiNumeralOption;
|
|
|
|
// whether to always search font cmaps globally
|
|
// when doing system font fallback
|
|
int8_t mFallbackUsesCmaps;
|
|
|
|
// Whether the platform supports rendering OpenType font variations
|
|
bool mHasVariationFontSupport;
|
|
|
|
// Whether the platform font APIs have native support for COLR fonts.
|
|
// Set to true during initialization on platforms that implement this.
|
|
bool mHasNativeColrFontSupport = false;
|
|
|
|
// max character limit for words in word cache
|
|
int32_t mWordCacheCharLimit;
|
|
|
|
// max number of entries in word cache
|
|
int32_t mWordCacheMaxEntries;
|
|
|
|
uint64_t mTotalSystemMemory;
|
|
|
|
// Hardware vsync source. Only valid on parent process
|
|
RefPtr<mozilla::gfx::VsyncSource> mVsyncSource;
|
|
|
|
RefPtr<mozilla::gfx::DrawTarget> mScreenReferenceDrawTarget;
|
|
|
|
private:
|
|
/**
|
|
* Start up Thebes.
|
|
*/
|
|
static void Init();
|
|
|
|
static void InitOpenGLConfig();
|
|
static void CreateCMSOutputProfile();
|
|
|
|
static void GetCMSOutputProfileData(void*& mem, size_t& size);
|
|
|
|
friend void RecordingPrefChanged(const char* aPrefName, void* aClosure);
|
|
|
|
virtual void GetPlatformCMSOutputProfile(void*& mem, size_t& size);
|
|
|
|
/**
|
|
* Calling this function will compute and set the ideal tile size for the
|
|
* platform. This will only have an effect in the parent process; child
|
|
* processes should be updated via SetTileSize to match the value computed in
|
|
* the parent.
|
|
*/
|
|
void ComputeTileSize();
|
|
|
|
/**
|
|
* This uses nsIScreenManager to determine the screen size and color depth
|
|
*/
|
|
void PopulateScreenInfo();
|
|
|
|
void InitCompositorAccelerationPrefs();
|
|
void InitGPUProcessPrefs();
|
|
virtual void InitPlatformGPUProcessPrefs() {}
|
|
void InitOMTPConfig();
|
|
|
|
static bool IsDXInterop2Blocked();
|
|
static bool IsDXNV12Blocked();
|
|
static bool IsDXP010Blocked();
|
|
static bool IsDXP016Blocked();
|
|
|
|
RefPtr<gfxASurface> mScreenReferenceSurface;
|
|
nsCOMPtr<nsIObserver> mSRGBOverrideObserver;
|
|
RefPtr<mozilla::layers::MemoryPressureObserver> mMemoryPressureObserver;
|
|
|
|
// The preferred draw target backend to use for canvas
|
|
mozilla::gfx::BackendType mPreferredCanvasBackend;
|
|
// The fallback draw target backend to use for canvas, if the preferred
|
|
// backend fails
|
|
mozilla::gfx::BackendType mFallbackCanvasBackend;
|
|
// The backend to use for content
|
|
mozilla::gfx::BackendType mContentBackend;
|
|
// The backend to use when we need it not to be accelerated.
|
|
mozilla::gfx::BackendType mSoftwareBackend;
|
|
// Bitmask of backend types we can use to render content
|
|
uint32_t mContentBackendBitmask;
|
|
|
|
mozilla::widget::GfxInfoCollector<gfxPlatform> mAzureCanvasBackendCollector;
|
|
mozilla::widget::GfxInfoCollector<gfxPlatform> mApzSupportCollector;
|
|
mozilla::widget::GfxInfoCollector<gfxPlatform> mTilesInfoCollector;
|
|
mozilla::widget::GfxInfoCollector<gfxPlatform> mFrameStatsCollector;
|
|
mozilla::widget::GfxInfoCollector<gfxPlatform> mCMSInfoCollector;
|
|
|
|
nsTArray<mozilla::layers::FrameStats> mFrameStats;
|
|
|
|
RefPtr<mozilla::gfx::DrawEventRecorder> mRecorder;
|
|
|
|
// Backend that we are compositing with. NONE, if no compositor has been
|
|
// created yet.
|
|
mozilla::layers::LayersBackend mCompositorBackend;
|
|
|
|
int32_t mScreenDepth;
|
|
mozilla::gfx::IntSize mScreenSize;
|
|
|
|
// An instance of gfxSkipChars which is empty. It is used as the
|
|
// basis for error-case iterators.
|
|
const gfxSkipChars kEmptySkipChars;
|
|
};
|
|
|
|
#endif /* GFX_PLATFORM_H */
|