@kubohiroya/turbowarp-bubble 0.1.0 → 0.2.0
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 +225 -31
- package/dist/composition.js +696 -625
- package/dist/extension-manifest.json +22 -22
- package/dist/turbowarp-adapter.js +1209 -533
- package/dist/turbowarp-bubble.js +1800 -346
- package/dist/types/composition.d.ts +49 -17
- package/dist/types/turbowarp-adapter.d.ts +10 -2
- package/docs/assets/animation-mode-guide.svg +2 -2
- package/docs/assets/block-quick-start.svg +8 -8
- package/docs/assets/bubble-lifecycle.gif +0 -0
- package/docs/block-manual.ja.md +37 -37
- package/docs/block-manual.md +44 -44
- package/docs/index.html +31 -31
- package/docs/ja/index.html +23 -23
- package/package.json +40 -31
|
@@ -1,5 +1,3 @@
|
|
|
1
|
-
import type { AssetManagerComposition, AssetManagerCompositionTarget } from "@kubohiroya/turbowarp-asset-manager/composition";
|
|
2
|
-
import type { SvgTextComposition, SvgTextTarget } from "@kubohiroya/turbowarp-svg-text/composition";
|
|
3
1
|
import { type BubblePlacement, type BubblePlacementInput } from "./placement.js";
|
|
4
2
|
import { type BubbleOffset, type BubbleOffsetInput } from "./actor-transform.js";
|
|
5
3
|
import { type BubbleVisualStyle } from "./bubble-svg.js";
|
|
@@ -8,8 +6,8 @@ export { bubbleBackgroundRegions, bubbleDirectionAliases, bubbleDirectionNames,
|
|
|
8
6
|
export { actorRelativeBubbleCenter, defaultBubbleDistance, defaultBubbleOffset, defaultBubbleTailLength, normalizeBubbleDistance, normalizeBubbleOffset, normalizeBubbleTailLength, type ActorBounds, type ActorRelativeCenterInput, type BubbleOffset, type BubbleOffsetInput, } from "./actor-transform.js";
|
|
9
7
|
export { bubbleBodyCenterOffset, bubbleVisualStyles, renderBubbleSvg, type BubbleBodyCenterOffsetInput, type BubbleVisualStyle, type RenderBubbleSvgInput, } from "./bubble-svg.js";
|
|
10
8
|
export type BubbleKind = "say" | "think";
|
|
11
|
-
export type BubbleAnimationMode = "idle" | "talking" | "awaiting-
|
|
12
|
-
export type BubbleLayer = "portraitBase" | "portraitBlink" | "
|
|
9
|
+
export type BubbleAnimationMode = "idle" | "talking" | "awaiting-continue";
|
|
10
|
+
export type BubbleLayer = "portraitBase" | "portraitBlink" | "portraitLipSync" | "continueIndicator";
|
|
13
11
|
export interface BubbleFrameAnimationInput {
|
|
14
12
|
readonly frames: ReadonlyArray<string>;
|
|
15
13
|
readonly frameIntervalSeconds: number;
|
|
@@ -17,18 +15,20 @@ export interface BubbleFrameAnimationInput {
|
|
|
17
15
|
export interface BubblePortraitInput {
|
|
18
16
|
readonly base: string;
|
|
19
17
|
readonly blink?: BubbleFrameAnimationInput;
|
|
20
|
-
readonly
|
|
18
|
+
readonly lipSync?: BubbleFrameAnimationInput;
|
|
21
19
|
}
|
|
22
20
|
export interface BubbleStyleInput {
|
|
23
21
|
readonly name: string;
|
|
24
22
|
readonly textStyle: string;
|
|
23
|
+
readonly maxWidth?: number;
|
|
24
|
+
readonly textLocale?: string;
|
|
25
25
|
readonly placement?: BubblePlacementInput;
|
|
26
26
|
readonly distance?: number;
|
|
27
27
|
readonly tailLength?: number;
|
|
28
28
|
readonly offset?: BubbleOffsetInput;
|
|
29
29
|
readonly visualStyle?: BubbleVisualStyle;
|
|
30
30
|
readonly portrait?: BubblePortraitInput;
|
|
31
|
-
readonly
|
|
31
|
+
readonly continueIndicator?: BubbleFrameAnimationInput;
|
|
32
32
|
}
|
|
33
33
|
export interface BubbleFrameAnimation {
|
|
34
34
|
readonly frames: ReadonlyArray<string>;
|
|
@@ -37,31 +37,61 @@ export interface BubbleFrameAnimation {
|
|
|
37
37
|
export interface BubblePortrait {
|
|
38
38
|
readonly base: string;
|
|
39
39
|
readonly blink?: BubbleFrameAnimation;
|
|
40
|
-
readonly
|
|
40
|
+
readonly lipSync?: BubbleFrameAnimation;
|
|
41
41
|
}
|
|
42
42
|
export interface BubbleStyle {
|
|
43
43
|
readonly name: string;
|
|
44
44
|
readonly textStyle: string;
|
|
45
|
+
readonly maxWidth?: number;
|
|
46
|
+
readonly textLocale?: string;
|
|
45
47
|
readonly placement: BubblePlacement;
|
|
46
48
|
readonly distance: number;
|
|
47
49
|
readonly tailLength: number;
|
|
48
50
|
readonly offset: BubbleOffset;
|
|
49
51
|
readonly visualStyle: BubbleVisualStyle;
|
|
50
52
|
readonly portrait?: BubblePortrait;
|
|
51
|
-
readonly
|
|
53
|
+
readonly continueIndicator?: BubbleFrameAnimation;
|
|
54
|
+
}
|
|
55
|
+
export interface BubbleAssetTarget {
|
|
56
|
+
readonly id: string;
|
|
57
|
+
readonly isStage: boolean;
|
|
58
|
+
}
|
|
59
|
+
export interface BubbleImageCapability {
|
|
60
|
+
readonly applyToTarget: (name: unknown, target: BubbleAssetTarget) => void | Promise<void>;
|
|
61
|
+
readonly getMimeType: (name: unknown) => string;
|
|
62
|
+
readonly isRegistered: (name: unknown) => boolean;
|
|
63
|
+
}
|
|
64
|
+
export interface BubbleAudioCapability {
|
|
65
|
+
readonly playSound: (name: unknown, options?: Readonly<{
|
|
66
|
+
untilDone?: boolean;
|
|
67
|
+
}>) => Promise<void>;
|
|
68
|
+
}
|
|
69
|
+
export interface BubbleTextTarget {
|
|
70
|
+
readonly drawableID: number;
|
|
71
|
+
}
|
|
72
|
+
export interface BubbleSvgText {
|
|
73
|
+
readonly setText: (input: {
|
|
74
|
+
readonly styleName: string;
|
|
75
|
+
readonly target: BubbleTextTarget;
|
|
76
|
+
readonly text: string;
|
|
77
|
+
}) => void;
|
|
78
|
+
readonly releaseTarget: (target: BubbleTextTarget) => void;
|
|
79
|
+
readonly measureText?: (input: {
|
|
80
|
+
readonly styleName: string;
|
|
81
|
+
readonly text: string;
|
|
82
|
+
}) => number;
|
|
52
83
|
}
|
|
53
|
-
export type BubbleAssetManager = Pick<AssetManagerComposition, "applyToTarget" | "getMimeType" | "isRegistered">;
|
|
54
|
-
export type BubbleSvgText = Pick<SvgTextComposition, "releaseTarget" | "setText">;
|
|
55
84
|
export interface BubbleSurfaceTargets {
|
|
56
|
-
readonly text:
|
|
57
|
-
readonly portraitBase?:
|
|
58
|
-
readonly portraitBlink?:
|
|
59
|
-
readonly
|
|
60
|
-
readonly
|
|
85
|
+
readonly text: BubbleTextTarget;
|
|
86
|
+
readonly portraitBase?: BubbleAssetTarget;
|
|
87
|
+
readonly portraitBlink?: BubbleAssetTarget;
|
|
88
|
+
readonly portraitLipSync?: BubbleAssetTarget;
|
|
89
|
+
readonly continueIndicator?: BubbleAssetTarget;
|
|
61
90
|
}
|
|
62
91
|
export interface BubbleSurface {
|
|
63
92
|
readonly targets: BubbleSurfaceTargets;
|
|
64
93
|
setLayerVisible(layer: BubbleLayer, visible: boolean): void | Promise<void>;
|
|
94
|
+
updateStyle(style: BubbleStyle): void | Promise<void>;
|
|
65
95
|
show(): void | Promise<void>;
|
|
66
96
|
hide(): void | Promise<void>;
|
|
67
97
|
dispose(): void | Promise<void>;
|
|
@@ -83,7 +113,8 @@ export interface BubbleAnimationErrorContext {
|
|
|
83
113
|
readonly assetName: string;
|
|
84
114
|
}
|
|
85
115
|
export interface BubbleCompositionOptions {
|
|
86
|
-
readonly
|
|
116
|
+
readonly imageResolver?: BubbleImageCapability;
|
|
117
|
+
readonly audio?: BubbleAudioCapability;
|
|
87
118
|
readonly svgText: BubbleSvgText;
|
|
88
119
|
readonly createSurface: BubbleSurfaceFactory;
|
|
89
120
|
readonly scheduler?: BubbleScheduler;
|
|
@@ -102,6 +133,7 @@ export interface BubbleHandle {
|
|
|
102
133
|
readonly kind: BubbleKind;
|
|
103
134
|
readonly animationMode: BubbleAnimationMode;
|
|
104
135
|
setText(text: string): Promise<void>;
|
|
136
|
+
updateStyle(style: BubbleStyleInput): Promise<void>;
|
|
105
137
|
setAnimationMode(mode: BubbleAnimationMode): Promise<void>;
|
|
106
138
|
close(): Promise<void>;
|
|
107
139
|
}
|
|
@@ -113,7 +145,7 @@ export interface BubbleComposition {
|
|
|
113
145
|
releaseAll(): Promise<void>;
|
|
114
146
|
dispose(): Promise<void>;
|
|
115
147
|
}
|
|
116
|
-
export type BubbleCompositionErrorCode = "BUBBLE-COMPOSITION-001" | "BUBBLE-COMPOSITION-002" | "BUBBLE-COMPOSITION-003" | "BUBBLE-COMPOSITION-004" | "BUBBLE-COMPOSITION-005";
|
|
148
|
+
export type BubbleCompositionErrorCode = "BUBBLE-COMPOSITION-001" | "BUBBLE-COMPOSITION-002" | "BUBBLE-COMPOSITION-003" | "BUBBLE-COMPOSITION-004" | "BUBBLE-COMPOSITION-005" | "BUBBLE-COMPOSITION-006" | "BUBBLE-COMPOSITION-007";
|
|
117
149
|
export declare class BubbleCompositionError extends Error {
|
|
118
150
|
readonly code: BubbleCompositionErrorCode;
|
|
119
151
|
constructor(code: BubbleCompositionErrorCode, message: string);
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { type BubbleComposition, type BubbleCompositionOptions, type
|
|
1
|
+
import { type BubbleComposition, type BubbleCompositionOptions, type BubbleAudioCapability, type BubbleImageCapability, type BubbleScheduler, type BubbleSvgText } from "./composition.js";
|
|
2
2
|
export interface TurboWarpBubbleTarget {
|
|
3
3
|
readonly id: string;
|
|
4
4
|
readonly isStage: boolean;
|
|
@@ -34,6 +34,12 @@ export interface TurboWarpAssetManagerExtension {
|
|
|
34
34
|
getAssetMimeType(args: Readonly<{
|
|
35
35
|
NAME: unknown;
|
|
36
36
|
}>): string;
|
|
37
|
+
playSound?(args: Readonly<{
|
|
38
|
+
NAME: unknown;
|
|
39
|
+
}>): Promise<void>;
|
|
40
|
+
playSoundUntilDone?(args: Readonly<{
|
|
41
|
+
NAME: unknown;
|
|
42
|
+
}>): Promise<void>;
|
|
37
43
|
resolveSkin(value: unknown): Readonly<{
|
|
38
44
|
skinId: number;
|
|
39
45
|
}> | Promise<Readonly<{
|
|
@@ -47,6 +53,7 @@ export interface TurboWarpSvgTextExtension {
|
|
|
47
53
|
}>, util: Readonly<{
|
|
48
54
|
target: TurboWarpBubbleTarget;
|
|
49
55
|
}>): void;
|
|
56
|
+
measureText?(styleName: unknown, text: unknown): number;
|
|
50
57
|
releaseTextActor(target: TurboWarpBubbleTarget): boolean;
|
|
51
58
|
}
|
|
52
59
|
export interface TurboWarpBubbleRuntime {
|
|
@@ -56,7 +63,8 @@ export interface TurboWarpBubbleRuntime {
|
|
|
56
63
|
requestRedraw?(): void;
|
|
57
64
|
}
|
|
58
65
|
export interface TurboWarpBubbleCompositionOptions {
|
|
59
|
-
readonly
|
|
66
|
+
readonly imageResolver?: BubbleImageCapability;
|
|
67
|
+
readonly audio?: BubbleAudioCapability;
|
|
60
68
|
readonly svgText?: BubbleSvgText;
|
|
61
69
|
readonly scheduler?: BubbleScheduler;
|
|
62
70
|
readonly onAnimationError?: BubbleCompositionOptions["onAnimationError"];
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
2
2
|
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="500" viewBox="0 0 1200 500" role="img" aria-labelledby="title description">
|
|
3
3
|
<title id="title">Bubble animation mode比較</title>
|
|
4
|
-
<desc id="description">talking、awaiting-
|
|
4
|
+
<desc id="description">talking、awaiting-continue、idleにおける目パチ、口パク、continue framesの動作比較。</desc>
|
|
5
5
|
<style>
|
|
6
6
|
text { font-family: -apple-system, BlinkMacSystemFont, "Hiragino Sans", "Noto Sans JP", sans-serif; }
|
|
7
7
|
.heading { fill: #25283a; font-size: 28px; font-weight: 700; }
|
|
@@ -53,7 +53,7 @@
|
|
|
53
53
|
<g>
|
|
54
54
|
<rect x="420" y="86" width="360" height="382" rx="20" fill="#ffffff" stroke="#d9deea" stroke-width="2"/>
|
|
55
55
|
<rect x="440" y="106" width="170" height="34" rx="17" fill="#ff6680"/>
|
|
56
|
-
<text x="525" y="129" text-anchor="middle" style="fill:#ffffff;font-size:15px;font-weight:700">awaiting-
|
|
56
|
+
<text x="525" y="129" text-anchor="middle" style="fill:#ffffff;font-size:15px;font-weight:700">awaiting-continue</text>
|
|
57
57
|
<text x="440" y="164" class="small">ユーザの「次へ」操作待ち</text>
|
|
58
58
|
<g>
|
|
59
59
|
<circle cx="496" cy="253" r="37.44" fill="#ffd5b5" stroke="#b85d63" stroke-width="2.88"/>
|
|
@@ -133,7 +133,7 @@
|
|
|
133
133
|
<rect x="407.0399999999999" y="744" width="112.71999999999998" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
|
|
134
134
|
<text x="415.0399999999999" y="763" class="input-text" style="font-size:12px">hero-dialogue</text>
|
|
135
135
|
</g>
|
|
136
|
-
<text x="52" y="804" class="body">続けて blink・
|
|
136
|
+
<text x="52" y="804" class="body">続けて blink・lip-sync・continue のフレームを設定</text>
|
|
137
137
|
<text x="52" y="832" class="small">目パチ 0.4秒 / 口パク 0.1秒 / 次へ 0.2秒</text>
|
|
138
138
|
<g role="group" aria-label="目パチフレームを設定">
|
|
139
139
|
<rect x="640" y="150" width="510" height="70" rx="12" fill="#ff6680" stroke="#000000" stroke-opacity="0.14" stroke-width="2"/>
|
|
@@ -151,9 +151,9 @@
|
|
|
151
151
|
<g role="group" aria-label="口パクフレームを設定">
|
|
152
152
|
<rect x="640" y="230" width="510" height="70" rx="12" fill="#ff6680" stroke="#000000" stroke-opacity="0.14" stroke-width="2"/>
|
|
153
153
|
<rect x="658" y="230" width="28" height="6" rx="3" fill="#000000" fill-opacity="0.18"/>
|
|
154
|
-
<text x="657" y="257" class="block-text" style="font-size:12px">set
|
|
155
|
-
<rect x="
|
|
156
|
-
<text x="
|
|
154
|
+
<text x="657" y="257" class="block-text" style="font-size:12px">set lip-sync frames</text>
|
|
155
|
+
<rect x="805.36" y="238" width="231.75999999999996" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
|
|
156
|
+
<text x="813.36" y="257" class="input-text" style="font-size:12px">HeroMouthClosed,HeroMouthOpen</text>
|
|
157
157
|
<text x="657" y="282" class="block-text" style="font-size:12px">every</text>
|
|
158
158
|
<rect x="701.2" y="263" width="38.32" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
|
|
159
159
|
<text x="709.2" y="282" class="input-text" style="font-size:12px">0.1</text>
|
|
@@ -164,9 +164,9 @@
|
|
|
164
164
|
<g role="group" aria-label="次へアイコンフレームを設定">
|
|
165
165
|
<rect x="640" y="310" width="510" height="70" rx="12" fill="#ff6680" stroke="#000000" stroke-opacity="0.14" stroke-width="2"/>
|
|
166
166
|
<rect x="658" y="310" width="28" height="6" rx="3" fill="#000000" fill-opacity="0.18"/>
|
|
167
|
-
<text x="657" y="337" class="block-text" style="font-size:12px">set
|
|
168
|
-
<rect x="
|
|
169
|
-
<text x="
|
|
167
|
+
<text x="657" y="337" class="block-text" style="font-size:12px">set continue frames</text>
|
|
168
|
+
<rect x="805.36" y="318" width="97.83999999999999" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
|
|
169
|
+
<text x="813.36" y="337" class="input-text" style="font-size:12px">Next1,Next2</text>
|
|
170
170
|
<text x="657" y="362" class="block-text" style="font-size:12px">every</text>
|
|
171
171
|
<rect x="701.2" y="343" width="38.32" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
|
|
172
172
|
<text x="709.2" y="362" class="input-text" style="font-size:12px">0.2</text>
|
|
@@ -225,6 +225,6 @@
|
|
|
225
225
|
</g>
|
|
226
226
|
<rect x="644" y="720" width="502" height="112" rx="16" fill="#fff3f6" stroke="#ffc4d1"/>
|
|
227
227
|
<text x="668" y="750" class="body" style="font-weight:700">Bubbleが条件成立またはtimeoutまで待機</text>
|
|
228
|
-
<text x="668" y="779" class="body">待機中は
|
|
228
|
+
<text x="668" y="779" class="body">待機中はcontinue framesをループし、口パクを停止。</text>
|
|
229
229
|
<text x="668" y="808" class="body">待機後はidleへ移り、次のcloseを実行します。</text>
|
|
230
230
|
</svg>
|
|
Binary file
|
package/docs/block-manual.ja.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
## 1. 必要な拡張機能
|
|
8
8
|
|
|
9
|
-
入力待ちを含む完全な例では6つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variables
|
|
9
|
+
入力待ちを含む完全な例では6つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。文字BubbleにはSVG TextとBubbleが必要です。portrait、lip-sync、continue indicator、将来のフルボイスや表示効果音などのメディアアセットにはAsset Managerが必要です。Async InputとRuntime ExpressionはBubble待機を使う場合だけ必要です。
|
|
10
10
|
|
|
11
11
|
| 順番 | 拡張機能 | 読み込み先 |
|
|
12
12
|
| ---: | ------------------------ | -------------------------------------------------------------------------------------------------------- |
|
|
@@ -14,10 +14,10 @@
|
|
|
14
14
|
| 2 | Async Input 0.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.3.0/dist/async-input.js` |
|
|
15
15
|
| 3 | Runtime Expression 0.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.3.0/dist/runtime-expression.js` |
|
|
16
16
|
| 4 | Asset Manager 0.7.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.7.0/dist/asset-manager.js` |
|
|
17
|
-
| 5 | SVG Text 0.
|
|
18
|
-
| 6 | Bubble 0.
|
|
17
|
+
| 5 | SVG Text 0.4.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-svg-text@0.4.0/dist/svg-text.js` |
|
|
18
|
+
| 6 | Bubble 0.2.0 | npm公開後は`https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.2.0/dist/turbowarp-bubble.js` |
|
|
19
19
|
|
|
20
|
-
開発中のBubbleを試す場合は、このリポジトリの`dist/turbowarp-bubble.js`をローカルカスタム拡張機能として読み込みます。表示時にAsset Manager
|
|
20
|
+
開発中のBubbleを試す場合は、このリポジトリの`dist/turbowarp-bubble.js`をローカルカスタム拡張機能として読み込みます。表示時にSVG Textが、画像・メディア機能の使用時にAsset Managerが、待機開始時にAsync InputかRuntime Expressionが見つからなければ、Bubbleは明示的なエラーを返します。
|
|
21
21
|
|
|
22
22
|
参考:
|
|
23
23
|
|
|
@@ -72,7 +72,7 @@ define text style [dialogue-text]
|
|
|
72
72
|
|
|
73
73
|
Bubbleは`dialogue-text`という名前を参照します。文字styleとBubble styleはruntime状態なので、通常は緑の旗が押されたときに毎回定義します。
|
|
74
74
|
|
|
75
|
-
SVG Text 0.
|
|
75
|
+
SVG Text 0.4.xは文字providerです。名前付き文字styleの定義、SVG文字skinの生成、文字幅の測定を担当します。Bubbleの配置は`set bubble placement`で設定し、tailや吹き出し外形はSVG Text providerの責務ではありません。
|
|
76
76
|
|
|
77
77
|
## 4. Bubble styleを定義する
|
|
78
78
|
|
|
@@ -158,10 +158,10 @@ set portrait base [HeroFace] for bubble style [hero-dialogue]
|
|
|
158
158
|
set blink frames [HeroEyesOpen,HeroEyesClosed]
|
|
159
159
|
every [0.4] seconds for bubble style [hero-dialogue]
|
|
160
160
|
|
|
161
|
-
set
|
|
161
|
+
set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
|
|
162
162
|
every [0.1] seconds for bubble style [hero-dialogue]
|
|
163
163
|
|
|
164
|
-
set
|
|
164
|
+
set continue frames [Next1,Next2]
|
|
165
165
|
every [0.2] seconds for bubble style [hero-dialogue]
|
|
166
166
|
```
|
|
167
167
|
|
|
@@ -186,25 +186,25 @@ wait with this bubble until condition [input == "pressed"] or timeout after [10]
|
|
|
186
186
|
close this bubble
|
|
187
187
|
```
|
|
188
188
|
|
|
189
|
-
まずTemporary Variablesで`input`を初期化してから、Async Inputのキー入力とタップのlistenerを登録します。Bubbleの待機ブロックは、`input == "pressed"`をRuntime Expressionへ委譲し、開始直後とVMの各フレームで評価します。待機中は自動的に`awaiting-
|
|
189
|
+
まずTemporary Variablesで`input`を初期化してから、Async Inputのキー入力とタップのlistenerを登録します。Bubbleの待機ブロックは、`input == "pressed"`をRuntime Expressionへ委譲し、開始直後とVMの各フレームで評価します。待機中は自動的に`awaiting-continue`となり、口パクを停止して`set continue frames`の画像をループします。条件成立またはtimeout後は`idle`へ移り、次の`close this bubble`へ進みます。timeoutを`0`にすると時間制限なしです。
|
|
190
190
|
|
|
191
191
|
次の待機に入る前に`input`を空文字へ戻してください。前回の`pressed`が残っていると、次の条件が直ちに成立します。別のBubble表示、close、対象targetの停止、projectの開始・停止、runtime破棄では、targetが所有する待機とlistener、timerをキャンセルして解放します。
|
|
192
192
|
|
|
193
|
-
音声再生や別の文字送り処理と組み合わせる場合は、それらが完了した時点で`awaiting-
|
|
193
|
+
音声再生や別の文字送り処理と組み合わせる場合は、それらが完了した時点で`awaiting-continue`へ切り替えます。
|
|
194
194
|
|
|
195
|
-

|
|
196
196
|
|
|
197
197
|
アニメーションGIFを再生できない環境では、次の比較図で各animation modeを確認できます。
|
|
198
198
|
|
|
199
|
-

|
|
200
200
|
|
|
201
201
|
## 6. Animation modeの使い分け
|
|
202
202
|
|
|
203
|
-
| mode
|
|
204
|
-
|
|
|
205
|
-
| `talking`
|
|
206
|
-
| `awaiting-
|
|
207
|
-
| `idle`
|
|
203
|
+
| mode | 目パチ | 口パク | continue frames | 主な用途 |
|
|
204
|
+
| ------------------- | ------ | ------------ | --------------- | ---------------------------- |
|
|
205
|
+
| `talking` | 実行 | 実行 | 非表示 | セリフ表示中、音声再生中 |
|
|
206
|
+
| `awaiting-continue` | 実行 | 停止・非表示 | ループ | ユーザによる「次へ」操作待ち |
|
|
207
|
+
| `idle` | 実行 | 停止・非表示 | 停止・非表示 | Bubbleを表示したまま静止 |
|
|
208
208
|
|
|
209
209
|
`set this bubble animation mode [MODE]`は、呼び出したsprite、clone、またはStageが所有するBubbleだけを変更します。先に`say`または`think`を実行していない場合はエラーになります。
|
|
210
210
|
|
|
@@ -231,37 +231,37 @@ cloneが停止・削除された場合は、そのtargetに属するtimer、SVG
|
|
|
231
231
|
|
|
232
232
|
## 9. ブロック一覧
|
|
233
233
|
|
|
234
|
-
| ブロック | 説明
|
|
235
|
-
| -------------------------------------------------------------------------------------- |
|
|
236
|
-
| `define bubble style [STYLE] using text style [TEXT_STYLE]` | Bubble styleを定義または再定義する
|
|
237
|
-
| `set bubble placement [PLACEMENT] for bubble style [STYLE]` | Actor相対方向・角度、または背景相対領域を設定する
|
|
238
|
-
| `set bubble distance [DISTANCE] for bubble style [STYLE]` | Actor boundsからtail先端までの距離を設定する
|
|
239
|
-
| `set bubble visual style [VISUAL_STYLE] for bubble style [STYLE]` | Bubble本体のSVG形状を10種類から設定する
|
|
240
|
-
| `set bubble tail length [LENGTH] for bubble style [STYLE]` | Bubble borderからtail先端までの基準長を設定する
|
|
241
|
-
| `set bubble offset x [X] y [Y] scale [SCALE] % for bubble style [STYLE]` | 本体位置と、文字を含む全体のscaleを設定する
|
|
242
|
-
| `set portrait base [ASSET] for bubble style [STYLE]` | portraitのベース画像を設定する
|
|
243
|
-
| `set blink frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | 目パチ差分と間隔を設定する
|
|
244
|
-
| `set
|
|
245
|
-
| `set
|
|
246
|
-
| `say [MESSAGE] with bubble style [STYLE]` | `talking` modeでsay表示を開始・置換する
|
|
247
|
-
| `think [MESSAGE] with bubble style [STYLE]` | `talking` modeでthink表示を開始・置換する
|
|
248
|
-
| `set this bubble animation mode [MODE]` | `talking`、`awaiting-
|
|
249
|
-
| `wait with this bubble until condition [CONDITION] or timeout after [TIMEOUT] seconds` | Runtime Expressionの条件成立またはtimeoutまで待つ
|
|
250
|
-
| `close this bubble` | 自分のBubbleと所有resourceを解放する
|
|
251
|
-
| `Bubble version` | Bubble実装versionを返す
|
|
234
|
+
| ブロック | 説明 |
|
|
235
|
+
| -------------------------------------------------------------------------------------- | ------------------------------------------------------- |
|
|
236
|
+
| `define bubble style [STYLE] using text style [TEXT_STYLE]` | Bubble styleを定義または再定義する |
|
|
237
|
+
| `set bubble placement [PLACEMENT] for bubble style [STYLE]` | Actor相対方向・角度、または背景相対領域を設定する |
|
|
238
|
+
| `set bubble distance [DISTANCE] for bubble style [STYLE]` | Actor boundsからtail先端までの距離を設定する |
|
|
239
|
+
| `set bubble visual style [VISUAL_STYLE] for bubble style [STYLE]` | Bubble本体のSVG形状を10種類から設定する |
|
|
240
|
+
| `set bubble tail length [LENGTH] for bubble style [STYLE]` | Bubble borderからtail先端までの基準長を設定する |
|
|
241
|
+
| `set bubble offset x [X] y [Y] scale [SCALE] % for bubble style [STYLE]` | 本体位置と、文字を含む全体のscaleを設定する |
|
|
242
|
+
| `set portrait base [ASSET] for bubble style [STYLE]` | portraitのベース画像を設定する |
|
|
243
|
+
| `set blink frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | 目パチ差分と間隔を設定する |
|
|
244
|
+
| `set lip-sync frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | 口パク差分と間隔を設定する |
|
|
245
|
+
| `set continue frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | `awaiting-continue`中の「次へ」アニメーションを設定する |
|
|
246
|
+
| `say [MESSAGE] with bubble style [STYLE]` | `talking` modeでsay表示を開始・置換する |
|
|
247
|
+
| `think [MESSAGE] with bubble style [STYLE]` | `talking` modeでthink表示を開始・置換する |
|
|
248
|
+
| `set this bubble animation mode [MODE]` | `talking`、`awaiting-continue`、`idle`からmodeを選ぶ |
|
|
249
|
+
| `wait with this bubble until condition [CONDITION] or timeout after [TIMEOUT] seconds` | Runtime Expressionの条件成立またはtimeoutまで待つ |
|
|
250
|
+
| `close this bubble` | 自分のBubbleと所有resourceを解放する |
|
|
251
|
+
| `Bubble version` | Bubble実装versionを返す |
|
|
252
252
|
|
|
253
253
|
## 10. よくあるエラー
|
|
254
254
|
|
|
255
255
|
| 状況 | 原因と対処 |
|
|
256
256
|
| ---------------------------------- | ------------------------------------------------------------------------ |
|
|
257
|
-
| Asset Managerを要求するエラー | Asset Manager 0.7.x
|
|
258
|
-
| SVG Textを要求するエラー | SVG Text 0.
|
|
257
|
+
| Asset Managerを要求するエラー | 画像・メディアアセットを使う前にAsset Manager 0.7.xを読み込む |
|
|
258
|
+
| SVG Textを要求するエラー | SVG Text 0.4.xをサンドボックスなしで読み込む |
|
|
259
259
|
| Async Inputを要求するエラー | Bubble待機より前にAsync Input 0.3.xをサンドボックスなしで読み込む |
|
|
260
260
|
| Runtime Expressionを要求するエラー | Bubble待機より前にRuntime Expression 0.3.xをサンドボックスなしで読み込む |
|
|
261
261
|
| `bubble style is not defined` | `define bubble style`を先に実行する。緑の旗の再実行時も再定義する |
|
|
262
262
|
| image assetが未登録 | `register resource ... as asset ...`の完了後にBubbleを表示する |
|
|
263
263
|
| assetが画像ではない | `MIME type of asset [NAME]`で`image/*`か確認する |
|
|
264
|
-
|
|
|
264
|
+
| continue framesが1枚 | 2枚以上にするか、空にしてcontinue表示を解除する |
|
|
265
265
|
| frame intervalエラー | `SECONDS`を0より大きい有限値にする |
|
|
266
266
|
| StageからActor相対表示した | placementを`HEADER_LIKE`、`CENTER`、`FOOTER_LIKE`にする |
|
|
267
267
|
| placementが不正 | 16方向、alias、0〜360度、背景相対3値のいずれかを指定する |
|
package/docs/block-manual.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# TurboWarp Bubble Block Manual
|
|
2
2
|
|
|
3
|
-
This manual explains how to use `turbowarp-bubble` as an unsandboxed TurboWarp custom extension. A Bubble combines an SVG body, text, a character portrait, blinking and lip-sync layers, and an animated
|
|
3
|
+
This manual explains how to use `turbowarp-bubble` as an unsandboxed TurboWarp custom extension. A Bubble combines an SVG body, text, a character portrait, blinking and lip-sync layers, and an animated continue indicator.
|
|
4
4
|
|
|
5
5
|

|
|
6
6
|
|
|
7
7
|
## 1. Load the required extensions
|
|
8
8
|
|
|
9
|
-
The complete input-wait example uses six extensions. Add Temporary Variables from TurboWarp's extension library, then load the
|
|
9
|
+
The complete input-wait example uses six extensions. Add Temporary Variables from TurboWarp's extension library, then load the custom extensions needed by the selected features with **Run without sandbox** enabled. SVG Text and Bubble are required for text bubbles. Asset Manager is required for portrait, lip-sync, continue indicator, and future voice or display-sound assets. Async Input and Runtime Expression are required only before using a Bubble wait.
|
|
10
10
|
|
|
11
11
|
| Order | Extension | URL |
|
|
12
12
|
| ----: | ------------------------ | ----------------------------------------------------------------------------------------------------------------- |
|
|
@@ -14,10 +14,10 @@ The complete input-wait example uses six extensions. Add Temporary Variables fro
|
|
|
14
14
|
| 2 | Async Input 0.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.3.0/dist/async-input.js` |
|
|
15
15
|
| 3 | Runtime Expression 0.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.3.0/dist/runtime-expression.js` |
|
|
16
16
|
| 4 | Asset Manager 0.7.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-manager@0.7.0/dist/asset-manager.js` |
|
|
17
|
-
| 5 | SVG Text 0.
|
|
18
|
-
| 6 | Bubble 0.
|
|
17
|
+
| 5 | SVG Text 0.4.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-svg-text@0.4.0/dist/svg-text.js` |
|
|
18
|
+
| 6 | Bubble 0.2.0 | After npm publication: `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.2.0/dist/turbowarp-bubble.js` |
|
|
19
19
|
|
|
20
|
-
To try a development build, load this repository's `dist/turbowarp-bubble.js` as a local custom extension. Bubble reports an explicit error if
|
|
20
|
+
To try a development build, load this repository's `dist/turbowarp-bubble.js` as a local custom extension. Bubble reports an explicit error if SVG Text is missing when it displays a Bubble, if an image/media feature is used without Asset Manager, or if Async Input or Runtime Expression is missing when it starts a Bubble wait.
|
|
21
21
|
|
|
22
22
|
See also:
|
|
23
23
|
|
|
@@ -37,8 +37,8 @@ The following example stores costumes in a hidden asset sprite named `Assets`.
|
|
|
37
37
|
| `HeroEyesClosed` | `HeroEyesClosed` | Transparent overlay containing only the closed eyes |
|
|
38
38
|
| `HeroMouthClosed` | `HeroMouthClosed` | Transparent overlay containing only the closed mouth |
|
|
39
39
|
| `HeroMouthOpen` | `HeroMouthOpen` | Transparent overlay containing only the open mouth |
|
|
40
|
-
| `Next1` | `Next1` | First frame of the
|
|
41
|
-
| `Next2` | `Next2` | Second frame of the
|
|
40
|
+
| `Next1` | `Next1` | First frame of the continue indicator |
|
|
41
|
+
| `Next2` | `Next2` | Second frame of the continue indicator |
|
|
42
42
|
|
|
43
43
|
Use the same canvas size and center point for the base, eye, and mouth images. Keep overlay backgrounds transparent; mismatched canvases or centers make the layers drift when composed.
|
|
44
44
|
|
|
@@ -72,7 +72,7 @@ define text style [dialogue-text]
|
|
|
72
72
|
|
|
73
73
|
Bubble refers to this style as `dialogue-text`. Text and Bubble styles are runtime state, so normally define them again whenever the green flag is clicked.
|
|
74
74
|
|
|
75
|
-
SVG Text 0.
|
|
75
|
+
SVG Text 0.4.x is a text provider: it defines named text styles, creates SVG text skins, and measures text. Bubble placement is configured by `set bubble placement`; the SVG Text provider does not own Bubble direction, tail, or outer shape.
|
|
76
76
|
|
|
77
77
|
## 4. Define a Bubble style
|
|
78
78
|
|
|
@@ -124,7 +124,7 @@ These placements do not depend on actor coordinates, bounds, or visibility. Use
|
|
|
124
124
|
- `tail length` (default `18`) is the nominal distance from the Bubble border to the tail tip at the normal position.
|
|
125
125
|
- `offset x/y/scale` (default `[0, 0, 100]`) uses positive x to the right, positive y upward, and scale as a percentage. `[10, -10, 120]` moves the body 10 right and 10 down, then scales it to 120%.
|
|
126
126
|
|
|
127
|
-
Scale applies to the body, SVG Text, portrait base, blink/lip-sync layers,
|
|
127
|
+
Scale applies to the body, SVG Text, portrait base, blink/lip-sync layers, continue indicator, and internal padding as one unit, so the displayed font size scales by the same factor. When scale alone changes, the body center moves away from the actor by the increase in radius, preserving the actor-side gap. The x/y offset is added afterward. The tail tip remains fixed and the union with the body border is regenerated, so an offset can change the effective tail length.
|
|
128
128
|
|
|
129
129
|
Near a Stage edge, keeping the scaled Bubble on-screen takes priority and can reduce the requested distance. Actor-relative distance, tail, offset, and scale settings do not apply to `HEADER_LIKE`, `CENTER`, or `FOOTER_LIKE`.
|
|
130
130
|
|
|
@@ -150,7 +150,7 @@ The default visual style is `NORMAL`. The body drawable is created before text a
|
|
|
150
150
|
|
|
151
151
|
`NEGATIVE` is not a separate style because it can be expressed with fill and border colors. Orientation and segments are also not public inputs; dimensions are calculated from width, font, character count, and the number of lines after wrapping.
|
|
152
152
|
|
|
153
|
-
Now configure the portrait and
|
|
153
|
+
Now configure the portrait and continue animation layers:
|
|
154
154
|
|
|
155
155
|
```text
|
|
156
156
|
set portrait base [HeroFace] for bubble style [hero-dialogue]
|
|
@@ -158,17 +158,17 @@ set portrait base [HeroFace] for bubble style [hero-dialogue]
|
|
|
158
158
|
set blink frames [HeroEyesOpen,HeroEyesClosed]
|
|
159
159
|
every [0.4] seconds for bubble style [hero-dialogue]
|
|
160
160
|
|
|
161
|
-
set
|
|
161
|
+
set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
|
|
162
162
|
every [0.1] seconds for bubble style [hero-dialogue]
|
|
163
163
|
|
|
164
|
-
set
|
|
164
|
+
set continue frames [Next1,Next2]
|
|
165
165
|
every [0.2] seconds for bubble style [hero-dialogue]
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
`ASSETS` is a comma-separated list of Asset Manager names. Surrounding whitespace is removed; commas cannot be part of an asset name.
|
|
169
169
|
|
|
170
|
-
- Blink and
|
|
171
|
-
- Use two or more
|
|
170
|
+
- Blink and lip-sync animations accept one or more frames. A single frame remains static.
|
|
171
|
+
- Use two or more continue frames so the loop is visible.
|
|
172
172
|
- `SECONDS` must be a finite number greater than zero.
|
|
173
173
|
- An empty `ASSETS` input removes that animation.
|
|
174
174
|
- An empty portrait base removes the whole portrait.
|
|
@@ -186,25 +186,25 @@ wait with this bubble until condition [input == "pressed"] or timeout after [10]
|
|
|
186
186
|
close this bubble
|
|
187
187
|
```
|
|
188
188
|
|
|
189
|
-
Initialize `input` with Temporary Variables before registering the Async Input listeners. The listeners update that runtime variable when Space is pressed or the sprite is tapped. The Bubble wait delegates `input == "pressed"` to Runtime Expression immediately and once per VM frame. While waiting it automatically enters `awaiting-
|
|
189
|
+
Initialize `input` with Temporary Variables before registering the Async Input listeners. The listeners update that runtime variable when Space is pressed or the sprite is tapped. The Bubble wait delegates `input == "pressed"` to Runtime Expression immediately and once per VM frame. While waiting it automatically enters `awaiting-continue`, stops lip-sync, and loops the images configured by `set continue frames`. When the condition becomes true or the timeout expires, it enters `idle` and continues to `close this bubble`. Set the timeout to `0` to wait without a timeout.
|
|
190
190
|
|
|
191
191
|
Reset `input` to an empty string before each later wait; otherwise the previous `pressed` value makes the next condition succeed immediately. Starting another Bubble, closing it, stopping its target, restarting or stopping the project, and disposing the runtime all cancel the target-owned wait and release its listener and timer.
|
|
192
192
|
|
|
193
|
-
When combining Bubble with audio or a separate text-reveal system, switch to `awaiting-
|
|
193
|
+
When combining Bubble with audio or a separate text-reveal system, switch to `awaiting-continue` when that process completes.
|
|
194
194
|
|
|
195
|
-

|
|
196
196
|
|
|
197
197
|
If animated GIF playback is unavailable, use this static animation-mode comparison:
|
|
198
198
|
|
|
199
|
-

|
|
200
200
|
|
|
201
201
|
## 6. Bubble animation modes
|
|
202
202
|
|
|
203
|
-
| Mode
|
|
204
|
-
|
|
|
205
|
-
| `talking`
|
|
206
|
-
| `awaiting-
|
|
207
|
-
| `idle`
|
|
203
|
+
| Mode | Blink | Lip-sync | Continue frames | Typical use |
|
|
204
|
+
| ------------------- | ----- | ------------ | --------------- | ------------------------------------ |
|
|
205
|
+
| `talking` | Runs | Runs | Hidden | Dialogue display or audio playback |
|
|
206
|
+
| `awaiting-continue` | Runs | Stops/hidden | Loops | Await the user's request to continue |
|
|
207
|
+
| `idle` | Runs | Stops/hidden | Stops/hidden | Keep a Bubble visible and still |
|
|
208
208
|
|
|
209
209
|
`set this bubble animation mode [MODE]` changes only the Bubble owned by the calling sprite, clone, or Stage. It reports an error if that target has not first run `say` or `think`.
|
|
210
210
|
|
|
@@ -231,37 +231,37 @@ When a clone stops or is deleted, timers, SVG Text skins, and renderer drawables
|
|
|
231
231
|
|
|
232
232
|
## 9. Block reference
|
|
233
233
|
|
|
234
|
-
| Block | Description
|
|
235
|
-
| -------------------------------------------------------------------------------------- |
|
|
236
|
-
| `define bubble style [STYLE] using text style [TEXT_STYLE]` | Define or redefine a Bubble style
|
|
237
|
-
| `set bubble placement [PLACEMENT] for bubble style [STYLE]` | Set an actor direction/angle or a stage-relative region
|
|
238
|
-
| `set bubble distance [DISTANCE] for bubble style [STYLE]` | Set the distance from actor bounds to the tail tip
|
|
239
|
-
| `set bubble visual style [VISUAL_STYLE] for bubble style [STYLE]` | Select one of ten SVG body shapes
|
|
240
|
-
| `set bubble tail length [LENGTH] for bubble style [STYLE]` | Set the nominal border-to-tip tail length
|
|
241
|
-
| `set bubble offset x [X] y [Y] scale [SCALE] % for bubble style [STYLE]` | Set body position and whole-Bubble scale, including text
|
|
242
|
-
| `set portrait base [ASSET] for bubble style [STYLE]` | Set the portrait base image
|
|
243
|
-
| `set blink frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set blink overlays and interval
|
|
244
|
-
| `set
|
|
245
|
-
| `set
|
|
246
|
-
| `say [MESSAGE] with bubble style [STYLE]` | Start or replace a `say` Bubble in `talking` mode
|
|
247
|
-
| `think [MESSAGE] with bubble style [STYLE]` | Start or replace a `think` Bubble in `talking` mode
|
|
248
|
-
| `set this bubble animation mode [MODE]` | Select `talking`, `awaiting-
|
|
249
|
-
| `wait with this bubble until condition [CONDITION] or timeout after [TIMEOUT] seconds` | Await a Runtime Expression condition or optional timeout
|
|
250
|
-
| `close this bubble` | Release this target's Bubble and owned resources
|
|
251
|
-
| `Bubble version` | Report the Bubble implementation version
|
|
234
|
+
| Block | Description |
|
|
235
|
+
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
|
|
236
|
+
| `define bubble style [STYLE] using text style [TEXT_STYLE]` | Define or redefine a Bubble style |
|
|
237
|
+
| `set bubble placement [PLACEMENT] for bubble style [STYLE]` | Set an actor direction/angle or a stage-relative region |
|
|
238
|
+
| `set bubble distance [DISTANCE] for bubble style [STYLE]` | Set the distance from actor bounds to the tail tip |
|
|
239
|
+
| `set bubble visual style [VISUAL_STYLE] for bubble style [STYLE]` | Select one of ten SVG body shapes |
|
|
240
|
+
| `set bubble tail length [LENGTH] for bubble style [STYLE]` | Set the nominal border-to-tip tail length |
|
|
241
|
+
| `set bubble offset x [X] y [Y] scale [SCALE] % for bubble style [STYLE]` | Set body position and whole-Bubble scale, including text |
|
|
242
|
+
| `set portrait base [ASSET] for bubble style [STYLE]` | Set the portrait base image |
|
|
243
|
+
| `set blink frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set blink overlays and interval |
|
|
244
|
+
| `set lip-sync frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set lip-sync overlays and interval |
|
|
245
|
+
| `set continue frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set the animation shown during `awaiting-continue` |
|
|
246
|
+
| `say [MESSAGE] with bubble style [STYLE]` | Start or replace a `say` Bubble in `talking` mode |
|
|
247
|
+
| `think [MESSAGE] with bubble style [STYLE]` | Start or replace a `think` Bubble in `talking` mode |
|
|
248
|
+
| `set this bubble animation mode [MODE]` | Select `talking`, `awaiting-continue`, or `idle` for this Bubble |
|
|
249
|
+
| `wait with this bubble until condition [CONDITION] or timeout after [TIMEOUT] seconds` | Await a Runtime Expression condition or optional timeout |
|
|
250
|
+
| `close this bubble` | Release this target's Bubble and owned resources |
|
|
251
|
+
| `Bubble version` | Report the Bubble implementation version |
|
|
252
252
|
|
|
253
253
|
## 10. Troubleshooting
|
|
254
254
|
|
|
255
255
|
| Symptom | Cause and solution |
|
|
256
256
|
| ------------------------------------ | --------------------------------------------------------------------------- |
|
|
257
|
-
| Asset Manager required error | Load Asset Manager 0.7.x without sandbox
|
|
258
|
-
| SVG Text required error | Load SVG Text 0.
|
|
257
|
+
| Asset Manager required error | Load Asset Manager 0.7.x without sandbox before using image/media assets |
|
|
258
|
+
| SVG Text required error | Load SVG Text 0.4.x without sandbox |
|
|
259
259
|
| Async Input required error | Load Async Input 0.3.x without sandbox before using the Bubble wait |
|
|
260
260
|
| Runtime Expression required error | Load Runtime Expression 0.3.x without sandbox before using the Bubble wait |
|
|
261
261
|
| `bubble style is not defined` | Run `define bubble style` first, including after restarting with green flag |
|
|
262
262
|
| Image asset is not registered | Wait for `register resource ... as asset ...` before showing the Bubble |
|
|
263
263
|
| Asset is not an image | Confirm `MIME type of asset [NAME]` is `image/*` |
|
|
264
|
-
| Only one
|
|
264
|
+
| Only one continue frame | Supply at least two frames, or clear the setting |
|
|
265
265
|
| Frame interval error | Use a finite `SECONDS` value greater than zero |
|
|
266
266
|
| Actor-relative Bubble from the Stage | Use `HEADER_LIKE`, `CENTER`, or `FOOTER_LIKE` |
|
|
267
267
|
| Invalid placement | Use a 16-way direction, alias, 0–360 degree angle, or stage-relative value |
|