Can a testing script eventually lead to a Help Tutorial?

Testing an application, and learning about it, seem to share some of the same characteristics:

XoPhoto does some things, and not others. So the question for testers, and users, is  almost the same: What does it do? How does the user cause it to happen?

For testers there are some additional questions:  Does it perform it’s main functions. Does it work on all versions of Sugar? Is it reliable and predictable, regardless of the previous activity or state? Does it recover gracefully from errors? (power outage, disk full, incorrect user inputs, media failure).

What are the areas to test, and for users, the things to know about?

  • Getting pictures into XoPhoto from camera, USB, SD card
  • Organizing, selecting, reordering, viewing full screen images (slide show)
  • Transferring pictures (exporting or importing) from XoPhoto to folders, USB, SD cards.
  • Removing unwanted pictures from the XO

The following sequence is the beginning of a list of operations which can be used to test the Activity on the various Sugar builds, and may also become an outline for a Tutorial:

Getting Pictures Into the XO

  1. Open the “Record Activity” and take 10 or so pictures.
  2. Close “Record” and open “XoPhoto”. Do the newly taken pictures appear at the first of the thumbnails in the “All Pictures” stack?
  3. Insert a USB drive or SD card containing pictures in any of the following formats: (.jpg, .png, .gif, .tif)
  4. Select the second ‘Inputs’ tab on the menu at the top of the screen. Click on the left most icon (the right arrow triangle).
  5. Select the USB or SD cards on the left column (older builds require that the user select “File System”, “media”, (USB or SD card label name). Then select the folder which contains the images that the user wants to import.
  6. Again verify that the imported pictures appear at the beginning of the “All Pictures” stack

Organizing, selecting, reordering

  1. Delete 3 pictures from “All Pictures”, and then from the XO, by dragging them to the trash, and then “Emptying the Trash” (when the user clicks on the “Trash”, the “Empty Trash” icon becomes visible).
  2. Verify that both methods of dragging work properly:
    • Right click on the “from image” , move hand cursor to target, right click again.
    • Left button press and hold, move cursor to target, release left button.
  3. Create a new stack by double clicking on a thumbnail.
  4. Delete it by clicking on the stack with the red X.
  5. Create a new empty stack by clicking on the stack with the green +.
  6. Drag an image to the new empty stack.
  7. Left click on the new stack to view the contents of that new stack.
  8. Left click on the “All Pictures” stack again.
  9. Drag 3 or 4 more images to this new stack.
  10. Rename the stack by clicking on the new stack, clicking on the “Activity” tab of the menu at the top of the screen,and changing the name at the top of the screen just to the left of the green “+”.
  11. Reorder the images in a stack by dragging an image from where it is to where you want it to be (using left click drag, and right click grab, and then right click again drop).
  12. Add a title, and a comment for an image by first clicking the “Input” menu option, clicking on the image you want to name, and typing in the shorter field at the top of the screen.  Put an comment or description in the longer field.  Do the same for another image.  Verify that the information is retained by clicking on the first image again.
  13. Select a stack on the left side, that you would like to view as a “slideshow”.

Viewing full screen images (slide show)

  1. Click on the “Output” menu tab.
  2. The double right arrow will display the thumbnail surrounded by a colored halo in large format. The square icon returns to the thumbnail screen.
  3. Change the delay between slides by changing the number in the field to the right of the square.
  4. Click on the right facing triangle to start the “Slideshow”.
  5. During fullscreen, use the space bar to pause and unpause the automatic display of the slide sequence, use left and right arrow keys on the lower right corner of keyboard to step forward and back, up and down arrows to turn the titles on and off.
  6. Click on the “unfullscreen” box in the upper right corner.
  7. Click on “Pause” and then left or right arrows to single step through slides.
  8. or “Stop” (square box) to return to the thumbnail view.

    Transferring pictures (exporting or importing) from XoPhoto to folders, USB, SD cards.

    1. Export a stack by clicking on the “Output” menu tab, and then the top left-most export icon.
    2. Select the output folder where you would like the stack folder placed. (If your macine still has an older build, you can select USB or SD by first selecting “file system”, “media”, <your USB or SD label name>).  The folder name created by XoPhoto will be the stack name you selected (default will be “New_Stack”, “New_Stack-1″, “New_Stack-2″, etc.).
    3. Delete the stack you just exported by following the instructions in the next section.
    4. Import the just exported images back into the Journal, and recreate the stack by selecting the left-most icon on the “Input” menu tab. You must navigate to the folder with the name or the stack you just exported.
    5. Verify that all the “title”, “description” information is restored appropriately.

    Removing unwanted pictures from the XO

    1. To remove an image from a stack you have created, just drag it to the “Trash”. It will disappear from the stack, but it will not be added to the contents of the “Trash” stack.
    2. If you want to delete an image from the XO, and throw it away, select the “All Pictures” stack, (which shows all images in the Journal), and drag it to the “Trash”.
    3. If you change your mind, and don’t want to delete an image that you have already dragged to the “Trash”, you can drag it from the images displayed in the “Trash” back to the “All Pictures” stack.  It will be removed from the “Trash” and put back in “All Pictures”.
    4. By left clicking on the “Trash” you can verify that the image has been set up for deletion.  It will be removed from the XO when you “Empty Trash”.  There is no recovery of images once you click “Empty Trash” (unless you have previously exported them to a folder, or another storage device).
    5. If you want to delete a large number of images, perhaps after you have exported a stack to a USB device, you may drag a stack  to the “Trash”, and then “Empty Trash”.
    6. If you want to delete all of the images in “All Pictures”, you must drag them individually to a stack that you have created,  then drag that stack to the trash, and then “Empty trash”.
    Posted in Testing, Tutorial, XoPhoto resources | Leave a comment

    Other information about XoPhoto

    • The XoPhoto Activity includes a help system which is based on html. A copy of this help is online at an Internet Service Provider that interfaces easily with the Dreamweaver program I use for html development.
    • Technical and historical information about the development of XoPhoto is archived at OLPC.
    • The most recent stable version of the XoPhoto software in on the laptop.org web site.
    • Review bug that have been reported at the sugarlabs.org trac site.
    • To report a bug yourself on the sugarlabs.org site you will need to select a user name and password, and wait for approval from a sugarlabs administrator (spam prevention). Or alternatively you can email me at georgejhunt@gmail.com, and I will enter it into the system.
    • The development version, with new features, and changing frequently is in a git repository at http://git.sugarlabs.org/projects/xophoto/repos/mainline.
    Posted in FAQ, XoPhoto resources | 1 Comment

    Musings about Features to include in the next major release

    • Most social networking sites provide a randomly encoded email address for each user to use for uploading pictures. XoPhoto should be able to send an album as individual emails or as multiple attachments.
    • The information returned from deployments is that the kids really enjoy the camera, and use the Record Activity heavily, often quickly filling up the Journal. XoPhoto should monitor the amount of free space in the Journal, and provide continuous feedback about the space left.
    • When XoPhoto imports a folder of images, it should create stack in the left column, (which is easily deleted without deleting the images from the Journal), so they can easily be acted upon as a grouping.
    • To optomize space in the Journal, especially when importing from a camera SD card, XoPhoto should have resize and crop capability. (Whatever software library is used should preserve any metadata in the original images).
    • The left column could be reworked. The “All Pictures” and “Trash” could remain fixed where they are, and the image stacks could scroll in the space below these two fixed targets. Perhaps new stacks could be added from the top, like a push down stack, so that the current context is always on screen and doesn’t require scrolling, except when returning to an earlier activity.
    Posted in Feature suggestions | Leave a comment

    New release XoPhoto-9.xo

    New release XoPhoto-9 November 26

    This release allows the new user to chose to install practice images or not, fixes a number of bugs, and is tested to work on Build 852 on both the XO1.0 and XO1.5, and on build 650.

    Hi everyone, (Hello World),

    As of September 6, I have 5 XO’s engaged in testing XoPhoto, each initialized with a different build: (Builds 650, 767, 802, 852 for the 1.0, and 852 for XO1.5).  There have been many problems to work out, but the solutions came pretty quickly, since program logic, and features, haven’t been at issue.

    Shooting for the upload and release in the next few days. I’d like to change the images that are automatically loaded into the Journal to be educational in the use of XoPhoto.

    Update as of September 25: I’ve been struggling with creeping feature disease — or maybe it’s just realization of inadequate design.  A number of issues have been addressed:

    • A new database structure can be included in  a later release of XoPhoto, and the data from earlier versions of the sqlite XoPhoto database  in a student’s journal will be transferred to the new structure.
    • Titles and comments entered by the student will be copied to USB sticks, SD cards, and file folders, in a xml format which can be reloaded into XoPhoto when the pictures are reloaded into XoPhoto.
    • Titles and Comments are displayed during the Slideshow presentation if the user selects the fullscreen icon.
    • User selection of the slideshow repeat delay.
    Posted in Releases | Leave a comment