11 · RunCurveChart —— 实时运行曲线

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 里可行,但需要额外的离屏位图。

当前用"整块淡色"是因为:

  1. 效果可接受------曲线下方和上方都被染了一点,但曲线本身(不透明)还是清晰;
  2. 零额外内存;
  3. 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 首句返回,什么都不画
相关推荐
Hhy_11073 小时前
《C++深度解构07》手撕 vector —— 从底层三指针架构到迭代器失效彻底吃透
c语言·开发语言·c++·学习·visual studio
艾莉丝努力练剑3 小时前
【QT】系统相关:TCP的API介绍
开发语言·前端·c++·人工智能·qt·学习·tcp/ip
青少儿编程课堂4 小时前
蓝桥杯·全国青少年信息素养大赛·电子学会Python/C++考级:中国剩余定理解析
c++·python·算法·bfs·信息学竞赛
wo_jack4 小时前
C++ 入门笔记(十八):list 进阶 —— const 迭代器、operator-> 与 clear 的坑
数据结构·c++·面试·stl·list
ShineWinsu5 小时前
对于Qt:QVBoxLayout常见属性以及方法的解析
开发语言·数据库·c++·qt·gui·客户端·布局管理器
ShineWinsu16 小时前
对于Qt:QFormLayout常见属性以及方法的解析
开发语言·c++·qt·面试·客户端·表单·qformlayout
kyle~17 小时前
嵌入式 SoC 系统
linux·c++·嵌入式·计算系统
爱写Bug的浮游20 小时前
C++移动构造真的比拷贝快吗
c++·性能优化
Aaa西红柿鸡蛋20 小时前
网络协议分析实验:基于 UDP 广播模型的 C/S 通信设计与实现
c++