newpaint release (v0.3.11)

[kkoreilly]

We have merged #1457 (v0.3.11), which is a major PR that greatly improves our rendering infrastructure and performance, especially on web. However, it comes with multiple breaking changes, which are documented down below. Please let us know if you have any issues or questions.

To use the new version, run go get cogentcore.org/[email protected] and then go mod tidy. Please note that you must reinstall the core tool (go install cogentcore.org/core/cmd/[email protected]) as there have been changes to it, especially for web.

Improvements

• Rendering on web now happens primarily through HTML Canvas functions (stroke, fill, fillText, etc), which results in massive performance improvements
  • This is particularly notable when scrolling on an app with large amounts of text, such as the docs
  • Gradient rendering is much faster on web now, as shown by the color picker docs
• International fonts and emojis are now supported on all platforms, including web and native (Improve default fonts and support displaying all unicode characters (using go-text) #568)
  • If you have the right font installed somewhere on your operating system, it will render things correctly
  • We now use go-text for font and text management
• Character-specific text selection of normal read-only text is now supported on all platforms (Support character-specific text selection #1051)
• The scrolling speed is now more accurate on all platforms, and the slide scrolling animations on mobile are improved
• The final rendering phase happens asynchronously, which reduces hanging and improves performance
• The rendering architecture is now more robust and is documented on the website
  • The new rendering system will allow us to add video support on web soon (Add multimedia support (audio and video playback and capture) #516)
• Added robust animations that stay in sync with the app frame rate
• The text editor architecture has been redesigned in a more effective and extensible way
  • Text editors are now much more performant
  • Text editors now automatically size more accurately based on their content
  • We will now be able to add a terminal widget soon (terminal emulator widget #959)
• Added a new collapser widget to allow the user to toggle whether details are shown
• Dialogs are automatically centered relative to their context widget
• The default font has been updated from Roboto to Noto Sans, with the mono font remaining Roboto Mono
• Support for CSL-based citation management and automatically numbered figures has been added to Cogent Content
• Various bug fixes related to rendering and htmlcore

Breaking changes

• The API for font styling has changed
  • See the text docs for reference
  • Text alignment and whitespace enums are now in text instead of styles. For example, styles.Center is now text.Center (only for text; layout alignment still uses styles.Center).
  • Font styling enums like weight, italic, and decoration are now in rich instead of styles. For example, styles.WeightBold is now rich.Bold and styles.Underline is now rich.Underline.
  • The property for italic is now called s.Font.Slant instead of s.Font.Style
  • s.Font.Family is now an enum, with s.Font.CustomFont used for specific font families. Instead of s.SetMono(true), you now set s.Font.Family = rich.Monospace. See the font family docs.
  • The API for custom fonts has changed (see the new documentation)
• The paint API, used in the canvas widget, has changed
  • See the canvas docs for reference
  • Instead of calling Stroke() and/or Fill(), you now call Draw(), which does both if applicable
  • pc.StrokeStyle is now pc.Stroke, and pc.FillStyle is now pc.Fill
  • The Draw prefix has been dropped from many functions. For example, DrawCircle is now just Circle
  • Some advanced drawing functions take different arguments than they used to. Consult the website and API docs, and ask us if you have any questions.
• The text editor API has changed
  • For most simple use cases, the main changes are renaming texteditor to textcore and Buffer to Lines
  • See the updated text editor docs for reference
  • Options have been renamed to Settings
  • If you were accessing low-level things previously that no longer work, please ask us and we can help you update
• Some packages and types have been moved around
  • For example, cogentcore.org/core/parse is now cogentcore.org/core/text/parse
  • Except for the breaking changes listed earlier, most of these renames should not impact end-user code, but please let us know if you run into any issues.
• The old IsVisible has been renamed to IsDisplayable, with the new version of IsVisible checking whether the widget is actually currently visible.

Next steps

This PR is a major redesign of our infrastructure, and it fixes many issues as discussed above. Now that we have completed this significant refactor, we should have more time for addressing other issues and adding new features. Please see the v1 Roadmap (#1526) for an outline of our plans going forward.