skia2/modules/canvaskit/CHANGELOG.md
Kevin Lubick 6b921b7e4a [canvaskit] add support for SkAnimatedImage
Also adds tests for static png,jpg,gif

Was unable to simply expose drawDrawable because the JS
side of things does not understand inheritance (specifically,
it doesn't know what is a descendant from SkDrawable).

Change-Id: I6a833c93f22ef90ae12e901168ff428e20504209
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/242562
Reviewed-by: Kevin Lubick <kjlubick@google.com>
2019-09-20 18:34:01 +00:00

171 lines
7.5 KiB
Markdown

# CanvasKit Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
### Added
- `CanvasKit.MakeAnimatedImageFromEncoded`, `SkCanvas.drawAnimatedImage`.
## [0.7.0] - 2019-09-18
### Added
- `SkCanvas.drawCircle()`, `SkCanvas.getSaveCount()`
- `SkPath.offset()`, `SkPath.drawOval`
- `SkRRect` support (`SkCanvas.drawRRect`, `SkCanvas.drawDRRect`, `CanvasKit.RRectXY`).
Advanced users can specify the 8 individual radii, if needed.
- `CanvasKit.computeTonalColors()`, which returns TonalColors, which has an
ambient SkColor and a spot SkColor.
- `CanvasKit.SkColorFilter` and a variety of factories. `SkPaint.setColorFilter` is the only
consumer of these at the moment.
- `CanvasKit.SkColorMatrix` with functions `.identity()`, `.scaled()`, `.concat()` and
others. Primarily for use with `CanvasKit.SkColorFilter.MakeMatrix`.
### Changed
- `MakeSkVertices` uses a builder to save a copy.
### Breaking
- When `SkPath.arcTo` is given seven arguments, it no longer turns the first four into
a `SkRect` automatically, and instead uses them as
`arcTo(rx, ry, xAxisRotate, useSmallArc, isCCW, x, y)` (see SkPath.h for more).
## [0.6.0] - 2019-05-06
### Added
- `SkSurface.grContext` now exposed. `GrContext` has new methods for monitoring/setting
the cache limits; tweaking these may lead to better performance in some cases.
`getResourceCacheLimitBytes`, `setResourceCacheLimitBytes`, `getResourceCacheUsageBytes`
- `SkCanvas.drawAtlas` for efficiently drawing multiple sprites from a sprite sheet with
a set of transforms, color blends, etc.
- `SkColorBuilder`, `RSXFormBuilder`, `SkRectBuilder` which increase performance by
reducing the amount of malloc/free calls per frame, given that the array size is fixed.
- Basic `SkPicture` support. `SkSurface.captureFrameAsSkPicture` is a helper function to
capture an `SkPicture`, which can be dumped to disk (for debugging) with
`SkPicture.DEBUGONLY_saveAsFile`.
- `SkImage.readPixels`, which returns a TypedArray of pixel values (safe to use
anywhere, doesn't need a delete()).
### Changed
- Better `GrGLCaps` support for WebGL - this shouldn't have any impacts on APIs or
correctness, except by perhaps fixing a few bugs in various surface types.
- Use unsigned ints for SkColor on the JS side - this shouldn't have any impacts
unless clients have pre-computed colors, in which case, they will need to re-compute them.
- [breaking] Moved `CanvasKit.MakeImageShader` to `SkImage.makeShader` - removed clampUnpremul
as argument.
## [0.5.1] - 2019-03-21
### Added
- `SkPathMeasure`, `RSXFormBuilder`, `SkFont.getWidths`, `SkTextBlob.MakeFromRSXform`
which were needed to add the helper function `SkTextBlob.MakeOnPath`.
- `SkSurface.requestAnimationFrame` - wrapper around window.requestAnimationFrame that
takes care of the setup/tear down required to use CanvasKit optimally. The callback
has an `SkCanvas` as the first parameter - callers should draw on that.
### Changed
- Location in Skia Git repo now `modules/canvaskit` (was `experimental/canvaskit`)
### Fixed
- Extern bug in `CanvasKit.SkMatrix.invert`
- Fallback to CPU now properly refreshes the canvas to get access to the
CanvasRenderingContext2D.
- Compile flags for better WebGL1 support for some graphics cards.
- Antialias bug on large oval paths <https://crbug.com/skia/8873>
### Deprecated
- `SkCanvas.flush` will be removed soon - client should only call `SkSurface.flush`
## [0.5.0] - 2019-03-08
### Added
- isVolitile option to `CanvasKit.MakeSkVertices`. The previous (and current default) behavior
was for this to be true; some applications may go faster if set to false.
- `SkCanvas.saveLayer(rect, paint)`
- `SkCanvas.restoreToCount(int)` which can be used with the output of .save() and .saveLayer().
- Optional particles library from modules/particles. `See CanvasKit.MakeParticles(json)`;
- More public APIs for working with Surfaces/Contexts `GetWebGLContext`,
`MakeGrContext`, `MakeOnScreenGLSurface`, `MakeRenderTarget`.
- `SkSurface.getSurface()` and `SkCanvas.getSurface()` for making compatible surfaces (typically
used as a workspace and then "saved" with `surface.makeImageSnapshot()`)
### Breaking
- `CanvasKit.MakeWebGLCanvasSurface` no longer takes a webgl context as a first arg, only a
canvas or an id of a canvas. If users want to manage their own GL contexts, they should build
the `SkSurface` themselves with `GetWebGLContext` -> `MakeGrContext` ->
`MakeOnScreenGLSurface`.
## [0.4.1] - 2019-03-01
### Added
- Optional arguments to `MakeManagedAnimation` for supplying external assets (like images, fonts).
## [0.4.0] - 2019-02-25
### Added
- `SkPath.addRoundRect`, `SkPath.reset`, `SkPath.rewind` exposed.
- `SkCanvas.drawArc`, `SkCanvas.drawLine`, `SkCanvas.drawOval`, `SkCanvas.drawRoundRect` exposed.
- Can import/export a SkPath to an array of commands. See `CanvasKit.MakePathFromCmds` and
`SkPath.toCmds`.
- `SkCanvas.drawTextBlob()` and `SkCanvas.SkTextBlob.MakeFromText()` to draw text to a canvas.
- `CanvasKit.TextEncoding` enum. For use with `SkTextBlob`.
- Text shaping with `ShapedText` object and `SkCanvas.drawText`. At compile time, one can choose
between using Harfbuzz/ICU (default) or a primitive one ("primitive_shaper") which just does
line breaking. Using Harfbuzz/ICU substantially increases code size (4.3 MB to 6.4 MB).
### Changed
- `SkCanvas.drawText()` now requires an `SkFont` object for raw strings.
### Removed
- `SkPaint.setTextSize()`, `SkPaint.getTextSize()`, `SkPaint.setTypeface()`
which should be replaced by using `SkFont`.
- Deprecated `CanvasKitInit().then()` interface (see 0.3.1 notes)
### Fixed
- Potential bug in `ready()` if already loaded.
## [0.3.1] - 2019-01-04
### Added
- `SkFont` now exposed.
- `MakeCanvasSurface` can now take a canvas element directly.
- `MakeWebGLCanvasSurface` can now take a WebGL context as an integer and use it directly.
### Changed
- `CanvasKitInit(...).then()` is no longer the recommended way to initialize things.
It will be removed in 0.4.0. Use `CanvasKitInit(...).ready()`, which returns a real Promise.
### Removed
- `SkPaint.measureText` - use `SkFont.measureText` instead.
## [0.3.0] - 2018-12-18
### Added
- Add Canvas2D JS layer. This mirrors the HTML Canvas API. This may be omitted at compile time
it by adding `no_canvas` to the `compile.sh` invocation.
- `CanvasKit.FontMgr.DefaultRef()` and `fontmgr.MakeTypefaceFromData` to load fonts.
- Exposed `SkPath.setVolatile`. Some animations see performance improvements by setting
their paths' volatility to true.
### Fixed
- `SkPath.addRect` now correctly draws counter-clockwise vs clockwise.
### Changed
- `CanvasKit.MakeImageShader` no longer takes encoded bytes, but an `SkImage`, created from
`CanvasKit.MakeImageFromEncoded`. Additionally, the optional parameters `clampIfUnpremul`
and `localMatrix` have been exposed.
- `SkPath.arcTo` now takes `startAngle`, `sweepAngle`, `forceMoveTo` as additional parameters.
- `SkPath.stroke` has a new option `precision` It defaults to 1.0.
- CanvasKit comes with one font (NotoMono) instead of the Skia TestTypeface. Clients are encouraged
to use the new `fontmgr.MakeTypefaceFromData` for more font variety.
### Removed
- `CanvasKit.initFonts()` - no longer needed.
## [0.2.1] - 2018-11-20
Beginning of Changelog history