240
<imagedata fileref="figures/cheese-screenshot.jpg" format="JPG"/>
272
<imagedata fileref="figures/cheese-2.28.0-main.jpg" format="JPG"/>
279
Especially for Cheese-users with small displays, like the ones in netbooks, we have designed
280
another view. It is more horizontally aligned, in order to fit better on small widescreen displays.
281
The wide-view is shown in the screenshot below.
285
<title>Cheese wide screenshot</title>
289
<imagedata fileref="figures/cheese-2.28.0-wide.jpg" format="JPG"/>
247
Cheese defaults to photo mode, and needs to be changed to video mode if
296
Cheese uses the photo mode by defaults, but you can change this to use the video
297
or burst mode if desired.
251
300
<section id="using-effects">
252
301
<title>Efièches</title>
254
303
To apply effects to the input of your webcam, click
255
the button labelled <guibutton>Effects</guibutton>. When you go to the
256
effects window, you will see a window similar to the image below
304
the button labelled <guibutton>Effects</guibutton>. When you then go to
305
the effects window, you will see a window similar to the image below.
258
307
<title>Cheese effects screenshot</title>
262
<imagedata fileref="figures/cheese-effects-screenshot.jpg" format="JPG"/>
311
<imagedata fileref="figures/cheese-2.28.0-effects.jpg" format="JPG"/>
271
You are able to select numerous effects to apply to your photo. To apply
272
an effect, just click on the effect that you want. The button will appear highlighted.
273
Selecting multiple effects will apply all the effects to
274
your image (for example, if you apply <guibutton>Hulk</guibutton> and
275
<guibutton>Vertical Flip</guibutton>, the
276
input from the webcam will be altered to have a green shade and be up side down).
277
To disable all effects, just click on the
320
You can apply some really cool effects to your photos too! Just choose
321
from the several different effects available and click its corresponding
322
button to apply it to your photo. Selecting multiple effects will apply
323
all the effects to your image. For example, if you select
324
<guibutton>Hulk</guibutton> and <guibutton>Vertical Flip</guibutton>,
325
the input from the webcam will be altered to have a green shade and be
326
upside down. To disable all effects, just click on the
278
327
<guibutton>No Effect</guibutton> button.
331
To return to the preview of your webcam, just push the button
332
labelled <guibutton>Effects</guibutton> again. This will toggle
333
the Effects menu and bring you back to the normal view.
282
337
<section id="using-photomode">
283
338
<title>Mòde fotografia</title>
285
Photo mode is the default mode that Cheese opens in. When not in photo mode,
286
click the button labelled <guibutton>Photo</guibutton>, press
287
<keycombo><keycap>Alt</keycap><keycap>P</keycap></keycombo> or Menu:
340
Photo mode is the default mode for Cheese. When not in photo mode,
341
click the button that shows the icon of a single photo or select it from the menu:
288
342
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Photo</guimenuitem></menuchoice>
289
343
to change to photo mode.
290
344
Photo mode will take a single photo every time the button labelled
291
345
<guibutton>Take a photo</guibutton> or the <keycap>Spacebar</keycap>
292
is pressed, and will save to disk.
346
key is pressed, and will save to disk.
312
The video mode does look any different to the screenshot of photo mode,
365
The video mode does not look much different from the photo mode,
313
366
except that the button labelled <guibutton>Take a photo</guibutton> will
314
be either <guibutton>Start Recording</guibutton>
315
or <guibutton>Stop Recording</guibutton>,
316
and the button labelled <guibutton>Video</guibutton> is greyed out, whereas the button
317
labelled <guibutton>Photo</guibutton> is not.
367
say <guibutton>Start Recording</guibutton> or <guibutton>Stop Recording</guibutton>,
368
and the button with the film roll icon is pushed in, whereas the other
369
mode buttons (photo and burst) are not.
373
<section id="using-burstmode">
374
<title>Burst Mode</title>
376
In burst mode you can take more pictures in a row. It works exactly like
377
the photo mode, except that it takes a series of pictures. When you are
378
not in burst mode, click the button that shows the icon of several
379
pictures in a row or select it from the menu: <menuchoice><guimenu>Cheese</guimenu><guimenuitem>Burst</guimenuitem></menuchoice> to
380
change to burst mode. Burst mode will start to take a series of
381
pictures with an interval of some seconds in between photos when the
382
button labelled <guibutton>Take Multiple Photos</guibutton> or the
383
<keycap>Spacebar</keycap> key is pressed.
384
The delay and amount of pictures to take can be set in the preferences
385
dialog. For more information please see <xref linkend="preferences"/>.
322
You can use both photo and video mode in Fullscreen. To do this, just click
323
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice> to
324
enter Fullscreen mode, or press <keycap>F11</keycap>. To exit Fullscreen
325
mode, press <keycap>Esc</keycap> or <keycap>F11</keycap>.
390
All modes can be used in fullscreen. To do this, click the
391
<menuchoice><guimenu>Cheese</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice> menu to
392
enter fullscreen mode, or press the <keycap>F11</keycap> key. To exit fullscreen
393
mode, press the <keycap>Esc</keycap> or the <keycap>F11</keycap> keys.
398
<title>Cheese fullscreen screenshot</title>
402
<imagedata fileref="figures/cheese-2.28.0-fullscreen.jpg" format="JPG"/>
332
411
<section id="working-with">
334
413
<section id="takingaphoto">
335
414
<title>Prene una fotografia</title>
337
To take a photo in Cheese, be sure to be in “Photo” mode.
341
To take a photo, apply the effects that you wish by clicking the button
342
labelled <guibutton>Effects</guibutton>, click on the effects desired as
343
described in a previous section and press the button labelled
344
<guibutton>Back</guibutton>. You should now have the effects that
345
you clicked on applied to the webcam input.
349
To take the photo, press the button labelled <guibutton>Take a photo</guibutton>
350
or press the <keycap>spacebar</keycap>. You will then
351
see <application>Cheese</application> count down from 3 or instantly take the photo, depending on your settings. When the photo is taken, your entire screen
416
To take a photo with Cheese, be sure to be in the “Photo” mode.
420
It's easy to take photos with special effects. Just click the button
421
labelled <guibutton>Effects</guibutton>, and click on the effects desired as
422
described in <xref linkend="using-effects"/>. You should now have the effects that
423
you chose applied to the webcam input. Press the effects button again to
424
get back to the normal view.
428
To take a photo, press the button labelled <guibutton>Take a photo</guibutton>
429
or press the <keycap>spacebar</keycap> key. Alternatively, you can also use
430
the webcam capture button, if your webcam has one. You will then
431
see <application>Cheese</application> count down from 3 or instantly take the photo,
432
depending on your settings. When the photo is taken, your entire screen
352
433
will flash white, and the photo that was just taken will appear in the photo
353
stream at the bottom of the program window.
434
stream at the bottom of the program's window. To abort the countdown you can use the
435
<keycap>Esc</keycap> key.
357
439
<section id="recordingavideo">
358
<title>Prene una vidèo</title>
440
<title>Recording a video</title>
360
To take a video in Cheese, make sure that the <guibutton>Video</guibutton>
442
To record a video in Cheese, make sure that the <guibutton>Video</guibutton>
361
443
button has been pressed.
365
447
To start recording a video, press the button labelled <guibutton>Start
366
Recording</guibutton> or press the <keycap>spacebar</keycap>.
367
The time of how much video has been recorded will appear in the bottom right
448
Recording</guibutton> or press the <keycap>Spacebar</keycap> key. Alternatively,
449
you can also use the webcam capture button, if your webcam has one.
450
To stop recording just press the same button, now labelled <guibutton>Stop
451
Recording</guibutton>, and the recording will stop and the video saved.
373
If your video appears to be jerky or have a low
456
If your video appears to be jerky or has a low
374
457
frame rate (only updating the picture every few seconds), it does not mean that the recording
375
458
has a similar frame rate. In many cases, the recorded file will have a better frame rate.
463
<section id="takingburst">
464
<title>Taking a series of pictures in burst mode</title>
466
To take more than one picture over some time you can use the burst mode.
467
Burst mode can be set up in the preferences dialog where you can also set the
468
amount of pictures you want to take and the delay in seconds between them.
469
You can find more information about that in <xref linkend="preferences"/>.
473
To start the burst mode, press the button labelled <guibutton>Take Multiple Photos</guibutton>
474
or press the <keycap>Spacebar</keycap> key. Alternatively, you can also use the webcam capture button,
475
if your webcam has one. To stop the burst capture you can use the
476
<keycap>Esc</keycap> key.
481
<section id="setting-up">
482
<title>Setting up Cheese</title>
484
<section id="preferences">
485
<title>The preferences dialog</title>
487
The preferences dialog allows you to set up some webcam specific parameters and
488
parameters specific to the burst mode. If you have more than one webcam or video device attached
489
to your system, the preferences dialog allows you to choose which one you would like to use for Cheese and
490
what resolution the image should have. Use the sliders to play around with the
491
brightness, contrast, saturation and hue values to find the best for your webcam.
495
<title>Cheese preferences screenshot</title>
499
<imagedata fileref="figures/cheese-2.28.0-preferences.jpg" format="JPG"/>
506
The parameters for the burst mode can be set in the preferences dialog as well. You only
507
have to adjust the values for the number of photos you wish to take and the delay
508
in seconds between each picture taken.
513
<title>GConf settings</title>
515
It's possible to define where Cheese stores the captured media (photos and videos). These
516
settings are stored in GConf. You can change the settings with the <command>gconf-editor</command>,
517
application. There you have to select /apps/cheese in the tree on the left. Then you can set the <guilabel>video_path</guilabel> and
518
<guilabel>photo_path</guilabel> to the location you prefer. There you can also set other parameters
519
for Cheese, but you should use the preferences dialog for a controlled access.
523
<para>Attention: Be careful while using GConf to change your settings! If you are not completely sure about what
524
you are doing, you should ask someone who knows!</para>
381
529
<section id="sharing">
382
530
<title>Partejar de fotografias e de vidèos</title>
383
532
<section id="view">
384
533
<title>Visualizar una fotografia o una vidèo</title>
386
535
To view a video or photo that has been taken, locate it in the photo stream and
387
double click on it. Alternatively, you can right click on it and select <guimenuitem>Open</guimenuitem>.
536
double click it. Alternatively, you can right click on it and select <guimenuitem>Open</guimenuitem>.
388
537
This will then open the file in the default application for that file type.
406
555
To delete a photo from the photo stream, locate the photo you wish to delete in
407
556
the photo stream, left click on it once and press the <keycap>delete</keycap> button on your
408
keyboard. Alternatively, you can right click on it and click <guimenuitem>Delete</guimenuitem>.
557
keyboard. Alternatively, you can right click on it and select <guimenuitem>Delete</guimenuitem>
558
from the pop-up menu.
412
You will be prompted if you wish to delete it from the photo stream. To confirm,
562
You will be asked if you wish to delete it from the photo stream. To confirm,
413
563
press the button labelled <guibutton>Move to Trash</guibutton>.
418
This will only move the image to the "trash", as well as remove from
568
This will move the image to the "trash", as well as remove from
419
569
your photo stream. This will not remove the photo from your computer. To remove
420
it from your trash, you will need to empty your trash.
570
it from your system, you will need to empty your trash.
426
576
<title>Enviar una fotografia per corrièl</title>
428
578
Photos can be directly emailed from Cheese. You will need to have the default mail
429
client set up with an email account, otherwise you will need to set one up. To email
430
a photo, locate the photo you wish to email in the photo stream, right click on
579
client set up with an email account. To email
580
a photo, locate the photo in the photo stream, right click on
431
581
it and select <guimenuitem>Send by Mail</guimenuitem>.
435
585
This will open the default mail client (for example, Evolution) and a new email
436
message with the photo as an attachment.
586
message will be created with the photo you selected as an attachment.
440
590
<section id="account-photo">
441
591
<title>Set as Account Photo</title>
443
To set a photo as your account photo (which can be viewed from
593
To set a photo as your account photo (which can be viewed from the
444
594
<menuchoice><guimenu>System</guimenu><guimenuitem>Preferences</guimenuitem>
445
<guimenuitem>About Me</guimenuitem></menuchoice>, and which will also appear if the login window displays a list of
446
user names with photos), locate the photo that you wish to set in Cheese, right click
595
<guimenuitem>About Me</guimenuitem></menuchoice> menu, and the login window with a list of
596
user names with photos), locate the photo that you wish to use in Cheese, right click
447
597
on it and select <guimenuitem>Set as Account Photo</guimenuitem>.
535
696
<section id="faq-store">
536
<title>Ont <application>Cheese</application> estoca mas fotografias ?</title>
538
Your photos are stored in ~/.gnome2/cheese/media. You can also save
539
them to an alternate location from within Cheese. Please see
540
<xref linkend="saving"/> for
697
<title>Where does <application>Cheese</application> store my photos and videos?</title>
699
Cheese stores your pictures in a folder called Webcam inside the
700
XDG-Directory set for Pictures (in most distributions its ~/Pictures/Webcam).
701
The same applies for Videos: ~/Videos/Webcam. XDG is a standard to
702
declare default folders in your system. You can find more information
703
about XDG <ulink url="http://standards.freedesktop.org/basedir-spec/basedir-spec-0.6.html" type="http">here</ulink>.
707
If the XDG-Path is not set on your System, cheese has a fallback solution: it
708
will store both your pictures and videos in ~/.gnome2/cheese/media. This is the default
709
directory for your media if you have an older version of <application>Cheese</application>.
713
How to set an alternate path is described in <xref linkend="gconf"/>.
717
<para>Attention: leave this settings blank if you want <application>Cheese</application> to use the default directories.</para>
722
You can also save your pictures to an alternate location from within Cheese. Please see
723
<xref linkend="saving"/> for information on this.
545
728
<section id="faq-quickcam">
561
744
"When I launch Cheese, I get the message 'No Camera Found' but I have my webcam plugged into my computer".
563
There are many situations this can happen in, and the exact problem that is causing this needs to be isolated.
564
If possible, try each of the following to try and get your webcam working.
565
1. Plug your webcam into another computer. If it works there, then it is a problem with
746
There are many situations that can cause this, and the exact problem that is causing it needs to be isolated.
747
If possible, try each of the following to try and get your webcam working:
748
1. Plug your webcam into another computer. If it works there, then it is a problem
566
749
with the connection to your computer, or the operating system if it was a different
567
750
one on the other computer. Check the ports on your computer (try another one) and
568
consult support personel for your particular operating system.
569
2. See if your camera is being detected by your computer, on Linux, open up the terminal or console and type
751
consult support for your particular operating system.
752
2. See if your camera is being detected by your computer. On Linux, open up the terminal or console and type
570
753
"dmesg" before you plug in your webcam. Notice the most recent entries, and then plug in your webcam. Type
571
754
"dmesg" again and see if the most recent entries differ. If the message mentions a USB device being detected,
572
755
and your webcam is the only USB device that has been changed, then your computer is detecting your webcam
573
756
fine. If not, then test to see if the webcam is working on another computer. This may only work with USB
575
758
3. As Cheese uses the gstreamer backend, it is most likely because gstreamer is not detecting the webcam (or
576
gstreamer has become corrupt). Please contact support personel for the particular operating system that
759
gstreamer has become corrupt). Please contact support for the particular operating system that
577
760
you are running with as many details as possible. For Ubuntu, please use the <ulink url="http://ubuntuforums.org/" type="http">Ubuntu Forums</ulink>.
581
764
<section id="faq-supported-webcams">
582
<title>Which cameras are supported</title>
765
<title>Which cameras are supported?</title>
584
767
Cheese uses gstreamer for video grabbing. So in principle Cheese supports
585
any camera that works with GStreamer. In principle that should be any camera
586
which support video4linux or video4linux2.
768
any camera that works with GStreamer. That should be any camera
769
which supports video4linux or video4linux2.
added
removed
help/oc/cheese.xml
