Merge origin/main into origin/dev

[yiiqii]

Summary by CodeRabbit

Here are the release notes for version 2.2.0:

• New Features

  • Added support for vertical text alignment in rich text
  • Introduced overflow interface for rich text
  • Added parameters to disable AVIF/WebP image formats
  • Exported rich-text-loader

• Performance

  • Optimized timeline evaluation performance

• Refactoring

  • Updated Stats plugin initialization to support custom containers and visibility
  • Restructured timeline playables

• Bug Fixes

  • Corrected item render order
  • Fixed WebGL creation and player destruction issues
  • Resolved three.js rendering errors

• Dependency Updates

  • Updated various development dependencies to their latest versions

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This release (version 2.2.0) introduces significant enhancements to the Galacean Effects library, focusing on rich text handling, performance optimization, and rendering improvements. Key changes include adding support for vertical text alignment, implementing an overflow interface for rich text, and introducing parameters to disable AVIF and WebP image formats. The update also refactors the Stats plugin initialization, improves timeline playables structure, and addresses various rendering and performance issues.

Changes

File/Group	Change Summary
CHANGELOG-zh_CN.md & CHANGELOG.md	Added version 2.2.0 with new features and fixes
Package Versions	Updated to 2.2.0 across multiple packages
packages/effects-core/src/asset-manager.ts	Added disableWebP and disableAVIF options for image processing
packages/effects-core/src/plugins/text/text-layout.ts	Renamed overFlow to overflow, changed default text overflow behavior
packages/effects-core/src/plugins/timeline/	Extensive refactoring of timeline playables and tracks
plugin-packages/rich-text/src/rich-text-component.ts	Enhanced text overflow handling and initialization
plugin-packages/stats/	Updated Stats plugin with more configurable initialization and debugging

Sequence Diagram

sequenceDiagram
    participant User
    participant Scene
    participant AssetManager
    participant RichTextComponent
    participant TimelinePlayable

    User->>Scene: Load scene with new options
    Scene->>AssetManager: Process images with format options
    AssetManager-->>Scene: Apply image format preferences
    User->>RichTextComponent: Set text overflow mode
    RichTextComponent->>RichTextComponent: Update text rendering
    User->>TimelinePlayable: Initialize with new structure
    TimelinePlayable->>TimelinePlayable: Optimize evaluation process

Loading

Possibly related PRs

• feat: 增加是否禁用 avif/webp 参数 #805: Disabling image formats
• feat: effect component uses track time #640: Rich text overflow handling
• fix: composition reverse delay #648: Stats plugin initialization refactoring
• fix: color property track create wrong mixer #738: Rendering order improvements
• fix: item render order #816: Children render order management
• fix: 修复 WebGL 创建失败， player 销毁报错问题 #817: WebGL creation failure prevention
• fix: 修复 threejs 渲染报错 #818: Rendering error fixes

Suggested Reviewers

• Sruimeng
• RGCHN
• wumaolinmaoan

Poem

🐰 Hop into version two-point-two,
Where render magic comes anew!
Text flows smooth, images bright,
Performance tuned with rabbit's might.
Galacean Effects, a playful dance! 🎨✨

Tip

CodeRabbit's docstrings feature is now available as part of our Early Access Program! Simply use the command @coderabbitai generate docstrings to have CodeRabbit automatically generate docstrings for your pull request. We would love to hear your feedback on Discord.

---

📜 Recent review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 3074284 and 54343cc.

⛔ Files ignored due to path filters (1)

• pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (65)

• CHANGELOG-zh_CN.md (1 hunks)
• CHANGELOG.md (1 hunks)
• package.json (2 hunks)
• packages/effects-core/package.json (1 hunks)
• packages/effects-core/src/asset-manager.ts (1 hunks)
• packages/effects-core/src/comp-vfx-item.ts (4 hunks)
• packages/effects-core/src/components/shape-component.ts (1 hunks)
• packages/effects-core/src/composition-source-manager.ts (0 hunks)
• packages/effects-core/src/composition.ts (1 hunks)
• packages/effects-core/src/math/value-getters/value-getter.ts (6 hunks)
• packages/effects-core/src/plugins/cal/animation-stream.ts (2 hunks)
• packages/effects-core/src/plugins/cal/calculate-item.ts (2 hunks)
• packages/effects-core/src/plugins/cal/playable-graph.ts (4 hunks)
• packages/effects-core/src/plugins/text/text-layout.ts (3 hunks)
• packages/effects-core/src/plugins/timeline/playable-assets/timeline-asset.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/playables/activation-mixer-playable.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/playables/color-property-mixer-playable.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/playables/float-property-mixer-playable.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/playables/index.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/playables/particle-mixer-playable.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/playables/sprite-color-mixer-playable.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/playables/sub-composition-mixer-playable.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/playables/track-mixer-playable.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/playables/transform-mixer-playable.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/playables/vector4-property-mixer-playable.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/track.ts (6 hunks)
• packages/effects-core/src/plugins/timeline/tracks/activation-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/color-property-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/float-property-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/index.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/particle-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/property-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/sprite-color-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/sub-composition-track.ts (2 hunks)
• packages/effects-core/src/plugins/timeline/tracks/transform-track.ts (1 hunks)
• packages/effects-core/src/plugins/timeline/tracks/vector4-property-track.ts (1 hunks)
• packages/effects-core/src/scene.ts (2 hunks)
• packages/effects-core/src/vfx-item.ts (1 hunks)
• packages/effects-helper/package.json (1 hunks)
• packages/effects-threejs/package.json (1 hunks)
• packages/effects-threejs/src/material/three-material.ts (2 hunks)
• packages/effects-webgl/package.json (1 hunks)
• packages/effects/package.json (1 hunks)
• packages/effects/src/player.ts (1 hunks)
• plugin-packages/alipay-downgrade/package.json (1 hunks)
• plugin-packages/downgrade/package.json (1 hunks)
• plugin-packages/editor-gizmo/package.json (1 hunks)
• plugin-packages/model/package.json (1 hunks)
• plugin-packages/multimedia/package.json (1 hunks)
• plugin-packages/orientation-transformer/package.json (1 hunks)
• plugin-packages/rich-text/demo/src/simple.ts (2 hunks)
• plugin-packages/rich-text/package.json (1 hunks)
• plugin-packages/rich-text/src/index.ts (1 hunks)
• plugin-packages/rich-text/src/rich-text-component.ts (6 hunks)
• plugin-packages/spine/package.json (1 hunks)
• plugin-packages/stats/package.json (1 hunks)
• plugin-packages/stats/src/core.ts (2 hunks)
• plugin-packages/stats/src/hooks/drawcall-hook.ts (1 hunks)
• plugin-packages/stats/src/hooks/program-hook.ts (2 hunks)
• plugin-packages/stats/src/hooks/shader-hook.ts (3 hunks)
• plugin-packages/stats/src/hooks/texture-hook.ts (3 hunks)
• plugin-packages/stats/src/monitor.ts (7 hunks)
• plugin-packages/stats/src/stats-component.ts (1 hunks)
• plugin-packages/stats/src/stats.ts (3 hunks)
• web-packages/imgui-demo/src/panels/node-graph/node-graph.ts (2 hunks)

---

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

• Review comments: Directly reply to a review comment made by CodeRabbit. Example:
  • I pushed a fix in commit <commit_id>, please review it.
  • Generate unit testing code for this file.
  • Open a follow-up GitHub issue for this discussion.
• Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
  • @coderabbitai generate unit testing code for this file.
  • @coderabbitai modularize this function.
• PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
  • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
  • @coderabbitai read src/utils.ts and generate unit testing code.
  • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
  • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

• @coderabbitai pause to pause the reviews on a PR.
• @coderabbitai resume to resume the paused reviews.
• @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
• @coderabbitai full review to do a full review from scratch and review all the files again.
• @coderabbitai summary to regenerate the summary of the PR.
• @coderabbitai generate docstrings to generate docstrings for this PR. (Beta)
• @coderabbitai resolve resolve all the CodeRabbit review comments.
• @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
• @coderabbitai help to get help.

Other keywords and placeholders

• Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
• Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
• Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

• Visit our Documentation for detailed information on how to use CodeRabbit.
• Join our Discord Community to get help, request features, and share feedback.
• Follow us on X/Twitter for updates and announcements.