/*
 BLOCK.DOX

 License CC0 PUBLIC DOMAIN

 To the extent possible under law, Mark J. Olesen has waived all copyright
 and related or neighboring rights to FDOSTUI Library. This work is published
 from: United States.
*/

/*!  \file block.h
\brief read or write a block of screen memory

The block_read and block_write routines are typically used in the library
to save and restore the background of popups.

*/

/*!
\fn void __FAR* block_read(
    struct box const*const              i_box)
\brief read a block of screen memory
\param[in] i_box region of screen to read
\returns 0 failure unable to allocate memory
\returns !0 pointer to memory block
*/

/*!
\fn void block_write(
    void const __FAR*                   i_block,
    struct box const*const              i_box)
\brief write a block of screen memory
\param[in] i_block memory bock to write
\param[in] i_box region to write block
\returns none
*/

/*!
\fn void block_free(
    void __FAR*                         i_block)
\param[in] i_block block to release
\returns none
*/


