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

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

: imshow (im)

: imshow (im, limits)

: imshow (im, map)

: imshow (rgb, …)

: imshow (filename)

: imshow (…, string_param1, value1, …)

: h = imshow (…)

Отобразить изображение im, где im может быть двумерной матрицей (изображение в градациях серого) или трёхмерной матрицей (изображение RGB).

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

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

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

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

"displayrange"

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

"colormap"

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

"xdata"

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

"ydata"

Если value1 — это вектор из двух элементов, он должен содержать вертикальные границы изображения в форме [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 — необязательные векторы из двух элементов, [min, max], задающие координаты центров угловых пикселей. Если диапазон задан как [max, min], изображение будет перевёрнуто вдоль соответствующей оси. Для удобства x и y можно задать как векторы из N элементов, соответствующие длине данных в img. Однако для определения пределов осей будут использоваться только первый и последний элементы.

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

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

Примечание по реализации: начало координат (0, 0) для изображений расположено в верхнем левом углу. Для обычных графиков начало координат расположено в нижнем левом углу. Octave учитывает эту инверсию, строя график данных обычным образом, а затем меняя направление оси y, задавая свойству ydir значение "reverse". Это следует учитывать, когда изображение необходимо наложить на обычный график. Рекомендуется сначала отобразить изображение, а затем построить график с инвертированными значениями ydata, например, с помощью 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 — необязательные векторы из двух элементов, [min, max], задающие координаты центров угловых пикселей. Если диапазон задан как [max, min], изображение будет перевёрнуто вдоль соответствующей оси. Для удобства x и y можно задать как векторы из N элементов, соответствующие длине данных в img. Однако для определения границ изображения будут использоваться только первый и последний элементы.

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

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

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