IMAGE (kimage_proc) functions


LIBRARY ROUTINE

litexture - texture feature extraction using LAW metrics

LIBRARY CALL

int litexture(
        kobject in_obj,
        int L5L5,
        int L5E5,
        int L5S5,
        int L5W5,
        int L5R5,
        int E5L5,
        int E5E5,
        int E5S5,
        int E5W5,
        int E5R5,
        int S5L5,
        int S5E5,
        int S5S5,
        int S5W5,
        int S5R5,
        int W5L5,
        int W5E5,
        int W5S5,
        int W5W5,
        int W5R5,
        int R5L5,
        int R5E5,
        int R5S5,
        int R5W5,
        int R5R5,
        kobject out_obj)

INPUT

none

OUTPUT

none

RETURN VALUE

TRUE (1) on success, FALSE (0) on failure

DESCRIPTION

lktexture will extract texture features from an image by convolving the original image with a spatial filter. The spatial filters are comprised of 5 x 5 kernals derived from center-weighted vectors defined by the LAWS texture measure.

The five center-weighted vectors are:

L5 = [ 1 4 6 4 1] E5 = [-1 -2 0 2 1] S5 = [-1 0 2 0 -1] W5 = [-1 2 0 -2 1] R5 = [ 1 -4 6 -4 1]

Each 5 x 5 kernal is derived from multiplying a particular combination of two of the above vectors. This results in 25 possible 5 x 5 kernals.

If the input object elements dimension is greater than 1 then the results obtained by applying all texture kernels to the first band are stored by planes in the output object, followed by the results obtained by applying all texture kernels to the second band, etc.

lklinearop() is called to convolve the input image with the selected kernels. The result are stored as a WxH planes along the E direction in the output object.

The output object will always set up with a color space model of KNONE, with KCOLOR_HAS_ALPHA set to FALSE.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

lktexture will operate on input objects of any data storage type.

The output object will be of type KLONG, KDOUBLE, or KDCOMPLEX, determined by the data type of the input object. If the input object is of data type KBYTE, KUBYTE, KSHORT, or KUSHORT, then it is converted up to an KLONG image. If the input is of type KFLOAT or KDOUBLE, then the result will be KDOUBLE. Any complex input type is converted to type KDCOMPLEX.

MODIFICATION

none

FILES

$IMAGE/objects/library/kimage_proc/src/litexture.c

SEE ALSO

kimage_proc(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.