让代码更简单

当前位置:代码狗 > 开发教程 > 工业视觉教程 > 正文

CogDisplay.CreateContentBitmap方法中文说明

重要:本文最后更新于2020-07-25 08:23:35,某些文章具有时效性,若有错误或已失效,请在下方留言或联系代码狗

以图片对象中的位图形式返回当前显示内容(图像和图形)。

命名空间: Cognex.VisionPro.Display
Assembly: Cognex.VisionPro.Display.Controls (in Cognex.VisionPro.Display.Controls.dll) Version: 55.0.0.0

方法原型

public virtual Image CreateContentBitmap(
CogDisplayContentBitmapConstants content,
[OptionalAttribute] CogRectangle contentRect,
[OptionalAttribute] int bitmapSize
)

参数

  • content
    类型:Cognex.VisionPro.Display.CogDisplayContentBitmapConstants
    要创建的内容位图的类型。
  • contentRect (Optional)
    类型:Cognex.VisionPro.CogRectangle
    显示中要返回为位图的矩形。
  • bitmapSize (Optional)
    类型:System.Int32
    请求的位图的最大尺寸。

返回值

类型:图像
返回图像

异常

Exception Condition
AxHost.InvalidActiveXStateException 当显示控件无效时引发。
CogException 发生以下情况之一时引发:BitmapSize小于0,如果无法分配返回位图,或者如果传递的内容rect无法映射到像素(#)空间,则出现CogSpaceTree错误。

content参数指定如何创建位图。

如果使用“自定义”作为内容参数,则contentRect和bitmapSize参数将指定显示图像的哪个部分用于创建位图。如果bitmapSize为零,则返回的位图是contentRect描述的图像的未缩放部分。如果bitmapSize不为零,则将其用作生成位图的最大维度,并且位图的纵横比与contentRect相同。

如果contentRect为空且bitmapSize为零,则返回的位图为显示的未缩放内容。

CogDisplayContentBitmapConstants

用于指定显示内容位图格式的枚举。

Member name Value Description
Custom 2 返回位图的内容由传递的内容矩形和位图大小决定。
Display 1 返回的位图正好包含显示中可见的内容。图像将按当前在显示中的显示方式进行缩放和平移,并在显示边界处剪裁图形注释。
Image 0 返回的位图包含完整的未缩放图像,其中图形注释在图像边界处被剪裁。

注意:使用Display方法保存图像时,请不要修改cogdisplayrecord控件大小,否则保存的图像大小会异常。特别是大家在做了UI自适应处理后,最小化操作会改变控件大小!

扩展阅读

VisionPro保存cogRecordDisplay图像

感觉很棒!可以赞赏支持我哟~

赞(0) 打赏

评论 抢沙发

×

请作者吃根烤肠!

支付宝