rockbox/apps/plugins/text_viewer
Thomas Martitz 249bba03f1 Initial commit of the Samsung YP-R0 port.
This port is a hybrid native/RaaA port. It runs on a embedded linux system,
but is the only application. It therefore can implement lots of stuff that
native targets also implement, while leveraging the underlying linux kernel.

The port is quite advanced. User interface, audio playback, plugins work
mostly fine. Missing is e.g. power mangement and USB (see SamsungYPR0 wiki page).

Included in utils/ypr0tools are scripts and programs required to generate
a patched firmware. The patched firmware has the rootfs modified to load
Rockbox. It includes a early/safe USB mode.

This port needs a new toolchain, one that includes glibc headers and libraries.
rockboxdev.sh can generate it, but e.g. codesourcey and distro packages may
also work.

Most of the initial effort is done by Lorenzo Miori and others (on ABI),
including reverse engineering and patching of the original firmware,
initial drivers, and more. Big thanks to you.

Flyspray: FS#12348
Author: Lorenzo Miori, myself

Merry christmas to ypr0 owners! :)

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@31415 a1c6a512-1295-4272-9138-f99709370657
2011-12-24 11:56:46 +00:00
..
readme.txt
SOURCES
text_viewer.c Fix nearly all residual 'variable set but not used' warnings reported from GCC 4.6.0. 2011-05-01 14:44:20 +00:00
text_viewer.make
tv_action.c
tv_action.h
tv_bookmark.c
tv_bookmark.h
tv_button.h Initial commit of the Samsung YP-R0 port. 2011-12-24 11:56:46 +00:00
tv_display.c Text viewer plugin: Fix info viewport font not being set to user selected font 2011-11-30 03:06:41 +00:00
tv_display.h
tv_menu.c
tv_menu.h
tv_pager.c
tv_pager.h
tv_preferences.c FS#12273 - use buflib for font storage. thanks to the testers :) 2011-09-24 13:19:34 +00:00
tv_preferences.h FS#12273 - use buflib for font storage. thanks to the testers :) 2011-09-24 13:19:34 +00:00
tv_reader.c
tv_reader.h
tv_screen_pos.c
tv_screen_pos.h
tv_settings.c FS#12273 - use buflib for font storage. thanks to the testers :) 2011-09-24 13:19:34 +00:00
tv_settings.h
tv_text_processor.c FS#12273 - use buflib for font storage. thanks to the testers :) 2011-09-24 13:19:34 +00:00
tv_text_processor.h
tv_text_reader.c
tv_text_reader.h
tv_window.c
tv_window.h

about the text viewer plugin.

Limitation
    for the target which PLUGIN_BUFFER_SIZE < 0x13000 (i.e., archos series),
    can only be read up to 999 pages.


Difference between viewer.rock
    [settings file]
       - the global setting, 'tv_global.dat' is stored.
       - Settings and bookmarks for each file, 'tv_file.dat' is stored.

      Note: when viewer.dat(viewer_file.dat) exists, tv_global.dat(tv_file.dat) is created by
            using viewer.dat(viewer_file.dat).

    [wod wrap]
          - add the following characters which can be split the line.
                '!', ',', '.', ':', ';', '?', 
                U+00b7, U+2010, U+3000, U+3001, U+3002, U+30fb, U+30fc, 
                U+ff01, U+ff0c, U+ff0d, U+ff0e, U+ff1a, U+ff1b, U+ff1f.

          - when the line split, if the line length is short ( < 0.75 * display width), 
            split the line in display width. (thus, maybe split a word)

    [line mode]
       [join]
           - break line condition has changed.
               - If the next line is a blank line or spaces only line, this line breaks.

       [reflow]
           - indent changes is two spaces (changable in the settings).
           - supports the player which does not define HAVE_LCD_BITMAP.

    [alignment]
           - the right alignment supports the player which does not define HAVE_LCD_BITMAP.

    [bookmark]
           - increased to 16 the number of bookmarks that can be registered.


TODO list
  - for the target which PLUGIN_BUFFER_SIZE < 0x13000 (i.e., archos series),   
    supports more than 999 pages of text.

  - add History feature.

  - draw images that are linked to the text. (<img src="...">)

  - play audios that are linked to the text. (<audio src="...">)

  - more treatments of line breaking, word wrappings.
    (for example, period does not appear the top of line.)