Ownway.Info(プレゼンテーションの書き方)

プレゼンテーションの書き方

本プログラムは、プレゼンテーションをXMLによって記述する。同じXMLによって記述されたファイルでも、役割によって使うタグが異なることに注意する。本プログラムは役割によって４種類のXMLファイルを読み分ける。また、必ず読み込まれる特殊なファイルとしてconfig/config.xmlが存在する。以下にファイルの種類とその役割を示す。

ファイルの種類	役割
config/config.xml	全てのプレゼンテーションに共通の設定を記述する。
プレゼンテーションファイル（*.prt）	プレゼンテーション全体に関する設定を記述する。
スタイルファイル（*.xsl）	プレゼンテーションのスタイルを記述する。
リソースファイル（*.xml）	プレゼンテーション中で使用するフォントや材質や画像などを記述する。
コンテンツファイル（*.xml）	プレゼンテーションの内容を記述する。

このページでは、各ファイルの書き方について説明する。

1: config/config.xml

2: プレゼンテーションファイル(*.prt)

このファイルは、全てのプレゼンテーションに共通の設定を記述するファイルである。一つは起動時のデフォルトのウィンドウサイズと、もう一つは全てのプレゼンテーションに共通するスタイルファイルとリソースファイルを指定することである。以下に例を示す。

<?xml version="1.0" encoding="Shift_JIS"?>

<presentation>
	<!-- ウィンドウサイズ -->
	<width>800</width>
	<height>600</height>
	<fullscreen>false</fullscreen>

	<!-- 共通スタイルシート -->
	<stylesheet>stylesheet1.xsl</stylesheet>
	<stylesheet>stylesheet2.xsl</stylesheet>

	<!-- 共通リソース -->
	<resource>resource1.xml</resource>
	<resource>resource2.xml</resource>
</presentation>

ウィンドウサイズの指定には、width・height・fullscreenの３つのタグを使用する。以上に示した例では横800ピクセル・縦600ピクセルの通常ウィンドウにプレゼンテーションを表示する。 fullscreenにtrueを指定すると全画面表示モードでプレゼンテーションを表示する。

スタイルファイルとリソースファイルの指定には、それぞれstylesheetタグとresourceタグを使用する。スタイルファイルとリソースファイルは、ともに任意数のファイルを指定できる。指定したファイル名は、configディレクトリからの相対パスとして解釈される。従って、以上に示した例ではスタイルファイルとしてconfig/stylesheet1.xsl・config/stylesheet2.xslを、リソースファイルとしてconfig/resource1.xml・config/resource2.xmlを読み込むようプレゼンテーションプログラムに指定している。

2: プレゼンテーションファイル(*.prt)

■ プレゼンテーションファイル(*.prt)

このファイルは、一つのプレゼンテーション全体に関する設定を記述するファイルである。このファイルの内容はconfig/config.xmlとほとんど変わらない。 config/config.xmlとの違いは、プレゼンテーションの内容となるファイルを指定するcontentsタグが使えることだけである。以下に例を示す。

<?xml version="1.0" encoding="Shift_JIS"?>

<presentation>
	<!-- コンテンツ -->
	<contents>contents.xml</contents>

	<!-- ウィンドウサイズ -->
	<width>800</width>
	<height>600</height>
	<fullscreen>true</fullscreen>

	<!-- スタイルシート -->
	<stylesheet>stylesheet1.xsl</stylesheet>
	<stylesheet>stylesheet2.xsl</stylesheet>

	<!-- リソース -->
	<resource>resource1.xml</resource>
	<resource>resource2.xml</resource>
</presentation>

スタイルやリソースと異なり、プレゼンテーションの内容となるファイルは一つだけである。ウィンドウサイズを指定しなかった場合は、config/config.xmlで指定した値がデフォルトで使用される。

3: スタイルファイル(*.xsl)

このファイルは、標準的なXSLによってXMLの変換規則を記述するファイルである。一つのプレゼンテーションは、config/config.xmlとプレゼンテーションファイルのそれぞれで指定された複数のスタイルファイルを使用する。プレゼンテーションとして最終的に画面に表示されるコンテンツは、これら全てのスタイルファイルに記述された全ての変換を受けた結果である。変換が行われる順番は、以下のようになる。

config/config.xmlで１番目に指定されたスタイルファイル
config/config.xmlで２番目に指定されたスタイルファイル
config/config.xmlでｎ番目に指定されたスタイルファイル
プレゼンテーションファイルで１番目に指定されたスタイルファイル
プレゼンテーションファイルで２番目に指定されたスタイルファイル
プレゼンテーションファイルでｎ番目に指定されたスタイルファイル

4: リソースファイル(*.xml)

このファイルは、プレゼンテーション中で使用するフォントや材質や画像を記述するファイルである。ここで記述されたリソースには名前が付けられ、コンテンツ中から参照することができる。以下に例を示す。

<?xml version="1.0" encoding="Shift_JIS" ?>

<resource>
	<!-- フォント定義 -->
	<fonts>
		<font name="big"    font="msgothic.ttc" size="56" />
		<font name="middle" font="msgothic.ttc" size="48" />
		<font name="normal" font="msgothic.ttc" size="40" />
		<font name="small"  font="msgothic.ttc" size="32" />
	</fonts>

	<!-- 材質定義 -->
	<materials>
		<material name="RED"
			ambient  =" 0.2, 0.0, 0.0"
			diffuse  =" 0.6, 0.0, 0.0"
			specular =" 0.7, 0.0, 0.0"
			shininess=" 1.0" />

		<material name="GREEN"
			ambient  =" 0.0, 0.2, 0.0"
			diffuse  =" 0.0, 0.6, 0.0"
			specular =" 0.0, 0.7, 0.0"
			shininess=" 1.0" />

		<material name="BLUE"
			ambient  =" 0.0, 0.0, 0.2"
			diffuse  =" 0.0, 0.0, 0.6"
			specular =" 0.0, 0.0, 0.7"
			shininess=" 1.0" />
	</materials>

	<!-- 画像定義 -->
	<images>
		<image name="image1" image="images/image1.jpg" />
		<image name="image2" image="images/image2.png" />
		<image name="image3" image="images/image3.gif" />
	</images>
</resource>

fonts内のfontタグでフォント、 materials内のmaterialタグで材質、 images内のimageタグで画像のリソースを記述できる。 font・material・imageの各タグは共通してname属性を持っており、ここに指定した名前を使うことによってコンテンツからこれらのリソースを利用する。各タグの指定方法を以下に示す。

■ fontタグ

font属性

フォントディレクトリ（Windows2000の場合はc:\winnt\fonts、Windows XPの場合はc:\windows\fonts）に入っているフォントの名前を指定する。

size属性

フォントのサイズをポイント単位で指定する。

■ materialタグ

ambient・diffuse・specular属性

それぞれ環境光・拡散光・鏡面光の値をRed・Green・Blue・Alphaに関して指定する。 Alphaに関しては省略が可能で、省略した場合は1.0という値が使われる。

shininess属性

鏡面の指数を指定する。値が大きいほどハイライトの部分が小さく、明るくなる｡

■ imageタグ

image属性

画像ファイル名を指定する。指定できる画像ファイルの種類はjpg・png・gifである ^*1。

フォントと材質はここで指定しなければコンテンツ中で使用することはできないが、画像に関してはリソースとしてあらかじめ記述されていなくてもコンテンツ中でファイル名を直接指定できる。ただし、コンテンツ中にファイル名を指定した場合は、そのページが開かれるごとに画像が読み込まれるためページが切り替わるのに時間が掛かる場合はリソースとして記述してしまった方がいい。

*1: 画像の読み込みにはライブラリを用いており、そのライブラリに依存する。たぶん、他にも色々読み込めると思うが、やったことがない。

5: コンテンツファイル(*.xml)

このファイルは、プレゼンテーションの内容を記述するファイルである。注意して欲しいのは、このファイルに書かれた内容はスタイルファイルによって変換を受けるということである。実際にコンテンツとして画面に表示されるのは、全ての変換を受けた結果である。従って、指定したスタイルファイルの内容によってこのファイルに書かれる内容は大きく変わってくる。ここでは、最終的に変換されたXMLがどのような記述になっていなければならないのかを説明する。

コンテンツの内容は、最終的に以下のような形式になっていなければならない。

<?xml version="1.0" encoding="Shift_JIS" ?>

<presentation defaultFont="normal">
	<!-- １ページ目 -->
	<page>
		<!-- １ページ目の内容 -->
	</page>

	<!-- ２ページ目 -->
	<page>
		<!-- ２ページ目の内容 -->
	</page>

	<!-- ３ページ目 -->
	<page>
		<!-- ３ページ目の内容 -->
	</page>
</presentation>

presentationタグのdefaultFont属性には、デフォルトとして使うフォントのリソース名を指定する。 pageタグはプレゼンテーションの各ページを示すタグであり、記述した順にプレゼンテーションのページとなる。

5.1: pageタグ（ページ）

一つのページは特殊効果設定とページ内容の二つの情報を持つ。以下に一ページの標準的な記述の例を示す。

<page>
	<effects>
		<!-- 特殊効果設定 -->
	</effects>

	<contents>
		<!-- ページ内容 -->
	</contents>
</page>

5.2: effectsタグ（特殊効果設定）

effectsタグ内で使うことのできるタグは、effectタグとorderタグの二つだけである。 effectタグはページ内で使用する特殊効果を定義する。そして、orderタグは特殊効果が動作する順番を制御する。以下に例を示す。

<effects>
	<!-- 特殊効果定義 -->
	<effect name="null" type="null" />
	<effect name="effect1" type="lift" />
	<effect name="effect2" type="top" axis="0.0, 1.0, 0.0" da="45.0"/>
	<effect name="effect3" type="effects">
		<effect type="lift" />
		<effect type="top" axis="0.0, 1.0, 0.0" da="45.0" />
	</effect>

	<!-- 特殊効果動作制御 -->
	<order name="null" />
	<order name="effect1" />
	<order name="effect2" />
	<order name="effect3" />
	<order name="effect1, effect2, effect3" />
</effects>

■ effectタグ

name属性

特殊効果の名前を指定する。

type属性

特殊効果のタイプを指定する。現在指定できるタイプは以下の通りである。

null（ヌル）	何もしない特殊効果である。
lift（リフト）	オブジェクトを手前に持ち上げる特殊効果である。
top（駒）	オブジェクトを指定した軸（axis属性）・指定した角速度（speed属性）で回転させる特殊効果である。
effects（複数）	複数の特殊効果を合わせて一つの特殊効果とする。

enable属性（省略可）

trueに設定することで順序に関係なく初期状態で特殊効果を有効にできる。

■ orderタグ

orderタグは特殊効果の起動順序を制御する。特殊効果はプレゼンテーションソフトの操作に従って、記述された順序で作動する。 orderタグはname属性のみを持つ。name属性にはeffectタグによって定義された特殊効果名を指定する。複数の特殊効果を同時に作動させたい場合は、カンマで区切って指定する。

5.3: contentsタグ（ページ内容）

contentsタグ内に記述したテキストは、文字として画面に表示される。デフォルトのフォントとは別のフォントを使用したい場合は、fontタグで指定する。画像を表示したい場合は、imageタグを使用する。プレゼンテーションにアクセントをつけるために３Ｄのキューブを置くためにはcubeタグを使用する。空白を入れたい場合はnullタグを使用する。また、これらのオブジェクトを配置する位置を制御するためにはcontainerタグを使用する。現在定義されているタグは、以上の非常に単純なタグだけである。プレゼンテーションを記述するためには、以上のタグを組み合わせて使用する。以下に、各タグの詳細を示す。

■ fontタグ

fontタグは、タグ内のテキストが使用するフォントを設定する。

font属性（省略可）

使用するフォントのリソース名を指定する。

color属性（省略可）

使用する色をR,G,Bで指定する。

style属性（省略可）

使用するスタイルを指定する。指定できるスタイルを以下に示す。

normal	通常
bold	太字
italic	斜体
underline	下線

また以上のスタイルを複合的に用いる場合は、|(vertical bar)で複数のスタイルを区切って指定する。

<font font="big" />
<font color="255,0,0" />  <!-- 赤 -->
<font style="bold" />  <!-- 太字 -->
<font name="big" color="0,255,0" style="bold|italic" />  <!-- 緑で太字で斜体 -->

■ imageタグ

imageタグは画像を表示する。

image属性（file属性と排他的関係）

画像のリソース名を指定する。

file属性（image属性と排他的関係）

画像のファイル名を指定する。

width・height属性（省略可）

画像の表示サイズを指定する。省略した場合は、元画像のサイズを使用する。

<image image="image1" />
<image file="image1.jpg" />
<image image="image1" width="800.0" />  <!-- 幅は800、高さは画像のまま -->
<image image="image1" width="800.0" height="600.0" />  <!-- 幅は800、高さは600 -->

■ cubeタグ

cubeタグは３Ｄのキューブを表示する。

size属性

キューブのサイズを指定する。

material属性

キューブの材質をリソース名で指定する。

<cube size="50,50,50" material="RED" />

■ nullタグ

nullタグは何も表示しない区画を取る。

size属性

空白のサイズを指定する。

<null size="50,50,50" />

■ containerタグ

containerタグは、タグ内のオブジェクトの配置を制御する。

offset属性（省略可）

配置位置からのオフセット値を指定する。すなわち、ここで指定した座標値分、このコンテナに配置されたオブジェクトがずれて表示されることになる。

center属性（省略可）

コンテナの回転中心座標を中心からの相対値として指定する。省略した場合はコンテナの中心座標がそのまま回転中心座標となる。特殊効果で回転などを加える場合には、どこを基点に回転させるのかを指定するために使用する。

size属性（省略可）

サイズを指定する。指定しなかった場合、通常は全てのオブジェクトを配置することによる適切なサイズが決定される。

layout属性（省略可）

コンテナ上にどのようにオブジェクトを配置するかを指定する。現在指定することができるレイアウトを以下に示す。

null（デフォルト）	特に何もしない
horizontal	水平方向にオブジェクトを配置する。
vertical	垂直方向にオブジェクトを配置する。
interior	奥行き方向にオブジェクトを配置する。

align属性（省略可）

x,y,zの各軸に対してコンテナ上にどのようにオブジェクトを配置するかのレイアウトの指針を指定する。現在指定することができる値を以下に示す。

center, *	真中に配置する
left, right	左右に配置する（Ｘ座標のみ指定可）
top, bottom	上下に配置する（Ｙ座標のみ指定可）
front, back	前後に配置する（Ｚ座標のみ指定可）

effect属性（省略可）

特殊効果名を指定し、コンテナに配置されたオブジェクトに特殊効果を設定する。

<!-- ３つのキューブを横に並べる -->
<container layout="horizontal">
	<cube size="50,50,50" material="RED" />
	<cube size="50,50,50" material="GREEN" />
	<cube size="50,50,50" material="BLUE" />
</container>

<!-- TESTというテキストにeffect1という特殊効果を加える -->
<container effect="effect1">
	TEST
</container>

<container layout="vertical" align="left,*,*" size="800,*,*">
	このテキストを、
	左側に揃えるようにして配置する。
	全体としての幅は500として設定される。
</container>