IGeometryModel::Marshal - История изменений

Андрей Чусов: Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.

2017-12-17T14:49:16Z

Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.

← Предыдущая		Версия 00:49, 18 декабря 2017
Строка 1:		Строка 1:
	{{NavBar\|{{Системная иерархия:IGeometryModel}} \ Marshal}}		{{NavBar\|{{Системная иерархия:IGeometryModel}} \ Marshal}}
	{{function begin\|return_code_t Marshal(const char* pDomainName, size_type cchDomainName, std::uint32_t nFormat, IOutputStream* pOs) const noexcept;\|{{IGeometryModel::Marshal brief}}}}		{{function begin\|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION Marshal(const char* pDomainName, size_type cchDomainName, std::uint32_t nFormat, IOutputStream* pOs) const noexcept;\|{{IGeometryModel::Marshal brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pDomainName\|[[Имя подсистемы предметной области]], для которой осуществляется маршаллинг. UTF-8 строка размером <tt>cchDomainName</tt> байт.\|paramdir=[in]}}		{{function_paramlist add\|pDomainName\|[[Имя подсистемы предметной области]], для которой осуществляется маршаллинг. UTF-8 строка размером <tt>cchDomainName</tt> байт.\|paramdir=[in]}}

Андрей Чусов в 06:32, 12 августа 2017

2017-08-12T06:32:39Z

← Предыдущая		Версия 16:32, 12 августа 2017
Строка 1:		Строка 1:
	{{NavBar\|{{Системная иерархия:IGeometryModel}} \ Marshal}}		{{NavBar\|{{Системная иерархия:IGeometryModel}} \ Marshal}}
	{{function begin\|return_code_t ~~PLATFORM_NATIVE_CALLING_CONVENTION~~ Marshal(const char* pDomainName, size_type cchDomainName, std::uint32_t nFormat, IOutputStream* pOs) const noexcept;\|{{IGeometryModel::Marshal brief}}}}		{{function begin\|return_code_t Marshal(const char* pDomainName, size_type cchDomainName, std::uint32_t nFormat, IOutputStream* pOs) const noexcept;\|{{IGeometryModel::Marshal brief}}}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pDomainName\|[[Имя подсистемы предметной области]], для которой осуществляется маршаллинг. UTF-8 строка размером <tt>cchDomainName</tt> байт.\|paramdir=[in]}}		{{function_paramlist add\|pDomainName\|[[Имя подсистемы предметной области]], для которой осуществляется маршаллинг. UTF-8 строка размером <tt>cchDomainName</tt> байт.\|paramdir=[in]}}

Андрей Чусов в 05:28, 12 августа 2017

2017-08-12T05:28:33Z

@@ Строка 1: / Строка 1: @@
 {{NavBar|{{Системная иерархия:IGeometryModel}} \ Marshal}}
-{{function begin|package<default_package_allocator, IGeometryModel> Marshal() const;
+{{function begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION Marshal(const char* pDomainName, size_type cchDomainName, std::uint32_t nFormat, IOutputStream* pOs) const noexcept;|{{IGeometryModel::Marshal brief}}}}
 {{function_paramlist begin}}
-{{function_paramlist add|pBuffer|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IGeometryModel::MarshalSize]]. Функция заполняет буфер запакованной геометрической моделью.|paramdir=[in]}}
+{{function_paramlist add|pDomainName|[[Имя подсистемы предметной области]], для которой осуществляется маршаллинг. UTF-8 строка размером <tt>cchDomainName</tt> байт.|paramdir=[in]}}
-{{function_paramlist add|cbBuffer|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
+{{function_paramlist add|cchDomainName|Размер имени в байтах.}}
 {{function_paramlist end}}
-{{function return_value|
+{{function return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.}}
 {{function_sa begin}}
-{{function_sa add|[[package_reference]]}}
+{{function_sa add|[[IGeometryModel]]|{{IGeometryModel brief}}}}
-{{function_sa add|[[package]]}}
+{{function_sa add|[[LoadGeometryModelForDomain]]|{{LoadGeometryModelForDomain brief}}}}
 {{function_sa end}}
 {{function end}}

Андрей Чусов в 10:12, 11 июня 2016

2016-06-11T10:12:44Z

← Предыдущая		Версия 20:12, 11 июня 2016
Строка 6:		Строка 6:
	}}		}}
	{{function_paramlist begin}}		{{function_paramlist begin}}
	{{function_paramlist add\|pBuffer\|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[~~IGeometryModel_MarshalSize\|~~IGeometryModel::MarshalSize]]. Функция заполняет буфер запакованной геометрической моделью.\|paramdir=[in]}}		{{function_paramlist add\|pBuffer\|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IGeometryModel::MarshalSize]]. Функция заполняет буфер запакованной геометрической моделью.\|paramdir=[in]}}
	{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}		{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
	{{function_paramlist end}}		{{function_paramlist end}}
Строка 14:		Строка 14:
	\|Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.		\|Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.

	Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[~~IGeometryModel_MarshalSize\|~~IGeometryModel::MarshalSize]].		Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[IGeometryModel::MarshalSize]].

	Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять геометрическую модель напрямую, без вызова методов.		Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять геометрическую модель напрямую, без вызова методов.

Андрей Чусов: Андрей Чусов переименовал страницу IGeometryModel Marshal в IGeometryModel::Marshal без оставления перенаправления

2016-01-09T18:44:16Z

Андрей Чусов переименовал страницу IGeometryModel Marshal в IGeometryModel::Marshal без оставления перенаправления

← Предыдущая

Версия 04:44, 10 января 2016

Андрей Чусов в 18:43, 9 января 2016

2016-01-09T18:43:40Z

← Предыдущая		Версия 04:43, 10 января 2016
Строка 1:		Строка 1:
	{{NavBar\|{{IGeometryModel ~~hierarchy~~}} \ Marshal}}		{{NavBar\|{{Системная иерархия:IGeometryModel}} \ Marshal}}
	{{function begin\|package<default_package_allocator, IGeometryModel> Marshal() const;		{{function begin\|package<default_package_allocator, IGeometryModel> Marshal() const;
	package_reference<IGeometryModel> Marshal(void* pBuffer, size_type cbBuffer) const;\|{{~~IGeometryModel_Marshal_brief~~}}		package_reference<IGeometryModel> Marshal(void* pBuffer, size_type cbBuffer) const;\|{{IGeometryModel::Marshal brief}}
	# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].		# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].
	# Записывает запакованные данные в предоставленный извне буфер.		# Записывает запакованные данные в предоставленный извне буфер.

Андрей Чусов в 16:56, 3 января 2016

2016-01-03T16:56:46Z

← Предыдущая		Версия 02:56, 4 января 2016
Строка 9:		Строка 9:
	{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}		{{function_paramlist add\|cbBuffer\|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
	{{function_paramlist end}}		{{function_paramlist end}}
	{{function return_value		{{function return_value\|
	Объект, управляющий запакованным пакетом данных. Первая перегрузка, в отличие от второй, возвращает объект, также управляющий буфером, хранящим запакованные данные, и автоматически освобождает память при деструкции возвращенного объекта. Вторая перегрузка управляет только данными, но ответственность за освобождения памяти буфера ложится на вызывающего.}}		Объект, управляющий запакованным пакетом данных. Первая перегрузка, в отличие от второй, возвращает объект, также управляющий буфером, хранящим запакованные данные, и автоматически освобождает память при деструкции возвращенного объекта. Вторая перегрузка управляет только данными, но ответственность за освобождения памяти буфера ложится на вызывающего.}}
	{{function details		{{function details

Андрей Чусов в 16:19, 3 января 2016

2016-01-03T16:19:09Z

← Предыдущая		Версия 02:19, 4 января 2016
Строка 10:		Строка 10:
	{{function_paramlist end}}		{{function_paramlist end}}
	{{function return_value		{{function return_value
	~~\|Указатель~~ на реализацию интерфейса [[IPolyCollection]] коллекции полигональных элементов геометрической модели среды моделируемого поля.}}		Объект, управляющий запакованным пакетом данных. Первая перегрузка, в отличие от второй, возвращает объект, также управляющий буфером, хранящим запакованные данные, и автоматически освобождает память при деструкции возвращенного объекта. Вторая перегрузка управляет только данными, но ответственность за освобождения памяти буфера ложится на вызывающего.}}
	{{function details		{{function details
	\|Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.		\|Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.

Андрей Чусов: Новая страница: «{{NavBar|{{IGeometryModel hierarchy}} \ Marshal}} {{function begin|package Marshal() const; package_reference
2016-01-02T15:36:51Z

Новая страница: «{{NavBar|{{IGeometryModel hierarchy}} \ Marshal}} {{function begin|package<default_package_allocator, IGeometryModel> Marshal() const; package_reference<IGeometry…»

Новая страница
{{NavBar|{{IGeometryModel hierarchy}} \ Marshal}}
{{function begin|package<default_package_allocator, IGeometryModel> Marshal() const;
package_reference<IGeometryModel> Marshal(void* pBuffer, size_type cbBuffer) const;|{{IGeometryModel_Marshal_brief}}
# Выделяет память под хранение запакованных данных, которые управляются запаковщиком [[package]].
# Записывает запакованные данные в предоставленный извне буфер.
}}
{{function_paramlist begin}}
{{function_paramlist add|pBuffer|Указатель на буфер памяти, байтовым размером, как минимум, равным значению, возвращаемому методом [[IGeometryModel_MarshalSize|IGeometryModel::MarshalSize]]. Функция заполняет буфер запакованной геометрической моделью.|paramdir=[in]}}
{{function_paramlist add|cbBuffer|Байтовый размер предоставленного для второй перегрузки буфера данных.}}
{{function_paramlist end}}
{{function return_value
|Указатель на реализацию интерфейса [[IPolyCollection]] коллекции полигональных элементов геометрической модели среды моделируемого поля.}}
{{function details
|Перегрузка 1 за раз создает смарт объект C++ (см. [[package]]), который управляет как запаковкой, так и выделенной им же памятью. Перегрузка 2 позволяет использовать уже существующую память, которая заполняется запакованной геометрической моделью среды моделируемого поля. В обоих случаях полученный пакет данных полностью описывает геометрическую модель и может быть передан удаленным узлам.

Вторая перегрузка предполагает, что размер предоставленного буфера задан в байтах параметром <tt>cbBuffer</tt>. Этот размер должен быть не меньше значения, возвращаемого методом [[IGeometryModel_MarshalSize|IGeometryModel::MarshalSize]].

Методы фактически делегируют вызов запаковщику [[package]], на вход которого можно предоставлять геометрическую модель напрямую, без вызова методов.
<syntaxhighlight lang=cpp>
using namespace CAMaaS;

const IGeometryModel& geom = get(); //какой-то метод возвращающий read-only ссылку на модель

auto pckg = package<std::allocator, IGeometryModel> (geom); //аналогично вызову geom.Marshal();

auto buffer_size = package_reference<IGeometryModel>::calculate_size(geom); //аналогично geom.MarshalSize();
auto buffer = new std::uint8_t [buffer_size];
auto pckg_ref = package_reference<IGeometryModel> (buffer, buffer_size, geom); //аналогично вызову geom.Marshal(buffer, buffer_size);
</syntaxhighlight>
}}
{{function_exceptionlist begin}}
{{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_out_of_memory_exception.html Chusov::Exceptions::OutOfMemoryException]|Исключение, которое может быть сгенерировано перегрузкой 1 в случае нехватки памяти.}}
{{function_exceptionlist add|[http://www.chusov.org/doxygen/struct_chusov_1_1_exceptions_1_1_insufficient_buffer_exception.html Chusov::Exceptions::InsufficientBufferException]|Исключение, которое может быть сгенерировано перегрузкой 2 в случае, если предоставлен слишком малый буфер <tt>pBuffer</tt>.}}
{{function_exceptionlist end}}
{{function_sa begin}}
{{function_sa add|[[package_reference]]}}
{{function_sa add|[[package]]}}
{{function_sa add|[[make_package]]|Функция, позволяющая создание запакованных объектов на основе их типов, полученных дедукцией и с использованием стандартного менеджера памяти [http://en.cppreference.com/w/cpp/memory/allocator std::allocator].}}
{{function_sa end}}
{{function end}}