Skip to content

コンバータの使い方

SpriteStudio edited this page Jun 27, 2023 · 32 revisions

Ss6Converter

お知らせ

  • 2021/04/07 出力するデータサイズを大幅に削減した新しいコンバータを公開しました。Ss6ConverterVer2 こちらもご確認下さい。
  • 2019/02/25 C言語のソースファイル形式で出力する機能は近い将来削除される予定です。利用場面が限定的であり現在のところメンテナンスコストに比してサポートを継続する価値が無いと考えられるからです。今後も最新のSDKと共に継続してご利用になりたいユーザー様はこちらからご相談ください。

概要

Ss6Converter は OPTPiX SpriteStudio 6 で製作したアニメーションデータをランタイム用の形式(ssbp、json、ssfb)に変換するコンバータです。
このコンバータが出力するデータは汎用目的であり、特定のプレイヤー専用のデータを出力するものではありません。
ソースファイルを公開していますので自由にカスタマイズすることが可能です。

取得方法

releases から各プラットフォームの Ss6Converter アーカイブをダウンロードしてください。

最新版は こちらに になります。

  • 動作を確認しているOSのバージョン
  • Windows版 :10

使用手順

GUIで行う場合

2019-09-26_15h45_48

  1. Ss6ConveterGUIを実行します。
  2. コンバートするsspjファイルをドラック&ドロップして登録します。
  3. 必要なファイル形式を選択します。(使用するプレイヤープログラムが対応する形式を選んでください)
  4. Convet Start ボタンを押してコンバートを開始します。
  5. Statusが「Convert Success!」と表示されると、sspj フォルダに選択した形式の拡張子(.ssbp/.json/.ssfbなど)が付いた同名のファイルが作成されます。

コマンドラインで行う場合

コマンドプロンプトを起動し以下の様に入力し実行します。

Ss6Converter 変換対象のsspjファイルの**フルパス** [オプション]...

オプション

  • -o 出力フォルダのパス
    • 省略した場合、sspj ファイルと同じフォルダに出力されます。
  • -f 出力するファイル形式の指定
    • 形式には ssbp/json/ssfb のいずれかを指定します。※2019/09/26 時点
    • 使用するプレイヤープログラムが対応する形式を選択してください。

実行例

Ss6Converter C:\ss_anime\test.sspj -o D:\output_path\ -f ssfb

C:\ss_anime\test.sspj ファイル及び、このsspjファイルに登録された ssae, ssce, ssee ファイルを1つのssfbファイルに変換し、D:\output_path\ フォルダに保存します。

変換に成功すると出力フォルダに選択した形式の拡張子(.ssbp/.json/.ssfbなど)が付いた同名のファイルが作成されます。

出力ファイルについて

出力ファイルには、test.sspj に登録された全ての *.ssae *.ssce *.ssee ファイルが変換され含まれています。
参照イメージ(画像ファイル)は含まれませんのでプレイヤー側で利用する際に適切な場所へ配置するようにしてください。

ssbpファイルにはフォーマットバージョンが存在しており、アップデートによって変更が生じると使用中のプレイヤーで再生できなくなる可能性があります。
下記の表を参考に、プレイヤーが対応しているSpriteStudioのバージョンに該当するSDKを取得し、ここに含まれるコンバータを利用するようにしてください。

ssbpのフォーマットバージョン SS6 SDK のバージョン SpriteStudio 備考
11 1.6.x 6.2.0
10 1.5.x 6.2.0
9 1.4.x 6.1.3
8 1.3.x 6.1
7 1.2.x 6.0
6 1.1.x 6.0
5 1.0.x 6.0 ※メッシュデータには対応していません。
  • ssbpファイルのバージョンの違いによってアニメが再生できない場合の対処方法
    • プレイヤーの最新バージョンを取得し差し替え、または、差分をマージする。全アニメデータを再コンバートする必要がございます。
    • 動作確認が取れているプレイヤーとコンバータの組み合わせて使用し、アップデートする必要のある部分のみプレイヤーをマージする。
  • ファイル名に全角文字を使用しないでください。
  • セル名、パーツ名、ラベル名に全角文字を使用しないでください。
  • 16色PNGには対応していません。圧縮ありで保存した場合に16色PNGに変換される場合があります。 コンバートができない場合は圧縮なしで保存して試してみてください。
  • セルマップには必ず1つのセルリストを登録してください。 セルリストがない場合プレイヤーがssbpファイルの解析に失敗します。

コンバータのビルド方法