CreateObjectId: различия между версиями

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
(Новая страница: «Запрос на создание нового объекта модели. Задано три класса объектов: # Полигональный эл…»)
 
(Точка входа в control.dll давно уже имеет другое имя)
 
(не показаны 4 промежуточные версии этого же участника)
Строка 4: Строка 4:
# Секущая плоскость вывода результатов моделирования.
# Секущая плоскость вывода результатов моделирования.


'''Входные параметры запроса'''<ref>Содержимое буфера <code>pPackedInputParams</code> при вызове функции [[entry_point]].</ref>
'''Входные параметры запроса'''<ref>Содержимое буфера <code>pPackedInputParams</code> при вызове функции [[ControlSystemEntryPoint]].</ref>


{{package_sequence begin}}
{{package_sequence begin}}
{{packed_model_name}}
{{packed_model_name}}
{{packed_object}}
{{packed_object}}
{{package_sequence header | Специальные параметры объекта, зависимые от класса.}}
{{package_sequence end}}
{{package_sequence end}}


''При создании объекта его имя не задается, поэтому поле <code>object_name_size</code> должно быть нулевым, а данные <code>object_name</code> должны отсутствовать.''
'''Выходные параметры запроса'''<ref>Содержимое буфера <code>pPackedOutputParams</code>, возвращаемого управляющей подсистемой.</ref>


В зависимости от класса создаваемого объекта указанные выше параметры дополняются специальными для класса параметрами.
В случае успешного вызова функции [[ControlSystemEntryPoint]] ответом является имя созданного элемента модели <code>model_name</code> на сервере.


'''Для полигонального объекта.'''
'''Другие запросы'''


{{package_sequence begin}}
{{Control Message Table}}
{{package_sequence add | faces_count | 4 | Число полигонов, составляющих создаваемый объект. }}
{{packed_face | Полигон 1}}
{{package_sequence header | ... }}
{{packed_face | Полигон <tt>faces_count</tt>}}
 
 
{{package_sequence header | Полигон <tt>faces_count</tt>}}
{{package_sequence add | vertex_count | 4 | Число вершин, составляющих полигон. }}
{{packed_point | Вершина 1 }}
{{package_sequence header | ... }}
{{packed_point | Вершина <tt>vertex_count</tt>. }}
{{package_sequence add | domain_size | 4 | Байтовый размер параметров предметной области. }}
{{package_sequence add | domain_data | <tt>domain_size</tt> | Параметры предметной области, связанные с полигоном <tt>faces_count</tt>. }}
{{package_sequence end}}
 
''Вершины полигона должны быть заданы по часовой стрелке при обходе с внешней стороны объекта.''
 
''В предметной области "Архитектурная акустика" общие предметные параметры полигонального объекта не задаются. Однако в качестве предметных параметров, связанных поверхностью, передается коэффициент поглощения звука - как число с плавающей точкой двойной точности.''
 
''В предметной области "Интеграл" параметры доменной области, связанные с полигональным объектом и отдельными полигонами, не задаются.''
 
'''Для источника поля.'''
 
{{package_sequence begin}}
{{packed_point | Позиция источника поля}}
{{packed_point | Вектор направления источника поля}}
{{package_sequence end}}
 
''Параметром предметной области, связанным с источником поля, является его интенсивность в главном направлении.''
 
''В предметной области "Интеграл" параметры доменной области, связанные с источником, не задаются.''
 
'''Для плоскости вывода результатов.'''
 
{{package_sequence begin}}
{{packed_point | Позиция точки на плоскости}}
{{packed_point | Первый вектор направления плоскости}}
{{packed_point | Второй вектор направления плоскости, не параллельный первому.}}
{{package_sequence end}}
 
''Вектора плоскости должны быть взаимно ортогональными.''
 
''Точка и вектора должны быть заданы таким образом, чтобы в соответствующем базисе координаты всех точек плоскости, лежащих "внутри" модели, были неотрицательны. См. [http://www.chusov.org:8080/issue/cam-27 | cam-27].''
 
''В предметной области "Архитектурная акустика" параметры доменной области, связанные с источником, не задаются.''


''В предметной области "Интеграл" параметры доменной области, связанные с источником, не задаются.''
'''Примечания'''

Текущая версия на 18:37, 4 июня 2019

Запрос на создание нового объекта модели. Задано три класса объектов:

  1. Полигональный элемент геометрической модели.
  2. Источник поля.
  3. Секущая плоскость вывода результатов моделирования.

Входные параметры запроса[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 Беззнаковый целочисленный идентификатор класса создаваемого объекта.
Символическое имя Значение Описание
ObjectPoly 0 Идентификатор полигонального объекта.
ObjectSource 1 Идентификатор источника.
ObjectPlain 2 Идентификатор плоскости вывода результатов.


Для полигонального объекта
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 Последовательно заданные координаты точки.
...

Выходные параметры запроса[5]

В случае успешного вызова функции ControlSystemEntryPoint ответом является имя созданного элемента модели model_name на сервере.

Другие запросы


Символическое имя Целочисленное значение Действие
CreateModelId 0 создание новой модели
CreateObjectId 1 создание нового элемента модели
UploadModelId 2 загрузка модели со стороны пользователя.
StartSimulationId 3 запуск физического моделирования в предметной области
GetProcessStatusId 4 получение сведений о состоянии процесса моделирования
GetSimulationResultsId 5 получение результатов моделирования
StopSimulationId 6 досрочная остановка процесса моделирования (не реализовано)
CloseSimulationId 7 закрытие моделирования и освобождение соответствующих ресурсов на сервере; если запущен процесс моделирования, то его остановка.

Примечания

  1. ↑ Содержимое буфера pPackedInputParams при вызове функции ControlSystemEntryPoint.
  2. ↑ 2,0 2,1 При создании модели имя объекта не должно задаваться пользователем, т.е. object_name_size должно быть равно 0, а данные поля object_name не должны включаться в параметры запроса на создание объекта.
  3. ↑ Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
    Для предметной области "Архитектурная акустика".
    • Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
    • Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
    • Для плоскости вывода результатов параметры предметной области не задаются.
    Для предметной области "Интеграл".
    • Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
  4. ↑ 4,0 4,1 Запакованные параметры предметной области объектов-элементов модели среды моделируемого физического поля.
    Для предметной области "Архитектурная акустика".
    • Для полигонального объекта общие предметные параметры полигонального объекта не задаются. Вместо этого задаются параметры каждой отдельной поверхности (полигона), составляющей полигональный объект. Данные представлены в описании класса CFace.
    • Для источника поля общие параметры предметной области, связанные с объектом, представлены в описании класса CPrimarySource.
    • Для плоскости вывода результатов параметры предметной области не задаются.
    Для предметной области "Интеграл".
    • Параметры предметной области, связанные с объектом любого класса, а также параметры, связанные с поверхностями полигонального объекта, не задаются.
  5. ↑ Содержимое буфера pPackedOutputParams, возвращаемого управляющей подсистемой.
Источник — http://51.250.0.107/w/index.php?title=CreateObjectId&oldid=7878