ISourceObject::GetVector: различия между версиями
Перейти к навигации
Перейти к поиску
(Новая страница: «{{NavBar|{{Системная иерархия:ISourceObject}} \ GetVector}} {{function begin|return_code_t GetVector(size_type iDimension, IPoint** ppVector) co…») |
(Исправление для нулевого кода return_code_t и включение PLATFORM_NATIVE_CALLING_CONVENTION в интерфейсы.) |
||
| Строка 1: | Строка 1: | ||
{{NavBar|{{Системная иерархия:ISourceObject}} \ GetVector}} | {{NavBar|{{Системная иерархия:ISourceObject}} \ GetVector}} | ||
{{function begin|return_code_t GetVector(size_type iDimension, IPoint** ppVector) const noexcept;|{{ISourceObject::GetVector brief}}}} | {{function begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetVector(size_type iDimension, IPoint** ppVector) const noexcept;|{{ISourceObject::GetVector brief}}}} | ||
{{function_paramlist begin}} | {{function_paramlist begin}} | ||
{{function_paramlist add|iDimension|Индекс измерения. Индекс первого измерения - 0.}} | {{function_paramlist add|iDimension|Индекс измерения. Индекс первого измерения - 0.}} | ||
Текущая версия на 00:51, 18 декабря 2017
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetVector(size_type iDimension, IPoint** ppVector) const noexcept;
Возвращает направление источника в выбранном измерении.
- Параметры
iDimension Индекс измерения. Индекс первого измерения - 0. [out] ppVector Указатель, принимающий адрес векторного выражения направления в заданном измерении. Вектор выражается реализацией геометрической точки с интерфейсом IPoint. По завершении использования возвращенная реализация должна закрываться своим методом Release. Гарантируется ненулевое значение возвращенного вектора для любого значения параметра iDimension. - Возвращаемое значение:
- 32-битовый целый код ошибки, который в случае успешного выполнения неотрицателен. Направление источника задается матрицей направлений при создании источника в модели. Ранг этой матрицы при создании источника должен быть не меньше количества строк матрицы минус один. Направлению источника в измерении iDimension соответствует столбец этой матрицы с номером iDimension. Если значение параметра iDimension при вызове GetVector больше количества столбцов этой матрицы, матрица достраивается рекурсивно для каждого из измерений, больших ранга матрицы, следующим образом. Если в результате добавления нового столбца матрицы последняя перестает быть квадратной, к матрице предварительно добавляется строка с нулевыми элементами. Далее к матрице добавляется столбец, каждый элемент которого равен модулю своего минора.