File Exchange

image thumbnail


version (3.49 KB) by

Visually select a single image from an array of images in a directory.



View License

[img, map, alpha, filename, pathname, allFileNames] = uiselectim('start_path');

Provides functionality for visually selecting a single image from an array of images. All images must be in a common directory. Calls uigetfile with the multi-select option enabled, allowing the user to select any number of images. The layout tool will automatically display images in a subplot array. If you single-click an image, a background patch is highlighted to show the selection. Double-clicking (or selecting the "Okay" button) finalizes the selection, and returns the selected image (and map and alpha value, where appropriate), the filename, and the pathname.

start_path (optional): start_path specifies the directory to display when the dialog is first opened. If start_path is a string representing a valid directory path, the dialog box opens in the specified directory. If start_path is an empty string ('') or is not provided, the dialog box opens in the current working directory.

Output arguments 1--3 map to the output arguments of IMREAD. Note that MAP and ALPHA may be empty. FILENAME and PATHNAME, not surprisingly, return the filename and pathname of the selected image. ALLFILENAMES returns a (sorted) list of the names of all images selected for display in UISELECTIM. (See help for IMREAD for additional information about the first three output arguments.)

Comments and Ratings (3)


Juan (view profile)

Amit Shachaf

Very nice utility

Alex Leung

Great GUI to select an image!


Updated license


6/25/2010 Addressed minor comment issue.


Updated M file and license text file copyright to The MathWorks, Inc.


added copyright

MATLAB Release
MATLAB 7.3 (R2006b)

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video