Skip to content

About

A C++17 + SFML 3.1 desktop function and implicit-equation plotter with adaptive axes, animations, curve snapping, and a bilingual UI.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

函数绘图 · Function Plotter 1.0.0

简体中文 | English

使用 C++17 + SFML 3.1 编写的 Windows 桌面函数 / 方程绘图器。浅色模式以浅蓝和白色为主,深色模式使用深蓝和深灰;两种模式都可以用任意强调色重新着色。

GitHub 仓库 · Releases · Changelog · MIT License

浅色模式

下载与安装

从 v1.0.0 Release 下载:

版本 文件 说明
安装版 FunctionPlotter-Setup-1.0.0-win64.exe 安装到当前用户目录,无需管理员权限;创建开始菜单 / 桌面快捷方式,并注册卸载入口
便携版 FunctionPlotter-1.0.0-win64-portable.zip 解压后直接运行 FunctionPlotter.exe,不写注册表

校验文件:SHA256SUMS.txt

  • 系统要求:Windows 10 1803+ / Windows 11(安装器使用系统自带的 tar.exe 解包)。
  • 当前发布文件未做代码签名,首次运行时 Windows SmartScreen 可能提示“无法识别的应用”;选择“更多信息 → 仍要运行”即可。
  • 安装版默认目录:%LOCALAPPDATA%\Programs\FunctionPlotter,安装时可以修改。
  • 卸载入口:Windows“设置 → 应用”中的 Function Plotter,或开始菜单中的“卸载 Function Plotter”。

功能

绘图

  • 自动适应的平面直角坐标系,刻度数量和“漂亮”步长随窗口大小、缩放级别变化。
  • 坐标轴、刻度数字、端点箭头和 x / y 轴标签。
  • 两种输入模式:
    • 函数:输入框左侧显示 f(x) =
    • 方程:支持隐式方程,例如 x^2 + y^2 = 4
  • 函数按屏幕列采样并自动断开渐近线;隐式方程使用 Marching Squares 提取等值线。
  • 鼠标指针靠近曲线时自动吸附到最近点,显示圆点与 (x, y) 坐标;同时隐藏系统鼠标指针。
  • 默认开启“从左到右”绘制动画,持续时间可在设置中调整。
  • 空状态提示“开始绘制”;启动后进行任意点击、滚轮、键盘输入等操作后,提示自动隐藏。

视图交互

  • 鼠标滚轮缩放,支持三种缩放锚点:鼠标位置、坐标原点、窗口中心。
  • WASD / 方向键平移;按住鼠标左键拖动;Shift 加速平移。
  • 放大 / 缩小 / 视图复位按钮;窗口可自由缩放,最小 860 × 700。
  • 输入框失焦后,按任意普通键清除图像(移动键、Enter、Esc 等保留)。

输入与清除

  • 输入框支持 ← / → / Home / End 移动光标,支持在任意位置插入和删除。
  • 空输入框获得焦点时光标位于最左侧,占位提示不会把光标推后。
  • 切换“函数 / 方程”会清空输入框并重新聚焦,方便直接输入。
  • Esc:输入时清空输入;无输入焦点时清空输入和图像,并把光标放回输入框。
  • Backspace:输入时删除前一个字符;无输入焦点时清空输入和图像并聚焦。
  • 点击 清除:同时清空输入和图像,并聚焦输入框。
  • 清除图像后,左上角图例和表达式标签同步移除。

设置面板

设置面板分为“外观”和“绘图”两个标签页:

外观

  • 浅色 / 深色模式。
  • 主题配色:8 个预设色 + RGB 自定义调色。强调色会同步改变窗口背景、网格、按钮、输入框、图例和左上角 Logo。
  • 线条粗细。
  • 恢复到初始状态。

绘图

  • 自动清除旧图像(关闭后可叠加最多 6 条曲线)。
  • 从左到右绘制动画开关;动画持续时间 0.2–4.0 秒。
  • 缩放模式:鼠标 / 原点 / 窗口中心。
  • 显示网格、显示刻度数字、显示十字准星。
  • 吸附提示说明。

其他

  • 设置标题栏内提供 中 / EN 语言切换,界面文案、窗口标题和解析错误会即时切换为中文或英文。
  • 顶部右侧设置按钮;点击面板外的绘图区域会关闭面板。

外观设置

绘图设置

深色模式与曲线吸附

表达式语法

支持变量:x(函数模式);x、y(方程模式)。
支持常量:pi、e、tau。

运算符:

+  -  *  /  ^

支持隐式乘法,例如 2x、3sin(x)、(x+1)(x-1)、2pi。

内置函数:

sin cos tan asin acos atan
sinh cosh tanh
sqrt cbrt abs exp
ln log log10 lg log2
floor ceil round sign

绝对值也可以写成 |x|。输入支持 ²、³、全角符号、×、÷、π 等常见数学字符,解析前会自动规范化。

示例:

x^2 - 4
sin(x)
1/x
sqrt(x)
abs(x) + 1
x^2 + y^2 = 4
x^2 / 4 + y^2 / 9 = 1
y = x^2
x = 2
x * y = 1
|x| + |y| = 2

方程中的 r 不会被当作常量。请把半径写成具体数字,例如 x^2 + y^2 = 4。

操作说明

操作 说明
点击输入框 开始输入表达式
Enter 绘制;输入框未激活时先激活输入框
← / → 在输入框中移动光标
Home / End 跳到输入开头 / 结尾
Backspace 输入时删除前一个字符;未聚焦时清空输入和图像并聚焦
Delete 输入时删除后一个字符
Esc 关闭设置 / 下拉框;输入时清空输入;否则清空输入和图像并聚焦
鼠标滚轮 按设置的缩放模式缩放
W A S D / 方向键 平移坐标系
Shift + 移动 加速平移
鼠标左键拖动 平移坐标系
鼠标靠近曲线 吸附到曲线并显示 (x, y)
任意其他键 输入框未聚焦时清除全部图像
点击 清除 清空输入和图像,并聚焦输入框
点击右上角 设置 打开设置面板

“任意键清除”与 WASD 移动、输入编辑存在天然冲突,因此实现时保留 WASD、方向键、Enter、Esc、修饰键和编辑键;输入框聚焦时只进行文字输入,不触发清图。为了便于连续输入,绘制成功后输入框默认失焦,此时可直接按普通字符键清图。

构建

环境

  • Windows 10/11
  • CMake ≥ 3.22
  • Ninja
  • MSYS2 UCRT64:GCC、SFML 3.1

以 MSYS2 为例:

pacman -S --needed mingw-w64-ucrt-x86_64-gcc `
  mingw-w64-ucrt-x86_64-cmake `
  mingw-w64-ucrt-x86_64-ninja `
  mingw-w64-ucrt-x86_64-sfml

一键构建

powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1

构建并运行表达式单元测试:

powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1 -Test

运行:

powershell -ExecutionPolicy Bypass -File .\scripts\run.ps1

手动 CMake

cmake -S . -B build -G Ninja `
  -DCMAKE_PREFIX_PATH=C:/msys64/ucrt64 `
  -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
.\build\bin\FunctionPlotter.exe

也可以使用预设:

cmake --preset windows-msys2
cmake --build --preset windows-msys2
ctest --preset windows-msys2

构建后,CMake 会自动把 SFML 及其传递依赖 DLL 复制到 build/bin,并复制 assets 目录,因此可以直接运行 build/bin/FunctionPlotter.exe。

打包安装版与便携版

powershell -ExecutionPolicy Bypass -File .\scripts\package.ps1

脚本会构建应用和测试,并生成:

dist/
  FunctionPlotter-1.0.0-win64-portable/      解压即可运行的目录
  FunctionPlotter-1.0.0-win64-portable.zip
  FunctionPlotter-Setup-1.0.0-win64.exe

已有构建结果时可以跳过重新编译:

powershell -ExecutionPolicy Bypass -File .\scripts\package.ps1 -SkipBuild

安装器是一个独立的 Win32 程序,内嵌便携包;安装时使用 Windows 自带的 tar.exe 解压,写入当前用户的开始菜单、桌面快捷方式和卸载注册表项。不需要管理员权限。

实现说明

src/
  Expression.*   词法分析、递归下降解析、AST 求值,中英文错误信息
  Graph.*        坐标变换、网格、刻度、箭头、函数与隐式方程渲染、动画、吸附
  Ui.*           圆角卡片、文字、开关、滑块的绘制工具;文字形状缓存
  Theme.*        从强调色生成浅色 / 深色配色
  App.*          窗口、输入、设置、语言、交互和整体 UI
  main.cpp       入口(Windows GUI 子系统 + 错误提示框)
installer/
  installer_main.cpp     Win32 安装器
  uninstaller_main.cpp   Win32 卸载器
tests/
  expression_tests.cpp
scripts/
  build.ps1  run.ps1  package.ps1
  • 函数绘制:按屏幕像素列采样 f(x),检测非有限值与跳变以断开渐近线。
  • 方程绘制:在屏幕格点上计算 F(x, y) = lhs - rhs,使用 Marching Squares 提取零等值线,格距随窗口大小自适应。
  • 动画:只绘制曲线在屏幕列上“已揭开”的部分,并叠加一条轻微的高亮前沿;隐式方程按列裁剪。
  • 吸附:函数模式在鼠标附近逐列寻找最近采样点;方程模式在鼠标周围做局部 Marching Squares 采样,再取最近点。
  • 坐标刻度:根据当前缩放选择 1 / 2 / 5 × 10^n 的“漂亮”步长,目标间距约 82 px。
  • 文字性能:避免每帧重新构造 sf::Text,按字体、字号、样式和内容缓存已排版文本。绘图界面维持在 60 FPS。
  • 分辨率适配:UI 布局根据窗口尺寸实时计算;最小窗口 860 × 700,设置面板在最小尺寸下仍不遮挡底部输入栏。
  • 颜色主题:主题不再是固定色表,而是由强调色和明暗基调混合生成背景、卡片、边框、网格、按钮和 Logo 配色。

字体

程序优先读取:

  1. assets/fonts/NotoSansSC-Regular.ttf
  2. assets/NotoSansSC-Regular.ttf
  3. Windows 系统字体:微软雅黑、黑体、等线、Segoe UI
  4. Linux 常见 Noto CJK / DejaVu 字体

Windows 环境通常直接使用系统自带的微软雅黑。若要分发到缺少中文字体的环境,可将支持中文的字体放到 assets/fonts/NotoSansSC-Regular.ttf,构建时会自动复制到可执行文件旁。

测试

.\build\bin\expression_tests.exe
# 或
ctest --test-dir build --output-on-failure

覆盖函数解析、方程解析、隐式乘法、绝对值、Unicode 规范化、定义域错误、错误输入和中英文错误信息等场景。

已知取舍

  • 输入框支持键盘光标移动,但尚未实现鼠标拖选和剪贴板粘贴。
  • 更改线条颜色 / 粗细时,会即时应用到最近绘制的曲线;新曲线使用当前设置。
  • 自动清除关闭时最多同时显示 6 条曲线。
  • 设置只在本次运行中有效,不写入配置文件。
  • 绘制动画是视觉过渡,不改变最终采样精度。
  • 发布的可执行文件未签名,SmartScreen 可能给出提示。

许可

本项目以 MIT License 发布,详见 LICENSE。SFML 按 zlib/png 许可分发;图标为本项目自制。若在项目中加入 Noto Sans SC 等第三方字体,请遵循对应字体的 OFL 许可。

About

A C++17 + SFML 3.1 desktop function and implicit-equation plotter with adaptive axes, animations, curve snapping, and a bilingual UI.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages