forked from len0rd/rockbox
First step of charcell LCD code rework: * Make it fully unicode aware so that adding non-ISO8859-1 scripts becomes possible (limited by the LCD capabilities of course). * Make the API more similar to the bitmap LCD code's API. * Moved hardware dependent parts to target tree. * Simplified code. * Jumpscroll temporarily non-functional.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@12916 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
parent
165f62d0cd
commit
ad4e3d6657
26 changed files with 1652 additions and 1806 deletions
612
firmware/drivers/lcd-charcell.c
Normal file
612
firmware/drivers/lcd-charcell.c
Normal file
|
@ -0,0 +1,612 @@
|
|||
/***************************************************************************
|
||||
* __________ __ ___.
|
||||
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
||||
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
||||
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
||||
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
||||
* \/ \/ \/ \/ \/
|
||||
* $Id$
|
||||
*
|
||||
* Copyright (C) 2007 by Jens Arnold
|
||||
* Based on the work of Alan Korr, Kjell Ericson and others
|
||||
*
|
||||
* All files in this archive are subject to the GNU General Public License.
|
||||
* See the file COPYING in the source tree root for full license agreement.
|
||||
*
|
||||
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||||
* KIND, either express or implied.
|
||||
*
|
||||
****************************************************************************/
|
||||
#include "config.h"
|
||||
#include "hwcompat.h"
|
||||
|
||||
#include "lcd.h"
|
||||
#include "kernel.h"
|
||||
#include "thread.h"
|
||||
#include <string.h>
|
||||
#include <stdlib.h>
|
||||
#include "file.h"
|
||||
#include "debug.h"
|
||||
#include "system.h"
|
||||
#include "lcd-charcell.h"
|
||||
#include "rbunicode.h"
|
||||
|
||||
/** definitions **/
|
||||
|
||||
#define SCROLLABLE_LINES LCD_HEIGHT
|
||||
#define VARIABLE_XCHARS 16 /* number of software user-definable characters */
|
||||
|
||||
#define NO_PATTERN (-1)
|
||||
|
||||
#define SCROLL_MODE_OFF 0
|
||||
#define SCROLL_MODE_RUN 1
|
||||
|
||||
/* track usage of user-definable characters */
|
||||
struct pattern_info {
|
||||
short count;
|
||||
unsigned short xchar;
|
||||
};
|
||||
|
||||
struct cursor_info {
|
||||
unsigned char hw_char;
|
||||
bool enabled;
|
||||
bool visible;
|
||||
int x;
|
||||
int y;
|
||||
int divider;
|
||||
int downcount;
|
||||
};
|
||||
|
||||
static int find_xchar(unsigned long ucs);
|
||||
|
||||
/** globals **/
|
||||
|
||||
/* The "frame"buffer */
|
||||
static unsigned char lcd_buffer[LCD_WIDTH][LCD_HEIGHT];
|
||||
#ifdef SIMULATOR
|
||||
unsigned char hardware_buffer_lcd[LCD_WIDTH][LCD_HEIGHT];
|
||||
#endif
|
||||
|
||||
static int xmargin = 0;
|
||||
static int ymargin = 0;
|
||||
|
||||
static unsigned char xfont_variable[VARIABLE_XCHARS][(HW_PATTERN_SIZE+3)&~3];
|
||||
/* round up pattern size to a multiple of 4 bytes for faster access */
|
||||
static bool xfont_variable_locked[VARIABLE_XCHARS];
|
||||
static struct pattern_info hw_pattern[MAX_HW_PATTERNS];
|
||||
static struct cursor_info cursor;
|
||||
|
||||
/* scrolling */
|
||||
static volatile int scrolling_lines=0; /* Bitpattern of which lines are scrolling */
|
||||
static void scroll_thread(void);
|
||||
static char scroll_stack[DEFAULT_STACK_SIZE];
|
||||
static const char scroll_name[] = "scroll";
|
||||
static int scroll_ticks = 12; /* # of ticks between updates */
|
||||
static int scroll_delay = HZ/2; /* delay before starting scroll */
|
||||
static int bidir_limit = 50; /* percent */
|
||||
static int jump_scroll_delay = HZ/4; /* delay between jump scroll jumps */
|
||||
static int jump_scroll = 0; /* 0=off, 1=once, ..., JUMP_SCROLL_ALWAYS */
|
||||
static struct scrollinfo scroll[SCROLLABLE_LINES];
|
||||
|
||||
static const char scroll_tick_table[16] = {
|
||||
/* Hz values:
|
||||
1, 1.25, 1.55, 2, 2.5, 3.12, 4, 5, 6.25, 8.33, 10, 12.5, 16.7, 20, 25, 33 */
|
||||
100, 80, 64, 50, 40, 32, 25, 20, 16, 12, 10, 8, 6, 5, 4, 3
|
||||
};
|
||||
|
||||
/* LCD init */
|
||||
void lcd_init (void)
|
||||
{
|
||||
lcd_init_device();
|
||||
lcd_charset_init();
|
||||
memset(hw_pattern, 0, sizeof(hw_pattern));
|
||||
memset(lcd_buffer, xchar_info[find_xchar(' ')].hw_char, sizeof(lcd_buffer));
|
||||
|
||||
create_thread(scroll_thread, scroll_stack,
|
||||
sizeof(scroll_stack), scroll_name
|
||||
IF_PRIO(, PRIORITY_USER_INTERFACE)
|
||||
IF_COP(, CPU, false));
|
||||
}
|
||||
|
||||
/** parameter handling **/
|
||||
|
||||
void lcd_setmargins(int x, int y)
|
||||
{
|
||||
xmargin = x;
|
||||
ymargin = y;
|
||||
}
|
||||
|
||||
int lcd_getxmargin(void)
|
||||
{
|
||||
return xmargin;
|
||||
}
|
||||
|
||||
int lcd_getymargin(void)
|
||||
{
|
||||
return ymargin;
|
||||
}
|
||||
|
||||
int lcd_getstringsize(const unsigned char *str, int *w, int *h)
|
||||
{
|
||||
int width = utf8length(str);
|
||||
|
||||
if (w)
|
||||
*w = width;
|
||||
if (h)
|
||||
*h = 1;
|
||||
|
||||
return width;
|
||||
}
|
||||
|
||||
/** low-level functions **/
|
||||
|
||||
static int find_xchar(unsigned long ucs)
|
||||
{
|
||||
int low = 0;
|
||||
int high = xchar_info_size - 1;
|
||||
|
||||
do
|
||||
{
|
||||
int probe = (low + high) >> 1;
|
||||
|
||||
if (xchar_info[probe].ucs < ucs)
|
||||
low = probe + 1;
|
||||
else if (xchar_info[probe].ucs > ucs)
|
||||
high = probe - 1;
|
||||
else
|
||||
return probe;
|
||||
}
|
||||
while (low <= high);
|
||||
|
||||
/* Not found: return index of no-char symbol (last symbol, hardcoded). */
|
||||
return xchar_info_size - 1;
|
||||
}
|
||||
|
||||
static int xchar_to_pat(int xchar)
|
||||
{
|
||||
int i;
|
||||
|
||||
for (i = 0; i < hw_pattern_count; i++)
|
||||
if (hw_pattern[i].xchar == xchar)
|
||||
return i;
|
||||
|
||||
return NO_PATTERN;
|
||||
}
|
||||
|
||||
static const unsigned char *xchar_to_glyph(int xchar)
|
||||
{
|
||||
unsigned index = xchar_info[xchar].glyph;
|
||||
|
||||
if (index & 0x8000)
|
||||
return xfont_variable[index & 0x7fff];
|
||||
else
|
||||
return xfont_fixed[index];
|
||||
}
|
||||
|
||||
static void lcd_free_pat(int xchar)
|
||||
{
|
||||
int x, y;
|
||||
unsigned char substitute;
|
||||
int pat = xchar_to_pat(xchar);
|
||||
|
||||
if (pat != NO_PATTERN)
|
||||
{
|
||||
substitute = xchar_info[xchar].hw_char;
|
||||
|
||||
for (x = 0; x < LCD_WIDTH; x++)
|
||||
{
|
||||
for (y = 0; y < LCD_HEIGHT; y++)
|
||||
{
|
||||
if (pat == lcd_buffer[x][y])
|
||||
{
|
||||
lcd_buffer[x][y] = substitute;
|
||||
#ifdef SIMULATOR
|
||||
hardware_buffer_lcd[x][y] = substitute;
|
||||
#else
|
||||
lcd_put_hw_char(x, y, substitute);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
}
|
||||
if (cursor.enabled && pat == cursor.hw_char)
|
||||
cursor.hw_char = substitute;
|
||||
|
||||
hw_pattern[pat].count = 0;
|
||||
#ifdef SIMULATOR
|
||||
lcd_update();
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
static int lcd_get_free_pat(int xchar)
|
||||
{
|
||||
static int last_used_pat = 0;
|
||||
|
||||
int pat = last_used_pat; /* start from last used pattern */
|
||||
int least_pat = pat; /* pattern with least priority */
|
||||
int least_priority = xchar_info[hw_pattern[pat].xchar].priority;
|
||||
int i;
|
||||
|
||||
for (i = 0; i < hw_pattern_count; i++)
|
||||
{
|
||||
if (++pat >= hw_pattern_count) /* Keep 'pat' within limits */
|
||||
pat = 0;
|
||||
|
||||
if (hw_pattern[pat].count == 0)
|
||||
{
|
||||
hw_pattern[pat].xchar = xchar;
|
||||
last_used_pat = pat;
|
||||
return pat;
|
||||
}
|
||||
if (xchar_info[hw_pattern[pat].xchar].priority < least_priority)
|
||||
{
|
||||
least_priority = xchar_info[hw_pattern[pat].xchar].priority;
|
||||
least_pat = pat;
|
||||
}
|
||||
}
|
||||
if (xchar_info[xchar].priority > least_priority) /* prioritized char */
|
||||
{
|
||||
lcd_free_pat(hw_pattern[least_pat].xchar);
|
||||
hw_pattern[least_pat].xchar = xchar;
|
||||
last_used_pat = least_pat;
|
||||
return least_pat;
|
||||
}
|
||||
return NO_PATTERN;
|
||||
}
|
||||
|
||||
static int map_xchar(int xchar)
|
||||
{
|
||||
int pat;
|
||||
|
||||
if (xchar_info[xchar].priority > 0) /* soft char */
|
||||
{
|
||||
pat = xchar_to_pat(xchar);
|
||||
|
||||
if (pat == NO_PATTERN) /* not yet mapped */
|
||||
{
|
||||
pat = lcd_get_free_pat(xchar); /* try to map */
|
||||
if (pat == NO_PATTERN) /* failed: just use substitute */
|
||||
return xchar_info[xchar].hw_char;
|
||||
else /* define pattern */
|
||||
lcd_define_hw_pattern(pat, xchar_to_glyph(xchar));
|
||||
}
|
||||
hw_pattern[pat].count++; /* increase reference count */
|
||||
return pat;
|
||||
}
|
||||
else /* hardware char */
|
||||
return xchar_info[xchar].hw_char;
|
||||
}
|
||||
|
||||
static void lcd_putxchar(int x, int y, int xchar)
|
||||
{
|
||||
int lcd_char = lcd_buffer[x][y];
|
||||
|
||||
if (lcd_char < hw_pattern_count) /* old char was soft */
|
||||
hw_pattern[lcd_char].count--; /* decrease old reference count */
|
||||
|
||||
lcd_buffer[x][y] = lcd_char = map_xchar(xchar);
|
||||
#ifdef SIMULATOR
|
||||
hardware_buffer_lcd[x][y] = lcd_char;
|
||||
lcd_update();
|
||||
#else
|
||||
lcd_put_hw_char(x, y, lcd_char);
|
||||
#endif
|
||||
}
|
||||
|
||||
/** user-definable pattern handling **/
|
||||
|
||||
unsigned long lcd_get_locked_pattern(void)
|
||||
{
|
||||
int i = 0;
|
||||
|
||||
for (i = 0; i < VARIABLE_XCHARS; i++)
|
||||
{
|
||||
if (!xfont_variable_locked[i])
|
||||
{
|
||||
xfont_variable_locked[i] = true;
|
||||
return 0xe000 + i; /* hard-coded */
|
||||
}
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
void lcd_unlock_pattern(unsigned long ucs)
|
||||
{
|
||||
int xchar = find_xchar(ucs);
|
||||
int index = xchar_info[xchar].glyph;
|
||||
|
||||
if (index & 0x8000) /* variable extended char */
|
||||
{
|
||||
lcd_free_pat(xchar);
|
||||
xfont_variable_locked[index & 0x7fff] = false;
|
||||
}
|
||||
}
|
||||
|
||||
void lcd_define_pattern(unsigned long ucs, const char *pattern)
|
||||
{
|
||||
int xchar = find_xchar(ucs);
|
||||
int index = xchar_info[xchar].glyph;
|
||||
int pat;
|
||||
|
||||
if (index & 0x8000) /* variable extended char */
|
||||
{
|
||||
memcpy(xfont_variable[index & 0x7fff], pattern, HW_PATTERN_SIZE);
|
||||
pat = xchar_to_pat(xchar);
|
||||
if (pat != NO_PATTERN)
|
||||
lcd_define_hw_pattern(pat, pattern);
|
||||
}
|
||||
}
|
||||
|
||||
/** output functions **/
|
||||
|
||||
/* Clear the whole display */
|
||||
void lcd_clear_display(void)
|
||||
{
|
||||
int x, y;
|
||||
int xchar = find_xchar(' ');
|
||||
|
||||
lcd_stop_scroll();
|
||||
lcd_remove_cursor();
|
||||
|
||||
for (x = 0; x < LCD_WIDTH; x++)
|
||||
for (y = 0; y < LCD_HEIGHT; y++)
|
||||
lcd_putxchar(x, y, xchar);
|
||||
}
|
||||
|
||||
/* Put an unicode character at the given position */
|
||||
void lcd_putc(int x, int y, unsigned long ucs)
|
||||
{
|
||||
if ((unsigned)x >= LCD_WIDTH || (unsigned)y >= LCD_HEIGHT)
|
||||
return;
|
||||
|
||||
lcd_putxchar(x, y, find_xchar(ucs));
|
||||
}
|
||||
|
||||
/* Show cursor (alternating with existing character) at the given position */
|
||||
void lcd_put_cursor(int x, int y, unsigned long cursor_ucs)
|
||||
{
|
||||
if ((unsigned)x >= LCD_WIDTH || (unsigned)y >= LCD_HEIGHT
|
||||
|| cursor.enabled)
|
||||
return;
|
||||
|
||||
cursor.enabled = true;
|
||||
cursor.visible = false;
|
||||
cursor.hw_char = map_xchar(find_xchar(cursor_ucs));
|
||||
cursor.x = x;
|
||||
cursor.y = y;
|
||||
cursor.downcount = 0;
|
||||
cursor.divider = 4;
|
||||
}
|
||||
|
||||
/* Remove the cursor */
|
||||
void lcd_remove_cursor(void)
|
||||
{
|
||||
if (cursor.enabled)
|
||||
{
|
||||
if (cursor.hw_char < hw_pattern_count) /* soft char, unmap */
|
||||
hw_pattern[cursor.hw_char].count--;
|
||||
|
||||
cursor.enabled = false;
|
||||
#ifdef SIMULATOR
|
||||
hardware_buffer_lcd[cursor.x][cursor.y] = lcd_buffer[cursor.x][cursor.y];
|
||||
#else
|
||||
lcd_put_hw_char(cursor.x, cursor.y, lcd_buffer[cursor.x][cursor.y]);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
|
||||
/* Put a string at a given position, skipping first ofs chars */
|
||||
static int lcd_putsxyofs(int x, int y, int ofs, const unsigned char *str)
|
||||
{
|
||||
unsigned short ucs;
|
||||
const unsigned char *utf8 = str;
|
||||
|
||||
while (*utf8 && x < LCD_WIDTH)
|
||||
{
|
||||
utf8 = utf8decode(utf8, &ucs);
|
||||
|
||||
if (ofs > 0)
|
||||
{
|
||||
ofs--;
|
||||
continue;
|
||||
}
|
||||
lcd_putc(x++, y, ucs);
|
||||
}
|
||||
return x;
|
||||
}
|
||||
|
||||
/* Put a string at a given position */
|
||||
void lcd_putsxy(int x, int y, const unsigned char *str)
|
||||
{
|
||||
lcd_putsxyofs(x, y, 0, str);
|
||||
}
|
||||
|
||||
/*** Line oriented text output ***/
|
||||
|
||||
/* Put a string at a given char position */
|
||||
void lcd_puts(int x, int y, const unsigned char *str)
|
||||
{
|
||||
lcd_puts_offset(x, y, str, 0);
|
||||
}
|
||||
|
||||
/* Put a string at a given char position, skipping first offset chars */
|
||||
void lcd_puts_offset(int x, int y, const unsigned char *str, int offset)
|
||||
{
|
||||
/* make sure scrolling is turned off on the line we are updating */
|
||||
scrolling_lines &= ~(1 << y);
|
||||
|
||||
x += xmargin;
|
||||
y += ymargin;
|
||||
|
||||
x = lcd_putsxyofs(x, y, offset, str);
|
||||
while (x < LCD_WIDTH)
|
||||
lcd_putc(x++, y, ' ');
|
||||
}
|
||||
|
||||
/** scrolling **/
|
||||
|
||||
void lcd_stop_scroll(void)
|
||||
{
|
||||
scrolling_lines=0;
|
||||
}
|
||||
|
||||
void lcd_scroll_speed(int speed)
|
||||
{
|
||||
scroll_ticks = scroll_tick_table[speed];
|
||||
}
|
||||
|
||||
void lcd_scroll_delay(int ms)
|
||||
{
|
||||
scroll_delay = ms / (HZ / 10);
|
||||
}
|
||||
|
||||
void lcd_bidir_scroll(int percent)
|
||||
{
|
||||
bidir_limit = percent;
|
||||
}
|
||||
|
||||
void lcd_jump_scroll(int mode) /* 0=off, 1=once, ..., JUMP_SCROLL_ALWAYS */
|
||||
{
|
||||
jump_scroll = mode;
|
||||
}
|
||||
|
||||
void lcd_jump_scroll_delay(int ms)
|
||||
{
|
||||
jump_scroll_delay = ms / (HZ / 10);
|
||||
}
|
||||
|
||||
void lcd_puts_scroll(int x, int y, const unsigned char *string)
|
||||
{
|
||||
lcd_puts_scroll_offset(x, y, string, 0);
|
||||
}
|
||||
|
||||
void lcd_puts_scroll_offset(int x, int y, const unsigned char *string,
|
||||
int offset)
|
||||
{
|
||||
struct scrollinfo* s;
|
||||
int len;
|
||||
|
||||
s = &scroll[y];
|
||||
|
||||
s->start_tick = current_tick + scroll_delay;
|
||||
|
||||
lcd_puts_offset(x, y, string, offset);
|
||||
len = utf8length(string);
|
||||
|
||||
if (LCD_WIDTH - xmargin < len)
|
||||
{
|
||||
/* prepare scroll line */
|
||||
char *end;
|
||||
|
||||
memset(s->line, 0, sizeof s->line);
|
||||
strcpy(s->line, string);
|
||||
|
||||
/* get width */
|
||||
s->len = utf8length(s->line);
|
||||
|
||||
/* scroll bidirectional or forward only depending on the string width */
|
||||
if (bidir_limit)
|
||||
{
|
||||
s->bidir = s->len < (LCD_WIDTH - xmargin) * (100 + bidir_limit) / 100;
|
||||
}
|
||||
else
|
||||
s->bidir = false;
|
||||
|
||||
if (!s->bidir) /* add spaces if scrolling in the round */
|
||||
{
|
||||
strcat(s->line, " ");
|
||||
/* get new width incl. spaces */
|
||||
s->len += SCROLL_SPACING;
|
||||
}
|
||||
|
||||
end = strchr(s->line, '\0');
|
||||
strncpy(end, string, LCD_WIDTH);
|
||||
|
||||
s->offset = offset;
|
||||
s->startx = xmargin + x;
|
||||
s->backward = false;
|
||||
scrolling_lines |= (1<<y);
|
||||
}
|
||||
else
|
||||
/* force a bit switch-off since it doesn't scroll */
|
||||
scrolling_lines &= ~(1<<y);
|
||||
}
|
||||
|
||||
static void scroll_thread(void)
|
||||
{
|
||||
struct scrollinfo* s;
|
||||
int index;
|
||||
int xpos, ypos;
|
||||
|
||||
/* initialize scroll struct array */
|
||||
scrolling_lines = 0;
|
||||
|
||||
while (1)
|
||||
{
|
||||
for (index = 0; index < SCROLLABLE_LINES; index++)
|
||||
{
|
||||
/* really scroll? */
|
||||
if (!(scrolling_lines&(1<<index)))
|
||||
continue;
|
||||
|
||||
s = &scroll[index];
|
||||
|
||||
/* check pause */
|
||||
if (TIME_BEFORE(current_tick, s->start_tick))
|
||||
continue;
|
||||
|
||||
if (s->backward)
|
||||
s->offset--;
|
||||
else
|
||||
s->offset++;
|
||||
|
||||
xpos = s->startx;
|
||||
ypos = ymargin + index;
|
||||
|
||||
if (s->bidir) /* scroll bidirectional */
|
||||
{
|
||||
if (s->offset <= 0)
|
||||
{
|
||||
/* at beginning of line */
|
||||
s->offset = 0;
|
||||
s->backward = false;
|
||||
s->start_tick = current_tick + scroll_delay * 2;
|
||||
}
|
||||
if (s->offset >= s->len - (LCD_WIDTH - xpos))
|
||||
{
|
||||
/* at end of line */
|
||||
s->offset = s->len - (LCD_WIDTH - xpos);
|
||||
s->backward = true;
|
||||
s->start_tick = current_tick + scroll_delay * 2;
|
||||
}
|
||||
}
|
||||
else /* scroll forward the whole time */
|
||||
{
|
||||
if (s->offset >= s->len)
|
||||
s->offset -= s->len;
|
||||
}
|
||||
lcd_putsxyofs(xpos, ypos, s->offset, s->line);
|
||||
}
|
||||
if (cursor.enabled)
|
||||
{
|
||||
if (--cursor.downcount < 0)
|
||||
{
|
||||
int lcd_char;
|
||||
|
||||
cursor.downcount = cursor.divider;
|
||||
cursor.visible = !cursor.visible;
|
||||
lcd_char = cursor.visible ? cursor.hw_char
|
||||
: lcd_buffer[cursor.x][cursor.y];
|
||||
#ifdef SIMULATOR
|
||||
hardware_buffer_lcd[cursor.x][cursor.y] = lcd_char;
|
||||
#else
|
||||
lcd_put_hw_char(cursor.x, cursor.y, lcd_char);
|
||||
#endif
|
||||
}
|
||||
}
|
||||
#ifdef SIMULATOR
|
||||
lcd_update();
|
||||
#endif
|
||||
sleep(scroll_ticks);
|
||||
}
|
||||
}
|
Loading…
Add table
Add a link
Reference in a new issue