The "Peko" Project


PVNS カスタマイズリファレンス

この文書では、ゲーム開発者向けに、"Peko" Visual Novel System のカスタマイズ方法について説明します。

カスタマイズの概要

PVNS では、データディレクトリの位置や読み込むフォント・プラグインなどのシステム設定の他、キャンバスのサイズや文章の描画色など外観に関する設定など、多くのプログラム構成情報をリソースとして、プログラムコードの外に出しています。

リソースを編集することで、PVNS をゲーム開発者の意向に添うようにカスタマイズすることができます。

カスタマイズ可能な項目の種類は次の通りです。

PVNS におけるリソースとは、ID によって識別される外部データであり、リソースファイル中に格納されているものを指します。

リソースの詳細については、後述の「リソースとは」を参照してください。

PVNS のリソースは項目の種類毎に用意されたリソースファイルに記述されます。以下にその対応を表として示します。

リソースファイル一覧
種別リソースファイル
ゲーム情報game-info.xml
システム設定system.xml
メニューのキャプション文字列menu.xml
ダイアログのキャプション・メッセージ文字列dialog.xml
キャンバスの外見canvas.xml
タイトル画面の設定title.xml

これらのリソースファイルは、PVNS runtime (peko.jar) と同じディレクトリに、各ファイルばらばらに配置するか、あるいは、config.dat という名前の ZIP ファイルに纏めて配置します。

なお、config.dat が PVNS runtime と同じディレクトリにある場合、PVNS は config.dat に格納されたリソースファイルを優先的に使用します。

また、これらリソースファイルは全て必須です。PVNS の起動時にどれか一つでも検出できないリソースファイルがあった場合、PVNS は起動できません。

ゲーム情報の設定

ゲーム情報として、ゲームのタイトルやアイコンなどを設定できます。ゲーム情報はメインウィンドウのタイトルバーや、バージョン情報ダイアログなどに使用されます。

リソース名game-info.title
データ型string
説明ゲームタイトルを設定します。設定した内容は、メインウィンドウのタイトルバーとバージョン情報ダイアログで表示されます。
リソース名game-info.version
データ型string
説明ゲームのバージョン番号を設定します。設定した内容はバージョン情報ダイアログで表示されます。
リソース名game-info.publisher
データ型string
説明ゲームの制作者名を設定します。設定した内容はバージョン情報ダイアログで表示されます。
リソース名game-info.copyright
データ型string
説明ゲームの Copyright noticeを設定します。設定した内容はバージョン情報ダイアログで表示されます。
リソース名game-info.additional-info
データ型list/string
説明ゲームに関する追加の情報 (制作者 URL やサポートメールアドレスなど) を設定します。設定した内容は、各項目 1 行ずつにバージョン情報ダイアログで表示されます。

システム設定のカスタマイズ

システム設定として、PVNS がゲームを実行するために必要な情報を設定します。必要な情報としては、言語情報、ディレクトリ設定、フォント設定などがあります。

リソース名peko.system.locale
データ型peko:locale
説明言語情報を設定します。設定した内容は、フォントやセーブ時刻に影響します。未設定の場合は、PVNS の起動に使用した Java VM の設定に従います。
リソース名peko.system.location.scenes
データ型string
説明データ種別が scene であるデータを格納するディレクトリ/アーカイブ名を設定します。ディレクトリ/アーカイブ名は、ゲームパッケージがインストールされたディレクトリからの相対パスで記述します。設定したディレクトリ/アーカイブは実際に存在している必要があります。なお、パス中に上位ディレクトリへの移動を表す「..」を含めることはできません
リソース名peko.system.location.images
データ型string
説明データ種別が image であるデータを格納するディレクトリ/アーカイブ名を設定します。設定内容や制約については、peko.system.location.scenes に準じます。
リソース名peko.system.location.sounds
データ型string
説明データ種別が sound であるデータを格納するディレクトリ/アーカイブ名を設定します。設定内容や制約については、peko.system.location.scenes に準じます。
リソース名peko.system.location.misc
データ型string
説明データ種別が misc であるデータを格納するディレクトリ/アーカイブ名を設定します。設定内容や制約については、peko.system.location.scenes に準じます。
リソース名peko.system.location.save
データ型string
説明セーブデータを格納するディレクトリ名を設定します。ディレクトリ名は、ゲームパッケージがインストールされたディレクトリからの相対パスで記述します。設定したディレクトリが実在しない場合、PVNS 起動時に生成されます。なお、パス中に上位ディレクトリへの移動を表す「..」を含めることはできません
リソース名peko.system.start-scene
データ型string
説明ゲーム開始時に、最初に処理するシーン名を設定します。
リソース名peko.system.fonts
データ型list/string
説明追加で読み込むフォントを指定します。利用可能なフォントファイルは True Type 形式で、misc ディレクトリに配置します。指定されたフォントが misc ディレクトリに存在しない場合、起動時に警告(WARN)ダイアログが表示されます。

メニューのキャプション文字列をカスタマイズすることができます。個々のメニュー項目には mnemonic が設定されており、キャプション文字列に含まれる mnemonic 文字には下線が引かれて描画されます。

リソース名peko.menu.system.menu-caption
データ型string
説明「システム」メニューのキャプション文字列を設定します。mnemonic は 'S' です。
リソース名peko.menu.system.save
データ型string
説明「システム」-「セーブ」メニューのキャプション文字列を設定します。mnemonic は 'S' です。
リソース名peko.menu.system.load
データ型string
説明「システム」-「ロード」メニューのキャプション文字列を設定します。mnemonic は 'O' です。
リソース名peko.menu.system.return-title
データ型string
説明「システム」-「タイトルに戻る」メニューのキャプション文字列を設定します。mnemonic は 'T' です。
リソース名peko.menu.system.read-again
データ型string
説明「システム」-「過去の文章」メニューのキャプション文字列を設定します。mnemonic は 'R' です。
リソース名peko.menu.system.exit
データ型string
説明「システム」-「終了」メニューのキャプション文字列を設定します。mnemonic は 'X' です。
「システム」メニュー設定例

「システム」メニュー

リソース名peko.menu.config.menu-caption
データ型string
説明「設定」メニューのキャプション文字列を設定します。mnemonic は 'C' です。
リソース名peko.menu.config.play-mode.menu-caption
データ型string
説明「設定」-「プレイモード」メニューのキャプション文字列を設定します。mnemonic は 'P' です。
リソース名peko.menu.config.play-mode.normal
データ型string
説明「設定」-「プレイモード」-「ノーマル」メニューのキャプション文字列を設定します。mnemonic は 'N' です。
リソース名peko.menu.config.play-mode.auto
データ型string
説明「設定」-「プレイモード」-「自動」メニューのキャプション文字列を設定します。mnemonic は 'A' です。
リソース名peko.menu.config.play-mode.skip
データ型string
説明「設定」-「プレイモード」-「次の選択肢までスキップ」メニューのキャプション文字列を設定します。mnemonic は 'S' です。
リソース名peko.menu.config.use-effect
データ型string
説明「設定」-「画像エフェクト OFF」メニューのキャプション文字列を設定します。mnemonic は 'E' です。
「設定」メニューのカスタマイズ

「設定」メニュー

リソース名peko.menu.help.menu-caption
データ型string
説明「ヘルプ」メニューのキャプション文字列を設定します。mnemonic は 'H' です。
リソース名peko.menu.help.help-contents
データ型string
説明「ヘルプ」-「ヘルプ」メニューのキャプション文字列を設定します。mnemonic は 'H' です。*現在のバージョンではヘルプ機能は未実装です。
リソース名peko.menu.help.version
データ型string
説明「ヘルプ」-「バージョン情報」メニューのキャプション文字列を設定します。mnemonic は 'A' です。
リソース名peko.menu.help.about-pvns
データ型string
説明「ヘルプ」-「PVNS について」メニューのキャプション文字列を設定します。mnemonic は 'P' です。
「ヘルプ」メニューのカスタマイズ

「ヘルプ」メニュー

ダイアログのカスタマイズ

under construction...

セーブデータ選択ダイアログ

リソース名peko.savedata-chooser.cell.size
データ型peko:dimension
説明セーブデータ情報を表示するセルのサイズを設定します。
リソース名peko.savedata-chooser.cell.title-format
データ型message-format
説明セーブデータ情報のタイトルをセルに描画する際に使用するフォーマットを設定します。置換文字列は、{0}:セーブデータ番号 {1}:タイトル に置換されます。
リソース名peko.savedata-chooser.cell.timestamp-format
データ型date-format
説明セーブデータ情報のタイムスタンプをセルに描画する際に使用するフォーマットを設定します。
リソース名peko.savedata-chooser.cell.no-data-title
データ型string
説明セーブデータが保存されていないセルに描画するタイトルを設定します。
リソース名peko.savedata-chooser.cell.background.selected
データ型peko:color
説明選択されているセルの背景色を設定します。
リソース名peko.savedata-chooser.cell.background.unselected
データ型peko:color
説明選択されていないセルの背景色を設定します。
リソース名peko.savedata-chooser.cell.title.color
データ型peko:color
説明セーブデータ情報のタイトルを描画する際に使用する前景色(文字色)を設定します。
リソース名peko.savedata-chooser.cell.title.font
データ型peko:font
説明セーブデータ情報のタイトルを描画する際に使用するフォントを設定します。
リソース名peko.savedata-chooser.cell.timestamp.color
データ型peko:color
説明セーブデータ情報のタイムスタンプを描画する際に使用する前景色(文字色)を設定します。
リソース名peko.savedata-chooser.cell.timestamp.font
データ型peko:font
説明セーブデータ情報のタイムスタンプを描画する際に使用するフォントを設定します。
リソース名peko.savedata-chooser.cell.comment.color
データ型peko:color
説明セーブデータ情報のコメントを描画する際に使用する前景色(文字色)を設定します。
リソース名peko.savedata-chooser.cell.comment.font
データ型peko:font
説明セーブデータ情報のコメントを描画する際に使用するフォントを設定します。
リソース名peko.savedata-chooser.cell.items-at-once
データ型integer
説明セーブデータ選択ダイアログを表示した際に、スクロールせずに一度に表示できるセル数を設定します。セーブデータ選択ダイアログでは、横スクロールバーは使用しませんので、この設定によりダイアログの高さが決定されます。
リソース名peko.savedata-chooser.cell.button.ok
データ型string
説明「OK」ボタンのラベル文字列を設定します。
リソース名peko.savedata-chooser.cell.button.cancel
データ型string
説明「キャンセル」ボタンのラベル文字列を設定します。
リソース名peko.savedata-chooser.caption.save
データ型string
説明セーブ処理のためにセーブデータ選択ダイアログを表示した際に使用する、キャプション文字列を設定します。
リソース名peko.savedata-chooser.caption.load
データ型string
説明ロード処理のためにセーブデータ選択ダイアログを表示した際に使用する、キャプション文字列を設定します。
リソース名peko.savedata-chooser.dialog.title.save
データ型string
説明セーブ処理のためにセーブデータ選択ダイアログを表示した際に使用する、ダイアログタイトルを設定します。
リソース名peko.savedata-chooser.dialog.title.load
データ型string
説明ロード処理のためにセーブデータ選択ダイアログを表示した際に使用する、ダイアログタイトルを設定します。
リソース名peko.savedata-chooser.dialog.confirm.title
データ型string
説明セーブデータの上書き確認ダイアログのダイアログタイトルを設定します。
リソース名peko.savedata-chooser.dialog.confirm.message
データ型string
説明セーブデータの上書き確認ダイアログのダイアログメッセージを設定します。
リソース名peko.savedata-chooser.dialog.notify.title
データ型string
説明ロード可能データなし情報ダイアログのダイアログタイトルを設定します。
リソース名peko.savedata-chooser.dialog.notify.message
データ型string
説明ロード可能データなし情報ダイアログのダイアログメッセージを設定します。

その他のダイアログ

under construction...

キャンバスのカスタマイズ

キャンバスの設定を行うリソースは、リソース ID が peko.canvas で始まり、大きく次の 4 項目に分類されます。

  1. 全体に共通のリソース
  2. TextCanvas のリソース
  3. StageCanvas のリソース
  4. SelectCanvas のリソース

キャンバス全体

リソース名peko.canvas.canvas-size
データ型peko:dimension
説明キャンバスのサイズを指定します。PVNS はキャンバスサイズを基に StageCanvas や Main Window のサイズを決定します。
リソース名peko.canvas.text-history
データ型integer
説明「過去の文章」表示機能で見直すことができる最大のページ数。

TextCanvas

リソース名peko.canvas.text.view-type
データ型string
説明ページ表示領域の表示タイプを設定します。リソースの値には、full または window のいずれかを指定して下さい。それ以外の値では、PVNS 実行時に警告としてメッセージが表示され、full が設定されます。

ページ表示領域の表示タイプの例

リソース名peko.canvas.text.size
データ型peko:dimension
説明ページ表示領域のサイズを設定します。ページ表示領域の表示タイプが full の場合、ここでの設定は無視されます。
リソース名peko.canvas.text.location
データ型peko:point
説明キャンバス内での、ページ表示領域の左上隅の座標を設定します。キャンバス左上隅が座標の原点(0,0)になります。ページ表示領域の表示タイプが full の場合、ここでの設定は無視されます。

ページ表示領域の各サイズ設定の例

リソース名peko.canvas.text.padding
データ型peko:insets
説明ページ表示領域の枠と文章が表示されている領域の間のパディング幅を設定します。通常では、マーカーを配置するために、右パディングに一文字分のスペースを追加して下さい。
リソース名peko.canvas.text.line-span
データ型float
説明行と行の間の間隔(上の行の下端から下の行の上端)を設定します。
リソース名peko.canvas.text.background.transparency
データ型float
説明ページ表示領域の背景の透過率(透明度)を 0.0 から 1.0 の間の実数で指定します。
リソース名peko.canvas.text.background.color
データ型peko:color
説明ページ表示領域の背景色を設定します。
リソース名peko.canvas.text.foreground.color
データ型peko:color
説明ページ表示領域の前景色(文字の色)を設定します。
リソース名peko.canvas.text.foreground.shadow
データ型float
説明文字の陰の部分の色を設定します。

ページ表示領域の各種色設定の例

リソース名peko.canvas.text.font
データ型peko:font
説明文章の表示に使用するフォントを設定します。

StageCanvas

リソース名peko.canvas.stage.default-effect.background
データ型string
説明背景切り替え時に使用するデフォルトのエフェクト名を設定します。PSML-Scene の background 要素で effect 属性が省略された場合に使用されます。
リソース名peko.canvas.stage.default-effect.actor
データ型string
説明人物切り替え時に使用するデフォルトのエフェクト名を設定します。PSML-Scene の enter, action, exit 要素で effect 属性が省略された場合に使用されます。
リソース名peko.canvas.stage.default-effect.slide
データ型string
説明スライド切り替え時に使用するデフォルトのエフェクト名を設定します。PSML-Scene の show-slide, hide-slide 要素で effect 属性が省略された場合に使用されます。

SelectCanvas

リソース名peko.canvas.select.align
データ型string
説明選択肢ボタンが配置される領域の水平方向の基準位置を設定します。リソースの値には、leftcenter、あるいは right のいずれかから指定して下さい。
leftの例centerの例rightの例
leftcenterright

水平方向の基準位置設定の例

リソース名peko.canvas.select.vertical-align
データ型string
説明選択肢ボタンが配置される領域の垂直方向の基準位置を設定します。リソースの値には、topmiddle、あるいは bottom のいずれかから指定して下さい。
topの例middleの例rightの例
topmiddlebottom

垂直方向の基準位置設定の例

リソース名peko.canvas.select.columns
データ型integer
説明選択肢ボタンを並べる際の列数を設定します。
1列の例2列の例
columns=1columns=2

列数設定の例

リソース名peko.canvas.select.span.column
データ型integer
説明選択肢ボタンの列間の間隔(左のボタンの右端から右のボタンの左端までの距離)を pixel 単位で設定します。
リソース名peko.canvas.select.span.row
データ型integer
説明選択肢ボタンの行間の間隔(上のボタンの下端から下のボタンの上端までの距離)を pixel 単位で設定します。
選択肢ボタン間隔設定の例

選択肢ボタン間隔設定の例

リソース名peko.canvas.select.span.bound
データ型integer
説明ボタンが配置される領域とキャンバスの枠との間の間隔を設定します。この設定は、ボタンを配置する基準位置によって適用される場所が変わります。
水平方向の基準位置ごとの適用場所
基準位置適用される場所
leftボタン配置領域の左端とキャンバスの左枠との間
center無視されます
rightボタン配置領域の右端とキャンバスの右枠との間
垂直方向の基準位置ごとの適用場所
基準位置適用される場所
topボタン配置領域の上端とキャンバスの上枠との間
middle無視されます
bottomボタン配置領域の下端とキャンバスの下枠との間
リソース名peko.canvas.select.button.width
データ型integer
説明選択肢ボタンの幅を設定します。
リソース名peko.canvas.select.button.background.transparency
データ型float
説明選択肢ボタンの背景の透過率(透明度)を 0.0 から 1.0 の間の実数で指定します。
リソース名peko.canvas.select.button.foreground.selected
データ型peko:color
説明選択されている選択肢ボタンの前景色(文字の色)を設定します。
リソース名peko.canvas.select.button.foreground.unselected
データ型peko:color
説明選択されていない選択肢ボタンの前景色(文字の色)を設定します。
リソース名peko.canvas.select.button.foreground.shadow
データ型peko:color
説明選択肢ボタンのラベルの陰の部分の色を設定します。

選択肢ボタンの各種色設定の例

リソース名peko.canvas.select.button.font
データ型peko:font
説明選択肢ボタンのラベルに使用するフォントを設定します。

タイトル画面のカスタマイズ

タイトル画面で設定できる内容は、SelectCanvas とほとんど同じです。実際、タイトル画面に表示されるタイトルメニューは、選択肢として描画されています。

タイトルメニューのスタイルを設定するリソースのリソース ID は、peko.canvas.select.*canvas.selecttitle.style に置き換えたもの(peko.title.style.*) になります。

ここでは、タイトル画面固有のリソースについて説明します。タイトル画面固有のリソースとしては、タイトルメニューのラベルなどがあります。

リソース名peko.title.bgm
データ型string
説明タイトル画面の BGM として再生する音楽クリップ名を設定します。
リソース名peko.title.image
データ型string
説明タイトル画面背景として描画する画像名を設定します。
リソース名peko.title.caption.start
データ型string
説明「最初から始める」タイトルメニューボタンのラベルを設定します。
リソース名peko.title.caption.resume
データ型string
説明「続きから始める」タイトルメニューボタンのラベルを設定します。
リソース名peko.title.caption.exit
データ型string
説明「終了」タイトルメニューボタンのラベルを設定します。

シーン固有のカスタマイズ

PVNS の外観や動作は、シーン毎に設定されたのプロパティ情報によっても変更されます。シーン・プロパティの設定方法は、「PSML 1.0 Scene ショートリファレンス」の property 要素の解説を参照して下さい。

以下にシーン毎に設定可能なプロパティの概要を示します。

プロパティ名canvas.text.view-type
データ型string
説明ページ表示領域の表示タイプを設定します。設定できる値の詳細は、peko.canvas.text.view-type の項目を参照して下さい。
プロパティ名canvas.text.size
データ型peko:dimension
説明ページ表示領域のサイズを設定します。設定できる値の詳細は、peko.canvas.text.size の項目を参照して下さい。
プロパティ名canvas.text.location
データ型peko:point
説明キャンバス内での、ページ表示領域の左上隅の座標を設定します。設定できる値の詳細は、peko.canvas.text.location の項目を参照して下さい。
プロパティ名canvas.text.padding
データ型peko:insets
説明ページ表示領域の枠と文章が表示されている領域の間のパディング幅を設定します。設定できる値の詳細は、peko.canvas.text.padding の項目を参照して下さい。
プロパティ名canvas.text.line-span
データ型float
説明行と行の間の間隔(上の行の下端から下の行の上端)を設定します。設定できる値の詳細は、peko.canvas.text.line-span の項目を参照して下さい。
プロパティ名canvas.text.background.transparency
データ型float
説明ページ表示領域の背景の透過率(透明度)を設定します。設定できる値の詳細は、peko.canvas.text.background.transparency の項目を参照して下さい。
プロパティ名canvas.text.background.color
データ型peko:color
説明ページ表示領域の背景色を設定します。設定できる値の詳細は、peko.canvas.text.background.color の項目を参照して下さい。
プロパティ名canvas.text.foreground.color
データ型peko:color
説明ページ表示領域の前景色(文字の色)を設定します。設定できる値の詳細は、peko.canvas.text.foreground.color の項目を参照して下さい。
プロパティ名canvas.text.foreground.shadow
データ型float
説明文字の陰の部分の色を設定します。設定できる値の詳細は、peko.canvas.text.foreground.shadow の項目を参照して下さい。
プロパティ名canvas.text.font.family
データ型string
説明文章の表示に使用するフォントのフォントファミリ名を設定します。このプロパティで設定されたフォントファミリ名で、リソースで指定されたフォントの設定を上書きします。フォントのファミリ名以外の項目(size, style, weight)はリソースの設定が使用されます。使用できる値については、peko:font データ型の説明を参照してください。
プロパティ名canvas.text.font.size
データ型float
説明文章の表示に使用するフォントのフォントサイズを設定します。このプロパティで設定されたフォントサイズで、リソースで指定されたフォントの設定を上書きします。フォントのサイズ以外の項目(family, style, weight)はリソースの設定が使用されます。使用できる値については、peko:font データ型の説明を参照してください。
プロパティ名canvas.text.font.style
データ型string
説明文章の表示に使用するフォントのフォントスタイルを設定します。このプロパティで設定されたフォントスタイルで、リソースで指定されたフォントの設定を上書きします。フォントのスタイル以外の項目(family, size, weight)はリソースの設定が使用されます。使用できる値については、peko:font データ型の説明を参照してください。
プロパティ名canvas.text.font.weight
データ型string
説明文章の表示に使用するフォントのウェイトを設定します。このプロパティで設定されたフォントウェイトで、リソースで指定されたフォントの設定を上書きします。フォントのウェイト以外の項目(family, size, style)はリソースの設定が使用されます。使用できる値については、peko:font データ型の説明を参照してください。

リソースとは

リソースとは、PVNS の設定情報や、アイコン、メニュー文字列などのデータです。PVNS ではリソースを特定の記述方式に従って XML ファイル中に記述します。このリソースを記述したファイルのことを、リソースファイルと呼びます

この章では、リソースファイルの記述方式について説明します。

リソース ID

リソースは ID によって識別されます。ID には階層構造があり、以下に示す形式で定義されます。

(親カテゴリ名).(子カテゴリ名).~(略)~.(リソース名)

リソース ID の構造

カテゴリとカテゴリ(またはリソース名)の間は「.(半角ピリオド: \u002E)で区切ります。

例えば、シナリオ固有の設定として、キャンバスの、テキストキャンバスに関する設定で、テキストキャンバスの表示タイプを設定するリソースのリソース ID は peko.canvas.text.view-type となります。

XML ファイルへの記述

リソースファイルでは、リソースは、XML namespaces URI http://tsukuba-bunko.org/ns/resource で定義される resources 要素の内容として記述されます。resources タグには、リソースを表すタグと明確に区別するためにXML namespace prefix を使用することを推奨します。

リソースファイルの例を以下に示します。

<?xml version="1.0" encoding="Shift_JIS"?>
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <scenario>
    <title>テスト!</title>
    <producer>つくば文庫</producer>
          :
    (その他のリソース)
          :
  </scenario>
</res:resource>

リソースファイルの例(1)

リソースファイルにリソースを記述する場合、リソース ID を構成するカテゴリ名(またはリソース名)が、そのまま XML のタグ名になります。

例えば、peko.canvas.text.view-type の場合、次のように記述されます。

<peko>
  <canvas>
    <text>
      <view-type>window</view-type>
    </text>
  </canvas>
</peko>

リソースファイルの例(2)

親カテゴリが同一であるリソースは、XML 上でも親カテゴリに対応する要素を共有することが出来ます。

例えば、scenario.canvas.text.view-typescenario.canvas.canvas-size は、scenario.canvas. までを共有していますので、次のように記述することが出来ます。

<scenario>
  <canvas>
    <canvas-size>640,480</canvas-size>
    <text>
      <view-type>window</view-type>
    </tet>
  </canvas>
</scenario>

リソースファイルの例(3)

データ形式

リソースの値は単なる文字列データではなく、固有のデータの型(種別)を持っています。この章では、データ型毎の記述方式について説明します。

型名boolean
解説論理値(真/偽)を表すデータ型です。値が trueyeson の場合「真」に、それ以外の場合「偽」になります。大文字小文字は区別しません。
型名integer
解説32bit の整数値を表すデータ型です。指定可能な範囲は -21474836482147483647 です。途中に桁を示すカンマやピリオドを入れることは出来ません(エラーになります)。詳しくは The Java Language Specification[External Link]3.10.1 Integer Literals[External Link] を参照してください。
型名float
解説32bit の浮動小数値を表すデータ型です。詳しくは The Java Language Specification[External Link]3.10.2 Floating-Point Literals[External Link] を参照してください。
型名string
解説文字列を表すデータ型です。文字列を構成する文字としては、Unicode で定義されている文字であれば使用することが可能です。ただし、XML の区切り文字として指定されている文字については文字参照を使用することでエスケープする必要があります。
型名message-format
解説文字列のテンプレートを表すデータ型です。置換したい箇所に「{n}」という形式のトークンを埋め込むことでテンプレートを構築できます。詳しくは、Java API Specification[External Link]MessagFormat[External Link] を参照してください。
型名date-format
解説日時の表記法のテンプレートを表すデータ型です。詳しくは、Java API Specification[External Link]SimpleDateFormat[External Link] を参照してください。
型名list/string
解説文字列のリストを表すデータ型です。リストの各要素は、http://tsukuba-bunko.org/ns/resource 名前空間に定義された item 要素の値として記述します。以下に、list/string 型リソースの記述例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <list>
      <res:item>string1</res:item>
      <res:item>string2</res:item>
      <res:item>string3</res:item>
    </list>
  </sample>
</res:resource>

list/string データ型リソースの記述例

型名peko:dimension
解説矩形のサイズを表すデータ型です。width(幅)と height(高さ)から構成され、それぞれの値をカンマで区切った一つの文字列として記述します。カンマや width、height の前後に空白(\u0020:半角スペース)が任意の数含まれてもかまいません。width と height は、それぞれ 0 以上の 32bit 整数値です。以下に、peko:dimesion 型リソースの記述例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <dimension>640, 480</dimension>
  </sample>
</res:resource>

peko:dimension の例

型名peko:point
解説2 次元の座標を表すデータ型です。x 座標値と y 座標値から構成され、それぞれの値をカンマで区切った一つの文字列として記述します。カンマや x 座標値、y 座標値 の前後に空白(U+0020:半角スペース)が任意の数含まれてもかまいません。x 座標値 と y座標値 は、それぞれ 0 以上の 32bit 整数値です。例として、以下に peko:point 型リソースの記述例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <point>0, 100</point>
  </sample>
</res:resource>

peko:point の例

型名peko:insets
解説ある矩形の境界線と、その矩形を囲む矩形の境界線との間の距離を表すデータ型です。矩形のパディング領域を指定するのに使用されます。top、right、bottom、left の4つの値で構成され、それぞれの値をカンマで区切った一つの文字列として記述します。カンマや top、right、bottom、left の前後に空白(U+0020:半角スペース)が任意の数含まれてもかまいません。top、right、bottom、left は、それぞれ 0 以上の 32bit 整数値です。以下に、peko:insets 型リソースの記述例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <insets1>0, 1, 2, 3</insets1>
    <insets2>0, 1, 2</insets2>
    <insets3>0, 1</insets3>
    <insets4>0</insets4>
  </sample>
</res:resource>

peko:insets の例

peko:insets型のリソース値には、省略記法が使用できます。以下の例では、次のように解釈されます。
peko:insets の記法と解析結果の例
リソース値解析結果
0,1,2,3top=0, right=1, bottom=2, left=3
0,1,2top=0, right=1, bottom=2, left=1
0,1top=0, right=1, bottom=0, left=1
0top=0, right=0, bottom=0, left=0
型名peko:color
解説色を表すデータ型です。色の記述には、色名または RGB 指定の2種類の方法があります。以下に色指定の例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <color1>red</color1>
    <color2>#FFBBAA</color2>
  </sample>
</res:resource>

peko:color の例

peko:color型リソースの値として使用可能な色名は次の 13 種類です。
色名一覧
blackbluecyandarkGraygray
greenlightGraymagentaorangepink
redwhiteyellow
RGB 指定では、「#」(\u0023) に続けて、R値、B値、G値を 2 桁の 16 進数で記述します。RGB の各値は 8 bit の符号なし整数で、0 ~ 255 の範囲になります。例えば、R=8 G=255 B=127 の場合、「#08FF7F」と記述します。
型名peko:font
解説フォントを表すデータ型です。フォントは、family (フォントファミリ名)、size (サイズ)、style (スタイル)、weight (ウェイト) から構成されます。family, size, style, weight の各項目は XML 形式の場合、子要素の値として記述します。以下に、peko:font型リソースの記述例を示します。
<res:resource xmlns:res="http://tsukuba-bunko.org/ns/resource">
  <sample>
    <font>
      <family>SansSerif</family>
      <size>25</size>
      <style>italic</style>
      <weight>bold</style>
    </font>
  </sample>
</res:resource>

peko:font の例

family, size, style, weight の各項目は省略することができます。省略は任意の項目で行うことができ、4 項目のうち 2 項目を省略したり、あるいは全部省略したりすることもできます。以下に、省略した場合に適用される各項目のデフォルト値を示します。
フォント設定のデフォルト値
項目名デフォルト値
familystringSerif
sizefloat20.0
styleitalic or normalnormal
wightbold or normalnormal
style には italic または normal のいずれかを、weight には bold または normal のいずれかを指定します。どちらの項目でも、大文字小文字は区別され、前述の値以外が指定された場合はデフォルト値を使用します(エラーにはなりません)。family に使用できないフォントファミリ名を指定した場合、または、size に不正な値を記述した場合、PVNS の初期化時に警告が表示されます。