Apple Shake 4 - Manual (Page 356)

356 Chapter 14 Customizing Shake
Finding Shake’s Default Settings
Shake uses two important files to set the original default settings. These files are named
nreal.h and nrui.h, in the following directory:
On Mac OS X
<ShakeInstall>/Contents/Resources
On Linux
<ShakeDir>/include
The first file, nreal.h, lists every function and default setting in Shake. Although this file
should never be modified by the user, you can open it, and copy functions to use as a
formatting reference for creating your own custom .h preference files. The commands
found in the nreal.h file can be copied and saved in .h files within your own startup
directory.
The second file, nrui.h, contains the data Shake uses to build the interface. It assigns
menu names and contents, tabs, buttons, slider settings, and all of the default settings
used by the interface in its default state. The commands in the nrui.h file should be
copied and saved in .h files within your ui directory.
Note: To open these files for the Mac OS X version of Shake, Control-click or right-click
the Shake icon, then choose Show Package Contents from the shortcut menu to view
the Shake package contents (which include the nreal.h and nrui.h files).
Creating Your Own Preference Files
You can create your own preference files (.h files) to change Shake’s default settings,
add functionality, or change Shake’s performance.
To add your own .h files to customize Shake:
1 Using your text editor of choice, create a new file, then enter the variables and settings
you wish it to modify.
These variables are covered in depth later in this chapter, and are referenced
throughout the documentation.
2 Save the file as a plain text file.
Preference files can be given any name, (except “nreal.h” or “nrui.h,” which are reserved
files used by Shake as the standard list of functions and settings), and they must have
the .h extension to be recognized by Shake.
Note: A fast way to disable a preference file is to remove its .h extension.
3 Place the new .h file within one of the directories discussed in the next section.
Warning: You should never modify either of these files. Doing so risks damaging your
Shake installation, requiring you to reinstall Shake.