Редактор маски обзор

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

Диалоговое окно Mask Editor помогает вам создать и настроить маску блока. Диалоговое окно Mask Editor открывается, когда вы создаете или редактируете маску. Можно получить доступ к диалоговому окну Mask Editor любой из этих опций:

Создать маску,

Нажмите Diagram> Mask> Create Mask.
Щелкните правой кнопкой по блоку и выберите Mask> Create Mask.

Отредактировать маску,

Нажмите Diagram> Mask> Edit Mask.
Щелкните правой кнопкой по блоку и выберите Mask> Edit Mask.

Примечание

Можно также использовать горячую клавишу CTRL + M, чтобы открыть Редактор Маски.

Диалоговое окно Mask Editor содержит набор панелей с вкладками, каждая из которых включает вам, задают функцию маски. Эти вкладки:

Icon & Ports Pane: создать значки маски блока.
Parameters & Dialog Pane: разработать диалоговые окна маски.
Панель инициализации: инициализировать маскированный блок с помощью кода MATLAB^®.
Панель документации: добавить описание и справку о маске блока.

Примечание

Для получения информации о создании и редактировании маски блока из командной строки, смотрите Маски Управления Программно.

Панель Icon & Ports помогает вам создать значок блока, который содержит описательный текст, уравнения состояния, изображение и графику.

Панель Icon & Ports разделена на эти разделы:

Опции: Предоставляет список различных средств управления, которые могут быть применены на значок маски.
Предварительный просмотр: Отображает предварительный просмотр значка маски блока.
Команды рисования значка: Позволяет вам чертить значок маски при помощи кода MATLAB.

Примечание

Можно создать статический и динамический значок маски блока. Для получения дополнительной информации смотрите, Чертят Значок Маски и slexMaskDisplayAndInitializationExample.

Опции

Options, доступный на левой панели, является списком средств управления, которые позволяют вам задавать атрибуты на значке маски. Эти опции,

Блокируйте кадр. Кадр блока является прямоугольником, который заключает блок. Можно принять решение показать или скрыть кадр путем установки параметра Block Frame на Visible или Invisible. Значение по умолчанию должно сделать кадр блока видимым. Например, эти данные показывают видимые и невидимые кадры блока для блока логического элемента И.

Прозрачность значка. Прозрачность значка может быть установлена в Opaque, Opaque with ports или Transparent, на основе того, хотите ли вы скрыть или показать то, что под значком. Опция по умолчанию Opaque скрывает информацию, такую как метки порта. Кадр блока отображен для прозрачного значка и скрыт для непрозрачного значка.

Для блока подсистемы, если вы устанавливаете прозрачность значка на Opaque with ports, метки порта видимы.

Примечание

Если вы устанавливаете прозрачность значка на Transparent, Simulink^® не скрывает кадр блока, даже если вы устанавливаете свойство Block Frame на Invisible.

Модули значка. Эта опция управляет системой координат, используемой командами рисования. Это применяется только к plot, text и командам рисования patch. Можно выбрать из числа этого выбора: Autoscale, Normalized и Pixel.

Autoscale масштабирует значок, чтобы соответствовать кадру блока. Когда блок изменен, значок также изменен. Например, эти данные показывают значок, чертивший с помощью этих векторов:
```
X = [0 2 3 4 9]; Y = [4 6 3 5 8];
```
Нижний левый угол кадра блока (0,3), и верхний правый угол (9,8). Область значений оси X равняется 9 (от 0 до 9), в то время как область значений оси Y равняется 5 (от 3 до 8).
Normalized чертит значок в кадре блока, нижний левый угол которого (0,0) и чей верхний правый угол (1,1). Только значения X и Y от 0 до 1 появляются. Когда блок изменен, значок также изменен. Например, эти данные показывают значок, чертивший с помощью этих векторов:
```
X = [.0 .2 .3 .4 .9]; Y = [.4 .6 .3 .5 .8];
```
Pixel чертит значок со значениями X и Y, выраженными в пикселях. Значок автоматически не изменен, когда блок изменен. Чтобы обеспечить значок, чтобы изменить размер с блоком, задайте команды рисования с точки зрения размера блока.

Вращение значка. Когда блок повернут или инвертирован, можно выбрать, вращать ли или инвертировать значок, или иметь его остаются фиксированными в его исходной ориентации. Значение по умолчанию не должно вращать значок. Вращение значка сопоставимо с вращением порта блока. Эти данные показывают результаты выбора Fixed и вращения значка Rotates, когда блок логического элемента И повернут.

Вращение порта. Эта опция включает, вы вам задаете тип вращения порта для маскированного блока. Выбор:

default
Порты переупорядочиваются после по часовой стрелке вращение, чтобы поддержать слева направо порядок нумерации порта для портов вдоль верха и низа блока и порядок нумерации порта от начала до конца для портов вдоль левых и правых сторон блока.
physical
Порты вращаются с блоком, не будучи переупорядоченным после по часовой стрелке вращение.

Опция вращения по умолчанию подходит для систем управления и других приложений моделирования, где блок-схемы обычно имеют нисходящую и лево-правильную ориентацию. Это упрощает редактирование схем путем минимизации потребности повторно подключить блоки после вращений, чтобы сохранить стандартную ориентацию.

Точно так же физическая опция вращения подходит для электронных, механических, гидравлических, и других приложений моделирования, где блоки представляют физические компоненты, и строки представляют физические соединения. Физическая опция вращения более тесно моделирует поведение представленных устройств (то есть, порты вращаются с блоком, как они были бы на физическом устройстве). Кроме того, опция старается не вводить пересечения строки как результат вращений, делая схемы легче читать.

Например, следующие данные показывают две схемы, представляющие ту же транзисторную цепь. В одном маскированные блоки, представляющие транзисторы, используют вращение по умолчанию и в другом, физическом вращении.

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

Примечание

Вращение вводит строку, пересекающую схему, которая использует вращение по умолчанию, но не в схеме, которая использует физическое вращение. Также то, что нет никакого способа отредактировать схему с вращением по умолчанию, чтобы удалить пересечение строки. Смотрите Щелчок или Поверните Блоки для получения дополнительной информации.

Запустите Инициализацию. Опция Run initialization позволяет вам управлять выполнением команд инициализации маски. Выбор:

Off (Значение по умолчанию): не выполняет команды инициализации маски. Когда команды рисования маски не имеют зависимости от рабочей области маски, рекомендуется задать значение Run initialization как Off. Устанавливание значения к Off помогает в оптимизации производительности Simulink, когда команды инициализации маски не выполняются.
On: Выполняет команды инициализации маски, если рабочая область маски не актуальна. Когда эта опция задана, команды инициализации маски выполняются прежде, чем выполнить команды рисования маски независимо от зависимости от рабочей области маски команд рисования маски.
Analyze: Выполняет команды инициализации маски, только если существует зависимость от рабочей области маски. Когда эта опция задана, Simulink выполняет команды инициализации маски прежде, чем выполнить команды рисования значка маски. Опция Analyze для обратной совместимости и не рекомендуется в противном случае. Рекомендуется, чтобы модели Simulink от R2016b или прежде были обновлены с помощью Советника по вопросам Обновления.
Для получения дополнительной информации см. slexMaskDrawingExamples.

Предварительный просмотр

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

Когда вы добавляете команду рисования значка и нажимаете Apply, обновления предварительного просмотра изображений, и отображен в разделе Preview панели Icon & Ports.

Команды рисования значка

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

Команды рисования значка маски

Команда рисования	Описание	Пример синтаксиса
`color`	Измените цвет рисунка последующих команд рисования значка маски	`color('red'); port_label('output',1,'Text')`
`disp`	Отобразите текст на значке маскированном.	`disp('Gain')`
`dpoly`	Отобразите передаточную функцию на значке маскированном	`dpoly([0 0 1], [1 2 1], 'z')`
`droots`	Отобразите передаточную функцию на значке маскированном	`droots([-1], [-2 -3], 4)`
`fprintf`	Отобразите переменный текст, сосредоточенный на значке маскированном	`fprintf('Sum = %d', 7)`
`image`	Отобразите изображение RGB на значке маскированном Примечание Чтобы добавить изображение значка маски от пользовательского интерфейса, нажмите Mask> Add Mask Icon в контекстном меню.	`image('b747.jpg')`
`patch`	Чертите цветовое поле заданной формы на значке маскированном	`patch([0 10 20 30 30 0], [10 30 20 25 10 10],[1 0 0])`
`plot`	Чертите соединительную серию графика точек на значке маскированном	`plot([10 20 30 40], [10 20 10 15])`
`port_label`	Чертите метку порта на значке маскированном	`port_label('output', 1, 'xy')`
`text`	Отобразите текст в определенном местоположении на значке маскированном. Необходимо выбрать `Pixels` в поле Icon units.	`text(5,10, 'Gain')`
`block_icon`	Продвиньте значок блока, содержавшегося в Подсистеме к маске Подсистемы	`block_icon(BlockName)` Здесь, значок блока продвинут на свой блок Subsystem. Для получения дополнительной информации см. slexblockicon.

Примечание

Simulink не поддерживает команды рисования маски в рамках анонимных функций.

Команды рисования выполняются в той же последовательности, как они добавляются в текстовом поле Icon drawing commands. Команды рисования имеют доступ ко всем переменным в рабочей области маски. Если какая-либо команда рисования не может успешно выполниться, маски вопроса об отображениях значка блока.

Команды рисования выполняются после того, как блок чертится в этих случаях:

Изменения внесены и применены в диалоговом окне маски.
Изменения внесены в Редакторе Маски.
Изменения сделаны к блок-схеме, которая влияет на внешний вид блока, такой как поворачивание блока.

Parameters & Dialog Pane

Средства управления
Диалоговое окно
Propertyeditor

Панель Parameters & Dialog позволяет вам разработать диалоговые окна маски с помощью диалоговых средств управления в Parameters, Display и палитрах Action.

Панель Parameters & Dialog разделена на эти разделы:

Parameter & Dialog Pane

Раздел	Разделите описание	Подраздел	Описание подраздела
Средства управления	Средства управления являются элементами в диалоговом окне маски, что пользователи могут взаимодействовать с добавить или управлять данными.	Параметр	Параметры являются вводами данных пользователем, которые принимают участие в симуляции. Палитра Parameters имеет набор диалоговых средств управления параметром, которые можно добавить в диалоговое окно маски.
		Отображение	Controls на палитре Display позволяет вам диалоговым средствам управления группы в диалоговом окне маски и тексте отображения и изображениях
		Действие	Средства управления действием позволяют вам выполнять некоторые действия в диалоговом окне маски. Например, можно кликнуть по гиперссылке или кнопке в диалоговом окне маски.
Диалоговое окно	Можно кликнуть или перетащить мышью диалоговые средства управления от палитр до Dialog box, чтобы создать диалоговое окно маски.	Нет данных	Нет данных
Propertyeditor	Property editor позволяет вам просматривать и устанавливать свойства для Parameters, Display и средств управления Action.	Свойства	Задает основную информацию обо всех диалоговых средствах управления, таких как Name, Value, Prompt и Type.
		Атрибуты	Задает, как интерпретировано диалоговое управление маской. Атрибуты связаны только с параметрами.
		Диалоговое окно	Задает, как диалоговые средства управления отображены в диалоговом окне маски.
		Размещение	Задает, как диалоговые средства управления размечаются на диалоговом окне маски.

Средства управления

Раздел средств управления является sub, разделенным на Параметры, Отображение и разделы Действия. Таблица Средств управления приводит различные средства управления и их описание.

Таблица средств управления

Средства управления		Описание
Parameters
	Редактирование	Позволяет вам вводить значение параметров путем ввода его в поле.
	Флажок	Принимает булево значение.
	Всплывающее окно	Позволяет вам выбирать значение параметров из списка возможных значений. Когда вы устанавливаете флажок Evaluate, связанная переменная содержит индекс выбранного пункта. Обратите внимание на то, что индекс запускается от 1, а не 0. Когда Evaluate отключен, связанная переменная содержит строку выбранного пункта.
	Поле комбинированного списка	Позволяет вам выбирать значение параметров из списка возможных значений. Можно также ввести значение или из списка или из за пределами списка. Значения предусмотрели параметр Combo box, не оценены. Для получения дополнительной информации смотрите пример Поля комбинированного списка в slexMaskParameterOptionsExample.
	Переключатель	Позволяет вам выбирать значение параметров из списка возможных значений. Все опции для переключателя отображены на диалоговом окне маски.
	Ползунок	Позволяет вам скользить к значениям в области значений, заданной минимальными и максимальными значениями. Параметр Slider может принять вход как номер или имя переменной. Если заданная переменная является базовым рабочим пространством или переменной рабочего пространства модели, можно настроить значение переменных через Slider. Можно настроить значения в линейной шкале или логарифмическом масштабе с помощью Scale выпадающее меню Можно также управлять областью значений ползунка динамически. Для получения дополнительной информации см. slexMaskParameterOptionsExample.
	Набор	Позволяет вам набирать к значениям в области значений, заданной минимальными и максимальными значениями. Параметр Dial может принять вход как номер или имя переменной. Если заданная переменная является базовым рабочим пространством или переменной рабочего пространства модели, можно настроить значение переменных через Dial. Можно настроить значения в линейной шкале или логарифмическом масштабе с помощью Scale выпадающее меню. Можно также управлять областью значений набора динамически. Для получения дополнительной информации см. slexMaskParameterOptionsExample.
	Поле счетчика	Позволяет вам вращаться через значения в области значений, заданной минимальными и максимальными значениями. Можно задать размер шага для значений.
	DataTypeStr	Позволяет вам задать тип данных для параметра маски. Можно сопоставить Min, Max и параметры Edit с параметром типа данных. Для получения дополнительной информации смотрите, Задают Типы данных Используя Параметр DataTypeStr.
	Min	Задает минимальное значение для параметра DataTypeStr.
	Max	Задает максимальное значение для параметра DataTypeStr.
	Модуль	Позволяет вам устанавливать модули измерения для выходных или входных значений маскированного блока. Параметр Unit может принять любые модули измерения, как введено. Например, рад/секунда для угловой скорости, ^meters/sec2 для ускорения или расстояния в км или m. Для получения дополнительной информации см. slexMaskingUnit.
	Пользовательская таблица	Позволяет вам добавлять таблицы в диалоговом окне маски. Вы можете добавленные стоимости как вложенный массив ячеек в разделе Values Редактора свойств. Для получения дополнительной информации смотрите SlexMaskingCustomTable.
	Продвиньте параметр	Позволяет вам выборочно продвигать параметры блоков от базовых блоков до маски. Кликните по полю Type options, чтобы открыть диалоговое окно Promoted Parameter Selector . В этом диалоговом окне можно выбрать параметры блоков, которые вы хотите продвинуть. Нажмите OK, чтобы закрыть его.
	Продвиньте все	Позволяет вам продвигать все базовые параметры блоков маску. Когда вы продвигаете все параметры, продвинуть операция удаляет параметры, которые были продвинуты ранее.
Container
	Панель	Контейнер группе диалоговых средств управления. Вы используете Panel для логической группировки диалоговых средств управления.
	Групповой блок	Контейнер, чтобы сгруппировать другие диалоговые средства управления и контейнеры в диалоговом окне маски.
	Вкладка	Перейдите в диалоговые средства управления группы в диалоговом окне маски. Вкладка содержится в контейнере вкладки. Контейнер вкладки может иметь несколько вкладок.
	Таблица	Контейнер, чтобы сгруппировать Edit, Check box и параметры Popup в табличной форме. Можно также искать и отсортировать содержимое, перечисленное в контейнере Table. Для получения дополнительной информации смотрите Табличный пример в Диалоговых Параметрах макета и Обрабатывающий Большое количество Параметров Маски.
	CollapsiblePanel	Контейнер, чтобы сгруппировать диалоговые средства управления, подобные Panel. Можно принять решение расширить или свернуть диалоговые средства управления CollapsiblePanel. Для получения дополнительной информации смотрите Разборный пример Панели в Диалоговых Параметрах макета.
Display
	Текст	Текст отображен в диалоговом окне маски.
	Изображение	Изображение отображено в диалоговом окне маски.
	Текстовая область	Добавьте пользовательский текст или код MATLAB в диалоговом окне маски.
	Управление полем списка	Позволяет вам выбирать значение из списка возможных значений. Можно выбрать несколько значений (Ctrl + нажатие кнопки).
Action
	Гиперссылка	Текст гиперссылки отображен на диалоговом окне маски.
	Кнопка	Кнопочные управления на диалоговом окне маски. Можно программировать кнопку для определенных действий. Можно также добавить изображение на кнопочные управления. Для получения дополнительной информации см. slexMaskParameterOptionsExample.

Диалоговое окно

Можно создать иерархию из диалоговых средств управления путем перетаскивания их от раздела Controls до Dialog box. Можно также кликнуть по палитрам на разделе Controls, чтобы добавить необходимое управление в Dialog box. Можно добавить максимум 32 уровней иерархии в Dialog box.

Dialog box отображает три поля: Type, Prompt и Name.

Поле Type показывает тип диалогового управления и не может быть отредактировано. Это также отображает порядковый номер для диалоговых средств управления параметром.
Поле Prompt показывает текст запроса для диалогового управления.
Поле Name автозаполняется и однозначно определяет диалоговые средства управления. Вы можете принять решение добавить различное значение (допустимое имя MATLAB) в поле Name и не должны совпадать со встроенным названием параметра.

Средства управления Parameter отображены в голубом фоне, тогда как Display и средства управления Action отображены в белом фоне на Dialog box.

Можно переместить диалоговое управление в иерархию, можно скопировать и вставить диалоговое управление, можно также удалить узел. Для получения дополнительной информации смотрите Диалоговые Операции Управления.

Propertyeditor

Property editor позволяет вам просматривать и устанавливать свойства для Parameter, Display и диалоговых средств управления Action. Property editor для Parameter показывают:

Можно установить следующие свойства для Parameter, Action и диалоговых средств управления Display. Для получения дополнительной информации см. таблицу Редактора свойств.

Propertyeditor

Свойство	Описание
Properties
Имя	Однозначно определяет диалоговое управление в диалоговом окне маски. Свойство Name должно быть установлено для всех диалоговых средств управления.
Значение	Значение диалогового управления Parameter. Свойство Value применяется только к диалоговым средствам управления Parameter.
Подсказка	Текст метки, который идентифицирует параметры в диалоговом окне маски. Свойство Prompt применяется ко всем диалоговым средствам управления кроме Panel и диалоговому управлению Image.
Ввод	Тип диалогового управления. Можно использовать поле Type, чтобы изменить типы Container и Parameter. Вы не можете изменить контейнерный тип, чтобы Перейти и наоборот.
Расширение	Позволяет вам задавать, расширено ли разборное диалоговое управление панелью или свернуто по умолчанию.
Введите опции	Свойство Type options позволяет вам устанавливать определенные свойства Parameter. Свойство Type options применяется к Popup, Radio button, DataTypeStr и параметрам Promoted.
Filepath	Можно добавить изображение в маску с помощью диалогового управления Image. Можно также отобразить изображение на диалоговом управлении Button. В любом случае обеспечьте путь к изображению в свойстве File path, которое включено для этих двух диалоговых средств управления. Для диалогового управления Button задайте пустой символьный вектор для свойства Prompt для изображения, которое будет отображено.
Переход на новую строку	Свойство Word wrap включает переход на новую строку для длинного текста. Свойство Word wrap применяется только для диалогового управления Text.
Максимум и минимум	Свойства Maximum и Minimum позволяют вам задать область значений для средств управления как Spinbox, Slider и Dial.
Неродной размер	Позволяет вам задавать размер шага для значений. Это свойство применяется только для диалогового управления Spinbox.
Подсказка	Позволяет вам задавать подсказку для выбранного диалогового типа управления. Подсказка видима, когда вы наводите курсор на диалоговое управление на диалоговом окне маски. Можно добавить подсказки для всего диалогового типа средств управления за исключением Group box, Tab, CollapsiblePanel и Panel.
Шкала	Позволяет вам устанавливать настраивающуюся шкалу как `linear` или `log` для Slider и диалоговых средств управления Dial.
Attributes
Оценить	Simulink использует значение параметра маски при печати это в диалоговом окне маски, или это может оценить то, что вы задаете и используете в качестве результата оценки. Выберите опцию Evaluate для параметра, чтобы задать оценку параметра (значение по умолчанию). Чтобы подавить оценку, очистите опцию.
Настраиваемый	По умолчанию можно изменить значение параметров маски во время симуляции. Чтобы предотвратить изменение значения параметров во время симуляции, очистите опцию Tunable. Если параметр маскированный не поддерживает настройку параметра, Simulink игнорируют установку опции Tunable параметра маски. Такие параметры затем отключены на Редакторе Маски. Можно указать, что тип параметра, где настраиваемый отключен. Можно также изменить значение параметров маски при симуляции модели на быстром режиме перезапуска. В зависимости от значения, заданного для атрибута Tunable и режима симуляции, параметр маски может или быть только для чтения или чтение-запись. Если вы установили настраиваемый атрибут на on или off, и режим симуляции или нормален или на быстром режиме перезапуска, то параметры маски устанавливаются на чтение-запись (доступный для редактирования) и режим только для чтения, соответственно. Если вы устанавливаете настраиваемый режим на выполнение-к-управляемому, и если ваш режим симуляции собирается быстро перезапустить режим, то параметры маски устанавливаются на чтение-запись (настраиваемый) режим, когда модель не моделируется. Для получения информации о настройке параметра и блоках, которые поддерживают его, смотрите Мелодию и Эксперимент со Значениями Параметров блоков.
Только для чтения	Указывает, что параметр не может быть изменен.
Скрытый	Указывает, что параметр не должен быть отображен в диалоговом окне маски.
Никогда не сохраняйте	Указывает, что значение параметров никогда не становится сохраненным в образцовом файле.
Ограничение	Позволяет вам добавлять ограничения в выбранный параметр.
Dialog box
Включить	Enable по умолчанию выбран. Если вы очищаете эту опцию, выбранное управление становится недоступным редактированию. Пользователи маскированного блока не могут установить значение параметра.
Видимый	Выбранное управление появляется в диалоговом окне маски, только если эта опция выбрана.
'callback'	Код MATLAB, который вы хотите, чтобы Simulink выполнил, когда пользователь применяет изменение в выбранном управлении. Simulink использует базовое рабочее пространство, чтобы выполнить код коллбэка.
Layout
Местоположение элемента	Позволяет вам устанавливать местоположение для диалогового управления появляться в текущей строке или новой строке.
Выровняйте подсказки	Позволяет вам выравнивать параметры на диалоговом окне маски. Эта опция поддерживается для всех типов управления Отображением кроме Таблицы. Для получения дополнительной информации смотрите Параметр Поля комбинированного списка.
Быстрое местоположение	Позволяет вам устанавливать быстрое местоположение для диалогового управления или на верхней части или слева от диалогового управления. Вы не можете установить свойство Prompt location для Check box, Dial, DataTypeStr, Collapsible Panel и Radiobutton.
Ориентация	Позволяет вам задавать горизонтальную или вертикальную ориентацию для ползунков и переключателей.
Горизонтальный фрагмент	Если эта опция выбрана, средства управления на фрагменте диалогового окна маски горизонтально, когда вы изменяете размер диалогового окна маски. По умолчанию флажок Horizontal Stretch устанавливается. Для получения дополнительной информации смотрите Горизонтальное Свойство Фрагмента.

Панель инициализации

Диалоговые переменные
Команды инициализации
Позвольте блоку библиотеки изменять свое содержимое
Правила для команд Инициализации

Панель Initialization позволяет вам добавлять команды MATLAB, которые инициализируют маскированный блок.

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

Маскированный блок имеет команды рисования значка.
Примечание
Simulink не инициализирует маскированные блоки, которые не имеют команд рисования значка, даже если у них есть команды инициализации.
Маскированный блок принадлежит библиотеке и включил Allow library block to modify its contents.

Команды инициализации для всех маскированных блоков в модели запускаются когда вы:

Обновите схему
Запустите симуляцию
Запустите генерацию кода
Нажмите Apply на диалоговом окне

Команды инициализации для отдельного маскированного блока, запущенного, когда вы:

Измените любой из параметров маски, которые задают маску, такую как MaskDisplay и MaskInitialization, при помощи Редактора Маски или команды set_param.
Вращайте или инвертируйте маскированный блок, если значок зависит от команд инициализации.
Заставьте значок чертиться или перерисовываться, и рисунок значка зависит от кода инициализации.
Измените значение параметра маски при помощи диалогового окна блока или команды set_param.
Скопируйте маскированный блок в той же модели или между различными моделями.

Панель Initialization содержит средства управления, описанные в этом разделе.

Диалоговые переменные

Список Dialog variables отображает имена диалоговых средств управления и сопоставленных параметров маски, которые заданы в панели Parameters & Dialog. Можно также использовать список, чтобы изменить названия параметров маски. Чтобы изменить название, дважды кликните имя в списке. Поле редактирования, содержащее существующее имя, появляется. Отредактируйте существующее имя и нажмите Enter или нажатие кнопки вне поля редактирования, чтобы подтвердить ваши изменения.

Команды инициализации

Введите команды инициализации в это поле. Можно ввести любое допустимое выражение MATLAB, состоя из функций MATLAB и скриптов, операторов и переменных, заданных в рабочей области маски. Команды инициализации запущены в рабочей области маски, не базовом рабочем пространстве.

Позвольте блоку библиотеки изменять свое содержимое

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

Правила для команд Инициализации

Следующие правила касаются команд инициализации маски:

Не используйте код инициализации, чтобы создать диалоговые окна маски, внешний вид которых или настройки управления изменяются в зависимости от изменений, внесенных в другие настройки управления. Вместо этого используйте коллбэки маски, обеспеченные именно с этой целью.
Постарайтесь не снабжать имена переменных предисловием в командах инициализации с MaskParam_L_ и MaskParam_M_. Эти определенные префиксы резервируются для использования с именами внутренней переменной.
Избегайте использования команд set_param, чтобы установить параметры блоков, находящихся в подсистемах маскированных, которые находятся в инициализируемой подсистеме маскированной. Смотрите Настроенные Вложенные Параметры Маскированного блока для деталей.

Панель документации

Панель Documentation позволяет вам задать или изменить тип, описание и текст справки для маскированного блока.

Ввод

Тип маски является классификацией блоков, которая появляется в диалоговом окне маски и на всех панелях Mask Editor для блока. Когда Simulink отображает диалоговое окно маски, это суффиксы (mask) к типу маски. Чтобы задать тип маски, введите его в поле Type. Текст может содержать любой допустимый символ MATLAB, но не может содержать разрывы строки.

Описание

Описание маски является итоговым текстом справки, которые описывают цель или функцию блока. По умолчанию описание маски отображено ниже типа маски в диалоговом окне маски. Чтобы задать описание маски, введите его в поле Description. Текст может содержать любой легальный символ MATLAB. Simulink автоматически переносит длинные линии. Можно обеспечить разрывы строки при помощи ключа Enter.

Справка

Онлайновая Справка для маскированного блока предоставляет информацию в дополнение к обеспеченному полями Type и Description. Эта информация появляется в отдельном окне, когда пользователь маскированного блока нажимает кнопку Help на диалоговом окне маски. Чтобы задать справку маски, введите один из них в поле Help:

Спецификация URL
web или команда eval
Буквенный текст или текст HTML

Обеспечьте URL. Если первой строкой поля Mask help является URL, Simulink передает URL вашему веб-браузеру по умолчанию. URL может начаться с https:, www:, file:, ftp: или mailto:. Примеры:

https://www.mathworks.com
file:///c:/mydir/helpdoc.html

Если браузер активен, MATLAB и Simulink не имеют никакого дальнейшего контроля над своими действиями.

Обеспечьте Команду web. Если первая строка поля Mask help является командой web, Simulink передает команду MATLAB, который отображает заданный файл в MATLAB Online Браузер документации. Пример:

web([docroot '/MyBlockDoc/' get_param(gcb,'MaskType') '.html'])

См. документацию команды web MATLAB для деталей. Команда web, используемая для справки маски, не может возвращаемые значения.

Обеспечьте Команду eval. Если первая строка поля Mask help является командой eval, Simulink передает команду MATLAB, который выполняет заданную оценку. Пример:

eval('!Word My_Spec.doc')

Смотрите MATLAB документация команды eval для деталей. Команда eval, используемая для справки маски, не может возвращаемые значения.

Предоставьте Буквенный текст или ТЕКСТ HTML. Если первой строкой поля Mask help не является URL, или web или команда eval, Simulink отображает текст в MATLAB Online Браузер документации в соответствии с заголовком, который является значением поля Mask type. Текст может содержать любой легальный символ MATLAB, разрывы строки и любой стандартный HTML-тэг, включая теги как img это изображения на дисплее.

Simulink сначала копирует текст во временную папку, затем отображает текст с помощью команды web. Если вы хотите, чтобы текст отобразил изображение, можно обеспечить путь URL к файлу изображения, или можно поместить файл изображения во временную папку. Используйте tempdir, чтобы найти временную папку, которую Simulink использует для вашей системы.

Дополнительные опции

Следующие кнопки появляются на Mask Editor:

Кнопка Preview применяет изменения, которые вы внесли и открываете диалоговое окно маски.
Кнопка OK применяет настройки маски и закрывает Mask Editor.
Кнопка Cancel закрывает Mask Editor, не применяя изменений, которые вы внесли в маску.
Кнопка Help отображает онлайновую информацию о Mask Editor.
Кнопка Apply применяет настройки маски и оставляет Mask Editor открытым.
Кнопка Unmask удаляет маску и закрывает Mask Editor. Чтобы создать маску снова, выберите блок и выберите Mask> Create Mask.

Документация