blob: 86c9512e03a801e8d0d7381fe21b8da62fe01a71 [file] [log] [blame]
Heather Miller118a4072019-07-25 11:33:30 -04001Skia Graphics Release Notes
2
3This file includes a list of high level updates for each milestone release.
4
Hal Canary9e514a12019-10-01 15:15:36 -04005* * *
Mike Reed430470d2019-09-12 17:09:12 -04006
Jim Van Verth351c9b52020-11-12 15:21:11 -05007Milestone 89
8------------
Jim Van Verthea4aa392021-01-11 11:01:09 -05009 * Add SkShadowUtils::GetLocalBounds. Generates bounding box for shadows
10 relative to path.
11 https://review.skia.org/351922
12
Brian Salomon4878b3e2021-01-08 18:11:33 -050013 * Removed SkPerlinNoiseShader::MakeImprovedNoise.
14 https://review.skia.org/352057
15
Jim Van Verthea4aa392021-01-11 11:01:09 -050016 * Removed deprecated version of MakeFromYUVATextures. Use the version
Brian Salomond12c91b2020-12-23 20:28:53 -050017 that takes GrYUVABackendTextures instead.
18 https://review.skia.org/345174
Leon Scroggins IIIe4271602020-12-15 15:52:39 -050019
20 * SkAnimatedImage: Always respect exif orientation
21 Replace SkPixmapPriv::ShouldSwapWidthHeight with
22 SkEncodedOriginSwapsWidthHeight.
23 https://review.skia.org/344762
24
Jim Van Verth63f03542020-12-16 11:56:11 -050025 * Add kDirectionalLight_ShadowFlag support. If enabled, light position represents
26 a vector pointing towards the light, and light radius is blur radius at elevation 1.
27 https://review.skia.org/321792
Brian Salomonb5f880a2020-12-07 11:30:16 -050028
Brian Salomon01ff5382020-12-15 16:06:26 -050029 * Support GL_LUMINANCE8_ALPHA8 textures. These can be used with GrBackendTexture APIs
30 on GrDirectContext and as planes of YUVA images via GrYUVABackendTextures.
31 https://review.skia.org/344761
32
Brian Salomon8670c982020-12-08 16:39:32 -050033 * Removed previously deprecated SkImage::MakeFromYUVATexturesCopyToExternal.
34 https://review.skia.org/342077
35
Brian Salomonb5f880a2020-12-07 11:30:16 -050036 * Add versions of GrDirectContext::createBackendTexture and updateBackendTexture
37 that take a GrSurfaceOrigin. The previous versions are deprecated.
38 https://review.skia.org/341005
39
Michael Ludwige0dee012020-12-04 12:59:39 -050040 * Remove support for deprecated kDontClipToLayer_SaveLayerFlag in SkCanvas::SaveLayerRec
41 https://review.skia.org/339988
42
Leon Scroggins III469d67e2020-11-11 12:45:40 -050043 * Expose more info in SkCodec::FrameInfo
44 https://review.skia.org/339857
45
Michael Ludwiga2c40202020-11-24 13:14:04 -050046 * Added dither control to the SkImageFilters::Shader factory.
47 https://review.skia.org/338156
Jim Van Verth351c9b52020-11-12 15:21:11 -050048
Jim Van Verth9e640472020-11-19 12:59:06 -050049 * Add MTLBinaryArchive parameter to GrMtlBackendContext. This allows
50 Skia to cache PipelineStates in the given archive for faster
51 shader compiles on future runs. The client must handle loading and
52 saving of the archive.
53 https://review.skia.org/333758
54
Brian Salomonfcc4e852020-11-18 08:46:44 -050055 * Deprecated enum SkYUVAInfo::PlanarConfig has been removed.
56 https://review.skia.org/334161
57
Brian Salomon98e17bf2020-11-16 10:31:49 -050058 * Deprecated SkImage factories have been removed from
59 SkDeferredDisplayListRecorder.
60
Brian Salomona29ed262020-11-12 16:34:28 -050061 * The following YUV image factories have been removed:
62 SkImage::MakeFromYUVTexturesCopyWithExternalBackend
63 SkImage::MakeFromNV12TexturesCopyWithExternalBackend
64 Replacement pattern outlined below.
65 1) Make image using MakeFromYUVATextures
66 2) Make a SkSurface around result texture using SkSurface::MakeFromBackendTexture
67 3) surface->getCanvas()->drawImage(image, 0, 0);
68 4) surface->flushAndSubmit()
69 5) Optional: SkImage::MakeFromBackendTexture() to use as SkImage.
70 https://review.skia.org/334596
71
Jim Van Verth351c9b52020-11-12 15:21:11 -050072 * Added a new interface for GrDirectContext creation in Metal, using
73 a new struct called GrMtlBackendContext. The previous interface taking
74 a MTLDevice and MTLCommandQueue is deprecated.
75 https://review.skia.org/334426
76
Robert Phillipsca924242020-11-30 08:32:38 -050077 * SkCanvas::flush has been deprecated.
78
Jim Van Verth351c9b52020-11-12 15:21:11 -050079* * *
80
Heather Miller93f22bc2020-10-02 08:44:30 -040081Milestone 88
Heather Miller481ff132020-08-20 15:59:08 -040082------------
Heather Miller481ff132020-08-20 15:59:08 -040083
Brian Salomone4387382020-11-11 16:34:19 -050084 * SkYUVAInfo now has separate enums for division of channels among planes and
85 the subsampling. The previous combined enum, PlanarConfig, is deprecated.
86 https://review.skia.org/334102
87
Brian Salomonf1432742020-11-09 15:40:27 -050088 * Simplified SkDeferredDisplayListRecorder promise image API. Removed "release"
89 callback and renamed "done" callback to "release". The new "release" proc can
Brian Salomonbd3792d2020-11-10 14:17:58 -050090 be null. Added a new SkYUVAInfo-based factory for YUVA promise texture images
91 and deprecated the old SkYUVAIndex-based one.
Brian Salomonf1432742020-11-09 15:40:27 -050092 https://review.skia.org/331836
Brian Salomonbd3792d2020-11-10 14:17:58 -050093 https://review.skia.org/333519
Brian Salomonfea12232020-10-16 16:11:27 -040094
Brian Osmanb06301e2020-11-06 11:45:36 -050095 * Limit the types and intrinsics supported in SkRuntimeEffect to GLSL ES 1.00
96 https://review.skia.org/332597
97
Vignesh Venkatasubramanianeb7f9602020-11-04 14:13:39 -080098 * Add AVIF support to SkHeifCodec.
99
Greg Daniel007d97d2020-11-04 10:50:39 -0500100 * Add support for creating SkSurfaceCharacterizations directly for use by a
101 GrVkSecondaryCBDrawContext.
102 https://review.skia.org/331877
103
Ben Wagner9abf7192020-10-23 11:29:03 -0400104 * Removed SkSurfaceProps::kLegacyFontHost_InitType, SkFontLCDConfig, and related code.
105 The default pixel geometry for SkSurfaceProps is now kUnknown instead of kRGB_H.
106 The removal was guarded by the SK_LEGACY_SURFACE_PROPS build flag which was later removed.
107 https://review.skia.org/322490
108 https://review.skia.org/329364
109
Brian Salomon9f8ee0d2020-10-19 13:31:49 -0400110 * Legacy 8-bit YUV interface removed from SkImageGenerator. Use more flexible SkYUVAPixmaps-
111 based interface instead.
112 https://review.skia.org/327917
113
Brian Salomonc1a249d2020-10-19 10:55:45 -0400114 * New variant of SkImage::MakeFromYUVATextures. Takes a new type GrYUVATextures
115 which wraps an SkYUVAInfo and compatible set of GrBackendTextures. The provides
116 a more complete and structured specification of the planar configuration. Previous
117 version is deprecated.
Brian Salomon694ff172020-11-04 16:54:28 -0500118 Already deprecated MakeFromYUVATexturesCopyToExternal added to replace other deprecated
119 APIs. It's not recommended that clients use this and instead use the pattern described
120 in the API comment.
Brian Salomon9f8ee0d2020-10-19 13:31:49 -0400121 https://review.skia.org/317762
Brian Salomon694ff172020-11-04 16:54:28 -0500122 https://review.skia.org/329956
Brian Salomonc1a249d2020-10-19 10:55:45 -0400123
kylechar97a1e672020-10-19 10:07:48 -0400124 * Add field to GrContextOptions to disable mipmap support even if the backend
125 supports it.
126
Mike Klein8aa0edf2020-10-16 11:04:18 -0500127 * SkTPin() removed from public API.
128
Michael Ludwig01b93ea2020-10-09 10:45:07 -0400129 * Add new SkImageFilters::Blend factory function, in place of the now deprecated
130 SkImageFilters::Xfermode factory function. Behavior is identical, but name better matches
131 conventions in SkShader and SkColorFilter.
132 https://review.skia.org/324623
133
Michael Ludwigc98d5b62020-10-09 10:31:28 -0400134 * SkImageFilters::Foo() factory functions now accept SkIRect, SkRect, and optional SkIRect* or
135 SkRect*, instead of previously just the optional SkIRect*. Internally, the crop rects are stored
136 as floats to allow for fractional crops to be defined in the local coordinate system (before
137 transformation by the canvas matrix).
138 https://review.skia.org/324622
139
Michael Ludwig7d0f8532020-10-07 15:27:20 -0400140 * Add new SkImageFilters::Shader factory and deprecate SkImageFilters::Paint factory. All
141 supported/valid Paint() filters can be represented more cleanly as a Shader image filter.
142 https://review.skia.org/323680
143
Adlai Holler0ce2c542020-10-06 14:04:35 -0400144 * GrContext has been replaced by two separate classes: GrDirectContext which is
145 the traditional notion of GrContext, and GrRecordingContext which is a context
146 that is recording an SkDeferredDisplayList and therefore has reduced functionality.
147 Unless you are using SkDeferredDisplayList, migrate directly to GrDirectContext in
148 all cases.
149
Brian Salomon72c7b982020-10-06 10:07:38 -0400150 * CPU sync bool added to SkSurface::flushAndSubmit() and GrContext::flushAndSubmit()
151
Brian Salomonf165f792020-10-05 13:25:05 -0400152 * Removed legacy variant of SkImage::MakeFromYUVAPixmaps. Use the version that
153 takes SkYUVAPixmaps instead. It has a more structured description of the
154 planar configuration.
155 https://review.skia.org/322480
156
Brian Salomon86d07fd2020-10-02 14:37:57 -0400157 * Some SkImage YUV image factories have been removed. Replacement patterns
158 outlined below.
159 SkImage::MakeFromYUVATexturesCopy
160 1) Make SkImage from YUVA planes using SkImage::MakeFromYUVATextures
161 2) Use Skia to allocate a surface using SkSurface::MakeRenderTarget
162 3) surface->getCanvas()->drawImage(image, 0, 0);
163 4) surface->makeImageSnapShot() produces RGBA image.
164 SkImage::MakeFromYUVATexturesCopyWithExternalBackend
165 1) Make image using MakeFromYUVATextures
166 2) Make a SkSurface around result texture using SkSurface::MakeFromBackendTexture
167 3) surface->getCanvas()->drawImage(image, 0, 0);
168 4) surface->flushAndSubmit()
169 5) Optional: SkImage::MakeFromBackendTexture() to use as SkImage.
170 SkImage::MakeFromNV12TexturesCopy
171 Same as SkImage::MakeFromYUVATexturesCopy
172 https://review.skia.org/321537
173
Greg Daniel36366202020-10-02 11:13:33 -0400174 * GrBackendRenderTargets which are created with a stencilBits param, now require
175 the stencilBits to be 0, 8, or 16.
176 https://review.skia.org/321545
177
Heather Miller93f22bc2020-10-02 08:44:30 -0400178* * *
179
180Milestone 87
181------------
182
Brian Salomon57fd9232020-09-28 17:02:49 -0400183 * GrVkImageInfo now has a field for sample count. GrBackendRenderTarget constructor
184 that took both a GrVkImageInfo and separate sample count is deprecated. Use the
Brian Salomon718ae762020-09-29 16:52:49 -0400185 version without sample count instead. Similarly, GrD3DTextureResourceInfo now
186 has a sample count field and GrBackendRenderTarget no longer takes a separate
Brian Salomon8e0aa442020-09-30 13:50:18 -0400187 sample count for Direct3D. The sample count for GrBackendRenderTarget is now
188 directly queried from MtlTexture rather than passed separately. The version that
189 takes a separate sample count is deprecated and the parameter is ignored.
Brian Salomon718ae762020-09-29 16:52:49 -0400190 https://review.skia.org/320262
191 https://review.skia.org/320757
Brian Salomon8e0aa442020-09-30 13:50:18 -0400192 https://review.skia.org/320956
Brian Salomon57fd9232020-09-28 17:02:49 -0400193
Jim Van Verthc2d10ef2020-09-28 15:36:00 -0400194 * Added deprecation warning for Metal support on MacOS 10.13, iOS 8.3, and older.
195 https://review.skia.org/320260
196
Brian Salomon57fd9232020-09-28 17:02:49 -0400197 * GrVkImageInfo now has a field for sample count. GrBackendRenderTarget constructor
198 that took both a GrVkImageInfo and separate sample count is deprecated. Use the
199 version without sample count instead.
200
Michael Ludwige5d5eed2020-09-28 10:33:42 -0400201 * Update SkClipOp::kMax_EnumValue to include only intersect and difference when
202 SK_SUPPORT_DEPRECATED_CLIPOPS is not defined.
203 https://review.skia.org/320064
204
Jim Van Verth1b89eb72020-09-23 16:29:51 -0400205 * Add support for external allocator for Direct3D 12 backend.
206 Defines base classes for an allocation associated with a backend texture and a
207 a memory allocator to create such allocations.
208 Adds memory allocator to backend context.
209 https://review.skia.org/317243
210
Greg Daniel1d3c8c12020-09-23 14:23:36 -0400211 * Add new optional parameter to GrContext::setBackend[Texture/RenderTarget]State which can
212 be used to return the previous GrBackendSurfaceMutableState before the requested change.
213 https://review.skia.org/318698
214
Michael Ludwig395ddc32020-09-16 18:41:38 +0000215 * New optimized clip stack for GPU backends. Enabled by default but old behavior based on
216 SkClipStack can be restored by defining SK_DISABLE_NEW_GR_CLIP_STACK when building. It is not
217 compatible with SK_SUPPORT_DEPRECATED_CLIPOPS and we are targeting the removal of support for
218 the deprecated, expanding clip ops.
219 https://review.skia.org/317209
220
John Stilesf2f9b0d2020-08-25 13:33:45 -0400221 * GPU backends now properly honor the SkFilterQuality when calling drawAtlas.
222 https://review.skia.org/313081
223
Brian Osman767f4442020-08-13 16:59:48 -0400224 * The signature of 'main' used with SkRuntimeEffect SkSL has changed. There is no longer an
225 'inout half4 color' parameter, effects must return their color instead.
226 Valid signatures are now 'half4 main()' or 'half4 main(float2 coord)'.
227 https://review.skia.org/310756
228
Brian Salomon94f65d72020-09-18 14:09:51 -0400229 * New YUVA planar specifications for SkCodec, SkImageGenerator, SkImage::MakeFromYUVAPixmaps.
230 Chroma subsampling is specified in more structured way. SkCodec and SkImageGenerator
231 don't assume 3 planes with 8bit planar values. Old APIs are deprecated.
Brian Salomon87d42e52020-08-24 09:18:16 -0400232 https://review.skia.org/309658
Brian Salomonbe0e42c2020-08-27 11:00:04 -0400233 https://review.skia.org/312886
Brian Salomon59c60b02020-09-01 15:01:15 -0400234 https://review.skia.org/314276
Brian Salomon94f65d72020-09-18 14:09:51 -0400235 https://review.skia.org/316837
236 https://review.skia.org/317097
Brian Salomon87d42e52020-08-24 09:18:16 -0400237
Greg Daniel7b62dca2020-08-21 11:26:12 -0400238 * Added VkImageUsageFlags to GrVkImageInfo struct.
239
Heather Miller481ff132020-08-20 15:59:08 -0400240* * *
241
Jim Van Verthc1a67b52020-06-25 13:10:29 -0400242Milestone 86
243------------
Greg Danielce9f0162020-06-30 13:42:46 -0400244
Brian Osmana4b91692020-08-10 14:26:16 -0400245 * Remove support for 'in' variables from SkRuntimeEffect. API now exclusively refers to inputs
246 as 'uniforms'.
247 https://review.skia.org/309050
248
Leon Scroggins III326b9892020-08-05 16:51:10 -0400249 * Add SkImageGeneratorNDK and SkEncodeImageWithNDK for using Android's NDK APIs to decode and
250 encode.
251 https://review.skia.org/308185
252 https://review.skia.org/308800
Leon Scroggins IIIf21d6b92020-08-05 10:44:17 -0400253
Mike Reed3a608e52020-07-28 17:24:21 -0400254 * SkImage:remove DecodeToRaster, DecodeToTexture
255 https://review.skia.org/306331
256
Greg Daniel95afafb2020-07-22 12:09:26 -0400257 * Add GrContext api to update compressed backend textures.
258 https://review.skia.org/302265
259
Brian Salomon7e67dca2020-07-21 09:27:25 -0400260 * Rename GrMipMapped to GrMipmapped for consistency with new APIs.
Brian Salomon40a40622020-07-21 10:32:07 -0400261 Also rename GrBackendTexture::hasMipMaps() to GrBackendTexture::hasMipmaps()
Brian Salomon7e67dca2020-07-21 09:27:25 -0400262 https://review.skia.org/304576
Brian Salomon40a40622020-07-21 10:32:07 -0400263 https://review.skia.org/304598
Brian Salomon7e67dca2020-07-21 09:27:25 -0400264
Greg Daniel414418d2020-07-08 11:44:25 -0400265 * Add option for clients to own semaphores after wait calls.
266 https://review.skia.org/301216
267
Greg Danielce9f0162020-06-30 13:42:46 -0400268 * Remove obsolete GrFlushFlags.
269 https://review.skia.org/298818
270
Greg Danielc72d7a52020-06-25 21:00:17 -0400271 * Adds default flush() calls to SkSurface, SkImage, and GrContext. These calls do
Greg Danielce9f0162020-06-30 13:42:46 -0400272 a basic flush without a submit. If you haven't updated Skia in a couple releases
Greg Danielc72d7a52020-06-25 21:00:17 -0400273 and still have flush() calls in your code that you expect to do a flush and
274 submit, you should update all those to the previously added flushAndSubmit() calls
275 instead.
276 https://review.skia.org/299141
277
Jim Van Verthc1a67b52020-06-25 13:10:29 -0400278 * Enable BackendSemaphores for the Direct3D backend.
279 https://review.skia.org/298752
280
Brian Salomon63a0a752020-06-26 13:32:09 -0400281 * Added SkImage:asyncRescaleAndReadPixels and SkImage::asyncRescaleAndReadPixelsYUV420
282 https://review.skia.org/299281
283
Robert Phillips2a4acf32020-07-06 15:50:15 -0400284 * Ganesh is moving towards replacing GrContext with the GrDirectContext/GrRecordingContext
285 pair. GrDirectContexts have _direct_ access to the GPU and are very similar to the old
286 GrContext. GrRecordingContexts are less powerful contexts that lack GPU access but provided
287 context-like utilities during DDL recording. SkSurfaces and SkCanvas will now only return
288 GrRecordingContexts. Clients requiring context features that need GPU access can then
289 check (via GrRecordingContext::asDirectContext) if the available recording context is actually
290 a direct context.
291
John Stiles91196252020-07-28 09:23:54 -0400292 * Replace #defined values in SkString with equivalent constexprs.
293 http://review.skia.org/306160
294
Jim Van Verthc1a67b52020-06-25 13:10:29 -0400295* * *
296
Heather Millerb88892f2020-05-15 10:53:49 -0400297Milestone 85
298------------
299
Brian Salomon24069eb2020-06-24 10:19:52 -0400300 * Added GrContext::oomed() which reports whether Skia has seen a GL_OUT_OF_MEMORY
301 error from Open GL [ES] or VK_ERROR_OUT_OF_*_MEMORY from Vulkan.
302 https://review.skia.org/298216
Greg Daniel1db8e792020-06-09 17:29:32 -0400303
Greg Daniel9efe3862020-06-11 11:51:06 -0400304 * Add option on SkSurface::flush to pass in a GrBackendSurfaceMutableState which
305 we will set the gpu backend surface to be at the end of the flush.
306 https://review.skia.org/295567
307
Greg Daniel1db8e792020-06-09 17:29:32 -0400308 * Add GrContext function to set mutable state on a backend surface. Currently this
309 is only used for setting vulkan VkImage layout and queue family.
310 https://review.skia.org/293844
311
Brian Salomon3fdc49f2020-06-02 22:01:39 -0400312 * SkSurface factores that take GrBackendTexture or GrBackendRenderTarget now always
Greg Daniel1db8e792020-06-09 17:29:32 -0400313 call the release proc (if provided) on failure. SkSurface::replaceBackendTexture
Brian Salomon3fdc49f2020-06-02 22:01:39 -0400314 also calls the release proc on failure.
315 https://review.skia.org/293762
316
Brian Salomon39278022020-06-02 11:47:26 -0400317 * SkSurface::asyncRescaleAndReadPixels and SkSurfaceasyncRescaleAndReadPixelsYUV420
318 now require explicit GrContext submit to guarantee finite time before callback
319 is invoked.
320 https://review.skia.org/292840
Heather Millerb88892f2020-05-15 10:53:49 -0400321
Greg Danielaa9d99f2020-06-02 11:10:41 -0400322 * Add VkSharingMode field to GrVkImageInfo.
323 https://review.skia.org/293559
324
Leon Scroggins III43182bc2020-05-21 11:14:31 -0400325 * Move SkBitmapRegionDecoder into client_utils/android.
326
Kevin Lubick23620222020-06-03 11:19:49 -0400327 * SkCanvas.clear and SkCanvas.drawColor now accept SkColor4f in addition to SkColor.
328
Brian Salomonc0d88a12020-05-28 17:44:05 -0400329 * Remove SkSurface::MakeFromBackendTextureAsRenderTarget.
330 This factory existed to work around issues with GL_TEXTURE_RECTANGLE that existed
331 in Chrome's command buffer. Those issues have since been resolved. Use
332 SkSurface::MakeFromBackendTexutre or SkSurface::MakeFromBackendRenderTarget instead.
333 https://review.skia.org/292719
334
Greg Daniel55822f12020-05-26 11:26:45 -0400335 * Adds submittedProc callback to GrFlushInfo which will be called when the work
336 from the flush call is submitted to the GPU. This is specifically useful for knowing
337 when semahpores sent with the flush have been submitted and can be waiting on.
338 https://review.skia.org/291078
339
Greg Daniel04283f32020-05-20 13:16:00 -0400340 * GrContext submit is now required to be called in order to send GPU work to the
341 actual GPU. The flush calls simply produces 3D API specific objects that are ready
342 to be submitted (e.g. command buffers). For the GL backend, the flush will still
343 send commands to the driver. However, clients should still assume the must call
344 submit which is where any glFlush that is need for sync objects will be called. There,
345 are flushAndSubmit() functions of GrContext, SkSurface, and SkImage that will act
346 like the previous flush() functions. This will flush the work and immediately call
347 submit.
348 https://review.skia.org/289033
349
Greg Daniel49de1032020-05-19 18:06:26 -0400350 * Remove deprecated version of flush calls on GrContext and SkSurface.
351 https://review.skia.org/2290540
352
Brian Osman8219e912020-05-15 13:04:48 -0400353 * SkCanvas::drawVertices and drawPatch now support mapping an SkShader without explicit
354 texture coordinates. If they're not supplied, the local positions (vertex position or
355 patch cubic positions) will be directly used to sample the SkShader.
356 https://review.skia.org/290130
357
Heather Millerb88892f2020-05-15 10:53:49 -0400358* * *
359
Heather Millere4bcbf82020-04-03 12:01:51 -0400360Milestone 84
Heather Millerb88892f2020-05-15 10:53:49 -0400361------------
Greg Daniel5ab94e12020-05-13 14:11:40 -0400362
Greg Danielb2365d82020-05-13 15:32:04 -0400363 * Add api on GrContext, updateBackendTexture that will upload new data to a
364 GrBackendTexture.
365 https://review.skia.org/288909
366
Greg Daniel5ab94e12020-05-13 14:11:40 -0400367 * Add GrContext getter to SkSurface.
368 https://review.skia.org/289479
369
Greg Danielda50cb82020-05-13 14:07:40 -0400370 * Deprecate GrContext and SkSurface flush() call and replace ith with flushAndSubmit().
371 This only effects the default flush call that takes no parameters.
372 https://review.skia.org/289478
Heather Millere4bcbf82020-04-03 12:01:51 -0400373
Greg Danielc1ad77c2020-05-06 11:40:03 -0400374 * GrContext::createBackendTexture functions that initialize the texture no longer
375 guarantee that all the data has been uploaded and the gpu is done with the texture.
376 Instead the client can assume the upload work has been submitted to the gpu and they
377 must wait for that work to finish before deleting the texture. This can be done via
378 their own synchronization or by passing in a finish proc into the create calls which
379 will be called when it is safe to delete the texture (at least in terms of work
380 done during the create).
381 https://review.skia.org/286517
Heather Millere4bcbf82020-04-03 12:01:51 -0400382
Mike Reed52653732020-05-05 14:40:42 -0400383 * Remove unused SkMaskFilter helpers: compbine, compose
384 Note: shadermaskfilter will likely be removed next (clipShader should serve)
385
Xianzhu Wanga91e4782020-05-01 09:34:57 -0700386 * Add back SkCanvas::kPreserveLCDText_SaveLayerFlag to indicate that saveLayer()
387 will preserve LCD-text. All text in the layer must be drawn on opaque background
388 to ensure correct rendering.
389
Leon Scroggins III63cfb362020-04-24 13:00:48 -0400390 * Add the new directory client_utils/ for code that is specific to a single client and
391 should be considered separate from Skia proper. Move SkFrontBufferedStream into the
392 subdir android/.
393
Mike Kleind5cba9d2020-04-24 07:44:50 -0500394 * SkBitmap and SkPixmap's erase() methods now treat their color parameters
395 consistently with the rest of Skia, with all SkColors and any untagged
396 SkColor4fs interpreted as sRGB, not as a color in the bitmap's color space.
397 SkPixmap::erase(SkColor4f) now takes an SkColorSpace, so you can pass
398 pixmap.colorSpace() if you want the old behavior.
399
Mike Reedd276e3f2020-04-14 15:44:21 -0400400 * SkCamera.h and SkMatrix44.h are DEPRECATED.
Mike Reed14f62de2020-04-14 11:35:40 -0400401 Use SkM44 if you want to have 3d transformations.
402
Ben Wagnercc81e202020-04-09 13:00:44 -0400403 * Changed Dilate and Erode image filters to take SkScalar for radius instead of int. While
404 the image filters themselves are defined in terms of discrete pixels, the radii provided by
405 the user are mapped through the CTM so taking ints forced over discretization. After mapping
406 through the CTM the radii are now rounded to pixels.
407 https://review.skia.org/281731
408 https://review.skia.org/282636
409
Greg Daniel8561fc22020-04-08 12:52:51 -0400410 * Updated the contract of GrContext and SkSurface flush calls in regards to semaphores. Made it
411 clear that the caller is responsible for deleting any initialized semaphores after the flush
412 call regardless if we were able to submit them or not. Also, allows skia to only submit a
413 subset of the requested semaphores if we failed to create some.
414 https://review.skia.org/282265
415
416
Brian Osman62a0fb22020-04-07 13:48:15 -0400417 * SkCanvas::drawVertices will now always fill the triangles specified by the vertices. Previously,
418 vertices with no colors and no (texture coordinates or shader) would be drawn in wireframe.
419 https://review.skia.org/282043
420
Heather Millere4bcbf82020-04-03 12:01:51 -0400421* * *
422
Heather Miller6c138712020-03-16 10:50:49 -0400423Milestone 83
Heather Millerb88892f2020-05-15 10:53:49 -0400424------------
Heather Millerd5153bb2019-10-17 00:03:36 -0400425
Kevin Lubick988ce042020-03-25 13:13:20 -0400426 * Remove localmatrix option from SkShaders::[Blend, Lerp]
427
Jim Van Verth05d09192020-03-20 11:23:39 -0400428 * Fill out Direct3D parameters for backend textures and backend rendertargets.
429
Brian Salomonbc074a62020-03-18 10:06:13 -0400430 * SkImage::makeTextureImage() takes an optional SkBudgeted param
Michael Ludwigb0cee9b2020-03-12 10:52:15 -0400431
Brian Salomonf4ba4ec2020-03-19 15:54:28 -0400432 * Made non-GL builds of GPU backend more robust.
433 https://review.skia.org/277456
434
435 * MoltenVK support removed. Use Metal backend instead.
436 https://review.skia.org/277612
Heather Miller6c138712020-03-16 10:50:49 -0400437
438* * *
439
440Milestone 82
Heather Millerb88892f2020-05-15 10:53:49 -0400441------------
Heather Miller6c138712020-03-16 10:50:49 -0400442
Michael Ludwigb0cee9b2020-03-12 10:52:15 -0400443 * Removed drawBitmap and related functions from SkDevice; all public drawBitmap functions on
444 SkCanvas automatically wrap the bitmap in an SkImage and call the equivalent drawImage function.
445 Drawing mutable SkBitmaps will now incur a mandatory copy. Switch to using SkImage directly or
446 mark the bitmap as immutable before drawing.
447
Brian Osmandafbf122020-03-11 12:26:56 -0400448 * Removed "volatile" flag from SkVertices. All SkVertices objects are assumed to be
449 volatile (the previous default behavior).
450
Michael Ludwigb0cee9b2020-03-12 10:52:15 -0400451 * Removed exotic legacy bitmap functions from SkCanvas (drawBitmapLattic, drawBitmapNine); the
452 exotic SkImage functions still exist.
453
Leon Scroggins IIIa77f30c2020-03-09 14:23:30 -0400454 * Make it possible to selectively turn on/off individual encoders/decoders,
455 using skia_use_(libpng/libjpeg_turbo/libwebp)(decode/encode).
456
Greg Daniel456f9b52020-03-05 19:14:18 +0000457 * Removed GrGpuResource, GrSurface, and GrTexture from public api. These were not
Greg Daniel7c902112020-03-06 13:07:10 -0500458 meant to be public, and we now can move them into src. Also removed getTexture
459 function from SkImage.h
Greg Daniel456f9b52020-03-05 19:14:18 +0000460
Mike Reed5caf9352020-03-02 14:57:09 -0500461 * Removed Bones from SkVertices
462
Brian Salomond8575452020-02-25 12:13:29 -0500463 * Added a field to GrContextOptions that controls whether GL errors are checked after
464 GL calls that allocate textures, etc. It also controls checking for shader compile
465 success, and program linking success.
466
Robert Phillips1cec4d52020-02-24 08:38:34 -0500467 * Made SkDeferredDisplayList.h officially part of the public API (i.e., moved it to
468 include/core). Also added a ProgramIterator to SkDeferredDisplayList which allows
469 clients to pre-compile some of the shaders the DDL requires.
470
Robert Phillipsb3c061a2020-02-13 13:24:47 -0500471 * Added two new helper methods to SkSurfaceCharacterization: createBackendFormat and
472 createFBO0. These make it easier for clients to create new surface characterizations that
473 differ only a little from an existing surface characterization.
474
Brian Osman788b9162020-02-07 10:36:46 -0500475 * Removed SkTMax and SkTMin.
Brian Osman5f3d9f72020-02-06 14:51:46 -0500476 * Removed SkTClamp and SkClampMax.
Brian Osmanaba642c2020-02-06 12:52:25 -0500477 * Removed SkScalarClampMax and SkScalarPin.
Brian Osman7f364052020-02-06 11:25:43 -0500478 * Removed SkMax32 and SkMin32.
Brian Osman116b33e2020-02-05 13:34:09 -0500479 * Removed SkMaxScalar and SkMinScalar.
480
Allen Bauera428c7b2020-02-04 14:27:22 -0800481 * SkColorSetA now warns if the result is unused.
482
Leon Scroggins III196f3192020-02-03 12:39:54 -0500483 * An SkImageInfo with a null SkColorSpace passed to SkCodec::getPixels() and
484 related calls is treated as a request to do no color correction at decode
485 time.
Dominik Röttschesc9b06ca2020-01-31 18:13:37 +0200486
Dominic Mazzoni7dfb46e2020-02-19 10:59:29 -0800487 * Add new APIs to add attributes to document structure node when
488 creating a tagged PDF.
489
Dominik Röttschesc9b06ca2020-01-31 18:13:37 +0200490 * Remove CGFontRef parameter from SkCreateTypefaceFromCTFont.
491 Use CTFontManagerCreateFontDescriptorFromData instead of
492 CGFontCreateWithDataProvider to create CTFonts to avoid memory use issues.
493
Leon Scroggins III42a604f2020-02-06 15:47:58 -0500494 * Added SkCodec:: and SkAndroidCodec::getICCProfile for reporting the native
495 ICC profile of an encoded image, even if it doesn't map to an SkColorSpace.
Heather Millerebc4d622020-01-30 13:57:13 -0500496
Yi Xu55bca412020-02-14 18:10:40 -0500497 * SkSurface::ReplaceBackendTexture takes ContentChangeMode as a parameter,
498 which allow callers to specify whether retain a copy of the current content.
Michael Ludwigb0cee9b2020-03-12 10:52:15 -0400499
500 * Enforce the existing documentation in SkCanvas::saveLayer that it ignores
501 any mask filter on the restore SkPaint. The 'coverage' of a layer is
Michael Ludwigeced98b2020-03-03 10:39:41 -0500502 ill-defined, and masking should be handled by pre-clipping or using the
503 auxiliary clip mask image of the SaveLayerRec.
Yi Xu55bca412020-02-14 18:10:40 -0500504
Heather Millerebc4d622020-01-30 13:57:13 -0500505* * *
506
507Milestone 81
Heather Millerb88892f2020-05-15 10:53:49 -0400508------------
Heather Millerebc4d622020-01-30 13:57:13 -0500509
Brian Salomon87c31422020-01-22 09:59:56 -0500510 * Added support for GL_NV_fence extension.
Heather Miller2e046a22019-12-05 15:27:42 -0500511
Leon Scroggins III3eedc972020-01-22 10:44:00 -0500512 * Make SkImageInfo::validRowBytes require rowBytes to be pixel aligned. This
513 makes SkBitmap match the behavior of raster SkSurfaces in rejecting
514 non-aligned rowBytes.
515
Robert Phillips99dead92020-01-27 16:11:57 -0500516 * Added an SkImage::MakeRasterFromCompressed entry point. Also updated
517 SkImage::MakeFromCompressed to decompress the compressed image data if
518 the GPU doesn't support the specified compression type (i.e., macOS Metal
519 doesn't support BC1_RGB8_UNORM so such compressed images will always be
520 decompressed on that platform).
521
Robert Phillipsb0855272020-01-15 12:56:52 -0500522 * Added support for BC1 RGBA compressed textures
523
Brian Osmana88cab12020-01-09 10:21:44 -0500524 * Added CachingHint to SkImage::makeRasterImage
525
Kevin Lubickf5bc8fb2020-01-08 13:29:31 -0500526 * Added SkAnimatedImage::getCurrentFrame()
527
Jim Van Verthe2767012020-01-08 12:15:44 -0500528 * Add support to create an SkSurface from an MTKView, with delayed acquisition of
529 the MTLDrawable.
530 Entry point: SkSurface::MakeFromMTKView
531
Brian Salomon44207f32020-01-06 15:20:18 -0500532 * Removed SkIRect::EmptyIRect(). Use SkIRect::MakeEmpty() instead.
533 https://review.skia.org/262382/
534
Heather Millerebc4d622020-01-30 13:57:13 -0500535 * Moved SkRuntimeEffect to public API. This is the new (experimental) interface to custom SkSL
536 shaders and color filters.
Brian Osmanee426f22020-01-02 11:55:24 -0500537
Heather Millerebc4d622020-01-30 13:57:13 -0500538 * Added BC1 compressed format support. Metal and Vulkan seem to only support the BC
539 formats on desktop machines.
Robert Phillips8f259a02019-12-20 11:32:27 -0500540
Heather Millerebc4d622020-01-30 13:57:13 -0500541 * Added compressed format support for backend texture creation API.
542 This adds the following new entry points:
543 GrContext::compressedBackendFormat
544 GrContext::createCompressedBackendTexture
545 The latter method comes in variants that allow color-initialized and
546 compressed texture data initialized.
Robert Phillipsb915c942019-12-17 14:44:37 -0500547
Brian Salomona6069a12019-12-13 10:48:33 -0500548 * Added SkMatrix::MakeTrans(SkIVector)
549 https://review.skia.org/259804
Heather Miller2e046a22019-12-05 15:27:42 -0500550
Heather Millerebc4d622020-01-30 13:57:13 -0500551* * *
552
Heather Miller2e046a22019-12-05 15:27:42 -0500553Milestone 80
Heather Millerb88892f2020-05-15 10:53:49 -0400554------------
Heather Miller2e046a22019-12-05 15:27:42 -0500555
Greg Danielf0e04f02019-12-04 15:17:54 -0500556 * For Vulkan backend, we now require that the VkDevice, Queue, and Instance outlive
557 either the destruction or abandoning of the GrContext. Additionally, all
558 GrBackendTextures created via GrContext::createBackendTexture calls must be deleted
559 before destroying or abandoning the GrContext.
560 https://review.skia.org/257921
561
Brian Salomon4e1066f2019-12-04 10:33:52 -0500562 * Removed SkSize& SkSize::operator=(const SkISize&)
563 https://review.skia.org/257880
564
Brian Salomon8a99a412019-12-04 11:05:35 -0500565 * SkISize width() and height() now constexpr
566 https://review.skia.org/257680
567
Brian Salomone21af502019-11-22 16:56:36 -0500568 * Added SkMatrix::MakeTrans(SkVector) and SkRect::makeOffset(SkVector).
569 https://review.skia.org/255782
570
Brian Salomonc75bc032019-11-11 13:47:25 -0500571 * Added SkImageInfo::MakeA8(SkISize) and added optional color space parameter to
572 SkImageInfo::MakeN32Premul(SkISize).
Heather Millercc13acb2019-10-22 15:45:45 -0400573
Kevin Lubick47bd9f12019-11-08 06:55:15 -0800574 * Added dimensions() and getFrameCount() to SkAnimatedImage
575 https://review.skia.org/253542
576
Brian Osman09ee1122019-11-05 11:41:16 -0500577 * Removed SkMatrix44 version of toXYZD50 from SkColorSpace. Switched to skcms types in
578 transferFn, invTrasnferFn, and gamutTransformTo functions.
579 https://review.skia.org/252596
580
Brian Osmane36d0302019-11-01 17:10:28 -0400581 * Removed rotation and YUV support from SkColorMatrix
582 https://review.skia.org/252188
583
Brian Osman2b73e662019-11-01 10:02:24 -0400584 * Added kBT2020_SkYUVColorSpace. This is BT.2020's YCbCr conversion (non-constant-luminance).
585 https://review.skia.org/252160
586
Brian Salomon3683a4f2019-10-28 09:16:47 -0400587 * Remove old async read pixels APIs
588 https://review.skia.org/251198
589
Michael Ludwigcc836872019-11-04 15:01:52 -0500590 * Expose SkBlendModeCoeff and SkBlendMode_AsCoeff for Porter-Duff blend modes.
591 https://review.skia.org/252600
592
Heather Millercc13acb2019-10-22 15:45:45 -0400593* * *
594
595Milestone 79
Heather Millerb88892f2020-05-15 10:53:49 -0400596------------
Heather Millerd5153bb2019-10-17 00:03:36 -0400597
Mike Reeda32654c2019-10-04 10:18:34 -0400598 * SkTextBlob::Iter to discover the glyph indices and typefaces in each run
599 https://skia-review.googlesource.com/246296
600
Brian Osman11e6aa82019-10-16 13:58:42 -0400601 * Added support for PQ and HLG transfer functions to SkColorSpace.
Heather Millerd5153bb2019-10-17 00:03:36 -0400602 https://skia-review.googlesource.com/c/skia/+/249000
Brian Osman11e6aa82019-10-16 13:58:42 -0400603
Greg Daniel8b666172019-10-09 12:38:22 -0400604 * Added new api on GrContext ComputeImageSize. This replaces the hold static helper
605 ComputeTextureSize.
Heather Millerd5153bb2019-10-17 00:03:36 -0400606 https://skia-review.googlesource.com/c/skia/+/247337
Hal Canary9e514a12019-10-01 15:15:36 -0400607
Brian Salomon9241a6d2019-10-03 13:26:54 -0400608 * New versions of SkSurface async-rescale-and read APIs that allow client to extend
609 the lifetime of the result data. Old versions are deprecated.
610 https://review.skia.org/245457
611
Hal Canary9e514a12019-10-01 15:15:36 -0400612 * Add SkColorInfo. It's dimensionless SkImageInfo.
613 https://review.skia.org/245261
614
615 * Added SkPixmap-based createBackendTexture method to GrContext. This allows clients to create
616 backend resources (initialized with texture data) that Skia/Ganesh doesn't know about/track.
617 https://review.skia.org/244676
618
619 * Add explicit src and dst colorspace parameters to SkColorFilter::filterColor4f()
620 https://review.skia.org/244882
621
622 * Remove Vulkan/Metal float32 RGBA texture support
623 https://review.skia.org/244881
624
625 * Add SkSurface::MakeFromCAMetalLayer
626 https://review.skia.org/242563
627
628 * Added kAlpha_F16_SkColorType, kRG_F16_SkColorType and kRGBA_16161616_SkColorType.
629 This is intended to help support HDR YUV uses case (e.g., P010 and P016). As such,
630 the addition is focused on allowing creation of SkPixmaps and SkImages and not
631 SkSurfaces (i.e., who wants to render to render to these?)
632 https://review.skia.org/241357
633
634 * Start to move nested SkPath types (e.g. Direction, Verb) up to root level in SkPathTypes.h
635 https://review.skia.org/241079
636
637 * Remove isRectContour and ksNestedFillRects from public
638 https://review.skia.org/241078
639
640 * Added kRG_88_SkColorType. This is intended to help support YUV uses case (e.g., NV12).
641 As such, the addition is focused on allowing creation of SkPixmaps and SkImages and not
642 SkSurfaces (i.e., who wants to render to RG?)
643 https://review.skia.org/239930
644 https://review.skia.org/235797
645
Brian Osman172bb442019-09-06 10:16:02 -0400646 * Make the size of program/pipeline caches configurable via
647 GrContextOptions::fRuntimeProgramCacheSize
648 https://review.skia.org/239756
649
Hal Canary9e514a12019-10-01 15:15:36 -0400650 * Added kAlpha_16_SkColorType and kRG_1616_SkColorType. This is intended to help support HDR YUV
651 uses case (e.g., P010 and P016). As such, the addition is focused on allowing creation of
652 SkPixmaps and SkImages and not SkSurfaces (i.e., who wants to render to render to these?)
653 https://review.skia.org/239930
654
655 * Add GrContext::precompileShader to allow up-front compilation of previously-cached shaders.
656 https://review.skia.org/239438
657
658* * *
659
Heather Miller118a4072019-07-25 11:33:30 -0400660Milestone 78
Heather Millerb88892f2020-05-15 10:53:49 -0400661------------
Heather Miller118a4072019-07-25 11:33:30 -0400662
Hal Canary2af5db72019-08-20 11:28:37 -0400663 * SkDrawLooper is no longer supported in SkPaint or SkCanvas.
Hal Canary3b0e7f62019-08-20 14:52:02 -0400664 https://review.skia.org/230579
665 https://review.skia.org/231736
Mike Reed9dc0b9e2019-07-29 17:52:48 -0400666
Hal Canary3b0e7f62019-08-20 14:52:02 -0400667 * SkPath::Iter::next() now ignores its consumDegenerates bools. Those will so
668 go away entirely
669 https://review.skia.org/235104
Mike Reedba7e9a62019-08-16 13:30:34 -0400670
Hal Canary2af5db72019-08-20 11:28:37 -0400671 * SkImage: new factories: DecodeToRaster, DecodeToTexture
Hal Canary3b0e7f62019-08-20 14:52:02 -0400672 https://review.skia.org/234476
Mike Reeda5acbf92019-08-14 11:08:41 -0400673
Hal Canary2af5db72019-08-20 11:28:37 -0400674 * SkImageFilter API refactor started:
675 - Provide new factory API in include/effects/SkImageFilters
676 - Consolidated enum types to use SkTileMode and SkColorChannel
677 - Hide filter implementation classes
Hal Canary3b0e7f62019-08-20 14:52:02 -0400678 - Hide previously public functions on SkImageFilter that were intended for
679 internal use only
680 https://review.skia.org/230198
681 https://review.skia.org/230876
682 https://review.skia.org/231256
Florin Malita48009492019-08-01 17:20:19 -0400683
Hal Canary3b0e7f62019-08-20 14:52:02 -0400684 * SkColorFilters::HSLAMatrix - new matrix color filter operating in HSLA
685 space.
686 https://review.skia.org/231736
Brian Salomond4764a12019-08-08 12:08:24 -0400687
Hal Canary3b0e7f62019-08-20 14:52:02 -0400688 * Modify GrBackendFormat getters to not return internal pointers. Use an enum
689 class for GL formats.
690 https://review.skia.org/233160
Brian Salomonec22b1a2019-08-09 09:41:48 -0400691
Hal Canary2af5db72019-08-20 11:28:37 -0400692 * Expose GrContext::dump() when SK_ENABLE_DUMP_GPU is defined.
Hal Canary3b0e7f62019-08-20 14:52:02 -0400693 https://review.skia.org/233557
Sergey Ulanov2739fd22019-08-11 22:46:33 -0700694
Hal Canary3b0e7f62019-08-20 14:52:02 -0400695 * Vulkan backend now supports YCbCr sampler for I420 Vulkan images that are
696 not backed by external images.
697 https://review.skia.org/233776
Leon Scroggins III6154ac42019-08-14 11:29:29 -0400698
Hal Canary3b0e7f62019-08-20 14:52:02 -0400699 * Add SkCodec::SelectionPolicy for distinguishing between decoding a still
700 image or an image sequence for a container format that has both (e.g. HEIF).
701 https://review.skia.org/232839
Brian Osmand566e2e2019-08-14 13:19:04 -0400702
Hal Canary3b0e7f62019-08-20 14:52:02 -0400703 * SkImage::makeTextureImage and SkImage::MakeCrossContextFromPixmap no longer
704 take an SkColorSpace parameter. It was unused.
705 https://review.skia.org/234579
706 https://review.skia.org/234912
Brian Osmand5148372019-08-14 16:14:51 -0400707
Hal Canary3b0e7f62019-08-20 14:52:02 -0400708 * SkImage::reinterpretColorSpace - to reinterpret image contents in a new
709 color space.
710 https://review.skia.org/234328
Brian Osman4c3fd342019-08-15 12:13:53 -0400711
Hal Canary2af5db72019-08-20 11:28:37 -0400712 * Removed SkImage::MakeCrossContextFromEncoded.
Hal Canary3b0e7f62019-08-20 14:52:02 -0400713 https://review.skia.org/234912
Hal Canary2af5db72019-08-20 11:28:37 -0400714
Jim Van Verth066ceb12019-08-28 14:35:55 -0400715 * Add Metal support for GrFence, GrSemaphore, and GrBackendSemaphore
716 https://review.skia.org/233416
717
Hal Canary2af5db72019-08-20 11:28:37 -0400718 * SkMallocPixelRef: remove MakeDirect and MakeWithProc from API.
719 https://review.skia.org/234660
Mike Klein334a6422019-08-27 08:12:15 -0500720
Michael Ludwiga595f862019-08-27 15:25:49 -0400721 * Remove 4-parameter variant of SkRect::join() and intersect(), and
722 noemptycheck variants of intersect().
723 https://review.skia.org/235832
724 https://review.skia.org/237142
725
Mike Klein334a6422019-08-27 08:12:15 -0500726 * Remove unused sk_sp comparison operators.
727 https://review.skia.org/236942
Michael Ludwiga595f862019-08-27 15:25:49 -0400728
729 * Add SkColor4f variant to experimental_DrawEdgeAAQuad for SkiaRenderer.
730 https://review.skia.org/237492
Robert Phillipscf39f372019-09-03 10:29:20 -0400731
732 * Deprecated maxCount resource cache limit for Ganesh.
733 This hasn't been relevant for a long time.
734
Brian Osmana66081d2019-09-03 14:59:26 -0400735 * Changed GrContextOptions' fDisallowGLSLBinaryCaching to fShaderCacheStrategy,
736 and allow caching SkSL.
737 https://review.skia.org/238856
Chris Dalton38f0a492019-10-07 11:51:07 -0600738
739 * Use GL_QCOM_TILED_RENDERING to explicitly discard stencil
Heather Millercc13acb2019-10-22 15:45:45 -0400740
741 * Added RELEASE_NOTES.txt file
742 https://review.skia.org/229760
Chris Dalton5a2f9622019-12-27 14:56:38 -0700743
744 * Implemented internal support for OpenGL tessellation.