Skia Graphics Release Notes
This file includes a list of high level updates for each milestone release.
SkAndroidCodec::getGainmapAndroidCodec which returns an SkAndroidCodec instead of an SkStream. Mark as deprecated the version that returns an SkStream.SkColorFilter::filterColor has been removed. Please use SkColorFilter::filterColor4f instead.include/core/SkFourByteTag.hGR_MAKE_BITFIELD_CLASS_OPS and GR_DECL_BITFIELD_CLASS_OPS_FRIENDS have been removed from the public APISkMSec has been removed from the public API, including SkParse::FindMSecskgpu::graphite::TextureInfo, skgpu::graphite::BackendTexture, have been deprecated and moved to be functions in DawnTypes.hSkImageFilters::DropShadow and SkImageFilters::DropShadowOnly now accept SkColor4f and SkColorSpace for the shadow color.SkScalerContext::MakeRecAndEffects now converts SkFont::isEmbolden to the kEmbolden_Flag. It no longer automatically converts embolden requests into (more) stroking. This can now (optionally) be done in SkTypeface::onFilterRec by calling the new SkScalerContextRec::useStrokeForFakeBold().skgpu::graphite::TextureInfo, skgpu::graphite::BackendTexture, skgpu::graphite::BackendSemaphore have been deprecated and moved to be functions in VulkanGraphiteTypes.hSkSL now properly reports an error if user code includes various GLSL reserved keywords. Previously, Skia would correctly reject keywords that were included in “The OpenGL ES Shading Language, Version 1.00,” but did not detect reserved keywords added in more modern GLSL versions. Instead, Skia would allow such code to compile during the construction of a runtime effect, but actually rendering the effect using a modern version of OpenGL would silently fail (or assert) due to the presence of the reserved name in the the code.
Examples of reserved names which SkSL will now reject include dmat3x3, atomic_uint, isampler2D, or imageCubeArray.
For a more thorough list of reserved keywords, see the “3.6 Keywords” section of the OpenGL Shading Language documentation.
The following symbols (and their files) have been deleted in favor of their GPU-backend-agnostic form:
GrVkBackendContext -> skgpu::VulkanBackendContextGrVkExtensions -> skgpu::VulkanExtensionsGrVkMemoryAllocator = skgpu::VulkanMemoryAllocatorGrVkBackendMemory = skgpu::VulkanBackendMemoryGrVkAlloc = skgpu::VulkanAllocGrVkYcbcrConversionInfo = skgpu::VulkanYcbcrConversionInfoGrVkGetProc = skgpu::VulkanGetProcThe Metal-specific constructors and methods on skgpu::graphite::TextureInfo, skgpu::graphite::BackendTexture, skgpu::graphite::BackendSemaphore have been deprecated and moved to be functions in MtlGraphiteTypes.h
SkImage now has a method makeScaled(...) which returns a scaled version of the image, retaining its original “domain”
SkSL now properly recognizes the types uvec2, uvec3 or uvec4.
Unsigned types are not supported in Runtime Effects, as they did not exist in GLSL ES2; however, SkSL should still recognize these typenames and reject them if they are used in a program. That is, we should not allow uvec3 to be used as a variable or function name. We will now properly detect and reject this as an error.
The following deprecated fields have been removed from GrVkBackendContext:
fMinAPIVersion. Use fMaxAPIVersion instead.fInstanceVersion. Use fMaxAPIVersion instead.fFeatures. Use fDeviceFeatures or fDeviceFeatures2 instead.fOwnsInstanceAndDevice. No replacement, as it had no effect.GrVkBackendContext is now an alias for skgpu::VulkanBackendContext. Clients should use the latter, as the former will be eventually removed.
SkShaderMaskFilters and SkTableMaskFilters have been deprecated. They will be removed entirely in an upcoming Skia release.
Skia's internal array class (skia_private::TArray<T>) now protects its unused capacity when Address Sanitizer (ASAN) is enabled. Code which inadvertently writes past the end of a Skia internal structure is now more likely to trigger an ASAN error.
SkFloat2Bits and SkBits2Float have been removed from the Skia public headers. These were always private API (since they lived in /include/private) but they had leaked into some example code, and tended to be available once a handful of Skia headers were #included.
SkSL now allows the ++ and -- operators on vector and matrix variables.
Previously, attempting to use these operators on a vector or matrix would lead to an error. This was a violation of the GLSL expression rules (5.9): “The arithmetic unary operators negate (-), post- and pre-increment and decrement (-- and ++) operate on integer or floating-point values (including vectors and matrices).”
SkScalarIsFinite, SkScalarsAreFinite, and SkScalarIsNaN have been removed from the Skia API. These calls can be replaced with the functionally-equivalent std::isfinite and std::isnan.
Clients can explicitly make a Ganesh GL backend for iOS with GrGLInterfaces::MakeIOS from include/gpu/ganesh/gl/ios/GrGLMakeIOSInterface.h
Clients can explicitly make a Ganesh GL backend for Mac with GrGLInterfaces::MakeMac from include/gpu/ganesh/gl/mac/GrGLMakeMacInterface.h
The following headers have been relocated (notice “ganesh” in the filepath):
The size of the GPU memory cache budget can now be queried using member maxBudgetedBytes of skgpu::graphite::Context and skgpu::graphite::Recorder.
Added skgpu::graphite::Context::maxTextureSize(), which exposes the maximum texture dimension supported by the underlying backend.
Using a MTLBinaryArchive to pre-load the MSL shader cache is no longer supported in Ganesh, and the fBinaryArchive member of GrMtlBackendContext has been removed.
The sksl-minify tool can now eliminate unnecessary braces. For instance, given the following SkSL code:
if (condition) {
return 1;
} else {
return 2;
}
The minifier will now emit:
if(a)return 1;else return 2;
Added SkBitmap::setColorSpace. This API allows the colorspace of an existing SkBitmap to be reinterpreted. The pixel data backing the bitmap will be left as-is. The colorspace will be honored when the bitmap is accessed via APIs which support colorspace conversion, like readPixels.
SkDrawLooper has been removed completely from Skia. It was previously deprecated.
Metal-specific constructors and methods have been removed from GrBackendFormat, GrBackendTexture, and GrBackendRenderTarget and moved to include/gpu/ganesh/mtl/GrMtlBackendSurface.h
By default, //modules/skottie and //modules/svg will use primitive text shaping. Clients that wish to use harfbuzz/icu for more correct shaping will need to use one of the builders and call setTextShapingFactory with a newly-created SkShapers::Factory implementation during construction.
For ease of configuration, modules/skshaper/utils/FactoryHelpers.h can be used to provide this, but only if the client is depending on the correct skshaper and skunicode modules (which should set defines such as SK_SHAPER_HARFBUZZ_AVAILABLE).
For example builder.setTextShapingFactory(SkShapers::BestAvailable()) will use Harfbuzz or CoreText for shaping if they were compiled in to the clients binary.
SkColorFilter::filterColor is now deprecated and will eventually be removed in favor of filterColor4f.
The Perlin noise shaders (MakeFractalNoise and MakeTurbulence) will now properly rotate when transformed. On raster surfaces, the performance of Perlin noise has also been significantly improved.
Graphite's SkImages::WrapTexture now takes an additional parameter that indicates whether a mipmapped texture should be used as is or whether Graphite should generate the upper level contents from the base level contents.
GrBackendSemaphore::initMetal, GrBackendSemaphore::mtlSemaphore, and GrBackendSemaphore::mtlValue have been replaced with GrBackendSemaphores::MakeMtl, GrBackendSemaphores::GetMtlHandle, and GrBackendSemaphores::GetMtlValue, defined in include/gpu/ganesh/mtl/GrMtlBackendSemaphore.h
GrDirectContext::MakeMetal has been moved to GrDirectContexts::MakeMetal, located in include/gpu/ganesh/mtl/GrMtlDirectContext.h. The APIs that passed in void* have been removed in that change, so clients who use those need to create a GrMtlBackendContext themselves.
include/gpu/mtl/GrMtlTypes.h and include/gpu/mtl/GrMtlBackendContext.h have been relocated to include/gpu/ganesh/mtl/GrMtlTypes.h and include/gpu/ganesh/mtl/GrMtlBackendContext.h respectively.
Added SkCodecs::DeferredImage which is similar to SkImages::DeferredFromEncodedData except it allows the caller to pass in a SkCodec directly instead of depending on compiled-in codecs.
The following SkShaper functions have been moved or deleted:
Additionally, two SkShaper::shape method overloads have been removed - clients now need to specify all 10 arguments (although it is common to pass in nullptr for features).
SkStream::getData() has been added as a virtual. Subclasses can implement this if it is efficient to turn the underlying contents into an SkData (e.g. SkStreamMemory). SkStreamMemory::asData() has been renamed to getData() as a result of this change and will be removed in a future release.
When SkCodec::SelectionPolicy::kPreferStillImage is passed to SkWuffsCodec/SkGifDecoder creation, and the input stream cannot be rewound, the resulting SkWuffsCodec will no longer copy the stream. Because it will now have a non-seekable stream, it no longer supports getFrameCount, which will now simply report 1, or getFrameInfo, which is useful only for animation anyway. Chromium uses kPreferStillImage, simply because it is the default, but will not be affected by this change because it always supplies a seekable stream.
A kDefault_Flag = 0 value has been added to the SkSurfaceProps::Flags enum. This is just a self-documenting zero-value that aims to improve code readability, e.g.:
// The two lines below are equivalent. SkSurfaceProps(/* surfaceFlags= */ 0, kRGB_H_SkPixelGeometry); SkSurfaceProps(SkSurfaceProps::kDefault_Flag, kRGB_H_SkPixelGeometry);
In native builds the default use of wgpu::Device::Tick to detect GPU progress has been updated to use wgpu::Instance::ProcessEvents instead. To simulate the non-yielding behavior of Context in native DawnBackendContext::fTick may still be explicitly set to nullptr.
The Vulkan backend for both Ganesh and Graphite will now invoke an optional client-provided callback function when a VK_ERROR_DEVICE_LOST error code is returned from the Vulkan driver. Additional debugging information will be passed from the driver to this callback if the VK_EXT_device_fault extension is supported and enabled.
This optional callback can be be provided via the fDeviceLostContext and fDeviceLostProc fields on GrVkBackendContext (Ganesh) and VulkanBackendContext (Graphite).
SkAnimCodecPlayer has been removed from the public API.
SkCodec::getImage() will now respect the origin in the metadata (e.g. Exif metadata that rotates the image). This may mean callers who provide an SkImageInfo may need to rotate it, e.g. via SkPixmapUtils::SwapWidthHeight.
graphite::BackendTexture can be created from a WGPUTextureView. This comes with a perfomance cost when reading pixels to or writing pixels from the CPU. An intermediate WGPUTexture is created to support these operations. However, this enables creating SkSurface or SkImage from wgpu::SwapChain::GetCurrentTextureView.
SkSL now properly reports an error if the body of a for-loop declares a variable which shadows the for-loop induction variable.
In other words, SkSL code like this will now generate an error:
for (int x = 0; x < 10; ++x) {
int x = 123; // error: symbol 'x' was already defined
}
Previously, the declaration of x would be allowed, in violation of the GLSL scoping rules (6.3): “For both for and while loops, the sub-statement does not introduce a new scope for variable names.”
The PDF code now directly depends on Skia's JPEG decoder and encoder. The build time shims to avoid using a JPEG decoder and encoder have been removed. In the future these may be made optional again by allowing the user to supply them at runtime.
SkSL variables declared inside of a switch statement will now properly fall out of scope after the closing brace of the switch-block, as one would expect.
In other words, SkSL code like this will now generate an error:
switch (n) {
case 1:
int x = 123;
}
return x; // error: unknown identifier 'x'
Previously, x would remain accessible after the switch's closing brace.
skgpu::graphite::ContextOptions::fNeverYieldToWebGPU is removed. Instead, yielding in an Emscripten build is controlled by installing a client-provided function on skgpu::graphite::DawnBackendContext. The client may install a function that uses Asyncify to yield to the main thread loop. If no function is installed then the Context has the same restrictions as with the old option.
In native builds the default is to use wgpu::Device::Tick to detect GPU progress. To simulate the non-yielding behavior of Context in native DawnBackendContext::fTick may be explicitly set to to nullptr.
By externalizing the use of Asyncify it is possible to build Skia without generated JS code that relies on Asyncify.
SkSL will now properly report an error if a function contains a top-level variable with the same name as a function parameter. SkSL intends to match the scoping rules of GLSL, in particular: “A function’s parameter declarations and body together form a single scope nested in the global scope.”
A program like this will now be rejected:
void func(int var) {
int var;
}
error: 2: symbol 'var' was already defined
int var;
^^^^^^^
SkFont::getTypeface() will no longer return a nullptr to indicate “the default typeface”. If left unspecified, SkFonts will use an empty typeface (e.g. no glyphs).
SkFontMgr::RefDefault() has been deleted. Clients should instantiate and manage their own SkFontMgrs and use them to explicitly create SkTypefaces
GrGLMakeNativeInterface has been deprecated and will eventually be removed. Clients should be calling the precise factory (e.g. GrGLInterfaces::makeGLX) they need. Some APIs that currently allow a nullptr GrGLInterface will be stop allowing this (e.g. GrDirectContexts::MakeGL).
SkFontArguments::Palette::Override's index member is changing from an int type to uint16_t to make the size exact and remove an unneeded signedness. This avoids platform/compiler-specific size ambiguiity and more closely matches the OpenType CPAL table.
SkFontConfigInterface::makeTypeface now has a required sk_sp<SkFontMgr> parameter to be used for parsing the font data from the stream.
skgpu::graphite::ContextOptions has a new field, fNeverYieldToWebGPU. This new option is only valid with the Dawn backend. It indicates that skgpu::graphite::Context should never yield to Dawn. In native this means wgpu::Device::Tick() is never called. In Emscripten it means Context never yields to the main thread event loop.
When the option is enabled, skgpu::SyncToCpu::kYes is ignored when passed to Context::submit(). Moreover, it is a fatal error to have submitted but unfinished GPU work before deleting Context. A new method, hasUnfinishedGpuWork() is added to Context that can be used to test this condition.
The intent of this option is to be able to use Graphite in WASM without requiring Asyncify.
Deprecated GrMipmapped and GrMipMapped alias have been removed in favor of skgpu::Mipmapped.
Harfbuzz-backed SkShaper instances will no longer treat a null SkFontMgr as meaning “use the default SkFontMgr for fallback” and instead will not do fallback for glyphs missing from a font.
GrBackendSemaphore::initVk and GrBackendSemaphore::vkSemaphore have been replaced with GrBackendSemaphores::MakeVk and GrBackendSemaphores::GetVkSemaphore, defined in include/gpu/ganesh/vk/GrVkBackendSemaphore.h
The Vulkan-specific methods and constructor of MutableTextureState have been deprecated in favor of those found in include/gpu/vk/VulkanMutableTextureState.h.
SkBase64.h has been removed from the public API.
SkFont::refTypefaceOrDefault and SkFont::getTypefaceOrDefault() have been removed from the public API.
GrBackendSemaphore::initGL and GrBackendSemaphore::glSync have been removed from the public API.
For Graphite, SkImages::AdoptTextureFrom has been renamed to SkImages::WrapTexture to better reflect what is happening to the passed in texture.
GrSurfaceInfo.h has been removed from the public API.
SkMesh now allows shaders, color filters, and blenders to be used in the mesh-fragment program. Pass in effects using the children parameter of SkMesh::Make or SkMesh::MakeIndexed. For a working example, see gm/mesh.cpp.
The behavior for SkPicture deserialization (via SkReadBuffer) to fallback to SkImages::DeferredFromEncodedData when SkDeserialImageProc is not set or returns null is deprecated and will be removed shortly.
SkDeserialImageFromDataProc has been added to SkDeserialProcs to allow clients to safely avoid a copy when decoding image data in SkPictures.
SkDeserialImageProc now takes in an optional AlphaType which can be used to override the AlphaType that an image was serialized with, if desired.
skgpu::graphite::RecorderOptions::kDefaultRecorderBudget is now a static data member.
SkTypeface::MakeFromName, SkTypeface::MakeFromFile, SkTypeface::MakeFromStream, and SkTypeface::MakeFromData are deprecated and will be removed eventually. These should be replaced with calls directly to the SkFontMgr that can provide the appropriate typefaces.
SkTypeface::MakeDefault() has been deprecated. Soon it will return an empty typeface and eventually be removed.
SkTypeface::UniqueID() has been removed - clients should use the method instead of this static function.
GrDirectContext::MakeVulkan... has been moved to GrDirectContexts::MakeVulkan... which are defined in include/gpu/ganesh/vk/GrVkDirectContext.h
The various GPU wait calls on GrDirectContext, SkSurface, and GrVkSecondaryCBContext which take a client supplied semaphore, now only guarantee to block the gpu transfer and fragment stages instead of all gpu commands. This shouldn't affect any client since client provided gpu resources (e.g. textures) are only ever used by Skia in the fragment stages.
Added new SkImageFilters::Crop(SkRect, SkTileMode, sk_sp<SkImageFilter>) image filter effect that crops the output from the wrapped SkImageFilter and optionally applies the SkTileMode when sampling outside of the crop rect.
GrDirectContext::MakeGL... has been moved to GrDirectContexts::MakeGL... which are defined in include/gpu/ganesh/gl/GrGLDirectContext.h
GrDirectContext::submit and GrDirectContext::flushAndSubmit calls now take a GrSyncCpu enum instead of a error-prone boolean.
Similarly, calls to GrDirectContext::performDeferredCleanup and GrDirectContext::purgeUnlockedResources take a GrPurgeResourceOptions enum.
SkMeshSpecification no longer rejects fragment programs which include uniform shader, uniform colorFilter or uniform blender. However, SkMesh::Make will not allow the mesh specification to be used.
SkMesh::Make and SkMesh::MakeIndexed now require a span of child effects as a new parameter. This functionality is still a work in progress; for now, always pass an empty span.
sksl-minify can now minify SkMesh programs. Pass --meshvert or --meshfrag to indicate that the input program is an SkMesh vertex or fragment program. When minifying a mesh program, you must supply struct Varyings and struct Attributes which correspond to the SkMeshSpecification; these will be eliminated from the minified output.
SkMergePathEffect, SkMatrixPathEffect, SkStrokePathEffect, and SkStrokeAndFillPathEffect have been removed from the public API. These effects can be implemented on the SkPath objects directly using other means and clients will likely find performance boosts by doing so.
SkShadowFlags are now visible in include/utils/SkShadowUtils.h
SkPictures no longer serialize SkImages to PNG encoded data by default. Clients who wish to preserve this should make use of SkSerialProcs, specifically the fImageProc field.
GrDirectContext::flush variants now expect a SkSurface pointer only, not an sk_sp.
SkImage::makeWithFilter has been deprecated. It has been replaced with three factory functions:
Ganesh: SkImages::MakeWithFilter(GrRecordingContext*, ...); -- declared in SkImageGanesh.h
Graphite: SkImages::MakeWithFilter(skgpu::graphite::Recorder*, ...); -- declared in Image.h
Raster: SkImages::MakeWithFilter(...); -- declared in SkImage.h
The new factories require the associated backend context object be valid. For example, the Graphite version will return nullptr if it isn't supplied with a Recorder object.
SkSL and Runtime Effects are no longer optional features of Skia; they are always available. The GN flag skia_enable_sksl has been removed.
SkSL will now properly reject sequence-expressions containing arrays, or sequence-expressions containing structures of arrays. Previously, the left-side expression of a sequence was checked, but the right-side was not. In GLSL ES 1.0, and therefore in SkSL, the only operator which is allowed to operate on arrays is the array subscript operator ([]).
The Dawn backend for Ganesh has been removed. Dawn will continue to be supported in the Graphite backend.
We plan to remove SkTime.h from the public API. As of now, SkAutoTime has been deleted as it was unused.
Vulkan-specific calls are being removed from GrBackendSurface.h. Clients should use the equivalents found in include/gpu/ganesh/vk/GrVkBackendSurface.h"
SkGraphics::AllowJIT() has been removed. It was previously deprecated (and did nothing).
New methods are added to SkImage, SkSurface, and skgpu::graphite::context named asyncRescaleAndReadPixeksYUVA420. These function identically to the existing asyncRescaleAndReadPixelsYUV420 methods but return a fourth plane containing alpha at full resolution.
SkAutoGraphics was removed. This was a helper struct that simply called SkGraphics::Init. Any instance of SkAutoGraphics can be replaced with a call to SkGraphics::Init.
SkCanvas::flush() has been removed. It can be replaced with:
if (auto dContext = GrAsDirectContext(canvas->recordingContext())) {
dContext->flushAndSubmit();
}
SkCanvas::recordingContext() and SkCanvas::recorder() are now const. They were implicitly const but are now declared to be such.
SkCanvas::recordingContext() and SkCanvas::recorder() are now const. They were implicitly const but are now declared to be such.
SkMesh::MakeIndexBuffer, SkMesh::CopyIndexBuffer, SkMesh::MakeVertexBuffer, and SkMesh::CopyVertexBuffer have been moved to the SkMeshes namespace. Ganesh-specific versions have been created in include/gpu/ganesh/SkMeshGanesh.h.
SkPath now enforces an upper limit of 715 million path verbs.
SkRuntimeEffectBuilder::uniforms(), SkRuntimeEffectBuilder::children(), SkRuntimeShaderBuilder::makeShader(), SkRuntimeColorFilterBuilder::makeColorFilter(), and SkRuntimeBlendBuilder::makeBlender() are now marked as const. No functional changes internally, just making explicit what had been implicit.
SkRuntimeEffect::makeImage and SkRuntimeShaderBuilder::makeImage have been removed.
GL-specific calls have been removed from GrBackendSurface.h. Clients should use the equivalents found in include/gpu/ganesh/gl/GrGLBackendSurface.h
A new SkTiledImageUtils namespace (in SkTiledImageUtils.h) provides DrawImage and DrawImageRect methods that directly mirror SkCanvas' drawImage and drawImageRect calls.
The new entry points will breakup large SkBitmap-backed SkImages into tiles and draw them if they would be too large to upload to the gpu as one texture.
They will fall through to their SkCanvas correlates if tiling isn't needed or possible.
SkPromiseImageTexture has been removed from the public API, as well as SkImages::PromiseTextureFrom and SkImages::PromiseTextureFromYUVA, public consumers of that data type.
SkDeferredDisplayList, SkDeferredDisplayListRecorder, and SkSurfaceCharacterization have been removed from the public API.
The intermediate color computed by SkBlenders::Arithmetic is now always clamped to between 0 and 1 (inclusive), and then enforcePremul is applied when that parameter is true.
Added a new public type, SkColorTable, to own the lookup tables passed into SkColorFilters::Table, which allows clients and the returned SkColorFilter to share the table memory instead of having to duplicate it in any wrapper types that lazily create Skia representations.
The deprecated SkImageFilters::Magnifier factory that did not take a lens bounds parameter has been removed.
SkImageFilters::RuntimeShader has variations that take a maximum sample radius, which is used to provide padded input images to the runtime effect so that boundary conditions are avoided.
SkImageFilters::AlphaThreshold has been removed. Its only use was in ChromeOS and that usage has been replaced with a Blend(kSrcIn, input, Picture(region)) filter graph to achieve the same effect.
The single-argument SkImageFilters::Image(sk_sp<SkImage>) factory is removed. The SkSamplingOptions to use when rendering the image during filtering must be provided. SkFilterMode::kLinear is recommended over the previous bicubic default.
GrTextureGenerator now has a subclass GrExternalTextureGenerator which can be subclassed by clients and used with SkImages::DeferredFromTextureGenerator in order to create images from textures that were created outside of skia. GrTextureGenerator has been removed from the public API in favor of GrExternalTextureGenerator.
SkPoint now uses float for its coordinates. This starts the process of removing SkScalar from Skia. SkScalar was a typedef for float, so this has no practical impact on code that uses Skia.
SkSamplingOptions(SkFilterMode) and SkSamplingOptions(SkCubicResampler) are no longer marked explicit so that samplings can be created inline more succinctly.
SkShaders is now a namespace (was previously a non-constructable class with only static functions). SkPerlinNoiseShader::MakeFractalNoise and SkPerlinNoiseShader::MakeTurbulence have been moved to the SkShaders namespace and SkPerlinNoiseShader (the public non-constructable class) has been slated for moving into private internals of Skia. There are no functional differences in the moved functions, however the change of some #includes in include/core/SkShader.h, include/effects/SkGradientShader.h, and include/effects/SkPerlinNoiseShader.h may cause clients who were depending on the transitive dependencies to now fail to compile.
The following methods have been removed from SkSurface and relocated to other methods/functions:
SkSurface::asImage -> SkSurfaces::AsImage (include/gpu/graphite/Surface.h)SkSurface::flushAndSubmit -> GrDirectContext::flushAndSubmitSkSurface::flush -> GrDirectContext::flushSkSurface::makeImageCopy -> SkSurfaces::AsImageCopy (include/gpu/graphite/Surface.h)SkSurface::resolveMSAA -> SkSurfaces::ResolveMSAA() (include/gpu/ganesh/SkSurfaceGanesh.h)Additionally, SkSurface::BackendSurfaceAccess is now in the SkSurfaces namespace.
The deprecated SkTableColorFilter class and its methods have been removed. Clients should use SkColorFilters::Table and SkColorFilters::TableARGB (defined in include/core/SkColorFilter.h).
The SkYUVAPixmapInfo::SupportedDataTypes(const GrImageContext&) constructor has been removed from the public API.
Clients now need to register codecs which Skia should use to decode raw bytes. For example: SkCodecs::Register(SkJpegDecoder::Decoder());. Skia still provides many supported formats (see include/codec/*Decoder.h). Clients are free to specify their own, either supplementing the existing set or using a custom version instead of the one previously provided by default by Skia. See SkCodecs::Decoder for the necessary data to provide when using a custom decoder (in include/codec/SkCodec.h).
To ease the transition, Skia will continue (for a short while) to register codecs unless SK_DISABLE_LEGACY_INIT_DECODERS is defined.
SkDrawable::newPictureSnapshot is removed. Instead, call SkDrawable::makePictureSnapshot. The old method returned a bare (but ref-counted) pointer, which was easy for clients to get wrong. The new method returns an sk_sp<SkPicture>, which is easier to handle, and consistent with the rest of skia.
SkGraphics::PurgePinnedFontCache() has been added to allow clients to explicitly trigger SkStrikeCache purge checks for SkStrikes with pinners. Defining SK_STRIKE_CACHE_DOESNT_AUTO_CHECK_PINNERS in the user configuration now disables automatic purge checking of strikes with pinners.
The following SkImage factories have been moved to include/gpu/graphite/Image.h:
SkImage::MakeGraphiteFromBackendTexture -> SkImages::AdoptTextureFromSkImage::MakeGraphiteFromYUVABackendTextures -> SkImages::TextureFromYUVATexturesSkImage::MakeGraphiteFromYUVAPixmaps -> SkImages::TextureFromYUVAPixmapsSkImage::MakeGraphitePromiseTexture -> SkImages::PromiseTextureFromThe SkImage method makeTextureImage has been moved to SkImages::TextureFromImage.
SkImage::RequiredImageProperties has been renamed to SkImage::RequiredProperties, with fMipmapped turned into a boolean instead of the GPU enum.
SkImage::makeColorSpace and SkImage::makeColorTypeAndColorSpace now take a GrDirectContext as the first parameter. This should be supplied when dealing with texture-backed images and can be nullptr otherwise.
SkImage::subset now takes a GrDirectContext* as its first parameter (this can be nullptr for non-gpu backed images. Images which are backed by a codec or picture will not be turned into a GPU texture before being read. This should only impact picture-backed images, which may not be read correctly if the picture contain nested texture-backed images itself. To force a conversion to a texture, clients should call SkImages::TextureFromImage, passing in the image, and then call subset on the result. Documentation has been clarified that SkImage::subset will return a raster- backed image if the source is not backed by a texture, and texture-otherwise.
SkImages::SubsetTextureFrom has been added to subset an image and explicitly return a texture- backed image. This allows some optimizations, especially for large images that exceed a maximum texture size of a GPU.
SkImage::makeRasterImage and SkImage::makeNonTextureImage now take a GrDirectContext* which clients should supply for reading-back pixels from texture-backed images.
SkImageFilters::Image now returns a non-null image filter if the input sk_sp<SkImage> is null or the src rectangle is empty or does not overlap the image. The returned filter evaluates to transparent black, which is equivalent to a null or empty image. Previously, returning a null image filter would mean that the dynamic source image could be surprisingly injected into the filter evaluation where it might not have been intended.
SkImageFilters::Magnifier(srcRect, inset) is deprecated. These parameters do not provide enough information for the implementation to correctly respond to canvas transform or participate accurately in layer bounds planning.
A new SkImageFilters::Magnifier function is added that takes additional parameters: the outer lens bounds and the actual zoom amount (instead of inconsistently reconstructing the target zoom amount, which was the prior behavior). Additionally, the new factory accepts an SkSamplingOptions to control the sampling quality.
SkImageFilters::Picture now returns a non-null image filter if the input sk_sp<SkPicture> is null. The returned filter evaluates to transparent black, which is equivalent to a null or empty picture. Previously, returning a null image filter would mean that the dynamic source image could be surprisingly injected into the filter evaluation where it might not have been intended.
SkImageFilters::Shader now returns a non-null image filter if the input sk_sp<SkShader> is null. The returned filter evaluates to transparent black, which is equivalent to a null or empty shader. Previously, returning a null image filter would mean that the dynamic source image could be surprisingly injected into the filter evaluation where it might not have been intended.
SkImageGenerator::MakeFromEncoded has been removed from the public API. SkImage::DeferredFromEncoded or SkCodec::MakeFromData should be used instead.
SkSurface::getBackendTexture and SkSurface::getBackendRenderTarget have been deprecated and replaced with SkSurfaces::GetBackendTexture and SkSurfaces::GetBackendRenderTarget respectively. These are found in include/gpu/ganesh/SkSurfaceGanesh.h. The supporting enum BackendHandleAccess has also been moved to SkSurfaces::BackendHandleAccess as an enum class, with shorter member names.
SkSurface factory methods have been moved to the SkSurfaces namespace. Many have been renamed to be more succinct or self-consistent. Factory methods specific to the Ganesh GPU backend are defined publicly in include/gpu/ganesh/SkSurfaceGanesh.h. The Metal Ganesh backend has some specific factories in include/gpu/ganesh/mtl/SkSurfaceMetal.h.
SkGradientShader::Interpolation struct to the shader factory functions. The color space and hue method options are based on the CSS Color Level 4 specfication:SkImages::GetBackendTextureFromImage has been renamed SkImages::MakeBackendTextureFromImage.SkImage::getBackendTexture() has been moved to SkImages::GetBackendTextureFromImage() in SkImageGanesh.h.SkImage::makeTextureImage() has been moved to SkImages::TextureFromImage() in SkImageGanesh.h.SkImage::flush() and SkImage::flushAndSubmit() has been moved to GrDirectContext::flush() and GrDirectContext::flushAndSubmit() in SkImageGanesh.h.SkSurfaceProperties::kAlwaysDither_Flag added to globally enable dithering for a specific SkSurface target.SkSerialImageProc and SkDeserialImageProc are now also used to encode/decode the SkMipmap layers of certain SkImages.SK_USE_WIC_ENCODER and SK_USE_CG_ENCODER have been removed, as well as the code to use the Windows Image Codecs and Core Graphics as a way to have Skia encode files in PNG, JPEG, and WEBP format. Skia continues to support use of the NDK codecs on Android, as well as using external C++ libraries (e.g. libpng, libjpeg-turbo) to encode images. WIC and CG are still used to decode images on the appropriate platforms.SkImage::encodeToData has been deprecated. Clients should use refEncodedData if the image was from an encoded bytestream or one of SkPngEncoder::Encode, SkJpegEncoder::Encode, SkWebpEncoder::Encode directly.SK_ENCODE_PNG -> skia_use_libjpeg_turbo_encodeSK_ENCODE_JPEG -> skia_use_libpng_encodeSK_ENCODE_WEBP -> skia_use_libwebp_encode Other clients should make sure the appropriate *EncoderImpl.cpp files from src/encode are included in the build.SkImageEncoder has been removed. Clients should use one of SkPngEncoder::Encode, SkJpegEncoder::Encode or SkWebpEncoder::Encode directly.SkImageGenerator has a new subclass GrTextureGenerator which can be used if clients want to provide specialized ways of making Ganesh texture-backed Images.SkImageGenerator::MakeFromPicture has been removed from the public API. Clients should be drawing the picture directly instead of turning it into an image first.SkImage::CompressionType has been renamed to SkTextureCompressionType and moved to include/core/SkTextureCompressionType.hSkEncodedImageFormat.h and SkPngChunkReader.h are now in include/codecSkICC.h is now in include/encodeskia-minify output-file.sksl input-file.sksl to write a minified version of the runtime shader “input-file.sksl” into a file named “output-file.sksl”. By default, sksl-minify expects a shader, but you can also pass command line options --colorfilter or --blender if your program is a color-filter or a blender. A compile error will be printed to stdout if an error is found in the program.half4 main(float2 coords, half4 color). This was disallowed at Milestone 87, but the restriction was inadvertently relaxed in later milestones. Going forward, we will only accept a shader signature of half4 main(float2 coords).makeShader functions associated with SkRuntimeEffect no longer take an isOpaque parameter. These functions will now make a best effort to determine if your shader always produces opaque output, and optimize accordingly. If you definitely want your shader to produce opaque output, do so in the shader's SkSL code. This can be done by adjusting any return statement in your shader with a swizzle: return color.rgb1;. https://review.skia.org/506462toLinearSrgb converts a color to the sRGB color gamut, with a linear transfer function. fromLinearSrgb converts a color from that same color space. These are helpful for effects that need to work in a specific color space, or want to apply effects (like lighting) that work best in a linear color space. Note that if the destination surface has no color space (color space is nullptr), these intrinsics will do no conversion, and return the input color unchanged. https://review.skia.org/481416Metal backend has been changed to track command buffer resources manually rather than using retained resources. https://review.skia.org/432878
Added virtual onResetClip() to SkCanvas for Android Framework, to emulate the soon-to-be-removed expanding clip ops guarded by SK_SUPPORT_DEPRECATED_CLIPOPS. https://review.skia.org/430897
Removed SK_SUPPORT_DEPRECATED_CLIPOPS build flag. Clips can only be intersect and difference. https://review.skia.org/436565
There is a new syntax for invoking (sampling) child effects in SkSL. Previously, children (shaders, colorFilters, blenders) were invoked using different overloads of sample. That syntax is deprecated (but still supported). Now, the child behaves like an object, with a method name eval. The arguments to these eval methods are the same as the arguments in the old sample intrinsics. For example: // Old syntax: sample(shader, xy) sample(colorFilter, color) sample(blender, srcColor, dstColor) // New syntax: shader.eval(xy) colorFilter.eval(color) blender.eval(srcColor, dstColor) https://review.skia.org/444735
Removed SkPaint::getHash https://review.skia.org/419336
Removed SkShaders::Lerp. It was unused (and easy to replicate with SkRuntimeEffect). https://review.skia.org/419796
The default value of GrContextOptions::fReduceOpsTaskSplitting is now enabled. https://review.skia.org/419836
Removed SkMatrix44
Hides SkPathEffect::computeFastBounds() from public API; external subclasses of SkPathEffect must implement onComputeFastBounds() but can return false to signal it's not computable. https://review.skia.org/406140
Add SkM44::RectToRect constructor (SkM44's equivalent to SkMatrix::RectToRect) https://review.skia.org/402957
Metal support has been removed for versions of iOS older than 10.0 and MacOS older than 10.14. https://review.skia.org/401816
Removed custom attributes from SkVertices and the corresponding varying feature from SkRuntimeEffect. https://review.skia.org/398222
Dropped support for mixed samples. Mixed samples is no longer relevant for Ganesh. DMSAA and the new Ganesh architecture both rely on full MSAA, and any platform where mixed samples is supported will ultimately not use the old architecture.
SkRuntimeEffect::Make has been removed. It is replaced by MakeForShader and MakeForColorFilter. These functions do stricter error checking on the SkSL, to ensure it is valid for a particular stage of the Skia pipeline. https://review.skia.org/402156
The SkSL DSL API has been moved into public headers, although it is still under active development and isn't quite ready for prime time yet. https://review.skia.org/378496
Skia's GPU backend no longer supports NVPR. Our more recent path renderers are more performant and are not limited to nVidia hardware.
SkRuntimeEffect now supports uniforms of type int, int2, int3, and int4. Per the OpenGL ES Shading Language Version 1.00 specification, there are few guarantees about the representation or range of integral types, and operations that assume integral representation (eg, bitwise), are not supported. https://review.skia.org/391856
SkRuntimeEffect requires that ‘shader’ variables be declared as ‘uniform’. The deprecated syntax of ‘in shader’ is no longer supported. https://review.skia.org/393081
Renamed use of sk_cf_obj in external Metal types to sk_cfp. https://review.skia.org/372556
GrDirectContext::ComputeImageSize() is removed. Use SkImage::textureSize() instead. https://review.skia.org/368621 https://review.skia.org/369317 https://review.skia.org/371958
Remove SkImageFilter::MakeMatrixFilter as it was unused and replaced with SkImageFilters::MatrixTransform. https://review.skia.org/366318
Refactored particle system to use a single code string containing both Effect and Particle code. Uniform APIs are now shared for all program entry points, and no longer prefixed with ‘Effect’ or ‘Particle’. For example, instead of SkParticleEffect::effectUniformInfo and SkParticleEffect::particleUniformInfo, there is just SkParticleEffect::uniformInfo.
Remove SkImageFilter::CropRect from the public API as it's no longer usable. All factories work with ‘SkRect’, ‘SkIRect’, or nullable pointers to ‘Sk[I]Rect’. https://review.skia.org/361496
Remove deprecated SkImageFilter factory functions and supporting types. All default-provided SkImageFilters are now only constructed via ‘include/effects/SkImageFilters.h’ https://review.skia.org/357285
Added SkRuntimeEffect::makeImage() to capture the output of an SkRuntimeEffect in an SkImage. https://review.skia.org/357284
Updated SkRuntimeEffect::Make() to take an Options struct. It also now returns a Results struct instead of a tuple. https://review.skia.org/363785 https://review.skia.org/367060
Changed SkRuntimeEffect::Varying to have lower-case member names, with no ‘f’ prefix. https://review.skia.org/365656
Changed SkRuntimeEffect::Uniform to have lower-case member names, with no ‘f’ prefix. https://review.skia.org/365696
Deprecate (and ignore) SkAndroidCodec::ExifOrientation https://review.skia.org/344763
Fix several minor issues in lighting image filters:
SkDeferredDisplayListRecorder::makePromiseTexture has moved to SkImage::MakePromiseTexture. New code should use the new entry point – migration CLs will be coming soon. https://review.skia.org/373716
Removed SkYUVAIndex and SkYUVASizeInfo. These were no longer used in any public APIs. https://review.skia.org/352497
Numerous changes to SkRuntimeEffect, aligning the capabilities and restrictions with The OpenGL ES Shading Language 1.00 (aka, the shading language of OpenGL ES2 and WebGL 1.0). All built-in functions from sections 8.1 through 8.6 implemented & tested on all backends. Removed types and features that require newer versions of GLSL: https://review.skia.org/346657 [Non-square matrices] https://review.skia.org/347046 [uint, short, ushort, byte, ubyte] https://review.skia.org/349056 [while and do-while loops] https://review.skia.org/350030 [Bitwise operators and integer remainder]
Add SkShadowUtils::GetLocalBounds. Generates bounding box for shadows relative to path. https://review.skia.org/351922
Removed SkPerlinNoiseShader::MakeImprovedNoise. https://review.skia.org/352057
Removed deprecated version of MakeFromYUVATextures. Use the version that takes GrYUVABackendTextures instead. https://review.skia.org/345174
SkAnimatedImage: Always respect exif orientation Replace SkPixmapPriv::ShouldSwapWidthHeight with SkEncodedOriginSwapsWidthHeight. https://review.skia.org/344762
Add kDirectionalLight_ShadowFlag support. If enabled, light position represents a vector pointing towards the light, and light radius is blur radius at elevation 1. https://review.skia.org/321792
Support GL_LUMINANCE8_ALPHA8 textures. These can be used with GrBackendTexture APIs on GrDirectContext and as planes of YUVA images via GrYUVABackendTextures. https://review.skia.org/344761
Removed previously deprecated SkImage::MakeFromYUVATexturesCopyToExternal. https://review.skia.org/342077
Add versions of GrDirectContext::createBackendTexture and updateBackendTexture that take a GrSurfaceOrigin. The previous versions are deprecated. https://review.skia.org/341005
Remove support for deprecated kDontClipToLayer_SaveLayerFlag in SkCanvas::SaveLayerRec https://review.skia.org/339988
Expose more info in SkCodec::FrameInfo https://review.skia.org/339857
Added dither control to the SkImageFilters::Shader factory. https://review.skia.org/338156
Add MTLBinaryArchive parameter to GrMtlBackendContext. This allows Skia to cache PipelineStates in the given archive for faster shader compiles on future runs. The client must handle loading and saving of the archive. https://review.skia.org/333758
Deprecated enum SkYUVAInfo::PlanarConfig has been removed. https://review.skia.org/334161
Deprecated SkImage factories have been removed from SkDeferredDisplayListRecorder.
The following YUV image factories have been removed: SkImage::MakeFromYUVTexturesCopyWithExternalBackend SkImage::MakeFromNV12TexturesCopyWithExternalBackend Replacement pattern outlined below. 1) Make image using MakeFromYUVATextures 2) Make a SkSurface around result texture using SkSurface::MakeFromBackendTexture 3) surface->getCanvas()->drawImage(image, 0, 0); 4) surface->flushAndSubmit() 5) Optional: SkImage::MakeFromBackendTexture() to use as SkImage. https://review.skia.org/334596
Added a new interface for GrDirectContext creation in Metal, using a new struct called GrMtlBackendContext. The previous interface taking a MTLDevice and MTLCommandQueue is deprecated. https://review.skia.org/334426
SkCanvas::flush has been deprecated.
SkYUVAInfo now has separate enums for division of channels among planes and the subsampling. The previous combined enum, PlanarConfig, is deprecated. https://review.skia.org/334102
Simplified SkDeferredDisplayListRecorder promise image API. Removed “release” callback and renamed “done” callback to “release”. The new “release” proc can be null. Added a new SkYUVAInfo-based factory for YUVA promise texture images and deprecated the old SkYUVAIndex-based one. https://review.skia.org/331836 https://review.skia.org/333519
Limit the types and intrinsics supported in SkRuntimeEffect to GLSL ES 1.00 https://review.skia.org/332597
Add AVIF support to SkHeifCodec.
Add support for creating SkSurfaceCharacterizations directly for use by a GrVkSecondaryCBDrawContext. https://review.skia.org/331877
Removed SkSurfaceProps::kLegacyFontHost_InitType, SkFontLCDConfig, and related code. The default pixel geometry for SkSurfaceProps is now kUnknown instead of kRGB_H. The removal was guarded by the SK_LEGACY_SURFACE_PROPS build flag which was later removed. https://review.skia.org/322490 https://review.skia.org/329364
Legacy 8-bit YUV interface removed from SkImageGenerator. Use more flexible SkYUVAPixmaps- based interface instead. https://review.skia.org/327917
New variant of SkImage::MakeFromYUVATextures. Takes a new type GrYUVATextures which wraps an SkYUVAInfo and compatible set of GrBackendTextures. The provides a more complete and structured specification of the planar configuration. Previous version is deprecated. Already deprecated MakeFromYUVATexturesCopyToExternal added to replace other deprecated APIs. It's not recommended that clients use this and instead use the pattern described in the API comment. https://review.skia.org/317762 https://review.skia.org/329956
Add field to GrContextOptions to disable mipmap support even if the backend supports it.
SkTPin() removed from public API.
Add new SkImageFilters::Blend factory function, in place of the now deprecated SkImageFilters::Xfermode factory function. Behavior is identical, but name better matches conventions in SkShader and SkColorFilter. https://review.skia.org/324623
SkImageFilters::Foo() factory functions now accept SkIRect, SkRect, and optional SkIRect* or SkRect*, instead of previously just the optional SkIRect*. Internally, the crop rects are stored as floats to allow for fractional crops to be defined in the local coordinate system (before transformation by the canvas matrix). https://review.skia.org/324622
Add new SkImageFilters::Shader factory and deprecate SkImageFilters::Paint factory. All supported/valid Paint() filters can be represented more cleanly as a Shader image filter. https://review.skia.org/323680
GrContext has been replaced by two separate classes: GrDirectContext which is the traditional notion of GrContext, and GrRecordingContext which is a context that is recording an SkDeferredDisplayList and therefore has reduced functionality. Unless you are using SkDeferredDisplayList, migrate directly to GrDirectContext in all cases.
CPU sync bool added to SkSurface::flushAndSubmit() and GrContext::flushAndSubmit()
Removed legacy variant of SkImage::MakeFromYUVAPixmaps. Use the version that takes SkYUVAPixmaps instead. It has a more structured description of the planar configuration. https://review.skia.org/322480
Some SkImage YUV image factories have been removed. Replacement patterns outlined below. SkImage::MakeFromYUVATexturesCopy 1) Make SkImage from YUVA planes using SkImage::MakeFromYUVATextures 2) Use Skia to allocate a surface using SkSurface::MakeRenderTarget 3) surface->getCanvas()->drawImage(image, 0, 0); 4) surface->makeImageSnapShot() produces RGBA image. SkImage::MakeFromYUVATexturesCopyWithExternalBackend 1) Make image using MakeFromYUVATextures 2) Make a SkSurface around result texture using SkSurface::MakeFromBackendTexture 3) surface->getCanvas()->drawImage(image, 0, 0); 4) surface->flushAndSubmit() 5) Optional: SkImage::MakeFromBackendTexture() to use as SkImage. SkImage::MakeFromNV12TexturesCopy Same as SkImage::MakeFromYUVATexturesCopy https://review.skia.org/321537
GrBackendRenderTargets which are created with a stencilBits param, now require the stencilBits to be 0, 8, or 16. https://review.skia.org/321545
GrVkImageInfo now has a field for sample count. GrBackendRenderTarget constructor that took both a GrVkImageInfo and separate sample count is deprecated. Use the version without sample count instead. Similarly, GrD3DTextureResourceInfo now has a sample count field and GrBackendRenderTarget no longer takes a separate sample count for Direct3D. The sample count for GrBackendRenderTarget is now directly queried from MtlTexture rather than passed separately. The version that takes a separate sample count is deprecated and the parameter is ignored. https://review.skia.org/320262 https://review.skia.org/320757 https://review.skia.org/320956
Added deprecation warning for Metal support on MacOS 10.13, iOS 8.3, and older. https://review.skia.org/320260
GrVkImageInfo now has a field for sample count. GrBackendRenderTarget constructor that took both a GrVkImageInfo and separate sample count is deprecated. Use the version without sample count instead.
Update SkClipOp::kMax_EnumValue to include only intersect and difference when SK_SUPPORT_DEPRECATED_CLIPOPS is not defined. https://review.skia.org/320064
Add support for external allocator for Direct3D 12 backend. Defines base classes for an allocation associated with a backend texture and a a memory allocator to create such allocations. Adds memory allocator to backend context. https://review.skia.org/317243
Add new optional parameter to GrContext::setBackend[Texture/RenderTarget]State which can be used to return the previous GrBackendSurfaceMutableState before the requested change. https://review.skia.org/318698
New optimized clip stack for GPU backends. Enabled by default but old behavior based on SkClipStack can be restored by defining SK_DISABLE_NEW_GR_CLIP_STACK when building. It is not compatible with SK_SUPPORT_DEPRECATED_CLIPOPS and we are targeting the removal of support for the deprecated, expanding clip ops. https://review.skia.org/317209
GPU backends now properly honor the SkFilterQuality when calling drawAtlas. https://review.skia.org/313081
The signature of ‘main’ used with SkRuntimeEffect SkSL has changed. There is no longer an ‘inout half4 color’ parameter, effects must return their color instead. Valid signatures are now ‘half4 main()’ or ‘half4 main(float2 coord)’. https://review.skia.org/310756
New YUVA planar specifications for SkCodec, SkImageGenerator, SkImage::MakeFromYUVAPixmaps. Chroma subsampling is specified in more structured way. SkCodec and SkImageGenerator don't assume 3 planes with 8bit planar values. Old APIs are deprecated. https://review.skia.org/309658 https://review.skia.org/312886 https://review.skia.org/314276 https://review.skia.org/316837 https://review.skia.org/317097
Added VkImageUsageFlags to GrVkImageInfo struct.
Remove support for ‘in’ variables from SkRuntimeEffect. API now exclusively refers to inputs as ‘uniforms’. https://review.skia.org/309050
Add SkImageGeneratorNDK and SkEncodeImageWithNDK for using Android's NDK APIs to decode and encode. https://review.skia.org/308185 https://review.skia.org/308800
SkImage:remove DecodeToRaster, DecodeToTexture https://review.skia.org/306331
Add GrContext api to update compressed backend textures. https://review.skia.org/302265
Rename GrMipMapped to GrMipmapped for consistency with new APIs. Also rename GrBackendTexture::hasMipMaps() to GrBackendTexture::hasMipmaps() https://review.skia.org/304576 https://review.skia.org/304598
Add option for clients to own semaphores after wait calls. https://review.skia.org/301216
Remove obsolete GrFlushFlags. https://review.skia.org/298818
Adds default flush() calls to SkSurface, SkImage, and GrContext. These calls do a basic flush without a submit. If you haven't updated Skia in a couple releases and still have flush() calls in your code that you expect to do a flush and submit, you should update all those to the previously added flushAndSubmit() calls instead. https://review.skia.org/299141
Enable BackendSemaphores for the Direct3D backend. https://review.skia.org/298752
Added SkImage:asyncRescaleAndReadPixels and SkImage::asyncRescaleAndReadPixelsYUV420 https://review.skia.org/299281
Ganesh is moving towards replacing GrContext with the GrDirectContext/GrRecordingContext pair. GrDirectContexts have direct access to the GPU and are very similar to the old GrContext. GrRecordingContexts are less powerful contexts that lack GPU access but provided context-like utilities during DDL recording. SkSurfaces and SkCanvas will now only return GrRecordingContexts. Clients requiring context features that need GPU access can then check (via GrRecordingContext::asDirectContext) if the available recording context is actually a direct context.
Replace #defined values in SkString with equivalent constexprs. http://review.skia.org/306160
Added GrContext::oomed() which reports whether Skia has seen a GL_OUT_OF_MEMORY error from Open GL [ES] or VK_ERROR_OUT_OF_*_MEMORY from Vulkan. https://review.skia.org/298216
Add option on SkSurface::flush to pass in a GrBackendSurfaceMutableState which we will set the gpu backend surface to be at the end of the flush. https://review.skia.org/295567
Add GrContext function to set mutable state on a backend surface. Currently this is only used for setting vulkan VkImage layout and queue family. https://review.skia.org/293844
SkSurface factores that take GrBackendTexture or GrBackendRenderTarget now always call the release proc (if provided) on failure. SkSurface::replaceBackendTexture also calls the release proc on failure. https://review.skia.org/293762
SkSurface::asyncRescaleAndReadPixels and SkSurfaceasyncRescaleAndReadPixelsYUV420 now require explicit GrContext submit to guarantee finite time before callback is invoked. https://review.skia.org/292840
Add VkSharingMode field to GrVkImageInfo. https://review.skia.org/293559
Move SkBitmapRegionDecoder into client_utils/android.
SkCanvas.clear and SkCanvas.drawColor now accept SkColor4f in addition to SkColor.
Remove SkSurface::MakeFromBackendTextureAsRenderTarget. This factory existed to work around issues with GL_TEXTURE_RECTANGLE that existed in Chrome's command buffer. Those issues have since been resolved. Use SkSurface::MakeFromBackendTexutre or SkSurface::MakeFromBackendRenderTarget instead. https://review.skia.org/292719
Adds submittedProc callback to GrFlushInfo which will be called when the work from the flush call is submitted to the GPU. This is specifically useful for knowing when semahpores sent with the flush have been submitted and can be waiting on. https://review.skia.org/291078
GrContext submit is now required to be called in order to send GPU work to the actual GPU. The flush calls simply produces 3D API specific objects that are ready to be submitted (e.g. command buffers). For the GL backend, the flush will still send commands to the driver. However, clients should still assume the must call submit which is where any glFlush that is need for sync objects will be called. There, are flushAndSubmit() functions of GrContext, SkSurface, and SkImage that will act like the previous flush() functions. This will flush the work and immediately call submit. https://review.skia.org/289033
Remove deprecated version of flush calls on GrContext and SkSurface. https://review.skia.org/2290540
SkCanvas::drawVertices and drawPatch now support mapping an SkShader without explicit texture coordinates. If they're not supplied, the local positions (vertex position or patch cubic positions) will be directly used to sample the SkShader. https://review.skia.org/290130
Add api on GrContext, updateBackendTexture that will upload new data to a GrBackendTexture. https://review.skia.org/288909
Add GrContext getter to SkSurface. https://review.skia.org/289479
Deprecate GrContext and SkSurface flush() call and replace ith with flushAndSubmit(). This only effects the default flush call that takes no parameters. https://review.skia.org/289478
GrContext::createBackendTexture functions that initialize the texture no longer guarantee that all the data has been uploaded and the gpu is done with the texture. Instead the client can assume the upload work has been submitted to the gpu and they must wait for that work to finish before deleting the texture. This can be done via their own synchronization or by passing in a finish proc into the create calls which will be called when it is safe to delete the texture (at least in terms of work done during the create). https://review.skia.org/286517
Remove unused SkMaskFilter helpers: compbine, compose Note: shadermaskfilter will likely be removed next (clipShader should serve)
Add back SkCanvas::kPreserveLCDText_SaveLayerFlag to indicate that saveLayer() will preserve LCD-text. All text in the layer must be drawn on opaque background to ensure correct rendering.
Add the new directory client_utils/ for code that is specific to a single client and should be considered separate from Skia proper. Move SkFrontBufferedStream into the subdir android/.
SkBitmap and SkPixmap‘s erase() methods now treat their color parameters consistently with the rest of Skia, with all SkColors and any untagged SkColor4fs interpreted as sRGB, not as a color in the bitmap’s color space. SkPixmap::erase(SkColor4f) now takes an SkColorSpace, so you can pass pixmap.colorSpace() if you want the old behavior.
SkCamera.h and SkMatrix44.h are DEPRECATED. Use SkM44 if you want to have 3d transformations.
Changed Dilate and Erode image filters to take SkScalar for radius instead of int. While the image filters themselves are defined in terms of discrete pixels, the radii provided by the user are mapped through the CTM so taking ints forced over discretization. After mapping through the CTM the radii are now rounded to pixels. https://review.skia.org/281731 https://review.skia.org/282636
Updated the contract of GrContext and SkSurface flush calls in regards to semaphores. Made it clear that the caller is responsible for deleting any initialized semaphores after the flush call regardless if we were able to submit them or not. Also, allows skia to only submit a subset of the requested semaphores if we failed to create some. https://review.skia.org/282265
SkCanvas::drawVertices will now always fill the triangles specified by the vertices. Previously, vertices with no colors and no (texture coordinates or shader) would be drawn in wireframe. https://review.skia.org/282043
Remove localmatrix option from SkShaders::[Blend, Lerp]
Fill out Direct3D parameters for backend textures and backend rendertargets.
SkImage::makeTextureImage() takes an optional SkBudgeted param
Made non-GL builds of GPU backend more robust. https://review.skia.org/277456
MoltenVK support removed. Use Metal backend instead. https://review.skia.org/277612
Removed drawBitmap and related functions from SkDevice; all public drawBitmap functions on SkCanvas automatically wrap the bitmap in an SkImage and call the equivalent drawImage function. Drawing mutable SkBitmaps will now incur a mandatory copy. Switch to using SkImage directly or mark the bitmap as immutable before drawing.
Removed “volatile” flag from SkVertices. All SkVertices objects are assumed to be volatile (the previous default behavior).
Removed exotic legacy bitmap functions from SkCanvas (drawBitmapLattic, drawBitmapNine); the exotic SkImage functions still exist.
Make it possible to selectively turn on/off individual encoders/decoders, using skia_use_(libpng/libjpeg_turbo/libwebp)(decode/encode).
Removed GrGpuResource, GrSurface, and GrTexture from public api. These were not meant to be public, and we now can move them into src. Also removed getTexture function from SkImage.h
Removed Bones from SkVertices
Added a field to GrContextOptions that controls whether GL errors are checked after GL calls that allocate textures, etc. It also controls checking for shader compile success, and program linking success.
Made SkDeferredDisplayList.h officially part of the public API (i.e., moved it to include/core). Also added a ProgramIterator to SkDeferredDisplayList which allows clients to pre-compile some of the shaders the DDL requires.
Added two new helper methods to SkSurfaceCharacterization: createBackendFormat and createFBO0. These make it easier for clients to create new surface characterizations that differ only a little from an existing surface characterization.
Removed SkTMax and SkTMin.
Removed SkTClamp and SkClampMax.
Removed SkScalarClampMax and SkScalarPin.
Removed SkMax32 and SkMin32.
Removed SkMaxScalar and SkMinScalar.
SkColorSetA now warns if the result is unused.
An SkImageInfo with a null SkColorSpace passed to SkCodec::getPixels() and related calls is treated as a request to do no color correction at decode time.
Add new APIs to add attributes to document structure node when creating a tagged PDF.
Remove CGFontRef parameter from SkCreateTypefaceFromCTFont. Use CTFontManagerCreateFontDescriptorFromData instead of CGFontCreateWithDataProvider to create CTFonts to avoid memory use issues.
Added SkCodec:: and SkAndroidCodec::getICCProfile for reporting the native ICC profile of an encoded image, even if it doesn't map to an SkColorSpace.
SkSurface::ReplaceBackendTexture takes ContentChangeMode as a parameter, which allow callers to specify whether retain a copy of the current content.
Enforce the existing documentation in SkCanvas::saveLayer that it ignores any mask filter on the restore SkPaint. The ‘coverage’ of a layer is ill-defined, and masking should be handled by pre-clipping or using the auxiliary clip mask image of the SaveLayerRec.
Added support for GL_NV_fence extension.
Make SkImageInfo::validRowBytes require rowBytes to be pixel aligned. This makes SkBitmap match the behavior of raster SkSurfaces in rejecting non-aligned rowBytes.
Added an SkImage::MakeRasterFromCompressed entry point. Also updated SkImage::MakeFromCompressed to decompress the compressed image data if the GPU doesn‘t support the specified compression type (i.e., macOS Metal doesn’t support BC1_RGB8_UNORM so such compressed images will always be decompressed on that platform).
Added support for BC1 RGBA compressed textures
Added CachingHint to SkImage::makeRasterImage
Added SkAnimatedImage::getCurrentFrame()
Add support to create an SkSurface from an MTKView, with delayed acquisition of the MTLDrawable. Entry point: SkSurface::MakeFromMTKView
Removed SkIRect::EmptyIRect(). Use SkIRect::MakeEmpty() instead. https://review.skia.org/262382/
Moved SkRuntimeEffect to public API. This is the new (experimental) interface to custom SkSL shaders and color filters.
Added BC1 compressed format support. Metal and Vulkan seem to only support the BC formats on desktop machines.
Added compressed format support for backend texture creation API. This adds the following new entry points: GrContext::compressedBackendFormat GrContext::createCompressedBackendTexture The latter method comes in variants that allow color-initialized and compressed texture data initialized.
Added SkMatrix::MakeTrans(SkIVector) https://review.skia.org/259804
For Vulkan backend, we now require that the VkDevice, Queue, and Instance outlive either the destruction or abandoning of the GrContext. Additionally, all GrBackendTextures created via GrContext::createBackendTexture calls must be deleted before destroying or abandoning the GrContext. https://review.skia.org/257921
Removed SkSize& SkSize::operator=(const SkISize&) https://review.skia.org/257880
SkISize width() and height() now constexpr https://review.skia.org/257680
Added SkMatrix::MakeTrans(SkVector) and SkRect::makeOffset(SkVector). https://review.skia.org/255782
Added SkImageInfo::MakeA8(SkISize) and added optional color space parameter to SkImageInfo::MakeN32Premul(SkISize).
Added dimensions() and getFrameCount() to SkAnimatedImage https://review.skia.org/253542
Removed SkMatrix44 version of toXYZD50 from SkColorSpace. Switched to skcms types in transferFn, invTrasnferFn, and gamutTransformTo functions. https://review.skia.org/252596
Removed rotation and YUV support from SkColorMatrix https://review.skia.org/252188
Added kBT2020_SkYUVColorSpace. This is BT.2020's YCbCr conversion (non-constant-luminance). https://review.skia.org/252160
Remove old async read pixels APIs https://review.skia.org/251198
Expose SkBlendModeCoeff and SkBlendMode_AsCoeff for Porter-Duff blend modes. https://review.skia.org/252600
SkTextBlob::Iter to discover the glyph indices and typefaces in each run https://skia-review.googlesource.com/246296
Added support for PQ and HLG transfer functions to SkColorSpace. https://skia-review.googlesource.com/c/skia/+/249000
Added new api on GrContext ComputeImageSize. This replaces the hold static helper ComputeTextureSize. https://skia-review.googlesource.com/c/skia/+/247337
New versions of SkSurface async-rescale-and read APIs that allow client to extend the lifetime of the result data. Old versions are deprecated. https://review.skia.org/245457
Add SkColorInfo. It's dimensionless SkImageInfo. https://review.skia.org/245261
Added SkPixmap-based createBackendTexture method to GrContext. This allows clients to create backend resources (initialized with texture data) that Skia/Ganesh doesn't know about/track. https://review.skia.org/244676
Add explicit src and dst colorspace parameters to SkColorFilter::filterColor4f() https://review.skia.org/244882
Remove Vulkan/Metal float32 RGBA texture support https://review.skia.org/244881
Add SkSurface::MakeFromCAMetalLayer https://review.skia.org/242563
Added kAlpha_F16_SkColorType, kRG_F16_SkColorType and kRGBA_16161616_SkColorType. This is intended to help support HDR YUV uses case (e.g., P010 and P016). As such, the addition is focused on allowing creation of SkPixmaps and SkImages and not SkSurfaces (i.e., who wants to render to render to these?) https://review.skia.org/241357
Start to move nested SkPath types (e.g. Direction, Verb) up to root level in SkPathTypes.h https://review.skia.org/241079
Remove isRectContour and ksNestedFillRects from public https://review.skia.org/241078
Added kRG_88_SkColorType. This is intended to help support YUV uses case (e.g., NV12). As such, the addition is focused on allowing creation of SkPixmaps and SkImages and not SkSurfaces (i.e., who wants to render to RG?) https://review.skia.org/239930 https://review.skia.org/235797
Make the size of program/pipeline caches configurable via GrContextOptions::fRuntimeProgramCacheSize https://review.skia.org/239756
Added kAlpha_16_SkColorType and kRG_1616_SkColorType. This is intended to help support HDR YUV uses case (e.g., P010 and P016). As such, the addition is focused on allowing creation of SkPixmaps and SkImages and not SkSurfaces (i.e., who wants to render to render to these?) https://review.skia.org/239930
Add GrContext::precompileShader to allow up-front compilation of previously-cached shaders. https://review.skia.org/239438
SkDrawLooper is no longer supported in SkPaint or SkCanvas. https://review.skia.org/230579 https://review.skia.org/231736
SkPath::Iter::next() now ignores its consumDegenerates bools. Those will so go away entirely https://review.skia.org/235104
SkImage: new factories: DecodeToRaster, DecodeToTexture https://review.skia.org/234476
SkImageFilter API refactor started:
SkColorFilters::HSLAMatrix - new matrix color filter operating in HSLA space. https://review.skia.org/231736
Modify GrBackendFormat getters to not return internal pointers. Use an enum class for GL formats. https://review.skia.org/233160
Expose GrContext::dump() when SK_ENABLE_DUMP_GPU is defined. https://review.skia.org/233557
Vulkan backend now supports YCbCr sampler for I420 Vulkan images that are not backed by external images. https://review.skia.org/233776
Add SkCodec::SelectionPolicy for distinguishing between decoding a still image or an image sequence for a container format that has both (e.g. HEIF). https://review.skia.org/232839
SkImage::makeTextureImage and SkImage::MakeCrossContextFromPixmap no longer take an SkColorSpace parameter. It was unused. https://review.skia.org/234579 https://review.skia.org/234912
SkImage::reinterpretColorSpace - to reinterpret image contents in a new color space. https://review.skia.org/234328
Removed SkImage::MakeCrossContextFromEncoded. https://review.skia.org/234912
Add Metal support for GrFence, GrSemaphore, and GrBackendSemaphore https://review.skia.org/233416
SkMallocPixelRef: remove MakeDirect and MakeWithProc from API. https://review.skia.org/234660
Remove 4-parameter variant of SkRect::join() and intersect(), and noemptycheck variants of intersect(). https://review.skia.org/235832 https://review.skia.org/237142
Remove unused sk_sp comparison operators. https://review.skia.org/236942
Add SkColor4f variant to experimental_DrawEdgeAAQuad for SkiaRenderer. https://review.skia.org/237492
Deprecated maxCount resource cache limit for Ganesh. This hasn't been relevant for a long time.
Changed GrContextOptions' fDisallowGLSLBinaryCaching to fShaderCacheStrategy, and allow caching SkSL. https://review.skia.org/238856
Use GL_QCOM_TILED_RENDERING to explicitly discard stencil
Added RELEASE_NOTES.txt file https://review.skia.org/229760
Implemented internal support for OpenGL tessellation.