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
, возвращаемого доменной областью.