Project Name: close.dpj

Project Type:
    ADSP-BF533 [X]
    ADSP-BF537 [ ]
    ADSP-BF561 [ ]

Hardware Used:
    ADSP-BF533 EZ-Kit
    VisualDSP++ Emulator

System Services Components Used:
    None

OVERVIEW
========
The close function performs the close operation on an input binary image.  This is done
by calling the dilation function, followed by the erosion function.  The results of the
on the stack, and used as input to the erosion function.  The structured elements are
stored as shown below.

                        | h00  h01  h02 |
                        | h10  h11  h12 |
                        | h20  h21  h22 |

For this function to work properly, the number of columns in the input image must be
an even number, aligned to a word or half word boundary.  The input image must not be
stored in the same memory bank with the structured elements.  The same structured
elements will be used for both the dilation function, and the erosion function.

Prototype:
    void _close (unsigned char* in, int row, int col, short * SE,  unsigned char *out );

Arguments:
     in   -  Pointer to the input image.
     row  -  Number of rows in input image.
     col  -  Number of columns in input image.
     SE   -  Pointer to 3x3 structured element.
     out  -  Pointer to the output buffer.

Registers used: R0-R7, P0-P5.




RUNNING THE APPLICATION (on the ADSP-BF533 EZ-KIT Lite)
===========================================================

1) Load Project "close.dpj".

2) Select "Project->Rebuild Project"

3) Select "Debug->Run".

4) Observe output on VisualDSP++ console window.


Files in This Application
==========================

This application consists of the following files:

    "./close.ldf" - linker description file
    "./close.dpj" - project file
    "../../src/t_close.c" - source file
    "../../src/close.asm" - source file
    "../../src/dilation.asm" - source file
    "../../src/erosion.asm" -  source file
    "../../../../BFinUtils/ADSP-BF533/SDK-cycle_count.asm" - source file
    "../../include/close.h" -  include file
    "../../../../Include/SDK-cycle_count.h" - include file