windresは,Windowsのリソースを操作することに使用することが可 能です.
警告: windresは,Windowsターゲットに対してのみ役に立つ ので,常にバイナリユーティリティの一部としてビルドされるわけではありま せん.
windres [options] [input-file] [output-file]
windresはリソースを入力ファイルから読み込み,それを出力ファイ ルにコピーします.ファイルは以下の三つの形式のいずれか一つが可能です.
rc
res
coff
これらの形式の差異の正確な記述は,Microsoftのドキュメントで利用可能です.
windresがrc
形式からres
形式に変換するとき,それ
はWindows Resource Compilerのように動作します.windresが
res
形式からcoff
形式に変換するとき,それはWindows
CVTRES
プログラムのように動作します.
windresがrc
ファイルを生成するとき,出力は似ていますが,
入力で期待される形式と同一ではありません.入力rc
ファイルが外部の
ファイル名を参照するとき,出力rc
ファイルは,その代わりにファイル
の内容を含めます.
入力や出力の形式が指定されていない場合,windresはファイル名,
または,入力ファイルのファイルの内容を基に推測します..rcの拡張
子を持つファイルは,rc
ファイルとして扱われ,.resの拡張子
を持つファイルは,res
ファイルとして扱われ,そして,.oや
.exeの拡張子を持つファイルは,coff
ファイルとして扱われま
す.
出力ファイルが指定されない場合,windresは,rc
形式内の
リソースを標準出力に出力します.
rc
を書き,COFFオブジェクトファイルに変換するために
windresを使用し,COFFファイルをアプリケーションにリンクするの
が通常の使用方法です.これは,rc
ファイルのリソースの記述を,
Windowsで利用可能にします.
rc
ファイルを読み込むとき,それは最初にCプリプ
ロセッサを通じて実行されます.このオプションは,使用するプリプロセッサ
を指定するために利用してもかまわず,それには引数を前置するものを含みま
す.デフォルトのプリプロセッサ引数は,gcc -E -xc-header
-DRC_INVOKED
です.
rc
ファイルを読み込むとき使用する,インクルードディレクトリを指定
します.windresは,これを-Iオプションとしてプリプロ
セッサに渡します.windresは,rc
ファイルで指名されてい
るファイルを探すとき,このディレクトリの検索も行います.このコマンドに
渡された引数が,(-Jオプションで記述されている) サポートされる
formatsにマッチする場合,推奨しない旨の警告を発し,-J オ
プションのように動作します.新しいプログラムでは,この動作を使用すべき
ではありません.ディレクトリがformatにマッチする場合,単純な接頭
辞‘./’を用いて下位互換性が無くなるようにして下さい.
rc
ファイルを読み込むとき,プリプロセッサに渡す-Dオプショ
ンを指定します.
rc
ファイルを読み込むとき,プリプロセッサに渡す-Uオプショ
ンを指定します.
rc
との互換性のためで,無視されます.
rc
ファイルを読み込むとき使用する,デフォルトの言語を指定します.
valは16進数の言語コードにする必要があります.下位8ビットは言語で,
上位8ビットはサブ言語です.
YYDEBUG
を1
と定義してコンパイルされる場
合,パーサデバッグを開始します.