@combos-fun/plugin-renderer-render 0.0.45 → 0.0.47
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/agent-skill.md +9 -31
- package/package.json +5 -5
package/agent-skill.md
CHANGED
|
@@ -1,44 +1,22 @@
|
|
|
1
1
|
# `@combos-fun/plugin-renderer-render` — Agent notes
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
## When to read
|
|
6
|
-
|
|
7
|
-
Read whenever you need to hide / fade an object, change draw order, or turn on z-sorted children inside a container.
|
|
8
|
-
|
|
9
|
-
## Public API
|
|
3
|
+
Read only for per-GameObject visibility, opacity, or sibling draw ordering.
|
|
10
4
|
|
|
11
5
|
```ts
|
|
12
6
|
import { Render, RenderSystem, type RenderParams } from '@combos-fun/plugin-renderer-render';
|
|
13
7
|
```
|
|
14
8
|
|
|
15
|
-
`componentName = 'Render'
|
|
9
|
+
`Render.componentName = 'Render'`; `RenderSystem.systemName = 'Render'`.
|
|
16
10
|
|
|
17
11
|
| Field | Type | Default |
|
|
18
|
-
|
|
19
|
-
| `visible` | `boolean
|
|
20
|
-
| `alpha` | `number
|
|
21
|
-
| `zIndex` | `number
|
|
22
|
-
| `sortableChildren` | `boolean
|
|
23
|
-
|
|
24
|
-
## Required setup
|
|
25
|
-
|
|
26
|
-
`RendererSystem` (from `plugin-renderer`) must be added before `RenderSystem`.
|
|
27
|
-
|
|
28
|
-
## Common pitfalls
|
|
29
|
-
|
|
30
|
-
| Symptom | Fix |
|
|
31
|
-
|---------|-----|
|
|
32
|
-
| Wrong stacking order | Set `sortableChildren: true` on the parent's `Render` and `zIndex` on children |
|
|
33
|
-
| Object visible despite `visible: false` | Confirm `RenderSystem` is registered |
|
|
34
|
-
| Fade has no effect | Confirm `alpha` is between 0 and 1 |
|
|
35
|
-
|
|
36
|
-
## Minimal example
|
|
12
|
+
|---|---|---|
|
|
13
|
+
| `visible` | `boolean?` | `true` |
|
|
14
|
+
| `alpha` | `number?` | `1` |
|
|
15
|
+
| `zIndex` | `number?` | `0` |
|
|
16
|
+
| `sortableChildren` | `boolean?` | `false` |
|
|
37
17
|
|
|
38
18
|
```ts
|
|
39
|
-
go.addComponent(new Render({ visible: true, alpha:
|
|
19
|
+
go.addComponent(new Render({ visible: true, alpha: 0.75, zIndex: 5 }));
|
|
40
20
|
```
|
|
41
21
|
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
`pnpm --filter @combos-fun/plugin-renderer-render run build`.
|
|
22
|
+
`alpha` and `visible` are copied to the GameObject container each frame. Ordering is explicit: put `Render({ sortableChildren: true })` on the parent and `Render({ zIndex })` on its children. Changing a child's `zIndex` marks the parent for sorting; a bare `zIndex` without the parent setting does not reorder siblings.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@combos-fun/plugin-renderer-render",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.47",
|
|
4
4
|
"description": "Per-GameObject visibility / alpha / zIndex / sortable-children control",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"module": "dist/plugin-renderer-render.esm.js",
|
|
@@ -36,10 +36,10 @@
|
|
|
36
36
|
"author": "sun668 <q947692259@gmail.com>",
|
|
37
37
|
"dependencies": {
|
|
38
38
|
"pixi.js": "^8.18.1",
|
|
39
|
-
"@combos-fun/
|
|
40
|
-
"@combos-fun/
|
|
41
|
-
"@combos-fun/
|
|
42
|
-
"@combos-fun/
|
|
39
|
+
"@combos-fun/renderer-adapter": "0.0.47",
|
|
40
|
+
"@combos-fun/engine": "0.0.47",
|
|
41
|
+
"@combos-fun/inspector-decorator": "0.0.47",
|
|
42
|
+
"@combos-fun/plugin-renderer": "0.0.47"
|
|
43
43
|
},
|
|
44
44
|
"scripts": {
|
|
45
45
|
"build": "node ../../scripts/build-package.mjs"
|