createwire

Функция создания линии связи.

Синтаксис:

wire_id = createwire(id, line_type, parent_line_id, point_nmb, start_port_id, end_port_id, points_count);
wire_id = createwire(id, line_type, parent_line_id, point_nmb, start_port_id, end_port_id, points_count, layer_nmb);

Аргументы:

id – целое число, идентификатор проекта или страницы;

line_type – целое число, тип линии связи (0 – математическая, 1 – гидравлическая, 2 – тепловая, 3 – электрическая, 4 – механическая, 5 – связь состояния, 6 – межканальный обмен, 7 – тепловое излучение, 8 – связь бака с трубным пучком);

parent_line_id – целое число, идентификатор родительской линии;

point_nmb – целое число, номер точки родительской линии начиная с 0, куда будет присоединена линия;

start_port_id – целое число, идентификатор начального порта;

end_port_id – целое число, идентификатор конечного порта;

points_count – целое число, количество промежуточных точек в линии связи;

layer_nmb – целое число, номер визуального слоя проекта (если не указан, то принимается равным 0).

Описание:

createwire – функция позволяет проводить на схеме проекта или странице (c идентификатором id) линию связи типа line_type от порта с идентификатором start_port_id до порта с идентификатором end_port_id, при этом аргументы parent_line_id и point_nmb должны быть равны 0. Либо от точки с номером point_nmb линии связи с идентификатором parent_line_id до порта с идентификатором end_port_id, при этом start_port_id должно быть равно 0. Идентификатор проекта может быть получен с помощью функций getcurrentprojectid, addprojecttopack. Идентификатор порта может быть получен с помощью функции getblockportid. Идентификатор линии связи может быть получен с помощью функций getportwireid, getparentwireid, getportwires.

Результат:

Функция возвращает целочисленное значение wire_id, равное идентификатору созданной линии связи.

Пример:

out_port_id = getblockportid(block1_id,0); //получение идентификатора начального порта
in_port_id = getblockportid(block2_id,1); //получение идентификатора конечного порта
in_port2_id = getblockportid(block2_id,2); //получение идентификатора второго конечного порта
wire_id = createwire(getcurrentprojectid,0,0,0,out_port_id,in_port_id,2); //создание линии связи от начального порта до конечного порта
createwire(getcurrentprojectid,0,wire_id,1,0,test_port,0); //создание линии связи от первой точки созданной линии до второго конечного порта

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

Сопутствующие материалы