12 windres

windresは，Windowsのリソースを操作することに使用することが可能です．

警告: windresは，Windowsターゲットに対してのみ役に立 つので，常にバイナリユーティリティの一部としてビルドされるわけではあり ません．

     
     windres [options] [input-file] [output-file]
     

windresはリソースを入力ファイルから読み込み，それを出力ファ イルにコピーします．ファイルは以下の三つの形式のいずれか一つが可能です．

rc

リソースコンパイラで読み込むテキスト形式．

res

リソースコンパイラが生成したバイナリ形式．

coff

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で利用可能にします．

-i filename

--input filename

入力ファイル名です．このオプションが使用されていない場合， windresは，最初の非オプションの引数を入力ファイル名として使 用します．非オプションの引数がない場合，windresは，標準入力 から読み込みます．windresは，COFFファイルを標準入力から読み 込むことは不可能です．

-o filename

--output filename

出力ファイル名です．このオプションが使用されない場合， windres は，入力ファイル名として使用した後の，最初の非オプショ ンの引数を出力ファイル名として使用します．非オプションの引数がない場合， windres は，標準出力に書き出します．windresは， COFFファイルを標準出力に書き出すことは不可能です．rcとの互換 性のため，オプション-foも受け入れますが，その使用方法は推奨さ れていないことに注意して下さい．

-J format

--input-format format

読み込む入力の形式です．formatは，`res'，`rc'，または `coff'が可能です．入力形式が指定されない場合，windresは， 上記のように推測します．

-O format

--output-format format

生成する出力の形式です．formatは，`res'，`rc'，または `coff'が可能です．出力形式が指定されない場合，windresは， 上記のように推測します．

-F target

--target target

入出力としてのCOFFに対して使用するBFDフォーマットを指定します．これは， BFDターゲット名です．サポートされているターゲットのリストを見るために， --helpオプションが使用することが可能です．通常， windresはデフォルトのフォーマットを使用し，それは --helpオプションでリストアップされる最初のものです． Target Selection.

--preprocessor program

windresがrcファイルを読み込むとき，それは最初にCプリ プロセッサを通じて実行されます．このオプションは，使用するプリプロセッ サを指定するために利用してもかまわず，それには引数を前置するものを含み ます．デフォルトのプリプロセッサ引数は，gcc -E -xc-header -DRC_INVOKED です．

-I directory

--include-dir directory

rcファイルを読み込むとき使用する，インクルードディレクトリを指 定します．windresは，これを-Iオプションとしてプリプ ロセッサに渡します．windresは，rcファイルで指名されて いるファイルを探すとき，このディレクトリの検索も行います．このコマンド に渡された引数が，(-Jオプションで記述されている) サポートされ るformatsにマッチする場合，推奨しない旨の警告を発し，-J オプションのように動作します．新しいプログラムでは，この動作を使用すべ きではありません．ディレクトリがformatにマッチする場合，単純な接 頭辞`./'を用いて下位互換性が無くなるようにして下さい．

-D target

--define sym[=val]

rcファイルを読み込むとき，プリプロセッサに渡す-Dオプショ ンを指定します．

-U target

--undefine sym

rcファイルを読み込むとき，プリプロセッサに渡す-Uオプショ ンを指定します．

-r

rcとの互換性のためで，無視されます．

-v

冗長モードを可能にします．これは，プリプロセッサが指定されていない場合， そのプリプロセッサを報告します．

-l val

--language val

rcファイルを読み込むとき使用する，デフォルトの言語を指定します． valは16進数の言語コードにする必要があります．下位8ビットは言語で， 上位8ビットはサブ言語です．

--use-temp-file

プリプロセッサの出力を読み込むためpopenを使用する代わりに，一時ファイ ルを使用します．popenの実装にバグの多いホストの場合，このオプションを 使用してください(例えば，ある非英語バージョンのWindows95とWindows98は， 出力がコンソールでないところでは，バグの多いpopenとなっていることが知 られています)．

--no-use-temp-file

プリプロセッサの出力を読み込むため，一時ファイルではなくpopenを使用し ます．これはデフォルトの動作です．

-h

--help

使用方法の概要を出力します．

-V

--version

windresのバージョンナンバーを出力します．

--yydebug

windresがYYDEBUGを1と定義してコンパイルされる 場合，パーサデバッグを開始します．