简体中文 | 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-sfmlpowershell -ExecutionPolicy Bypass -File .\scripts\build.ps1构建并运行表达式单元测试:
powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1 -Test运行:
powershell -ExecutionPolicy Bypass -File .\scripts\run.ps1cmake -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 配色。
程序优先读取:
assets/fonts/NotoSansSC-Regular.ttfassets/NotoSansSC-Regular.ttf- Windows 系统字体:微软雅黑、黑体、等线、Segoe UI
- 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 许可。



