uiimage
Создайте компонент изображения
Описание
im = uiimage создает компонент изображения на новом рисунке и возвращает Image объект. MATLAB® вызывает uifigure функция для создания нового рисунка. Использовать uiimage отображение изображения, значка или логотипа в вашем приложении.
im = uiimage( задает Name,Value)Image значения свойств с использованием одного или нескольких аргументов пары "имя-значение".
im = uiimage( задает родительский контейнер и одно или несколько значений свойств.parent,Name,Value)
Примеры
Отобразить изображение
Создайте компонент изображения в рисунке. Изображение по умолчанию отображения.
fig = uifigure; im = uiimage(fig);
Теперь добавьте изображение к компоненту изображения.
im.ImageSource = 'peppers.png';
Отображение анимированного GIF с Letterboxing
Создайте компонент изображения, который отображает анимированный 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
Входные параметры
parent - Родительский контейнер
Figure объект (по умолчанию) | Panel | объекта Tab | объекта ButtonGroup | объекта GridLayout объект
Родительский контейнер, заданный как Figure объект, созданный с использованием uifigure функция, или один из ее дочерних контейнеров: Tab, Panel, ButtonGroup, или GridLayout. Если вы не задаете родительский контейнер, MATLAB вызывает uifigure функция для создания нового Figure объект, который служит родительским контейнером.
Аргументы в виде пар имя-значение
Задайте необязательные разделенные разделенными запятой парами Name,Value аргументы. Name - имя аргумента и Value - соответствующее значение. Name должны находиться внутри кавычек. Можно задать несколько аргументов в виде пар имен и значений в любом порядке Name1,Value1,...,NameN,ValueN.
im = uiimage('ScaleMethod','none')Примечание
Перечисленные здесь свойства являются только подмножеством. Полный список см. в разделе Свойств изображений».
'ImageSource' - Источник изображения или файл
'' (по умолчанию) | путь к файлу | mn-by-3 truecolor массив изображений
Источник изображения или файл, заданный как путь к файлу или 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';
'ScaleMethod' - Метод масштабирования изображений
'fit' (по умолчанию) | 'fill' | 'none' | 'scaledown' | 'scaleup' | 'stretch'
Метод масштабирования изображений, заданный как одно из значений, перечисленных в таблице. Используйте этот аргумент пары "имя-значение", чтобы задать способ визуализации изображения в области компонента.
Таблица также демонстрирует каждый метод шкалы с помощью примера изображения. В примерах визуализированных изображений BackgroundColor свойство компонента изображения установлено в 'magenta'. Поведение масштабирования файлов изображений SVG может варьироваться в зависимости от того, как определен файл.
| Значение | Описание | Пример | Шкалы вверх | Шкалы вниз | Поддерживает соотношение сторон | Изображение клипса | |
|---|---|---|---|---|---|---|---|
| Оригинальное изображение | Визуализированное изображение | ||||||
'fit' | Масштабирует в любом направлении, чтобы отобразить изображение в пределах области компонента, и поддерживает соотношение сторон без усечения. |
|
| Да | Да | Да | Нет |
'fill' | Масштабируется в любом направлении, чтобы заполнить область компонента, сохраняя соотношение сторон и при необходимости обрезку. |
|
| Да | Да | Да | Да |
'none' | Использует фактический размер изображения и поддерживает соотношение сторон. Если площадь компонента меньше изображения, изображение обрезается. |
|
| Нет | Нет | Да | Да |
'scaledown' | Масштабируется вниз и поддерживает соотношение сторон без усечения. Если оригинальное изображение больше, чем площадь компонента, изображение масштабируется вниз и визуализируется как |
|
| Нет | Да | Да | Нет |
'scaleup' | Шкалы и поддержание соотношения сторон с помощью усечения. Если оригинальное изображение меньше, чем площадь компонента, изображение шкал вверх и визуализируется как |
|
| Да | Нет | Да | Да |
'stretch' | Масштабируется в любом направлении, чтобы заполнить площадь компонента, без сохранения соотношения сторон и без усечения. |
|
| Да | Да | Нет | Нет |
'ImageClickedFcn' - Изображение, кликнутое как обратный вызов
'' (по умолчанию) | указатель на функцию | массив ячеек | вектор символов
Изображение кликнуло коллбэк, заданное как одно из следующих значений:
Указатель на функцию.
Массив ячеек, в котором первый элемент является указателем на функцию. Последующие элементы массива ячеек являются аргументами, которые передаются в функцию обратного вызова.
Вектор символов, содержащий допустимое выражение MATLAB (не рекомендуемый). MATLAB оценивает это выражение в базовом рабочем пространстве.
Этот коллбэк выполняется, когда пользователь кликает изображение в приложении.
Эта функция обратного вызова может получить доступ к определенной информации о взаимодействии пользователя с изображением. MATLAB передает эту информацию в ImageClickedData объект как второй аргумент функции обратного вызова. В App Designer аргумент называется event. Вы можете запросить свойства объекта с помощью записи через точку. Для примера, event.Source возвращает Image объект, с которым взаимодействует пользователь, чтобы вызвать коллбэк. The ImageClickedData объект недоступен для функций обратного вызова, заданных как векторы символов.
В следующей таблице перечислены свойства ImageClickedData объект.
| Свойство | Значение |
|---|---|
EventName | 'ImageClicked' |
Source | Компонент, выполняющий коллбэк |
Для получения дополнительной информации о записи коллбэков см. Раздел «Запись коллбэков в App Designer».
'Position' - Расположение и размер компонента изображения
[100 100 100 100] (по умолчанию) | [left bottom width height]
Расположение и размер компонента изображения относительно родительского элемента, заданные как вектор четырех элементов формы [left bottom width height]. Эта таблица описывает каждый элемент в векторе.
| Элемент | Описание |
|---|---|
left | Расстояние от внутреннего левого края родительского контейнера до внешнего левого края компонента изображения |
bottom | Расстояние от внутреннего нижнего ребра родительского контейнера до внешнего нижнего ребра компонента изображения |
width | Расстояние между правым и левым внешними краями компонента изображения |
height | Расстояние между верхним и нижним внешними краями компонента изображения |
The Position значения относятся к drawable area родительского контейнера. Область векторной и растровой графики является областью внутри границ контейнера и не включает область, занимаемую украшениями, такими как панель меню или заголовок.
Все измерения указаны в пикселях модулей.