Project Name: boundary.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 eight pixels surrounding a given pixel make up that pixel's boundary. This boundary
function returns the non-zero "gray value" with its co-ordinates, within a given image.
A gray value is a color value where all three color components are equal to one other.
In this application, the image background is assumed to be zeros.  The X and Y co-ordinates
are packed such that the higher half contains the X co-ordinate, and lower half contains
the Y co-ordinate.  The XY co-ordinate array is of type ‘integer’, and the output array
is of type ‘unsigned char’.

Prototype:
    void _boundary(unsigned char* in, int row,int col,int *XY, unsigned char * out);


Arguments:
     in   -  Address of Input image
     row  -  Number of rows in the image
     col   -  Number of columns in image
     xy   -  Array in which to store the XY co-ordinates
     out   -  Address Output image

For this function to work, the input array must not be stored in the same memory bank
with the buffer which stores the XY coordinate values.

Registers used: R0-R3, I1, L1, P0-P2, LC0, LC1.



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

1) Load project "boundary.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:

    "./boundary.ldf" - linker description file
    "./boundary.dpj" - project file
    "../../../../BFinUtils/ADSP-BF533/SDK-cycle_count.asm" -  source file
    "../../src/boundary.asm" -  source file
    "../../src/t_boundary.c" -  source file
    "../../include/boundary.h" -  include file
    "../../../../Include/SDK-cycle_count.h" -  include file