Skip to content

Configuration Options

CalculusCalculator's configuration is divided into two categories: interface settings (language / theme, stored in a config file) and project save (current working session, stored in a project file).

Interface Settings (Settings Tab)

Open the settings page via the menu bar "Features → Settings". You can configure:

  • Interface language: Chinese / English. Takes effect immediately and persists.
  • Interface theme: Light / Dark. Takes effect immediately and persists.
  • Save settings (new in v1.6.4): finely control which types of data are saved when saving, via checkboxes.

These two settings are retained after the application closes and automatically restored on next launch.

Config File Location

Interface settings are saved as JSON. The path is determined by the Qt standard config directory:

<AppConfigLocation>/CalculusCalculator/CalculusCalculator/settings.json

Typical locations:

  • Windows: C:/Users/<username>/AppData/Local/CalculusCalculator/CalculusCalculator/settings.json
  • Linux: ~/.config/CalculusCalculator/CalculusCalculator/settings.json
  • macOS: ~/Library/Application Support/CalculusCalculator/CalculusCalculator/settings.json

Example file structure:

{
  "language": "zh_CN",
  "theme": "dark",
  "hasInitialized": true,
  "version": "2.0.0"
}

version records the "last-run application version", written on every startup (merged, not overwriting other keys). It can be used to detect upgrades or debug config compatibility.

Tip

Earlier versions (before the app name was set) may have written settings to AppData/Local/settings.json or AppData/Local/python/settings.json. The new version automatically migrates these old paths on first launch, so your previously saved light / dark preferences will not be lost.

Project Save / Load

Use the menu bar "File → Save / Save As / Open" to save the current working session as a project file (JSON). The contents include:

  • All tab input contents
  • Custom function list (fs dictionary)
  • Tab order number
  • Geometry objects (points / lines / circles / triangles / polygons, etc.)
  • Cache area expressions
  • All dropdown selection box options
  • All formula rendering view contents
  • Language and theme at save time

Save Settings (new in v1.6.4)

In the "Save settings (when saving)" area of the "Settings" page, you can finely control the saved content via the following checkboxes:

Option Data controlled
Function list Custom function definitions (fs dictionary)
Equation list (equation system) List of entered equation expressions (eqs)
Inequality list (inequality system) List of entered inequality expressions (rels)
Vector list Defined vector coordinates and properties
All cache contents All expression text temporarily stored in the cache area
Plane geometry object list Points, lines, circles, triangles, polygons, etc. defined in plane geometry
Solid geometry object list 3D points, lines, planes, etc. defined in solid geometry
All text box text Text contents in all input boxes
All selection box options Current selected index of all dropdown boxes
All expression display box contents Formula rendering parameters in all QGraphicsViews
All settings options Tab order, language, theme settings

Note

After unchecking an item, that type of data will not be saved; when loading, if the save does not contain that type of data, the current state is kept unchanged and will not be overwritten with empty values.

Opening a project file automatically restores the above session and applies the theme and language settings saved within it.

Note

The theme / language in the project file only take effect when "opening that project"; the global interface settings still follow settings.json.