Origin Cファイルの作成と編集

概要

コードビルダは、Origin CとLabTalkプログラミングの統合開発環境(IDE)です。 コードビルダは、Origin Cのプログラムを記述／編集したり、コンパイル、リンク、デバッグをしたり、実行するためのツールを提供します。 Origin Cのコードは任意のテキストエディタで書くことができますが、コンパイルしてリンクするにはコードビルダのワークスペースに追加する必要があります。

コードビルダウィンドウ

ファイルの種類

Origin Cは、ファイル、ソース、オブジェクト、プリプロセス、ワークスペースという4種類のファイルを使用する。

ソース (*.c, *.cpp, *.h, *.ocz)

ソースファイルは基本的に人間が読めるOrigin Cコードを含むテキストファイルです。 コードビルダや他のテキストエディタで作成することができ、任意の場所に保存することができます。 コードビルダのテキストエディタは、シンタックスの色付け、内容に応じたヘルプ、デバッグの機能があります。また、コードビルダでは暗号化Origin Cファイル(*.ocz)を作成でき、他の人と安全にファイルを共有できます。

ソースファイルはコンパイル、リンク、ロードされるまで、それらに含まれる関数をOriginで使用することはできません。

オブジェクト (*.ocb)ファイル, オブジェクトファイル(*.OCB)

ソースファイルがコンパイルされるとき、オブジェクトファイルが生成されます。 オブジェクトファイルはソースファイルと同じファイル名を持ちますが、ファイル拡張子は、*.ocb となります。 オブジェクトファイルは、コンピュータが読むことができ、Originはその関数を呼び出して実行します。 Originは、最初にソースファイルをコンパイルし、そして、ソースファイルが変更されときにのみ再コンパイルします。

Origin内のオブジェクトファイルは、バージョンに依存し、それらを共有することはできません。 関数やOrigin Cアプリケーションを共有する場合、代わりにプリプロセスファイルを共有します。

プリプロセス (*.op)ファイル, プリプロセスファイル(*.OP)

デフォルトでは、Originはソースファイルをコンパイルしてオブジェクトファイルを生成します。 しかし、下記のシステム変数で、オブジェクトファイルの代わりにプリプロセスファイルを生成するように変更することができます。 プリプロセスファイルは、コンパイルが必要ですが、コードの共有に対して次のようなメリットがあります。

• Originのバージョンに依存しない
• ソースコードを共有せずに関数を共有可能
• ビルド処理がソースファイルよりもはるかに高速

オブジェクト(OCB)ファイルまたはプリプロセス(OP)ファイルの生成を可能にするシステム変数は @OCS と @OCSB です。スクリプトウィンドウまたはコードビルダのLabTalkコンソールで、これらの値を変更できます。 例えば、スクリプトウィンドウで、次のように入力します。

@OCSB=0; // これ以降コンパイルでOPファイルを作成

@OCSコンパイラ, プリプロセスファイルを生成

この変数のデフォルト値は1で、OCBファイルまたはOPファイルを作成します。@OCS=0の場合、コンパイラはOCBファイルまたはOPファイルを作成しません。

@OCSBコンパイラ, プリプロセスファイルの種類

@OCSB=1がデフォルト値で、これはコンパイル時にオブジェクトを生成します。OPファイルを生成するには、@OCSB=0を設定すると、コンパイル時にOPファイルが生成される。OPファイルは、ソースファイルと同じフォルダ内に保存され、同じファイル名を持ちますが、拡張子がOPとなります。@OCS=0の場合、この変数は意味を持ちません。

Notes: 1.生成されるOPとOCBは、32bit、64bitのバージョンを持ちます。例えば、32bitバージョンのabc.cから生成されたopファイルは、abc_32.OPという名前になります。 2.Origin 9.0以降、生成された32bitあるいは64bitバージョンのファイルは、対応するバージョン（32bitあるいは64bit）のOriginでしか動作しません。

ワークスペース (*.ocw)ファイル、ワークスペースファイル(*.OCW)

コードビルダでは、数多くのOrigin Cソースファイルを含むプロジェクトを作成または使用できます。 これらのファイルは、フォルダ内で階層で統合化されていたり、されていない場合があります。このようなファイルを、プロジェクトを切り替える度に、手動でロードするのはとても不便です。

このような理由で、Userフォルダに含まれる構造およびファイルはワークスペースファイルに保存することができます。 ワークスペースファイルをコードビルダにロードする際に、プロジェクトは直前に保存した状態に戻ります。割り当てられた構造が何であっても、すべてのソースファイルが利用できます。

ワークスペース表示

コードビルダのワークスペース表示は次の、6つのフォルダがあります。

1. Apps
2. Project
3. System
4. Temporary
5. User [AutoLoad]
6. User

ワークスペース表示

各フォルダ内のファイルは、次のように異なるイベントでコンパイルリンクします。

Appsワークスペース、パッケージフォルダ

このフォルダはパッケージを管理するために使用されます。このフォルダにはフォルダのみが含まれており、各フォルダはAppsフォルダ内のディスクフォルダを表します。

• 「Apps」フォルダのコンテキストメニュー

Appsフォルダを右クリックすると、次の2つの項目を含むコンテキストメニューが表示されます。

1. 既存フォルダの追加...
2. 新規作成

1つ目はAppsフォルダに既に存在するフォルダを選択する方法で、2つ目はUntitledという名前の新しいフォルダを作成する方法で、AppsフォルダにUntitledという名前の新しいディスクフォルダも作成する方法です。新規作成メニューを繰り返し選択するとUntitledフォルダが複数作成されます。

• 各パッケージフォルダのコンテキストメニュー。

  

  1. 新規作成...

     これはフォルダ内にファイルを作成するために使用されます。

  2. ファイルの追加

     フォルダにファイルを追加するのに使用します。各パッケージフォルダは、Appsフォルダ内のディスクフォルダを表します。選択したファイルがまだ Apps Folder\packageFolder\ にない場合は、Apps Folder\packageFolder\ フォルダにコピーされます。

  3. フルパスを表示

     ファイルのフルパスを表示/非表示にします。

  4. 除外扱いとする

     コードビルダーでビルドボタンをクリックしたときに、Appフォルダ内のすべてのファイルがコンパイルリンクされないようにします。

  5. 関係アイテムのロード

     すべての依存Origin CファイルをTemporaryフォルダにロードしてコンパイルします。

  6. 名前の変更

     フォルダの名前を変更します。

  7. 削除

     コードビルダからフォルダを削除します。これは実際にはファイルシステムからフォルダを削除しません。

  8. 複製

     フォルダを複製します。

  9. 生成...

     パッケージマネージャを起動し、パッケージフォルダからファイルを追加します。最後に保存されたときと同じファイルシステムの場所にOPXが存在する場合、そのOPXがロードされ、パッケージフォルダからすべてのファイルが追加される前にすべてのファイルが削除されます。

  10. ファイルエクスプローラでフォルダを開く

      ファイルエクスプローラでパッケージフォルダを開きます。

  11. iniからOPXを作成

      「package.ini」が存在する場合、package.iniからOPXファイルを生成します。参照[1]

Projectワークスペース、プロジェクトフォルダ

Projectフォルダ内のファイルは、現在のOriginプロジェクトファイル(*.OPJ)に保存されます。それらを含むOriginプロジェクトファイルを開く際に、それらはコードビルダワークスペースのプロジェクトフォルダに追加されます。 それらはプロジェクトファイルを開くと自動的にコンパイルされリンクされます。

Systemワークスペース、システムフォルダ

Systemフォルダ内のファイルは、Windowsフォルダ内に外部的に保存されます（通常はOrigin Cフォルダまたはそのサブフォルダの1つ）。それらは、自動的にコードビルダワークスペースのSystemフォルダに追加され、Originが起動したときにコンパイル、リンクされます。

Temporaryワークスペース、一時フォルダ

Project, System, Userフォルダ内にリストされていないすべてのファイルは、Originを使用しているときにロードされ、コンパイルされ、Temporaryフォルダに表示されます。 例えば、グラフをエクスポートする場合、グラフエクスポートを取り扱うために使われるすべてのファイルは、Temporaryフォルダに現れます。

User [AutoLoad]ワークスペース、ユーザフォルダ

このフォルダは、次で説明するUser Folder に似ています。相違点としては、手動でのコンパイルリンクが必要ないことです。このフォルダ内のファイルは、Origin起動時に自動的にコンパイルリンクされ、このフォルダ下のファイルで定義された関数が利用可能になります。

Userワークスペース、ユーザフォルダ

User フォルダ内のファイルはWindowsフォルダ内に外部保存され、コードビルダワークスペースのUserフォルダに手動で追加されます。コンパイルとリンクは、ユーザがコードビルダで行います。

Notes: AppsフォルダとUser [AutoLoad]フォルダの内容はすべてのOriginセッションをまたいで保持され、Projectフォルダの内容は各プロジェクトファイル(OPJ)に固有です。

コードビルダのクイックスタートコードビルダ

コードビルダの使用を開始するには：

1. キーボードでAlt+4を押すか、コードビルダボタンをクリックして、コードビルダを開きます。
2. ソースファイルの新規作成 Ctrl+Nを押すか、新規ツールバーボタンをクリックして、新しいソースコードファイルを作成します。 新規ファイルダイアログが開いたら、ソースコードファイルの名前を入力し、Enterキーを押すかOKボタンをクリックします。
3. エディタウィンドウが開きます。 エディタウィンドウの最後の行の末尾に移動し、Enterキーを押して新しい空白行を開始します。 次の関数を入力します。

   void HelloWorld()
   {
   	printf("Hello World, from Origin C\n");
   }

4. コードを呼び出す前にコンパイルしてリンクする必要があります。Shift+F8を押すか、ツールバーのビルドボタン をクリックして、コンパイルおよびリンクすることができます。
5. 出力ウィンドウにコンパイルとリンクの進行状況が表示されます。 エラーが表示された場合は、関数を再確認してエラーを修正します。 エラーが表示されなければ、関数を呼び出す準備ができています。
6. 関数、実行コマンド-結果ウィンドウの上部をクリックします。 関数に引数は必要ないため、HelloWorldまたはHelloWorld()を入力してEnterキーを押します。 コマンド-結果ウィンドウの下部には、入力した行の繰り返しが表示され、その後に関数の出力行が表示されます。

これらのステップはコードビルダーを使用するのに十分なものですが、Origin Cファイルを効率よく記述したり、デバッグや実行の助けとなる多くの詳細設定があります。 これらについては、後に続くセクションで説明しています。