Programs to view HINT files
News
The HINT file format version 2.1 features the addition of primitives to implement color. As a consequence, an updated viewer is required. While it should be forward compatible with newer versions, it is not allways backward compatible with older versions.
Documentation
The hint viewer software consists of a backend, written in C and several frontends. The backend is reusable and depends heavily on the HINT file format version, the frontends are specific for an operating system. Currently five frontends are (see below) available: for Linux, Windows, Android, iOS and MacOS. The Android HintView is joint work with Prof. Gudrun Socher.Currently the most simple viewer is the viewer for Linux. Its user interface consists just of a few key strokes and mouse movements as described in the man page. All the viewers use the same backend. The code for rendering pages is written in OpenGL and available in two slightly different version, one for OpenGL and one for OpenEGL. If you want to investigate the sources or want to implement your own viewer, the Linux viewer is a good starting point.
A book (cover on the left) is in preparation. Documented sources will become available with the printed documentation (or on request from the author).
Sources
Sources for hintview are now on github: github.com/ruckertm/HINT
Binaries
Binaries using the old HINT file format version 1.4 can be found here: HINT version 1.4 but the version 1.4 is deprecated. Similar binaries for version 2.0 can be found here: HINT version 2.0- Windows: the Version 2.1.1 viewer supports HINT Format Version 2.1.
For easy inatallation use this setup file: setup_HintView_2_1_1.exe.
For manual installation just download the executable hintview.exe. You may want to put it to directory on your search path and associate the viewer executable with .hnt files.
- Android: The HINT viewer for Android is available from the
Play Store:
HintView
Alternatively here is an APK for download: hintview-2-1-1-app-release.apk
- Linux:
A Debian installation package is available since Debian trixie.
(See also
github.com/debian-tex/hintview.)
The package may also run on derived distributions such as Ubuntu.
For Linux there is a precompiled binary hintview. As it is with precompiled Linux binaries, they might work on your system or not. You can downlaod the manual page here: hintview.1.
Using the sources from the repository, it should be sufficient to install the required libraries (libdl, libglew, libglfw3 libfreetype, libX11, libXrandr, libXinerama, libXi, libXcursor, libGL, libz, libpthread, libm, libc), change to the Linux/ subdirectory and run make or possibly WITH_GTK=number make where number is either 2 or 3.
- MacOS: Currently I am working on offering a viewer in the
Apple Store.
Thanks to Richard Koch, you can download a package for MacOS from his home page at
https://pages.uoregon.edu/koch/.
Alternatively you can download a complete Xcode project from the source repository mentioned above.
There is a short video, demonstrating some of the program features. It was made for Jonathan Fine's TeX Hour on Thursday, September 29, 2022.
- iOS: Here again I am working on providing the viewer through the Apple Store. Instead, you can download a complete Xcode project from the source repository mentioned above.
Books
The first complete book that is avalable as a HINT file is here!- Jack London: The Call of the Wild
Example Files
Examples using the old HINT file format version 1.4 can be found here: HINT version 1.4.Examples using the old HINT file format version 2.0 can be found here: HINT version 2.0.
The following files use the HINT file format version 2.1 and were produced using hitex or hilatex.
- png.hnt
png.tex
A.png
Text with a png image.
- jpg.hnt
jpg.tex
A.jpg
Text with a jpg image.
- image.hnt
image.tex
Loewe.jpg
Head.jpg
Images that shrink and stretch like glue
- leaders.hnt
leaders.tex
Leaders as in a table of content
- ligature.hnt
ligature.tex
Ligatures for testing hyphenation and page breaking
- math.hnt
math.tex
Some math
- mfpreface.hnt
mfpreface.tex
The preface of the METAFONT book
- sample2e.hnt
sample2e.tex
The basic LaTeX Example file
- ueb2.hnt
ueb2.tex
A typical example of weekly exercises in a course on programming
- insertions.hnt
insertions.tex
Demonstrating floating insertions like footnotes and illustrations.
- calibration.hnt
calibration.tex
Shows vertical and horizontal rulers that should be exactly 10cm long if displayed at a zoom factor of 100%.
- vtop.hnt
vtop.tex
Illustrates the vertical alignment of variable size boxes.
- format.hnt
The book: HINT: The File Format
- ctex.hnt
The TeX program as translated from WEB to cweb.
Errata and Improvements
- To be continued ...
Data Protection Declaration
The Data Protection Declaration for the HintView application can be found here.
Support
- These programs are still under continuous development. So don't ask for support.
- If you want to help, send me immediately an email to ruckert (at) cs.hm.edu.
- If you own a company and want to use HINT files and HINT viewers as part of your products, send me an email to ruckert (at) cs.hm.edu.