Maple Professional
Maple Academic
Maple Student Edition
Maple Personal Edition
Maple Player
Maple Player for iPad
MapleSim Professional
MapleSim Academic
Maple T.A. - Testing & Assessment
Maple T.A. MAA Placement Test Suite
Möbius - Online Courseware
Machine Design / Industrial Automation
Aerospace
Vehicle Engineering
Robotics
Power Industries
System Simulation and Analysis
Model development for HIL
Plant Modeling for Control Design
Robotics/Motion Control/Mechatronics
Other Application Areas
Mathematics Education
Engineering Education
High Schools & Two-Year Colleges
Testing & Assessment
Students
Financial Modeling
Operations Research
High Performance Computing
Physics
Live Webinars
Recorded Webinars
Upcoming Events
MaplePrimes
Maplesoft Blog
Maplesoft Membership
Maple Ambassador Program
MapleCloud
Technical Whitepapers
E-Mail Newsletters
Maple Books
Math Matters
Application Center
MapleSim Model Gallery
User Case Studies
Exploring Engineering Fundamentals
Teaching Concepts with Maple
Maplesoft Welcome Center
Teacher Resource Center
Student Help Center
ImageTools[Read] - read an image from a file
Calling Sequence
Read( file, img, opts )
Parameters
file
-
string; the pathname of the 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
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.
Options
format = BMP, JPEG, 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 than the fourth layer is set to all zeros. The default is NULL.
Examples
See Also
ImageTools, ImageTools[Formats], ImageTools[RGBtoGray], ImageTools[Write]
Download Help Document
