FreeBSD Manual Pages
bin2c(1) hxtools bin2c(1) Name bin2c -- embed data files into C as variables Syntax bin2c [-C program-file] [-D dir_prefix] [-H header-file] [-G guard- name] [-p num] [-v] [--ultra] [--wxbitmap] file... Description bin2c converts files to C variables. It does so by reading the contents of each file supplied on the argument line and writes out C program code that defines a variable with the file's contents. hxtools's bin2c implementation supports: • space-efficient encoding of the arbitrary data • multiple input files • creation of either a standalone .h file, or a .c/.h file pair. (See examples below.) Options -C file If specified, causes the variable definition to be emitted to the given filename. -D dir_prefix All filenames on the command line will be prefixed with the given directory. This has the implication that files will be searched relative to dir_prefix, while the variable name ending up in the C source for an image will remain non-prefixed. -G name Request that an include guard by the identifier guard-name is emitted into the header file. If -C was specified and a .c/.h pair is generated, an include guard is always emitted, and the -G option can be used to set that name. -H file The file where the variable declarations will be emitted to. If -C was not specified, h-file will not contain any header guard by default, and it will contain the variable definition, the latter of which will be marked as static (file scope). -p num Strip num leading path components when transforming input paths to variable names. If num is negative, that many trailing path components are retained. If -p is not specified, the default is -1. -v Be verbose. Show all the names and filenames that bin2c will write. --ultra Writeout the raw data as a string literal. As the literal con- tains a trailing NUL byte, the size of the array is necessarily also one byte longer than the raw data, which you need to ac- count for. (In C, it would be possible to write char x[3] = "ABC", but this leads to an error in C++ where x[4] is re- quired.) --wxbitmap Generate C++ code that generates wxBitmap objects. (Implies Ul- tra encoding, and deals with it appropriately, too.) Examples To generate a single C header file that behaves like XPM files and which is suitable for inclusion into a C program file of your own: bin2c -H images.h foo.png bar.png To generate a .c/.h pair instead, the invocation is: bin2c -C images.c foo.png bar.png This will create a C program file "images.c" containing all the defini- tions and a "images.h" that your code can use to get ahold of the dec- larations. History hxtools's bin2c developed from the earlier png2wx.pl utility. See also hxtools(7) hxtools 2013-09-29 bin2c(1)
Name | Syntax | Description | Options | Examples | History | See also
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bin2c&sektion=1&manpath=FreeBSD+Ports+15.0>