@next2d/player 2.6.0 → 2.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +93 -2
- package/next2d.js +58 -58
- package/package.json +25 -24
- package/src/index.js +1 -1
package/README.md
CHANGED
|
@@ -5,7 +5,7 @@ Next2D Player
|
|
|
5
5
|
</div>
|
|
6
6
|
|
|
7
7
|
[](https://github.com/Next2D/Player/actions/workflows/integration.yml)
|
|
8
|
-
[](https://github.com/Next2D/player/actions/workflows/github-code-scanning/codeql)
|
|
9
9
|
[](https://github.com/Next2D/Player/actions/workflows/lint.yml)
|
|
10
10
|
|
|
11
11
|
[](https://github.com/Next2D/Player/releases)
|
|
@@ -123,7 +123,98 @@ start();
|
|
|
123
123
|
| `bgColor` | string | "transparent" | 你可以指定一个十六进制的背景颜色。默认为无色。 |
|
|
124
124
|
|
|
125
125
|
## Flowchart
|
|
126
|
-
|
|
126
|
+
|
|
127
|
+
```mermaid
|
|
128
|
+
flowchart TB
|
|
129
|
+
%% Main Drawing Flow Chart
|
|
130
|
+
subgraph MainFlow["🎨 Drawing Flow Chart - Main Rendering Pipeline"]
|
|
131
|
+
direction TB
|
|
132
|
+
|
|
133
|
+
subgraph Inputs["Display Objects"]
|
|
134
|
+
Shape["Shape<br/>(Bitmap/Vector)"]
|
|
135
|
+
TextField["TextField<br/>(canvas2d)"]
|
|
136
|
+
Video["Video Element"]
|
|
137
|
+
end
|
|
138
|
+
|
|
139
|
+
Shape --> MaskCheck
|
|
140
|
+
TextField --> MaskCheck
|
|
141
|
+
Video --> MaskCheck
|
|
142
|
+
|
|
143
|
+
MaskCheck{"mask<br/>rendering?"}
|
|
144
|
+
|
|
145
|
+
MaskCheck -->|YES| DirectRender["Direct Rendering"]
|
|
146
|
+
DirectRender -->|drawArrays| FinalRender
|
|
147
|
+
|
|
148
|
+
MaskCheck -->|NO| CacheCheck1{"cache<br/>exists?"}
|
|
149
|
+
|
|
150
|
+
CacheCheck1 -->|NO| TextureAtlas["📦 Texture Atlas<br/>(Binary Tree Packing)"]
|
|
151
|
+
TextureAtlas --> Coordinates
|
|
152
|
+
|
|
153
|
+
CacheCheck1 -->|YES| Coordinates["📍 Coordinates DB<br/>(x, y, w, h)"]
|
|
154
|
+
|
|
155
|
+
Coordinates --> FilterBlendCheck{"filter or<br/>blend?"}
|
|
156
|
+
|
|
157
|
+
FilterBlendCheck -->|NO| MainArrays
|
|
158
|
+
FilterBlendCheck -->|YES| NeedCache{"cache<br/>exists?"}
|
|
159
|
+
|
|
160
|
+
NeedCache -->|NO| CacheRender["Render to Cache"]
|
|
161
|
+
CacheRender --> TextureCache
|
|
162
|
+
NeedCache -->|YES| TextureCache["💾 Texture Cache"]
|
|
163
|
+
|
|
164
|
+
TextureCache -->|drawArrays| FinalRender
|
|
165
|
+
|
|
166
|
+
MainArrays["⚡ Instanced Arrays<br/>━━━━━━━━━━━━━━━<br/>matrix<br/>colorTransform<br/>Coordinates<br/>━━━━━━━━━━━━━━━<br/><b>Batch Rendering</b>"]
|
|
167
|
+
|
|
168
|
+
MainArrays -->|drawArraysInstanced<br/><b>Multiple objects in one call</b>| FinalRender["🎬 Final Rendering"]
|
|
169
|
+
|
|
170
|
+
FinalRender -->|60fps| MainFramebuffer["🖥️ Main Framebuffer<br/>(Display)"]
|
|
171
|
+
end
|
|
172
|
+
|
|
173
|
+
%% Branch Flow for Filter/Blend/Mask
|
|
174
|
+
subgraph BranchFlow["🎭 Filter/Blend/Mask - Branch Processing"]
|
|
175
|
+
direction TB
|
|
176
|
+
|
|
177
|
+
subgraph FilterInputs["Display Objects"]
|
|
178
|
+
Shape2["Shape<br/>(Bitmap/Vector)"]
|
|
179
|
+
TextField2["TextField<br/>(canvas2d)"]
|
|
180
|
+
Video2["Video Element"]
|
|
181
|
+
end
|
|
182
|
+
|
|
183
|
+
Shape2 --> CacheCheck2
|
|
184
|
+
TextField2 --> CacheCheck2
|
|
185
|
+
Video2 --> CacheCheck2
|
|
186
|
+
|
|
187
|
+
CacheCheck2{"cache<br/>exists?"}
|
|
188
|
+
|
|
189
|
+
CacheCheck2 -->|NO| EffectRender["Effect Rendering"]
|
|
190
|
+
CacheCheck2 -->|YES| BranchArrays
|
|
191
|
+
EffectRender --> BranchArrays
|
|
192
|
+
|
|
193
|
+
BranchArrays["⚡ Instanced Arrays<br/>━━━━━━━━━━━━━━━<br/>matrix<br/>colorTransform<br/>Coordinates<br/>━━━━━━━━━━━━━━━<br/><b>Batch Rendering</b>"]
|
|
194
|
+
|
|
195
|
+
BranchArrays -->|drawArraysInstanced<br/><b>Multiple objects in one call</b>| BranchRender["Effect Result"]
|
|
196
|
+
|
|
197
|
+
BranchRender -->|filter/blend| TextureCache
|
|
198
|
+
end
|
|
199
|
+
|
|
200
|
+
%% Connections between flows
|
|
201
|
+
FilterBlendCheck -.->|"trigger<br/>branch flow"| BranchFlow
|
|
202
|
+
BranchArrays -.->|"rendering info<br/>(coordinates)"| MainArrays
|
|
203
|
+
|
|
204
|
+
%% Styling
|
|
205
|
+
style MainFlow fill:#e3f2fd,stroke:#1976d2,stroke-width:3px
|
|
206
|
+
style BranchFlow fill:#fff3e0,stroke:#f57c00,stroke-width:3px
|
|
207
|
+
style Inputs fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px
|
|
208
|
+
style FilterInputs fill:#f5f5f5,stroke:#9e9e9e,stroke-width:1px
|
|
209
|
+
|
|
210
|
+
style MainArrays fill:#c8e6c9,stroke:#388e3c,stroke-width:3px
|
|
211
|
+
style BranchArrays fill:#c8e6c9,stroke:#388e3c,stroke-width:3px
|
|
212
|
+
style FinalRender fill:#ffecb3,stroke:#f57f17,stroke-width:2px
|
|
213
|
+
style MainFramebuffer fill:#c5e1a5,stroke:#689f38,stroke-width:3px
|
|
214
|
+
style TextureCache fill:#e1bee7,stroke:#8e24aa,stroke-width:2px
|
|
215
|
+
style Coordinates fill:#b3e5fc,stroke:#0277bd,stroke-width:2px
|
|
216
|
+
style TextureAtlas fill:#fff9c4,stroke:#f9a825,stroke-width:2px
|
|
217
|
+
```
|
|
127
218
|
|
|
128
219
|
## License
|
|
129
220
|
This project is licensed under the [MIT License](https://opensource.org/licenses/MIT) - see the [LICENSE](LICENSE) file for details.
|