GNOME.org
 

[cheese] help: Added Mallard help, removed DocBook help

commit 510817801372f41fcba4f4a6cb0af9d9387b24dc
Author: Julita Inca <yrazes gmail com>
Date:   Mon Sep 5 19:19:38 2011 +0200

    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

 help/C/apply-effects.page              |   34 ++
 help/C/burst-mode.page                 |   47 ++
 help/C/card-graphic.page               |   26 ++
 help/C/cheese.xml                      |  757 --------------------------------
 help/C/closed.page                     |   57 +++
 help/C/delete-photo.page               |   36 ++
 help/C/disable-countdown.page          |   21 +
 help/C/disable-flash.page              |   22 +
 help/C/figures/cheese-delete.png       |  Bin 0 -> 46955 bytes
 help/C/figures/cheese-effects.jpg      |  Bin 255229 -> 0 bytes
 help/C/figures/cheese-effects.png      |  Bin 0 -> 36419 bytes
 help/C/figures/cheese-fullscreen.jpg   |  Bin 677517 -> 0 bytes
 help/C/figures/cheese-introduction.png |  Bin 0 -> 55172 bytes
 help/C/figures/cheese-main.jpg         |  Bin 328542 -> 0 bytes
 help/C/figures/cheese-preferences.jpg  |  Bin 47428 -> 0 bytes
 help/C/figures/cheese-record.png       |  Bin 0 -> 43617 bytes
 help/C/figures/cheese-save.png         |  Bin 0 -> 48237 bytes
 help/C/figures/cheese-share.jpg        |  Bin 327784 -> 0 bytes
 help/C/figures/cheese-take.png         |  Bin 0 -> 43922 bytes
 help/C/figures/cheese-wide.jpg         |  Bin 335183 -> 0 bytes
 help/C/figures/cheese.png              |  Bin 0 -> 11925 bytes
 help/C/figures/effects.png             |  Bin 0 -> 2079569 bytes
 help/C/figures/image-properties.png    |  Bin 0 -> 250073 bytes
 help/C/figures/settings.png            |  Bin 0 -> 38999 bytes
 help/C/full-screen.page                |   33 ++
 help/C/image-properties.page           |   54 +++
 help/C/index.page                      |   45 ++
 help/C/introduction.page               |   26 ++
 help/C/legal.xml                       |   76 ----
 help/C/no-device.page                  |   43 ++
 help/C/record-video.page               |   38 ++
 help/C/resolution-photo.page           |   32 ++
 help/C/save-photo.page                 |   28 ++
 help/C/take-photo.page                 |   47 ++
 help/C/view-photo.page                 |   26 ++
 help/C/webcams.page                    |   33 ++
 help/C/wide-mode.page                  |   27 ++
 37 files changed, 675 insertions(+), 833 deletions(-)
---
diff --git a/help/C/apply-effects.page b/help/C/apply-effects.page
new file mode 100644
index 0000000..868d051
--- /dev/null
+++ b/help/C/apply-effects.page
@@ -0,0 +1,34 @@
+<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>
diff --git a/help/C/burst-mode.page b/help/C/burst-mode.page
new file mode 100644
index 0000000..8aafefe
--- /dev/null
+++ b/help/C/burst-mode.page
@@ -0,0 +1,47 @@
+<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>
diff --git a/help/C/card-graphic.page b/help/C/card-graphic.page
new file mode 100644
index 0000000..0807930
--- /dev/null
+++ b/help/C/card-graphic.page
@@ -0,0 +1,26 @@
+<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>
diff --git a/help/C/closed.page b/help/C/closed.page
new file mode 100644
index 0000000..8d72212
--- /dev/null
+++ b/help/C/closed.page
@@ -0,0 +1,57 @@
+<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>
diff --git a/help/C/delete-photo.page b/help/C/delete-photo.page
new file mode 100644
index 0000000..1566af0
--- /dev/null
+++ b/help/C/delete-photo.page
@@ -0,0 +1,36 @@
+<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>
diff --git a/help/C/disable-countdown.page b/help/C/disable-countdown.page
new file mode 100644
index 0000000..bcf0f78
--- /dev/null
+++ b/help/C/disable-countdown.page
@@ -0,0 +1,21 @@
+<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>
diff --git a/help/C/disable-flash.page b/help/C/disable-flash.page
new file mode 100644
index 0000000..76b1263
--- /dev/null
+++ b/help/C/disable-flash.page
@@ -0,0 +1,22 @@
+<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>
diff --git a/help/C/figures/cheese-delete.png b/help/C/figures/cheese-delete.png
new file mode 100644
index 0000000..e292359
Binary files /dev/null and b/help/C/figures/cheese-delete.png differ
diff --git a/help/C/figures/cheese-effects.png b/help/C/figures/cheese-effects.png
new file mode 100644
index 0000000..03df758
Binary files /dev/null and b/help/C/figures/cheese-effects.png differ
diff --git a/help/C/figures/cheese-introduction.png b/help/C/figures/cheese-introduction.png
new file mode 100644
index 0000000..07d50fc
Binary files /dev/null and b/help/C/figures/cheese-introduction.png differ
diff --git a/help/C/figures/cheese-record.png b/help/C/figures/cheese-record.png
new file mode 100644
index 0000000..240e428
Binary files /dev/null and b/help/C/figures/cheese-record.png differ
diff --git a/help/C/figures/cheese-save.png b/help/C/figures/cheese-save.png
new file mode 100644
index 0000000..bddaad2
Binary files /dev/null and b/help/C/figures/cheese-save.png differ
diff --git a/help/C/figures/cheese-take.png b/help/C/figures/cheese-take.png
new file mode 100644
index 0000000..7ff63db
Binary files /dev/null and b/help/C/figures/cheese-take.png differ
diff --git a/help/C/figures/cheese.png b/help/C/figures/cheese.png
new file mode 100644
index 0000000..8a1c226
Binary files /dev/null and b/help/C/figures/cheese.png differ
diff --git a/help/C/figures/effects.png b/help/C/figures/effects.png
new file mode 100644
index 0000000..2d6b683
Binary files /dev/null and b/help/C/figures/effects.png differ
diff --git a/help/C/figures/image-properties.png b/help/C/figures/image-properties.png
new file mode 100644
index 0000000..53cddd5
Binary files /dev/null and b/help/C/figures/image-properties.png differ
diff --git a/help/C/figures/settings.png b/help/C/figures/settings.png
new file mode 100644
index 0000000..50004d1
Binary files /dev/null and b/help/C/figures/settings.png differ
diff --git a/help/C/full-screen.page b/help/C/full-screen.page
new file mode 100644
index 0000000..79d8915
--- /dev/null
+++ b/help/C/full-screen.page
@@ -0,0 +1,33 @@
+<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>
diff --git a/help/C/image-properties.page b/help/C/image-properties.page
new file mode 100644
index 0000000..eced506
--- /dev/null
+++ b/help/C/image-properties.page
@@ -0,0 +1,54 @@
+<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>
diff --git a/help/C/index.page b/help/C/index.page
new file mode 100644
index 0000000..5adccc8
--- /dev/null
+++ b/help/C/index.page
@@ -0,0 +1,45 @@
+<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>
diff --git a/help/C/introduction.page b/help/C/introduction.page
new file mode 100644
index 0000000..50f70a1
--- /dev/null
+++ b/help/C/introduction.page
@@ -0,0 +1,26 @@
+<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>
diff --git a/help/C/no-device.page b/help/C/no-device.page
new file mode 100644
index 0000000..056c275
--- /dev/null
+++ b/help/C/no-device.page
@@ -0,0 +1,43 @@
+<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>
diff --git a/help/C/record-video.page b/help/C/record-video.page
new file mode 100644
index 0000000..4c57b00
--- /dev/null
+++ b/help/C/record-video.page
@@ -0,0 +1,38 @@
+<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>
diff --git a/help/C/resolution-photo.page b/help/C/resolution-photo.page
new file mode 100644
index 0000000..70169c2
--- /dev/null
+++ b/help/C/resolution-photo.page
@@ -0,0 +1,32 @@
+<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>
diff --git a/help/C/save-photo.page b/help/C/save-photo.page
new file mode 100644
index 0000000..0b7dad7
--- /dev/null
+++ b/help/C/save-photo.page
@@ -0,0 +1,28 @@
+<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>
diff --git a/help/C/take-photo.page b/help/C/take-photo.page
new file mode 100644
index 0000000..59e9200
--- /dev/null
+++ b/help/C/take-photo.page
@@ -0,0 +1,47 @@
+<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>
diff --git a/help/C/view-photo.page b/help/C/view-photo.page
new file mode 100644
index 0000000..a85387d
--- /dev/null
+++ b/help/C/view-photo.page
@@ -0,0 +1,26 @@
+<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>
diff --git a/help/C/webcams.page b/help/C/webcams.page
new file mode 100644
index 0000000..71429e7
--- /dev/null
+++ b/help/C/webcams.page
@@ -0,0 +1,33 @@
+<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">
+      <name>Julita Inca</name>
+      <email>yrazes gmail com</email>
+      <years>2011</years>
+    </credit>
+
+    <desc>There is a list of some webcams and drivers that works good with Cheese.</desc>
+  </info>
+
+<title>I have no image on my Cheese screen</title>
+
+<comment>
+ <cite>Phil Bull</cite>
+ <p>This topic needs cleaning up a little. It needs to explain the problem (and what the user would expect to see if they had that problem) more clearly. There should also be a stronger division between different solutions, and more explanation of what each solution is trying to address.</p>
+</comment>
+
+<p>Maybe you are trying to open up <app>Cheese</app> and it does not display the picture from the webcam, even though the webcam light is on. To get your camera working with <app>Cheese</app> follow these recommendations:</p>
+<steps>
+<item>
+<p>First, you will have to ensure that it works with the <link href="http://gstreamer.freedesktop.org/";>Gstreamer Framework</link> (i.e.<link href="http://linux-galaxy.blogspot.com/2011/06/cheese-faltan-uno-o-mas-elementos.html";> installation</link>) and Video4Linux2 (V4L2) or Video4Linux (V4L). See some packages <link href="https://launchpad.net/~libv4l/+archive/ppa?field.series_filter=maverick";>here</link>. To
+test this, you can use the 'gstreamer-properties' tool or use this <link href="http://testwebcam.com";>page</link>.</p></item>
+<item><p>If the problem persists, check if your video card has the specific driver. Most of the time, general drivers are installed or detected by default instead of the specific one. To know what driver you need, see the <link href="http://en.gentoo-wiki.com/wiki/Webcam#Webcam_driver";>wiki webcam</link> or check the <link href="http://linuxcommand.org/man_pages/lsusb8.html";>lsusb command</link>; and search your webcam driver in <link href="http://www.logitech.com";>Logitech</link> or <link href="http://www.ideasonboard.org/uvc/";>Linux UVC</link>.</p></item> 
+<item><p>Finally, if the problem continues, change the <link xref="resolution-photo">resolution</link> setting of the camera. Some applications can't detect the camera's resolution, so they put by defatult a diferent resolution of your webcam in the initial configuration.</p></item> 
+</steps>
+<p>See some <link href="https://wiki.ubuntu.com/SkypeWebCams?highlight=%28cheese%29";>webcams tested in Ubuntu</link> and <link href="http://building-a-black-hole.blogspot.com";>some experiences</link> with the <app>Cheese technology</app>.</p>
+</page>
diff --git a/help/C/wide-mode.page b/help/C/wide-mode.page
new file mode 100644
index 0000000..be298b0
--- /dev/null
+++ b/help/C/wide-mode.page
@@ -0,0 +1,27 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="wide-mode">
+  <info>
+	<revision version="3.0" date="2011-08-25" status="candidate"/>
+	<link type="guide" xref="index#advanced" group="#first"/>
+ 
+    <credit type="author copyright">
+      <name>Julita Inca</name>
+      <email>yrazes gmail com</email>
+      <years>2011</years>
+    </credit>
+
+    <desc>Change the position of the photo stream so that the webcam video feed is larger.</desc>
+  </info>
+
+  <title>Make the webcam video preview bigger</title>
+
+<p>The <em>photo stream</em> is where photos and videos appear after you have taken/recorded them. By default, it is a horizontal strip at the bottom of the Cheese window.</p>
+  
+<p>You can make the photo stream appear as a vertical bar instead. This is useful if you have a wide computer screen that is not very high; switching to a vertical layout means that there is more room to display the video feed from the webcam.</p>
+
+<p>To switch to a vertical layout, click <guiseq><gui>Cheese</gui><gui>Wide Mode</gui></guiseq>. To switch back to a horizontal layout, do the same thing.</p>
+
+<p>Another way of increasing the size of the webcam preview is to make Cheese fullscreen. To do this, click <guiseq><gui>Cheese</gui><gui>Fullscreen</gui></guiseq> or press <key>F11</key>. You can get out of fullscreen mode, press <key>F11</key>.</p>
+
+</page>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]