Vector or matrix — This format defines indexed image data. Each element defines a color for one pixel of the image. The elements map to colors in the colormap. The CDataMapping property controls the mapping method.

3-D array of RGB triplets — This format defines true color image data using RGB triplet values. Each RGB triplet defines a color for one pixel of the image. An RGB triplet is a three-element vector that specifies the intensities of the red, green, and blue components of the color. The first page of the 3-D array contains the red components, the second page contains the green components, and the third page contains the blue components. Since the image uses true colors instead of colormap colors, the CDataMapping property has no effect.

'direct' — Interpret the values as indices into the current colormap. Values with a decimal portion are fixed to the nearest lower integer.

'scaled' — Scale the values to range between the minimum and maximum color limits. The CLim property of the axes contains the color limits.

Scalar — Use a consistent transparency across the entire image.

Array the same size as CData — Use a different transparency value for each image element.

'none' — Interpret the values as transparency values. A value of 1 or greater is completely opaque, a value of 0 or less is completely transparent, and a value between 0 and 1 is semitransparent.

'scaled' — Map the values into the figure’s alphamap. The minimum and maximum alpha limits of the axes determine the alpha data values that map to the first and last elements in the alphamap, respectively. For example, if the alpha limits are [3 5], then alpha data values less than or equal to 3 map to the first element in the alphamap. Alpha data values greater than or equal to 5 map to the last element in the alphamap. The ALim property of the axes contains the alpha limits. The Alphamap property of the figure contains the alphamap.

'direct' — Interpret the values as indices into the figure’s alphamap. Values with a decimal portion are fixed to the nearest lower integer:

'nearest' — This method is best when there are a small number of pixel values that represent distinct categories, or when you want to see individual pixels in a highly zoomed-in view. The value of a pixel located at (x, y) is the value of the pixel that is closest to (x, y) in the original image.

'bilinear' — This method is best in almost all other situations. The value of a pixel located at (x, y) is a weighted average of the surrounding pixels in the original image. To minimize display artifacts, additional smoothing is applied when you shrink the image. If your MATLAB session or figure is using the Painters renderer, then there is no additional smoothing when the image shrinks. To determine the renderer, call the rendererinfo function.

Two-element vector — Use the first element as the location for the center of CData(1,1) and the second element as the location for the center of CData(m,n), where [m,n] = size(CData). Evenly distribute the centers of the remaining CData elements between those two points.

The width of each pixel is determined by the expression:

(XData(2)-XData(1))/(size(CData,2)-1)

If XData(1) > XData(2), then the image is flipped left-right.

Scalar — Center CData(1,1) at this location and each following element one unit apart.

Two-element vector — Use the first element as the location for the center of CData(1,1) and the second element as the location for the center of CData(m,n), where [m,n] = size(CData). Evenly distribute the centers of the remaining CData elements between those two points.

The height of each pixel is determined by the expression:

(YData(2)-YData(1))/(size(CData,1)-1)

If YData(1) > YData(2), then the image is flipped up-down.

Scalar — Center CData(1,1) at this location and each following element one unit apart.

'on' — Display the object.

'off' — Hide the object without deleting it. You still can access the properties of an invisible object.

'on' — Selected. If you click the object when in plot edit mode, then MATLAB sets its Selected property to 'on'. If the SelectionHighlight property also is set to 'on', then MATLAB displays selection handles around the object.

'off' — Not selected.

'on' — Display selection handles when the Selected property is set to 'on'.

'off' — Never display selection handles, even when the Selected property is set to 'on'.

A value of 'on' clips parts of the object that are outside the axes limits.

A value of 'off' displays the entire object, even if parts of it appear outside the axes limits. Parts of the object might appear outside the axes limits if you create a plot, set hold on, freeze the axis scaling, and then create the object so that it is larger than the original plot.

Function handle

Cell array containing a function handle and additional arguments

Character vector that is a valid MATLAB command or function, which is evaluated in the base workspace (not recommended)

Clicked object — Access properties of the clicked object from within the callback function.

Event data — Empty argument. Replace it with the tilde character (~) in the function definition to indicate that this argument is not used.

Function handle.

Cell array in which the first element is a function handle. Subsequent elements in the cell array are the arguments to pass to the callback function.

Character vector containing a valid MATLAB expression (not recommended). MATLAB evaluates this expression in the base workspace.

Function handle.

Cell array in which the first element is a function handle. Subsequent elements in the cell array are the arguments to pass to the callback function.

Character vector containing a valid MATLAB expression (not recommended). MATLAB evaluates this expression in the base workspace.

The running callback is the currently executing callback.

The interrupting callback is a callback that tries to interrupt the running callback.

A value of 'on' allows other callbacks to interrupt the object's callbacks. The interruption occurs at the next point where MATLAB processes the queue, such as when there is a drawnow, figure, uifigure, getframe, waitfor, or pause command.

A value of 'off' blocks all interruption attempts. The BusyAction property of the object owning the interrupting callback determines if the interrupting callback is discarded or put into a queue.

The running callback is the currently executing callback.

The interrupting callback is a callback that tries to interrupt the running callback.

'queue' — Puts the interrupting callback in a queue to be processed after the running callback finishes execution.

'cancel' — Does not execute the interrupting callback.

'visible' — Capture mouse clicks only when visible. The Visible property must be set to 'on'. The HitTest property determines if the Image object responds to the click or if an ancestor does.

'none' — Cannot capture mouse clicks. Clicking the Image object passes the click to the object behind it in the current view of the figure window. The HitTest property of the Image object has no effect.

'on' — Trigger the ButtonDownFcn callback of the Image object. If you have defined the ContextMenu property, then invoke the context menu.

'off' — Trigger the callbacks for the nearest ancestor of the Image object that has one of these:

'on' — Object handle is always visible.

'off' — Object handle is invisible at all times. This option is useful for preventing unintended changes by another function. Set the HandleVisibility to 'off' to temporarily hide the handle during the execution of that function.

'callback' — Object handle is visible from within callbacks or functions invoked by callbacks, but not from within functions invoked from the command line. This option blocks access to the object at the command line, but permits callback functions to access it.