Free Hero Mesh

Changes To .heromeshrc
Login
This is a mirror of the main repository for Free Hero Mesh. New tickets and changes will not be accepted at this mirror.

Changes to ".heromeshrc" between 2018-04-20 06:08:34 and 2018-06-24 02:26:23

1
2
3
4
5

6
7
8
9
10
11
12
1
2
3
4

5
6
7
8
9
10
11
12




-
+







This document describes the current plan (part of which is implemented), and may be altered if it changes.

The <tt>.heromeshrc</tt> file is a file in [https://tronche.com/gui/x/xlib/resource-manager/file-syntax.html|X resource manager] format, except that <tt>#include</tt> isn't (currently) implemented. It should be placed in your home directory. If the environment variable <tt>HOME</tt> is not set, the current directory is used. (Note: The X server is not queried for resources, nor are any other files queried; this resource database is entirely local to Free Hero Mesh.)

The first component if all resource settings is the puzzle set name, ignoring any directory path components. If the puzzle set includes a <tt>.name</tt> file, its contents are used as the puzzle set name for this purpose.
The first component if all resource settings is the puzzle set name, ignoring any directory path components (omit the first component when specifying a setting as a command-line argument). If the puzzle set includes a <tt>.name</tt> file, its contents are used as the puzzle set name for this purpose.

Some options are boolean. In this case, a true value is anything that starts with "t", "T", "y", "Y", or "1", while a false value is anything that starts with "f", "F", "n", "N", or "0". If neither is the case, the default setting is used.

<h2>altImage</h2>
A nonnegative integer (default zero). If more than one picture is available of the selected picture size, this is used to determine which one to load.

For example, it can be used to select which player character you want (e.g. male or female or whatever).
75
76
77
78
79
80
81








82
83
84
85
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93







+
+
+
+
+
+
+
+





<h2>sqlMemStatus</h2>
Boolean; set true to collect memory statistics for SQLite. (Not all memory allocation in Free Hero Mesh uses SQLite, however.) Currently this does not do anything in Free Hero Mesh itself, although an extension might use it.

<h2>sqlSmallAllocations</h2>
Boolean; if true, SQLite tries to avoid large memory allocations. False by default.

<h2>stackProtection</h2>
Control stack overflow protection. If omitted or if a C compiler that does not support GNU extensions is used, then no stack protection is implemented. Otherwise, it may be one of the following:
  *  <tt>?</tt> sets stack protection test mode. This mode collects statistics of the lowest, highest, and initial frame addresses, and will display the data when the program ends.
  *  <tt>&lt;</tt> and then a number will cause an error message if the frame address is less than the initial frame address plus the specified number of bytes.
  *  <tt>&gt;</tt> and then a number will cause an error message if the frame address is greater than the initial frame address plus the specified number of bytes.

Note: The stack overflow protection is only implemented for functions that may call themself recursively (either directly or indirectly).

<h2>tracePrefix</h2>
If message tracing is enabled, then many events within the game (including a Trace instruction) will write a line to stdout with the details of the event; this setting defines a prefix to add to each line of trace events.

You may then use external programs to filter the output by this prefix.