[Introduction]
[Download and Install]
[Documentation]
[Disclaimer]

OOFCanvas is a replacement for libgnomecanvas, designed for use in OOF2, but hopefully useful elsewhere. OOFCanvas is based on Cairo and is compatible with gtk3.

OOF2 used libgnomecanvas to display and interact with images and meshes. But libgnomecanvas requires gtk+2, and gtk+2 works only with Python3, not Python2, and Python2 is being phased out. In order to upgrade OOF2 to Python3, we needed to first upgrade it from gtk+2 to Gtk3, and to do that we needed to first replace libgnomecanvas.

The canvas is a drawing area that can display a variety of shapes, including text. It can be scrolled, zoomed, and printed. Items drawn on the canvas can be selected with the mouse.

OOFCanvas is not a drop-in replacement for libgnomecanvas. It's also not a full-fledged gtk widget. It's a set of classes that does some of what libgnomecanvas did and uses gtk.

All of the code is in C++. Wrappers for Python are generated by SWIG.

1. Click here to download OOFCanvas version 1.1.2. (100083 bytes, compressed; MD5 checksum d90a06217c836f680642d3b57b049310).

2. Install the OOFCanvas prerequisites, which are:

   • CMake, version 3.18 or later.
   • SWIG, version 4.0 or later.
   • pkg-config.
   For the following, if your system provides separate "developer" packages that include headers and other files needed for compilation, install the developer packages:
   • Python, version 3.8 or later.
   • Gtk3, version 3.22 or later, but not Gtk4
   • PyGObject, version 3.22 or later
   • CairoMM, version 1.12 or later.
   • Pango, version 1.40 or later.
   • PangoCairo, version 1.40 or later.
   If you want the ability to display images loaded by the ImageMagick library, also install
   • ImageMagick, version 6.0 or later (but not as late as 7.0). Make sure to install the C++ headers for Magick++ if provided separately.
   If you want to try OOFCanvas's experimental support for numpy arrays (eg, for use with scikit-image), install
   • numpy, version 1.21 or later.
   • scikit-image, version 0.20 or later.
   but note that adding numpy support to OOFCanvas can cause problems in OOF2 (at least for OOF2 version 2.3.0).

   Detailed instructions for installing the prerequisites on a few operating systems are available here.

3. Read the Manual, which contains the installation instructions. The manual is also available in markdown format.

See the OOFCanvas Manual and the OOFCanvas Change Log.

NIST-developed software is provided by NIST as a public service. You may use, copy and distribute copies of the software in any medium, provided that you keep intact this entire notice. You may improve, modify and create derivative works of the software or any portion of the software, and you may copy and distribute such modifications or works. Modified works should carry a notice stating that you changed the software and should note the date and nature of any such change. Please explicitly acknowledge the National Institute of Standards and Technology as the source of the software. To facilitate maintenance we ask that before distributing modified versions of this software, you first contact the authors at oof_manager@list.nist.gov.

NIST-developed software is expressly provided "AS IS." NIST MAKES NO WARRANTY OF ANY KIND, EXPRESS, IMPLIED, IN FACT OR ARISING BY OPERATION OF LAW, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT AND DATA ACCURACY. NIST NEITHER REPRESENTS NOR WARRANTS THAT THE OPERATION OF THE SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT ANY DEFECTS WILL BE CORRECTED. NIST DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF THE SOFTWARE OR THE RESULTS THEREOF, INCLUDING BUT NOT LIMITED TO THE CORRECTNESS, ACCURACY, RELIABILITY, OR USEFULNESS OF THE SOFTWARE.

You are solely responsible for determining the appropriateness of using and distributing the software and you assume all risks associated with its use, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and the unavailability or interruption of operation. This software is not intended to be used in any situation where a failure could cause risk of injury or damage to property. The software developed by NIST employees is not subject to copyright protection within the United States.