uiimage

Создайте компонент изображения

Описание

im = uiimage создает компонент изображения на новом рисунке и возвращает Image объект. MATLAB® вызывает uifigure функция для создания нового рисунка. Использовать uiimage отображение изображения, значка или логотипа в вашем приложении.

im = uiimage(Name,Value) задает Image значения свойств с использованием одного или нескольких аргументов пары "имя-значение".

пример

im = uiimage(parent) создает компонент изображения в указанном родительском контейнере. Это родительский элемент может быть рисунок, созданная с помощью uifigure функции или одного из дочерних контейнеров.

пример

im = uiimage(parent,Name,Value) задает родительский контейнер и одно или несколько значений свойств.

Примеры

свернуть все

Создайте компонент изображения в рисунке. Изображение по умолчанию отображения.

fig = uifigure;
im = uiimage(fig);

Теперь добавьте изображение к компоненту изображения.

im.ImageSource = 'peppers.png';

Создайте компонент изображения, который отображает анимированный GIF с использованием фактического размера изображения.

fig = uifigure;
im = uiimage(fig,'ImageSource','questions.gif');
im.ScaleMethod = 'none';

Теперь масштабируйте изображение так, чтобы оно помещалось в пределах области компонента по умолчанию, сохраняя соотношение сторон и без усечения. Затем применить черный фон, чтобы создать внешний вид почтового ящика (черные полосы над и под изображением).

im.ScaleMethod = 'scaledown';
im.BackgroundColor = 'black';

Создайте изображение и коллбэк, которые выполняются при клике по изображению. В этом случае изображение открывает веб-сайт MathWorks ®.

Этот программный файл, называемый imagetoURL.m, показывает, как:

  • Создайте компонент изображения с ImageClickedFcn коллбэк.

  • Используйте web функция в обратном коллбэке для открытия внешнего URL-адреса в вашем системном браузере.

  • Создайте подсказку, которая появляется при наведении указателя мыши на изображение.

Когда вы запускаете файл программы, кликните изображение, чтобы открыть веб-сайт MathWorks ®.

function imagetoURL
fig = uifigure('Visible','off');
fig.Position(3:4) = [333 239];

im = uiimage(fig);
im.Position = [20 120 100 100];
im.ImageSource = 'membrane.png';
im.ImageClickedFcn = @ImageClicked;
im.Tooltip = 'Go to www.mathworks.com';

    function ImageClicked(src,event)
        url = 'https://www.mathworks.com/';
        web(url);
    end

fig.Visible = 'on';
end

Входные параметры

свернуть все

Родительский контейнер, заданный как Figure объект, созданный с использованием uifigure функция, или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция для создания нового Figure объект, который служит родительским контейнером.

Аргументы в виде пар имя-значение

Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.

Пример: im = uiimage('ScaleMethod','none')

Примечание

Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойств изображений».

Источник изображения или файл, заданный как путь к файлу или m-by- n-by-3 truecolor массив изображений. Поддерживаемые форматы изображений включают JPEG, PNG, GIF, SVG или m-by- n-by-3 truecolor массив изображений.

Для получения дополнительной информации об массивах изображений truecolor, см. «Типы изображений».

Пример: im = uiimage('ImageSource','peppers.png');

Пример: im.ImageSource = 'C:\TEMP\ngc6543a.jpg';

Метод масштабирования изображений, заданный как одно из значений, перечисленных в таблице. Используйте этот аргумент пары "имя-значение", чтобы задать способ визуализации изображения в области компонента.

Таблица также демонстрирует каждый метод шкалы с помощью примера изображения. В примерах визуализированных изображений BackgroundColor свойство компонента изображения установлено в 'magenta'. Поведение масштабирования файлов изображений SVG может варьироваться в зависимости от того, как определен файл.

ЗначениеОписаниеПримерШкалы вверхШкалы внизПоддерживает соотношение сторонИзображение клипса
Оригинальное изображениеВизуализированное изображение
'fit'Масштабирует в любом направлении, чтобы отобразить изображение в пределах области компонента, и поддерживает соотношение сторон без усечения.

ДаДаДаНет
'fill'Масштабируется в любом направлении, чтобы заполнить область компонента, сохраняя соотношение сторон и при необходимости обрезку.

ДаДаДаДа
'none'Использует фактический размер изображения и поддерживает соотношение сторон. Если площадь компонента меньше изображения, изображение обрезается.

НетНетДаДа
'scaledown'

Масштабируется вниз и поддерживает соотношение сторон без усечения.


Если оригинальное изображение больше, чем площадь компонента, изображение масштабируется вниз и визуализируется как ScaleMethod установлено значение 'fit'. Если оригинальное изображение меньше, чем площадь компонента, изображение не масштабируется и визуализируется как ScaleMethod установлено значение 'none'.

НетДаДаНет
'scaleup'

Шкалы и поддержание соотношения сторон с помощью усечения.


Если оригинальное изображение меньше, чем площадь компонента, изображение шкал вверх и визуализируется как ScaleMethod установлено значение 'fit'. Если оригинальное изображение больше, чем площадь компонента, изображение не масштабируется и визуализируется как ScaleMethod установлено значение 'none'.

ДаНетДаДа
'stretch'Масштабируется в любом направлении, чтобы заполнить площадь компонента, без сохранения соотношения сторон и без усечения.

ДаДаНетНет

Изображение кликнуло коллбэк, заданное как одно из следующих значений:

  • Указатель на функцию.

  • Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.

  • Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.

Этот коллбэк выполняется, когда пользователь кликает изображение в приложении.

Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в ImageClickedData объект как второй аргумент функции обратного вызова. В App Designer аргумент называется event. Вы можете запросить свойства объекта с помощью записи через точку. Для примера, event.Source возвращает Image объект, с которым взаимодействует пользователь, чтобы вызвать коллбэк. The ImageClickedData объект недоступен для функций обратного вызова, заданных как векторы символов.

В следующей таблице перечислены свойства ImageClickedData объект.

СвойствоЗначение
EventName'ImageClicked'
SourceКомпонент, выполняющий коллбэк

Для получения дополнительной информации о записи коллбэков см. Раздел «Запись коллбэков в App Designer».

Расположение и размер компонента изображения относительно родительского элемента, заданные как вектор четырех элементов формы [left bottom width height]. Эта таблица описывает каждый элемент в векторе.

ЭлементОписание
leftРасстояние от внутреннего левого края родительского контейнера до внешнего левого края компонента изображения
bottomРасстояние от внутреннего нижнего ребра родительского контейнера до внешнего нижнего ребра компонента изображения
widthРасстояние между правым и левым внешними краями компонента изображения
heightРасстояние между верхним и нижним внешними краями компонента изображения

The Position значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает область, занимаемую украшениями, такими как панель меню или заголовок.

Все измерения указаны в пикселях модулей.

Совет

  • Для анализа и обработки изображений смотрите графические функции image и imshow.

См. также

Функции

Свойства

Введенный в R2019a