Read - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

All Products    Maple    MapleSim


ImageTools

  

Read

  

read an image from a file or URL

 

Calling Sequence

Parameters

Options

Description

Examples

Compatibility

Calling Sequence

Read( file, img, opts )

Read( url, img, opts )

Parameters

file

-

string; the pathname of the image file to read

url

-

string; URL address of an image file to read

img

-

(optional) Image; rtable to read image into

opts

-

(optional) equation(s) of the form option = value; specify options for the Read command

Options

• 

format = BMP, JPEG, PNG, or TIFF

  

Specifies the image format. It must be one of the values in ImageTools[Formats]. If not specified, the Read command guesses the format from the extension of file.

• 

output = imgo

Specifies a data structure into which the output is written; imgo must be of type Image. The size must match that of the input. If imgo is one layer, then the image is converted to a grayscale, as needed. If imgo has four layers and the image file does not, then the fourth layer is set to all zeros. The default is NULL.

• 

datatype = float[8]

• 

datatype = integer[1]

Specifies if the created Image should use one 8-byte floating point value (the default) or one 1-byte integer value per channel per pixel. The former result in less degredation when manipulating the image (scaling, convolution, gamma adjustment, and so on), but requires 8 times the memory of the latter.

Description

• 

The Read command returns an Image read from an image file in one of the supported formats. After completing the read, the file is closed.

• 

The Read command can read most variations of the supported formats. Those that are not grayscale, RGB, or RGBA, such as YCbCr or color-mapped images, are converted to one of the supported formats while being read.

• 

The file parameter is the name of the file and it must be a Maple string. If the format option is not provided, the file format is determined from the extension of the file name. For example, the string image.jpg is read as a JPEG file.

• 

The optional img parameter is a data structure into which the image is written.  It must be of type Image and have the proper dimensions and layers for the image. Using the img parameter is equivalent to using the output option.

Examples

withImageTools:imgCreate100,200,r,c0.251+sin0.005+0.003cc1+sin0.15r,r,c0.51+exp0.02000000000rsin0.05000000000c,r,cr100.:

Writegood_img.jpg,img

4066

(5.1)

img2Readgood_img.jpg

Embedimg2

Compatibility

• 

The ImageTools[Read] command was updated in Maple 18.

See Also

ImageTools

ImageTools[Formats]

ImageTools[RGBtoGray]

ImageTools[Write]