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 'callback'.

  • Используйте 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ПанельГруппа кнопок, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.

Аргументы name-value

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

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

Примечание

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

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

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

Пример: 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.Source возвращает Image возразите, что пользователь взаимодействует с инициировать коллбэк. ImageClickedData объект не доступен для функций обратного вызова, заданных как векторы символов.

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

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

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

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

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

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

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

Советы

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

Смотрите также

Функции

Свойства

Введенный в R2019a