Project Name: boundary.dpj
Project Group Name: boundary.dpg

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

Hardware Used:
    ADSP-BF561 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 example, 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-BF561 EZ-KIT Lite)
===========================================================

1) Load project group "boundary.dpg".

2) Select "Project->Rebuild Project"

3) Click OK in the "Load Multiprocessor Confirmation" window to load p0.dxe and p1.dxe.

4) Select "Debug-Multiprocessor Run".

5) Observe output on VisualDSP++ console window.



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

This example consists of the following files:

    "./boundary.ldf" - linker description file
    "./boundary.dpj" - project file
    "./boundary.dpg" - project group file

    "corea/corea.dpj" -  Core A project file

    "../../src/boundary.asm" -  Core A source file
    "../../src/t_boundary.c" -  Core A source file
    "../../../../BFinUtils/ADSP-BF561/SDK-cycle_count.asm" -  Core A source file

    "../../include/boundary.h" -  Core A include file
    "../../../../Include/SDK-cycle_count.h" -  Core A include file

    "coreb/coreb.dpj" -  Core B project file
    "../../../../BFinUtils/ADSP-BF561/SDK-coreb_idle.c - Core B source file

    "sml2/sml2.dpj" -  Shared Memory L2 project file
    "../../../../BFinUtils/ADSP-BF561/SDK-dummy.c - Shared Memory L2 source file

    "sml3/sml3.dpj" -  Shared Memory L3 project file
    "../../../../BFinUtils/ADSP-BF561/SDK-dummy.c    -  Shared Memory L3 source file