KmlMgMatrixSetValues

Set values for a matrix.

The specified matrix value must correspond to the non-zero element structure specified when the matrix handle is created. This interface applies to scenarios where the matrix structure remains unchanged but the value changes. After the values array is updated through this interface, the original values array space can be released.

Interface Definition

C interface:

KmlMgStatus KmlMgMatrixSetValues(KmlMgMatrixH matrix, void* values);

Parameters

Parameter	Type	Description	Input/Output
matrix	KmlMgMatrixH	Matrix handle created by KmlMgMatrixCreate	Input/Output
values	void *	Matrix value array	Input

Return Value

Return Value	Type	Description
KML_MG_OK	int	Normal execution.
KML_MG_ERR_INVALID_PARAM	int	Invalid parameter.
KML_MG_ERR_UNSUPPORTED	int	Unsupported feature.
KML_MG_ERR_NO_MEMORY	int	Memory allocation failed.
KML_MG_ERR_EXCEEDS_LIMIT	int	Value out of the valid range.
KML_MG_ERR_INCOMPATIBLE	int	Incompatible version.
KML_MG_ERR_NO_REQUIRED_FIELD	int	Required field not set.
KML_MG_ERR_UNKNOWN_TYPE	int	Unknown type.
KML_MG_ERR_THIRD_PART	int	Internal third-party call error.
KML_MG_ERR_INCONSISTENT	int	Inconsistent information transferred.
KML_MG_ERR_UNEXPECTED_CALL_ORDER	int	Unexpected call order.
KML_MG_ERR_MATRIX_VALUE_IS_NULL	int	Null matrix value.
KML_MG_ERR_NO_RESOURCE	int	Resources not ready.

Dependencies

#include "mg.h"

For details about the sample code, see Examples.

Parent topic: HMG