Installing Caret5 Software
- Download a Caret distribution from the Download
- Unzip the file in the desired location (/Applications on a Mac,
if desired). When a distribution is unzipped, it will create a
subdirectory named "caret".
- Executables (caret5, etc) are located in "caret/bin...".
The "bin..." directory is unique for each operating system and
- If you want to run Caret from the command line, it will be
necessary to set your PATH environment variable to the "bin..."
directory in your caret distribution.
- See your friendly system administrator for assistance or post to
the caret user's email list.
Installing Caret5 on Linux Systems
A user has reported a problem with Caret crashing on a Linux system
when displaying a volume. The crash has to do with caret
trying to render text which ultimately uses the FreeType library.
Check for the file ".fonts.conf" in your home directory. If it
exists, rename it and see what happens.
If your Linux operating system has the program "glxgears" or
"/usr/bin/glxgears", try running it. If it crashes you definitely
have a problem with your OpenGL drivers and libraries.
If your operating system is upgraded YOU MUST update your OpenGL
drivers and libraries. They are obtained from the manufacturer of
the graphics card.
Installing Caret5 on Mac OSX Systems
Adding Caret5 to the Dock
To place caret5 in the Dock, open up a finder and navigate to the caret
installation's "caret/macosx32_apps" or "caret/macosx64_apps"
directory. Drag the Caret5 icon from Finder into the Dock.
This allows Caret to be started from the Dock like other Mac
Enable Double-clicking of a Spec File in Finder to Start
It may be possible to set up your Mac so that you can navigate to a
directory and double-click a spec file to start Caret. To set
this up, use Finder to locate a Spec File. Hold down the
"control" key and then click the mouse over the spec file to pop-up a
menu. From the menu, select Get Info. Click the arrow next
to Open with" to show additional items. Click on the control
immediately below Open with: and select Other...". Use the dialog
that is displayed to navigate to the "caret/macosx32_apps" or
directory. Change Enable from Recommended Applications to All
Applications. Select the caret5 icon and press the Add
Installing Caret5 on Windows XP
Creating a Shortcut on the Windows XP Desktop
- Place the mouse so that it is NOT over any icons on the Desktop.
- Press the right mouse button and a popup menu is displayed.
From the popup menu, move the mouse to the New menu, and select
- Press the Browse button, and, in the Browse for Folder Dialog, go
into caret’s “caret/bin_windows32” or "caret/bin_windows64" directory
and select the file
the OK push button on the Browse for Folder Dialog.
- Press the Next push button on the Create Shortcut Dialog.
- On the next page, leave the name of the shortcut caret5 and press
the Finish push button.
- Double-click the Caret5 icon on the Desktop to start Caret5.
Setting the Path Environment Variable so that Caret5 and
caret_command May Be Started
from a Command Line Window
- From the Start Menu, select Control Panel.
- Double-click the System Icon.
- On the System Properties Dialog, click the Advanced tab.
- Press the Environment Variables push button near the bottom of
the System Properties Dialog.
- In the Environment Variables Dialog, there are two types of
environment variables. The bottom set of environment variables,
System variables, will set the Path for all users on the
computer. User variables for <login-name> will only set the
Path environment variable for the currently logged in user.
- If there is no Path environment variable, press the New push
button. In the Edit Variable Dialog that pops up, enter Path for
the Variable name and then enter the Variable value, full path to the
bin_windows32/64 directory, "C:\caret\bin_windows32". Note that
only the directory is
needed. Press the OK push button to close the Edit
- If there is a Path environment variable, press the Edit push
button. In the Edit Variable Dialog, press the left mouse button
in the Variable value text box, press the Home key to get to the
beginning of the value, press the left mouse button before the first
character, and then enter C:\caret\bin_windows32;" (a semicolon is
required between all directory names in the PATH). Press the OK
button to close the Edit Variable Dialog.
- Press the OK push button on the Environment Variables Dialog.
- Press the OK push button on the System Properties Dialog.
- Close the Control Panel Window.
- Using the Start Menu button, move the mouse over All Programs,
and from the Accessories Menu, select Command Prompt.
- In the Command Prompt Window, enter the command caret5 If
the Path Environment variable has been set correctly, Caret5 will
start. If not, check the previous steps.
Enable Double-clicking a “.spec” File to Start Caret5 in Windows
- From the Taskbar, select the Start menu and choose Control Panel.
- This step is only necessary if the Control Panel is in Category
View. If it is, you will see Pick A Category near the top of the
Window’s contents. If so, click Appearance and Themes. If
not, continue to the next step.
- Double-click Folder Options.
- Select the File Types tab.
- Scroll through the list of file types looking for SPEC. If
SPEC is found, press the mouse once on it to select it and then press
the Delete button. If the Delete button is disabled, first press
the Restore button which will enable the Delete button. Confirm
that you want to delete the SPEC extension.
- Press the New button and the Create New Extension dialog will
- Enter SPEC for the file extension and press the OK button to
close the Create New Extension dialog.
- In the Details for SPEC Extension section, press the Advanced
button to display the Edit File Type dialog.
- Press the New button to display the New Action dialog.
- Enter open for the Action.
- Press the Browse button and find the file caret5.exe which is
located in your caret distribution’s C:\caret\bin_windows32
caret5.exe and press the Open button to close the Open With dialog.
- Press OK on the New Action dialog to close it.
- Press the OK button on the Edit File Type Dialog to close it.
- Press Close on the Folder Options dialog.
- Double click a Spec File and Caret5 should start with the Spec
File Dialog listing the Spec File’s data files.
"OpenGL Error: invalid enumerant" Message
If this message is displayed, try restarting caret5 from the command
line as "caret5 -notext". If this eliminates the error message
and caret5 is being run on a Linux system, try updating the "FreeType"
library. If that does not solve the problem try updating the
OpenGL library. On Windows, try updating the OpenGL library.