slreportgen.report.Diagram类

包:slreportgen.report

创建图本报记者

描述

创建一个图记者,包括图快照,标题,为的Simulink金宝app®或Stateflow的®图。

注意

要在报告中使用图记者,您必须使用创建报告slreportgen.report.Report类。

施工

=图()创建一个空的图记者。设置其属性捕获的Simulink或Stateflow的图。金宝app

=图(资源用于通过指定的Simulink的或Stateflow的图创建的图记者金宝app资源。添加本报记者的一份报告创建图表的快照。然后,快照显示在报告作为与字幕的图像。快照图像存储在该报告的临时文件夹。当报告被关闭,快照映像复制到报告,然后,将图像从临时文件夹中删除。为了防止被删除,快照的影像文件,请使用调试该报告的财产。看到slreportgen.report.Report

=图(名称,值设定使用的名称 - 值对的特性。您可以按任意顺序指定多个名称 - 值对的参数。用单引号或双引号中每个属性的名称。

输入参数

展开全部

查看资源属性。

属性

展开全部

图快照图像源,指定为这些值中的一个。

  • 打开或加载Simulink模型的名称金宝app

  • 一个Simulink金宝app的子系统块的路径包含的Simulink图或Stateflow框图

  • slreportgen.finder.DiagramResult宾语

  • 处理至含有Simulink的图或Stateflow框图子系统块金宝app

  • Stateflow.Chart或状态流subchart对象。Subcharts是可以包含相同的对象作为一个顶层的图表,包括其它subcharts图形对象。Subcharts由一般规定Stateflow.StateStateflow.Function, 要么Stateflow.Box宾语。

快照记者,默认设置为的对象mlreportgen.report.FormalImage类。你并不需要自己设置该属性。该FormalImage对象添加图快照的报告。要控制快照的大小,设置mlreportgen.report.FormalImage属性。

图区域在快照捕获,指定为1×4阵列双打。数组的前两个值是Xÿ坐标,以像素为单位的顶部在Simulink编辑器坐标空间留下的图面积的角落。金宝app最后两个值的宽度和高度,以像素为单位。空数组指定整个图。

您可以设置认为,要在Simulink编辑器捕获,然后设置金宝appSnapshotArea属性的输出slreportgen.utils.getCurrentEditorView功能。对于一个示例,请参见以一个框图中的部分的快照

快照图像格式,指定为字符向量或标量的字符串。金宝app支持的格式有:

  • 'BMP'- 位图图像。

  • 'GIF'- 图形交换格式。

  • 'JPG'- JPEG图像。

  • 'PNG'- PNG图像。

  • 'EMF'- 增强型图元文件,在Windows上的D金宝appOCX输出仅支持®平台。

  • 'SVG'- 可伸缩矢量图形。

  • 'TIF'- 标签图像文件格式,在HTML输出不支持。金宝app

  • 'PDF'- PDF图像。

看到兼容性注意事项

选择包括各图元件的超链接,指定为逻辑。如果此属性为真正中,每个元素变成在描述它的报告对象的超链接。此属性仅适用于PDF和HTML报告。超链接允许您使用导航Simulink和Stateflow图的报告。金宝app

金宝appSimulinkObjectPropertiesStateflowObjectProperties记者一起工作使用超链接,使导航。每个记者序言它与超链接的目标创建报表对象。该目标的ID是基于模型中的报道元件的路径上。的图解记者还覆盖与超链接到相应的基于元素的目标ID的图快照的元素。到其中一个图元素链接的报告对象依赖于元素类型。

  • 基于图块(子系统,图表,模型)链接到块的图。

  • 其他区块链接到文本块的描述,通常阻止属性表。

  • 具有掩模参数掩蔽子系统块链接到块,的文本描述诸如掩模的参数表。这种连接的文字描​​述是只有真正的MaskedSystemLinkPolicy该图记者的属性设置为'块'要么'默认'。否则,屏蔽系统块链接到它的图。

  • 不具有掩模参数掩蔽子系统块链接到块的图。

要定制基于图的导航,创建自定义链接目标基于生成的目标IDslreportgen.utils.getObjectID实用功能。

政策确定屏蔽系统模块的超链接,指定为这些值的一个目标。

  • '默认'- 蒙面具有参数链接到文本描述,如掩模参数表系统块。不具有参数掩蔽系统块链接到该报告中的对应的方框图。

  • '系统'- 屏蔽系统模块链接到他们的框图报告。

  • '块'- 掩蔽系统块链接到他们的文本描述,例如掩蔽参数或子系统的参数表。

对于图快照图像缩放选项,指定为字符串,汽车习惯, 要么放大缩放控制尺寸的图像文件中的图快照图像的。

  • 汽车- 对于PDF或Word(DOCX)输出,汽车缩放图快照图像,以适应当前的页面布局,同时保持其高宽比。首先,图快照图像被缩放到页面宽度。如果图像高度超过页面高度,则图像被再次缩小。这种额外的缩放保证,在当前页面的图像拟合一个额外的1" 间隔。额外的间距允许额外的文本,如标题,缩放不适用于HTML输出。

  • 习惯- 缩放基于所述值的图快照图像高度宽度性能

  • 放大- 放大或缩小快照影像尺寸于由指定的百分比值放大属性。指定最大图像高度和最大图像宽度,使用最大高度MaxWidth特性,分别。

注意

一种java.lang.OutOfMemoryError当发生任何的属性设置这些组合中,可能会发生:

  • 缩放调成放大放大最大高度MaxWidth属性设定为大的值

  • 缩放调成习惯高度宽度属性设定为大的值

为了避免这种错误,变焦缩放,使用较小放大最大高度MaxWidth属性值。对于自定义缩放,使用较小高度宽度属性值。使用较小的值保证了页面上的图拟合。

快照图像,指定为,它由一个数字的字符向量或标量的字符串的高度,随后为测量单位的缩写。例如,“2英寸”指定两英寸。有效的缩写是:

  • PX- 像素(默认)

  • 厘米- 厘米

  • - 英寸

  • 毫米- 毫米

  • 个人计算机- 派卡

  • PT- 分

例:“2英寸”

快照图像,指定为,它由一个数字的字符向量或标量的字符串的宽度,接着为测量单位的缩写。例如,“2英寸”指定两英寸。有效的缩写是:

  • PX- 像素(默认)

  • 厘米- 厘米

  • - 英寸

  • 毫米- 毫米

  • 个人计算机- 派卡

  • PT- 分

例:“3英寸”

量的放大图快照图像,指定为字符串。该放大格式%,其中是,通过该图的快照图像被放大或缩小的百分比。

对于变焦倍数最大高度,指定为字符串。此属性仅适用于缩放被设定为放大

最大高度格式valueUnits,其中单位对于高度单位的缩写和是单位数。查看高度财产的有效表单位缩写。

变焦缩放最大宽度,指定为字符串。此属性仅适用于缩放被设定为放大

MaxWidth格式valueUnits,其中单位对于高度单位的缩写和是单位数。查看高度财产的有效表单位缩写。

模板为此记者,在这些方式中的一种指定的来源:

  • 指定文件包含模板为此记者路径矢量字符或字符串标量

  • 记者或报告其模板用于记者或它的模板库中包含了本报记者的模板

  • DOM文档或文档的一部分,其模板用于记者或它的模板库中包含了本报记者的模板

指定的模板必须是同一类型的哪个记者附加的报告。例如,对于一个微软®报告,TemplateSrc必须是一个Word模板记者。如果TemplateSrc属性为空,记者使用默认的记者模板报表的输出类型。

模板为此记者,指定为文字载体或串标名称。为此记者模板是在模板源的模板库(TemplateSrc)对本报记者表示。

超链接目标为此记者,指定为字符向量或标量的字符串指定链接目标ID,或mlreportgen.dom.LinkTarget宾语。字符向量或串标量值变换为LinkTarget宾语。链接目标对象立即之前本报记者在输出报告的内容。

方法

createTemplate 创建图模板
customizeReporter 创建自定义图记者班
getClassFolder 图表类定义文件的位置
getSnapshotImage 图快照映像文件位置

继承的方法

getImpl 获取执行记者

复制语义

处理。要了解手柄类如何影响复制操作,请参阅复制对象(MATLAB)。

例子

添加模型图的顶级

添加的顶级的快照VDP模型的报告。

load_system( 'VDP')进口slreportgen.report *进口mlreportgen.report * RPT = slreportgen.report.Report( '输出', 'PDF')。;章=章();chapter.Title =“图记者实施例”;图=图( “VDP”);diagram.Snapshot.Caption =“坡方程面包车”;diagram.SnapshotFormat = 'SVG';diagram.Snapshot.Height = '4英寸';添加(章,图);添加(RPT,章);rptview(RPT);

添加超链接图的报告

创建一个PDF报告,并添加从根系统的框图快照和子系统sf_car模型它。超链接添加到传输子系统,并添加一个段落的对象而该链接。

进口mlreportgen.report *进口slreportgen.report *进口slreportgen.utils *进口mlreportgen.dom * RPT = slreportgen.report.Report( '输出', 'PDF')。。章=章( 'sf_car');load_system( 'sf_car');DIAG1 =图( 'sf_car');diag1.Snapshot.Caption = '根系:sf_car';添加(章,DIAG1);添加(章,分页符);DIAG2 =图( 'sf_car /发动机');diag2.Snapshot.Caption = '子系统:sf_car /发动机';添加(章,DIAG2); add(chapter, PageBreak); para = Paragraph('Custom target for sf_car/transmission'); id = getObjectID('sf_car/transmission'); append(para,mlreportgen.dom.LinkTarget(id)); add(chapter,para); add(chapter,PageBreak); add(rpt, chapter); close(rpt); rptview(rpt);

以一个框图中的部分的快照

使用SnapshotArea属性来指定图来拍摄快照的区域。这个例子中设置在Simulink编辑器中的视图,然后设置金宝appSnapshotArea属性通过调用视图slreportgen.utils.getCurrentEditorView

打开模型。

F14

在Simuli金宝appnk编辑器中,显示要在快照中捕捉到图的一部分。通过调用获取当前的Simulin金宝appk编辑器视图区域slreportgen.utils.getCurrentEditorView

editorViewArea = getCurrentEditorView();

创建报告和图记者。将图快照区域当前编辑的可视面积。图记者添加到报表。

进口slreportgen.report。*进口Slreportgen.utils。*RPT =报告(“输出”'PDF');DIAG =图('F14');diag.SnapshotArea = editorViewArea;添加(RPT,诊断);关闭(RPT);rptview(RPT);

兼容性注意事项

展开全部

行为R2019b改变

介绍了在R2017b