Preferences

The Preferences dialogue box allows you to modify the Simulator parameters. It can be found in the ON popup menu: Alt–O "Preferences…".

Press "OK" or "Apply" to activate the new settings for the current session. The settings are not saved on the hard disk and will not become permanent until you save the current session. If you have unchecked "Save on exit" (see below), you must save the current session manually by pressing Ctrl–M.

The following items can be set in the dialogue box. Default values are used if no memory file is found on startup.

Simulator

• Strict HP-15C behaviour

  The real HP-15C stores numbers internally with 10 digits, and rounds each result to the 10th digit. The Tcl/Tk interpreter stores numbers in the IEEE-754 format with 17 digits and a different rounding mechanism. When this option is enabled, the number of relevant digits is set to 10 and each number is rounded to the 10th digit.

  The following calculation shows the effect of the two settings:

  f FIX 9

  2 ENTER 3 ÷

  0 . 6 6 −

  1 0 0 0 ×

  Result with "Strict HP-15C behaviour" enabled (10 digit precision):

  

  Result with "Strict HP-15C behaviour" disabled (17 digit precision):

  

  In the second case, the number is only rounded to the last digit on the display. Internally the number is stored as 6.666666666666599, giving full precision. For more information, see the section on number encoding in the Differences section.

  Default: Off

• HP-15C digit separators after reset

  By default, e.g. after a reset, the Simulator separates the integral and the fractional parts of a number with a comma, and separates groups of three digits in the integer part with a period (a decimal point).

  On the original HP-15C from HEWLETT-PACKARD the digit separators were the other way round. When this option is checked the Simulator behaves like the original HP-15C. Even after a reset.

  Default: oFF

• Pause length

  Time in milliseconds that a program pauses during execution when it encounters a f PSE statement. The valid range is 0 to 2000.

  This is also the time the display update is delayed after the last key is released in f PREFIX, g MEM and f i.

  Default: 1000

• Delay value

  Time in milliseconds that a program pauses after each statement. A value of around 100 gives a good idea of the performance of the real HP-15C. A value of 0 will give maximum performance. The valid range is 0 to 999.

  Default: 0

• Access "f" and "g" functions directly

  If this option is enabled, you can click directly on the gold and blue secondary functions. You do not need to press or click f or g first. If disabled, the gold functions cannot be clicked and clicking on a blue function is the same as clicking on the main key function.

  Default: On

• Highlight functions

  This option enables mouse-over effects for the blue and gold labels, when direct access to the f and g functions is enabled.
  

  Default: On

• Key sequence indicator

  The key sequence indicator is a small black square in the lower left corner of the display. It indicates an incomplete sequence. For example, if you press STO, the indicator will light up. If you now press 7 the indicator goes out, because the key sequence is complete. If instead, you continue with the + key, the indicator remains on. The Simulator is still waiting for the number of the storage register.

  The key sequence indicator is disabled during program execution.

  This function is inspired by the similar function on the DM15/DM15L from SwissMicros.

  Default: Off

• Save memory on exit

  If selected, the continuous memory is activated. When you exit the Simulator, the state will be saved to disk.

  If you uncheck this option, you will have to save the memory manually to make the new setting permanent!

  Default: On

• Use "C locale" for clipboard

  When this option is selected, a period is used as decimal point in the clipboard. This setting is independent of the current display settings for the decimal point and the digit separator.

  Default: Off

• Copy program when in PRGM mode

  By default, pressing Ctrl–C copies the contents of the X register to the clipboard. If this option is enabled and the Simulator is in PRGM mode, Ctrl–C copies the program code to the clipboard instead.

  Default: Off

• Save window position

  The last window position of the simulator is saved when set. The simulator will open at this position, the next time it is started.
  If the simulator window is not fully visible at the old position, the value is ignored. The simulator is then placed by the operating system's window manager.

  Default: Off

◀ Simulator ▲ Top

Menus

• Show menu

  On Windows and Linux, this activates a menu bar at the top of the simulator window.
  On macOS, the menu bar at the top of the screen is always active.

  Default: Off (always checked under macOS)

• Native macOS popup menus

  Earlier versions of Tcl/Tk did not allow fixed-width fonts in popup menus under macOS; a feature needed for the simulator popup menus. Newer combinations of Tcl/Tk and macOS; no longer have this limitation and native popup menus are now used by default. Disable this option if you experience problems with the stack and the memory popup menus.

  Default: On

• Number of recent programs

  The number of entries in the recent programs submenu. The valid range is between 10 and 30.

  Default: 10

There are three options for what information is displayed for each entry in the list:

• Show program title
• Show filename
• Show full path

Default: Show program title

• Show full path

  When this option is selected, the full path of a recently used program is displayed in the submenu. If not selected, only the base filename is displayed

  Default: Off

• Program mnemonics

  If this option is enabled, the program steps are displayed as mnemonics in the popup menu (Alt–S). If disabled, the program steps are displayed with their key codes. Note that this setting has no effect on the display.

  Default: On

• Coloured program menu

  When this option is selected, the following commands are displayed in colour in the program popup menu: LBL, RTN, GTO and GSB.

  Default: On

• Lines per column in program menu

  The program popup menu displays the program steps in a multi-column format. This value defines the number of program steps per column. The valid range is between 10 and 50.

  Default: 30

• Register and label addresses with decimal point

  This option controls how addresses of storage registers and labels between 10 and 19 are displayed. If enabled, the address is formatted with a decimal point, e.g. ,0 or .0, and if disabled, as a two-digit integer, e.g. 10.
  

  This option changes the format in the following situations:

  • Storage register menu
  • Program menu (if mnenomics are enabled)
  • GSB menu
  • Documentation dialogue
  • HTML export

  Default: Off

• Two-column storage menu

  By default, the storage popup menus display the available data storage registers in two columns. Deselect this setting if you want the storage menus to display all the data storage registers in one column.

  macOS: This option has has no effect when "Native macOS popup menus" (see below) is enabled. macOS does not allow multi-column popup menus.

  Default: On

• Storage register descriptions

  The storage register description from a loaded program can be displayed in the storage menus. Only the first 25 characters of a description are used.

  Default: Off

• Sort labels in GSB menu

  This controls whether the labels in the GSB menu are sorted or whether they appear in the order in which they occur in the program. If the labels are sorted, the letter labels are sorted before the number labels.

  Default: Off

• Matrix notation

  Two different styles are available for the matrix content menus: One with row and column headings like in a spreadsheet and one with the "row,column" information before each matrix element.

  Default: Rows/Columns

• Matrix separator

  When a matrix descriptor is in the display, pressing Ctrl–C copies the contents of the matrix to the clipboard. One line for each row and the elements of a row are separated by the selected separator.
  Be careful to select the "comma" separator as it may conflict with the thousands separator or the decimal point.

  Default: Semicolon

• Matrix submenus in stack menu

  A matrix item in the stack menu can be either a submenu button or just a label. In the case of a submenu button, moving the mouse over the button opens a submenu with the contents of the matrix.

  macOS: This only works if "Native macOS popup menus" are enabled.
  Windows, Linux: If matrix submenus are enabled, clicking on an item, e.g. "y:   A     2  2 ▶, does not scroll down the stack.

  Default: On

• Language

  This option controls the language used for menus and pop-ups. By default, the system language is used. If this language is not supported, British English is selected. The new setting is active immediately, except for the Preferences dialogue box. This dialogue box will use the new language the next time it is opened.

  Default: System

◀ Menus ▲ Top

Files

HP-15C Programs

• Encode programs in UTF-16 (LE)

  By default, the program files are encoded in UTF-16 (LE). Disable this option to encode them using the system default encoding.
  Note that HTML exports are always encoded in UTF-8.

  Default: On

• Confirm overwrite

  Defines the behaviour of the Save Program dialogue box if the selected file already exists. If enabled, the dialogue box will ask for confirmation before overwriting the existing file. If disabled, the file is overwritten without confirmation.

  Default: On

HTML Files

• Structure in English

  This setting determines the language used for HTML headings (<h#>), such as "Program Title", "Usage", etc., when exporting a program to an HTML file. If this option is selected, British English is used; if the option is unchecked, the currently selected menu language is used.
  This also sets a period as the decimal separator and a comma as the thousands separator.

  This setting has no effect on the text of the program description itself.

  Default: On

• Indent subroutines

  If this option is enabled, subroutines are indented in the HTML export to show the program structure. The start of a subroutine, i.e. f LBL followed by A…E, 0…9 or . 0…. 9 and the return command g RTN are not indented.

  Default: On

• Warn on missing documentation

  If this option is enabled, a warning message is displayed if you export a file as HTML and one of the following elements is empty:

  • Program
  • Program Title
  • Usage

  Default: On

• Single-column program listing

  By default, the program listing uses one column for programs with up to 25 steps, two columns for programs with up to 50 steps and three columns for programs with 51 or more steps. If this option is enabled, the program listing will always use only one column.

  Default: Off

• Keys in black and white

  By default, the keys are printed in colour. Enable this option to print them in black and white.
  This can be useful if you print out the documentation on a black and white printer, such as a laser printer.

  Default: Off

Description

• Open after loading a program

  If enabled, the Program Description dialogue box opens automatically after a program has been loaded.
  If the program has no documentation, the Program Description dialogue is never openened automatically.

  Default: Off

• Automatic preview

  If this option is enabled and the "Usage" field of a program description contains HTML tags or entities, the Program Description dialogue box opens in Preview mode. Otherwise it opens in Edit mode. Once the dialogue is open, you can switch between the two modes.
  

  Default: On

• Always insert Unicode characters

  If checked, the symbols are inserted as Unicode characters. If unchecked, HTML entities are inserted. This has no effect on the Preview mode; Unicode characters and their corresponding HTML entities will look the same.

  Default: On

• Toolbar style

  The menu buttons in the toolbar for the HTML tags can display icons or text.

  Default: Icons

• Show icons in tag menu

  Enables or disables icons in the context menu. Under macOS, the context menu does not normally have icons for the menu item.

  Default: Window, Linux: On; macOS: Off

• Highlight tags

  This section provides options to configure how tags are displayed in the "Usage" field of the Program Description dialogue box.

  Defaults: Colour: #800080 (RGB 128, 0, 128), bold: checked

• Text markers

  Allows you to select the colour used to highlight all occurrences of a text in the program description in Edit mode.

  Default: #FFFF00 (RGB 255, 255, 0)

• Show resources in tabs

  Resources can be grouped either as a block or in individual tabs for Labels, Memory Registers and Flags.

  This does not affect whether the resources are displayed at all. This is controlled by the "Resources" button below the description.

  Default: On

• Author information

  Information about the authorship of programs can be added in this field. This value is inserted into an empty "Usage" field, when the Program Description dialogue box is opened.

  Default: Empty

◀ Files ▲ Top

Devices

• DM15 Support

  This activates the support for the DM15, i.e. the menu items for the DM15 will be visible or hidden.

  Default: Off

  • Serial Interface Port

    The number of the serial port assigned by the operating system to the USB port of the DM15.

    Default: Not set

  • Timeout

    The timeout in seconds for the serial port.

    Default: 2 seconds

  • Number of registers

    Sets the number of data storage registers available in the HP-15C Simulator. The three options reflect the firmware versions available on the DM15.
    

    Default: 64 registers

• HP 15C CE Support

  This activates the support for the HP 15C CE, i.e. the menu items for the HP 15C CE will be visible or hidden.

  Default: Off

  • Number of registers

    Sets the number of data storage registers available in the HP-15C Simulator. The two options reflect the available modes on the HP 15C CE.

    Default: 96 registers

  • 192 register mode

    After a reset, the HP 15C CE's 192-register mode has 94 storage registers and 99 pool registers. This is where this mode differs from all other modes on all HP-15C derivates and clones. After a reset, the modes have 19 storage registers and the remaining are pool registers.

    If this option is activated, the simulator will behave like the HP 15C CE. If it is deactivated, the simulator has 19 storage registers and 174 pool registers after a reset.

    Default: Off

  • USB HID mode (not) available

    This label indicates whether the necessary HID library could be loaded or not. See the Preferences section USB HID access for more details.
    The information is independent of whether the HP 15C CE support is activated or not.

  Note:
  If the DM15 support or the HP 15C CE support is disabled, the "Number of registers" is set to the smallest value for the other device. If support for both is disabled, the Simulator reverts 64 registers as on the original HP-15C.

• Transmitted data

  The ten check boxes, five for reading and five for writing, determine what data is exchanged between the calculator and the HP-15C Simulator.

  Default: "Program" checked for both reading and writing.

• Ask for each operation

  When this option is selected the data to be exchanged between the source and the target device is interactively queried for each operation. The selection is set as the default for the next operation.

  Default: On

◀ Devices ▲ Top

Fonts

• Font set

  The layout of the Simulator is highly dependent on the combination of fonts, font sizes and the monitor resolution. The Simulator therefore provides predefined font sets for common display resolutions. These font sets have been fine-tuned to give a good representation of the real HP-15C body aspect ratio which is the "Golden Ratio".

  The following table lists the available font sets for each platform and display resolution:

  Platform	Font set	Size	Fonts used in set
  UNIX/Linux Mac OS	DejaVu fonts	small, normal, large and huge	DejaVu Sans
  	Microsoft fonts	small and normal	Arial Microsoft Sans Serif
  MS Windows (all versions)	Microsoft fonts	small, normal, large and huge	Arial Microsoft Small Fonts Microsoft Sans Serif

  Remarks:

  • The "HP-15C Simulator Font" is used with all sets.
  • If you want to change fonts or font sizes or add new font sets, you need to edit the Simulator source code. I suggest to not change existing font sets at all.
  • "DejaVu" fonts can be found on the Internet (see the Links page).
  
  
• Extended Unicode chars for key faces

  The Simulator can use certain Unicode characters to make the keys look more like the original HP-15C keys.

  All current operating systems should provide fonts with the necessary characters. If this option is enabled and a character is not available, you will see keys like this

  instead of or instead of .

  In this case, you should disable this option or install a suitable font.

  Default: On

• Graphic display instead of "HP15C Simulator Font"

  When this option is selected, a graphic display is used instead of the the "HP-15C Simulator Font".
  This is useful if you need administrator rights to install fonts but cannot get them; e.g. on company computers.

  The graphic display requires a binary extension, that is not included in the source code version. In this case, it is still required to install the font. If the extension can be loaded and the font is not installed, the graphic display is activated automatically.
  

  Default: Off

• Black digits

  By default, the simulator uses colours for the display that correspond to the original HP-15C.
  When this option is selected, the digits on the display are black to increase contrast.

  Default: Off

◀ Fonts ▲ Top

Help File Browser

This setting allows you to specify the browser used to display the Online Help.

When the Simulator is started for the first time, or if no browser is set, the Simulator checks for some common browsers. The operating system's default method for opening a web page is added to the top of the list. This results in the following list of possible browsers per operating system:

Platform	Browser list
UNIX/Linux	xdg-open firefox chrome opera vivaldi
macOS	open safari firefox chrome opera vivaldi
Windows	start firefox chrome opera vivaldi edge

The first entries in the list, xdg-open, open and start, will open a URL the default browser.

All the browsers found are listed, and the first one in the list is set as the Help file browser. You can select another browser from the list or use the "Browse…" button to find another one.

◀ Browser ▲ Top

FAQ ▶