@kubohiroya/turbowarp-bubble 0.13.0 → 0.13.1

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.
@@ -74,7 +74,7 @@
74
74
  </blockquote>
75
75
  <p><img src="../assets/block-quick-start.svg" alt="Next1とNext2を個別登録し、入力listenerを準備してBubble内蔵待機を使うブロック例"></p>
76
76
  <h2 id="requirements">1. 必要な拡張機能</h2>
77
- <p>入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.10.0のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Cacheが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。</p>
77
+ <p>入力待ちを含む完全な例では5つの拡張機能を使います。TurboWarpの拡張機能ライブラリからTemporary Variablesを追加し、選択した機能に必要なカスタム拡張機能を「サンドボックスなしで実行」を許可して読み込みます。BubbleはSVG Text 0.10.1のhost-neutral layout providerをbundle内に持ち、既定のSVG overlayではskinを作りません。portrait、lip-sync、continue indicator、フルボイス、表示効果音などのメディアアセットにはAsset Cacheが必要です。Async InputとRuntime Expressionはconditionを使うBubble待機またはclose policyで必要です。timeoutだけのclose policyにはどちらも不要です。</p>
78
78
  <table>
79
79
  <thead>
80
80
  <tr>
@@ -90,23 +90,23 @@
90
90
  </tr>
91
91
  <tr>
92
92
  <td align="right">2</td>
93
- <td>Async Input 0.7.0</td>
94
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.0/dist/async-input.js</code></td>
93
+ <td>Async Input 0.7.1</td>
94
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-async-input@0.7.1/dist/async-input.js</code></td>
95
95
  </tr>
96
96
  <tr>
97
97
  <td align="right">3</td>
98
- <td>Runtime Expression 0.6.0</td>
99
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.0/dist/runtime-expression.js</code></td>
98
+ <td>Runtime Expression 0.6.1</td>
99
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-runtime-expression@0.6.1/dist/runtime-expression.js</code></td>
100
100
  </tr>
101
101
  <tr>
102
102
  <td align="right">4</td>
103
- <td>Asset Cache 0.1.0</td>
104
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.1.0/dist/asset-cache.js</code></td>
103
+ <td>Asset Cache 0.2.2</td>
104
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-asset-cache@0.2.2/dist/asset-cache.js</code></td>
105
105
  </tr>
106
106
  <tr>
107
107
  <td align="right">5</td>
108
- <td>Bubble 0.13.0</td>
109
- <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.0/dist/turbowarp-bubble.js</code></td>
108
+ <td>Bubble 0.13.1</td>
109
+ <td><code>https://cdn.jsdelivr.net/npm/@kubohiroya/turbowarp-bubble@0.13.1/dist/turbowarp-bubble.js</code></td>
110
110
  </tr>
111
111
  </tbody></table>
112
112
  <p>開発中のBubbleを試す場合は、このリポジトリの<code>dist/turbowarp-bubble.js</code>をローカルカスタム拡張機能として読み込みます。既定SVG overlayに必要なrenderer APIがない場合、画像・メディア機能の使用時にAsset Cacheがない場合、condition待機の開始時にAsync InputかRuntime Expressionがない場合は、Bubbleが明示的なエラーを返します。低レベルComposition APIでは別のtext capabilityを注入できます。</p>
@@ -175,7 +175,7 @@ register resource [costume:Assets:Next2] as asset [Next2]
175
175
  </code></pre>
176
176
  <p>URL画像を使う場合は、<code>RESOURCE_ID</code>へHTTPS URLを指定します。Bubbleに設定できるのは、Asset Cacheへ登録済みでMIME typeが<code>image/*</code>のアセットだけです。</p>
177
177
  <h2 id="text-style">3. 文字layout styleを選ぶ</h2>
178
- <p>standalone BubbleはSVG Text 0.10.0のlayout compositionを内包し、2つのBubble styleを組み込みます。<code>say</code>はspeech本体とspeech tail、<code>think</code>はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い<code>say [MESSAGE]</code>/<code>think [MESSAGE]</code>ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile <code>default</code>、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.10.0をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開<code>getLayoutCapability()</code>を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。</p>
178
+ <p>standalone BubbleはSVG Text 0.10.1のlayout compositionを内包し、2つのBubble styleを組み込みます。<code>say</code>はspeech本体とspeech tail、<code>think</code>はthought本体とround trailを持ち、本体とtail/trailの形は別項目ではなく1つのvisual styleとして選びます。短い<code>say [MESSAGE]</code>/<code>think [MESSAGE]</code>ブロックが対応styleを自動選択するため、基本経路にはstyle定義もstyle入力も不要です。どちらも予約text profile <code>default</code>、内容に追従するサイズ、14px Helvetica、右側優先・収まりに応じた左反転、block入力の330文字上限、空文字でのcloseを使います。4pxのSVG strokeを白いfillより先に描き、内側半分を隠すことで、見かけの輪郭をTurboWarp標準と同じ細さにします。それ以外のtext style名やstyle設定ブロックを使うとcustom profileになります。custom text styleは初回参照時に背景透明のSVG Text既定styleとして初期化されます。stock SVG Text 0.10.1をBubbleより先に別拡張として読み込んだprojectでは、Bubbleが公開<code>getLayoutCapability()</code>を使い、SVG Text blockで定義したnamed styleを維持します。handoffのない古いSVG Textがロード済みならstyleを黙って置換せず互換errorを返し、必要な場合だけ文書化済みscratch-render fallbackを選択します。</p>
179
179
  <pre><code class="language-text">define bubble style [hero-dialogue] using text style [default]
180
180
  </code></pre>
181
181
  <p>独自のfont、色、alignmentを使うアプリhostは、<code>createSvgTextLayoutComposition()</code>へstyleを定義し、<code>createSvgTextOverlayTextCapability()</code>でBubbleへ注入します。custom profileは同じ<code>layoutText()</code>を使い、既定overlay backendではSVG文字skinを生成しません。Bubbleの配置、tail、吹き出し外形はBubble側が担当します。</p>
@@ -508,7 +508,7 @@ animate bubble shape to [WAVY] speed [1] for [0.5] seconds
508
508
  </thead>
509
509
  <tbody><tr>
510
510
  <td>Asset Cacheを要求するエラー</td>
511
- <td>画像・メディアアセットを使う前にAsset Cache 0.1.0を読み込む</td>
511
+ <td>画像・メディアアセットを使う前にAsset Cache 0.2.2を読み込む</td>
512
512
  </tr>
513
513
  <tr>
514
514
  <td>SVG overlay backendのエラー</td>
@@ -579,5 +579,2029 @@ pnpm docs:check
579
579
  <p><code>docs:check</code>は、SVGのviewBox、production renderer/wrapText由来marker、全visual style、GIFの寸法・16フレーム・ループ設定、マニュアルから画像と全16ブロックへの参照、およびPages用HTMLが最新であることを検証します。</p>
580
580
  </main>
581
581
  <footer class="site-footer">ソースコードはMPL-2.0で公開されています。</footer>
582
+ <style id="block-reference-style">
583
+ #extension-block-reference {
584
+ max-width: 72rem;
585
+ margin: 2rem auto;
586
+ padding: 1rem;
587
+ line-height: 1.6;
588
+ overflow-wrap: anywhere;
589
+ }
590
+ #extension-block-reference .block-reference-entry {
591
+ display: block;
592
+ scroll-margin-top: 6rem;
593
+ margin: 2rem 0;
594
+ padding: 1rem;
595
+ border: 1px solid currentColor;
596
+ border-radius: 0.5rem;
597
+ }
598
+ #extension-block-reference .block-reference-table {
599
+ overflow-x: auto;
600
+ }
601
+ #extension-block-reference table {
602
+ border-collapse: collapse;
603
+ width: 100%;
604
+ }
605
+ #extension-block-reference th,
606
+ #extension-block-reference td {
607
+ text-align: left;
608
+ vertical-align: top;
609
+ border: 1px solid currentColor;
610
+ padding: 0.5rem;
611
+ }
612
+ #extension-block-reference code {
613
+ white-space: pre-wrap;
614
+ }
615
+ #extension-block-reference a:focus-visible {
616
+ outline: 3px solid currentColor;
617
+ outline-offset: 3px;
618
+ }
619
+ </style>
620
+ <!-- BEGIN COMPLETE BLOCK REFERENCE -->
621
+ <section
622
+ lang="en"
623
+ id="extension-block-reference"
624
+ aria-labelledby="block-reference-title"
625
+ >
626
+ <h2 id="block-reference-title">Bubble: complete block reference</h2>
627
+ <p>
628
+ All 33 blocks are documented below, including compatibility blocks and
629
+ blocks available through optional features. Select a block to read its
630
+ behavior, arguments, default values, and menu choices. Each block has a
631
+ permanent link.
632
+ </p>
633
+ <nav aria-label="Block reference">
634
+ <ul>
635
+ <li>
636
+ <a href="#block-defineBubbleStyle"
637
+ ><code
638
+ >define bubble style [STYLE] using text style [TEXT_STYLE]</code
639
+ ></a
640
+ >
641
+ </li>
642
+ <li>
643
+ <a href="#block-defineBubbleClosePolicy"
644
+ ><code
645
+ >define bubble close policy [POLICY] trigger [TRIGGER] condition
646
+ [CONDITION] timeout [TIMEOUT] seconds</code
647
+ ></a
648
+ >
649
+ </li>
650
+ <li>
651
+ <a href="#block-setBubblePlacement"
652
+ ><code
653
+ >set bubble placement [PLACEMENT] for bubble style [STYLE]</code
654
+ ></a
655
+ >
656
+ </li>
657
+ <li>
658
+ <a href="#block-setPortraitBase"
659
+ ><code>set portrait base [ASSET] for bubble style [STYLE]</code></a
660
+ >
661
+ </li>
662
+ <li>
663
+ <a href="#block-setPortraitLayout"
664
+ ><code
665
+ >set portrait [PLACEMENT] offset x [X] y [Y] zoom [ZOOM] % corner
666
+ radius [RADIUS] px for bubble style [STYLE]</code
667
+ ></a
668
+ >
669
+ </li>
670
+ <li>
671
+ <a href="#block-setBubbleDistance"
672
+ ><code
673
+ >set bubble distance [DISTANCE] for bubble style [STYLE]</code
674
+ ></a
675
+ >
676
+ </li>
677
+ <li>
678
+ <a href="#block-setBubbleVisualStyle"
679
+ ><code
680
+ >set bubble visual style [VISUAL_STYLE] for bubble style
681
+ [STYLE]</code
682
+ ></a
683
+ >
684
+ </li>
685
+ <li>
686
+ <a href="#block-setBubbleTailLength"
687
+ ><code
688
+ >set bubble tail length [LENGTH] for bubble style [STYLE]</code
689
+ ></a
690
+ >
691
+ </li>
692
+ <li>
693
+ <a href="#block-setBubbleOffset"
694
+ ><code
695
+ >set bubble offset x [X] y [Y] scale [SCALE] % for bubble style
696
+ [STYLE]</code
697
+ ></a
698
+ >
699
+ </li>
700
+ <li>
701
+ <a href="#block-setBlinkFrames"
702
+ ><code
703
+ >set blink frames [ASSETS] every [SECONDS] seconds for bubble style
704
+ [STYLE]</code
705
+ ></a
706
+ >
707
+ </li>
708
+ <li>
709
+ <a href="#block-setLipSyncFrames"
710
+ ><code
711
+ >set lip-sync frames [ASSETS] every [SECONDS] seconds for bubble
712
+ style [STYLE]</code
713
+ ></a
714
+ >
715
+ </li>
716
+ <li>
717
+ <a href="#block-setContinueFrames"
718
+ ><code
719
+ >set continue frames [ASSETS] every [SECONDS] seconds for bubble
720
+ style [STYLE]</code
721
+ ></a
722
+ >
723
+ </li>
724
+ <li>
725
+ <a href="#block-setBubbleReveal"
726
+ ><code
727
+ >set bubble reveal unit [UNIT] every [SECONDS] seconds layout
728
+ [LAYOUT] for bubble style [STYLE]</code
729
+ ></a
730
+ >
731
+ </li>
732
+ <li>
733
+ <a href="#block-setBubbleWordDelimiters"
734
+ ><code
735
+ >set bubble word delimiters [DELIMITERS] show [SHOW] for bubble
736
+ style [STYLE]</code
737
+ ></a
738
+ >
739
+ </li>
740
+ <li>
741
+ <a href="#block-setBubbleRevealSound"
742
+ ><code
743
+ >set bubble reveal sound [ASSET] for bubble style [STYLE]</code
744
+ ></a
745
+ >
746
+ </li>
747
+ <li>
748
+ <a href="#block-setBubbleVoice"
749
+ ><code>set bubble voice [ASSET] for bubble style [STYLE]</code></a
750
+ >
751
+ </li>
752
+ <li>
753
+ <a href="#block-finishBubbleReveal"
754
+ ><code
755
+ >finish [UNIT] with condition [CONDITION] or timeout after [TIMEOUT]
756
+ seconds</code
757
+ ></a
758
+ >
759
+ </li>
760
+ <li>
761
+ <a href="#block-setBubbleShowAnimation"
762
+ ><code
763
+ >set bubble show animation [MOTION] for [SECONDS] seconds for bubble
764
+ style [STYLE]</code
765
+ ></a
766
+ >
767
+ </li>
768
+ <li>
769
+ <a href="#block-setBubbleHideAnimation"
770
+ ><code
771
+ >set bubble hide animation [MOTION] for [SECONDS] seconds for bubble
772
+ style [STYLE]</code
773
+ ></a
774
+ >
775
+ </li>
776
+ <li>
777
+ <a href="#block-animateBubble"
778
+ ><code>animate this bubble [MOTION]</code></a
779
+ >
780
+ </li>
781
+ <li>
782
+ <a href="#block-shakeBubble"
783
+ ><code
784
+ >shake this bubble direction [DIRECTION] count [COUNT] ease
785
+ [EASE]</code
786
+ ></a
787
+ >
788
+ </li>
789
+ <li>
790
+ <a href="#block-explodeBubble"
791
+ ><code
792
+ >explode this bubble relative scale [SCALE] count [COUNT] ease
793
+ [EASE]</code
794
+ ></a
795
+ >
796
+ </li>
797
+ <li>
798
+ <a href="#block-animateBubbleShape"
799
+ ><code
800
+ >animate bubble shape to [VISUAL_STYLE] speed [SPEED] for [SECONDS]
801
+ seconds</code
802
+ ></a
803
+ >
804
+ </li>
805
+ <li>
806
+ <a href="#block-say"><code>say [MESSAGE]</code></a>
807
+ </li>
808
+ <li>
809
+ <a href="#block-think"><code>think [MESSAGE]</code></a>
810
+ </li>
811
+ <li>
812
+ <a href="#block-showWithBubbleStyle"
813
+ ><code>show [MESSAGE] with bubble style [STYLE]</code></a
814
+ >
815
+ </li>
816
+ <li>
817
+ <a href="#block-sayWithBubbleStyle"
818
+ ><code>say [MESSAGE] with bubble style [STYLE]</code></a
819
+ >
820
+ </li>
821
+ <li>
822
+ <a href="#block-thinkWithBubbleStyle"
823
+ ><code>think [MESSAGE] with bubble style [STYLE]</code></a
824
+ >
825
+ </li>
826
+ <li>
827
+ <a href="#block-setBubbleAnimationMode"
828
+ ><code>set this bubble animation mode [MODE]</code></a
829
+ >
830
+ </li>
831
+ <li>
832
+ <a href="#block-waitForBubbleContinue"
833
+ ><code
834
+ >wait with this bubble until condition [CONDITION] or timeout after
835
+ [TIMEOUT] seconds</code
836
+ ></a
837
+ >
838
+ </li>
839
+ <li>
840
+ <a href="#block-waitAndCloseBubbleWithPolicy"
841
+ ><code
842
+ >wait and close this bubble using close policy [POLICY]</code
843
+ ></a
844
+ >
845
+ </li>
846
+ <li>
847
+ <a href="#block-closeBubble"><code>close this bubble</code></a>
848
+ </li>
849
+ <li>
850
+ <a href="#block-getVersion"><code>Bubble version</code></a>
851
+ </li>
852
+ </ul>
853
+ </nav>
854
+ <article id="block-defineBubbleStyle" class="block-reference-entry">
855
+ <h3>
856
+ <code>define bubble style [STYLE] using text style [TEXT_STYLE]</code>
857
+ </h3>
858
+ <p>
859
+ Defines or replaces a bubble style. The default text style without further
860
+ settings uses the Scratch-compatible basic profile.
861
+ </p>
862
+ <p>
863
+ Block type: COMMAND. Opcode: <code>defineBubbleStyle</code>.
864
+ <a href="#block-defineBubbleStyle">Permanent link</a>
865
+ </p>
866
+ <div class="block-reference-table">
867
+ <table>
868
+ <thead>
869
+ <tr>
870
+ <th>Argument</th>
871
+ <th>Type</th>
872
+ <th>Default value</th>
873
+ <th>Menu choices</th>
874
+ </tr>
875
+ </thead>
876
+ <tbody>
877
+ <tr>
878
+ <th scope="row"><code>STYLE</code></th>
879
+ <td>STRING</td>
880
+ <td><code>dialogue</code></td>
881
+ <td></td>
882
+ </tr>
883
+ <tr>
884
+ <th scope="row"><code>TEXT_STYLE</code></th>
885
+ <td>STRING</td>
886
+ <td><code>default</code></td>
887
+ <td></td>
888
+ </tr>
889
+ </tbody>
890
+ </table>
891
+ </div>
892
+ </article>
893
+ <article id="block-defineBubbleClosePolicy" class="block-reference-entry">
894
+ <p>
895
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
896
+ </p>
897
+ <h3>
898
+ <code
899
+ >define bubble close policy [POLICY] trigger [TRIGGER] condition
900
+ [CONDITION] timeout [TIMEOUT] seconds</code
901
+ >
902
+ </h3>
903
+ <p>
904
+ Defines or replaces a named close policy. The trigger explicitly selects a
905
+ condition, a timeout, or whichever happens first.
906
+ </p>
907
+ <p>
908
+ Block type: COMMAND. Opcode: <code>defineBubbleClosePolicy</code>.
909
+ <a href="#block-defineBubbleClosePolicy">Permanent link</a>
910
+ </p>
911
+ <div class="block-reference-table">
912
+ <table>
913
+ <thead>
914
+ <tr>
915
+ <th>Argument</th>
916
+ <th>Type</th>
917
+ <th>Default value</th>
918
+ <th>Menu choices</th>
919
+ </tr>
920
+ </thead>
921
+ <tbody>
922
+ <tr>
923
+ <th scope="row"><code>POLICY</code></th>
924
+ <td>STRING</td>
925
+ <td><code>advance-or-timeout</code></td>
926
+ <td></td>
927
+ </tr>
928
+ <tr>
929
+ <th scope="row"><code>TRIGGER</code></th>
930
+ <td>STRING</td>
931
+ <td><code>condition-or-timeout</code></td>
932
+ <td>
933
+ <ul>
934
+ <li><code>condition</code></li>
935
+ <li><code>timeout</code></li>
936
+ <li><code>condition-or-timeout</code></li>
937
+ </ul>
938
+ </td>
939
+ </tr>
940
+ <tr>
941
+ <th scope="row"><code>CONDITION</code></th>
942
+ <td>STRING</td>
943
+ <td><code>input == &quot;pressed&quot;</code></td>
944
+ <td></td>
945
+ </tr>
946
+ <tr>
947
+ <th scope="row"><code>TIMEOUT</code></th>
948
+ <td>NUMBER</td>
949
+ <td><code>10</code></td>
950
+ <td></td>
951
+ </tr>
952
+ </tbody>
953
+ </table>
954
+ </div>
955
+ </article>
956
+ <article id="block-setBubblePlacement" class="block-reference-entry">
957
+ <h3>
958
+ <code>set bubble placement [PLACEMENT] for bubble style [STYLE]</code>
959
+ </h3>
960
+ <p>
961
+ Sets an actor-relative direction/angle or a background-relative region.
962
+ Direction aliases and Scratch-style degrees from 0 through 360 are
963
+ accepted.
964
+ </p>
965
+ <p>
966
+ Block type: COMMAND. Opcode: <code>setBubblePlacement</code>.
967
+ <a href="#block-setBubblePlacement">Permanent link</a>
968
+ </p>
969
+ <div class="block-reference-table">
970
+ <table>
971
+ <thead>
972
+ <tr>
973
+ <th>Argument</th>
974
+ <th>Type</th>
975
+ <th>Default value</th>
976
+ <th>Menu choices</th>
977
+ </tr>
978
+ </thead>
979
+ <tbody>
980
+ <tr>
981
+ <th scope="row"><code>PLACEMENT</code></th>
982
+ <td>STRING</td>
983
+ <td><code>up-right</code></td>
984
+ <td>
985
+ <ul>
986
+ <li><code>up</code></li>
987
+ <li><code>up-up-right</code></li>
988
+ <li><code>up-right</code></li>
989
+ <li><code>right-up-right</code></li>
990
+ <li><code>right</code></li>
991
+ <li><code>right-down-right</code></li>
992
+ <li><code>down-right</code></li>
993
+ <li><code>down-down-right</code></li>
994
+ <li><code>down</code></li>
995
+ <li><code>down-down-left</code></li>
996
+ <li><code>down-left</code></li>
997
+ <li><code>left-down-left</code></li>
998
+ <li><code>left</code></li>
999
+ <li><code>left-up-left</code></li>
1000
+ <li><code>up-left</code></li>
1001
+ <li><code>up-up-left</code></li>
1002
+ <li><code>HEADER_LIKE</code></li>
1003
+ <li><code>CENTER</code></li>
1004
+ <li><code>FOOTER_LIKE</code></li>
1005
+ </ul>
1006
+ </td>
1007
+ </tr>
1008
+ <tr>
1009
+ <th scope="row"><code>STYLE</code></th>
1010
+ <td>STRING</td>
1011
+ <td><code>dialogue</code></td>
1012
+ <td></td>
1013
+ </tr>
1014
+ </tbody>
1015
+ </table>
1016
+ </div>
1017
+ </article>
1018
+ <article id="block-setPortraitBase" class="block-reference-entry">
1019
+ <h3><code>set portrait base [ASSET] for bubble style [STYLE]</code></h3>
1020
+ <p>
1021
+ Sets the registered image asset used as the portrait base. An empty asset
1022
+ removes the complete portrait.
1023
+ </p>
1024
+ <p>
1025
+ Block type: COMMAND. Opcode: <code>setPortraitBase</code>.
1026
+ <a href="#block-setPortraitBase">Permanent link</a>
1027
+ </p>
1028
+ <div class="block-reference-table">
1029
+ <table>
1030
+ <thead>
1031
+ <tr>
1032
+ <th>Argument</th>
1033
+ <th>Type</th>
1034
+ <th>Default value</th>
1035
+ <th>Menu choices</th>
1036
+ </tr>
1037
+ </thead>
1038
+ <tbody>
1039
+ <tr>
1040
+ <th scope="row"><code>ASSET</code></th>
1041
+ <td>STRING</td>
1042
+ <td><code>HeroFace</code></td>
1043
+ <td></td>
1044
+ </tr>
1045
+ <tr>
1046
+ <th scope="row"><code>STYLE</code></th>
1047
+ <td>STRING</td>
1048
+ <td><code>dialogue</code></td>
1049
+ <td></td>
1050
+ </tr>
1051
+ </tbody>
1052
+ </table>
1053
+ </div>
1054
+ </article>
1055
+ <article id="block-setPortraitLayout" class="block-reference-entry">
1056
+ <p>
1057
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1058
+ </p>
1059
+ <h3>
1060
+ <code
1061
+ >set portrait [PLACEMENT] offset x [X] y [Y] zoom [ZOOM] % corner radius
1062
+ [RADIUS] px for bubble style [STYLE]</code
1063
+ >
1064
+ </h3>
1065
+ <p>
1066
+ Places the portrait at a bubble edge or corner with a local offset, zoom,
1067
+ and rounded corners. NONE removes the portrait.
1068
+ </p>
1069
+ <p>
1070
+ Block type: COMMAND. Opcode: <code>setPortraitLayout</code>.
1071
+ <a href="#block-setPortraitLayout">Permanent link</a>
1072
+ </p>
1073
+ <div class="block-reference-table">
1074
+ <table>
1075
+ <thead>
1076
+ <tr>
1077
+ <th>Argument</th>
1078
+ <th>Type</th>
1079
+ <th>Default value</th>
1080
+ <th>Menu choices</th>
1081
+ </tr>
1082
+ </thead>
1083
+ <tbody>
1084
+ <tr>
1085
+ <th scope="row"><code>PLACEMENT</code></th>
1086
+ <td>STRING</td>
1087
+ <td><code>left</code></td>
1088
+ <td>
1089
+ <ul>
1090
+ <li><code>none</code></li>
1091
+ <li><code>left</code></li>
1092
+ <li><code>right</code></li>
1093
+ <li><code>top-left</code></li>
1094
+ <li><code>top-right</code></li>
1095
+ <li><code>bottom-left</code></li>
1096
+ <li><code>bottom-right</code></li>
1097
+ </ul>
1098
+ </td>
1099
+ </tr>
1100
+ <tr>
1101
+ <th scope="row"><code>X</code></th>
1102
+ <td>NUMBER</td>
1103
+ <td><code>0</code></td>
1104
+ <td></td>
1105
+ </tr>
1106
+ <tr>
1107
+ <th scope="row"><code>Y</code></th>
1108
+ <td>NUMBER</td>
1109
+ <td><code>0</code></td>
1110
+ <td></td>
1111
+ </tr>
1112
+ <tr>
1113
+ <th scope="row"><code>ZOOM</code></th>
1114
+ <td>NUMBER</td>
1115
+ <td><code>100</code></td>
1116
+ <td></td>
1117
+ </tr>
1118
+ <tr>
1119
+ <th scope="row"><code>RADIUS</code></th>
1120
+ <td>NUMBER</td>
1121
+ <td><code>0</code></td>
1122
+ <td></td>
1123
+ </tr>
1124
+ <tr>
1125
+ <th scope="row"><code>STYLE</code></th>
1126
+ <td>STRING</td>
1127
+ <td><code>dialogue</code></td>
1128
+ <td></td>
1129
+ </tr>
1130
+ </tbody>
1131
+ </table>
1132
+ </div>
1133
+ </article>
1134
+ <article id="block-setBubbleDistance" class="block-reference-entry">
1135
+ <p>
1136
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1137
+ </p>
1138
+ <h3>
1139
+ <code>set bubble distance [DISTANCE] for bubble style [STYLE]</code>
1140
+ </h3>
1141
+ <p>
1142
+ Sets the distance from the actor bounds to the tail tip for actor-relative
1143
+ placement.
1144
+ </p>
1145
+ <p>
1146
+ Block type: COMMAND. Opcode: <code>setBubbleDistance</code>.
1147
+ <a href="#block-setBubbleDistance">Permanent link</a>
1148
+ </p>
1149
+ <div class="block-reference-table">
1150
+ <table>
1151
+ <thead>
1152
+ <tr>
1153
+ <th>Argument</th>
1154
+ <th>Type</th>
1155
+ <th>Default value</th>
1156
+ <th>Menu choices</th>
1157
+ </tr>
1158
+ </thead>
1159
+ <tbody>
1160
+ <tr>
1161
+ <th scope="row"><code>DISTANCE</code></th>
1162
+ <td>NUMBER</td>
1163
+ <td><code>12</code></td>
1164
+ <td></td>
1165
+ </tr>
1166
+ <tr>
1167
+ <th scope="row"><code>STYLE</code></th>
1168
+ <td>STRING</td>
1169
+ <td><code>dialogue</code></td>
1170
+ <td></td>
1171
+ </tr>
1172
+ </tbody>
1173
+ </table>
1174
+ </div>
1175
+ </article>
1176
+ <article id="block-setBubbleVisualStyle" class="block-reference-entry">
1177
+ <p>
1178
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1179
+ </p>
1180
+ <h3>
1181
+ <code
1182
+ >set bubble visual style [VISUAL_STYLE] for bubble style [STYLE]</code
1183
+ >
1184
+ </h3>
1185
+ <p>
1186
+ Sets the inseparable SVG body and tail or trail shape pair used by this
1187
+ bubble style.
1188
+ </p>
1189
+ <p>
1190
+ Block type: COMMAND. Opcode: <code>setBubbleVisualStyle</code>.
1191
+ <a href="#block-setBubbleVisualStyle">Permanent link</a>
1192
+ </p>
1193
+ <div class="block-reference-table">
1194
+ <table>
1195
+ <thead>
1196
+ <tr>
1197
+ <th>Argument</th>
1198
+ <th>Type</th>
1199
+ <th>Default value</th>
1200
+ <th>Menu choices</th>
1201
+ </tr>
1202
+ </thead>
1203
+ <tbody>
1204
+ <tr>
1205
+ <th scope="row"><code>VISUAL_STYLE</code></th>
1206
+ <td>STRING</td>
1207
+ <td><code>NORMAL</code></td>
1208
+ <td>
1209
+ <ul>
1210
+ <li><code>NORMAL</code></li>
1211
+ <li><code>THINKING</code></li>
1212
+ <li><code>DREAMING</code></li>
1213
+ <li><code>YELLING</code></li>
1214
+ <li><code>OFF_PANEL</code></li>
1215
+ <li><code>WAVY</code></li>
1216
+ <li><code>WHISPERING</code></li>
1217
+ <li><code>ANNOUNCEMENT</code></li>
1218
+ <li><code>NARRATION</code></li>
1219
+ <li><code>NO_BUBBLE</code></li>
1220
+ </ul>
1221
+ </td>
1222
+ </tr>
1223
+ <tr>
1224
+ <th scope="row"><code>STYLE</code></th>
1225
+ <td>STRING</td>
1226
+ <td><code>dialogue</code></td>
1227
+ <td></td>
1228
+ </tr>
1229
+ </tbody>
1230
+ </table>
1231
+ </div>
1232
+ </article>
1233
+ <article id="block-setBubbleTailLength" class="block-reference-entry">
1234
+ <p>
1235
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1236
+ </p>
1237
+ <h3>
1238
+ <code>set bubble tail length [LENGTH] for bubble style [STYLE]</code>
1239
+ </h3>
1240
+ <p>
1241
+ Sets the nominal length from the bubble border to the tail tip for
1242
+ actor-relative placement.
1243
+ </p>
1244
+ <p>
1245
+ Block type: COMMAND. Opcode: <code>setBubbleTailLength</code>.
1246
+ <a href="#block-setBubbleTailLength">Permanent link</a>
1247
+ </p>
1248
+ <div class="block-reference-table">
1249
+ <table>
1250
+ <thead>
1251
+ <tr>
1252
+ <th>Argument</th>
1253
+ <th>Type</th>
1254
+ <th>Default value</th>
1255
+ <th>Menu choices</th>
1256
+ </tr>
1257
+ </thead>
1258
+ <tbody>
1259
+ <tr>
1260
+ <th scope="row"><code>LENGTH</code></th>
1261
+ <td>NUMBER</td>
1262
+ <td><code>18</code></td>
1263
+ <td></td>
1264
+ </tr>
1265
+ <tr>
1266
+ <th scope="row"><code>STYLE</code></th>
1267
+ <td>STRING</td>
1268
+ <td><code>dialogue</code></td>
1269
+ <td></td>
1270
+ </tr>
1271
+ </tbody>
1272
+ </table>
1273
+ </div>
1274
+ </article>
1275
+ <article id="block-setBubbleOffset" class="block-reference-entry">
1276
+ <p>
1277
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1278
+ </p>
1279
+ <h3>
1280
+ <code
1281
+ >set bubble offset x [X] y [Y] scale [SCALE] % for bubble style
1282
+ [STYLE]</code
1283
+ >
1284
+ </h3>
1285
+ <p>
1286
+ Offsets and scales the bubble body while keeping scale-only actor distance
1287
+ constant.
1288
+ </p>
1289
+ <p>
1290
+ Block type: COMMAND. Opcode: <code>setBubbleOffset</code>.
1291
+ <a href="#block-setBubbleOffset">Permanent link</a>
1292
+ </p>
1293
+ <div class="block-reference-table">
1294
+ <table>
1295
+ <thead>
1296
+ <tr>
1297
+ <th>Argument</th>
1298
+ <th>Type</th>
1299
+ <th>Default value</th>
1300
+ <th>Menu choices</th>
1301
+ </tr>
1302
+ </thead>
1303
+ <tbody>
1304
+ <tr>
1305
+ <th scope="row"><code>X</code></th>
1306
+ <td>NUMBER</td>
1307
+ <td><code>0</code></td>
1308
+ <td></td>
1309
+ </tr>
1310
+ <tr>
1311
+ <th scope="row"><code>Y</code></th>
1312
+ <td>NUMBER</td>
1313
+ <td><code>0</code></td>
1314
+ <td></td>
1315
+ </tr>
1316
+ <tr>
1317
+ <th scope="row"><code>SCALE</code></th>
1318
+ <td>NUMBER</td>
1319
+ <td><code>100</code></td>
1320
+ <td></td>
1321
+ </tr>
1322
+ <tr>
1323
+ <th scope="row"><code>STYLE</code></th>
1324
+ <td>STRING</td>
1325
+ <td><code>dialogue</code></td>
1326
+ <td></td>
1327
+ </tr>
1328
+ </tbody>
1329
+ </table>
1330
+ </div>
1331
+ </article>
1332
+ <article id="block-setBlinkFrames" class="block-reference-entry">
1333
+ <p>
1334
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1335
+ </p>
1336
+ <h3>
1337
+ <code
1338
+ >set blink frames [ASSETS] every [SECONDS] seconds for bubble style
1339
+ [STYLE]</code
1340
+ >
1341
+ </h3>
1342
+ <p>
1343
+ Sets comma-separated registered image assets for the portrait blink layer.
1344
+ An empty list removes blink animation.
1345
+ </p>
1346
+ <p>
1347
+ Block type: COMMAND. Opcode: <code>setBlinkFrames</code>.
1348
+ <a href="#block-setBlinkFrames">Permanent link</a>
1349
+ </p>
1350
+ <div class="block-reference-table">
1351
+ <table>
1352
+ <thead>
1353
+ <tr>
1354
+ <th>Argument</th>
1355
+ <th>Type</th>
1356
+ <th>Default value</th>
1357
+ <th>Menu choices</th>
1358
+ </tr>
1359
+ </thead>
1360
+ <tbody>
1361
+ <tr>
1362
+ <th scope="row"><code>ASSETS</code></th>
1363
+ <td>STRING</td>
1364
+ <td><code>EyesOpen,EyesClosed</code></td>
1365
+ <td></td>
1366
+ </tr>
1367
+ <tr>
1368
+ <th scope="row"><code>SECONDS</code></th>
1369
+ <td>NUMBER</td>
1370
+ <td><code>0.4</code></td>
1371
+ <td></td>
1372
+ </tr>
1373
+ <tr>
1374
+ <th scope="row"><code>STYLE</code></th>
1375
+ <td>STRING</td>
1376
+ <td><code>dialogue</code></td>
1377
+ <td></td>
1378
+ </tr>
1379
+ </tbody>
1380
+ </table>
1381
+ </div>
1382
+ </article>
1383
+ <article id="block-setLipSyncFrames" class="block-reference-entry">
1384
+ <p>
1385
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1386
+ </p>
1387
+ <h3>
1388
+ <code
1389
+ >set lip-sync frames [ASSETS] every [SECONDS] seconds for bubble style
1390
+ [STYLE]</code
1391
+ >
1392
+ </h3>
1393
+ <p>
1394
+ Sets comma-separated registered image assets for the portrait lip-sync
1395
+ layer. An empty list removes lip-sync animation.
1396
+ </p>
1397
+ <p>
1398
+ Block type: COMMAND. Opcode: <code>setLipSyncFrames</code>.
1399
+ <a href="#block-setLipSyncFrames">Permanent link</a>
1400
+ </p>
1401
+ <div class="block-reference-table">
1402
+ <table>
1403
+ <thead>
1404
+ <tr>
1405
+ <th>Argument</th>
1406
+ <th>Type</th>
1407
+ <th>Default value</th>
1408
+ <th>Menu choices</th>
1409
+ </tr>
1410
+ </thead>
1411
+ <tbody>
1412
+ <tr>
1413
+ <th scope="row"><code>ASSETS</code></th>
1414
+ <td>STRING</td>
1415
+ <td><code>MouthClosed,MouthOpen</code></td>
1416
+ <td></td>
1417
+ </tr>
1418
+ <tr>
1419
+ <th scope="row"><code>SECONDS</code></th>
1420
+ <td>NUMBER</td>
1421
+ <td><code>0.1</code></td>
1422
+ <td></td>
1423
+ </tr>
1424
+ <tr>
1425
+ <th scope="row"><code>STYLE</code></th>
1426
+ <td>STRING</td>
1427
+ <td><code>dialogue</code></td>
1428
+ <td></td>
1429
+ </tr>
1430
+ </tbody>
1431
+ </table>
1432
+ </div>
1433
+ </article>
1434
+ <article id="block-setContinueFrames" class="block-reference-entry">
1435
+ <p>
1436
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1437
+ </p>
1438
+ <h3>
1439
+ <code
1440
+ >set continue frames [ASSETS] every [SECONDS] seconds for bubble style
1441
+ [STYLE]</code
1442
+ >
1443
+ </h3>
1444
+ <p>
1445
+ Sets at least two comma-separated registered image assets for the
1446
+ awaiting-continue indicator. An empty list removes the indicator.
1447
+ </p>
1448
+ <p>
1449
+ Block type: COMMAND. Opcode: <code>setContinueFrames</code>.
1450
+ <a href="#block-setContinueFrames">Permanent link</a>
1451
+ </p>
1452
+ <div class="block-reference-table">
1453
+ <table>
1454
+ <thead>
1455
+ <tr>
1456
+ <th>Argument</th>
1457
+ <th>Type</th>
1458
+ <th>Default value</th>
1459
+ <th>Menu choices</th>
1460
+ </tr>
1461
+ </thead>
1462
+ <tbody>
1463
+ <tr>
1464
+ <th scope="row"><code>ASSETS</code></th>
1465
+ <td>STRING</td>
1466
+ <td><code>Next1,Next2</code></td>
1467
+ <td></td>
1468
+ </tr>
1469
+ <tr>
1470
+ <th scope="row"><code>SECONDS</code></th>
1471
+ <td>NUMBER</td>
1472
+ <td><code>0.2</code></td>
1473
+ <td></td>
1474
+ </tr>
1475
+ <tr>
1476
+ <th scope="row"><code>STYLE</code></th>
1477
+ <td>STRING</td>
1478
+ <td><code>dialogue</code></td>
1479
+ <td></td>
1480
+ </tr>
1481
+ </tbody>
1482
+ </table>
1483
+ </div>
1484
+ </article>
1485
+ <article id="block-setBubbleReveal" class="block-reference-entry">
1486
+ <p>
1487
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1488
+ </p>
1489
+ <h3>
1490
+ <code
1491
+ >set bubble reveal unit [UNIT] every [SECONDS] seconds layout [LAYOUT]
1492
+ for bubble style [STYLE]</code
1493
+ >
1494
+ </h3>
1495
+ <p>
1496
+ Sets CHARACTER, WORD, LINE, or BLOCK sequential reveal. WORD uses the
1497
+ configured delimiters; DYNAMIC reflows as text grows and RESERVED reserves
1498
+ the final text size.
1499
+ </p>
1500
+ <p>
1501
+ Block type: COMMAND. Opcode: <code>setBubbleReveal</code>.
1502
+ <a href="#block-setBubbleReveal">Permanent link</a>
1503
+ </p>
1504
+ <div class="block-reference-table">
1505
+ <table>
1506
+ <thead>
1507
+ <tr>
1508
+ <th>Argument</th>
1509
+ <th>Type</th>
1510
+ <th>Default value</th>
1511
+ <th>Menu choices</th>
1512
+ </tr>
1513
+ </thead>
1514
+ <tbody>
1515
+ <tr>
1516
+ <th scope="row"><code>UNIT</code></th>
1517
+ <td>STRING</td>
1518
+ <td><code>CHARACTER</code></td>
1519
+ <td>
1520
+ <ul>
1521
+ <li><code>CHARACTER</code></li>
1522
+ <li><code>WORD</code></li>
1523
+ <li><code>LINE</code></li>
1524
+ <li><code>BLOCK</code></li>
1525
+ </ul>
1526
+ </td>
1527
+ </tr>
1528
+ <tr>
1529
+ <th scope="row"><code>SECONDS</code></th>
1530
+ <td>NUMBER</td>
1531
+ <td><code>0.05</code></td>
1532
+ <td></td>
1533
+ </tr>
1534
+ <tr>
1535
+ <th scope="row"><code>LAYOUT</code></th>
1536
+ <td>STRING</td>
1537
+ <td><code>DYNAMIC</code></td>
1538
+ <td>
1539
+ <ul>
1540
+ <li><code>DYNAMIC</code></li>
1541
+ <li><code>RESERVED</code></li>
1542
+ </ul>
1543
+ </td>
1544
+ </tr>
1545
+ <tr>
1546
+ <th scope="row"><code>STYLE</code></th>
1547
+ <td>STRING</td>
1548
+ <td><code>dialogue</code></td>
1549
+ <td></td>
1550
+ </tr>
1551
+ </tbody>
1552
+ </table>
1553
+ </div>
1554
+ </article>
1555
+ <article id="block-setBubbleWordDelimiters" class="block-reference-entry">
1556
+ <p>
1557
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1558
+ </p>
1559
+ <h3>
1560
+ <code
1561
+ >set bubble word delimiters [DELIMITERS] show [SHOW] for bubble style
1562
+ [STYLE]</code
1563
+ >
1564
+ </h3>
1565
+ <p>
1566
+ Sets the character set used by WORD reveal and chooses whether delimiters
1567
+ remain visible.
1568
+ </p>
1569
+ <p>
1570
+ Block type: COMMAND. Opcode: <code>setBubbleWordDelimiters</code>.
1571
+ <a href="#block-setBubbleWordDelimiters">Permanent link</a>
1572
+ </p>
1573
+ <div class="block-reference-table">
1574
+ <table>
1575
+ <thead>
1576
+ <tr>
1577
+ <th>Argument</th>
1578
+ <th>Type</th>
1579
+ <th>Default value</th>
1580
+ <th>Menu choices</th>
1581
+ </tr>
1582
+ </thead>
1583
+ <tbody>
1584
+ <tr>
1585
+ <th scope="row"><code>DELIMITERS</code></th>
1586
+ <td>STRING</td>
1587
+ <td><code> /</code></td>
1588
+ <td></td>
1589
+ </tr>
1590
+ <tr>
1591
+ <th scope="row"><code>SHOW</code></th>
1592
+ <td>STRING</td>
1593
+ <td><code>false</code></td>
1594
+ <td>
1595
+ <ul>
1596
+ <li><code>false</code></li>
1597
+ <li><code>true</code></li>
1598
+ </ul>
1599
+ </td>
1600
+ </tr>
1601
+ <tr>
1602
+ <th scope="row"><code>STYLE</code></th>
1603
+ <td>STRING</td>
1604
+ <td><code>dialogue</code></td>
1605
+ <td></td>
1606
+ </tr>
1607
+ </tbody>
1608
+ </table>
1609
+ </div>
1610
+ </article>
1611
+ <article id="block-setBubbleRevealSound" class="block-reference-entry">
1612
+ <h3>
1613
+ <code>set bubble reveal sound [ASSET] for bubble style [STYLE]</code>
1614
+ </h3>
1615
+ <p>
1616
+ Sets a named audio asset played once per CHARACTER, WORD, LINE, or BLOCK
1617
+ reveal.
1618
+ </p>
1619
+ <p>
1620
+ Block type: COMMAND. Opcode: <code>setBubbleRevealSound</code>.
1621
+ <a href="#block-setBubbleRevealSound">Permanent link</a>
1622
+ </p>
1623
+ <div class="block-reference-table">
1624
+ <table>
1625
+ <thead>
1626
+ <tr>
1627
+ <th>Argument</th>
1628
+ <th>Type</th>
1629
+ <th>Default value</th>
1630
+ <th>Menu choices</th>
1631
+ </tr>
1632
+ </thead>
1633
+ <tbody>
1634
+ <tr>
1635
+ <th scope="row"><code>ASSET</code></th>
1636
+ <td>STRING</td>
1637
+ <td><code>Typewriter</code></td>
1638
+ <td></td>
1639
+ </tr>
1640
+ <tr>
1641
+ <th scope="row"><code>STYLE</code></th>
1642
+ <td>STRING</td>
1643
+ <td><code>dialogue</code></td>
1644
+ <td></td>
1645
+ </tr>
1646
+ </tbody>
1647
+ </table>
1648
+ </div>
1649
+ </article>
1650
+ <article id="block-setBubbleVoice" class="block-reference-entry">
1651
+ <h3><code>set bubble voice [ASSET] for bubble style [STYLE]</code></h3>
1652
+ <p>Sets the named full-voice audio asset played when the Bubble starts.</p>
1653
+ <p>
1654
+ Block type: COMMAND. Opcode: <code>setBubbleVoice</code>.
1655
+ <a href="#block-setBubbleVoice">Permanent link</a>
1656
+ </p>
1657
+ <div class="block-reference-table">
1658
+ <table>
1659
+ <thead>
1660
+ <tr>
1661
+ <th>Argument</th>
1662
+ <th>Type</th>
1663
+ <th>Default value</th>
1664
+ <th>Menu choices</th>
1665
+ </tr>
1666
+ </thead>
1667
+ <tbody>
1668
+ <tr>
1669
+ <th scope="row"><code>ASSET</code></th>
1670
+ <td>STRING</td>
1671
+ <td><code>Voice</code></td>
1672
+ <td></td>
1673
+ </tr>
1674
+ <tr>
1675
+ <th scope="row"><code>STYLE</code></th>
1676
+ <td>STRING</td>
1677
+ <td><code>dialogue</code></td>
1678
+ <td></td>
1679
+ </tr>
1680
+ </tbody>
1681
+ </table>
1682
+ </div>
1683
+ </article>
1684
+ <article id="block-finishBubbleReveal" class="block-reference-entry">
1685
+ <p>
1686
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1687
+ </p>
1688
+ <h3>
1689
+ <code
1690
+ >finish [UNIT] with condition [CONDITION] or timeout after [TIMEOUT]
1691
+ seconds</code
1692
+ >
1693
+ </h3>
1694
+ <p>
1695
+ Reveals the remaining units and waits for the Runtime Expression condition
1696
+ or timeout before completing.
1697
+ </p>
1698
+ <p>
1699
+ Block type: COMMAND. Opcode: <code>finishBubbleReveal</code>.
1700
+ <a href="#block-finishBubbleReveal">Permanent link</a>
1701
+ </p>
1702
+ <div class="block-reference-table">
1703
+ <table>
1704
+ <thead>
1705
+ <tr>
1706
+ <th>Argument</th>
1707
+ <th>Type</th>
1708
+ <th>Default value</th>
1709
+ <th>Menu choices</th>
1710
+ </tr>
1711
+ </thead>
1712
+ <tbody>
1713
+ <tr>
1714
+ <th scope="row"><code>UNIT</code></th>
1715
+ <td>STRING</td>
1716
+ <td><code>CHARACTER</code></td>
1717
+ <td>
1718
+ <ul>
1719
+ <li><code>CHARACTER</code></li>
1720
+ <li><code>WORD</code></li>
1721
+ <li><code>LINE</code></li>
1722
+ <li><code>BLOCK</code></li>
1723
+ </ul>
1724
+ </td>
1725
+ </tr>
1726
+ <tr>
1727
+ <th scope="row"><code>CONDITION</code></th>
1728
+ <td>STRING</td>
1729
+ <td><code>input == &quot;pressed&quot;</code></td>
1730
+ <td></td>
1731
+ </tr>
1732
+ <tr>
1733
+ <th scope="row"><code>TIMEOUT</code></th>
1734
+ <td>NUMBER</td>
1735
+ <td><code>10</code></td>
1736
+ <td></td>
1737
+ </tr>
1738
+ </tbody>
1739
+ </table>
1740
+ </div>
1741
+ </article>
1742
+ <article id="block-setBubbleShowAnimation" class="block-reference-entry">
1743
+ <p>
1744
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1745
+ </p>
1746
+ <h3>
1747
+ <code
1748
+ >set bubble show animation [MOTION] for [SECONDS] seconds for bubble
1749
+ style [STYLE]</code
1750
+ >
1751
+ </h3>
1752
+ <p>Selects the animation played when a Bubble starts displaying.</p>
1753
+ <p>
1754
+ Block type: COMMAND. Opcode: <code>setBubbleShowAnimation</code>.
1755
+ <a href="#block-setBubbleShowAnimation">Permanent link</a>
1756
+ </p>
1757
+ <div class="block-reference-table">
1758
+ <table>
1759
+ <thead>
1760
+ <tr>
1761
+ <th>Argument</th>
1762
+ <th>Type</th>
1763
+ <th>Default value</th>
1764
+ <th>Menu choices</th>
1765
+ </tr>
1766
+ </thead>
1767
+ <tbody>
1768
+ <tr>
1769
+ <th scope="row"><code>MOTION</code></th>
1770
+ <td>STRING</td>
1771
+ <td><code>fadeIn</code></td>
1772
+ <td>
1773
+ <ul>
1774
+ <li><code>fadeIn</code></li>
1775
+ <li><code>floatIn</code></li>
1776
+ <li><code>zoomIn</code></li>
1777
+ <li><code>riseUp</code></li>
1778
+ </ul>
1779
+ </td>
1780
+ </tr>
1781
+ <tr>
1782
+ <th scope="row"><code>SECONDS</code></th>
1783
+ <td>NUMBER</td>
1784
+ <td><code>0.2</code></td>
1785
+ <td></td>
1786
+ </tr>
1787
+ <tr>
1788
+ <th scope="row"><code>STYLE</code></th>
1789
+ <td>STRING</td>
1790
+ <td><code>dialogue</code></td>
1791
+ <td></td>
1792
+ </tr>
1793
+ </tbody>
1794
+ </table>
1795
+ </div>
1796
+ </article>
1797
+ <article id="block-setBubbleHideAnimation" class="block-reference-entry">
1798
+ <p>
1799
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1800
+ </p>
1801
+ <h3>
1802
+ <code
1803
+ >set bubble hide animation [MOTION] for [SECONDS] seconds for bubble
1804
+ style [STYLE]</code
1805
+ >
1806
+ </h3>
1807
+ <p>
1808
+ Selects the animation played before a Bubble is closed. It works with both
1809
+ DYNAMIC and RESERVED layout.
1810
+ </p>
1811
+ <p>
1812
+ Block type: COMMAND. Opcode: <code>setBubbleHideAnimation</code>.
1813
+ <a href="#block-setBubbleHideAnimation">Permanent link</a>
1814
+ </p>
1815
+ <div class="block-reference-table">
1816
+ <table>
1817
+ <thead>
1818
+ <tr>
1819
+ <th>Argument</th>
1820
+ <th>Type</th>
1821
+ <th>Default value</th>
1822
+ <th>Menu choices</th>
1823
+ </tr>
1824
+ </thead>
1825
+ <tbody>
1826
+ <tr>
1827
+ <th scope="row"><code>MOTION</code></th>
1828
+ <td>STRING</td>
1829
+ <td><code>fadeOut</code></td>
1830
+ <td>
1831
+ <ul>
1832
+ <li><code>fadeOut</code></li>
1833
+ <li><code>floatOut</code></li>
1834
+ <li><code>zoomOut</code></li>
1835
+ <li><code>sink</code></li>
1836
+ </ul>
1837
+ </td>
1838
+ </tr>
1839
+ <tr>
1840
+ <th scope="row"><code>SECONDS</code></th>
1841
+ <td>NUMBER</td>
1842
+ <td><code>0.2</code></td>
1843
+ <td></td>
1844
+ </tr>
1845
+ <tr>
1846
+ <th scope="row"><code>STYLE</code></th>
1847
+ <td>STRING</td>
1848
+ <td><code>dialogue</code></td>
1849
+ <td></td>
1850
+ </tr>
1851
+ </tbody>
1852
+ </table>
1853
+ </div>
1854
+ </article>
1855
+ <article id="block-animateBubble" class="block-reference-entry">
1856
+ <p>
1857
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1858
+ </p>
1859
+ <h3><code>animate this bubble [MOTION]</code></h3>
1860
+ <p>
1861
+ Plays an immediate display animation such as shake, explode, or a named
1862
+ show/hide motion.
1863
+ </p>
1864
+ <p>
1865
+ Block type: COMMAND. Opcode: <code>animateBubble</code>.
1866
+ <a href="#block-animateBubble">Permanent link</a>
1867
+ </p>
1868
+ <div class="block-reference-table">
1869
+ <table>
1870
+ <thead>
1871
+ <tr>
1872
+ <th>Argument</th>
1873
+ <th>Type</th>
1874
+ <th>Default value</th>
1875
+ <th>Menu choices</th>
1876
+ </tr>
1877
+ </thead>
1878
+ <tbody>
1879
+ <tr>
1880
+ <th scope="row"><code>MOTION</code></th>
1881
+ <td>STRING</td>
1882
+ <td><code>shake</code></td>
1883
+ <td>
1884
+ <ul>
1885
+ <li><code>fadeIn</code></li>
1886
+ <li><code>floatIn</code></li>
1887
+ <li><code>zoomIn</code></li>
1888
+ <li><code>riseUp</code></li>
1889
+ <li><code>fadeOut</code></li>
1890
+ <li><code>floatOut</code></li>
1891
+ <li><code>zoomOut</code></li>
1892
+ <li><code>sink</code></li>
1893
+ <li><code>shake</code></li>
1894
+ <li><code>explode</code></li>
1895
+ <li><code>animateBubbleShape</code></li>
1896
+ </ul>
1897
+ </td>
1898
+ </tr>
1899
+ </tbody>
1900
+ </table>
1901
+ </div>
1902
+ </article>
1903
+ <article id="block-shakeBubble" class="block-reference-entry">
1904
+ <p>
1905
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1906
+ </p>
1907
+ <h3>
1908
+ <code
1909
+ >shake this bubble direction [DIRECTION] count [COUNT] ease [EASE]</code
1910
+ >
1911
+ </h3>
1912
+ <p>
1913
+ Shakes the complete Bubble surface, including portrait and text, with an
1914
+ easing selection.
1915
+ </p>
1916
+ <p>
1917
+ Block type: COMMAND. Opcode: <code>shakeBubble</code>.
1918
+ <a href="#block-shakeBubble">Permanent link</a>
1919
+ </p>
1920
+ <div class="block-reference-table">
1921
+ <table>
1922
+ <thead>
1923
+ <tr>
1924
+ <th>Argument</th>
1925
+ <th>Type</th>
1926
+ <th>Default value</th>
1927
+ <th>Menu choices</th>
1928
+ </tr>
1929
+ </thead>
1930
+ <tbody>
1931
+ <tr>
1932
+ <th scope="row"><code>DIRECTION</code></th>
1933
+ <td>NUMBER</td>
1934
+ <td><code>90</code></td>
1935
+ <td></td>
1936
+ </tr>
1937
+ <tr>
1938
+ <th scope="row"><code>COUNT</code></th>
1939
+ <td>NUMBER</td>
1940
+ <td><code>2</code></td>
1941
+ <td></td>
1942
+ </tr>
1943
+ <tr>
1944
+ <th scope="row"><code>EASE</code></th>
1945
+ <td>STRING</td>
1946
+ <td><code>easeInOut</code></td>
1947
+ <td>
1948
+ <ul>
1949
+ <li><code>linear</code></li>
1950
+ <li><code>easeIn</code></li>
1951
+ <li><code>easeOut</code></li>
1952
+ <li><code>easeInOut</code></li>
1953
+ </ul>
1954
+ </td>
1955
+ </tr>
1956
+ </tbody>
1957
+ </table>
1958
+ </div>
1959
+ </article>
1960
+ <article id="block-explodeBubble" class="block-reference-entry">
1961
+ <p>
1962
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
1963
+ </p>
1964
+ <h3>
1965
+ <code
1966
+ >explode this bubble relative scale [SCALE] count [COUNT] ease
1967
+ [EASE]</code
1968
+ >
1969
+ </h3>
1970
+ <p>
1971
+ Changes the complete Bubble surface size by a relative amount for the
1972
+ requested number of cycles.
1973
+ </p>
1974
+ <p>
1975
+ Block type: COMMAND. Opcode: <code>explodeBubble</code>.
1976
+ <a href="#block-explodeBubble">Permanent link</a>
1977
+ </p>
1978
+ <div class="block-reference-table">
1979
+ <table>
1980
+ <thead>
1981
+ <tr>
1982
+ <th>Argument</th>
1983
+ <th>Type</th>
1984
+ <th>Default value</th>
1985
+ <th>Menu choices</th>
1986
+ </tr>
1987
+ </thead>
1988
+ <tbody>
1989
+ <tr>
1990
+ <th scope="row"><code>SCALE</code></th>
1991
+ <td>NUMBER</td>
1992
+ <td><code>1.15</code></td>
1993
+ <td></td>
1994
+ </tr>
1995
+ <tr>
1996
+ <th scope="row"><code>COUNT</code></th>
1997
+ <td>NUMBER</td>
1998
+ <td><code>2</code></td>
1999
+ <td></td>
2000
+ </tr>
2001
+ <tr>
2002
+ <th scope="row"><code>EASE</code></th>
2003
+ <td>STRING</td>
2004
+ <td><code>easeOut</code></td>
2005
+ <td>
2006
+ <ul>
2007
+ <li><code>linear</code></li>
2008
+ <li><code>easeIn</code></li>
2009
+ <li><code>easeOut</code></li>
2010
+ <li><code>easeInOut</code></li>
2011
+ </ul>
2012
+ </td>
2013
+ </tr>
2014
+ </tbody>
2015
+ </table>
2016
+ </div>
2017
+ </article>
2018
+ <article id="block-animateBubbleShape" class="block-reference-entry">
2019
+ <p>
2020
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
2021
+ </p>
2022
+ <h3>
2023
+ <code
2024
+ >animate bubble shape to [VISUAL_STYLE] speed [SPEED] for [SECONDS]
2025
+ seconds</code
2026
+ >
2027
+ </h3>
2028
+ <p>
2029
+ Transitions the Bubble outline to THINKING, DREAMING, YELLING, WAVY,
2030
+ WHISPERING, or another visual style.
2031
+ </p>
2032
+ <p>
2033
+ Block type: COMMAND. Opcode: <code>animateBubbleShape</code>.
2034
+ <a href="#block-animateBubbleShape">Permanent link</a>
2035
+ </p>
2036
+ <div class="block-reference-table">
2037
+ <table>
2038
+ <thead>
2039
+ <tr>
2040
+ <th>Argument</th>
2041
+ <th>Type</th>
2042
+ <th>Default value</th>
2043
+ <th>Menu choices</th>
2044
+ </tr>
2045
+ </thead>
2046
+ <tbody>
2047
+ <tr>
2048
+ <th scope="row"><code>VISUAL_STYLE</code></th>
2049
+ <td>STRING</td>
2050
+ <td><code>WAVY</code></td>
2051
+ <td>
2052
+ <ul>
2053
+ <li><code>NORMAL</code></li>
2054
+ <li><code>THINKING</code></li>
2055
+ <li><code>DREAMING</code></li>
2056
+ <li><code>YELLING</code></li>
2057
+ <li><code>OFF_PANEL</code></li>
2058
+ <li><code>WAVY</code></li>
2059
+ <li><code>WHISPERING</code></li>
2060
+ <li><code>ANNOUNCEMENT</code></li>
2061
+ <li><code>NARRATION</code></li>
2062
+ <li><code>NO_BUBBLE</code></li>
2063
+ </ul>
2064
+ </td>
2065
+ </tr>
2066
+ <tr>
2067
+ <th scope="row"><code>SPEED</code></th>
2068
+ <td>NUMBER</td>
2069
+ <td><code>1</code></td>
2070
+ <td></td>
2071
+ </tr>
2072
+ <tr>
2073
+ <th scope="row"><code>SECONDS</code></th>
2074
+ <td>NUMBER</td>
2075
+ <td><code>0.5</code></td>
2076
+ <td></td>
2077
+ </tr>
2078
+ </tbody>
2079
+ </table>
2080
+ </div>
2081
+ </article>
2082
+ <article id="block-say" class="block-reference-entry">
2083
+ <h3><code>say [MESSAGE]</code></h3>
2084
+ <p>
2085
+ Shows or replaces this sprite&#x27;s Scratch-compatible default say
2086
+ bubble. An empty message closes it.
2087
+ </p>
2088
+ <p>
2089
+ Block type: COMMAND. Opcode: <code>say</code>.
2090
+ <a href="#block-say">Permanent link</a>
2091
+ </p>
2092
+ <div class="block-reference-table">
2093
+ <table>
2094
+ <thead>
2095
+ <tr>
2096
+ <th>Argument</th>
2097
+ <th>Type</th>
2098
+ <th>Default value</th>
2099
+ <th>Menu choices</th>
2100
+ </tr>
2101
+ </thead>
2102
+ <tbody>
2103
+ <tr>
2104
+ <th scope="row"><code>MESSAGE</code></th>
2105
+ <td>STRING</td>
2106
+ <td><code>Hello!</code></td>
2107
+ <td></td>
2108
+ </tr>
2109
+ </tbody>
2110
+ </table>
2111
+ </div>
2112
+ </article>
2113
+ <article id="block-think" class="block-reference-entry">
2114
+ <h3><code>think [MESSAGE]</code></h3>
2115
+ <p>
2116
+ Shows or replaces this sprite&#x27;s Scratch-compatible default think
2117
+ bubble. An empty message closes it.
2118
+ </p>
2119
+ <p>
2120
+ Block type: COMMAND. Opcode: <code>think</code>.
2121
+ <a href="#block-think">Permanent link</a>
2122
+ </p>
2123
+ <div class="block-reference-table">
2124
+ <table>
2125
+ <thead>
2126
+ <tr>
2127
+ <th>Argument</th>
2128
+ <th>Type</th>
2129
+ <th>Default value</th>
2130
+ <th>Menu choices</th>
2131
+ </tr>
2132
+ </thead>
2133
+ <tbody>
2134
+ <tr>
2135
+ <th scope="row"><code>MESSAGE</code></th>
2136
+ <td>STRING</td>
2137
+ <td><code>Hmm...</code></td>
2138
+ <td></td>
2139
+ </tr>
2140
+ </tbody>
2141
+ </table>
2142
+ </div>
2143
+ </article>
2144
+ <article id="block-showWithBubbleStyle" class="block-reference-entry">
2145
+ <h3><code>show [MESSAGE] with bubble style [STYLE]</code></h3>
2146
+ <p>
2147
+ Shows or replaces this sprite&#x27;s Bubble. The selected style determines
2148
+ the complete body and tail or trail shape.
2149
+ </p>
2150
+ <p>
2151
+ Block type: COMMAND. Opcode: <code>showWithBubbleStyle</code>.
2152
+ <a href="#block-showWithBubbleStyle">Permanent link</a>
2153
+ </p>
2154
+ <div class="block-reference-table">
2155
+ <table>
2156
+ <thead>
2157
+ <tr>
2158
+ <th>Argument</th>
2159
+ <th>Type</th>
2160
+ <th>Default value</th>
2161
+ <th>Menu choices</th>
2162
+ </tr>
2163
+ </thead>
2164
+ <tbody>
2165
+ <tr>
2166
+ <th scope="row"><code>MESSAGE</code></th>
2167
+ <td>STRING</td>
2168
+ <td><code>Hello!</code></td>
2169
+ <td></td>
2170
+ </tr>
2171
+ <tr>
2172
+ <th scope="row"><code>STYLE</code></th>
2173
+ <td>STRING</td>
2174
+ <td><code>say</code></td>
2175
+ <td></td>
2176
+ </tr>
2177
+ </tbody>
2178
+ </table>
2179
+ </div>
2180
+ </article>
2181
+ <article id="block-sayWithBubbleStyle" class="block-reference-entry">
2182
+ <h3><code>say [MESSAGE] with bubble style [STYLE]</code></h3>
2183
+ <p>
2184
+ Shows or replaces this sprite&#x27;s say bubble in talking animation mode.
2185
+ An empty message closes the basic profile.
2186
+ </p>
2187
+ <p>
2188
+ Block type: COMMAND. Opcode: <code>sayWithBubbleStyle</code>.
2189
+ <a href="#block-sayWithBubbleStyle">Permanent link</a>
2190
+ </p>
2191
+ <p>Compatibility block, hidden from the palette.</p>
2192
+ <div class="block-reference-table">
2193
+ <table>
2194
+ <thead>
2195
+ <tr>
2196
+ <th>Argument</th>
2197
+ <th>Type</th>
2198
+ <th>Default value</th>
2199
+ <th>Menu choices</th>
2200
+ </tr>
2201
+ </thead>
2202
+ <tbody>
2203
+ <tr>
2204
+ <th scope="row"><code>MESSAGE</code></th>
2205
+ <td>STRING</td>
2206
+ <td><code>Hello!</code></td>
2207
+ <td></td>
2208
+ </tr>
2209
+ <tr>
2210
+ <th scope="row"><code>STYLE</code></th>
2211
+ <td>STRING</td>
2212
+ <td><code>dialogue</code></td>
2213
+ <td></td>
2214
+ </tr>
2215
+ </tbody>
2216
+ </table>
2217
+ </div>
2218
+ </article>
2219
+ <article id="block-thinkWithBubbleStyle" class="block-reference-entry">
2220
+ <h3><code>think [MESSAGE] with bubble style [STYLE]</code></h3>
2221
+ <p>
2222
+ Shows or replaces this sprite&#x27;s think bubble in talking animation
2223
+ mode. An empty message closes the basic profile.
2224
+ </p>
2225
+ <p>
2226
+ Block type: COMMAND. Opcode: <code>thinkWithBubbleStyle</code>.
2227
+ <a href="#block-thinkWithBubbleStyle">Permanent link</a>
2228
+ </p>
2229
+ <p>Compatibility block, hidden from the palette.</p>
2230
+ <div class="block-reference-table">
2231
+ <table>
2232
+ <thead>
2233
+ <tr>
2234
+ <th>Argument</th>
2235
+ <th>Type</th>
2236
+ <th>Default value</th>
2237
+ <th>Menu choices</th>
2238
+ </tr>
2239
+ </thead>
2240
+ <tbody>
2241
+ <tr>
2242
+ <th scope="row"><code>MESSAGE</code></th>
2243
+ <td>STRING</td>
2244
+ <td><code>Hmm...</code></td>
2245
+ <td></td>
2246
+ </tr>
2247
+ <tr>
2248
+ <th scope="row"><code>STYLE</code></th>
2249
+ <td>STRING</td>
2250
+ <td><code>dialogue</code></td>
2251
+ <td></td>
2252
+ </tr>
2253
+ </tbody>
2254
+ </table>
2255
+ </div>
2256
+ </article>
2257
+ <article id="block-setBubbleAnimationMode" class="block-reference-entry">
2258
+ <p>
2259
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
2260
+ </p>
2261
+ <h3><code>set this bubble animation mode [MODE]</code></h3>
2262
+ <p>
2263
+ Changes this sprite&#x27;s bubble animation mode. Awaiting continue stops
2264
+ lip-sync animation and starts the configured continue frames.
2265
+ </p>
2266
+ <p>
2267
+ Block type: COMMAND. Opcode: <code>setBubbleAnimationMode</code>.
2268
+ <a href="#block-setBubbleAnimationMode">Permanent link</a>
2269
+ </p>
2270
+ <div class="block-reference-table">
2271
+ <table>
2272
+ <thead>
2273
+ <tr>
2274
+ <th>Argument</th>
2275
+ <th>Type</th>
2276
+ <th>Default value</th>
2277
+ <th>Menu choices</th>
2278
+ </tr>
2279
+ </thead>
2280
+ <tbody>
2281
+ <tr>
2282
+ <th scope="row"><code>MODE</code></th>
2283
+ <td>STRING</td>
2284
+ <td><code>awaiting-continue</code></td>
2285
+ <td>
2286
+ <ul>
2287
+ <li><code>talking</code></li>
2288
+ <li><code>awaiting-continue</code></li>
2289
+ <li><code>idle</code></li>
2290
+ </ul>
2291
+ </td>
2292
+ </tr>
2293
+ </tbody>
2294
+ </table>
2295
+ </div>
2296
+ </article>
2297
+ <article id="block-waitForBubbleContinue" class="block-reference-entry">
2298
+ <p>
2299
+ <a href="#fixed-input-editing">Fixed input editor / 固定入力の編集</a>
2300
+ </p>
2301
+ <h3>
2302
+ <code
2303
+ >wait with this bubble until condition [CONDITION] or timeout after
2304
+ [TIMEOUT] seconds</code
2305
+ >
2306
+ </h3>
2307
+ <p>
2308
+ Switches to awaiting-continue mode, evaluates a Runtime Expression
2309
+ condition using variables updated by Async Input, and waits until the
2310
+ condition is true or the timeout expires. Zero disables the timeout.
2311
+ </p>
2312
+ <p>
2313
+ Block type: COMMAND. Opcode: <code>waitForBubbleContinue</code>.
2314
+ <a href="#block-waitForBubbleContinue">Permanent link</a>
2315
+ </p>
2316
+ <div class="block-reference-table">
2317
+ <table>
2318
+ <thead>
2319
+ <tr>
2320
+ <th>Argument</th>
2321
+ <th>Type</th>
2322
+ <th>Default value</th>
2323
+ <th>Menu choices</th>
2324
+ </tr>
2325
+ </thead>
2326
+ <tbody>
2327
+ <tr>
2328
+ <th scope="row"><code>CONDITION</code></th>
2329
+ <td>STRING</td>
2330
+ <td><code>input == &quot;pressed&quot;</code></td>
2331
+ <td></td>
2332
+ </tr>
2333
+ <tr>
2334
+ <th scope="row"><code>TIMEOUT</code></th>
2335
+ <td>NUMBER</td>
2336
+ <td><code>10</code></td>
2337
+ <td></td>
2338
+ </tr>
2339
+ </tbody>
2340
+ </table>
2341
+ </div>
2342
+ </article>
2343
+ <article
2344
+ id="block-waitAndCloseBubbleWithPolicy"
2345
+ class="block-reference-entry"
2346
+ >
2347
+ <h3><code>wait and close this bubble using close policy [POLICY]</code></h3>
2348
+ <p>
2349
+ Snapshots the named close policy, waits for its trigger, then closes this
2350
+ sprite&#x27;s bubble and releases its resources.
2351
+ </p>
2352
+ <p>
2353
+ Block type: COMMAND. Opcode: <code>waitAndCloseBubbleWithPolicy</code>.
2354
+ <a href="#block-waitAndCloseBubbleWithPolicy">Permanent link</a>
2355
+ </p>
2356
+ <div class="block-reference-table">
2357
+ <table>
2358
+ <thead>
2359
+ <tr>
2360
+ <th>Argument</th>
2361
+ <th>Type</th>
2362
+ <th>Default value</th>
2363
+ <th>Menu choices</th>
2364
+ </tr>
2365
+ </thead>
2366
+ <tbody>
2367
+ <tr>
2368
+ <th scope="row"><code>POLICY</code></th>
2369
+ <td>STRING</td>
2370
+ <td><code>advance-or-timeout</code></td>
2371
+ <td></td>
2372
+ </tr>
2373
+ </tbody>
2374
+ </table>
2375
+ </div>
2376
+ </article>
2377
+ <article id="block-closeBubble" class="block-reference-entry">
2378
+ <h3><code>close this bubble</code></h3>
2379
+ <p>
2380
+ Closes this sprite&#x27;s bubble and releases its timers and rendering
2381
+ resources.
2382
+ </p>
2383
+ <p>
2384
+ Block type: COMMAND. Opcode: <code>closeBubble</code>.
2385
+ <a href="#block-closeBubble">Permanent link</a>
2386
+ </p>
2387
+ <p>This block has no arguments.</p>
2388
+ </article>
2389
+ <article id="block-getVersion" class="block-reference-entry">
2390
+ <h3><code>Bubble version</code></h3>
2391
+ <p>Returns the Bubble implementation version.</p>
2392
+ <p>
2393
+ Block type: REPORTER. Opcode: <code>getVersion</code>.
2394
+ <a href="#block-getVersion">Permanent link</a>
2395
+ </p>
2396
+ <p>This block has no arguments.</p>
2397
+ </article>
2398
+ <p>
2399
+ <a href="https://github.com/kubohiroya/turbowarp-bubble/blob/main/README.md"
2400
+ >Repository guide and examples</a
2401
+ >
2402
+ </p>
2403
+ </section>
2404
+ <!-- END COMPLETE BLOCK REFERENCE -->
2405
+ <section id="fixed-input-editing">
2406
+ <h2>固定入力の編集 / Fixed input editing</h2>
2407
+ <p>
2408
+ GUI起動時の
2409
+ <code>blockEditorDialogs=1&amp;blockEditorFixedInputs=1</code>
2410
+ が必要です(既定OFF)。標準literalだけを編集し、reporter・非対応fieldは評価せず保持します。旧GUIでは通常のブロック動作を維持します。
2411
+ </p>
2412
+ <p>
2413
+ Static enum values are selected explicitly. New numeric edits must be finite
2414
+ JSON number tokens; unfinished buffers cannot be saved. Unchanged aliases,
2415
+ spaces and existing raw values are retained. Runtime style names, assets and
2416
+ expressions are not evaluated or resolved by this editor.
2417
+ </p>
2418
+ <table>
2419
+ <thead>
2420
+ <tr>
2421
+ <th>Block / 固定アンカー</th>
2422
+ <th>Arguments / UI</th>
2423
+ </tr>
2424
+ </thead>
2425
+ <tbody>
2426
+ <tr>
2427
+ <th scope="row">
2428
+ <a href="#block-defineBubbleClosePolicy"
2429
+ ><code>defineBubbleClosePolicy</code></a
2430
+ >
2431
+ </th>
2432
+ <td><code>TRIGGER</code> (enum), <code>TIMEOUT</code> (number)</td>
2433
+ </tr>
2434
+ <tr>
2435
+ <th scope="row">
2436
+ <a href="#block-setPortraitLayout"><code>setPortraitLayout</code></a>
2437
+ </th>
2438
+ <td>
2439
+ <code>PLACEMENT</code> (enum), <code>X</code> (number),
2440
+ <code>Y</code> (number), <code>ZOOM</code> (number),
2441
+ <code>RADIUS</code> (number)
2442
+ </td>
2443
+ </tr>
2444
+ <tr>
2445
+ <th scope="row">
2446
+ <a href="#block-setBubbleDistance"><code>setBubbleDistance</code></a>
2447
+ </th>
2448
+ <td><code>DISTANCE</code> (number)</td>
2449
+ </tr>
2450
+ <tr>
2451
+ <th scope="row">
2452
+ <a href="#block-setBubbleVisualStyle"
2453
+ ><code>setBubbleVisualStyle</code></a
2454
+ >
2455
+ </th>
2456
+ <td><code>VISUAL_STYLE</code> (enum)</td>
2457
+ </tr>
2458
+ <tr>
2459
+ <th scope="row">
2460
+ <a href="#block-setBubbleTailLength"
2461
+ ><code>setBubbleTailLength</code></a
2462
+ >
2463
+ </th>
2464
+ <td><code>LENGTH</code> (number)</td>
2465
+ </tr>
2466
+ <tr>
2467
+ <th scope="row">
2468
+ <a href="#block-setBubbleOffset"><code>setBubbleOffset</code></a>
2469
+ </th>
2470
+ <td>
2471
+ <code>X</code> (number), <code>Y</code> (number),
2472
+ <code>SCALE</code> (number)
2473
+ </td>
2474
+ </tr>
2475
+ <tr>
2476
+ <th scope="row">
2477
+ <a href="#block-setBlinkFrames"><code>setBlinkFrames</code></a>
2478
+ </th>
2479
+ <td><code>SECONDS</code> (number)</td>
2480
+ </tr>
2481
+ <tr>
2482
+ <th scope="row">
2483
+ <a href="#block-setLipSyncFrames"><code>setLipSyncFrames</code></a>
2484
+ </th>
2485
+ <td><code>SECONDS</code> (number)</td>
2486
+ </tr>
2487
+ <tr>
2488
+ <th scope="row">
2489
+ <a href="#block-setContinueFrames"><code>setContinueFrames</code></a>
2490
+ </th>
2491
+ <td><code>SECONDS</code> (number)</td>
2492
+ </tr>
2493
+ <tr>
2494
+ <th scope="row">
2495
+ <a href="#block-setBubbleReveal"><code>setBubbleReveal</code></a>
2496
+ </th>
2497
+ <td>
2498
+ <code>UNIT</code> (enum), <code>SECONDS</code> (number),
2499
+ <code>LAYOUT</code> (enum)
2500
+ </td>
2501
+ </tr>
2502
+ <tr>
2503
+ <th scope="row">
2504
+ <a href="#block-setBubbleWordDelimiters"
2505
+ ><code>setBubbleWordDelimiters</code></a
2506
+ >
2507
+ </th>
2508
+ <td><code>SHOW</code> (enum)</td>
2509
+ </tr>
2510
+ <tr>
2511
+ <th scope="row">
2512
+ <a href="#block-finishBubbleReveal"
2513
+ ><code>finishBubbleReveal</code></a
2514
+ >
2515
+ </th>
2516
+ <td><code>UNIT</code> (enum), <code>TIMEOUT</code> (number)</td>
2517
+ </tr>
2518
+ <tr>
2519
+ <th scope="row">
2520
+ <a href="#block-setBubbleShowAnimation"
2521
+ ><code>setBubbleShowAnimation</code></a
2522
+ >
2523
+ </th>
2524
+ <td><code>MOTION</code> (enum), <code>SECONDS</code> (number)</td>
2525
+ </tr>
2526
+ <tr>
2527
+ <th scope="row">
2528
+ <a href="#block-setBubbleHideAnimation"
2529
+ ><code>setBubbleHideAnimation</code></a
2530
+ >
2531
+ </th>
2532
+ <td><code>MOTION</code> (enum), <code>SECONDS</code> (number)</td>
2533
+ </tr>
2534
+ <tr>
2535
+ <th scope="row">
2536
+ <a href="#block-animateBubble"><code>animateBubble</code></a>
2537
+ </th>
2538
+ <td><code>MOTION</code> (enum)</td>
2539
+ </tr>
2540
+ <tr>
2541
+ <th scope="row">
2542
+ <a href="#block-shakeBubble"><code>shakeBubble</code></a>
2543
+ </th>
2544
+ <td>
2545
+ <code>DIRECTION</code> (number), <code>COUNT</code> (number),
2546
+ <code>EASE</code> (enum)
2547
+ </td>
2548
+ </tr>
2549
+ <tr>
2550
+ <th scope="row">
2551
+ <a href="#block-explodeBubble"><code>explodeBubble</code></a>
2552
+ </th>
2553
+ <td>
2554
+ <code>SCALE</code> (number), <code>COUNT</code> (number),
2555
+ <code>EASE</code> (enum)
2556
+ </td>
2557
+ </tr>
2558
+ <tr>
2559
+ <th scope="row">
2560
+ <a href="#block-animateBubbleShape"
2561
+ ><code>animateBubbleShape</code></a
2562
+ >
2563
+ </th>
2564
+ <td>
2565
+ <code>VISUAL_STYLE</code> (enum), <code>SPEED</code> (number),
2566
+ <code>SECONDS</code> (number)
2567
+ </td>
2568
+ </tr>
2569
+ <tr>
2570
+ <th scope="row">
2571
+ <a href="#block-setBubbleAnimationMode"
2572
+ ><code>setBubbleAnimationMode</code></a
2573
+ >
2574
+ </th>
2575
+ <td><code>MODE</code> (enum)</td>
2576
+ </tr>
2577
+ <tr>
2578
+ <th scope="row">
2579
+ <a href="#block-waitForBubbleContinue"
2580
+ ><code>waitForBubbleContinue</code></a
2581
+ >
2582
+ </th>
2583
+ <td><code>TIMEOUT</code> (number)</td>
2584
+ </tr>
2585
+ </tbody>
2586
+ </table>
2587
+ <p>
2588
+ <code>defineBubbleClosePolicy</code> は
2589
+ TRIGGERがconditionならTIMEOUTを非表示にし、timeout系だけ正の有限値を検査します。CONDITIONは読取専用です。selector変更先がcondition系ならCONDITIONの非空literalを確認し、reporterは未評価としてselector変更を拒否します。selector未変更でcondition-or-timeoutならCONDITION
2590
+ reporterを保持しTIMEOUTだけ保存できます。
2591
+ </p>
2592
+ <p>
2593
+ TIMEOUT
2594
+ draft20/保存値10で非表示→再表示なら20を復元し、無効bufferも保持・再検査します。非表示のまま保存成功ならprojectは10を維持し、dialog終了時に20を破棄します。SHOWはbooleanではなく文字列false/trueです。frame秒&gt;0、reveal/motion/wait秒&gt;=0、countは正整数です。未編集の数値は他項目編集時に新規検査しません。
2595
+ </p>
2596
+ <p>
2597
+ 同じdialog内の保存失敗ではdraftを保持します。保存成功・取消・dispose・project/target/登録失効で未保存draftを破棄し、再openは現在のrawから開始します。変更しないraw・reporter・sb3形式に移行は不要です。数値の新入力はblank・hex・非有限値を拒否し、既存rawの開閉にこの新入力規則を遡及しません。
2598
+ </p>
2599
+ <p>
2600
+ Schemaの正本は <code>schemas/block-editor-fixed-inputs.schema.json</code> の
2601
+ <code>$defs/&lt;opcode&gt;/properties/&lt;argument&gt;</code>
2602
+ です。各bindingは正本fragmentを直接参照し、生成Schemaを別の正本として扱いません。local実装の検証を公開サイトのdeploy完了と同一視せず、公開後URL到達は配布工程で確認します。
2603
+ </p>
2604
+ </section>
2605
+
582
2606
  </body>
583
2607
  </html>