DA::DAAbstractWidgetOverlay类 参考

参照QwtWidgetOverlay的Widget Overlay 更多...

#include <DAAbstractWidgetOverlay.h>

类 DA::DAAbstractWidgetOverlay 继承关系图:

类
class	PrivateData

Public 类型
enum	MaskMode { NoMask , MaskHint , AlphaMask }
enum	RenderMode { AutoRenderMode , CopyAlphaMask , DrawOverlay }
	渲染模式 更多...

Public 槽
void	updateOverlay ()

Public 成员函数
	DAAbstractWidgetOverlay (QWidget *parent)
void	setMaskMode (MaskMode mode)
MaskMode	getMaskMode () const
void	setRenderMode (RenderMode mode)
RenderMode	getRenderMode () const
virtual bool	eventFilter (QObject *object, QEvent *event) override

静态 Public 成员函数
static QRegion	maskRegion (const QRect &r, int penWidth)
	矩形的遮罩区域计算
static QRegion	maskRegionVOrHLine (const QLine &VOrHLine, int penWidth)
	针对水平线或竖直线的遮罩区域计算

Protected 成员函数
virtual void	drawOverlay (QPainter *painter) const =0
	绘制遮罩层的主要业务实现函数
virtual QRegion	maskHint () const
	计算遮罩区的近似值
virtual void	paintEvent (QPaintEvent *event) override
virtual void	resizeEvent (QResizeEvent *event) override

详细描述

参照QwtWidgetOverlay的Widget Overlay

遮罩层的主要用例是为了避免对下层窗口进行繁重的重绘操作。 与绘图画布结合使用时，覆盖层可以避免重新绘制，因为画布的内容可以从其后备存储中恢复。

成员枚举类型说明

MaskMode

enum DA::DAAbstractWidgetOverlay::MaskMode

\brief 遮罩模式

当使用遮罩时，下层窗口仅会为覆盖层的遮罩区域接收绘制事件。 否则，Qt 会触发完整的重绘。在性能较低的硬件（如嵌入式系统）上， 或者在远程桌面上使用光栅绘制引擎时，位块传输是一个明显的操作，需要避免。

是否以及如何使用遮罩取决于遮罩计算的复杂度和遮罩可以排除多少像素。

默认设置为 MaskHint。

参见

setMaskMode(), maskMode()

枚举值
NoMask	不使用遮罩。
MaskHint	使用 maskHint() 作为遮罩 在许多情况下，快速近似就足够了，没有必要构建更详细的遮罩 （例如文本的边界矩形）。
AlphaMask	通过检查 alpha 值来计算遮罩 有时无法给出快速近似，需要通过绘制覆盖层并测试结果来计算遮罩。 当有一个有效的 maskHint() 时，只会检查该近似范围内的像素。

RenderMode

enum DA::DAAbstractWidgetOverlay::RenderMode

渲染模式

为了计算 alpha 遮罩，覆盖层已经被绘制到一个临时的 QImage 上。 可以避免两次渲染覆盖层，而是复制这个缓冲区来绘制覆盖层。

在使用光栅绘制引擎（QWS、Windows）的图形系统上，这通常只意味着复制一些内存。 在 X11 上，这会生成一个昂贵的操作来构建一个像素图，对于简单的覆盖层可能不推荐。

注解

当 maskMode() != AlphaMask 时，渲染模式无效。

枚举值
AutoRenderMode	使用光栅绘制引擎时复制缓冲区。（默认）
CopyAlphaMask	总是复制缓冲区
DrawOverlay	从不复制缓冲区

成员函数说明

drawOverlay()

virtual void DA::DAAbstractWidgetOverlay::drawOverlay ( QPainter *  painter ) const

protectedpure virtual

绘制遮罩层的主要业务实现函数

参数

painter

在 DA::DAGraphicsViewOverlayMouseMarker 内被实现.

eventFilter()

bool DA::DAAbstractWidgetOverlay::eventFilter ( QObject *  object, QEvent *  event  )

overridevirtual

被 DA::DAAbstractGraphicsViewOverlay 重载.

maskHint()

QRegion DA::DAAbstractWidgetOverlay::maskHint ( ) const

protectedvirtual

计算遮罩区的近似值

• MaskHint 遮罩建议区域。
• AlphaMask 用于加速从非透明像素计算掩码的算法。

• NoMask 不使用遮罩。

  默认实现返回一个无效区域，表示没有建议区域。

  返回

  遮罩的建议区域

被 DA::DAGraphicsViewOverlayMouseMarker 重载.

maskRegion()

QRegion DA::DAAbstractWidgetOverlay::maskRegion ( const QRect &  r, int  penWidth  )

static

矩形的遮罩区域计算

参数

r	矩形
penWidth	画笔宽度

返回

maskRegionVOrHLine()

QRegion DA::DAAbstractWidgetOverlay::maskRegionVOrHLine ( const QLine &  VOrHLine, int  penWidth  )

static

针对水平线或竖直线的遮罩区域计算

参数

VOrHLine	水平线或竖直线
penWidth	画笔的宽度

返回

---

该类的文档由以下文件生成:

• /home/runner/work/data-workbench/data-workbench/src/DAUtils/DAAbstractWidgetOverlay.h
• /home/runner/work/data-workbench/data-workbench/src/DAUtils/DAAbstractWidgetOverlay.cpp