@kubohiroya/turbowarp-bubble 0.1.1 → 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.
@@ -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-advance";
12
- export type BubbleLayer = "portraitBase" | "portraitBlink" | "portraitTalk" | "advanceIndicator";
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 talk?: BubbleFrameAnimationInput;
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 advanceIndicator?: BubbleFrameAnimationInput;
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 talk?: BubbleFrameAnimation;
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 advanceIndicator?: BubbleFrameAnimation;
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: SvgTextTarget;
57
- readonly portraitBase?: AssetManagerCompositionTarget;
58
- readonly portraitBlink?: AssetManagerCompositionTarget;
59
- readonly portraitTalk?: AssetManagerCompositionTarget;
60
- readonly advanceIndicator?: AssetManagerCompositionTarget;
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 assetManager: BubbleAssetManager;
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 BubbleAssetManager, type BubbleScheduler, type BubbleSvgText } from "./composition.js";
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 assetManager?: BubbleAssetManager;
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-advance、idleにおける目パチ、口パク、advance framesの動作比較。</desc>
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-advance</text>
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・talk・advance のフレームを設定</text>
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 talk frames</text>
155
- <rect x="775.6" y="238" width="231.75999999999996" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
156
- <text x="783.6" y="257" class="input-text" style="font-size:12px">HeroMouthClosed,HeroMouthOpen</text>
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 advance frames</text>
168
- <rect x="797.92" y="318" width="97.83999999999999" height="25" rx="12.5" fill="#ffffff" fill-opacity="0.96"/>
169
- <text x="805.92" y="337" class="input-text" style="font-size:12px">Next1,Next2</text>
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">待機中はadvance framesをループし、口パクを停止。</text>
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
@@ -6,7 +6,7 @@
6
6
 
7
7
  ## 1. 必要な拡張機能
8
8
 
9
- 入力待ちを含む完全な例では6つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、残る5つのカスタム拡張機能は「サンドボックスなしで実行」を許可して読み込みます。Async InputとRuntime ExpressionはBubbleの待機ブロックより前に、Asset ManagerとSVG Textは最初のBubble表示より前に読み込みます。
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.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-svg-text@0.3.0/dist/svg-text.js` |
18
- | 6 | Bubble 0.1.0 | npm公開後は`https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.1.0/dist/turbowarp-bubble.js` |
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かSVG Textが、待機開始時にAsync InputかRuntime Expressionが見つからなければ、Bubbleは明示的なエラーを返します。
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.3.xではblock contract上`bubble direction`入力が残っていますが、Bubbleが`setText`で生成する文字drawableの配置には使われません。Bubbleの配置は次節の`set bubble placement`で設定します。SVG Textからのdirection削除は、破壊的変更が可能な次版で行います。
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 talk frames [HeroMouthClosed,HeroMouthOpen]
161
+ set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
162
162
  every [0.1] seconds for bubble style [hero-dialogue]
163
163
 
164
- set advance frames [Next1,Next2]
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-advance`となり、口パクを停止して`set advance frames`の画像をループします。条件成立またはtimeout後は`idle`へ移り、次の`close this bubble`へ進みます。timeoutを`0`にすると時間制限なしです。
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-advance`へ切り替えます。
193
+ 音声再生や別の文字送り処理と組み合わせる場合は、それらが完了した時点で`awaiting-continue`へ切り替えます。
194
194
 
195
- ![sayで口パクし、awaiting-advanceでadvance framesを動かし、入力成立後にBubbleを閉じるアニメーション](./assets/bubble-lifecycle.gif)
195
+ ![sayで口パクし、awaiting-continueでcontinue framesを動かし、入力成立後にBubbleを閉じるアニメーション](./assets/bubble-lifecycle.gif)
196
196
 
197
197
  アニメーションGIFを再生できない環境では、次の比較図で各animation modeを確認できます。
198
198
 
199
- ![talking、awaiting-advance、idleの目パチ、口パク、advance framesの状態比較](./assets/animation-mode-guide.svg)
199
+ ![talking、awaiting-continue、idleの目パチ、口パク、continue framesの状態比較](./assets/animation-mode-guide.svg)
200
200
 
201
201
  ## 6. Animation modeの使い分け
202
202
 
203
- | mode | 目パチ | 口パク | advance frames | 主な用途 |
204
- | ------------------ | ------ | ------------ | -------------- | ---------------------------- |
205
- | `talking` | 実行 | 実行 | 非表示 | セリフ表示中、音声再生中 |
206
- | `awaiting-advance` | 実行 | 停止・非表示 | ループ | ユーザによる「次へ」操作待ち |
207
- | `idle` | 実行 | 停止・非表示 | 停止・非表示 | Bubbleを表示したまま静止 |
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 talk frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | 口パク差分と間隔を設定する |
245
- | `set advance frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | `awaiting-advance`中の「次へ」アニメーションを設定する |
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-advance`、`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を返す |
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.3.xをサンドボックスなしで読み込む |
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
- | advance framesが1枚 | 2枚以上にするか、空にしてadvance表示を解除する |
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値のいずれかを指定する |
@@ -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 advance indicator.
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
  ![A quick-start block sequence that registers Next1 and Next2 separately, prepares input listeners, then uses Bubble's integrated wait](./assets/block-quick-start.svg)
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 five custom extensions with **Run without sandbox** enabled. Async Input and Runtime Expression must be available before a Bubble wait; Asset Manager and SVG Text must be available before the first Bubble is shown.
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.3.0 | `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-svg-text@0.3.0/dist/svg-text.js` |
18
- | 6 | Bubble 0.1.0 | After npm publication: `https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.1.0/dist/turbowarp-bubble.js` |
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 Asset Manager or SVG Text is missing when it displays a Bubble, or if Async Input or Runtime Expression is missing when it starts a Bubble wait.
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 advance indicator |
41
- | `Next2` | `Next2` | Second frame of the advance indicator |
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.3.x retains a `bubble direction` input in its block contract, but Bubble does not use it when creating the text drawable through `setText`. Use `set bubble placement` in the next section instead. The obsolete SVG Text direction input is intended to be removed in a later breaking release.
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, advance 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.
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 advance animation layers:
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 talk frames [HeroMouthClosed,HeroMouthOpen]
161
+ set lip-sync frames [HeroMouthClosed,HeroMouthOpen]
162
162
  every [0.1] seconds for bubble style [hero-dialogue]
163
163
 
164
- set advance frames [Next1,Next2]
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 talk animations accept one or more frames. A single frame remains static.
171
- - Use two or more advance frames so the loop is visible.
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-advance`, stops lip-sync, and loops the images configured by `set advance 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.
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-advance` when that process completes.
193
+ When combining Bubble with audio or a separate text-reveal system, switch to `awaiting-continue` when that process completes.
194
194
 
195
- ![A say Bubble lip-syncs, shows advance frames while awaiting advance, then closes after input](./assets/bubble-lifecycle.gif)
195
+ ![A say Bubble lip-syncs, shows continue frames while awaiting continue, then closes after input](./assets/bubble-lifecycle.gif)
196
196
 
197
197
  If animated GIF playback is unavailable, use this static animation-mode comparison:
198
198
 
199
- ![Blink, lip-sync, and advance-frame states in talking, awaiting-advance, and idle modes](./assets/animation-mode-guide.svg)
199
+ ![Blink, lip-sync, and continue-frame states in talking, awaiting-continue, and idle modes](./assets/animation-mode-guide.svg)
200
200
 
201
201
  ## 6. Bubble animation modes
202
202
 
203
- | Mode | Blink | Lip-sync | Advance frames | Typical use |
204
- | ------------------ | ----- | ------------ | -------------- | ----------------------------------- |
205
- | `talking` | Runs | Runs | Hidden | Dialogue display or audio playback |
206
- | `awaiting-advance` | Runs | Stops/hidden | Loops | Await the user's request to advance |
207
- | `idle` | Runs | Stops/hidden | Stops/hidden | Keep a Bubble visible and still |
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 talk frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set lip-sync overlays and interval |
245
- | `set advance frames [ASSETS] every [SECONDS] seconds for bubble style [STYLE]` | Set the animation shown during `awaiting-advance` |
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-advance`, 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 |
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.3.x without sandbox |
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 advance frame | Supply at least two frames, or clear the setting |
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 |