====== Hello World ======
[[fltk:|{{:fltk:fltk_shadow.png?200|}}]]

このページでは、FLTKを利用した小さなプログラムを作成します。
C++コードの内容を理解することよりも、ビルド（コンパイルとリンク）のやり方を理解することに重点を置きます。
まずはコマンドラインから手動でGCCのコマンドを実行する方法を紹介します。
この方法さえを理解してしまえば、Makefileを書くにもIDEの設定を行うにもに苦労せずにすむかと思います。
===== 前提 =====
[[install|FLTKのインストール]]に従って、FLTK 1.4.3が $HOME/MikanBox 以下にインストールされているものとします。
違う場所にインストールした場合は((違う場所であっても全く問題ありません。))、パスをご自身のものに置き換えてください。


===== 作業ディレクトリの用意 =====
作業ディレクトリは $HOME/code/fltk/hello-fltk とします。
ここに作成するプログラムのソースコードを保存して、また、ここでビルドを行います。

<note>
こういった名前やパスは、何かしら決めておかないと説明がしづらいので提示しているだけです。
同じ名前にする必要は全くありません。
ご自身の好みの場所に好きな名前で作成してください。
</note>

まずディレクトリを作成して、そこに移動しておきます。

<cli>
$ mkdir -p ~/code/fltk/hello-fltk
$ cd $_
</cli>


===== プログラムのソースコード =====
今回作成するプログラムのソースコードは、FLTKのマニュアルにあるものをそのまま拝借します。

  * https://www.fltk.org/doc-1.4/basics.html

__main.cpp__:

<code cpp>
/********************************************/
/* https://www.fltk.org/doc-1.4/basics.html */
/********************************************/

#include <FL/Fl.H>
#include <FL/Fl_Window.H>
#include <FL/Fl_Box.H>

int main(int argc, char **argv) {
  Fl_Window *window = new Fl_Window(340, 180);
  Fl_Box *box = new Fl_Box(20, 40, 300, 100, "Hello, World!");
  box->box(FL_UP_BOX);
  box->labelfont(FL_BOLD + FL_ITALIC);
  box->labelsize(36);
  box->labeltype(FL_SHADOW_LABEL);
  window->end();
  window->show(argc, argv);
  return Fl::run();
}
</code>

かなり直感的なものであるとは思います。
もしそうでなくて意味不明だったとしても、問題ありません。
このコードを素材に、FLTKアプリケーションのビルド手順を体験するのが今回の目的です。
コードの意味については今後よく吟味します。((さしあたってnewによって作成したオブジェクトをdeleteしていないことに疑念を抱かれかるもしれませんが、これが現実で問題になることはありません。FLTKはそのように作られています。))

===== コンパイル =====
コンパイルとリンクを一度に行うこともできますが、今回は別々に分けて行います。
そのほうが説明しやすいからです。

FLTKには、fltk-configというツール((シェルスクリプトで書かれたユーティリティです。))が付属しています。
pkg-configによく似た使い方をします。
$HOME/MikanBoxにFLTKをインストールしたので、この下のbinディレクトにfltk-configが存在しています。

<cli>
$ ~/MikanBox/bin/fltk-config --version
1.4.3
</cli>

このツールは、指定されたオプションにしたがって、コンパイラ・リンカに渡すフラグをテキストとして出力します。
指定可能なオプションの一覧は[[fltk-config-help|こちら]]。

C++コンパイラに指定するコンパイルフラグを出力するためのオプションは「%%--%%cxxflags」です。

<cli>
$ ~/MikanBox/bin/fltk-config --cxxflags
-I/home/freemikan/MikanBox/include -I/home/freemikan/MikanBox/include/FL/images -D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64 -D_THREAD_SAFE -D_REENTRANT
</cli>

パスのプリフィクスが/home/freemikan/MikanBoxとなっていることに注目してください。
これはインストール時にCMAKE_INSTALL_PREFIXでそう指定したからこのようになっています。

C++コンパイラとしてGCCを利用するので、この出力をそのままg++コマンドに渡してやります。
コピペするより、シェルのコマンド置き換えを利用したほうがずっと良いです。
コマンド置き換えは ''$(//command ...//)'' とするか ''`//command ...//`''((「`」はバッククォートです)) とします。
具体的には次のようにしてコンパイルします。

<cli>
$ g++ -c main.cpp `~/MikanBox/bin/fltk-config --cxxflags`
</cli>

「-c」は手動で与えている点に注意してください。
これによって、リンクは行わず、コンパイルのみを行うこと指示しています。

==== 結果の確認 ====
コンパイラのオプションに間違いがなく、コンパイルエラーもなければ、何もメッセージは出力されずにコマンドが完了します。
コンパイルされたオブジェクトファイルが生成されているはずなので、それを確認してみましょう。

<cli>
$ ls -l
合計 12
-rw-r--r-- 1 freemikan freemikan  400  5月 23 01:01 main.cpp
-rw-rw-r-- 1 freemikan freemikan 7816  5月 23 01:01 main.o      ←生成されたオブジェクトファイル
</cli>

main.oが存在していればOKです。

===== リンク =====
リンカオプションも同様にfltk-configの助けを借ります。
リンカオプションを出力するfltk-configのオプションは「%%--%%ldflags」です。

<cli>
$ ~/MikanBox/bin/fltk-config --ldflags
-L/home/freemikan/MikanBox/lib -lfltk -lm -lX11 -lXext -lpthread -ldl
</cli>

これをコマンド置き換えでg++に渡してやります。

<cli>
$ g++ -o hello-fltk main.o `~/MikanBox/bin/fltk-config --ldflags`
</cli>

「-o hello-fltk」は、生成する実行可能バイナリファイル名前をhello-fltkとすることを指示しています。
続けて、入力ファイルであるmain.oを指定しています。

<note>
入力ファイルmain.oの位置は意味を持ちます。
リンカオプションより後ろにしてはいけません。

<cli>
$ g++ -o hello-fltk `~/MikanBox/bin/fltk-config --ldflags` main.o
</cli>

これはリンクエラーになります。
</note>


==== 結果の確認 ====
リンクに問題がなければ、何もメッセージは出力されずにコマンドが終了します。
実行可能バイナリファイルが生成されていることを確認しておきましょう。

<cli>
$ ls -l
合計 1644
-rwxrwxr-x 1 freemikan freemikan 1670960  5月 23 01:02 hello-fltk   ←生成された実行可能バイナリファイル
-rw-r--r-- 1 freemikan freemikan     400  5月 23 01:01 main.cpp
-rw-rw-r-- 1 freemikan freemikan    7816  5月 23 01:01 main.o
</cli>

hello-fltkが存在していればOKです。
===== Hello Worldプログラムの実行 =====
最後に、hello-fltkを実行して、問題なくFLTKのウィンドウが表示されることを確認しておきます。

<cli>
$ ./hello-fltk
</cli>

{{ :fltk:fltk_hello.jpg |Hello FLTK!}}

このようなルック・アンド・フィールは典型的なFLTKアプリケーションのスタイルです。
あくまで個人的にですが、ややレトロチックで2000年代初頭のような印象を受けます。
逆にそれが良いと思われれば幸いです。