View source for Clock activity

{{Olpcboxtop|toptext=[[{{PAGENAME}}|Clock Activity]]}}
 {{ OBX activity |[[Image:Activity-clock.svg|75px]]|extra<!--|{{{text}}}--> }}
 {{ OBX xobundle|http://wiki.laptop.org/images/b/bd/Clock-3.xo|Clock}}
 {{ OBX test }}
<!-- {{ OBX devtickets |clock-activity}} -->
 {{ OBX pot
<!--  explicit codes: en, es, fr -->
}}
<!-- {{ OBX source dev|projects/clock}} -->
<!-- {{ OBX test |[[Tests/Clock|Clock]]|2008-02-02 }} -->
<!-- {{ OBX devtickets |clock-activity}} -->
<!-- {{ OBX pootle|1=http://dev.laptop.org/git?p=projects/clock;a=blob_plain;f=po/Clock.pot;hb=HEAD|2=extra}} -->
 {{ OBX team |[[User:Genepi|Pierre Métras]]}}
<small>see more [[:Category:OBX templates|templates]] or [[OBX proposals|propose new]]</small>
{{Olpcboxbottom}}

{{Users}}
==Description & Goals==

[[Image:clock-nice.jpg|right|300px|thumb|What time is it?]]

===Summary===

The Clock activity aims at two simple goals:
* As a teaching tool to help children learn how to read time.
* To give the children a way to know the time it is, with their XO, even they don't own a watch.
The presentation on screen has been kept simple enough to reach these two objectives.

===Current Use & Goals===

Click on right button to change display mode.
* Simpler display
* With hours numbers
* Date and day
* Nice clock face
* Digital clock view

A consistent color code is used through the activity so that hours are always displayed in blue (resp. minutes and seconds), either the figures in the digital clock or the short hand in the analog clocks, or the time scale. The child will understand that these are different representations of the same concept.


===Other uses===

Learn how to find geographical North (or South, depending in which hemisphere you are located) using the clock hands: [http://www.wikihow.com/Find-True-North-Without-a-Compass Findind True North Without a Compass].
And from there, build a solar clock!


===Screenshots===

{|style="border: solid 1px gray; margin: 1em auto 1em; auto"
|-
| valign="top"|
[[Image:clock-simple.jpg|300px|thumb|center|The basic clock face (v1)]]
| valign="top"|
[[Image:clock-nice.jpg|300px|thumb|center|The nice clock face (v1)]]
|-
| valign="top"|
[[Image:clock-simple-hours.jpg|300px|thumb|center|The basic clock face showing hours marks (Roman digits used by the French localization) (v1)]]
| valign="top"|
[[Image:clock-nice-date.jpg|300px|thumb|center|The nice clock face displaying the date with French localization (v1)]]
|-
|}

===Setting the time on your XO===

You can set the date and time of your XO with the [http://wiki.laptop.org/go/Sugar_Control_Panel#Time Sugar Control Panel].

===Packages and History===

As a Python application, the full source is included in the package for you to enjoy.

* Version 3 [[:Image:Clock-3.xo|Clock-3.xo package]]
 * Added the license information needed by 8.2 activity bundles.

* Version 2 [[:Image:Clock-2.xo|Clock-2.xo package]]
 * Added Digital Clock.
 * Better localization support.
 * Color code.
* Version 1 [[:Image:Clock-1.xo|Clock-1.xo package]]
 * Analog clocks: simple and nice.
 * Initial version.


{{Developers}}

==Development==

This code is released in Public Domain, so you can do whatever you want with it. This is simple enough that Python learners can try to add or change features. The whole clock code, with many detailed comments, is a 500 lines Python source.

Point of interests:
* PyGTK events programming, when one clicks on right button.
* Cairo drawing and Pango layout.
* Localization. Though a clock face should look quite similar in all cultures, you can adapt the way it displays hours numbers and date. Use of Pango markup allows to adapt the views to cultural representations of date and time.
* SVG rendering. The nice clock background is the SVG file clock.svg (drawn with [http://www.inkscape.org Inkscape]). You can change it to your liking.

Look at the README file for notes and ideas.


===Localization===

The Clock activity has been written with localization in mind, though a clock should look similar in all cultures. The POT file contains strftime patterns and Pango markup, so that translators can localize the application with more freedom. For instance, they can change the way date or time are displayed, the fonts to use or the size of characters.

I've provided 3 localizations for French, English and Spanish, but others are welcome!


=Functional Test=

* Open the clock activity.
* Check that it display the current time of the XO.
* Click on right button to change clock face display. Display mode loops (simple + hours + day and date + nice clock + digital).
* Close the activity; ensure that it closes properly.

=Enhancements=

* Add continuous display; current display stops after a few minutes requiring a click.
* Context menu to set the date, time, timezone, etc.
* Add a Big Ben chime.
* Talking clock: read aloud the time every minute.


[[Category:Software]]
[[Category:Developers]]
[[Category:Sugar]]
{{Activity page
|icon=Image:Activity-clock.svg
|genre=General Search and Discovery
|short description=The Clock activity aims at two simple goals:

    * As a teaching tool to help children learn how to read time.
    * To give the children a way to know the time it is, with their XO, even they don't own a watch.
|long description=Current Use & Goals

Click on right button to change display mode.

    * Simpler display
    * With hours numbers
    * Date and day
    * Nice clock face
    * Digital clock view 

A consistent color code is used through the activity so that hours are always displayed in blue (resp. minutes and seconds), either the figures in the digital clock or the short hand in the analog clocks, or the time scale. The child will understand that these are different representations of the same concept.
|contact person=User:Genepi
|language=English, French, Spanish
|language codes=en, es, fr
|bundle URL=http://wiki.laptop.org/images/b/bd/Clock-3.xo
|activity version=3
|releases=7.1.0 (650), 7.1.1 (653), 7.1.2 (656), 8.1.0 (703), Candidate
|devel status=5. Production-stable
}}
{{Activity bundle
|bundle URL=http://wiki.laptop.org/images/5/5a/Clock-2.xo
|activity version=2
|releases=7.1.0 (650), 7.1.1 (653), 7.1.2 (656), 8.1.0 (703)
|devel status=5. Production-stable
}}
{{Activity bundle
|bundle URL=http://wiki.laptop.org/images/d/db/Clock-1.xo
|activity version=1
|releases=7.1.0 (650), 7.1.1 (653)
|devel status=4. Beta
}}