|Version 3 (modified by David Callu, 10 years ago)|
Maco Jez's genwrapper is a utiltiy program that reads C++ header files and then automatically generates osgWrapper code from to use alongside osgIntrospection.
Latest development available in subversion:
- svn checkout http://www.openscenegraph.org/svn/genwrapper/trunk genwrapper
Package for the last release:
GenWrapper was created as an 'ad-hoc' tool to support the development of osgIntrospection and it was never intended to be used with anything other than OSG source files, nor it was designed to meet requirements other than the author's ones. GenWrapper was tested on the OSG source tree ONLY and it's not known to work with anything else. If you want to use GenWrapper on your own application's source tree, try to follow OSG coding conventions and directory layout in order to minimize the risk of failure. GENWRAPPER MAY OVERWRITE AND DESTROY YOUR FILES, USE AT YOUR OWN RISK. ALWAYS MAKE BACKUPS!!!
HOW IT WORKS
Wrappers are generated from a two-phases process. The first phase requires an XML description of source files to be created with Doxygen (GenWrapper can build a Doxyfile for you). In the second phase GenWrapper takes the XML input and generates C++ introspection wrappers and optionally GNU makefiles and VS6 project files.
- genwrapper -h | -?
- genwrapper -d path_to_osg [doxy_dir]
- genwrapper [-c config_file] [-v level] [-p] [-m] [-l] [doxy_dir] output_dir
show help screen.
directory where XML files generated by Doxygen are stored. Default is the system-wide temporary directory, if available.
output directory where wrappers should be written. May be the same as the source directory (path_to_osg).
loads the specified configuration file. This option can be repeated multiple times. If no configuration files are specified, genwrapper.conf in the GenWrapper directory will be used.
specify the verbosity level. May be one of: QUIET, ERROR, WARNING, NOTICE, INFO, DEBUG.
enable creation of VS6 project files.
enable creation of GNU makefiles.
enable creation of change lists (see notes below).
Create wrappers for OpenSceneGraph: -> ./genwrapper -d /path/to/osg | Doxygen - -> ./genwrapper /path/to/osg
- GenWrapper only overwrites files whose content has actually changed.
- Wrapper files are written into output_dir/src/osgWrappers.
- VS6 project files are written into output_dir/VisualStudio/osgWrappers.
- Change lists (option -l) are created as three text files for each target directory. Such files are named "removed.gw" (list of removed files), "added.gw" (list of added files) and "modified.gw" (list of modified files).
- Tested Doxygen version is 1.4.1. GenWrapper may not work with other versions.
Use, distribute, copy, modify, squeeze, trash... Do anything you wish :)