Eclipse を用いて，Windows の Cygwin 上 MagickWand を扱う C プログラムを開発（Windows 上）

このページでは，Eclipse を使い，MagickWand 経由で ImageMagick の機能を呼び出すような C プログラムを作る手順を図解で説明する． JMagick のインストール手順も説明する．

前準備

Java 25（Temurin 25 JDK）のインストール

Eclipse Temurin（Adoptium）のインストールを行い、Javaのプログラムをコンパイル・実行する環境を整える。扱う環境は、Windows搭載パソコンである。現時点(2026年6月)での最新LTS版である Java 25（Temurin 25 JDK）を推奨する。

[Windows での Java 25（Temurin 25 JDK）のインストール手順を見るには、ここをクリック]

Windows での Java 25（Temurin 25 JDK）のインストール

以下のいずれかの方法で Java 25（Temurin 25 JDK）をインストールする。JDKがインストール済みの場合、この手順は不要である。

方法 1：winget によるインストール

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。そして、コマンド全体をコマンドプロンプトにコピー＆ペーストする。

Temurin の Windows インストーラー（.msi）は、ユーザー単位ではなくマシン単位でインストールされる（1台に1つのインストール）。そのため、システム全体（全ユーザー向け）にインストールするには管理者権限が必要である。インストール完了後、コマンドプロンプトを再起動するとPATHが反映される。

REM Java 25（Temurin 25 JDK） をインストール（PATH と JAVA_HOME を更新）
winget install --id EclipseAdoptium.Temurin.25.JDK -e --silent --accept-source-agreements --accept-package-agreements --override "ADDLOCAL=FeatureMain,FeatureEnvironment,FeatureJarFileRunWith,FeatureJavaHome INSTALLDIR=\"C:\Program Files\Eclipse Adoptium\jdk-25\" /quiet"

上記の --override 内の指定の意味は次のとおりである。FeatureEnvironment はPATH環境変数の更新、FeatureJavaHome は JAVA_HOME 環境変数の更新、FeatureJarFileRunWith は .jar ファイルとJavaアプリケーションの関連付けである。INSTALLDIR はインストール先フォルダの指定である。

方法 2：インストーラーによるインストール

Adoptium公式サイト（https://adoptium.net/temurin/releases/）にアクセスし、Version として「25 - LTS」、Operating System として「Windows」を選び、.msi 形式のWindows用インストーラーをダウンロードする。
ダウンロードした .msi ファイルを実行し、インストールプログラムを起動する。
ライセンス条項を確認し、同意できる場合はチェックを入れて次へ進む。
「Installation Scope」画面では「Install for all users of this machine」を選ぶ
「Custom Setup（カスタムセットアップ）」画面で、インストールする機能を選択する。既定では「Add to PATH（PATH環境変数への追加）」と「Associate .jar」（.jarファイルの関連付け）が有効になっている。さらに、ツリー内でバツ印（×）が付いている「Set JAVA_HOME variable（JAVA_HOME環境変数の更新）」をクリックして有効に変更することを推奨する。これらを有効にしないと、コマンドプロンプトから java コマンドを実行できなかったり、開発ツールがJDKを見つけられなかったりする。
「次へ (Next)」をクリックし、続いて「インストール (Install)」をクリックしてインストールを開始する。完了後「Finish」で閉じる。

インストールの確認

コマンドプロンプトで以下を実行する。

java --version

バージョン番号（例：openjdk 25.x.x）が表示されればインストール成功である。「'java' は、内部コマンドまたは外部コマンドとして認識されていません。」と表示される場合は、インストールが正常に完了していないか、PATHが反映されていない（コマンドプロンプトを再起動して再度確認する）。

あわせて、コンパイラと JAVA_HOME も確認しておくとよい。

javac --version
echo %JAVA_HOME%

Eclipse のインストール

Eclipse をインストールする。扱う環境は、Windows搭載パソコンである。

[Windows での Eclipse のインストール手順を見るには、ここをクリック]

Windows での Eclipse のインストール

以下のいずれかの方法で Java 25（Temurin 25 JDK）をインストールする。JDKがインストール済みの場合、この手順は不要である。

方法 1：winget によるインストール

【インストールコマンドの実行方法】

管理者権限でコマンドプロンプトを起動する（手順：Windowsキーまたはスタートメニュー → cmd と入力 → 右クリック → 「管理者として実行」）。そして，コマンド全体をコマンドプロンプトにコピー＆ペーストする。

REM Temurin 25 JDK をインストール
winget install --id EclipseAdoptium.Temurin.25.JDK -e --accept-source-agreements --accept-package-agreements

winget が使えない場合や，インストール先・パッケージ種類を画面で選びながら導入したい場合は，次の方法を用いる。

方法 2：インストーラーによるインストール

公式サイトからダウンロードしてインストールできる。詳しくはhttps://www.kkaneko.jp/tools/win/eclipse.htmlで説明している。

Eclipse の初期設定、使用方法の基本

詳しくはhttps://www.kkaneko.jp/tools/win/eclipse.htmlで説明している。

その他の準備

Cygwin の Web ページの記述に従って，Cygwin のインストールが済んでいること．
C:\cygwin\bin\cygwin1.dll を C:\Windows\System32 にコピーしておくこと．
「Eclipse に CDT プラグインをインストール」の Web ページの記述に従って，CDT プラグインのインストールが済んでいること．
Windows の環境変数 PATH が「C;\Cygwin\usr\bin」を含むこと．

Eclipse の基本操作

基本操作として，新規プロジェクトの作成，C プログラムの作成, 保存, 実行を試す．

あらかじめ決めておく事項

プロジェクト名： Hello
プロジェクト・タイプ： 実行可能

プロジェクトの新規作成

下記の手順で，プロジェクトを新規に作成する．

プロジェクトを作成すると，ワークスペースのディレクトリ（C:\workspace）の下に，プロジェクトのディレクトリができる．プロジェクトのディレクトリの下には，デフォルトでは，Debug, src の２つのサブディレクトリができる．

プロジェクトの新規作成の開始
「ファイル」→「新規 (New)」→「プロジェクト (Project)」
または，パッケージ・エキスプローラ内で，右クリック→「新規 (New)」→「プロジェクト (Project)」
「C」の展開
新規プロジェクトのウインドウが開くので，「C」を展開する．
「C プロジェクト」の選択
展開した「C」の下にある「C プロジェクト」を選び，「次へ」をクリック．
プロジェクト名とプロジェクトタイプの指定
新規Cプロジェクトのウインドウが開くので，プロジェクト名と プロジェクト・タイプを指定する．
- プロジェクト名
  プロジェクト名には好きにつけて良いが，全角文字は避ける．分かりやすい名前が良い．
- プロジェクトタイプ
  static ライブラリー，共有ライブラリー，実行可能，Makefile プロジェクトから選べる．ここでは，実行可能を展開し，Hello World ANSI C プロジェクト選ぶ．
終わったら，「次へ」をクリック
基本設定
基本設定はデフォルトのままでよい．「次へ」をクリック
構成の選択
基本設定はデフォルトのままでよい．「完了」をクリック

ソース・ファイルの作成

ソース・ファイルの確認
パッケージ・エクスプローラで，プロジェクトHelloの srcを展開すると，ソース・ファイルの一覧が表示される．
* Hello World ANSI C プロジェクト選んだので，Hello.c がすでに出来ている．
ソース・ファイルの編集
パッケージ・エクスプローラで， Hello.cをダブルクリックすると，エディタが開き，ソース・ファイルの編集ができる．
MagickWand のサイトから wand.c を入手し，それをコピーアンドペーストする．
* wand.c は，サムネイル画像を生成するプログラム

プロジェクトの設定

プロジェクトのプロパティーを設定し，MagickWandの機能が使えるようにする．

プロジェクトのプロパティー
Eclipseで，プロジェクトHelloを右クリック．「プロパティー」を選択．出てきたウインドウで，「C/C++ビルド」の下の「設定」を選ぶ．
「ツール設定」タブの「Cygwin C Compiler (Cygwin C コンパイラー)」の下の「その他」について，「その他のフラグ」に，次の設定を追加
```
`MagickWand-config --cflags --cppflags`
```
「ツール設定」タブの「Cygwin C Linker (Cygwin C リンカー)」の下の「その他」について，「リンカー・フラグ」に，次の設定を追加
```
`MagickWand-config --ldflags`
```
Cywgin のコンソールで，「MagickWand-config --libs」を実行し，実行結果をみる．
「ツール設定」タブの「Cygwin リンカー」の下の「ライブラリー」について，「ライブラリー」に，「MagickWand-config --libs」の実行結果を設定する．例えば，「MagickWand-config --libs」の実行結果が「-lMagickWand -lMagickCore -lgdi32 -lfreetype」の場合は，「MagickWand」，「MagickCore」，「z」，「freetype」の4つを設定する．

ビルド

すべてビルド
CTRL + B（コントロールキーを押しながら「B」）または，「プロジェクト」メニューで「すべてビルド」
* ビルド時のエラーや警告があれば， Eclipse 内の問題・ビューに表示されるので確認する．問題・ビューのエラー一覧の中で，エラーをクリックすると該当箇所が強調表示される．

実行

デフォルトでは，実行ファイルは， C:\workspace\Hello\Debug\Hello.exe に出来る．（「Hello」はプロジェクト名）

Cygwin のコンソールで次のように実行．サムネイル画像である t.png が生成されていれば成功．（bluebells_clipped.jpg は，/usr/share/doc/ImageMagick-6.4.0.6/images/bluebells_clipped.jpg をコピーしておく）

cp /cygdrive/d/workspace/Hello/Debug/Hello.exe .
./Hello.exe bluebells_clipped.jpg t.png

* 実行がうまくいかない場合， C:\cygwin\bin\cygwin1.dll を C:\Windows\System32 にコピーすることを忘れている可能性がある．