Компонент предназначен для выделения подматрицы из уже существующей матрицы, называемой родительской (Parent).

Компонент с интерфейсом ImaSubmatrix имеет также интерфейс ImaMatrix для доступа к созданой подматрице. При использовании этого интерфейса для чтения или записи данных происходит преобразование индекса ячейки, заданное с помощью фукнций интерфейса ImaSubmatrix, и затем выполняется запись или считывание в/из родительской матрицы по преобразованному индексу.

Преобразование индекса

Преобразование проводится отдельно для каждой размерности в индексе элемента подматрицы. Каждой размерности подматрицы сопоставлена размерность родительской матрицы, в которую она отображается. Далее каждой размерности может быть сопоставлена таблица преобразования: i-й элемент в ней есть номер элемента родительской матрицы, которому соответствует i-й элемент данной размерности подматрицы. Например, если размерность 0 подматрицы отображается в размерность 1 родительской матрицы и таблица преобразования - (3,2,0,5,...), то индексам (0,*,*) и (3,*,*) подматрицы соответствует индексы (*,3,*) и (*,5,*) соответственно.

Некоторые размерности родительской матрицы могут не быть сопоставлены ни одной размерности подматрицы. Такие размерности называются фиксированными и координата по этой размерности задается заранее.

Пример. Пусть родительская матрица имеет размеры 8х9х10 и в подматрице задано преобразование индекса: Тогда подматрица будет иметь размер 4х8 и между ее элементами и элементами родительской матрицы будут следующие соответствия: и так далее.

HRESULT SetParent([in] ImaMatrix* par)
Функция позволет установить родительскую матрицу для подматрицы. При вызове также сбрасывается преобразование индекса.

Параметры:

par указатель на родительскую матрицу

Возвращаемое значение:

MA_NOERROR всегда

HRESULT GetParent([out,retval] ImaMatrix** par)
Функция позволет прочитать указатель на родительскую матрицу.

Параметры:

par указатель на возвращаемую родительскую матрицу

Возвращаемое значение:

MA_NOERROR при отсутствии ошибок
MA_ERR_BAD_PARAM если par==NULL

HRESULT ClearStructure()
Сбрасывает преобразование индекса так, что преобразование индекса не производится.

Возвращаемое значение:

MA_NOERROR всегда

HRESULT VerifyStructure()
Функция проверяет правильность задания преобразования: каждой незафиксированной размерности родительской матрицы должна соответствовать размерность в подматрице.

Возвращаемое значение:

MA_NOERROR при отсутствии ошибок
MA_ERR_VERIFY при несформированном преобразовании

HRESULT SetDim([in] int parentDim,[in] int dim,[in] int size,[in] int* index)
Функция устанавливает соответствие между размерностью parentDim родительской матрицы и размерностью dim подматрицы.

Если size=0, то таблица преобразования и аргумент index не используется.

Если size≠0 и index=0, то таблица преобразования берется из ранее заданного соответствия с тем же parentDim и длина этой таблицы (и размер подматрицы по размерности dim) устанавливается равным size.

Если size≠0 и index≠0, то таблица преобразования задается параметром index и длина этой таблицы (и размер подматрицы по размерности dim) устанавливается равным size. При этом таблица преобразования не копируется и все изменения массива index будут влиять на преобразование индексов.

Параметры:

parentDim размерность родительской матрицы, которой будет соответствовать размерность dim в подматрице
dim изменяемая размерность в подматрице
size длина таблицы преобразования или 0, если таблица не используется
index не используется, если size==0; таблица преобразования или NULL, если size≠0

Возвращаемое значение:

MA_NOERROR при отсутствии ошибок
MA_ERR_BAD_PARAM если parentDim или dim больше размерности соответственно родительской и данной матрицы
MA_ERR_NOTFOUND если size≠0, index=0 и таблица преобразования для размерности dim не была задана ранее

HRESULT FixDim([in] int parentDim,[in] int index)
Функция фиксирует размерность parentDim родительской матрицы и делает ее равной index.

Параметры:

parentDim фиксируемая размерность родительской матрицы
index фиксируемая координата по размерности parentDim родительской матрицы

Возвращаемое значение:

MA_NOERROR при отсутствии ошибок
MA_ERR_BAD_PARAM если parentDim больше, чем размерность родительской матрицы

Замечание:


HRESULT SetIdentityDim([in] int dim)
Функция увеличивает размерность подматрицы, добавляя размерность длины 1.

Параметры:

dim номер добавляемой размерности. При добавлении существующие размерности dim, dim+1,dim+2... "сдвигаются" на одну, сохраняя соответствия с размерностями родительской матрицы

Возвращаемое значение:

MA_NOERROR всегда