OpenCV
4.9.0
Open Source Computer Vision
|
Prev Tutorial: Transition guide
Original author | Sebastian Höffner |
Compatibility | OpenCV >= 3.3.0 |
Doxygen is a tool to generate documentations like the OpenCV documentation you are reading right now. It is used by a variety of software projects and if you happen to use it to generate your own documentation, and you are using OpenCV inside your project, this short tutorial is for you.
Imagine this warning inside your documentation code:
Inside your generated documentation this warning will look roughly like this:
While inside the OpenCV documentation the cv::Mat
is rendered as a link:
To generate links to the OpenCV documentation inside your project, you only have to perform two small steps. First download the file opencv.tag (right-click and choose "save as...") and place it somewhere in your project directory, for example as docs/doxygen-tags/opencv.tag
.
Open your Doxyfile using your favorite text editor and search for the key TAGFILES
. Change it as follows:
If you had other definitions already, you can append the line using a \
:
Doxygen can now use the information from the tag file to link to the OpenCV documentation. Rebuild your documentation right now!
GENERATE_TAGFILE = html/your_project.tag
. Your documentation will now contain a your_project.tag
file in its root directory.