Read

From OLPC
Revision as of 14:05, 22 December 2007 by W9ZSJ (talk | contribs) (→‎Executable .xo files: Comments from satisfied user of Read)
Jump to navigation Jump to search
  Please copy/paste "{{Translationlist | xx | origlang=en | translated={{{translated}}}}}" (where xx is ISO 639 language code for your translation) to Read/translations HowTo [ID# 87807]  +/-  


Activity-activity-read.svg This activity was core
Version 23
TST Read
Trac print.png Tickets all - active - new
OlpcProject.png Manusheel Gupta, Marco Gritti, Tomeu Vizoso, Walter Bender (Advisor), Dan Williams, Eben Eliason
mime pdf

see more templates or propose new

Description & Goals

Read activity

Summary

The Read activity allows the laptop to act as a book reader. It has a simple interface, and will view many kinds of text and image based book-like materials (PDF files work currenty). It will have particular strengths in Handheld mode, with extremely low power consumption and simple navigation controls.

It can currently read PDF files successfully.

Source

http://dev.laptop.org/git.do?p=projects/read-activity

Executable .xo files

Currently the activity has to be opened from the Journal; PDF functionality works, but the activity is memory hungry. I couldn`t open any other file types (.txt .htm .djvu for example didn`t work). --Tomhannen 15:33, 8 December 2007 (EST)


This worked like a charm, my first experience with Sugar beyond the main applications. Very clever. Thanks to Tomhannen.

One needs to fiddle with the keys to discover navigation within a document. The loading time is excessive if you jump ahead. But it works great and will bring on lots of Memory Full problems from happy users.

How to install the Read activity

  • To use the reader, download the .xo file shown above, using the Browse activity.
  • When it has downloaded, save it to your Journal.
  • Go to your Journal, click on the Read.xo activity, and choose "Resume".
  • The read activity should now be installed.

Media to try on the reader

  • To read a document, download the document to your Journal, then Resume it using the Read activity.
  • A large (14MB) PDF file with illustrations can be found [here].
  • It viewed correctly on a B4 laptop with OS build 650.

Screenshots

Find functionality
Navigation
Zooming
Dynamic Table of Contents

Development

Feature Requests
Implementation Discussion
Version History

Functional Test

Basic

  • Open the browser window and go to the library or content url (not sure exactly how this will work yet).
  • Double click on a book from the library directory.
  • Ensure that the file scrolls properly using the scroll keys and the up/down arrow keys.
  • Ensure that the image rotates with the rotate button and continues to scroll with the gamepad keys.
  • Ensure that zoom works: change the zoom 'Zoom to fit', 'Zoom to width' and 'Actual size', use the zoom controls to zoom to 95% and then 150%
  • Ensure next/previous page work; stay on a page other than page 1.
  • Close the activity; ensure that it closes properly.
  • Resume the activity from the Journal
  • Check that the page number and the zoom level are still what they were before closing (The page position may not be exactly the same as before, but should be on the same page number).

Secondary

  • Share the book with another XO.
  • Ensure that both people can read the book.

Initial mockups of the Reader

Document Description
Activity Mockup (2MB) history Adobe Illustrator file containing mockups for each toolbar