32.2 Отображение изображений

Естественной частью обработки изображений является визуализация изображения. Наиболее базовая функция для этого — функция imshow, которая отображает изображение, указанное в первом входном аргументе.

imshow (im)

imshow (im, limits)

imshow (im, map)

imshow (rgb, …)

imshow (filename)

imshow (…, string_param1, value1, …)

h = imshow (…)

Отобразить изображение im, где im может быть 2-мерной (серой) или 3-мерной (RGB) матрицей.

Если limits является вектором из 2 элементов [low, high], изображение отображается в диапазоне от low до high. Если для limits передана пустая матрица, диапазон отображения вычисляется как диапазон между минимальным и максимальным значениями в изображении.

Если map является допустимой цветовой картой, изображение будет отображаться как индексированное изображение с использованием предоставленной цветовой карты.

Если вместо изображения задан файл имени, файл будет прочитан и отображен.

Если задан параметр string_param1 со значением value1. string_param1 может быть любым из следующих:

"displayrange"

value1 — диапазон отображения, как описано выше.

"colormap"

value1 — цветовая карта для использования при отображении индексированного изображения.

"xdata"

Если value1 является вектором из 2 элементов, он должен содержать горизонтальные пределы изображения в формате [xfirst, xlast], где xfirst и xlast — абсциссы центров угловых пикселей. В противном случае value1 должен быть вектором, и только первые и последние элементы будут использованы для xfirst и xlast соответственно.

"ydata"

Если value1 является вектором из 2 элементов, он должен содержать вертикальные пределы изображения в формате [yfirst, ylast], где yfirst и ylast — ординаты центра угловых пикселей. В противном случае value1 должен быть вектором, и только первые и последние элементы будут использованы для yfirst и ylast соответственно.

Необязательное возвращаемое значение h — это дескриптор графического элемента изображения.

См. также: image, imagesc, colormap, gray2ind, rgb2ind.

image (img)

image (x, y, img)

image (…, "prop", val, …)

image ("prop1", val1, …)

h = image (…)

Отобразить матрицу как индексированное цветное изображение.

Элементы img — это индексы в текущей цветовой карте.

x и y — необязательные векторы из 2 элементов, [min, max], которые определяют координаты центров угловых пикселей. Если диапазон задан как [max, min], то изображение будет инвертировано по этой оси. Для удобства x и y могут быть заданы как векторы длиной N, соответствующие длине данных в img. Однако для определения пределов оси будут использованы только первые и последние элементы.

Можно указать несколько пар свойство/значение для объекта изображения, но они должны быть парами.

Необязательное возвращаемое значение h — это дескриптор графического элемента изображения.

Примечание к реализации: начало отсчета (0, 0) для изображений находится в верхнем левом углу. Для обычных графиков начало отсчета находится в нижнем левом углу. Octave обрабатывает эту инверсию, отображая данные обычно, а затем изменяет направление оси y, устанавливая свойство ydir в "reverse". Это имеет последствия всякий раз, когда изображение и обычный график необходимо наложить друг на друга. Рекомендуемое решение — отобразить изображение, а затем построить обращенные значения y с помощью, например, flipud (ydata).

Формы вызова: Функцию image можно вызывать в двух формах: высокоуровневой и низкоуровневой. При вызове с обычными параметрами используется высокоуровневая форма, которая сначала вызывает newplot для подготовки графической фигуры и осей. Когда единственными входами в image являются пары свойство/значение, используется низкоуровневая форма, которая создает новый экземпляр объекта изображения и вставляет его в текущие оси.

Свойства графиков: полный список свойств описан в разделе Свойства изображения.

См. также: imshow, imagesc, colormap.

imagesc (img)

imagesc (x, y, img)

imagesc (…, climits)

imagesc (…, "prop", val, …)

imagesc ("prop1", val1, …)

imagesc (hax, …)

h = imagesc (…)

Отобразить масштабированную версию матрицы img как цветное изображение.

Цветовая карта масштабируется так, чтобы элементы матрицы занимали всю цветовую карту. Если climits = [lo, hi] задан, то этот диапазон устанавливается в "clim" текущей оси.

x и y — необязательные векторы из 2 элементов, [min, max], которые определяют координаты центров угловых пикселей. Если диапазон задан как [max, min], то изображение будет инвертировано по этой оси. Для удобства x и y могут быть заданы как векторы длиной N, соответствующие длине данных в img. Однако для определения пределов изображения будут использованы только первые и последние элементы.

Необязательное возвращаемое значение h — это дескриптор графического элемента изображения.

Формы вызова: Функцию imagesc можно вызывать в двух формах: высокоуровневой и низкоуровневой. При вызове с обычными параметрами используется высокоуровневая форма, которая сначала вызывает newplot для подготовки графической фигуры и осей. Когда единственными входами в image являются пары свойство/значение, используется низкоуровневая форма, которая создает новый экземпляр объекта изображения и вставляет его в текущие оси.

См. также: image, imshow, caxis.