импорт::

Считайте растровые данные

Блокноты MuPAD® будут демонтированы в будущем релизе. Используйте live скрипты MATLAB® вместо этого.

Live скрипты MATLAB поддерживают большую часть функциональности MuPAD, хотя существуют некоторые различия. Для получения дополнительной информации смотрите, Преобразовывают Notebook MuPAD в Live скрипты MATLAB.

Синтаксис

import::readbitmap(filename, <ReturnType = DOM_HFARRAY | DOM_ARRAY | DOM_LIST>)

Описание

import::readbitmap используется для чтения ASCII или файлов двоичных данных, хранящих растровые изображения изображений. Следующие стандартные графические форматы могут быть считаны: BMP, DCX, DDS, КОМОК, GIF, ICO, JPG, LIF, MDL, PCD, PCX, PIC, ЯЩИК ДЛЯ ПРОБНОЙ МОНЕТЫ, PNG, PNM, PSD, PSP, PXR, СЫРЫЕ ДАННЫЕ, SGI, TGA, TIF, УОЛ, XPM. Формат пиксельных данных определяется автоматически от содержимого файла. Возвращаемое значение [w, h, colordata] предоставляет пиксельной высоте h, пиксельная ширина w и цветные данные растрового изображения.

Или полное возвращаемое значение или только третий элемент, colordata, может быть передан функциональному plot::Raster, чтобы сгенерировать объект графика, который может использоваться в графике MuPAD®. Например, команда

plot(plot::Raster(import::readbitmap("mypicture.jpeg")))

создает графику MuPAD битового массива, сохраненного в файле JPG “mypicture.jpeg”.

Примечание

Большинство стандартных графических форматов хранит строку пиксельных данных строкой в обычном порядке чтения начиная с левого верхнего угла изображения. Пиксельные данные в возвращенном массиве colordata (при запросе ReturnType = DOM_ARRAY), однако, должны быть интерпретированы можно следующим образом:

colordata[1, 1] является цветом RGB левого нижнего угла.

colordata[h, 1] является цветом RGB левого верхнего угла.

colordata[1, w] является цветом RGB правого нижнего угла.

colordata[h, w] является цветом RGB правого верхнего угла.

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

Это сопоставимо с интерпретацией цветовой гаммы plot::Raster.

import::readbitmap(filename) ищет файл в различных директориях:

  • Во-первых, имя интерпретировано как имя файла прямого доступа: filename конкатенирован к каждой директории, данной переменной окружения READPATH.

  • Затем имя файла интерпретировано как абсолютный путь.

  • Затем имя файла интерпретировано относительно “рабочей директории”.

  • Наконец, имя файла конкатенировано к пути к каталогу.

Если файл может быть открыт с одним из этого, называет, то файл читается.

Обратите внимание на то, что значение “рабочей директории” зависит от операционной системы. В системах Microsoft® Windows® и в Apple Mac OS X систем, “рабочая директория” является папкой, где MuPAD установлен. В системах UNIX® это - текущая рабочая директория, в которой был запущен MuPAD; когда запущено с меню или настольного элемента, это обычно - корневой каталог пользователя.

Разделитель пути (“/”) вставляется по мере необходимости при конкатенации данного пути и filename.

import::readbitmap не принимает дескрипторы файлов, возвращенные fopen. И при этом это не может обработать файлы, которые были сжаты gzip, но поскольку наиболее растровые форматы используют высококачественное сжатие в любом случае, существует мало причины попытаться сжать их снова в любом случае.

Примеры

Пример 1

Мы импортируем PGM (портативный graymap) изображение:

[w, h, Norton] := import::readbitmap("Norton.pgm"):

Растровое изображение должно быть встроено в графику MuPAD. Мы используем ширину w и высота h, чтобы поместить битовый массив в прямоугольник, стороны которого имеют то же отношение как исходное растровое изображение. С Scaling = Constrained мы убеждаемся, что это соотношение сторон также используется в конечном изображении:

xmin := 2: xmax := xmin + w/100:
ymin := 0.5: ymax := ymin + h/100:
plot(plot::Function2d(x*sin(PI/x), x = -1..4.5, AdaptiveMesh = 2),
     plot::Raster(Norton, x = xmin ..xmax, y = ymin .. ymax),
     Scaling = Constrained, Footer = "Work And Play"):

Параметры

filename

Имя файла: непустая строка символов

Опции

ReturnType

Опция, заданная как ReturnType = DOM_HFARRAY | DOM_ARRAY | DOM_LIST

Установите тип фактических цветных данных, возвращенных как colordata.

Если установлено в DOM_LIST, colordata является вложенным списком, наиболее удаленным списком, содержащим списки h, каждый из которых представляет одну строку данных изображения и содержит списки w трех чисел с плавающей запятой, каждый из который представляет цвет Цветов RGB.

Если установлено в DOM_ARRAY, colordata является массивом, содержащим списки с информацией о цвете, как в array(2, 1..h, 1..w, [color1, color2, …] ). Интерпретация походит на вложенные списки, описанные выше.

Если установлено в DOM_HFARRAY, который является настройкой по умолчанию, colordata является DOM_HFARRAY размерностей hfarray(3, 1..h, 1..w, 1..3, [actual data]). Интерпретация этих значений с плавающей точкой как описана выше для случая DOM_LIST.

Возвращаемые значения

list[w, h, colordata]. Целочисленный w является пиксельной шириной битового массива. Целочисленный h является пиксельной высотой битового массива. colordata обеспечивает цвета RGB битового массива. Его тип зависит от установки опции ReturnType.

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

Функции MuPAD

MuPAD графические примитивы

Для просмотра документации необходимо авторизоваться на сайте