uiimage
Создайте компонент изображения
Описание
im = uiimage создает компонент изображения в новой фигуре и возвращает Image объект. MATLAB® вызывает uifigure функция, чтобы создать новую фигуру. Используйте uiimage отобразить изображение, значок или логотип в вашем приложении.
im = uiimage( задает Name,Value)Image значения свойств с помощью одного или нескольких аргументов пары "имя-значение".
im = uiimage( задает родительский контейнер и одни или несколько значений свойств.parent,Name,Value)
Примеры
Отобразите изображение
Создайте компонент изображения в фигуре. Отображения изображений по умолчанию.
f = uifigure; im = uiimage(f);
Теперь добавьте изображение в компонент изображения.
im.ImageSource = 'peppers.png';
Отобразите анимированный GIF с добавлением черных полос сверху и снизу
Создайте компонент изображения, который отображает анимированный GIF с помощью фактического размера изображения.
f = uifigure; im = uiimage(f,'ImageSource','questions.gif'); im.ScaleMethod = 'none';
Теперь масштабируйте изображение так, чтобы оно соответствовало в области компонента по умолчанию, сохраняя соотношение сторон и без усечения. Затем примените черный фон, чтобы создать видимость добавления черных полос сверху и снизу (черные полосы выше и ниже изображения).
im.ScaleMethod = 'scaledown'; im.BackgroundColor = 'black';
Сконфигурируйте изображение, чтобы выполнить действие, когда кликнувшийся
Создайте изображение и коллбэк, который выполняется, когда на изображение нажимают. В этом случае изображение открывает веб-сайт MathWorks®.
Этот программный файл, названный imagetoURL.m, показывает вам как:
Создайте компонент изображения с
ImageClickedFcn'callback'.Используйте
webфункция в коллбэке, чтобы открыть внешний URL в вашем системном браузере.Создайте подсказку, которая появляется, когда вы наводите на изображение.
Когда вы запускаете программный файл, нажимаете на изображение, чтобы открыть веб-сайт MathWorks®.
function imagetoURL f = uifigure('Visible','off'); f.Position(3:4) = [333 239]; im = uiimage(f); 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 f.Visible = 'on'; end
Входные параметры
parent — Родительский контейнер
Figure объект (значение по умолчанию) | Panel возразите | Tab возразите | ButtonGroup возразите | GridLayout объект
Родительский контейнер в виде Figure объект создал использование uifigure функция или один из ее дочерних контейнеров: TabПанельГруппа кнопок, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция, чтобы создать новый Figure объект, который служит родительским контейнером.
Аргументы в виде пар имя-значение
Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.
im = uiimage('ScaleMethod','none')Примечание
Перечисленные здесь свойства являются только подмножеством. Для полного списка смотрите Свойства изображения.
'ImageSource' — Источник изображения или файл
'' (значение по умолчанию) | путь к файлу | m- n- 3 матрицы изображений истинного цвета
Источник изображения или файл в виде пути к файлу или m- n- 3 матрицы изображений истинного цвета. Поддерживаемые форматы изображения включают JPEG, PNG, GIF, SVG или m- n- 3 матрицы изображений истинного цвета.
Для получения дополнительной информации о матрицах изображений истинного цвета смотрите Типы изображения.
Пример: im = uiimage('ImageSource','peppers.png');
Пример: im.ImageSource = 'C:\TEMP\ngc6543a.jpg';
'ScaleMethod' — Отобразите метод масштабирования
'fit' (значение по умолчанию) | 'fill' | 'none' | 'scaledown' | 'scaleup' | 'stretch'
Отобразите метод масштабирования в виде одного из перечисленных в таблице значений. Используйте этот аргумент пары "имя-значение", чтобы задать, как вы хотите, чтобы ваше изображение представило в области компонента.
Таблица также демонстрирует каждый метод шкалы с изображением в качестве примера. В представленных примерах изображений, BackgroundColor свойство компонента изображения было установлено в 'magenta'. Масштабирующееся поведение файлов изображения SVG может варьироваться на основе того, как файл задан.
| Значение | Описание | Пример | Масштабирует | Уменьшается | Обеспечивает соотношение сторон | Изображение клипов | |
|---|---|---|---|---|---|---|---|
| Оригинальное изображение | Представленное изображение | ||||||
'fit' | Шкалы в любом направлении, чтобы отобразить изображение в области компонента, и обеспечивают соотношение сторон без усечения. |
|
| Да | Да | Да | Нет |
'fill' | Шкалы в любом направлении, чтобы заполнить область компонента, обеспечивая соотношение сторон и отсекая при необходимости. |
|
| Да | Да | Да | Да |
'none' | Использует фактический размер изображения и обеспечивает соотношение сторон. Если область компонента меньше, чем изображение, изображение отсекается. |
|
| Нет | Нет | Да | Да |
'scaledown' | Уменьшается и обеспечивает соотношение сторон без усечения. Если оригинальное изображение больше, чем область компонента, изображение уменьшается и представляет как будто |
|
| Нет | Да | Да | Нет |
'scaleup' | Масштабирует и обеспечивает соотношение сторон с усечением. Если оригинальное изображение меньше, чем область компонента, изображение масштабирует и представляет как будто |
|
| Да | Нет | Да | Да |
'stretch' | Шкалы в любом направлении, чтобы заполнить область компонента, не обеспечивая соотношение сторон и без усечения. |
|
| Да | Да | Нет | Нет |
'ImageClickedFcn' — Отобразите коллбэк, по которому кликают,
'' (значение по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Отобразите коллбэк, по которому кликают, в виде одного из этих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Этот коллбэк выполняется, когда пользователь нажимает на изображение в приложении.
Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в ImageClickedData возразите в качестве второго аргумента против своей функции обратного вызова. В App Designer аргумент называется событиемВы можете запросить свойства объекта с помощью записи через точку. Например, event.Source возвращает Image возразите, что пользователь взаимодействует с инициировать коллбэк. ImageClickedData объект не доступен для функций обратного вызова, заданных как векторы символов.
В следующей таблице перечислены свойства ImageClickedData объект.
| Свойство | Значение |
|---|---|
EventName | 'ImageClicked' |
Source | Компонент, выполняющий коллбэк |
Для получения дополнительной информации о записи коллбэков, смотрите Коллбэки Записи в App Designer.
'Position' — Местоположение и размер компонента изображения
[100 100 100 100] [left bottom width height]
Местоположение и размер компонента изображения относительно родительского элемента в виде четырех векторов элемента формы [left bottom width height]В этой таблице описываются каждый элемент в векторе.
| Элемент | Описание |
|---|---|
left | Расстояние от внутреннего левого края родительского контейнера к внешнему левому краю компонента изображения |
bottom | Расстояние от внутреннего базового края родительского контейнера к внешнему базовому краю компонента изображения |
width | Расстояние между правыми и левыми внешними краями компонента изображения |
height | Расстояние между верхними и нижними внешними краями компонента изображения |
Position значения относительно drawable area родительского контейнера. Область векторной и растровой графики является областью в границах контейнера и не включает область, занятую художественными оформлениями, такими как панель меню или заголовок.
Все измерения указаны в пикселях.