Go to the first, previous, next, last section, table of contents.

windres

windres may be used to manipulate Windows resources.
windres는 Windows 리소스를 다룬다.

Warning: windres is not always built as part of the binary utilities, since it is only useful for Windows targets.
주의! windres은 Windows 타겟에서만 사용하기 때문에 컴파일시 생성되지 않을 수 있다.

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

windres reads resources from an input file and copies them into an output file. Either file may be in one of three formats:

windres는 입력 파일에서 리소스를 읽어서 출력 파일로 복사한다. 각 파일은 다음 세 형식 중 하나이다.

rc: A text format read by the Resource Compiler.
리소스 컴파일러가 읽는 텍스트 형식
res: A binary format generated by the Resource Compiler.
리소스 컴파일러가 생성하는 이진 형식
coff: A COFF object or executable.
COFF 오브젝트 혹은 실행파일

The exact description of these different formats is available in documentation from Microsoft.

When windres converts from the rc format to the res format, it is acting like the Windows Resource Compiler. When windres converts from the res format to the coff format, it is acting like the Windows CVTRES program.

When windres generates an rc file, the output is similar but not identical to the format expected for the input. When an input rc file refers to an external filename, an output rc file will instead include the file contents.

각 형식의 자세한 설명은 Microsoft의 문서를 참고하라.

windres가 rc 형식을 res 형식으로 변환할 때 Windows 리소스 컴파일러와 같이 행동한다. res 형식을 coff 형식으로 변환할 때 Windows CVTRES 프로그램 같이 행동한다.

windres이 생성한 rc 파일은 입력으로 사용할 수 있는 형식과 비슷하지만 동일하지는 않다. 입력 rc 파일이 다른 파일명을 참조한다면 출력 rc 파일은 대신 그 파일 내용을 직접 포함한다.

If the input or output format is not specified, windres will guess based on the file name, or, for the input file, the file contents. A file with an extension of `.rc' will be treated as an rc file, a file with an extension of `.res' will be treated as a res file, and a file with an extension of `.o' or `.exe' will be treated as a coff file.

If no output file is specified, windres will print the resources in rc format to standard output.

The normal use is for you to write an rc file, use windres to convert it to a COFF object file, and then link the COFF file into your application. This will make the resources described in the rc file available to Windows.
입출력 형식을 지정하지 않으면 파일명과 (입력 파일의 경우) 파일 내용을 보고 판단한다. 확장자가 `.rc'인 파일은 rc 파일로 취급되고, `.res'는 res 파일로, `.o'나 `.exe'는 coff 파일로 취급된다.

출력 파일을 지정하지 않으면 rc 형식으로 표준출력에 출력한다.

보통 rc 파일을 작성하여 windres으로 COFF 오브젝트 파일로 변환한 후 프로그램과 같이 링크하게 된다. 그래서 rc 파일에 기술된 리소스를 Windows가 사용하게 된다.

-i filename
--input filename: The name of the input file. If this option is not used, then windres will use the first non-option argument as the input file name. If there are no non-option arguments, then windres will read from standard input. windres can not read a COFF file from standard input.
입력 파일 이름. 이 옵션을 사용하지 않으면, 옵션이 아닌 첫번째 아규먼트를 입력 파일 이름으로 사용한다. 만약 이런 아규먼트가 없다면 표준입력을 읽는다. windres은 표준입력으로 COFF 파일을 읽지 못한다.
-o filename
--output filename: The name of the output file. If this option is not used, then windres will use the first non-option argument, after any used for the input file name, as the output file name. If there is no non-option argument, then windres will write to standard output. windres can not write a COFF file to standard output.
출력 파일 이름. 이 옵션을 사용하지 않으면, (입력 파일 이름으로 사용할 것 다음의) 옵션이 아닌 첫번째 아규먼트를 출력 파일 이름으로 사용한다. 만약 이런 아규먼트가 없다면 표준출력으로 출력한다. windres은 표준출력으로 COFF 파일을 출력하지 못한다.
-I format
--input-format format: The input format to read. format may be `res', `rc', or `coff'. If no input format is specified, windres will guess, as described above.
입력 형식. format은 `res', `rc', `coff' 중 하나이다. 입력 형식이 지정되지 않으면 위에서 설명한데로 추측한다.
-O format
--output-format format: The output format to generate. format may be `res', `rc', or `coff'. If no output format is specified, windres will guess, as described above.
출력 형식. format은 `res', `rc', `coff' 중 하나이다. 출력 형식이 지정되지 않으면 위에서 설명한데로 추측한다.
-F target
--target target: Specify the BFD format to use for a COFF file as input or output. This is a BFD target name; you can use the --help option to see a list of supported targets. Normally windres will use the default format, which is the first one listed by the --help option. section Target Selection.
입출력으로 사용할 COFF 파일의 BFD 형식을 지정한다. 이는 BFD 타겟 이름이다. 지원하는 타겟은 --help 옵션으로 알 수 있다. 보통의 경우 --help 옵션에서 처음에 나오는, 기본 형식을 사용한다.
--preprocessor program: When windres reads an rc file, it runs it through the C preprocessor first. This option may be used to specify the preprocessor to use, including any leading arguments. The default preprocessor argument is gcc -E -xc-header -DRC_INVOKED.
rc을 읽을 때 먼저 C 전처리기를 통과시킨다. 이 옵션으로 전처리기와 사용할 아규먼트를 지정한다. 기본 전처리기와 아규먼트는 gcc -E -xc-header -DRC_INVOKED이다.
--include-dir directory: Specify an include directory to use when reading an rc file. windres will pass this to the preprocessor as an -I option. windres will also search this directory when looking for files named in the rc file.
rc 파일을 읽을 때 사용할 인클루드 디렉토리를 지정한다. windres는 이를 -I 옵션으로 전처리기에 전달한다. 또 rc 파일에 나오는 파일을 찾기 위해서 이 디렉토리를 검사한다.
-D sym[=val]
--define sym[=val]: Specify a -D option to pass to the preprocessor when reading an rc file.
rc 파일을 읽을 때 전처리기에 넘겨줄 -D 옵션을 지정한다.
-v: Enable verbose mode. This tells you what the preprocessor is if you didn't specify one.
자세하게 출력한다. 전처리기를 지정할지 않았을 때 어떤 것이 사용되는지 알려준다.
--language val: Specify the default language to use when reading an rc file. val should be a hexadecimal language code. The low eight bits are the language, and the high eight bits are the sublanguage.
rc 파일을 읽을 때 사용할 기본 언어를 지정한다. val은 16 진수의 언어 코드이다. 낮은 8 비트가 언어이고, 높은 8 비트는 부수언어이다.
--use-temp-file: Use a temporary file to instead of using popen to read the output of the preprocessor. Use this option if the popen implementation is buggy on the host (eg., certain non-English language versions of Windows 95 and Windows 98 are known to have buggy popen where the output will instead go the console).
전처리기의 출력을 popen으로 읽지 않고 임시 파일을 사용한다. 호스트의 popen 구현에 버그가 많은 경우 이 옵션을 사용한다. (어떤 비영어권 Window 95와 Window 98에서 popen은 출력을 콘솔로 보낸다.)
--no-use-temp-file: Use popen, not a temporary file, to read the output of the preprocessor. This is the default behaviour.
전처리기의 출력을 읽기 위해서 임시 파일을 사용하지 않고 popen을 사용한다. 이것이 기본 행동이다.
--help: Prints a usage summary.
사용법을 간단히 출력한다.
--version: Prints the version number for windres.
windres의 버전을 출력한다.
--yydebug: If windres is compiled with YYDEBUG defined as 1, this will turn on parser debugging.
windres가 YYDEBUG을 1로 컴파일된 경우, 파서의 디버깅을 작동시킨다.

Go to the first, previous, next, last section, table of contents.