import::readbitmap

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

Блокноты 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_LISTColorData вложенный список, наиболее удаленный список, содержащий h списки, каждый из которых представляет одну строку данных изображения и содержит w списки трех чисел с плавающей запятой, каждое из которых представляет цвет Цветов RGB.

Если установлено в DOM_ARRAYColorData массив, содержащий списки с информацией о цвете, как в 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 графические примитивы

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