components/u8g2/csrc/u8x8_selection_list.c

changeset 0
88d965579617
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/u8g2/csrc/u8x8_selection_list.c	Tue Oct 08 12:00:31 2019 +0200
@@ -0,0 +1,173 @@
+/*
+
+  u8x8_selection_list.c
+  
+  selection list with scroll option
+  
+  Universal 8bit Graphics Library (https://github.com/olikraus/u8g2/)
+
+  Copyright (c) 2016, olikraus@gmail.com
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without modification, 
+  are permitted provided that the following conditions are met:
+
+  * Redistributions of source code must retain the above copyright notice, this list 
+    of conditions and the following disclaimer.
+    
+  * Redistributions in binary form must reproduce the above copyright notice, this 
+    list of conditions and the following disclaimer in the documentation and/or other 
+    materials provided with the distribution.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 
+  CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, 
+  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 
+  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+  DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 
+  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 
+  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
+  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
+  LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+  CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 
+  STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
+  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  
+  
+*/
+
+#include "u8x8.h"
+
+/*
+  increase the cursor position
+*/
+void u8sl_Next(u8sl_t *u8sl)
+{
+  u8sl->current_pos++;
+  if ( u8sl->current_pos >= u8sl->total )
+  {
+    u8sl->current_pos = 0;
+    u8sl->first_pos = 0;
+  }
+  else
+  {
+    if ( u8sl->first_pos + u8sl->visible <= u8sl->current_pos + 1 )
+    {
+      u8sl->first_pos = u8sl->current_pos - u8sl->visible + 1;
+    }
+  }
+}
+
+void u8sl_Prev(u8sl_t *u8sl)
+{
+  if ( u8sl->current_pos == 0 )
+  {
+    u8sl->current_pos = u8sl->total - 1;
+    u8sl->first_pos = 0;
+    if ( u8sl->total > u8sl->visible )
+      u8sl->first_pos = u8sl->total - u8sl->visible;
+  }
+  else
+  {
+    u8sl->current_pos--;
+    if ( u8sl->first_pos > u8sl->current_pos )
+      u8sl->first_pos = u8sl->current_pos;
+  }
+}
+
+void u8x8_DrawSelectionList(u8x8_t *u8x8, u8sl_t *u8sl, u8x8_sl_cb sl_cb, const void *aux)
+{
+  uint8_t i;
+  for( i = 0; i < u8sl->visible; i++ )
+  {
+    sl_cb(u8x8, u8sl, i+u8sl->first_pos, aux);
+  }
+}
+
+/* selection list with string line */
+void u8x8_sl_string_line_cb(u8x8_t *u8x8, u8sl_t *u8sl, uint8_t idx, const void *aux)
+{
+  const char *s;
+  uint8_t row;
+  /* calculate offset from display upper border */
+  row = u8sl->y;
+  
+  /* calculate target pos */
+  row += idx;
+  row -= u8sl->first_pos;
+  
+  /* check whether this is the current cursor line */
+  if ( idx == u8sl->current_pos )
+    u8x8_SetInverseFont(u8x8, 1);
+  else
+    u8x8_SetInverseFont(u8x8, 0);
+  
+  /* get the line from the array */
+  s = u8x8_GetStringLineStart(idx, (const char *)aux);
+  
+  /* draw the line */
+  if ( s == NULL )
+    s = "";
+  u8x8_DrawUTF8Line(u8x8, u8sl->x, row, u8x8_GetCols(u8x8), s);  
+  u8x8_SetInverseFont(u8x8, 0);
+}
+
+/*
+  title: 		NULL for no title, valid str for title line. Can contain mutliple lines, separated by '\n'
+  start_pos: 	default position for the cursor (starts with 1)
+  sl:			string list (list of strings separated by \n)
+  returns 0 if user has pressed the home key
+  returns the selected line+1 if user has pressed the select key (e.g. 1 for the first line)
+*/
+uint8_t u8x8_UserInterfaceSelectionList(u8x8_t *u8x8, const char *title, uint8_t start_pos, const char *sl)
+{
+  u8sl_t u8sl;
+  uint8_t event;
+  uint8_t title_lines;
+  
+  if ( start_pos > 0 )
+    start_pos--;
+  
+  u8sl.visible = u8x8_GetRows(u8x8);
+  u8sl.total = u8x8_GetStringLineCnt(sl);
+  u8sl.first_pos = 0;
+  u8sl.current_pos = start_pos;
+  u8sl.x = 0;
+  u8sl.y = 0;
+  
+
+  //u8x8_ClearDisplay(u8x8);   /* not required because all is 100% filled */
+  u8x8_SetInverseFont(u8x8, 0);
+  
+  if ( title != NULL )
+  {
+    title_lines = u8x8_DrawUTF8Lines(u8x8, u8sl.x, u8sl.y, u8x8_GetCols(u8x8), title);
+    u8sl.y+=title_lines;
+    u8sl.visible-=title_lines;
+  }
+  
+  if ( u8sl.current_pos >= u8sl.total )
+    u8sl.current_pos = u8sl.total-1;
+
+  
+  u8x8_DrawSelectionList(u8x8, &u8sl, u8x8_sl_string_line_cb, sl);
+
+  for(;;)
+  {
+    event = u8x8_GetMenuEvent(u8x8);
+    if ( event == U8X8_MSG_GPIO_MENU_SELECT )
+      return u8sl.current_pos+1;
+    else if ( event == U8X8_MSG_GPIO_MENU_HOME )
+      return 0;
+    else if ( event == U8X8_MSG_GPIO_MENU_NEXT || event == U8X8_MSG_GPIO_MENU_DOWN )
+    {
+      u8sl_Next(&u8sl);
+      u8x8_DrawSelectionList(u8x8, &u8sl, u8x8_sl_string_line_cb, sl);      
+    }
+    else if ( event == U8X8_MSG_GPIO_MENU_PREV || event == U8X8_MSG_GPIO_MENU_UP  )
+    {
+      u8sl_Prev(&u8sl);
+      u8x8_DrawSelectionList(u8x8, &u8sl, u8x8_sl_string_line_cb, sl);      
+    }
+  }
+}
+

mercurial