1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<title>Untitled Document</title>
<link href="CSS/Georgia.css" rel="stylesheet" type="text/css" />
</head>
<body>
<h1>XoPhoto Features</h1>
<p><img class="right" src="images/initial_screen.jpg" alt="initial_screen" /></p>
<p> </p>
<ul>
<li>Select pictures from the Journal and put them into a Stack on the left side of the screen.</li>
<li>Create and name new Stacks, and delete old ones</li>
<li>View pictures in a stack, reorder them, add titles, comments, rotate them as required</li>
<li>Add pictures to the Journal from USB stick or SD card.</li>
<li>View a selected Stack of images in large screen format, individually, or as an automatic sequence of slides in a slide show</li>
<li>Copy the selected Stack of images from the Journal to a USB stick, SD card, or the user's home directory </li>
</ul>
<h3>Getting Started</h3>
<p>The first time XoPhoto starts up, it needs to look though the Journal to find all the pictures, and generate the small thumbnail images it uses. This may take a lot of time, particularly if there are a large number of pictures found there. As it is creating the thumbnails, they will become visible on the screen. The next time XoPhoto starts up, it will proceed much more quickly.</p>
<p>Note that for all of the icons at the top of the screen, moving the cursor to an icon will give a very short description of the function of that selection. </p>
<p>Initially there will be only two items visible on the left. The top one is labeled "All Pictures" and shows the number of pictures found in the Journal. The second is labeled "Trash 0". As you are working with the pictures in "All Pictures", there may be images which you want to discard. You can drag them to the "Trash" by left clicking on the undesired image, holding the left button down as you move the cursor over the image of the trash, and releasing the left button.</p>
<p>On the XO this usually takes two hands, one to control the left button, and the other to move the cursor. An alternative, and easier method is to click the right button on the undesired image, move the cursor to the trash, and then click the right button again.</p>
<h3>Creating a new Stack of images </h3>
<p><img class="left" src="images/the_new_album.png" width="400" height="300" alt="creating_album" /></p>
<p>At any time, the user can start a new stack by clicking the icon with the green plus sign. The default name is "New Stack". It can be renamed by typing the new name in the field labeled "New Album Name". </p>
<p>In a similar fashion, a stack can be deleted by clicking the "stack" icon with the red X overlayed upon it. For deleting a stack, you must confirm your intention before the stack will be deleted.</p>
<p>As a special case, if there are no Stacks in the left column (only "All Pictures" and the "Trash"), a "New Stack" will be created if the user double clicks on an image in the "All Pictures" set of images. Thereafter, double clicking will add the "double clicked image" to the most recently used stack.</p>
<h3>Manipulating Images on a Stack </h3>
<p>The order of the images in a stack can be changed by the drag and drop method mentioned above. Left click on the item to be moved, and hold it down while dragging the image to the new location.</p>
<h3>Deleting Images from the XO</h3>
<p><img class="right" src="images/delete_composite.png" width="556" height="458" />
Images can be removed from the stack by dragging them to the trash. When items from stacks you have created are dragged to the trash, they just disappear. They are not added to the contents of the trash. Only the images that are dragged from "All Pictures" are added to the contents of the trash basket. (Notice that in the multiple image to the right, the contents of the Trash are displayed--the trash basket is the same shade of gray as the right side). When you have selected the Trash, the contents of the Trash Basket are visible, and the "Empty Trash" icon becomes visible (the red X over the Trash image). When "Trash" is emptied, all corresponding pictures are removed from the XO and are not recoverable.</p>
<p>Certain editing operations affect all views: adding Title, Description, and rotating the image.</p>
<h3>Adding Images to XoPhoto from sources </h3>
<p>The XO itself is the most convenient means of adding photos to XoPhoto. The camera adds images to the Journal automatically whenever the Record Activity is used to take pictures. It is more convenient to use the XO as a camera, if the "O" button (one of the four grouped together in diamond shape on the right side of the XO screen) is used as the camera trigger.</p>
<p>Another way of using the XO as a source is to take a screenshot of what is currently on the XO display. This is done via the <alt "1"> key conbination.</p>
<p>Images can be imported by selecting the "Edit" tab on the menu, and then clicking on the top leftmost icon. USB sticks, and SD cards will become visible and can be selected as import sources. The dialogue box will permit the user to select a folder from which all the images will be imported into the XO Journal. Then the next time the XoPhoto program is started up, the new photos in the Journal will be noticed, and the thumbnails will be generated. </p>
<h3>Exporting images </h3>
<p>A stack of images can be exported to a folder from the Journal by choosing the "Output" tab of the top menu. The current version of XoPhoto exports the image as it was received from the source--without rotation, or other transformations. This may change in later versions, as soon as quality and preservation of embedded information issues can be resolved. The exported images will be output in the order of the stack, and with filenames modified to the title given to the image on the "Edit" menu tab. The filenames begin with a sequence number so that other slideshow programs will show them in the correct order. </p>
<p>The location of the folder can be selected using the dialog box which pops up initally. A folder will be generated with the name you entered when you named the photo stack. If a folder with that name already exists, a "-1" or "-2", etc, will be added to the folder name. </p>
<h3>Slideshow </h3><img class="right" src="images/slide_start.png" alt="start_slideshow" />
<p>At any time during the viewing of the thumbnails, if the user desires to view a larger view of the image, the "Output" tab "next slide" icon can be selected. This will show the currently selected image at the largest size possible. "Next slide" and "Previous slide" will continue to display large images. The square "Stop" icon will return the user to the thumbnail screen. </p>
<h3>Preparing the /home/olpc/Pictures Directory </h3>
<p>There is a procedure required to prepare the /home/olpc/Pictures directory to receive pictures from XoPhoto. This procedure will set the permissions on the "Pictures" directory so that XoPhoto can write. The procedure is a 4 step process:</p>
<ol>
<li>Open the Terminal Activity</li>
<li>Type the characters "cd" and hit the enter key. </li>
<li>Type the characters "./A" and hit the <tab> key. The auto-completion will complete the "./Activities/" pathname for you. Then type "X", <tab>. The path will become "./Activities/XoPhoto.activity/". Then type 'm',<tab>. The auto-completed path will be "./Activities/XoPhoto.activity/mkdir_Pictures". Then hit enter, and a short program will be executed which will properly set up your "Pictures" folder. </li>
</ol>
<p>Thereafter, whenever you export a stack of pictures, by default they will be placed in the "/home/olpc/Pictures" folder, and they will be available from to the Browse Activity for upload .</p>
<h3>How to Help Improve XoPhoto . . .Report Bugs </h3>
<p>You can help make XoPhoto better by reporting the Bugs, and suggestions you have for improvement. Fill out a Bug Report at </p>
<p><a href="http://bugs.sugarlabs.org/newticket?component=XoPhoto>
http://bugs.sugarlabs.org/newticket?component=XoPhoto</a>
<p>or send email with "XoPhoto Bug" in the title to "georgejhunt@gmail.com" describing the problem, and the software Build number from "My Settings" -- "About My Computer" (described in next paragraph). </p>
<p> The author of XoPhoto will make every effort to provide quick turnaround on fixes, and ensure that the software update activity function provides a convenient means of obtaining the improved activity (From the circle home screen, right click on the XO figure in the center, left click on "My Settings", left click on "softare update" -- on a recent build you need to use the horizontal scroll bar to make "software Update" visible). </p>
<p> </p>
<p> </p>
</body>
</html>
|
