Home - SpriteStudio/SSPlayerForCCH GitHub Wiki

==============================================================================

SpriteStudio Player For Cocos2d-x/CoronaSDK/HTML5 v1.0.7

Copyright © CRI Middleware Co., Ltd.

==============================================================================

概要

本ソフトウェアは SpriteStudioから出力された ssax ファイルを Cocos2d-x / CoronaSDK / HTML5 上で利用するためのコンバータと、コンバータにより出力したデータを再生するためのプレイヤープログラムのパッケージです。

ご注意

  • 今後ウェブテクノロジによる本ソフトウェアのアップデートは予定していません。
  • コンバータ及びプレイヤーのソースは自由に改変し、ご利用いただいて構いません。
  • ご利用前にライセンスを確認してください。
  • コンバータを改修する場合は、コンバータのビルド方法を参考にしてください。
  • 入力に指定できる SSAX ファイルのバージョンは ver.4 未満のものには対応していません。

使用できるアトリビュートはSpriteStudio4と同等になります。 インスタンスパーツ、エフェクトパーツの出力には対応しておりませんのでご注意ください。

OPTPiX SpriteStudio 5 対応プレイヤーについて

OPTPiX SpriteStudio 5 の機能に対応したプレイヤーライブラリはホームページ内のOPTPiX ヘルプセンターに掲載されておりますSS5Player for ~となります。
こちらは新機能の対応等、今後も継続して更新していきますので、特別な理由がない場合は新しいプレイヤーを利用してください。

OPTPiX SpriteStudio 5 からの利用手順

  1. OPTPiX SpriteStudio 5 の「プロジェクトの設定」→「互換性」→「再生対象のプラットフォーム」にてご利用のプレイヤー(SSP for Cocos2d-x/Corona SDK/HTML5 のいずれか)を選択し、プレイヤーが対応していない機能を抑制します。
  2. 同様に「プロジェクトの設定」→「エクスポート」→「アニメーションデータのフォーマット」を「SSAX」に設定しOKボタンを押します。
  3. メニューから「エクスポート」を選択します。
  4. 再生させたいアニメーションを選択し、出力先フォルダを指定してOKボタンを押します。
  5. 出力された .ssax ファイルを変換します。
    詳細はコンバータの使い方をご覧ください。
    1.で既に SSAX 以外を指定して利用されていた方はこちらもご覧ください。
  6. プレイヤー側で変換したデータを指定し再生します。
    詳細は下記のうち該当するプレイヤーの説明をご覧ください。

フォルダ構成

Converter/
  bin/
    コンバータの実行ファイルが mac win それぞれのサブフォルダに格納されています。

Player/
 コンバータが出力したアニメーションデータをユーザープログラム側で再生するためのソース・ヘッダファイル群です。

Samples/
 サンプルデータとユーザープログラムへの組み込み例です。

サンプルデータについて

Samples フォルダにプレイヤー別のデータが入っています。

Cocos2d-x/
  Cocos2d-x プレイヤー用の再生サンプルです。

  c/    C言語形式で出力したデータのロードと再生を行います。
  ssba/ バイナリ形式で出力したデータのロードと再生を行います。

CoronaSDK/
  CoronaSDK プレイヤー用の再生サンプルです。

HTML5/
  HTML5 プレイヤー用の再生サンプルです。

EditableData/
  各プレイヤーのサンプルで利用しているアニメーションデータの変換元データです。

  ss5_projects/
    OPTPiX SpriteStudio 5 のプロジェクトファイルです。
  ssax/
    ss5_projects 内のプロジェクトからエクスポートしたSSAXファイルです。
    このフォルダ内のSSAXファイルを各コンバータで変換し、利用しています。

ご注意

サンプルデータはすべて v1.0.6 のコンバータで変換したものを利用しています。
このため、v1.0.6 以外のバージョンのプレイヤーでサンプルデータを再生する場合は、
該当のバージョンのコンバータで元データを再度変換する必要があります。
元データは EditableData フォルダ内にあります。

Pull Request について

Pull Request は大歓迎です!
リクエスト送信前にIssue化しておく必要はありません。
変更内容はコミット時のコメントに記入していただければ十分です。

お問い合わせ

まずこちらのリンクからIssuesページを開き過去に投稿されたFAQをご確認ください。

Issuesページの質問だけ表示する場合はこちら
Issuesページの不具合だけ表示する場合はこちら
Issuesページの要望だけ表示する場合はこちら
同じ内容の質問があった場合、何か追加情報がある場合はコメントに書いて下さい。

質問、不具合、要望を投稿する方法

  • 投稿前に必ずお読みください

    • (重要)投稿した内容について
      投稿した内容は全て一般に公開されますので個人情報や機密情報を記載しないようにご注意ください。
    • 質問をIssueへの書き込むにはGitHubのアカウントが必要です。
      アカウントをお持ちでない場合、こちらのGitHubチュートリアルを参考にアカウントを作成してください。
    • 別のプレイヤー、別のツールの質問はそれぞれのページへ投稿してください。
  • 投稿する
    Title欄に先頭にバージョン番号をvX.X.Xとつけて概要を記入し、Leave a comment に詳細を記入します。
    [Submit new issue] ボタンを押して完了です。後ほど担当者が確認しコメントいたします。

    • こちらのリンクからIssuesページを開き緑の[New Issue]ボタンを押すと投稿フォームが開きます。
      New Issueボタン
  • 再現データの添付が必要な場合

    • ウェブテクノロジの専用メールアドレス [email protected] に添付して送付してください。
  • クリックするとメーラーが起動します。

  • ※送信する前に宛先が上記アドレスと相違ないかご確認ください。

  • ※重要なデータを含んでいる場合は、.zip を暗号化し、パスワードは別途お知らせください。

謝辞

  • CCSpriteBatchNode 対応のコードはL.T.SOFTWARE様よりご提供いただきました。

==============================================================================

株式会社CRI・ミドルウェア
https://www.cri-mw.co.jp/
Copyright © CRI Middleware Co., Ltd.

==============================================================================

  • SpriteStudio, Web Technologyは、株式会社ウェブテクノロジの登録商標です。
  • その他の商品名は各社の登録商標または商標です。