VisIt developers use several xml-based code generation tools to implement VisIt's features. The source core for these tools is kept in src/tools/dev/xml/
and src/tools/dev/xmledit/
.
We rely on xml code generation to keep our State object, Attribute, and Plugin APIs up-to-date. To automate the process we provide CMake targets that call our xml code generation tools for each object or plugin registred. Individual code gen targets are all wired into top level targets that allow you to apply the code gen tools to categories of code gen tasks. These targets replace older tools such as regen-ajp and various regenerateatts.py scripts.
CMake Target | Target Action |
---|---|
gen_cpp_all |
|
gen_python_all |
|
gen_java_all |
|
gen_info_all |
|
gen_cmake_all |
|
gen_plugin_all |
|
These are the helper functions we use to create targets that call xml tools in our CMake build system.
XML Tools Helper functions in src/CMake/VisItMacros.cmake
:
CMake Function | Target Action |
---|---|
ADD_CPP_GEN_TARGET |
|
ADD_PYTHON_GEN_TARGET |
|
ADD_JAVA_GEN_TARGET |
|
ADD_INFO_GEN_TARGET |
|
ADD_CMAKE_GEN_TARGET |
|
The xml2plugin and xml2avt tools are only called when you first create a new plugin or object, they are not exposed here.
Plugin Tools Helper functions in src/CMake/PluginMacros.cmake
:
- ADD_PLUGIN_CODE_GEN_TARGETS - wires up:
- ADD_CPP_GEN_TARGET
- ADD_PYTHON_GEN_TARGET
- ADD_JAVA_GEN_TARGET
- ADD_INFO_GEN_TARGET
- ADD_CMAKE_GEN_TARGET
- ADD_DATABASE_CODE_GEN_TARGETS - wires up:
- ADD_INFO_GEN_TARGET
- ADD_CMAKE_GEN_TARGET
- ADD_OPERATOR_CODE_GEN_TARGETS - alias for ADD_PLUGIN_CODE_GEN_TARGETS
- ADD_PLOT_CODE_GEN_TARGETS - alias for ADD_PLUGIN_CODE_GEN_TARGETS
VISIT_CMAKE_VERBOSE_GEN_TARGET_MESSAGES (default: OFF) When enabled display messages about code gen targets during CMake configure time.