Difference between revisions of "Karma/Specifications"

From Sugar Labs
Jump to navigation Jump to search
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>
 
<noinclude>{{GoogleTrans-en}}{{TOCright}}</noinclude>
  
=== Introduction ===
+
=== Introduction ===  
 
 
Notes: recommendations,
 
  
 
Two main goals should be kept in mind when creating Karma lessons:
 
Two main goals should be kept in mind when creating Karma lessons:
Line 23: Line 21:
 
==== Accessibility ====
 
==== Accessibility ====
  
...
+
Follow best practices for accessibility (e.g. example of a [http://northtemple.com/1608 checklist]), especially with regard to [http://en.wikipedia.org/wiki/Color_blindness colorblindness].
 +
 
 +
=== HTML ===
 +
 
 +
* <!DOCTYPE HTML>
 +
 
 +
=== JavaScript ===
 +
 
 +
* ...
  
 
=== Animations ===
 
=== Animations ===
Line 30: Line 36:
 
* Recommended tools: TBD
 
* Recommended tools: TBD
 
* Notes: TBD
 
* Notes: TBD
* ...
+
The Karma animations are created using JavScript and the Karma plugin. At this moment we haven't defined a mechanism to "export" (and "import") one animation. But copying and pasting the code (of the animation) will be enough in most cases.
  
 
=== Images ===
 
=== Images ===
  
* Format(s): [http://en.wikipedia.org/wiki/JPEG JPEG], [http://en.wikipedia.org/wiki/Portable_Network_Graphics PNG], [http://en.wikipedia.org/wiki/Scalable_Vector_Graphics SVG] '''(?)'''
+
* Format(s): [http://en.wikipedia.org/wiki/JPEG JPEG], [http://en.wikipedia.org/wiki/Portable_Network_Graphics PNG], [http://en.wikipedia.org/wiki/Scalable_Vector_Graphics SVG] '''(Note 1, 2 and 3)'''
* Recommended tools: [http://www.adobe.com/products/illustrator/ Adobe Illustrator] (non-free), [http://www.corel.com CorelDRAW] (non-free), [http://www.gimp.org/ GIMP], [http://www.inkscape.org/ Inkscape]
+
* Recommended tools: [http://www.inkscape.org/ Inkscape], [http://www.gimp.org/ GIMP], [http://www.adobe.com/products/illustrator/ Adobe Illustrator] (non-free), [http://www.corel.com CorelDRAW] (non-free)
* Max. resolution: 1200*900
+
* Max. resolution: 1200*900 px
* Notes: TBD
+
* Notes:  
 +
#To handle SVG files will be necessary to create a parser svg2canvas in order to introduce them as objects inside canvas element.
 +
#Animated SVG content will be hard to reproduce using canvas.
 +
#SVG animations seems slow under the XO-1 (Tested with [http://raphaeljs.com/ RaphaelJS] and Browse)
  
 
=== Sound ===
 
=== Sound ===
  
* Format(s): [http://en.wikipedia.org/wiki/Vorbis OGG Vorbis]
+
* Format(s): [http://en.wikipedia.org/wiki/Vorbis OGG Vorbis] (Note 1)
 
* Bit rate: TBD
 
* Bit rate: TBD
 
* Max. size per lesson: 3~4MB
 
* Max. size per lesson: 3~4MB
 
* Recommended tools: [http://audacity.sourceforge.net/ Audacity]
 
* Recommended tools: [http://audacity.sourceforge.net/ Audacity]
* Notes: TBD
+
* Notes:  
 +
# https://developer.mozilla.org/En/Media_formats_supported_by_the_audio_and_video_elements
  
 
=== Video ===
 
=== Video ===
  
* Format(s): TBD
+
* Format(s): TBD (Note 1)
 
* Recommended tools: TBD
 
* Recommended tools: TBD
 
* Notes: TBD
 
* Notes: TBD
* ...
+
# https://developer.mozilla.org/En/Media_formats_supported_by_the_audio_and_video_elements

Latest revision as of 03:53, 25 August 2009

Introduction

Two main goals should be kept in mind when creating Karma lessons:

  1. they should be easy to adapt
  2. they should run on as much hardware as possibe with OLPC's XO-1 laptop representing the baseline

General Notes

Hardware constraints

Since a large percentage (if not the majority) of Karma users are envisioned to be using OLPC XO-1 laptops, netbooks, older hardware or generally relatively slow systems there are several performance constraints that need to be taken into account when designing Karma lessons.

  • CPU/Memory: The baseline regarding available performance is the XO-1 laptop which comes with an AMD Geode LX 433MHz CPU and 256MB RAM (full specifications). This limits the use of high-resolution multimedia, animations and videos to some degree.
  • Display: Karma lessons should work well on displays with a resolution of 1024*768 (whereby a part of the display may be taken up by browser UI elements!).
  • Mass storage: Since especially the XO-1 laptop only has very limited local mass storage (1GB) lessons should be kept reasonably small.
  • Connectivity: Karma lessons must not assume constant connectivity with a locally (e.g. XS) or globally available server. Support for storing data locally will be provided by Karma.

Accessibility

Follow best practices for accessibility (e.g. example of a checklist), especially with regard to colorblindness.

HTML

  • <!DOCTYPE HTML>

JavaScript

  • ...

Animations

  • Format(s): TBD
  • Recommended tools: TBD
  • Notes: TBD

The Karma animations are created using JavScript and the Karma plugin. At this moment we haven't defined a mechanism to "export" (and "import") one animation. But copying and pasting the code (of the animation) will be enough in most cases.

Images

  1. To handle SVG files will be necessary to create a parser svg2canvas in order to introduce them as objects inside canvas element.
  2. Animated SVG content will be hard to reproduce using canvas.
  3. SVG animations seems slow under the XO-1 (Tested with RaphaelJS and Browse)

Sound

  • Format(s): OGG Vorbis (Note 1)
  • Bit rate: TBD
  • Max. size per lesson: 3~4MB
  • Recommended tools: Audacity
  • Notes:
  1. https://developer.mozilla.org/En/Media_formats_supported_by_the_audio_and_video_elements

Video

  • Format(s): TBD (Note 1)
  • Recommended tools: TBD
  • Notes: TBD
  1. https://developer.mozilla.org/En/Media_formats_supported_by_the_audio_and_video_elements