The Extension for Clickteam Fusion 2.5

ASTER とは

Clickteam Fusion 2.5 (以下 CF25) の Windows PC 専用拡張機能。

開発用プログラム言語 C++20 と標準ライブラリ (C++ STL) を利用して「正規表現 ( REGEX )」、テキストデータフォーマット「JSON」に対応。CF25 上で高度な文字列処理およびデータ処理が利用可能になります。

正規表現 (REGEX) とは

Regular Expression を略して REGEX (日本語訳：正規表現) と呼びます。文字列を意味ではなく記号パターンで分類し、パターンに一致する部分文字列もしくは文字列全体のマッチングを検索する機能。キャプチャグループという単位で一致した検索結果一覧を得たり、マッチした文字列を一括置換する Replace など高度な文字列検索・編集機能を実現します。

flowchart LR
  A[Source String] --> B{REGEX}
  C[Keyword] --> B{REGEX}
  B -->D[Search]
  D -->E[Match ??] 
  E --> G[if Condition]
  E --> H[Replace]
  G --> |true| I[CF25]
  G --> |false| I[CF25]
  H --> K[Replaced String]
  K --> I[CF25]

REGEX working Flowchart

JSON とは

JavaScript Object Notation を略して JSON 。元来 JavaScript で利用されるデータフォーマット形式でしたが、可読性の良さから普及が進みデータ解析では汎用的な存在になりました。文字エンコードは BOM 無し UTF-8 での保存が仕様化、利用可能なデータ型は文字列、数値、ブーリアン、Null、データ構造型は配列、オブジェクトをサポート。仕様が単純なので初学者でも簡単に書けます。

  {
  "string":"the extension for Clickteam Fusion 2.5, dedicated on windows PC",
  "string Array":["2024","04","15"],
  "number Array":[1,2,3,4,5],
  "object":{
    "string":"JSON",
    "Boolean array":[true, false],
    "mixed array":["string", 1.23, [true, false]]
  }
}
  
flowchart LR
    A[(JSON DATA)] --> |import| B{ASTER}
    A[(JSON DATA)] --- |export| B{ASTER}
    B{ASTER} <-.-> C(CF25)

JSON データと ASTER の役割

その他機能

特徴

  1. 複数パラメータを文字列として一括送信します。正規表現を使ったフォーマットチェック付き。
  2. ASTER 内部のイベント発生を即時実行条件として検出できる Event Detection 機能。
  3. JSON データをグローバル化して利用できる Data Sharing Option 機能。

利用許諾

BSD-2-Clause (2 条項 BSD License) のフリーウェアとして公開、商用利用可能。

動作要件

  • Windows OS 11
  • Clickteam Fusion 2.5 for Windows (Not require DLC)
  • HWA + DX9 + DX9 Shaders (for Object Motion Control)

How to Install

配布用バイナリ (エクステンション) は Release と Run_Only の二種類が含まれています。

  aster/
└── public/
    ├── toinstall/
    │   ├── Release/
    │   │   └── aster.mfx <--- for Clickteam Fusion's Frame Editor
    │   └── Run_Only/
    │       └── aster.mfx <--- ビルド用バイナリ
    ├── LICENCE_ASTER.txt 
    └── README.txt

エクステンションを各フォルダに手動でコピーしてください。

筆者環境の場合

“C:\Program Files (x86)\Clickteam Fusion Developer 2.5\Extensions\Unicode” » Release

“C:\Program Files (x86)\Clickteam Fusion Developer 2.5\Data\Runtime\Unicode” » Run_Only

以下フォルダにエクステンションをコピーします。