178
<imagedata fileref="figures/cheese-screenshot.jpg" format="JPG"/>
214
<imagedata fileref="figures/cheese-2.28.0-main.jpg" format="JPG"/>
221
Especially for &app;-users with small displays, like the ones in netbooks, we have designed
222
another view. It is more horizontally aligned, in order to fit better on small widescreen displays.
223
The wide-view is shown in the screenshot below.
227
<title>&app; wide screenshot</title>
231
<imagedata fileref="figures/cheese-2.28.0-wide.jpg" format="JPG"/>
185
&app; defaults to photo mode, and needs to be changed to video mode if
238
&app; uses the photo mode by defaults, but you can change this to use the video
239
or burst mode if desired.
189
242
<section id="using-effects">
190
243
<title>Effects</title>
192
245
To apply effects to the input of your webcam, click
193
the button labelled <guibutton>Effects</guibutton>. When you go to the
194
effects window, you will see a window similar to the image below
246
the button labelled <guibutton>Effects</guibutton>. When you then go to
247
the effects window, you will see a window similar to the image below.
196
249
<title>&app; effects screenshot</title>
200
<imagedata fileref="figures/cheese-effects-screenshot.jpg" format="JPG"/>
253
<imagedata fileref="figures/cheese-2.28.0-effects.jpg" format="JPG"/>
209
You are able to select numerous effects to apply to your photo. To apply
210
an effect, just click on the effect that you want. The button will appear highlighted.
211
Selecting multiple effects will apply all the effects to
212
your image (for example, if you apply <guibutton>Hulk</guibutton> and
213
<guibutton>Vertical Flip</guibutton>, the
214
input from the webcam will be altered to have a green shade and be up side down).
215
To disable all effects, just click on the
262
You can apply some really cool effects to your photos too! Just choose
263
from the several different effects available and click its corresponding
264
button to apply it to your photo. Selecting multiple effects will apply
265
all the effects to your image. For example, if you select
266
<guibutton>Hulk</guibutton> and <guibutton>Vertical Flip</guibutton>,
267
the input from the webcam will be altered to have a green shade and be
268
upside down. To disable all effects, just click on the
216
269
<guibutton>No Effect</guibutton> button.
273
To return to the preview of your webcam, just push the button
274
labelled <guibutton>Effects</guibutton> again. This will toggle
275
the Effects menu and bring you back to the normal view.
220
279
<section id="using-photomode">
221
280
<title>Photo Mode</title>
223
Photo mode is the default mode that &app; opens in. When not in photo mode,
224
click the button labelled <guibutton>Photo</guibutton>, press
225
<keycombo><keycap>Alt</keycap><keycap>P</keycap></keycombo> or Menu:
282
Photo mode is the default mode for &app;. When not in photo mode,
283
click the button that shows the icon of a single photo or select it from the menu:
226
284
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Photo</guimenuitem></menuchoice>
227
285
to change to photo mode.
228
286
Photo mode will take a single photo every time the button labelled
229
287
<guibutton>Take a photo</guibutton> or the <keycap>Spacebar</keycap>
230
is pressed, and will save to disk.
288
key is pressed, and will save to disk.
250
The video mode does look any different to the screenshot of photo mode,
307
The video mode does not look much different from the photo mode,
251
308
except that the button labelled <guibutton>Take a photo</guibutton> will
252
be either <guibutton>Start Recording</guibutton>
253
or <guibutton>Stop Recording</guibutton>,
254
and the button labelled <guibutton>Video</guibutton> is greyed out, whereas the button
255
labelled <guibutton>Photo</guibutton> is not.
309
say <guibutton>Start Recording</guibutton> or <guibutton>Stop Recording</guibutton>,
310
and the button with the film roll icon is pushed in, whereas the other
311
mode buttons (photo and burst) are not.
315
<section id="using-burstmode">
316
<title>Burst Mode</title>
318
In burst mode you can take more pictures in a row. It works exactly like
319
the photo mode, except that it takes a series of pictures. When you are
320
not in burst mode, click the button that shows the icon of several
321
pictures in a row or select it from the menu: <menuchoice><guimenu>Cheese</guimenu><guimenuitem>Burst</guimenuitem></menuchoice> to
322
change to burst mode. Burst mode will start to take a series of
323
pictures with an interval of some seconds in between photos when the
324
button labelled <guibutton>Take Multiple Photos</guibutton> or the
325
<keycap>Spacebar</keycap> key is pressed.
326
The delay and amount of pictures to take can be set in the preferences
327
dialog. For more information please see <xref linkend="preferences"/>.
260
You can use both photo and video mode in Fullscreen. To do this, just click
261
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice> to
262
enter Fullscreen mode, or press <keycap>F11</keycap>. To exit Fullscreen
263
mode, press <keycap>Esc</keycap> or <keycap>F11</keycap>.
332
All modes can be used in fullscreen. To do this, click the
333
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice> menu to
334
enter fullscreen mode, or press the <keycap>F11</keycap> key. To exit fullscreen
335
mode, press the <keycap>Esc</keycap> or the <keycap>F11</keycap> keys.
340
<title>&app; fullscreen screenshot</title>
344
<imagedata fileref="figures/cheese-2.28.0-fullscreen.jpg" format="JPG"/>
270
353
<section id="working-with">
272
355
<section id="takingaphoto">
273
356
<title>Taking a photo</title>
275
To take a photo in &app;, be sure to be in “Photo” mode.
279
To take a photo, apply the effects that you wish by clicking the button
280
labelled <guibutton>Effects</guibutton>, click on the effects desired as
281
described in a previous section and press the button labelled
282
<guibutton>Back</guibutton>. You should now have the effects that
283
you clicked on applied to the webcam input.
287
To take the photo, press the button labelled <guibutton>Take a photo</guibutton>
288
or press the <keycap>spacebar</keycap>. You will then
289
see &application; count down from 3 or instantly take the photo, depending on your settings. When the photo is taken, your entire screen
358
To take a photo with &app;, be sure to be in the “Photo” mode.
362
It's easy to take photos with special effects. Just click the button
363
labelled <guibutton>Effects</guibutton>, and click on the effects desired as
364
described in <xref linkend="using-effects"/>. You should now have the effects that
365
you chose applied to the webcam input. Press the effects button again to
366
get back to the normal view.
370
To take a photo, press the button labelled <guibutton>Take a photo</guibutton>
371
or press the <keycap>spacebar</keycap> key. Alternatively, you can also use
372
the webcam capture button, if your webcam has one. You will then
373
see &application; count down from 3 or instantly take the photo,
374
depending on your settings. When the photo is taken, your entire screen
290
375
will flash white, and the photo that was just taken will appear in the photo
291
stream at the bottom of the program window.
376
stream at the bottom of the program's window. To abort the countdown you can use the
377
<keycap>Esc</keycap> key.
295
381
<section id="recordingavideo">
296
<title>Taking a video</title>
382
<title>Recording a video</title>
298
To take a video in &app;, make sure that the <guibutton>Video</guibutton>
384
To record a video in &app;, make sure that the <guibutton>Video</guibutton>
299
385
button has been pressed.
303
389
To start recording a video, press the button labelled <guibutton>Start
304
Recording</guibutton> or press the <keycap>spacebar</keycap>.
305
The time of how much video has been recorded will appear in the bottom right
390
Recording</guibutton> or press the <keycap>Spacebar</keycap> key. Alternatively,
391
you can also use the webcam capture button, if your webcam has one.
392
To stop recording just press the same button, now labelled <guibutton>Stop
393
Recording</guibutton>, and the recording will stop and the video saved.
311
If your video appears to be jerky or have a low
398
If your video appears to be jerky or has a low
312
399
frame rate (only updating the picture every few seconds), it does not mean that the recording
313
400
has a similar frame rate. In many cases, the recorded file will have a better frame rate.
405
<section id="takingburst">
406
<title>Taking a series of pictures in burst mode</title>
408
To take more than one picture over some time you can use the burst mode.
409
Burst mode can be set up in the preferences dialog where you can also set the
410
amount of pictures you want to take and the delay in seconds between them.
411
You can find more information about that in <xref linkend="preferences"/>.
415
To start the burst mode, press the button labelled <guibutton>Take Multiple Photos</guibutton>
416
or press the <keycap>Spacebar</keycap> key. Alternatively, you can also use the webcam capture button,
417
if your webcam has one. To stop the burst capture you can use the
418
<keycap>Esc</keycap> key.
423
<section id="setting-up">
424
<title>Setting up &app;</title>
426
<section id="preferences">
427
<title>The preferences dialog</title>
429
The preferences dialog allows you to set up some webcam specific parameters and
430
parameters specific to the burst mode. If you have more than one webcam or video device attached
431
to your system, the preferences dialog allows you to choose which one you would like to use for Cheese and
432
what resolution the image should have. Use the sliders to play around with the
433
brightness, contrast, saturation and hue values to find the best for your webcam.
437
<title>&app; preferences screenshot</title>
441
<imagedata fileref="figures/cheese-2.28.0-preferences.jpg" format="JPG"/>
448
The parameters for the burst mode can be set in the preferences dialog as well. You only
449
have to adjust the values for the number of photos you wish to take and the delay
450
in seconds between each picture taken.
455
<title>GConf settings</title>
457
It's possible to define where &app; stores the captured media (photos and videos). These
458
settings are stored in GConf. You can change the settings with the <command>gconf-editor</command>,
459
application. There you have to select /apps/cheese in the tree on the left. Then you can set the <guilabel>video_path</guilabel> and
460
<guilabel>photo_path</guilabel> to the location you prefer. There you can also set other parameters
461
for &app;, but you should use the preferences dialog for a controlled access.
465
<para>Attention: Be careful while using GConf to change your settings! If you are not completely sure about what
466
you are doing, you should ask someone who knows!</para>
319
471
<section id="sharing">
320
472
<title>Sharing Photos and Videos</title>
321
474
<section id="view">
322
475
<title>Viewing a photo or video</title>
324
477
To view a video or photo that has been taken, locate it in the photo stream and
325
double click on it. Alternatively, you can right click on it and select <guimenuitem>Open</guimenuitem>.
478
double click it. Alternatively, you can right click on it and select <guimenuitem>Open</guimenuitem>.
326
479
This will then open the file in the default application for that file type.
344
497
To delete a photo from the photo stream, locate the photo you wish to delete in
345
498
the photo stream, left click on it once and press the <keycap>delete</keycap> button on your
346
keyboard. Alternatively, you can right click on it and click <guimenuitem>Delete</guimenuitem>.
499
keyboard. Alternatively, you can right click on it and select <guimenuitem>Delete</guimenuitem>
500
from the pop-up menu.
350
You will be prompted if you wish to delete it from the photo stream. To confirm,
504
You will be asked if you wish to delete it from the photo stream. To confirm,
351
505
press the button labelled <guibutton>Move to Trash</guibutton>.
356
This will only move the image to the "trash", as well as remove from
510
This will move the image to the "trash", as well as remove from
357
511
your photo stream. This will not remove the photo from your computer. To remove
358
it from your trash, you will need to empty your trash.
512
it from your system, you will need to empty your trash.
364
518
<title>Send a photo by e-mail</title>
366
520
Photos can be directly emailed from &app;. You will need to have the default mail
367
client set up with an email account, otherwise you will need to set one up. To email
368
a photo, locate the photo you wish to email in the photo stream, right click on
521
client set up with an email account. To email
522
a photo, locate the photo in the photo stream, right click on
369
523
it and select <guimenuitem>Send by Mail</guimenuitem>.
373
527
This will open the default mail client (for example, Evolution) and a new email
374
message with the photo as an attachment.
528
message will be created with the photo you selected as an attachment.
378
532
<section id="account-photo">
379
533
<title>Set as Account Photo</title>
381
To set a photo as your account photo (which can be viewed from
535
To set a photo as your account photo (which can be viewed from the
382
536
<menuchoice><guimenu>System</guimenu><guimenuitem>Preferences</guimenuitem>
383
<guimenuitem>About Me</guimenuitem></menuchoice>, and which will also appear if the login window displays a list of
384
user names with photos), locate the photo that you wish to set in &app;, right click
537
<guimenuitem>About Me</guimenuitem></menuchoice> menu, and the login window with a list of
538
user names with photos), locate the photo that you wish to use in &app;, right click
385
539
on it and select <guimenuitem>Set as Account Photo</guimenuitem>.
473
638
<section id="faq-store">
474
<title>Where does &application; store my photos?</title>
476
Your photos are stored in ~/.gnome2/cheese/media. You can also save
477
them to an alternate location from within &app;. Please see
478
<xref linkend="saving"/> for
639
<title>Where does &application; store my photos and videos?</title>
641
&app; stores your pictures in a folder called Webcam inside the
642
XDG-Directory set for Pictures (in most distributions its ~/Pictures/Webcam).
643
The same applies for Videos: ~/Videos/Webcam. XDG is a standard to
644
declare default folders in your system. You can find more information
645
about XDG <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html" type="http">here</ulink>.
649
If the XDG-Path is not set on your System, cheese has a fallback solution: it
650
will store both your pictures and videos in ~/.gnome2/cheese/media. This is the default
651
directory for your media if you have an older version of &application;.
655
How to set an alternate path is described in <xref linkend="gconf"/>.
659
<para>Attention: leave this settings blank if you want &application; to use the default directories.</para>
664
You can also save your pictures to an alternate location from within &app;. Please see
665
<xref linkend="saving"/> for information on this.
483
670
<section id="faq-quickcam">
499
686
"When I launch &app;, I get the message 'No Camera Found' but I have my webcam plugged into my computer".
501
There are many situations this can happen in, and the exact problem that is causing this needs to be isolated.
502
If possible, try each of the following to try and get your webcam working.
503
1. Plug your webcam into another computer. If it works there, then it is a problem with
688
There are many situations that can cause this, and the exact problem that is causing it needs to be isolated.
689
If possible, try each of the following to try and get your webcam working:
690
1. Plug your webcam into another computer. If it works there, then it is a problem
504
691
with the connection to your computer, or the operating system if it was a different
505
692
one on the other computer. Check the ports on your computer (try another one) and
506
consult support personel for your particular operating system.
507
2. See if your camera is being detected by your computer, on Linux, open up the terminal or console and type
693
consult support for your particular operating system.
694
2. See if your camera is being detected by your computer. On Linux, open up the terminal or console and type
508
695
"dmesg" before you plug in your webcam. Notice the most recent entries, and then plug in your webcam. Type
509
696
"dmesg" again and see if the most recent entries differ. If the message mentions a USB device being detected,
510
697
and your webcam is the only USB device that has been changed, then your computer is detecting your webcam
511
698
fine. If not, then test to see if the webcam is working on another computer. This may only work with USB
513
700
3. As &app; uses the gstreamer backend, it is most likely because gstreamer is not detecting the webcam (or
514
gstreamer has become corrupt). Please contact support personel for the particular operating system that
701
gstreamer has become corrupt). Please contact support for the particular operating system that
515
702
you are running with as many details as possible. For Ubuntu, please use the <ulink url="http://ubuntuforums.org/" type="http">Ubuntu Forums</ulink>.
519
706
<section id="faq-supported-webcams">
520
<title>Which cameras are supported</title>
707
<title>Which cameras are supported?</title>
522
709
&app; uses gstreamer for video grabbing. So in principle &app; supports
523
any camera that works with GStreamer. In principle that should be any camera
524
which support video4linux or video4linux2.
710
any camera that works with GStreamer. That should be any camera
711
which supports video4linux or video4linux2.