これは RuntimeRevolution 1.1.1 のヘルプにある文書を邦訳したものです。この文書の文責はＵＤＩにあり、またＵＤＩはこの文書についての一切の債務を負いません。 間違いがありましたら eudio@chabashira.co.jp までお知らせ下さい。この文書は必要と思われる時に適宜アップデートされます。

Help -> Tutorials -> Getting Started


1. Before you start
チュートリアルを始める前に

　このチュートリアルを始める前に、メニューの使い方、ファイルのオープンと保存、マルチウィンドウやボタンの扱い方など、コンピュータの扱いに慣れていなければならない。もしあなたがプラットフォームに慣れていないなら、このチュートリアルを効果的に使うために、まずオペレーティングシステムのドキュメントを読みなさい。

　ティップス：知らない用語が出てきたらマウスポインタをそこに当てなさい。もし用語の色が変わったら、それをクリックして用語集を参照することが出来る。（閉じるには再度クリックする）

　このチュートリアルは各ステップを理解しながら進んでいく方式である。各ステップが終わったら、画面下にある右向き矢印ボタンをクリックするか、Enter キーを押して次のステップに進みなさい。キーボードの矢印キーを使って各ステップを移動することも出来る。


2. About this tutorial
このチュートリアルについて。

　このチュートリアルでは、Revolution でアプリケーションを作って配布する基本的な方法を学ぶ。

　ここでは Revolution のインタフェースの基本を学ぶために、最も一般的なツールとその特徴を紹介する。あなたはほんの数分でスタンドアローン・アプリケーションを作ることが出来るだろう。

　伝統的なソフトウェア開発ツールでは、まずスクリーンに "Hello World" を表示させる練習から始める。もちろん同じ事をしてもいいが、Revolution ならもうちょっと気の利いたテキスト表示が出来る。このあとのチュートリアルでは、この練習問題を拡張し、ジオメトリーマネージャ（Geometry Manager）、アニメーションマネージャ（Animation Manager）などのパワフルなマネージャを使った、Revolution のパワフルな機能を紹介する。


3. Creating a new stack
新しいスタックを作る

　Revolution のソフトウェアを作るには、まずスタックを作る。新しいプログラム作りはいつでもスタック作りから始める。

　スタックオブジェクトはウィンドウであり、そこにはアプリケーションを構成する様々なオブジェクトが含まれている。各スタックはひとつ、或いは複数のカードを含み、その独立したパネルには、ボタン、フィールド、グラフィックなどのオブジェクトをそれぞれ含ませることが出来る。ボタンやカードなどのオブジェクトと同じように、スタックはそれ自身のスクリプトとプロパティを持っている。このチュートリアルでは普通の編集可能なウィンドウを作る。しかしスタックは編集可能ウィンドウとしても、パレットとしても、ダイアログボックスやメニューとしても表示することが出来る。

　新しいスタックを作るには File メニューから "New Mainstack" を実行する。これで新しいウィンドウが現れる。新しいスタックはひとつのカードを持っており、そのウィンドウエリアにオブジェクトを置くことが出来る。


4. Using the Properties palette
プロパティパレットを使う

　スタックを作ったので、これに名前を付けてみよう。

　スタックの名前はそのスタックのプロパティである。 Revolution ではオブジェクトのプロパティをプロパティパレットを使って編集することが出来る。ここで Revolution のスクリプト言語である Transcript で書かれたスクリプトをセットすることも出来る。さあ、プロパティパレットを使って、新しいスタックのプロパティを書き換えてみよう。

　プロパティパレットを開くには、Object メニューから "Stack Properties" を実行する。プロパティパレットがひとつ開き、Name ボックスにはスタックのデフォルト名（ "Untitled 1" ）が見るだろう。ボックスのテキストを選択して名前を "Hello World" に変え、Return キーを押して名前をセットする。


5. Saving your stack
スタックを保存する

　次の機能に移る前に、このスタックを保存しておくのは良いアイディアである。こうすれば何かで失敗した時に、保存しておいた前のバージョンに戻ることが出来る。

　スタックを保存するには、File メニューから "Save" を実行する。ファイルダイアログが現れて、ファイル名とその場所を指定することが出来る。名前を "HelloWorld.rev" として、Save ボタンをクリックしなさい。

　ティップス：　見てきたように、保存するファイルには名前が必要だが、スタックには必ずしも名前は必要ではない。これは Revolution ファイルが複数のスタックを含めることが出来るためである。（ただしこのチュートリアルではファイルにひとつのスタックしか作らない）


6. Creating a field object
フィールドオブジェクトを作る

　"Hello World" をスタックに表示するには、まずテキストを入れるオブジェクトを置かなければならない。 Revolution ではテキストの入れ物をフィールドと呼ぶ。

　新しいフィールドを作るには、Tools パレットの Field ツールをクリックする。（もし Tools パレットが表示されていなければ、Tools メニューの "Tools Palette" を実行しなさい）　Field ツールは Tools パレットの上から４番目の左側にある。

　このツールはお絵かきソフトのように扱う。 Field ツールを選択して、スタックウィンドウをクリックし、５センチほどマウスをドラッグする。マウスボタンを離すと新しいフィールドが現れ、カーソルは Pointer ツール（矢印の形）になる。


7. Setting field properties
フィールドプロパティの設定

　Properties パレットを開くと、スタックのプロパティが現れる。しかしあなたがオブジェクトを選択すると、Properties パレットはそのオブジェクトのプロパティに切り替わる。

　新しいフィールドを作った時は、それが自動的に選択された状態になる。だから Properties パレットは現在フィールドのプロパティを編集できる状態にある。

　Properties パレットでフィールドの名前を "My Field" としなさい。

　ついでにフィールドの外見を決めるプロパティをいくつかセットしよう。 "Opaque"、"3-D"、そして "Show Border" のチェックボックスのチェックを外す。これでフィールドは透明になり、テキスト部分だけが見えるようになる。次は、テキストの入力を試す...


8. Exploring field behaviors
フィールドの動作を探検する

　新しいフィールドを試すために、Tools パレットからブラウズ（ Browse ）ツールを選択する。（ブラウズツールは手の形をしたアイコンで、Tools パレットの左上にある）　これによってオブジェクトの選択状態が解除される。オブジェクトが何も選択されていない時は、Properties パレットは畳み込まれ、タイトルバーだけになる。

　ブラウズツールを選択してマウスポインタをフィールドの上に移動する。ポインタがフィールド上にあるあいだカーソルは I ビームに変わり、テキストを編集出来る状態であることを示す。フィールドをクリックして "Hello World" をタイプしなさい。

　Revolution のフィールドは、ワードプロセッサのように cut、copy、paste text を実行することが出来る。これらの基本動作は Revolution が自動的に行うため、あなたはそのアプリケーション独自の機能に集中することが出来る。さぁ、これらを使って始めよう...


9. Selecting a field
フィールドの選択

　新しいフィールドでは、テキストの属性は自動的に現在のオペレーションシステムの設定に従う。しかしＫのチュートリアルではもうちょっと面白いことをしよう。つまりフィールドのテキストフォントとサイズプロパティを変えてみる。

　フィールドを選択するには、Tools パレットから Pointer ツールに持ち変える。（ Pointer ツールは Tools パレット右上の矢印アイコンである）

　Pointer ツールでフィールドをクリックすると、そのフィールドを選択する。

　フィールドが選択されたら、Object メニューから "Text" を選ぶ。これによって、Revolution のほとんどのオブジェクトのテキスト属性を編集出来る Text パレットが開く。


10. Setting text attributes
テキスト属性を編集する

　Text パレットの "Text Font" と書かれたメニューから、好きなフォントを選ぶ。それから、その下にある "Text Size" メニューから、24 ポイントなどのサイズを選ぶ。そして Text パレットを閉じるか、邪魔にならないところに移動する。

　ティップス：　Text メニューの Font、Size サブメニューからテキストの属性を選ぶことも出来る。これらのメニューアイテムも試してみなさい。

　フィールドのテキスト属性のセットが済んだら、それをユーザーが変更してしまわないように、ロックすることが出来る。フィールドをロックするには、まず Pointer ツールでフィールドを選択する。 Properties パレットの左側にある Field タブをクリックして、"Lock Text" チェックボックスにチェックを入れなさい。これでフィールドのテキストはロックされ、フィールドのテキストは表示されるが編集出来ない状態になる。（もし後でテキストを変更したくなったら、チェックボックスをオフにすればよい）


11. Resizing the field
フィールドのリサイズ

　テキストをタイプしてテキストフォントやテキストサイズを変更していると、フィールドが大きすぎたり小さすぎたりすることがある。そういう時、フィールドの大きさを変更したいと考える。

　フィールドを選択した時、フィールドの各コーナーと各辺の真ん中に小さい四角の "ハンドラ" があったのに気付いたろうか。これらのハンドラをドローソフトのようにドラッグすることで、フィールドの大きさを変えることが出来る。

　フィールドのコーナーハンドルをクリックして、テキストが丁度収まる大きさになるまでドラッグしなさい。

　ティップス：　Properties パレットの Height、Width、の各ボックスの左にある "Set to formatted" と呼ばれる小さな矢印ボタンを使うと、フィールドのサイズを素早くテキストにフィットさせることが出来る。結果が好みに合わなかったら、ハンドラを使ってサイズを調整しなさい。


12. Creating a graphic object
グラフィックオブジェクトを作る

　あなたの使えるオブジェクトはフィールドだけではない。 Revolution は更にいくつかのオブジェクトタイプをサポートする。このチュートリアルでは、ボタンとグラフィックスを扱ってみる。

　スタックにグラフィックオブジェクトを追加するには、Tools パレットから Oval ツールを選択する。（ Oval ツールは Tools パレットの右側の下から５番目にある）　Field ツールで行ったと同じように、スタックウィンドウでマウスポインタをドラッグしてオブジェクトを作る。フィールドを被うような大きなグラフィックを作りなさい。

　ティップス：　もし真円のグラフィックを作りたいなら、Shift キーを押しながらドラッグしなさい。 Shift キーはオブジェクトの縦横のサイズを強制的に同じにする。


13. Setting graphic properties
グラフィックのプロパティを設定する

　新しいグラフィックを作ると自動的に選択状態になり、Properties パレットはグラフィックのプロパティを編集できる状態になる。 Properties パレットで名前を "My World" に変えなさい。

　Revolution のウィンドウにある各オブジェクトは、それぞれのレイヤーの中に存在する。オブジェクトが他のオブジェクトに重なった時は、どちらが上になるかをそのレイヤーが決定する。新しいオブジェクトを作るとそれは一番手前のレイヤーに置かれ、他のオブジェクトよりも上になる。

　oval グラフィックをフィールドよりも後ろにするには、Properties パレットにある、オブジェクトレイヤーを整えるボタンを使う。 oval グラフィックを選択して、Properties パレットの Layer ボックスの下にある Send to Back アイコン（一番左にある矢印アイコン）をクリックすれば、グラフィックはフィールドの後ろに移動する。


14. Setting colors and patterns
カラーとパターンを設定する

　Revolution のオブジェクトのカラープロパティは Colors パレットで変更することが出来る。先ほどの oval グラフィックを "world" （世界）にするために、これを青くしてみよう。

　グラフィックを選択して、Object メニューの "Colors and Patterns" を選ぶ。

　Revolution のオブジェクトにはいくつかのカラープロパティがあり、それぞれがオブジェクト様々な外見を決定する。これらのプロパティは Colors パレットの下の方にリストアップされている。グラフィックのカラーを変えるためには、まず "Background Color" をクリックして、パレット内にあるタイルのひとつをクリックする。するとグラフィックはあなたの選んだカラーで塗りつぶされる。

　ティップス：　カラーのセットが済んだら、作業スペースを空けるために Colors パレットを閉じても良い。


15. Creating a button object
ボタンオブジェクトを作る

　Revolution は多くの種類のボタンをサポートする。例えばオンオフをコントロールするためのチェックボックス、複数のオプションから選択するためのラジオボタン、そして普通の動作をする標準ボタン。ここでは標準ボタンを使って、シンプルなアニメーションをさせてみる。

　ボタンを作るには、Tools パレットから Button ツールを選択する。（ Button ツールは Tools パレットの左側、上から２番目にある）　Field ツールや Oval ツールを使った時と同じように、スタックウィンドウでクリックしてドラッグする。スタックウィンドウの左の下のほうにボタンを作ろう。


16. Setting button properties
ボタンプロパティの設定

　ボタンがひとつ作られ、Properties パレットが新しいボタンのプロパティを編集出来る状態になったことに気付いたろう。

　Revolution の多くのオブジェクトは、名前（name）とラベル（label）を持っている。これは、スクリプトからオブジェクトを参照するための名前を、ユーザーに見せるためのラベル文字列とは無関係に使えることを意味する。例えばユーザーのために長いラベル文字列を使ったとしても、スクリプトで参照する名前を短いもので済ますことが出来る。

　Properties パレットで name を "start" にセットし、label を "Show me!" にする。

　作業を保存するのにはいいタイミングである。 File メニューから Save を選び、チュートリアルスタックの変更を保存しなさい。


17. Introduction to scripting
スクリプティングのために

　ユーザーが何かのアクション −例えばマウスをクリックした、キーボードのキーを押した− を起こすと、Revolution はそのアクションのターゲットとなるオブジェクトにメッセージを送る。 Revolution も、ある種のイベント −例えばスタックのオープンやクローズ− が起きた時にメッセージを送る。

　スクリプトは、様々なメッセージに対応して、Revolution にどんなことをして欲しいかを伝えるためのものである。このチュートリアルでは、ユーザーが "Show Me!" ボタンをクリックした時に、スクリーンの外にあったフィールドをスタックウィンドウの中央に移動する、と言うスクリプトをボタンに書く。

　ボタンのスクリプトを開くには、Pointer ツールでボタンを選択し、Properties パレットの Script タブをクリックする。これでスクリプトエディタが開く。


18. Using the Script Editor
スクリプトエディタを使う

スクリプトエディタはオブジェクトのスクリプトを書くためのものである。スクリプトエディタにこのように入力しなさい：

on mouseUp
  show graphic "My World" with visual effect dissolve
  move field "My Field" to the location of this card
end mouseUp

on mouseUp
  show graphic "My World" with visual effect dissolve
  move field "My Field" to the location of this card
end mouseUp

on mouseUp
  show graphic "My World" with visual effect dissolve
  move field "My Field" to the location of this card
end mouseUp

on mouseUp
  show graphic "My World" with visual effect dissolve
  move field "My Field" to the location of this card
end mouseUp

on mouseUp
  show graphic "My World" with visual effect dissolve
  move field "My Field" to the location of this card
end mouseUp

on preOpenCard
  set the loc of field "My Field" to -100,-50
  hide graphic "My World"
end preOpenCard

on preOpenCard
  set the loc of field "My Field" to -100,-50
  hide graphic "My World"
end preOpenCard

on preOpenCard
  set the loc of field "My Field" to -100,-50
  hide graphic "My World"
end preOpenCard

on preOpenCard
  set the loc of field "My Field" to -100,-50
  hide graphic "My World"
end preOpenCard

on preOpenCard
  set the loc of field "My Field" to -100,-50
  hide graphic "My World"
end preOpenCard

on mouseUp
  send "preOpenCard" to this card
end mouseUp

on mouseUp
  send "preOpenCard" to this card
end mouseUp