DomainStartSimulation: различия между версиями
Перейти к навигации
Перейти к поиску
| Строка 5: | Строка 5: | ||
{{package_sequence begin}} | {{package_sequence begin}} | ||
{{package_sequence add |RequestId| 4 | Беззнаковый целочисленный идентификатор запроса, значение которого должно быть равно [[DomainStartSimulation]] (т.е. 0).}} | {{package_sequence add |RequestId| 4 | Беззнаковый целочисленный идентификатор запроса, значение которого должно быть равно [[DomainStartSimulation]] (т.е. 0).}} | ||
{{package_sequence add |control_address| Размер машинного слова<ref>Для подсистемы предметной области, реализованной как внутрипроцессный сервер</ref> или 6<ref>Для подсистемы предметной области, реализованной как удаленный узел</ref> | Адрес экземпляра [[подсистема управления|подсистемы управления]] (адрес в памяти для внутрипроцессного сервера, либо IP сокет - для удаленного узла).}} | {{package_sequence add |control_address| Размер машинного слова<ref>Для подсистемы предметной области, реализованной как внутрипроцессный сервер</ref> или 6<ref>Для подсистемы предметной области, реализованной как удаленный узел</ref> | Адрес экземпляра [[подсистема управления|подсистемы управления]] (адрес в памяти для внутрипроцессного сервера, либо TCP/IP сокет - для удаленного узла).}} | ||
{{packed geometry model}} | {{packed geometry model}} | ||
{{packed_process_name| Назначенное [[подсистема управления|подсистемой управления]] имя создаваемого моделирующего процесса.}} | {{packed_process_name| Назначенное [[подсистема управления|подсистемой управления]] имя создаваемого моделирующего процесса.}} | ||
Версия 14:52, 22 декабря 2015
Запрос управляющей системе на запуск моделирования для предоставленной модели среды.
Структура запроса[1]
| Имя поля | Размер, байт | Смысл | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| RequestId | 4 | Беззнаковый целочисленный идентификатор запроса, значение которого должно быть равно DomainStartSimulation (т.е. 0). | |||||||||||||||
| control_address | Размер машинного слова[2] или 6[3] | Адрес экземпляра подсистемы управления (адрес в памяти для внутрипроцессного сервера, либо TCP/IP сокет - для удаленного узла). | |||||||||||||||
| Геометрическая модель среды поля | |||||||||||||||||
| Имя модели | |||||||||||||||||
| model_name_size | 4 | Размер имени модели в байтах | |||||||||||||||
| model_name | model_name_size | Имя модели в UTF-8.
| |||||||||||||||
| Запакованные параметры пространства. | |||||||||||||||||
| metric_id | 4 | Беззнаковое целое, задающее единицу измерения длины. Может принимать одно из следующих значений.
| |||||||||||||||
| Запакованный размер. | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определен размер. | |||||||||||||||
| размеры | 8 dimensions | Последовательно заданные размеры во всех dimensions измерениях. Размеры в измерениях dimensions полагаются бесконечными. | |||||||||||||||
| Серия параметров предметной области пространства[4]. | |||||||||||||||||
| domain_size | 4 | Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные. | |||||||||||||||
| domain_name_size | 4 | Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные. | |||||||||||||||
| domain_name | domain_name_size | Строковой идентификатор экземпляра подсистемы предметной области. | |||||||||||||||
| domain_data_size | 4 | Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области. | |||||||||||||||
| domain_params | domain_data_size | Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
| |||||||||||||||
| ... | |||||||||||||||||
| Элементы геометрической модели | |||||||||||||||||
| object_count | 4 | Число всех объектов модели | |||||||||||||||
| Последовательность object_count запакованных объектов, каждый из которых, представлен ниже | |||||||||||||||||
| Общие параметры для всех классов объектов | |||||||||||||||||
| object_name_size | 4 | Беззнаковое целое число байт в имени объекта модели. [5] | |||||||||||||||
| object_name | object_name_size | UTF-8 строка с именем объекта модели. [5] | |||||||||||||||
| Серия параметров предметной области объекта[6]. | |||||||||||||||||
| domain_size | 4 | Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные. | |||||||||||||||
| domain_name_size | 4 | Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные. | |||||||||||||||
| domain_name | domain_name_size | Строковой идентификатор экземпляра подсистемы предметной области. | |||||||||||||||
| domain_data_size | 4 | Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области. | |||||||||||||||
| domain_params | domain_data_size | Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
| |||||||||||||||
| ... | |||||||||||||||||
| typeid | 4 | Беззнаковый целочисленный идентификатор класса создаваемого объекта.
| |||||||||||||||
| Для полигонального объекта | |||||||||||||||||
| faces_count | 4 | Число полигонов, составляющих создаваемый объект. | |||||||||||||||
| Полигон 1 | |||||||||||||||||
| vertex_count | 4 | Беззнаковое целое число вершин, составляющих полигон. | |||||||||||||||
| Вершина 1 | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| ... | |||||||||||||||||
| Вершина vertex_count. | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| Серия параметров предметной области полигона[7] | |||||||||||||||||
| domain_size | 4 | Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные. | |||||||||||||||
| domain_name_size | 4 | Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные. | |||||||||||||||
| domain_name | domain_name_size | Строковой идентификатор экземпляра подсистемы предметной области. | |||||||||||||||
| domain_data_size | 4 | Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области. | |||||||||||||||
| domain_params | domain_data_size | Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
| |||||||||||||||
| ... | |||||||||||||||||
| ... | |||||||||||||||||
| Полигон faces_count | |||||||||||||||||
| vertex_count | 4 | Беззнаковое целое число вершин, составляющих полигон. | |||||||||||||||
| Вершина 1 | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| ... | |||||||||||||||||
| Вершина vertex_count. | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| Серия параметров предметной области полигона[7] | |||||||||||||||||
| domain_size | 4 | Беззнаковое целое, задающее количество экземпляров подсистемы предметной области, для которых заданы данные. | |||||||||||||||
| domain_name_size | 4 | Беззнаковое целое, задающее байтовую длину идентификатора экземпляра подсистемы предметной области, для которой заданы данные. | |||||||||||||||
| domain_name | domain_name_size | Строковой идентификатор экземпляра подсистемы предметной области. | |||||||||||||||
| domain_data_size | 4 | Байтовый размер данных предметной области для экземпляра domain_name подсистемы предметной области. | |||||||||||||||
| domain_params | domain_data_size | Параметры предметной области для экземпляра domain_name подсистемы предметной области. Отсутствуют при domain_name_size = domain_data_size = 0.
| |||||||||||||||
| ... | |||||||||||||||||
| Для объекта-источника | |||||||||||||||||
| Позиция источника поля | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| Ненулевые некомпланарные вектора направлений для каждого из измерений | |||||||||||||||||
| число_векторов | 4 | Количество векторов, значение должно быть не меньше количества измерений, в которых определены вектора источника, минус один. | |||||||||||||||
| Вектора направлений источника поля | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| ... | |||||||||||||||||
| Для секущей плоскости вывода результатов | |||||||||||||||||
| Позиция точки на плоскости | |||||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| Направляющие вектора плоскости | |||||||||||||||||
| число_векторов | 4 | Число векторов, задающих положение плоскости. | |||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | |||||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | |||||||||||||||
| ...
| |||||||||||||||||
| Назначенное подсистемой управления имя создаваемого моделирующего процесса. | |||||||||||||||||
| process_name_size | 4 | Беззнаковое целое число байт в имени процесса | |||||||||||||||
| process_name | process_name_size | UTF-8 строка с именем процесса. | |||||||||||||||
Структура ответа[8]
Ответ отсутствует, параметр pOut игнорируется функцией DomainEntryPoint.
Примечания
- ↑ Наполнение буфера
pRequestпри вызове функции DomainEntryPoint. - ↑ Для подсистемы предметной области, реализованной как внутрипроцессный сервер
- ↑ Для подсистемы предметной области, реализованной как удаленный узел
- ↑ В предметной области "Архитектурная акустика" параметры доменной области пространства - число с плавающей точкой двойной точности (8 байт), задающее коэффициент линейного затухания звукового сигнала. Поэтому для архитектурной акустики domain_size должен быть равен 8, а domain_params должен содержать бинарного представления коэффициента затухания. В предметной области "Интеграл" параметры доменной области - пара пределов интегрирования (сначала - меньший, затем - больший), каждый из которых является 8-байтовым числом с плавающей точкой.
- ↑ 5,0 5,1 При создании модели имя объекта не должно задаваться пользователем, т.е.
object_name_sizeдолжно быть равно 0, а данные поляobject_nameне должны включаться в параметры запроса на создание объекта. - ↑ Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
Для предметной области "Архитектурная акустика".- Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
- Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
- Для плоскости вывода результатов параметры предметной области не задаются.
- Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
- ↑ 7,0 7,1 Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
Для предметной области "Архитектурная акустика".- Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
- Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
- Для плоскости вывода результатов параметры предметной области не задаются.
- Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
- ↑ Наполнение буфера
pOutпри вызове функции DomainEntryPoint.