- 2009/04/19 - Version 1.13 released (download) - Changes: Now compiles on Mac OSX; Added functions TwGetParam and TwSetParam; Arrow keys and Return key can now be used to navigate and tweak values; Added functions TwGetBarCount, TwGetBarByIndex, TwGetBarByName, TwRefreshBar; more...
- 2008/09/27 - Version 1.12 released - Changes: Added new var types TW_TYPE_QUAT* and TW_TYPE_DIR* allowing for the interactive tweaking of rotations (through quaternions) and 3D vectors (directions); Better management of transparent tweak bars; more...
- 2007/12/10 - Version 1.11 released - Changes: Add support for DirectX 10 in addition to OpenGL and DirectX 9, and a new example that uses DirectX 10; Added a new example that illustrates the use of the string variables; Cleanup the Help bar; more...
- News archive

AntTweakBar is a small and easy-to-use C/C++ library that allows programmers to quickly add a light and intuitive graphical user interface into graphic applications based on OpenGL, DirectX 9 or DirectX 10 to interactively tweak their parameters on-screen.

Program variables can be bound to graphical controls that allow users to modify them. Thus, parameters exposed by programmers can be easily modified. They are displayed into the graphical application through one or more embedded windows called tweak bars.

The AntTweakBar library mainly targets graphical applications that need a quick way to tune parameters (even in fullscreen mode) and see the result in real-time like 3D demos, games, prototypes, inline editors, debug facilities of weightier graphical applications, etc.

The library is designed to minimize programmer's work while offering a fast, clean, intuitive and non-intrusive graphical interface. For instance, numerical values are automatically mapped to a RotoSlider control for rapid editing.

It is composed of few easy-to-learn functions. Common variables like booleans, integers, floats and enums can be directly mapped to a graphic control through pointers or callback functions. Additional editing information like min and max values can be provided. Keyboard shortcuts can also be associated to controls and a help window which summarizes these shortcuts can be displayed. Programmers are not required to design the graphical interface by providing coordinates or by using a visual UI editor. Controls are automatically organized following an optional given hierarchy. In most cases, only one line of code is needed to add a new variable to a tweak bar.

While the library itself is written in C++, its programming interface is a C interface, and then it can be directly integrated in any C++ or C program.

It has been designed with performance in mind. Embedded in a typical 3D application, its rendering time is almost insignificant. Bars can also be iconified to fully minimize their rendering time.

AntTweakBar works with GNU/Linux and Windows, and can be easily integrated with your own windowing system or with existing toolkits. Examples of integration with GLFW, SDL, GLUT and DirectX are provided.

AntTweakBar is free to use and redistribute. See license for details.

• Download the latest version of the AntTweakBar library. It includes the header file and the library (compiled in binary formats + sources), as well as examples provided as source code and executable binaries.

• Tutorial: How to integrate AntTweakBar into your application.
• Examples: Some commented programs.
• Reference: Use the index (on the top-left side of this page) to browse the documentation.

• This website has been developed with DokuWiki.
• As other wikis, its content can be edited. Feel free to log in. Your help is welcome to improve this documentation (or to correct my english ).
• I am developing this project in my spare time, and your support (screenshots, links to this website, feedback, doc improvements, recommendations,...) is well appreciated. — Philippe