Update Record v 99

Signed-off-by: Iain Brown Douglas <iain@browndouglas.plus.com>

9 files changed, 148 insertions, 76 deletions

diff --git a/images/Record0.png b/images/Record0.png
new file mode 100644
index 0000000..a22ab15
--- /dev/null
+++ b/images/Record0.png
diff --git a/images/Record1composite.png b/images/Record1composite.png
new file mode 100644
index 0000000..80cdecd
--- /dev/null
+++ b/images/Record1composite.png
diff --git a/images/Record1still.png b/images/Record1still.png
new file mode 100644
index 0000000..955ec3e
--- /dev/null
+++ b/images/Record1still.png
diff --git a/images/Record2video.png b/images/Record2video.png
new file mode 100644
index 0000000..e6b2d9a
--- /dev/null
+++ b/images/Record2video.png
diff --git a/images/Record3audio.png b/images/Record3audio.png
new file mode 100644
index 0000000..f88beef
--- /dev/null
+++ b/images/Record3audio.png
diff --git a/images/Record4.png b/images/Record4.png
new file mode 100644
index 0000000..510f053
--- /dev/null
+++ b/images/Record4.png
diff --git a/images/Record5.png b/images/Record5.png
new file mode 100644
index 0000000..27a6874
--- /dev/null
+++ b/images/Record5.png
diff --git a/images/Record6.png b/images/Record6.png
new file mode 100644
index 0000000..9dd9a4b
--- /dev/null
+++ b/images/Record6.png
diff --git a/source/record.rst b/source/record.rst
index 87b1956..394c043 100644
--- a/source/record.rst
+++ b/source/record.rst
@@ -5,143 +5,215 @@ Record
 About
 -----
 
-The Record Activity is used for recording audio and video and for taking pictures. You will need to have a built in camera and microphone to use these features. If your computer only has a microphone and no camera then you can only use the Record Activity to record audio.
+The Record Activity is used for recording audio and video and for taking pictures. You will need to have a built in, or an attached, microphone and/or camera to use Record.
 
-Record can be used for :
+If your computer has no built in camera, or an unsuitable camera attached, then Record, will open in *Record audio* mode only.
 
-* Taking pictures
-* Recording video
-* Recording audio
-* Stop-motion photography 
-* Time-lapse photography
-* Creating 360° panoramas
-* Viewing slide shows
-* Storing extra information about audio, video, and pictures
+Quick start
+-----------
 
-Record stores images and audio in the Journal, from which they can be used by other activities, such as Draw, Write, Etoys, and Browse, as well as Memorize and some other games. Also, images can be transferred to a USB storage device from the Journal by "drag and drop".
+There are three record or capture modes. Select **one** of these buttons to chose your Record mode.
 
-Taking Photos
--------------
+.. image :: ../images/Record0.png
 
-You can use the Record Activity to take photographs of the world around you. The screenshot below highlights some of the key controls available in the main Photo Tab.
+The image above shows the buttons of the three *Record* modes, they are:
 
-.. image : ../images/record_photo_marked.jpg
+   * Picture camera mode
 
-Let's look at some specific details about the items highlighted above:
+   * Video camera mode
 
-1. This item shows the Photo Tab has been highlighted. This means that the Record Activity is in photo capture mode and all of the controls you see now reflect this.
-2. Record allows users to set a timer before recording happens. In this case, the timer is a pulldown menu that allows you to chose among three options: "Immediate", "5 Seconds", and "10 Seconds". Delaying the timer might be useful if you want to give yourself some time to get to the right pose before the Record Activity takes a snapshot.
-3. You often see a double arrow at the top right corner of your picture window. This arrow puts record into full screen mode, where everything is hidden except the picture window and the record button (item 4 below). In full screen mode, you can navigate the pointer to the top right corner and a similar icon pops up to allow you to return to normal mode.
-4. This is the button that tells the Record Activity to start recording. In Photo mode, Record takes a snapshot of whatever is in front of the camera.
-5. The area between the left and right arrows is called the tray. It is where previously recorded items are placed so that you can look at them later on.
+   * Audio, or sound mode
 
-Once Record successfully takes a photo, it shows up as an icon on the tray. You can click the icon to view the photo and to update information about that picture.
+This is the *Record* or capture button |Capture| in the centre of the screen, below *main image*.
 
-.. image :: ../images/photo-taken-marked_3.jpg
+.. |Capture| image:: ../images/button.png
 
-In the Photo View screenshot above, item 1 shows how the tray displays a history of your previously taken photos. When you click on a photo, you are taken to the interface you see in the screenshot, which includes a text field where you can name your photo (item 2). You also see the image taken by your camera (in this case, the skyline of Chicago). Item 3 is a small output window of what your camera sees (in this case, a very happy student!). If you click on this small window, you are returned to the main photo screen from which you can take more pictures.
+The main image shows what will be captured. Record will capture whatever is in front of the camera in *Picture camera* mode, or *Video camera* mode, and will capture whatever the microphone can detect, when in *Audio* mode.
 
-Item 4 on the bottom right of your image is a little tab that allows you to find out even more about the photo that was taken. The screenshot below shows the new window that appears. Here, you can read and enter new 'tags' for your image, and find out about when the picture was taken and by whom. A tag is a single word that helps categorize or describe the photo.
 
-As with the photo view window, you have the output of your camera on the bottom left. You can click this to go back to taking photos.
+  **Tip** As always in Sugar, if you are not sure what a button will do, hover the cursor over it, to reveal its function.
 
-.. image :: ../images/photo_tagging.jpg
+Record features in detail
+-------------------------
 
-Video
------
+.. image :: ../images/Record1still.png
+
+**Toolbar and capture buttons explained**
+
+1. Activity tab. Here you can enter a name for the project, access the Journal, to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing Media`.
+
+2. Picture camera mode is selected.
+
+3. Video camera mode button.  Press to switch to Video camera mode.
+
+4. Audio recording mode button. Press to switch to Audio recording mode.
+
+5. Select timer button. Press this button to engage a delay before taking a picture. Available delay options are, *Immediate*, *5 seconds*, or 10 secomds.
+
+6. Timer duration button. Duration is grayed out in *Picture camera* mode. In *Video* mode and in *Audio* mode press to *Select duration*. Available duration options are 2, 4, 6 minutes.
+
+7. Select quality button. The button is grayed out in *Picture camera* mode, and *Audio* mode. In Video camera mode, press this button to select low or high quality. Experiment and choose whichever gives the best results in your conditions.
+
+8. This image represents an picture already taken. It is in the area of the screen called the *tray*, which contains thumbnail images.
+
+9. The record or capture button. Once a picture, video, or Audio recording has been captured, it is automaticly saved in the Journal, and the saved image or clip is represented as a thumbnail in the tray.
+
+10. When the tray is full of images, this button scrolls through the images.
+
+11. Stop, or close the application.
+
+The next section covers Video camera mode, and then Audio recording in more specific detail. However you might now prefer to follow on to :ref:`Viewing, saving and managing your work`.
+
+Video camera
+------------
+
+.. image :: ../images/Record2video.png 
+
+**Toolbar and capture buttons explained**
+
+1. Activity tab. Here you can enter a name for the project, access the Journal, to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing Media`.
+
+2. Picture camera mode button. Press to switch to Picture camera mode.
+
+3. Video camera mode button is selected, and capture or record has been started.
+
+4. Audio recording mode button. Press to switch to Audio recording mode.
+
+5. Select timer button. Press this button to set a delay before capture, available delay options are, Immediate, 5 seconds, or 10 secomds.
+
+6. Timer duration button. In *Video* mode and in *Audio* mode, press to *Select duration*. Available duration options are 2, 4, 6 minutes.
 
-When you click the Video Tab, the Record Activity goes into video recording mode. Much of this process is very similar to recording photos: recorded videos show up in the tray at the bottom, you can name and tag your videos just as you name and tag photos, and you have many of the same controls for going in to fullscreen mode and navigating between video recording and viewing modes.
+7. Select quality button. In Video camera mode, press this button to select low or high quality. Experiment and choose whichever gives the best reults in your conditions.
 
-The screen capture below helps us to highlight a couple of items that are different or noteworthy in video mode. 
+8. Record is in *Sharing* mode, and we have been joined by a collaborator.
 
-.. image :: ../images/video_main.jpg 
+9. The image, which the other party shared is in the tray, identified by their characteristic colours. See also :ref:`Sharing Media`.
 
-Notice that there are two control menus. Item 1 is a delay timer just like the one used on photo mode: it lets you delay the start of recording several seconds so you can get ready in front of the camera. The duration menu (item 2) allows you to specify a maximum length for your video. In the current implementation, you can record videos of 2, 4 or 6 minutes.
+10. Time remaining bar. This is the time remaining, from the *Timer duration*, set with **6**.
+
+11. The button to stop capture and to save the video file. Once a recording has been captured, it is automaticly saved in the Journal.
+
+12. When you finish recording, the saved video clip will be represented by a thumbnail.
+
+13. When the tray is full of images, this button scrolls through the images.
+
+14. Stop, or close the application.
+
+The next section is Audio recording. However you might now prefer to follow on to :ref:`Viewing, saving and managing your work`.
 
-Once you are ready to record, click the button in item 3. When you finish recording, you should see your video show up in area 4. You can then click on the video to view it, name it, and update/view the tags assigned to the video.
 
 Audio
 -----
 
-The Record Activity also allows you to record Audio. To do so, you simply go to the Audio Tab in the Activity.
+.. image :: ../images/Record3audio.png
+
+**Toolbar and capture buttons explained**
+
+The tool bar items are just as described above.
+
+It is always a good idea to enter a name for your file **1** in the Activity tab, so that it is easier to find your work later.
+
+If you have a camera, an image **2** appears in the picture window and looks like live video. As the audio file is saved, the image is saved as a snapshot to help identify your audio recording.
+
+The Select timer and Timer duration buttons **3** are available, to set a delay before start of recording, and set the duration. You can either leave the audio recording to run for the set duration, or press the stop capture button **4** at any time.
+
+As with the photo and video modes, you see an icon for your recording **5** show up in the tray once you are done.
+
+.. _Viewing, saving and managing your work:
+
+Viewing, saving and managing your work
+--------------------------------------
 
-.. image :: ../images/recordaudio.png
- 
-If you have a camera, an image appears in the picture window and looks like live video.
+Working clock wise from the top left, shows the sequence, to save, name, and inspect an image once it has been taken. This sequence is taken in *Picture camera* mode, but the features are similar in all modes.
 
-.. image :: ../images/record.png 
+.. image :: ../images/Record1composite.png
 
-Don't worry... this is only saved as a snapshot to help identify your audio recording.
+The first screen shot, top left, shows the main image in Picture camera mode, while a picture, just taken, has been automatically saved and named in the Journal. It shows up as a thumbnail on the tray. The cursor is hovering on the thumbnail. The automaticly given, temporary name, is “Photo by Sugar Learner” **1**.
 
-The controls for audio recording are virtually identical to that of video recording. You have "Timer" and "Duration" controls that allow you to specify when and for how long your voice is recorded. You also have a tray at the bottom of the Activity that allows you to browse and view details of previously recorded audio.
-  
-To start recording press the button at the bottom: 
+When we click the thumbnail, the main image changes to *viewer* mode. Images are viewed and information can be updated.
 
-.. image :: ../images/button.png
- 
-Your recording starts:
+A field, in which to enter a title for the photo appears **2**. The title “Cornish village” is entered. Also at this point **2** is the full screen mode button. This will switch the main image to full screen.
 
-.. image :: ../images/recording.png
- 
-You can either leave the audio recording to run until it is complete or you can stop it by pressing on the same icon you pressed to start it. As with the photo and video modes, you see an icon for your recording show up once you are done. You can click this icon to edit the name and tags assigned to your new audio recording. 
+At the bottom right of the main image is a little tab, **3**, which allows you to find out more about the photo that was taken. Now pressing that tab **4** reveals the image information, author, date, and a space to add tags. A tag is a single word that helps categorize an item.
 
-To replay the audio click the icon of the recording at the bottom of the page.
+The tray displays a history of your previously taken photos. When you have more photos  in the tray the *scroll button* **5** scrolls through the images.
 
-.. image :: ../images/done.png
+To replay a video or audio recording, click the thumbnail of the recording in the tray. When viewing or listening to a clip, if you move your cursor in the main image area, you see small window **6**, representing the output of your camera or microphone. Click on that window to return from *viewer* mode to *capture* mode.
+
+The final image is displayed full screen, and can be reduced to normal with the button **7**.
+
+Record stores images and audio in the Journal, from which they can be used by other activities, such as Paint, Write, Etoys, and Browse, as well as Memorize and some other games. Images can be copied to a USB storage device from the Journal.
+
+.. _Sharing Media:
 
 Sharing Media
 -------------
 
-You can share photos, video and audio recordings (these can just be referred to as 'media') with your friends. To share media you must first have some media in the bottom tray. In our example we have the image of a Bison (see below) in the tray. Now select the Activity Tab on the left and the Record Activity looks something like this:
+You can share photos, video and audio recordings (these can just be referred to as 'media') with your friends.
 
-.. image :: ../images/sharing_2.png 
+.. image :: ../images/Record4.png
 
-You then see on the right the text "Share with:". To the right of this is a drop-down menu. Change the selection here to "My Neighborhood" as shown: 
- 
-.. image :: ../images/sharing_3.png
+To share media you must first have some media in the tray. We have the image of a Bison in the tray.
 
-Others looking at the Neighborhood View see your icon with an 'eye' (the Record Activity icon) next to it: 
- 
-.. image :: ../images/sharing_4.png
+The Activity tab has been opened, the collaboraton button is pressed and "My Neighborhood" selected.
 
-Others can now join your Activity and you can share your media with them. 
+Share, and join Record
+::::::::::::::::::::::
 
-Joining the Record Activity
-:::::::::::::::::::::::::::
+.. image :: ../images/Record5.png
 
-Once you have shared your Record Activity others need to do the following to join.  
-From the Neighborhood View, they need to click the 'eye' icon next to your icon:
+Once you have made your Activity available to share, others, looking at their Neighborhood View, see your icon with the Record icon, an eye, close to it. They can now join your Activity by clicking on the Record icon next to your icon.
 
-.. image :: ../images/sharing_5.png 
+They must then select "Join" and their Record Activity opens with your images in their tray.
 
-They must then choose 'Join' and their Record Activity opens with your images in their tray. In the Record Activity, thumbnails of photographs are shared.  The photograph's frame is in the same colors as the XO icon of the person who took the photo.
+Now in Record, thumbnails of both parties are shared.  The frame of the thumbnail is in the same colors as the XO icon of the person who took the photo.
 
-On your Frame, you can see the icons of all of the people with whom you are collaborating. You can also see their shared media.
+Images shared
+:::::::::::::
 
-.. image:: ../images/sharing_7a.png 
+.. image:: ../images/Record6.png
+
+On your Frame, you can see the icons of all of the people with whom you are collaborating. You can also see their shared media.
 
 You can exit a shared Activity at any time.
 
+|more| :doc:`/collaborating` has more information on sharing work in Sugar.
+
+.. |more| image:: ../images/more.png
+
+Getting creative with Record
+-----------------------------
+
+Record can be used for :
+
+* Taking pictures.
+* Recording video.
+* Recording audio.
+* Stop-motion photography.
+* Time-lapse photography.
+* Creating 360° panoramas.
+* Viewing slide shows.
+* Storing extra information about audio, video, and pictures.
+
 Things to Try with Record
 -------------------------
- 
-You can easily take pictures and make videos by using a built-in camera for still photography and video recording. You can also use the camera for video conferencing, which involves talking to others on a video screen knowing that the others can also view your video.
 
-You can express yourself with sound, images, and video using the cameras and microphones. You are learning about light, observations, angle, and perspective.
-By recording the sights and sounds around you, others can learn about you, your culture, and environment. You can communicate with your voice and pictures. You can tell factual or emotional stories with film or pictures to help change perceptions or take action.
+You can easily take pictures and make videos by using a built-in, or connected, camera for still photography and video recording. You can also use the camera for video conferencing, which involves talking to others on a video screen knowing that the others can also view your video.
+
+You can express yourself with sound, images, and video using the cameras and microphones. You are learning about light, observations, angle, and perspective. By recording the sights and sounds around you, others can learn about you, your culture, and environment. You can communicate with your voice and pictures. You can tell factual or emotional stories with film or pictures to help change perceptions or take action.
 
 You could also try some of the following : 
 
 * Use the Record Activity to record your voice with a built-in microphone.
-* Take a photo of where you live by aiming the camera lens at your home, and then clicking the circle icon. 
+* Take a photo of where you live by aiming the camera lens at your home, and then clicking the circle icon.
 * Record sounds of your city or town.
 * Record and leave messages for your family.
-* Teachers - record a message for parents. 
-* Interview your friends and record it to audio or video. 
+* Teachers - record a message for parents.
+* Interview your friends and record it to audio or video.
 * Make a video diary.
 * Open your photos in the Paint Activity and draw on them.
 * Add your pictures to a story using Write.
 * Upload a picture to Flickr or Wikimedia Commons.
 * Attach a picture to an e-mail you send to a friend or family member.
 * Take a picture of a flower or plant from the same place every day to show how it changes.
-* Take a picture of a baby animal every week to show how it grows. 
+* Take a picture of a baby animal every week to show how it grows.