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 = Image(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	Supported Output Formats
	HTML	Word	PDF
.bmp
.emf
.gif
.jpg
.png
.svg
.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 document element, specified as a character vector.

A session-unique ID is generated as part of document element creation. The generated tag has the form CLASS:ID, where CLASS is the class of the element and ID is the value of the Id property of the object. You can specify a tag to replace the generated tag.

For example, to make it easier to identify where an issue occurred during document generation, you can specify your own tag value.

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