panel/panel.c

   1 /****************************************************************************
   2  * Copyright 2020 Thomas E. Dickey                                          *
   3  * Copyright 1998-2010,2012 Free Software Foundation, Inc.                  *
   4  *                                                                          *
   5  * Permission is hereby granted, free of charge, to any person obtaining a  *
   6  * copy of this software and associated documentation files (the            *
   7  * "Software"), to deal in the Software without restriction, including      *
   8  * without limitation the rights to use, copy, modify, merge, publish,      *
   9  * distribute, distribute with modifications, sublicense, and/or sell       *
  10  * copies of the Software, and to permit persons to whom the Software is    *
  11  * furnished to do so, subject to the following conditions:                 *
  12  *                                                                          *
  13  * The above copyright notice and this permission notice shall be included  *
  14  * in all copies or substantial portions of the Software.                   *
  15  *                                                                          *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
  18  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.   *
  19  * IN NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,   *
  20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
  21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
  22  * THE USE OR OTHER DEALINGS IN THE SOFTWARE.                               *
  23  *                                                                          *
  24  * Except as contained in this notice, the name(s) of the above copyright   *
  25  * holders shall not be used in advertising or otherwise to promote the     *
  26  * sale, use or other dealings in this Software without prior written       *
  27  * authorization.                                                           *
  28  ****************************************************************************/
  29
  30 /****************************************************************************
  31  *  Author: Zeyd M. Ben-Halim <zmbenhal@netcom.com> 1995                    *
  32  *     and: Eric S. Raymond <esr@snark.thyrsus.com>                         *
  33  *     and: Juergen Pfeifer                         1996-1999,2008          *
  34  *     and: Thomas E. Dickey                                                *
  35  ****************************************************************************/
  36
  37 /* panel.c -- implementation of panels library, some core routines */
  38 #include "panel.priv.h"
  39
  40 MODULE_ID("$Id: panel.c,v 1.27 2020/02/02 23:34:34 tom Exp $")
  41
  42 /*+-------------------------------------------------------------------------
  43         _nc_retrace_panel (pan)
  44 --------------------------------------------------------------------------*/
  45 #ifdef TRACE
  46 NCURSES_EXPORT(PANEL *)
  47 _nc_retrace_panel(PANEL * pan)
  48 {
  49   T((T_RETURN("%p"), (void *)pan));
  50   return pan;
  51 }
  52 #endif
  53
  54 /*+-------------------------------------------------------------------------
  55         _nc_my_visbuf(ptr)
  56 --------------------------------------------------------------------------*/
  57 #ifdef TRACE
  58 #ifndef TRACE_TXT
  59 NCURSES_EXPORT(const char *)
  60 _nc_my_visbuf(const void *ptr)
  61 {
  62   char temp[32];
  63
  64   if (ptr != 0)
  65     _nc_SPRINTF(temp, _nc_SLIMIT(sizeof(temp)) "ptr:%p", ptr);
  66   else
  67     _nc_STRCPY(temp, "<null>", sizeof(temp));
  68   return _nc_visbuf(temp);
  69 }
  70 #endif
  71 #endif
  72
  73 /*+-------------------------------------------------------------------------
  74         dPanel(text,pan)
  75 --------------------------------------------------------------------------*/
  76 #ifdef TRACE
  77 NCURSES_EXPORT(void)
  78 _nc_dPanel(const char *text, const PANEL * pan)
  79 {
  80   _tracef("%s id=%s b=%s a=%s y=%d x=%d",
  81           text, USER_PTR(pan->user),
  82           (pan->below) ? USER_PTR(pan->below->user) : "--",
  83           (pan->above) ? USER_PTR(pan->above->user) : "--",
  84           PSTARTY(pan), PSTARTX(pan));
  85 }
  86 #endif
  87
  88 /*+-------------------------------------------------------------------------
  89         dStack(fmt,num,pan)
  90 --------------------------------------------------------------------------*/
  91 #ifdef TRACE
  92 NCURSES_EXPORT(void)
  93 _nc_dStack(const char *fmt, int num, const PANEL * pan)
  94 {
  95   char s80[80];
  96
  97   GetPanelHook(pan);
  98
  99   _nc_SPRINTF(s80, _nc_SLIMIT(sizeof(s80)) fmt, num, pan);
 100   _tracef("%s b=%s t=%s", s80,
 101           (_nc_bottom_panel) ? USER_PTR(_nc_bottom_panel->user) : "--",
 102           (_nc_top_panel) ? USER_PTR(_nc_top_panel->user) : "--");
 103   if (pan)
 104     _tracef("pan id=%s", USER_PTR(pan->user));
 105   pan = _nc_bottom_panel;
 106   while (pan)
 107     {
 108       dPanel("stk", pan);
 109       pan = pan->above;
 110     }
 111 }
 112 #endif
 113
 114 /*+-------------------------------------------------------------------------
 115         Wnoutrefresh(pan) - debugging hook for wnoutrefresh
 116 --------------------------------------------------------------------------*/
 117 #ifdef TRACE
 118 NCURSES_EXPORT(void)
 119 _nc_Wnoutrefresh(const PANEL * pan)
 120 {
 121   dPanel("wnoutrefresh", pan);
 122   wnoutrefresh(pan->win);
 123 }
 124 #endif
 125
 126 /*+-------------------------------------------------------------------------
 127         Touchpan(pan)
 128 --------------------------------------------------------------------------*/
 129 #ifdef TRACE
 130 NCURSES_EXPORT(void)
 131 _nc_Touchpan(const PANEL * pan)
 132 {
 133   dPanel("Touchpan", pan);
 134   touchwin(pan->win);
 135 }
 136 #endif
 137
 138 /*+-------------------------------------------------------------------------
 139         Touchline(pan,start,count)
 140 --------------------------------------------------------------------------*/
 141 #ifdef TRACE
 142 NCURSES_EXPORT(void)
 143 _nc_Touchline(const PANEL * pan, int start, int count)
 144 {
 145   char s80[80];
 146
 147   _nc_SPRINTF(s80, _nc_SLIMIT(sizeof(s80)) "Touchline s=%d c=%d", start, count);
 148   dPanel(s80, pan);
 149   touchline(pan->win, start, count);
 150 }
 151 #endif
 152
 153 #ifndef TRACE
 154 #  ifndef __GNUC__
 155      /* Some C compilers need something defined in a source file */
 156 extern void _nc_dummy_panel(void);
 157 void
 158 _nc_dummy_panel(void)
 159 {
 160 }
 161 #  endif
 162 #endif