DLL:
DuiLibRunCurveChartPlugin.dll类:
CCRunCurveChart标签:
RunCurveChart/RunCurve
单条实时曲线,重点是跑起来 ------定时器按固定周期往序列里塞采样值,
曲线从右往左滚动,带当前值读数和横线指示。
和 09-MultiCurveUI 的区别见那篇第一节。
本篇讲它独有的设计:自带演示波形。
一、数据结构
cpp
CC::CValueSeries m_series; // 单条环形缓冲,容量默认 300
int m_nSampleInterval; // 自动采样周期 ms,默认 100;0 = 只接受外部 Push
double m_dSampleAcc; // 采样累加器(秒)
bool m_bRunning; // 是否在跑
bool m_bAutoScale; // 自动量程
double m_dMinY, m_dMaxY;
DWORD m_dwCurveColor; // 0xFF35C0FF
bool m_bFill; // 曲线下方填充
int m_nFillAlpha; // 填充透明度 0..255
int m_nCurveWidth; // 线宽
bool m_bGrid; // 网格
bool m_bValueLine; // 当前值横线
bool m_bShowValue; // 顶部读数
CDuiString m_sUnit; // 单位
// 本地合成的演示波形
bool m_bDemoWave; // 默认 true
double m_dDemoPhase; // 相位
二、演示波形:没有数据也能看到效果
这是本插件最实用的设计。很多图表控件在"没有外部数据源"时是一块空白,
集成阶段根本没法判断控件是否正常。
所以这里内置一个本地合成的正弦波:
cpp
void CCRunCurveChart::OnTick(double dt, double dTotal)
{
(void)dTotal;
if (!m_bRunning) return;
if (m_nSampleInterval <= 0) return;
m_dSampleAcc += dt;
double dPeriod = (double)m_nSampleInterval / 1000.0;
if (dPeriod <= 0.0) dPeriod = 0.1;
// 按固定周期补采样;一次 Tick 最多补 4 个,防止长时间卡顿后补出几百个点
int nGuard = 0;
while (m_dSampleAcc >= dPeriod && nGuard < 4) {
m_dSampleAcc -= dPeriod;
++nGuard;
double v;
if (m_bDemoWave) {
// 演示波形:一个慢速正弦叠加一点锯齿,看起来像真实的速度曲线
m_dDemoPhase += dPeriod;
double dBase = (m_dMaxY - m_dMinY) * 0.5 + m_dMinY;
double dAmp = (m_dMaxY - m_dMinY) * 0.28;
v = dBase + dAmp * sin(m_dDemoPhase * 1.7)
+ dAmp * 0.3 * sin(m_dDemoPhase * 5.3);
if (v < m_dMinY) v = m_dMinY;
if (v > m_dMaxY) v = m_dMaxY;
}
else {
// 外部喂数模式下这里不产生数据
break;
}
m_series.Push(v);
if (m_bAutoScale) RecalcRange();
}
Invalidate();
}
2.1 波形公式
cpp
v = dBase + dAmp * sin(phase * 1.7) + dAmp * 0.3 * sin(phase * 5.3)
dBase= 量程中点((max - min) * 0.5 + min)dAmp= 量程的 28%((max - min) * 0.28)- 主波频率 1.7 rad/s,副波频率 5.3 rad/s(约主波的 3.1 倍)
- 副波幅度是主波的 30%
这是"两个不同频率的正弦叠加" ,产生一个不规则但有规律的波形------
看起来像真实的速度/电流曲线(有主趋势 + 高频噪声),而不是一眼假的纯正弦。
0.28 的幅度让波形在量程中点上下摆动 ±28%,再叠加 30% 的副波,
总幅度约 ±36%------不会顶到上下边界(还有 14% 余量),也不会太扁。
2.2 nGuard < 4 的补采样上限
cpp
int nGuard = 0;
while (m_dSampleAcc >= dPeriod && nGuard < 4) {
m_dSampleAcc -= dPeriod;
++nGuard;
...
}
这是防"卡顿后补出几百个点"。
如果窗口被拖动 2 秒(消息循环阻塞),dt 会积累到 2 秒,
m_dSampleAcc = 2.0。interval = 100ms 时,while 会连续补 20 个点。
补 20 个点本身不算灾难,但如果卡顿 30 秒(比如系统休眠唤醒),
会补 300 个点------一次 Tick 里 300 次 Push + 300 次 RecalcRange(每次 O(n)),
直接卡死。
夹到 4 个意味着:卡顿后最多"追" 4 个点,剩下的丢弃 。曲线会有一个小缺口,
但不会卡死。这是实时显示的合理取舍。
2.3 外部喂数自动关闭演示
cpp
void CCRunCurveChart::PushValue(double dValue)
{
// 外部喂数就关掉演示波形,避免两条数据源打架
m_bDemoWave = false;
m_series.Push(dValue);
if (m_bAutoScale) RecalcRange();
StartTick();
Invalidate();
}
一行 m_bDemoWave = false 就完成了"演示 → 生产"的切换。
不需要用户显式调 SetDemoWave(false)------第一次 PushValue 就自动切。
这样集成时"先看演示效果,再接真实数据"是无缝的。
三、曲线绘制:三段
cpp
void CCRunCurveChart::PaintCNContent(HDC hDC, const RECT& rcPaint)
{
(void)rcPaint;
RECT rcPlot = GetPlotRect();
if (CC::IsRectBlank(rcPlot)) return;
CC::FillRoundRect(hDC, rcPlot, 2, m_dwPlotBackColor);
PaintGrid(hDC, rcPlot); // 1. 网格 + Y 刻度
PaintCurve(hDC, rcPlot); // 2. 曲线 + 填充 + 指示点 + 横线
PaintReadout(hDC, rcPlot); // 3. 顶部当前值读数
// 外框
CC::StrokeRoundRect(hDC, rcPlot, 2, 1, 0xFF39424C);
}
3.1 绘图区留顶部给读数
cpp
RECT CCRunCurveChart::GetPlotRect() const
{
RECT rc = m_rcItem;
rc.left += 32; // Y 刻度文字
rc.top += 22; // ← 顶部留给当前值读数
rc.bottom -= 6;
rc.right -= 6;
if (CC::IsRectBlank(rc)) { RECT empty = { 0, 0, 0, 0 }; return empty; }
return rc;
}
rc.top += 22 是给顶部读数留位置。读数画在 m_rcItem.top + 2 到 rcPlot.top - 2
的区间里(正好 20px 高)。
读数为什么在顶部而不是在曲线上 :曲线上方通常是空的,放在那里不挡数据;
放在曲线上会遮住最近的采样点。
四、曲线 + 填充
cpp
void CCRunCurveChart::PaintCurve(HDC hDC, const RECT& rcPlot)
{
int nCount = m_series.GetCount();
if (nCount < 2) return;
int nW = CC::RectWidth(rcPlot);
int nH = CC::RectHeight(rcPlot);
if (nW <= 0 || nH <= 0) return;
double dSpan = m_dMaxY - m_dMinY;
if (dSpan == 0.0) dSpan = 1.0;
int nCap = CC::MaxOf(m_series.GetCapacity(), nCount);
double dStepX = (nCap > 1) ? (double)nW / (double)(nCap - 1) : (double)nW;
std::vector<POINT> pts;
pts.reserve((size_t)nCount);
for (int i = 0; i < nCount; ++i) {
double v = m_series.At(i);
double yRatio = (v - m_dMinY) / dSpan;
yRatio = CC::Clamp01(yRatio);
// 最新点在右边
double x = (double)rcPlot.right - (double)(nCount - 1 - i) * dStepX;
double y = (double)rcPlot.bottom - yRatio * (double)nH;
POINT p;
p.x = (int)(x + 0.5);
p.y = (int)(y + 0.5);
pts.push_back(p);
}
/* 填充 + 曲线 + 指示点 + 横线 */
}
X 步进按容量 算(nCap),和 MultiCurveUI 一样的道理------数据填满前曲线从
右侧逐渐长出来。
4.1 下方填充:一段废弃的路径代码
cpp
// 曲线下方填充
if (m_bFill && m_nFillAlpha > 0 && pts.size() >= 2) {
std::vector<POINT> poly;
poly.reserve(pts.size() + 2);
poly.push_back(pts[0]);
for (size_t i = 1; i < pts.size(); ++i) poly.push_back(pts[i]);
POINT pBr; pBr.x = pts.back().x; pBr.y = rcPlot.bottom; poly.push_back(pBr); // 右下角
POINT pBl; pBl.x = pts[0].x; pBl.y = rcPlot.bottom; poly.push_back(pBl); // 左下角
HBRUSH hBrush = ::CreateSolidBrush(RGB(...));
if (hBrush != NULL) {
HPEN hPen = ::CreatePen(PS_NULL, 0, 0);
HGDIOBJ hOldBrush = ::SelectObject(hDC, hBrush);
HGDIOBJ hOldPen = ::SelectObject(hDC, hPen);
// 用 1/4 的浅色做填充,避免盖住网格
int nSaved = ::SaveDC(hDC);
::BeginPath(hDC);
::Polygon(hDC, &poly[0], (int)poly.size());
::EndPath(hDC);
if (nSaved != 0) ::RestoreDC(hDC, nSaved); // ← 这里把路径丢掉了
// GDI 填充不能带 alpha,改用 AlphaBlend 叠一层薄色
::SelectObject(hDC, hOldBrush);
::SelectObject(hDC, hOldPen);
::DeleteObject(hBrush);
::DeleteObject(hPen);
CC::FillRectAlpha(hDC, rcPlot, m_dwCurveColor,
(BYTE)CC::MinOf(m_nFillAlpha / 2, 40)); // ← 实际填充是这个
}
}
这段代码有个明显的历史痕迹 :先构造了精确的多边形(曲线 + 底边),
BeginPath / Polygon / EndPath 也调了,然后 RestoreDC 把路径丢掉------
精确填充没生效。
实际起作用的最后一句:
cpp
CC::FillRectAlpha(hDC, rcPlot, m_dwCurveColor, MinOf(m_nFillAlpha / 2, 40));
它把整个绘图区盖一层 alpha ≤ 40 的淡色。
所以当前的"填充"效果是:整块绘图区被染上一层很淡的曲线色 ,而不是
"曲线下方填充、曲线上方透明"。
4.2 为什么保留这个半成品
要真正做"曲线下方填充",需要:
cpp
// 正确做法:路径填充到 32bpp DIB,再 AlphaBlend
HDC hMem = ::CreateCompatibleDC(hDC);
// ... 创建 32bpp DIB,选入 hMem
::BeginPath(hMem);
::Polygon(hMem, &poly[0], (int)poly.size());
::EndPath(hMem);
::SelectClipPath(hMem, RGN_OR); // ← 关键:把路径变成裁剪区
::FillRect(hMem, &rcAll, hBrush); // 用带 alpha 的画刷填
// ... AlphaBlend 回 hDC
或者更简单:用 SetROP2 + 点画法,或者接受"不透明填充 + 曲线压在上面"。
Polygon + SelectClipPath 这条路在 GDI 里可行,但需要额外的离屏位图。
当前用"整块淡色"是因为:
- 效果可接受------曲线下方和上方都被染了一点,但曲线本身(不透明)还是清晰;
- 零额外内存;
alpha ≤ 40(15%)足够淡,不干扰网格。
如果要精确填充,按上面的 DIB 路径改。这是本插件最值得改进的地方。
4.3 指示点 + 横线
cpp
CC::StrokePolyline(hDC, &pts[0], (int)pts.size(), m_nCurveWidth, m_dwCurveColor);
// 当前值指示点
CC::FillCircle(hDC, pts.back().x, pts.back().y, 3, m_dwCurveColor);
// 当前值横线
if (m_bValueLine) {
CC::DrawSegment(hDC, rcPlot.left, pts.back().y, rcPlot.right, pts.back().y,
1, 0x66FFFFFF & 0x00FFFFFF | 0xFF000000); // ← 这行颜色表达式有问题
}
最后那行颜色表达式是错的:
cpp
0x66FFFFFF & 0x00FFFFFF | 0xFF000000
按 C 运算符优先级,& 高于 |,所以是:
cpp
(0x66FFFFFF & 0x00FFFFFF) | 0xFF000000
= 0x00FFFFFF | 0xFF000000
= 0xFFFFFFFF // 纯白,完全不透明
作者的意图大概是 0x66FFFFFF(alpha=0x66 的白色),但经过 & 0x00FFFFFF
把 alpha 抹掉又 | 0xFF000000 设成不透明------结果就是纯白实线。
而 DrawSegment → StrokePolyline → CreatePen 只取 RGB 部分:
cpp
::CreatePen(PS_SOLID, nWidth, RGB((dwColor >> 16) & 0xFF, (dwColor >> 8) & 0xFF, dwColor & 0xFF));
所以 alpha 根本不起作用,画出来就是一条 1px 纯白横线。
如果要半透明白横线 ,CreatePen 做不到(GDI 画笔无 alpha)。
正确做法是用 FillRectAlpha 画一条 1px 高的矩形:
cpp
RECT rcLine = { rcPlot.left, pts.back().y, rcPlot.right, pts.back().y + 1 };
CC::FillRectAlpha(hDC, rcLine, 0xFFFFFFFF, 0x66);
当前效果其实可接受 (白色横线在深色背景上很清晰),只是那行表达式让人困惑。
建议简化成 0xFFFFFFFF 并在注释里说明"GDI 画笔不支持 alpha"。
五、顶部读数
cpp
void CCRunCurveChart::PaintReadout(HDC hDC, const RECT& rcPlot)
{
if (!m_bShowValue) return;
double dValue = GetLastValue();
TCHAR szBuf[64];
if (m_sUnit.IsEmpty()) {
_stprintf_s(szBuf, _T("%.2f"), dValue);
}
else {
_stprintf_s(szBuf, _T("%.2f %s"), dValue, m_sUnit.GetData());
}
HFONT hFont = m_fontValue.Get(13, true); // 13px 粗体
/* 选字体、SetBkMode、SetTextColor(用曲线色) */
RECT rcText;
rcText.left = rcPlot.left;
rcText.right = rcPlot.right;
rcText.top = m_rcItem.top + 2;
rcText.bottom = rcPlot.top - 2; // ← 正好在绘图区上方
::DrawText(hDC, szBuf, -1, &rcText, DT_RIGHT | DT_VCENTER | DT_SINGLELINE);
/* 还原字体 */
}
- 右对齐:数字靠右,和"最新数据在右边"的视觉方向一致;
- 用曲线色:读数和曲线同色,一眼对应;
%.2f固定两位 :曲线控件不提供decimals属性(和仪表盘不同),
因为实时曲线的读数变化快,固定格式更稳定(不会因位数变化而跳动)。
GetLastValue():
cpp
double CCRunCurveChart::GetLastValue() const
{
int n = m_series.GetCount();
return (n > 0) ? m_series.At(n - 1) : 0.0; // ← 空序列返回 0
}
空序列时读数是 0.00------看起来像"当前值 0"而不是"没数据"。
这是个小瑕疵,可以改成显示 --:
cpp
if (m_series.GetCount() <= 0) { _stprintf_s(szBuf, _T("--")); }
六、Y 刻度:和 MultiCurveUI 同一套自适应
cpp
// 按量程跨度选刻度格式:跨度大用整数,跨度小才带小数,
// 避免出现 111.4 / 99.74 这种看着别扭的刻度。
double dSpan = m_dMaxY - m_dMinY;
int nDecimals = 0;
if (dSpan < 1.0) nDecimals = 3;
else if (dSpan < 10.0) nDecimals = 2;
else if (dSpan < 100.0) nDecimals = 1;
for (int i = 0; i <= nDiv; ++i) {
double dValue = m_dMaxY - dSpan * (double)i / (double)nDiv;
...
}
nDiv = 4 是写死的(4 等分 = 5 条横线),没有像 MultiCurveUI 那样开放成属性。
理由:单曲线图的刻度不需要那么多档,固定 4 等分最清爽。
七、自动量程
cpp
void CCRunCurveChart::RecalcRange()
{
if (m_series.GetCount() <= 0) return;
double lo = m_series.Min();
double hi = m_series.Max();
double dSpan = hi - lo;
if (dSpan < 1e-6) {
double dPad = (fabs(hi) > 1.0) ? fabs(hi) * 0.1 : 1.0;
lo -= dPad;
hi += dPad;
}
else {
lo -= dSpan * 0.1;
hi += dSpan * 0.1;
}
m_dMinY = lo;
m_dMaxY = hi;
}
和 MultiCurveUI::RecalcRange 逻辑相同(全平给 ±10%、非全平各留 10% 余量)。
但这里有个副作用 :演示波形本身幅度是"量程的 28%",而 RecalcRange 又把
量程收紧到"数据范围的 ±10%"。所以演示时量程会不断收缩 ,最终稳定在
波形实际摆动范围附近。
这是预期的------autoscale="true" 就是"跟着数据缩放"。如果想让演示波形
始终占满固定的量程,设 autoscale="false" min="0" max="120"。
八、属性表
| 属性 | 值 | 说明 |
|---|---|---|
capacity |
int | 环形缓冲容量,默认 300 |
interval / sampleinterval |
int | 自动采样周期 ms,默认 100;0 = 只接受外部 Push |
running |
bool | 是否在跑,默认 true |
autoscale |
bool | 自动量程,默认 true |
min |
double | 手动量程下限 |
max |
double | 手动量程上限 |
curvecolor |
color | 曲线色,默认 #FF35C0FF |
fill |
bool | 下方填充,默认 true |
fillalpha |
int | 填充透明度,夹到 0--255,默认 50 |
curvewidth |
int | 线宽,夹到 1--8,默认 2 |
grid |
bool | 网格,默认 true |
valueline |
bool | 当前值横线,默认 true |
showvalue |
bool | 顶部读数,默认 true |
unit |
字符串 | 单位 |
plotcolor / plotbackcolor |
color | 绘图区底色,默认 #FF151B21 |
gridcolor |
color | 网格色,默认 #FF2A333C |
textcolor |
color | 刻度文字色,默认 #FFB8C6D4 |
demowave |
bool | 演示波形,默认 true;外部 PushValue 后自动关 |
push |
double | XML/脚本喂一个点 |
cleardata |
任意 | 清空数据 |
只读:pointcount、lastvalue、min、max、capacity。
九、XML 示例
xml
<!-- 标准用法:100ms 采样 -->
<RunCurveChart capacity="300" interval="100" autoscale="true"
curvecolor="#FF35C0FF" fill="true" unit="kw/h"
width="360" height="160" />
<!-- 固定量程 + 关掉填充 -->
<RunCurveChart min="0" max="500" autoscale="false"
fill="false" grid="true" curvewidth="2"
unit="A" width="400" height="180" />
<!-- 关掉当前值横线(曲线很密时避免糊) -->
<RunCurveChart demowave="false" interval="0" capacity="600"
unit="V" width="380" height="170" />
<!-- 关掉演示波形(纯外部喂数) -->
<RunCurveChart valueline="false" curvewidth="3" unit="rpm"
width="420" height="200" />
9.1 纯外部喂数模式
xml
<RunCurveChart demowave="false" interval="0" />
interval="0" → OnTick 里 if (m_nSampleInterval <= 0) return; 直接返回,
完全不自己采样。数据全靠 PushValue。
9.2 C++ 喂数
cpp
CCRunCurveChart* pCurve = static_cast<CCRunCurveChart*>(
m_pm.FindControl(_T("runCurve")));
// 每 100ms 调一次(可以用 DuiLib 定时器或自己的线程投递到 UI 线程)
pCurve->PushValue(GetCurrentSpeed());
或者用属性(脚本友好):
cpp
pCurve->SetAttribute(_T("push"), _T("45.5"));
9.3 显示效果

十、踩过的坑
10.1 nGuard < 4 必须留
见 2.2。不夹的话系统休眠唤醒后会一次补几百个点,直接卡死。
10.2 填充是"整块淡色"不是"下方填充"
见 4.1 / 4.2。当前实现是 FillRectAlpha(rcPlot, ...) 盖整块,
精确的多边形填充代码存在但被 RestoreDC 丢弃了。
10.3 横线颜色表达式是恒等变换
见 4.3。0x66FFFFFF & 0x00FFFFFF | 0xFF000000 等于 0xFFFFFFFF。
而且 GDI 画笔不支持 alpha,想半透明必须用 FillRectAlpha。
10.4 空序列读数是 0.00
见第五节。看起来像"当前值 0",建议改成 --。
10.5 演示波形下量程会收缩
见第七节。autoscale="true" 时量程跟着数据范围收紧,演示时量程会一直变小。
要固定就 autoscale="false"。
十一、空状态处理
| 状态 | 行为 |
|---|---|
无数据(m_series 空) |
PaintCurve 里 nCount < 2 返回;PaintReadout 显示 0.00;网格、刻度、外框正常 |
interval = 0 + 无外部 Push |
曲线永久空白,但有网格和刻度------看起来"待机" |
demowave="false" + 无外部 Push |
同上 |
| 控件太小 | GetPlotRect 返回空矩形 → PaintCNContent 首句返回,什么都不画 |