WideStudio Online Documents
Author: T. Hirabayashi

| WideStudio Online Documents | WideStudio Index Table of contents

> # WideStudio for BTRON

> WideStudio for BTRON は、 T-Engine または BTRON におけるデスクトップアプリケーションを 製作するための WideStudio です。
> WideStudio for BTRON を使うと次のような特徴がある T-Engine/BTRON アプリケーションを 製作することができます。
> - BTRON用のネイティブバイナリの高速なアプリケーションを製作できます。
> - 他のプラットフォームとプログラム資産が共有できます。

> ## WideStudio for BTRON の環境の構築

> WideStudio for BTRON では、Linux または Windows を開発環境とし、 BTRON アプリケーションを Linux 上または Windows 上で構築します。 出来たアプリケーションを BTRON に転送し、 実行しデバッグする開発形態をとります。
> WideStudio for BTRON で BTRON アプリケーションを製作するために 必須なソフトウェアを、 下記に示します。
> - gcc/g++ などの Linux 用のコンパイラ(Linux上の場合)
> - ソースコードを編集するためのエディタ
> - BTRON 開発環境(パーソナルメディア社 bright-v用の開発環境一式)
> Linux 上の場合、コンパイラは Linux に添附されている Linux 用の gcc/g++ コンパイラが必要です。
> また、Linux / Window ともに bright-v 開発環境に添付されている BTRON 用の gcc コンパイラが必要です。
> bright-v 開発環境が /usr/local/brightv (Linux上)、 c:/cygwin/usr/local/brightv (Windows上)に インストールされているものとして、WideStudio for BTRON の 環境構築を進めたいと思います。

> ## WideStudio for BTRON のビルド (Linux)

> Linux の場合、ソースコードからライブラリをビルドする必要があります。
> (注意)Windows の場合は、バイナリパッケージに予め BTRON 用のライブラリが 含まれますのでビルドの必要はありません。
> WideStudio のソースコードは、 ws-vX.XX.X-src.tar.gz というファイル名で公開されています。
> (注意)X.XX.X は WideStudio のバージョン番号を示します。
> そのファイルを入手したら、T-Engine 開発環境がインストールされている Linux 機で次のように展開します。展開するディレクトリは 一時的なものですのでどこでもかまいません。

>      cd /work
>      gzip -cd ws-vX.XX.X-src.tar.gz | tar -xvf -

> WideStudio for BTRON のビルドは2つのフェーズからなります。 1つは WideStudio 本体のビルドと、 1つは BTRON 用のライブラリのビルドです。
> - WideStudio 本体のビルド
> - WideStudio for BTRON 用のライブラリのビルド
> WideStudio 本体のビルドは、 gcc/g++ を Linux のものを用いて、 次の手順でおこないます。

>     cd /work/ws-vX.XX-X
>     ./configure
>     make

> 本体のビルドが終ったら次は、 WideStudio for BTRON のビルドです。 WideStudio for BTRON のビルドは、 BTRON バイナリを生成するために、 BTRON 用のコンパイラを使用するため、 BTRON 用コンパイラをインストールしたパスを 次の樣に設定します。
> csh の場合の場合の設定を示します。

>     setenv BD /usr/local/brightv

> 環境変数の設定が終ったら次の手順でおこないます。

>     cd /work/ws-vX.XX-X/src
>     make btron

> エラーが出ずにビルドできれば、環境のビルドはこれで完了です。 次のように入力して、でき上がった WideStudio 一式をインストールしましょう。 デフォルトで /usr/local/ws にインストールされます。

>     su
>     cd /work/ws-vX.XX-X
>     make install

> ## アプリケーションビルダーの設定

> アプリケーションビルダで、BTRON 用のアプリケーションをビルドする際に、 BTRON 用コンパイラをインストールしたパスを設定する必要があります。
> [プロジェクト]メニューの[プロジェクト設定]を選択し、 [環境設定]タブをクリックし下記の BTRON の項目に BTRON 用コンパイラをインストールしたパスを設定します。

> ## WideStudio for BTRON による Hello アプリケーションの作成

> 簡単なアプリケーション hello を例に、 WideStudio for BTRON で実際の BTRONアプリケーション構築手順を みていきましょう。
> まず、wsbuilder を起動し、 アプリケーションビルダーの［プロジェクト］メニュー の新規プロジェクトを選択し、 新規にプロジェクトを作成します。 プロジェクト名に hello を指定して、 「通常のアプリケーション」を選択してします。 作成されるプロジェクトファイル名は、hello.prj です。
> 次に、 [プロジェクト]メニューの[プロジェクト設定]を選択し、 [基本設定]タブをクリックし下記の TARGET の項目において、 BTRON を設定します。

> ## ウィンドウの作成

> プロジェクトを作成したら、次は、 hello のベースとなるウィンドウを一つ作成しましょう。 ビルダーの［ファイル］メニューの新規ウィンドウ を選択します。タイプは、「通常のウィンドウ」を選択し、 newwin000 の名称で作成し、プロパティを次のように設定します。

>     オブジェクト名称: newwin000
>     X座標： 0
>     Y座標： 0
>     横幅： 240
>     縦幅： 300
>     タイトル属性： タイトルなし

> 次に、作成されたばかりのウィンドウ上に、 ボタンオブジェクトを配置し、次のように設定します。

>     オブジェクト名称: newvbtn_000
>     Ｘ座標: 10
>     Ｙ座標: 10
>     横幅: 100
>     縦幅: 30
>     表示文字列: TEST

> ▲ hello のウィンドウの様子

> ## イベントプロシージャの作成

> 次はいよいよイベントプロシージャの作成です。 ボタンを押したら、「Hello!」と表示されるようにしてみましょう。 イベントプロシージャは、Ｃ＋＋言語で記述し、 オブジェクトのアクセスや任意のデータ処理等を行います。 そして、作成したプロシージャを配置した部品に対して、 起動されるイベントを指定します。
> 例えば、イベントプロシージャを、ボタンに対し、 マウスが押される等のイベントで設定しておくと、 マウスでボタンが押した時に実行されます。
> 作成したプッシュボタン newvbtn_000 に対し hello! と表示するような イベントプロシージャを作成します。 アプリケーションビルダーで、newvbtn_000 を選択して、 [編集]メニューの[プロシージャ編集]の[プロシージャ新規作成]を 選択し、次のように設定します。

>     #include
>     #include
>     #include
>     //-----------------------------------------------
>     //Function for the event procedure
>     //-----------------------------------------------
>     void btnop1(WSCbase* object){
>     static long cnt = 0;
>       if (cnt != 0){
>         exit(0);
>       }
>       object->setProperty(WSNlabelString,"Hello!");
>       cnt++;
>     }
>     static WSCfunctionRegister op("btnop1",(void*)btnop1);

> ## Hello プロジェクトのビルド

> 作成した hello プロジェクトを アプリケーションビルダーの［プロジェクト］メニューの［プロジェクト保存］ を選択して保存したら、 アプリケーションビルダーの［ビルド］メニューのビルドオールで ビルドを行います。 これでエラーが出なければ、hello は完成です。
> ▲ビルドのようす
> ビルドが成功すると、プロジェクトのディレクトリに hello.bz が生成されます。 この hello.bz を BTRON 開発環境に標準で添付される gterm を用いて次のようにシリアル転送し、設定します。
> また、ファイルの転送に関しては fget コマンドによるイーサネット転送も可能です。 詳しくは パーソナルメディア社から公開されている BTRON 開発環境の取扱説明書を 御覧ください。

>     [/SYS] recv -d /.../hello/hello.bz  ← hello.bz のファイルをフルパスで指定します。
>     [/SYS] expf -v hello.bz             ← hello.bz を展開します。
>     [/SYS] vup -t hello /SYS            ← hello を小物に登録します。
>     [/SYS] rm hello hello.bz            ← 不要になった hello を削除します。

> これで、「サンプルプログラム」という題目で 小物に hello が登録されます。 小物からダブルクリックしてアプリケーションを起動することができます。 プロジェクトのディレクトリに生成される hello.f を編集することで、 登録される「サンプルプログラム」という題目を変更することができます。

Document Release 3.20 for WideStudio ver 3.20, Oct 2002

WideStudio documents index | Table of contents

Copyright(C) T. Hirabayashi, 2000-2002 | Last modified: Dec 6, 2002