peanoScan

Name

peanoScan - scan a band in "peano" order

Syntax

 #include <xite/texture.h>

 int peanoScan( IBAND inband, IBAND outband,
    int blockPow );

Description

This procedure scans an input band according to the Peano curve rules and write the pixel values in horizontal lines in an output band, one dimensional representation of the input band.

If power is set to zero, only the largest possible square block of size some power of two is transformed.

 EX:
   128x128  : The whole band is transformed
   127x1024 : Only the upper, left 64x64 is transformed

If power is set to n, the image is split up in disjunct, square blocks of size (2**n)x(2**n). Each complete block (entirely inside the band) is transformed separately.

 EX blockPow = 3:
   128x128  : | The whole band is transformed in 16x16
              | separate blocks of size 8x8
   127x1024 : | The upper, left field of size 120x1024
              | is transformed in 15x128 separate blocks
              | of size 8x8

Restrictions

Accepts only usigned byte pixels.

Return value

 0 => ok
 1 => Bad input pixel type
 2 => Bad output pixel type
 3 => Bad power argument
 4 => Warning: Output band to small

Reference

 1) Joel Quinqueton and Marc Berthod
    "A Locally Adaptive Peano Scanning Algorithm"
    IEEE Transaction on Pattern Ana. and Machine Inte.
    Vol. PAMI-3, No. 4, July 1981
 2) P. T. Nguyen and J. Quinqueton
    "Space Filling Curves and Texture Analysis"
    IEEE Transaction on Pattern Ana. and Machine Inte.
    Vol. 2, 1982.

Author

Yogesan and Lønnestad, BLAB, ifi, UiO

Id

$Id: peanoScan.c,v 1.23 1996/12/06 19:17:46 svein Exp $