VCMV 説明

はじめに

VCMV(バーチャルコンソールマニュアルビューア)は、バーチャルコンソールゲームにマニュアルビューアの機能を提供する開発キットです。

バーチャルコンソールマニュアルビューアは、Opera製コンポーネントブラウザを使用して バーチャルコンソールゲーム用のユーザーマニュアルコンテンツを表示します。 コンテンツはhtmlとjavascriptを使用し、ガイドラインに従って作成します。 本パッケージには、ユーザーマニュアルのサンプルが入っています。

本SDKの目的は以下の二つです。

1. バーチャルコンソールゲームにマニュアルビューアの機能を提供する。
2. バーチャルコンソールエンジンの共通シェルを提供する。

マニュアルビューアへはホームボタンメニューを経由してアクセスします。 マニュアルビューアとホームボタンメニューは一部統合されました。 グラフィックとサウンドのリソースはマニュアルビューアと ホームボタンメニューで共有されます。 VCMVの最新版は、インターレース/ノンインターレースモード選択UIと 16:9スクウォッシュ/ストレッチ(縮める/引き伸ばす)選択UIに対応しています。

システムリソースの利用状況

マニュアルビューアは以下のリソースを使用しています。

・グラフィックス:

スタンダード GX ライブラリ (VI, GX はアプリで初期化してください)

・オーディオ:

AI, AX, MIX ライブラリ (アプリで初期化してください)

・MEM1:

現在、コンポーネントブラウザRSO用にMEM1のうち7.0MB必要です。 このメモリはビューアが使用されていない間は破棄できます。

・MEM2:

使用中はMEM2のうち約28MB必要です。以下が内訳になっています:
コンポーネントブラウザヒープ: デフォルト20MB。最小14MB。
メモリ常駐フォント: 2.6MB
レンダリングバッファとテクスチャバッファ: 3.2MB (608x456の場合)
ブラウザワークメモリ: 200KB
HBM リソース: 600KB
マニュアルコンテンツ: (アプリからアロケートされる - 最大約1.5MB)

上記のメモリすべて、ブラウザが使用中でないときは解放できます。 vcmvライブラリ自身が要求するスタティックな量だけはメモリに残る必要があります。

・メモリアロケーション詳細:

MEM1とMEM2用のメモリアロケータはアプリケーションが提供してください。 マニュアルビューアから使用される各バッファはどちらかに優先権がありますが、 優先する方のアロケーションが失敗すると、もう一方のメモリエリアからアロケートしようとします。 上記の内訳は各バッファの優先する方を示しています。 注:RSOだけは例外で、MEM1にしか置けません。

中韓版のマニュアルを表示する際の注意点

vcmvライブラリは本体の言語設定に応じて使用するフォントを変更します。 韓国版のマニュアルを作成する際は本体の言語設定を韓国語(ハングル)に設定してください。 中国版のマニュアルを作成する際は本体の言語設定を中国語(簡体字)に設定してください。 その他のリージョン用にマニュアルを作成する際は、韓国語・中国語以外に設定してください。

注意: 言語設定が正しく設定されていない場合、フォントの読み出しに失敗し、例外が発生してしまいますのでご注意ください。

マニュアルビューアのUI

ビューアはWiiリモコンまたはクラシックコントローラで操作可能です。 操作法は以下の表の通りです。

Wiiリモコン クラッシック
コントローラー
動作
DPD L トリガー カーソルの移動
A ボタン A ボタン リンク先へ移動
操作コントローラー指定 (複数コントローラー接続時)
十字ボタン上 十字ボタン上 上スクロール
十字ボタン下 十字ボタン下 下スクロール
+ ボタン + ボタン トップページに戻る
Home ボタン Home ボタン マニュアルビューアの終了

マニュアルビューア内では優先レンダリングモードを変更するために、以下のコマンドを使用可能です。 この優先は、全てのバーチャルコンソールゲームで共有されます。
コマンド 動作
コントローラ #1
ヌンチャク 'Z' + Wiiリモコン'A' + Wiiリモコン'1'
ノンインターレースモードに切り替えます。
(成功するとピングサウンドが鳴ります。)
現在のモードがインターレースかつ、現在のゲームがノンインターレースモードに対応している場合のみ有効。
コントローラ #1
ヌンチャク 'Z' + Wiiリモコン'A' + Wiiリモコン'2'
インターレースモードに切り替えます。
(成功するとピングサウンドが鳴ります。)
現在のモードがノンインターレースモードの場合のみ有効。
コントローラ #1
ヌンチャク 'Z' + Wiiリモコン'A' + Wiiリモコン'B'
16:9スクウォッシュフラグを切り替えます。
(成功するとピングサウンドが鳴り、直ちに画面幅を更新します。)
ユーザーがシステムメニューから16:9のテレビ画面設定を選択している場合のみ有効。

履歴

2008/11/17 初版。Readmeより転記。