mlreportgen.dom.Image class

Package: mlreportgen.dom
Superclasses:

Create image to include in report

Description

Create an image to include in a report.

Construction

imageObj = mlreportgen.dom.ImageImage(imagePath) creates an image object containing the image file specified by imagePath.

The contents of the specified image file are copied into the output document when the document is closed. Do not delete the original file before it is copied into the document.

Input Arguments

imagePath — Path of image file

character vector

Path of an image file, specified as a character vector. You can use these image formats.

Image Format	File Extension	Supported Document Type
		HTML	Word	PDF
Windows® bitmap	.bmp
Windows metafile	.emf
Graphics Interchange Format	.gif
JPEG image	.jpg
PDF	.pdf
Portable Network Graphics	.png
Scalable Vector Graphics	.svg
TIFF image	.tif

Output Arguments

imageObj — Image

mlreportgen.dom.Image object

Image represented by an mlreportgen.dom.Image object.

Properties

CustomAttributes — Custom attributes of document element

array of mlreportgen.dom.CustomAttribute objects

The output format must support the custom attributes of this document element.

Height — Watermark height

character vector

Watermark height, specified in the form valueUnits. Use any of these values for units:

• px — pixels (default)

• cm — centimeters

• in — inches

• mm — millimeters

• pc — picas

• pt — points

Alternatively, you can specify the image height using the Image.Style property. For example:

Image.Style = {Height('4in')};

Example: '22pi'

Id — ID for document element

character vector

ID for this document element, specified as a character vector. The DOM generates a session-unique ID when it creates the document element. You can specify your own ID.

Map — Map of hyperlink areas in image (HTML and PDF)

mlreportgen.dom.ImageMap object

Map of hyperlink areas in image, specified as an mlreportgen.dom.ImageMap object

Path — Path of image file

character vector

Path of image file, specified as a character vector.

Style — Format specification

array of format objects

Format objects that specify the format of a document element.

StyleName — Name of image style

character vector

Name of image style, specified as a character vector. The style name is the name of a style specified in the style sheet of the document or document part to which this image is appended. The specified style defines the appearance of this image in the output document where not overridden by the formats specified by the Style property of this element.

Note

Word output ignores the style name.

Tag — Tag for document element

character vector

Tag for the document element, specified as a character vector.

The DOM generates a session-unique tag when it creates the document element. Structure the tag as class:id, where class is the class of the element and id is the value of the Id property. You can specify a tag to replace the generated tag. Specifying your own tag can make it easier to identify where an issue occurred during document generation.

Width — Image width

character vector

Image width in the form valueUnits, where Units is an abbreviation for the units. These abbreviations are valid:

• px — pixels (default)

• cm — centimeters

• in — inches

• mm — millimeters

• pc — picas

• pt — points

Methods

Method	Purpose
append Use Image.append in a similar way to how you use ExternalLink.append.	Append a custom element to this image.
clone Use Image.clone in a similar way to how you use Paragraph.clone.	Clone this image

Compatibility Considerations

SVG image support for Word reports

Behavior changed in R2019b

Starting in R2019b, you can include Scalable Vector Graphics (SVG) images in Word reports. Word reports that contain SVG images require Microsoft^® Word 2016 or a later version. To generate reports with images that are compatible with earlier versions of Word, create mlreportgen.dom.Image objects from images that have a format other than SVG.