GLOBAL_FUN.h

//global functions(their prototypes):
#pragma once

#if  _do_debug
    extern LONG req_stack_space;
#endif

DOUBLE  my_factorial(USHORT n);
VOID    limited_degrees(SHORT  & ang);
VOID    limited_degrees(DOUBLE  & ang);

#ifdef   _mac_gui_app //''''''''''''''''''''''''''''''''''''''''''''\\.


#define ReleaseResource_(handle)                                            \
        do {                                                                \
            if(handle != nil){                                              \
                ::ReleaseResource(handle);                                  \
                handle = nil;                                               \
            }                                                               \
        } while (false)                 
#define DisposeHandle_(handle)                                              \
        do {                                                                \
            if(handle != nil){                                              \
                ::DisposeHandle(handle);                                    \
                handle = nil;                                               \
            }                                                               \
        } while (false)                 

    SInt16      nearest_int16(DOUBLE x);
    VOID        toggle(BOOLEAN  & x);
    VOID        draw_cell_frame(const Rect  &  rect);
//  VOID        my_set_cursor(SHORT id);
    VOID        trunc_pstr_so_it_fits(Str255  pstr, USHORT box_width, USHORT pixs_for_margins);
    BOOLEAN     get_TEXT_scrap(Handle  content_h);
#endif //_mac_gui_app \\............................................//




#ifdef   _mac_gui_app //''''''''''''''''''''''''''''''''''''''''''''\\.

    #if  _do_debug
        #define refresh_req_stack_space_()  if(req_stack_space>::StackSpace()) req_stack_space = ::StackSpace();
    #else
        #define refresh_req_stack_space_()
    #endif
#else
    #define refresh_req_stack_space_()
#endif //_mac_gui_app \\............................................//



//******************************************
inline
VOID  toggle(
BOOLEAN  &  x)      //i-o
{
    x=(!x);
}