Commit 51081780 authored by Julita Inca's avatar Julita Inca Committed by Ekaterina Gerasimova

help: Added Mallard help, removed DocBook help

Help written by Julita Inca during her outreach program:
http://lleksah.wordpress.com/2011/08/17/11th-report/, and taken from
https://gitorious.org/cheese-docs

https://bugzilla.gnome.org/show_bug.cgi?id=658301
parent cdb2a33c
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="apply-effects">
<info>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<link type="guide" xref="index"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Add fun effects to your photos and videos, like turning yourself green or distorting the picture like a funhouse mirror.</desc>
</info>
<title>Apply effects to photos and videos</title>
<p>You can apply fun, interesting effects to your photos and videos:</p>
<steps>
<item><p>Click <gui>Effects</gui>.</p></item>
<item>
<p>Select the effect you want by clicking one of the options.</p>
<p>You can select multiple effects if you like. For example, if you select Hulk and Kun-Fu, the picture will be altered to have a green shade and be upside down.</p>
</item>
<item>
<p>Click <gui>Effects</gui> to hide the effects menu and bring you back to the normal view.</p>
</item>
</steps>
<p><app>Cheese</app> offers 34 effects, of which only 9 are shown by default. If you want see more, click <gui>Next Effects</gui> and <gui>Previous Effects</gui> to get back again. These are some of them, from left to right: Bulge, Edge and Mirror.</p>
<p><media type="image" src="figures/effects.png" width="840" height="320"/></p>
<note style="tip"><p>To remove any effects that you added, click <gui>Effects</gui> and select <gui>No Effect</gui>.</p></note>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="burst-mode">
<info>
<link type="guide" xref="index#multiple-photos"/>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Burst Mode takes several photos in a short space of time. Change your pose in between each shot!</desc>
</info>
<title>Take multiple photos in rapid succession</title>
<p>You can use Burst Mode to automatically take several photos in one go, with a short pause between each shot. It's particularly fun if you change your pose in between pictures! To use Burst Mode:</p>
<steps>
<item>
<p>Click the small button that looks like a stack of photos in the lower left of the Cheese window. If you clicked the right one, the button in the center of the window should now say <gui>Take Multiple Photos</gui>.</p>
<p>Alternatively, click <guiseq><gui>Cheese</gui><gui>Burst</gui></guiseq>.</p>
</item>
<item>
<p>Click <gui>Take Multiple Photos</gui> or press the <key>spacebar</key>.</p>
<p>By default, four photos will be taken, with a three second delay between each photo. You'll see a countdown before each photo is taken.</p>
</item>
</steps>
<p>Press <key>Esc</key> if you want to stop Cheese from taking photos at any point.</p>
<section id="burst-preferences">
<title>Change how many photos are taken, and the delay between shots</title>
<p>You can change how many photos should be taken in each burst, and the length of the pause between photos:</p>
<steps>
<item>
<p>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>.</p>
</item>
<item>
<p>Change the options under <gui>Burst mode</gui> and click <gui>Close</gui>.</p>
</item>
</steps>
</section>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="card-graphic">
<info>
<revision version="3.0" date="2011-08-24" status="stub"/>
<link type="guide" xref="index#problems-section"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>XXXXX</desc>
</info>
<title>Graphics card support</title>
<comment>
<cite date="2011-08-24" href="mailto:philbull@gmail.com">Phil Bull</cite>
<p>This is a stub topic.</p>
</comment>
</page>
This diff is collapsed.
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="closed">
<info>
<revision version="3.0" date="2011-08-24" status="incomplete"/>
<link type="guide" xref="index#problems"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>The application closes itself after a while sometimes.</desc>
</info>
<title>Why does Cheese close itself when I don't want it to?</title>
<comment>
<cite>Phil Bull</cite>
<p>These instructions are potentially dangerous. They ask a user to become root!</p>
</comment>
<p>Terminal is the best debug tool; so, run <app>Cheese</app> in terminal and check if you got this output:</p>
<p><code>$ cheese</code></p>
<p><code>progname=cheese; RGBA=on
The program 'cheese' received an X Window System error.
This probably reflects a bug in the program.
The error was 'BadMatch (invalid parameter attributes)'.
(Details: serial 77 error_code 8 request_code 132 minor_code 19)
(Note to programmers: normally, X errors are reported asynchronously;
that is, you will receive the error a while after causing it.
To debug your program, run it with the --sync command line
option to change this behavior. You can then get a meaningful
backtrace from your debugger if you break on the gdk_x_error() function.)
?
</code></p>
<note style="important"><p>Before following the instructions to get a solution, you have to ask an expert of administration of Linux, becuase doing some changes as a superuser can cause some other changes in the system:</p></note>
<steps>
<item>
<p>To edit <gui>gtkrgba.sh</gui> as a root, open your terminal and type:</p>
<code>sudo gedit /etc/profile.d/gtkrgba.sh</code></item>
<item><p>You will see a list of applications that use rgba.</p>
<p>If you don't see <gui>Cheese</gui> in the list, append <gui>":cheese".</gui>
Be careful, it is <gui>“:”</gui> before <gui>"cheese"</gui>.
(See the last word in the last line):</p>
<p><code>export GTK_MODULES=rgba
export GTK_RGBA_APPS=allbut:firefox:firefox-3.5:gksudo:ooffice:soffice:inksca\
pe:gksu:gtk-recordMyDesktop:kompozer-bin:gpaint:lernid:totem:truecrypt:thunde\
rbird-bin:thunderbird:checkgmail:gloobus-preview:exe:firefox-bin:swiftfox-bin\
:gnome-mplayer:gnome-screensaver:google-chrome:chromium-browser:prism-bin:gno\
me-mplayer:xsane:metacity:mutter:Banshee:cheese </code></p></item>
<item><p>Save it and run <gui>Cheese</gui> by terminal. </p></item>
</steps>
<p>Source of the solution: <link href="http://www.ubuntu-es.org/node/129987">Ubuntu-es</link>, <link href="http://zaybort.linuxerz.org/2011/02/problemas-con-el-cheese/">Zaybort blog</link> and <link href="http://ubuntuforums.org/showthread.php?t=1754098">Ubuntu forums</link>. If you don't have the rgba package, click <link href= "https://wiki.ubuntu.com/DesktopTeam/RgbaGtkWithPPA">here</link>.</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="delete-photo">
<info>
<link type="guide" xref="index" group="#last"/>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Remove photos and videos that you don't want any more.</desc>
</info>
<title>Delete a photo or video</title>
<p>If you don't want a photo or video anymore, you can permanently delete it:</p>
<steps>
<item>
<p>Find the photo or video that you want to delete in the photo stream at the bottom of the Cheese window.</p>
</item>
<item>
<p>Right-click it and select <gui>Delete</gui>. Alternatively,
click it once to select it and press <key>Delete</key>.</p>
</item>
<item>
<p>You will be asked if you want to permanently delete it. Click <gui>Delete</gui> if you do; you will not be able to recover the photo.</p>
</item>
</steps>
<p>If you're not sure if you want to permanently delete the photo or video, you can right click it and select <gui>Move to Trash</gui> instead. This will put it in your computer's main <file>Trash</file> folder. (Cheese doesn't have its own Trash folder, and you can't access the computer's main Trash from within Cheese.)</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="disable-countdown">
<info>
<link type="guide" xref="index#advanced" group="#last"/>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Click <guiseq><gui>Cheese</gui><gui>Countdown</gui></guiseq> to disable the countdown.</desc>
</info>
<title>Disable the "Countdown" before photos are taken</title>
<p>By default, Cheese counts down from three before taking a photo. You can stop this from happening by clicking <guiseq><gui>Cheese</gui><gui>Countdown</gui></guiseq>, so that <gui>Countdown</gui> is unchecked.</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="disable-flash">
<info>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<link type="guide" xref="index#advanced"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Click <guiseq><gui>Cheese</gui><gui>Flash</gui></guiseq> so that <gui>Flash</gui> is unchecked.</desc>
</info>
<title>Stop the flash from firing</title>
<p>When you take a photo with Cheese, the computer screen briefly turns white. This is designed to provide something like a camera flash, to illuminate the scene better.</p>
<p>You can disable this if you like. Click <guiseq><gui>Cheese</gui><gui>Flash</gui></guiseq> so that <gui>Flash</gui> is unchecked.</p>
</page>
This diff is collapsed.
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="full-screen">
<info>
<revision version="3.0" date="2011-08-24" status="stub"/>
<link type="guide" xref="index#advanced-section"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>XXXX</desc>
</info>
<title>Full Screen</title>
<comment>
<cite date="2011-07-09" href="mailto:yrazes@gmail.com">Julita Inca</cite>
<p>This assumes the reader knows how to.... By the end of this page,
the reader will be able to....</p>
</comment>
<p>Short introductory text...</p>
<steps>
<item><p>First step...</p></item>
<item><p>Second step...</p></item>
<item><p>Third step...</p></item>
</steps>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="image-properties">
<info>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<link type="guide" xref="index#problems"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Adjust the saturation, contrast, brightness, and hue to make photos and videos look better.</desc>
</info>
<title>My photos/videos are too dark, or the colors don't look right</title>
<p>If your photos or videos are too dark or the colors seem to be wrong, try adjusting the saturation, contrast, brightness, and hue of them:</p>
<steps>
<item>
<p>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>.</p>
</item>
<item>
<p>Under <gui>Image properties</gui>, change the sliders to find the best settings for your webcam.</p>
</item>
<item>
<p>Click <gui>Close</gui> and check to see if the picture looks OK now.</p>
</item>
</steps>
<p>Here are some tips on using the different options under <gui>Image properties</gui> (from left to right): Applying brightness, contrast, hue and saturation. <media type="image" src="figures/image-properties.png" width="800" height="150"/></p>
<terms>
<item>
<title>Brightness</title>
<p>Increasing the brightness will make the picture lighter. If you are in a dark room, however, increasing the brightness might just make the picture look more "noisy" (covered in speckles).</p>
</item>
<item>
<title>Contrast</title>
<p>Choosing a higher contrast will make dark colors and lighter or neutral colors more distinct from one another. If the picture looks washed out, try increasing the contrast.</p>
</item>
<item>
<title>Hue</title>
<p>Changing the hue of the picture will add a tint to it. If pictures seem to be the wrong color (for example, too yellow), try changing the hue.</p>
</item>
<item>
<title>Saturation</title>
<p>Reducing the saturation makes the picture less colorful. If colors seem too harsh, reduce the saturation.</p>
</item>
</terms>
</page>
<page xmlns="http://projectmallard.org/1.0/"
xmlns:e="http://projectmallard.org/experimental/"
type="guide" style="task"
id="index">
<info>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<title type="link">Cheese Webcam Booth</title>
<title type="text">Cheese Webcam Booth</title>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Cheese lets you take pictures and make videos using your webcam. You can even add special effects!</desc>
</info>
<title>
<media type="image" mime="image/png" src="figures/cheese.png" width="40" height="40">
Cheese Webcam Booth logo
</media>
Cheese Webcam Booth
</title>
<links type="topic" style="mouseovers"
groups="introduction take-photo record-video
apply-effects save-photo delete-photo">
<e:mouseover src="figures/cheese-introduction.png"/>
<e:mouseover match="introduction" src="figures/cheese-introduction.png"/>
<e:mouseover match="take-photo" src="figures/cheese-take.png"/>
<e:mouseover match="record-video" src="figures/cheese-record.png"/>
<e:mouseover match="apply-effects" src="figures/cheese-effects.png"/>
<e:mouseover match="save-photo" src="figures/cheese-save.png"/>
<e:mouseover match="delete-photo" src="figures/cheese-delete.png"/>
</links>
<section id="advanced" style="2column">
<title>Settings</title>
</section>
<section id="problems">
<title>Common problems and questions</title>
</section>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="introduction">
<info>
<link type="guide" xref="index" group="#first"/>
<revision version="3.0" date="2011-08-24" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Introduction to the <app>Cheese Webcam Booth.</app></desc>
</info>
<title>Introduction</title>
<p>Cheese is a fun webcam booth application which lets you take photos and record videos using your webcam. By using Cheese, you can make funny, original photos and videos that you can easily share with others. It can take multiple photos in quick succession (using <link xref="burst-mode">burst mode</link>), and lets you <link xref="apply-effects">apply effects</link> that add a special, fancy, or funny touch to your photos and videos.</p>
<p>By default, Cheese starts in <gui>Photo Mode</gui>, ready to <link xref="take-photo">take a photo</link>. You need to switch to Video Mode to <link xref="record-video">record a video</link>, or switch to Burst Mode to <link xref="burst-mode">take multiple photos at once</link>.</p>
<p>Cheese works with most webcams, but if your particular make and model doesn't seem to work properly, see <link xref="webcams">Webcams</link> for advice on getting it to function.</p>
</page>
<legalnotice id="legalnotice">
<para>
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation
License (GFDL), Version 1.1 or any later version published
by the Free Software Foundation with no Invariant Sections,
no Front-Cover Texts, and no Back-Cover Texts. You can find
a copy of the GFDL at this <ulink type="help"
url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
distributed with this manual.
</para>
<para> This manual is part of a collection of GNOME manuals
distributed under the GFDL. If you want to distribute this
manual separately from the collection, you can do so by
adding a copy of the license to the manual, as described in
section 6 of the license.
</para>
<para>
Many of the names used by companies to distinguish their
products and services are claimed as trademarks. Where those
names appear in any GNOME documentation, and the members of
the GNOME Documentation Project are made aware of those
trademarks, then the names are in capital letters or initial
capital letters.
</para>
<para>
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
WITH THE FURTHER UNDERSTANDING THAT:
<orderedlist>
<listitem>
<para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
THAT THE DOCUMENT OR MODIFIED VERSION OF THE
DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
OF THE DOCUMENT OR MODIFIED VERSION OF THE
DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
EXCEPT UNDER THIS DISCLAIMER; AND
</para>
</listitem>
<listitem>
<para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
PARTIES, BE LIABLE TO ANY PERSON FOR ANY
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES OF ANY CHARACTER
INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
LOSSES ARISING OUT OF OR RELATING TO USE OF THE
DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
THE POSSIBILITY OF SUCH DAMAGES.
</para>
</listitem>
</orderedlist>
</para>
</legalnotice>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="no-device">
<info>
<revision version="3.0" date="2011-08-24" status="incomplete"/>
<link type="guide" xref="index#problems" group="#first"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>It started saying that it didn't recognize your webcam device.</desc>
</info>
<title>Why does it say "No device found"?</title>
<comment>
<cite>Phil Bull</cite>
<p>There are more possible reasons for why the webcam isn't detected properly. This topic needs to be expanded.</p>
</comment>
<p>If it says "No device found" when you open Cheese, it means that your webcam was not detected properly. Try the following suggestions to get it to recognize your webcam:</p>
<list>
<item>
<p>Make sure that the webcam's power switch is on, if it has one. Also, some laptops have a switch/key to enable/disable the webcam; so, check that the power lead is plugged in firmly too. A good way of checking that the webcam is working properly is to plug it into another computer to see if it's detected.</p>
</item>
<item>
<p>Some webcams need extra software to be installed before they can work. This is called a <em>device driver</em>, and whether you need one or not will depend on your . Install a device driver for your video card. Find your driver in <link href="http://www.logitech.com">Logitech website</link> or <link href="http://www.ideasonboard.org/uvc/">here</link>.</p>
</item>
<item><p>If you still have some problems, check all packages that are necessary for running <app>Cheese</app>. See more in <link xref="webcams">webcams</link>.</p></item>
</list>
<note style="advanced">
<p>See more troubleshootings related in <link href="http://ubuntuforums.org/archive/index.php/t-1703909.html">Ubuntu forums</link>,
<link href="http://askubuntu.com/questions/3222/my-webcam-wont-work-how-do-i-debug">Q/A Ubuntu</link> and
<link href="https://answers.launchpad.net/ubuntu/+source/cheese/+question/154094">here</link>.
Check also for Fedora <link href="http://forums.fedoraforum.org/showthread.php?t=251050">here</link>
</p>
</note>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="record-video">
<info>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<link type="guide" xref="index" group="#middle"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Use your webcam to record short movies that you can share with friends.</desc>
</info>
<title>Record a video</title>
<p>To record a video using your webcam:</p>
<steps>
<item>
<p>Make sure that you are in <gui>Video Mode</gui>; if you are, the button in the middle of the window will say <gui>Start Recording</gui>.</p>
<p>You can switch to Video Mode by clicking the small film strip icon in the bottom left of the screen, or by clicking <guiseq><gui>Cheese</gui><gui>Video</gui></guiseq>.</p>
</item>
<item>
<p>Click <gui>Start Recording</gui>, or press the <key>spacebar</key>. Cheese will start recording from your webcam.</p>
</item>
<item>
<p>To stop recording, click <gui>Stop Recording</gui> or press <key>Esc</key>.</p>
</item>
</steps>
<p>Videos are saved in the Ogg Theora (<file>.ogv</file>) format.</p>
<p>After you've stopped recording, the video will automatically appear in the photo stream at the bottom of the Cheese window. From here, you can <link xref="view-photo">play back the video</link>, upload it to a social network, post it in your blog or YouTube channel, or share it with friends by <link href="ghelp:gnome-help/#web-default-email">email</link>.</p>
<p>If you have problems sharing a video with people using other operating systems (like Windows or Mac OS), you may need to <link href="ghelp:gnome-help/#video-sending">convert it to a different format</link>.</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="resolution-photo">
<info>
<link type="guide" xref="index#advanced"/>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>The resolution of a video or photo determines how much detail you can see in it.</desc>
</info>
<title>Change the webcam resolution</title>
<p>The resolution of a photo or video tells you how many <em>pixels</em> the picture is made up of. The higher the resolution, the more pixels, and the more detail you should be able to see. Higher resolution generally means better quality pictures.</p>
<p>Photos and videos with higher resolution take up more space on your hard disk, however. High resolution videos, in particular, take up a lot of space.</p>
<p>If you want to save on disk space, reduce the resolution of your webcam. If you want better quality pictures, increase the resolution. To change the webcam resolution:</p>
<steps>
<item><p>Click <guiseq><gui>Edit</gui><gui>Preferences</gui></guiseq>.</p></item>
<item><p>Choose a different <gui>resolution</gui> from the drop-down list. Some webcams only support one resolution, so you may not have a choice.</p></item>
<item><p>Click <gui>Close</gui>.</p></item>
</steps>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="save-photo">
<info>
<link type="guide" xref="index"/>
<revision version="3.0" date="2011-08-25" status="review"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Right-click the picture and click <gui>Save As</gui>.</desc>
</info>
<title>Save a photo or video in a different folder</title>
<p>By default, Cheese saves the photos and videos that are in the photo stream in the <guiseq><gui>Pictures</gui><gui>Webcam</gui></guiseq> and <guiseq><gui>Videos</gui><gui>Webcam</gui></guiseq> folders in your Home folder.</p>
<p>To save a picture to a different location, right-click the picture in the photo stream and click <gui>Save As</gui>. Then, choose where you want to save the picture.</p>
<p>Alternatively, open the folder where you want to put the picture using the file manager, and then drag it from the photo stream into that folder.</p>
<!-- Please review this statement -->
<p>A new copy of the picture will be saved in that location. The old version will remain in the <guiseq><gui>Pictures</gui><gui>Webcam</gui></guiseq> or <guiseq><gui>Videos</gui><gui>Webcam</gui></guiseq> folder.</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="take-photo">
<info>
<link type="guide" xref="index" group="#first"/>
<link type="seealso" xref="disable-flash"/>
<link type="seealso" xref="disable-countdown"/>
<link type="seealso" xref="view-photo"/>
<link type="seealso" xref="delete-photo"/>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Take a photo to freeze any moment in life or record a video if you are really going to go back and watch it over and over.</desc>
</info>
<title>Take photos with the webcam</title>
<p>Webcams can be used to take still photos, as well as videos. To take a photo:</p>
<steps>
<item>
<p>Make sure that you're in Photo Mode. If you are, the button in the middle of the screen will say <gui>Take a Photo</gui>.</p>
<p>To switch to Photo Mode, click the small photo button in the bottom left of the window, or click <guiseq><gui>Cheese</gui><gui>Photo</gui></guiseq>.</p>
</item>
<item>
<p>Click <gui>Take a Photo</gui> or press the <key>Spacebar</key>.</p>
</item>
<item>
<p>There will be a short countdown, followed by a flash, and then the photo will appear in the <em>photo stream</em> at the bottom of the window.</p>
</item>
</steps>
<p>The photos in the photo stream are automatically saved in the <guiseq><gui>Pictures</gui><gui>Webcam</gui></guiseq> folder in your Home folder. They are saved in the JPEG (<filename>.jpg</filename>) format.</p>
<p>To cancel taking a photo after you have clicked <gui>Take a Photo</gui>, press <key>Esc</key> before the countdown finishes.</p>
<note>
<p>To take multiple photos in rapid succession, use <link xref="burst-mode">Burst Mode</link>.</p>
</note>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="view-photo">
<info>
<link type="guide" xref="index#photo-video"/>
<revision version="3.0" date="2011-08-25" status="candidate"/>
<credit type="author copyright">
<name>Julita Inca</name>
<email>yrazes@gmail.com</email>
<years>2011</years>
</credit>
<desc>Photos and videos will automatically appear in the photo stream.</desc>
</info>
<title>View a photo or video that you took</title>
<p>After you take a photo or record a video, it will appear in the <em>photo stream</em> at the bottom of the window.</p>
<p>If you want to see a bigger version of a photo, or play a video, double-click it. This will open it in the default photo viewer or video player.</p>
<p>All of the photos and videos in the photo stream are saved in the <guiseq><gui>Pictures</gui><gui>Webcam</gui></guiseq> or <guiseq><gui>Videos</gui><gui>Webcam</gui></guiseq> folders in your Home folder.</p>
</page>
<page xmlns="http://projectmallard.org/1.0/"
type="topic" style="task"
id="webcams">
<info>
<revision version="3.0" date="2011-08-25" status="incomplete"/>
<link type="guide" xref="index#problems"/>
<credit type="author copyright">