mediaLib Library Functions              mlibMatrixUnitU8(3MLIB)



NAME
     mlibMatrixUnitU8, mlibMatrixUnitU8C, mlibMatrixUnitS8,
     mlibMatrixUnitS8C,                    mlibMatrixUnitS16,
     mlibMatrixUnitS16C,                   mlibMatrixUnitS32,
     mlibMatrixUnitS32C - Unit matrix generation

SYNOPSIS
     cc [ flag... ] file... -lmlib [ library... ]
     #include 

     mlibstatus mlibMatrixUnitU8(mlibu8 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitU8C(mlibu8 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS8(mlibs8 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS8C(mlibs8 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS16(mlibs16 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS16C(mlibs16 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS32(mlibs32 *z, mlibs32 n);


     mlibstatus mlibMatrixUnitS32C(mlibs32 *z, mlibs32 n);


DESCRIPTION
     Each of these functions sets the values for a unit matrix.


     For real data, the following equation is used:

       z[i*n ] j] = 1  if i == j
       z[i*n ] j] = 0  if i != j



     where i = 0, 1, ..., (n - 1); j = 0, 1, ..., (n - 1).


     For complex data, the following equation is used:

       z[2*(i*n ] j)]     = 1  if i == j
       z[2*(i*n ] j)]     = 0  if i != j



SunOS 5.11           Last change: 2 Mar 2007                    1






mediaLib Library Functions              mlibMatrixUnitU8(3MLIB)



       z[2*(i*n ] j) ] 1] = 0



     where i = 0, 1, ..., (n - 1); j = 0, 1, ..., (n - 1).

PARAMETERS
     Each of the functions takes the following arguments:

     z    Pointer to the destination matrix.


     n    Number of rows and columns in the matrix.


RETURN VALUES
     Each of the functions returns  MLIBSUCES  if  successful.
     Otherwise it returns MLIBFAILURE.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     attributes(5)



















SunOS 5.11           Last change: 2 Mar 2007                    2