[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

12. windres

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

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

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

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

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

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

coff
COFFオブジェクト,または,実行形式.

これらの形式の差異の正確な記述は,Microsoftのドキュメントで利用可能で す.

windresrc形式からres形式に変換するとき,それ はWindows Resource Compilerのように動作します.windresres形式からcoff形式に変換するとき,それはWindows CVTRESプログラムのように動作します.

windresrcファイルを生成するとき,出力は似ていますが, 入力で期待される形式と同一ではありません.入力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'オプションでリストアップされる最初のものです. 15.1 ターゲットの選択.

--preprocessor program
windresrcファイルを読み込むとき,それは最初に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
windresYYDEBUG1と定義してコンパイルされる 場合,パーサデバッグを開始します.


[ << ] [ >> ]           [Top] [Contents] [Index] [ ? ]

This document was generated by Akihiro Sagawa on March, 3 2004 using texi2html