CreateObjectId
Запрос на создание нового объекта модели. Задано три класса объектов:
- Полигональный элемент геометрической модели.
- Источник поля.
- Секущая плоскость вывода результатов моделирования.
Входные параметры запроса[1]
| Имя поля | Размер, байт | Смысл | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Имя модели | ||||||||||||||
| model_name_size | 4 | Размер имени модели в байтах | ||||||||||||
| model_name | model_name_size | Имя модели в UTF-8.
| ||||||||||||
| Объект-элемент модели пространства | ||||||||||||||
| Общие параметры для всех классов объектов | ||||||||||||||
| object_name_size | 4 | Беззнаковое целое число байт в имени объекта модели. [2] | ||||||||||||
| object_name | object_name_size | UTF-8 строка с именем объекта модели. [2] | ||||||||||||
| Серия параметров предметной области объекта[3]. | ||||||||||||||
| 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 | Последовательно заданные координаты точки. | ||||||||||||
| Серия параметров предметной области полигона[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.
| ||||||||||||
| ... | ||||||||||||||
| ... | ||||||||||||||
| Полигон faces_count | ||||||||||||||
| vertex_count | 4 | Беззнаковое целое число вершин, составляющих полигон. | ||||||||||||
| Вершина 1 | ||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | ||||||||||||
| ... | ||||||||||||||
| Вершина vertex_count. | ||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 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.
| ||||||||||||
| ... | ||||||||||||||
| Для объекта-источника | ||||||||||||||
| Позиция источника поля | ||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | ||||||||||||
| Ненулевые некомпланарные вектора направлений для каждого из измерений | ||||||||||||||
| число_векторов | 4 | Количество векторов, значение должно быть не меньше количества измерений, в которых определены вектора источника, минус один. | ||||||||||||
| Вектора направлений источника поля | ||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | ||||||||||||
| ... | ||||||||||||||
| Для секущей плоскости вывода результатов | ||||||||||||||
| Позиция точки на плоскости | ||||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | ||||||||||||
| Направляющие вектора плоскости | ||||||||||||||
| число_векторов | 4 | Число векторов, задающих положение плоскости. | ||||||||||||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. | ||||||||||||
| координаты | 8 dimensions | Последовательно заданные координаты точки. | ||||||||||||
| ... | ||||||||||||||
| Специальные параметры объекта, зависимые от класса. | ||||||||||||||
При создании объекта его имя не задается, поэтому поле object_name_size должно быть нулевым, а данные object_name должны отсутствовать.
В зависимости от класса создаваемого объекта указанные выше параметры дополняются специальными для класса параметрами.
Для полигонального объекта.
| Имя поля | Размер, байт | Смысл |
|---|---|---|
| faces_count | 4 | Число полигонов, составляющих создаваемый объект. |
| Полигон 1 | ||
| vertex_count | 4 | Беззнаковое целое число вершин, составляющих полигон. |
| Вершина 1 | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| ... | ||
| Вершина vertex_count. | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 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.
|
| ... | ||
| ... | ||
| Полигон faces_count | ||
| vertex_count | 4 | Беззнаковое целое число вершин, составляющих полигон. |
| Вершина 1 | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| ... | ||
| Вершина vertex_count. | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 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.
|
| ...
| ||
| Полигон faces_count | ||
| vertex_count | 4 | Число вершин, составляющих полигон. |
| Вершина 1 | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| ... | ||
| Вершина vertex_count. | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| domain_size | 4 | Байтовый размер параметров предметной области. |
| domain_data | domain_size | Параметры предметной области, связанные с полигоном faces_count. |
Вершины полигона должны быть заданы по часовой стрелке при обходе с внешней стороны объекта.
В предметной области "Архитектурная акустика" общие предметные параметры полигонального объекта не задаются. Однако в качестве предметных параметров, связанных поверхностью, передается коэффициент поглощения звука - как число с плавающей точкой двойной точности.
В предметной области "Интеграл" параметры доменной области, связанные с полигональным объектом и отдельными полигонами, не задаются.
Для источника поля.
| Имя поля | Размер, байт | Смысл |
|---|---|---|
| Позиция источника поля | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| Вектор направления источника поля | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
Параметром предметной области, связанным с источником поля, является его интенсивность в главном направлении.
В предметной области "Интеграл" параметры доменной области, связанные с источником, не задаются.
Для плоскости вывода результатов.
| Имя поля | Размер, байт | Смысл |
|---|---|---|
| Позиция точки на плоскости | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| Первый вектор направления плоскости | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
| Второй вектор направления плоскости, не параллельный первому. | ||
| dimensions | 4 | Беззнаковое целое, которое задает число измерений, в которых определены ненулевые координаты точки. |
| координаты | 8 dimensions | Последовательно заданные координаты точки. |
Вектора плоскости должны быть взаимно ортогональными.
Точка и вектора должны быть заданы таким образом, чтобы в соответствующем базисе координаты всех точек плоскости, лежащих "внутри" модели, были неотрицательны. См. | cam-27.
В предметной области "Архитектурная акустика" параметры доменной области, связанные с источником, не задаются.
В предметной области "Интеграл" параметры доменной области, связанные с источником, не задаются.
Выходные параметры запроса[5]
В случае успешного вызова функции entry_point ответом является имя созданного элемента модели model_name на сервере.
- ↑ Содержимое буфера
pPackedInputParamsпри вызове функции entry_point. - ↑ 2,0 2,1 При создании модели имя объекта не должно задаваться пользователем, т.е.
object_name_sizeдолжно быть равно 0, а данные поляobject_nameне должны включаться в параметры запроса на создание объекта. - ↑ Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
Для предметной области "Архитектурная акустика".- Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
- Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
- Для плоскости вывода результатов параметры предметной области не задаются.
- Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
- ↑ 4,0 4,1 4,2 4,3 Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
Для предметной области "Архитектурная акустика".- Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
- Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
- Для плоскости вывода результатов параметры предметной области не задаются.
- Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
- ↑ Содержимое буфера
pPackedOutputParams, возвращаемого доменной областью.