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

Настройте метки порта на значке блока

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

  nodes
    p = foundation.electrical.electrical; % +
    n = foundation.electrical.electrical; % -  
  end

Если вы зададите пустую строку комментария после узла, введете или выведете объявление, соответствующему порту не отобразят его имя. Например, следующий синтаксис подавляет метку порта для входного порта физического сигнала PS:

  inputs
     PS; %
  end

Местоположения порта управления Используя аннотации

Используйте annotations разделите в файле компонента, чтобы задать местоположения порта. Например:

  nodes
    H = foundation.thermal.thermal;
    p = foundation.electrical.electrical; % +
    n = foundation.electrical.electrical; % -
  end
  annotations
    H : Side = top;
    p : Side = left;
    n : Side = right;
  end

Правила и ограничения:

Используйте комментарии для местоположений порта управления

Можно также использовать комментарий, который сразу следует за узлом, входом или выходным объявлением, чтобы задать и метку порта и местоположение. Комментарий может быть на той же линии или на отдельной линии. Комментарий должен начаться с % символ и быть формата label:location, где label строка, соответствующая имени входного порта в блок-схеме и location одна из следующих строк: left, right, top, bottom. Можно определить местоположение всех портов или на одной стороне блока или на двух противоположных сторонах, например, левых и правых, или верхних и нижних. Можно не использовать местоположение, если вы хотите сохранить местоположение по умолчанию порта (на левой стороне).

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

    r = foundation.mechanical.rotational.rotational; % :top

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

Следующее является примерами объявлений узла и получившихся значков блока.

nodes
   r = foundation.mechanical.rotational.rotational; 
   c = foundation.mechanical.rotational.rotational; 
end 

nodes
   r = foundation.mechanical.rotational.rotational; % rod
   c = foundation.mechanical.rotational.rotational; % case
end 

nodes
   r = foundation.mechanical.rotational.rotational; 
   c = foundation.mechanical.rotational.rotational; % c:right
end 

nodes
   r = foundation.mechanical.rotational.rotational; % rod
   c = foundation.mechanical.rotational.rotational; % case:right
end 

nodes
   r = foundation.mechanical.rotational.rotational; % rod
   c = foundation.mechanical.rotational.rotational; % :right
end 

nodes
   r = foundation.mechanical.rotational.rotational; % 
   c = foundation.mechanical.rotational.rotational; % case:right
end 

Используя аннотации

Используйте annotations разделите в файле компонента, чтобы задать имя значка пользовательского блока. Имя файла должно содержать расширение файла. Например:

  annotations
    Icon = 'custom_spring.jpg';
  end

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

  annotations
    Icon = '../../block_icons/custom_spring.jpg';
  end

annotations раздел также позволяет вам задать условные пользовательские значки. Это особенно полезно, если количество портов изменяется для различных вариантов. Например:

component MyPipe
  parameters
    thermal_variant = false; % Model thermal effects?
  end
  if thermal_variant 
  % Use icon with additional thermal port
    annotations
       Icon = 'pipe_thermal.jpg';
    end
  else
  % Use regular icon, with two fluid ports
    annotations
       Icon = 'pipe.jpg';
    end
  end
  [...] % Other parameters, variables, nodes, branches, equations
end

Используя соглашения о присвоении имен файла

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

Этот метод удобен, если вы поставляете полные пакеты библиотеки клиентам. Например, если подпакет, содержащий файл компонента spring.ssc также содержит файл с именем spring.jpg, затем тот файл изображения автоматически используется в значке, представляющем этот блок в пользовательской библиотеке.

Неявные правила для использования значков пользовательского блока:

Поддерживаемые форматы файлов

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

Тип изображения должен быть RGB (истинный цвет) изображение, сохраненное как m- n- 3 массива данных. Для получения дополнительной информации смотрите RGB (Истинный цвет) Изображения (MATLAB).

Определение свойств масштабирования и вращения значка пользовательского блока

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

component name
% [ CustomName [ : scale [ : rotation ] ] ] 
...

где

Например, следующий синтаксис

component spring
% Rotational Spring : 0.5 : fixed

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