# Handbok för Cheese

Cheese är ett program som tar foto och video från webbkameror (och andra kameror) och kan göra en del häftiga effekter

2007,2008
daniel g. siegel (dgsiegel@gmail.com)
Jaap A. Haitsma (jaap@haitsma.org)
2007
Daniel Nylander (po@danielnylander.se)
Joshua Henderson (joshhendo@gmail.com)

Tillstånd att kopiera, distribuera och/eller modifiera detta dokument ges under villkoren i GNU Free Documentation License (GFDL), version 1.1 eller senare, utgivet av Free Software Foundation utan standardavsnitt och omslagstexter. En kopia av GFDL finns att hämta på denna länk eller i filen COPYING-DOCS som medföljer denna handbok.

Denna handbok utgör en av flera GNOME-handböcker som distribueras under villkoren i GFDL. Om du vill distribuera denna handbok separat från övriga handböcker kan du göra detta genom att lägga till en kopia av licensavtalet i handboken enligt instruktionerna i avsnitt 6 i licensavtalet.

Flera namn på produkter och tjänster är registrerade varumärken. I de fall dessa namn förekommer i GNOME-dokumentation - och medlemmarna i GNOME-dokumentationsprojektet är medvetna om dessa varumärken - är de skrivna med versaler eller med inledande versal.

DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET TILLHANDAHÅLLS UNDER VILLKOREN I GNU FREE DOCUMENTATION LICENSE ENDAST UNDER FÖLJANDE FÖRUTSÄTTNINGAR:

1. DOKUMENTET TILLHANDAHÅLLS I "BEFINTLIGT SKICK" UTAN NÅGRA SOM HELST GARANTIER, VARE SIG UTTRYCKLIGA ELLER UNDERFÖRSTÅDDA, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, GARANTIER ATT DOKUMENTET ELLER EN MODIFIERAD VERSION AV DOKUMENTET INTE INNEHÅLLER NÅGRA FELAKTIGHETER, ÄR LÄMPLIGT FÖR ETT VISST ÄNDAMÅL ELLER INTE STRIDER MOT LAG. HELA RISKEN VAD GÄLLER KVALITET, EXAKTHET OCH UTFÖRANDE AV DOKUMENTET OCH MODIFIERADE VERSIONER AV DOKUMENTET LIGGER HELT OCH HÅLLET PÅ ANVÄNDAREN. OM ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT SKULLE VISA SIG INNEHÅLLA FELAKTIGHETER I NÅGOT HÄNSEENDE ÄR DET DU (INTE DEN URSPRUNGLIGA SKRIBENTEN, FÖRFATTAREN ELLER NÅGON ANNAN MEDARBETARE) SOM FÅR STÅ FÖR ALLA EVENTUELLA KOSTNADER FÖR SERVICE, REPARATIONER ELLER KORRIGERINGAR. DENNA GARANTIFRISKRIVNING UTGÖR EN VÄSENTLIG DEL AV DETTA LICENSAVTAL. DETTA INNEBÄR ATT ALL ANVÄNDNING AV ETT DOKUMENT ELLER EN MODIFIERAD VERSION AV ETT DOKUMENT BEVILJAS ENDAST UNDER DENNA ANSVARSFRISKRIVNING.

2. UNDER INGA OMSTÄNDIGHETER ELLER INOM RAMEN FÖR NÅGON LAGSTIFTNING, OAVSETT OM DET GÄLLER KRÄNKNING (INKLUSIVE VÅRDSLÖSHET), KONTRAKT ELLER DYLIKT, SKA FÖRFATTAREN, DEN URSPRUNGLIGA SKRIBENTEN ELLER ANNAN MEDARBETARE ELLER ÅTERFÖRSÄLJARE AV DOKUMENTET ELLER AV EN MODIFIERAD VERSION AV DOKUMENTET ELLER NÅGON LEVERANTÖR TILL NÅGON AV NÄMNDA PARTER STÄLLAS ANSVARIG GENTEMOT NÅGON FÖR NÅGRA DIREKTA, INDIREKTA, SÄRSKILDA ELLER OFÖRUTSEDDA SKADOR ELLER FÖLJDSKADOR AV NÅGOT SLAG, INKLUSIVE, MEN INTE BEGRÄNSAT TILL, SKADOR BETRÄFFANDE FÖRLORAD GOODWILL, HINDER I ARBETET, DATORHAVERI ELLER NÅGRA ANDRA TÄNKBARA SKADOR ELLER FÖRLUSTER SOM KAN UPPKOMMA PÅ GRUND AV ELLER RELATERAT TILL ANVÄNDNINGEN AV DOKUMENTET ELLER MODIFIERADE VERSIONER AV DOKUMENTET, ÄVEN OM PART SKA HA BLIVIT INFORMERAD OM MÖJLIGHETEN TILL SÅDANA SKADOR.

Joshua
Henderson
joshhendo@gmail.com
Jaap
Haitsma
jaap@haitsma.org
0.1
2007-12-04

Jaap A. Haitsma jaap@haitsma.org

Jaap A. Haitsma

0.2
2008-01-12

Jaap A. Haitsma jaap@haitsma.org

Joshua Henderson joshhendo@gmail.com

Jaap A. Haitsma

0.3
2008-08-20

Jaap A. Haitsma jaap@haitsma.org

Joshua Henderson joshhendo@gmail.com

Jaap A. Haitsma

## Återkoppling

För att rapportera ett fel eller föreslå någonting angående programmet Cheese eller den här handboken, följ anvisningarna på kontaktsidan för Cheese.

## Introduktion

Cheese är ett program som tar foto och video med häftiga effekter för GNOME-skrivbordet

## Användning

The main screen of Cheese looks like the screen shot below

### Cheese screenshot

Cheese defaults to photo mode, and needs to be changed to video mode if desired.

### Effects

To apply effects to the input of your webcam, click the button labelled Effects. When you go to the effects window, you will see a window similar to the image below

#### Cheese effects screenshot

You are able to select numerous effects to apply to your photo. To apply an effect, just click on the effect that you want. The button will appear highlighted. Selecting multiple effects will apply all the effects to your image (for example, if you apply Hulk and Vertical Flip, the input from the webcam will be altered to have a green shade and be up side down). To disable all effects, just click on the No Effect button.

### Photo Mode

Photo mode is the default mode that Cheese opens in. When not in photo mode, click the button labelled Photo, press Alt P or Menu: Cheese Photo to change to photo mode. Photo mode will take a single photo every time the button labelled Take a photo or the Spacebar is pressed, and will save to disk.

### Video Mode

Video mode is a mode that allows you to take short videos using the webcam. When not in video mode, click the button labelled Video, press Alt V or Menu: Cheese Video to change to video mode. Video mode will start recording a video every time the the button labelled Start Recording or the Spacebar is pressed. The video will stop recording and save to disk when the button labelled Stop Recording or the Spacebar is pressed.

The video mode does look any different to the screen shot of photo mode, except that the button labelled Take a photo will be either Start Recording or Stop Recording, and the button labelled Video is greyed out, whereas the button labelled Photo is not.

You can use both photo and video mode in Fullscreen. To do this, just click Cheese Fullscreen to enter Fullscreen mode, or press F11. To exit Fullscreen mode, press Esc or F11.

## Working with photos and videos

### Taking a photo

To take a photo in Cheese, be sure to be in “Photo” mode.

To take a photo, apply the effects that you wish by clicking the button labelled Effects, click on the effects desired as described in a previous section and press the button labelled Back. You should now have the effects that you clicked on applied to the webcam input.

To take the photo, press the button labelled Take a photo or press the spacebar. You will then see Cheese count down from 3 or instantly take the photo, depending on your settings. When the photo is taken, your entire screen will flash white, and the photo that was just taken will appear in the photo stream at the bottom of the program window.

### Taking a video

To take a video in Cheese, make sure that the Video button has been pressed

To start recording a video, press the button labelled Start Recording or press the spacebar. The time of how much video has been recorded will appear in the bottom right hand corner.

If your video appears to be jerky or have a low frame rate (only updating the picture every few seconds), it does not mean that the recording has a similar frame rate. In many cases, the recorded file will have a better frame rate.

## Sharing Photos and Videos

### Viewing a photo or video

To view a video or photo that has been taken, locate it in the photo stream and double click on it. Alternatively, you can right click on it and select Open. This will then open the file in the default application for that file type.

### Saving photos and videos to an alternate location

To save a photo to an alternate place on your hard drive where you can easily find them, find the photo or video that you wish to save in the photo stream, right click on it and select Save As from the pop-up menu. This will bring up a standard Save File dialog that will allow you to rename the photo if desired and save to any location you wish.

### Deleting a photo

To delete a photo from the photo stream, locate the photo you wish to delete in the photo stream, left click on it once and press the delete button on your keyboard. Alternatively, you can right click on it and click Delete.

You will be prompted if you wish to delete it from the photo stream. To confirm, press the button labelled Move to Trash.

This will only move the image to the "trash", as well as remove from your photo stream. This will not remove the photo from your computer. To remove it from your trash, you will need to empty your trash.

### Send a photo by e-mail

Photos can be directly emailed from Cheese. You will need to have the default mail client set up with an email account, otherwise you will need to set one up. To email a photo, locate the photo you wish to email in the photo stream, right click on it and select Send by Mail.

This will open the default mail client (for example, Evolution) and a new email message with the photo as an attachment.

### Set as Account Photo

To set a photo as your account photo (which can be viewed from System Preferences About Me, and which will also appear if the login window displays a list of user names with photos), locate the photo that you wish to set in Cheese, right click on it and select Set as Account Photo

### Export a photo to F-Spot

To export a photo to F-Sport, locate the photo that you wish to export in your photo stream, right click on it and select Export to F-Spot. You will then be prompted from F-Spot if you wish to import the photos that are sent to it.

Depending on the version of Cheese that you are currently using, F-Spot may prompt you to import the entire photo stream.

## Frågor och svar

### The video is sluggish/has a slow response. What can I do?

You may have set "`ximagesink`" (X Window System (No Xv)) as video-output. This means, that your cpu is doing all the work. Change it to "`xvimagesink`" (X Window System (X11/XShm/Xv)) in order to let your graphics card do the work.

To change the settings, run `gstreamer-properties`, click the Video tab and change the appropriate settings.

### I have a Mac with iSight and a ATI graphics card, and the colors are weird.

This is a problem with the ATI graphics card, though there is a work around. Change the video-output to custom and insert the following: "`ffmpegcolorspace ! video/x-raw-yuv,format=(fourcc)YV12 ! ffmpegcolorspace ! xvimagesink`".

To change the settings, run `gstreamer-properties`, click the Video tab and select custom from the drop down menu.

### My webcam works with gstreamer, but does not work with Cheese. What's wrong?

Using `gstreamer-properties` mentioned in the above question, try changing from xvimagesink to ximagesink or vice-versa. If this still does not work run `cheese --verbose` on the command line and copy the logging into a bug report in our bug tracker.

### My webcam works with other programs such as Ekiga, Camorama, but not with Cheese. What's wrong?

See if your webcam works when testing it in `gstreamer-properties`. If it works there, but not in Cheese, please file a bug report in our bug tracker.

### Where does Cheese store my photos?

Your photos are stored in ~/.gnome2/cheese/media. You can also save them to an alternate location from within Cheese. Please see for information on this.

### My Quickcam Express doesn't work with Cheese...

or gstreamer, and I see errors like "Not enough buffers. We got 1, we want at least 2" in the Cheese output. With driver "qc-usb".

Try running `qcset /dev/video0 compat=dblbuf` to enable double buffer compatibility mode, then restart Cheese

### "No Camera Found" Error Message

"When I launch Cheese, I get the message 'No Camera Found' but I have my webcam plugged into my computer".

There are many situations this can happen in, and the exact problem that is causing this needs to be isolated. If possible, try each of the following to try and get your webcam working. 1. Plug your webcam into another computer. If it works there, then it is a problem with with the connection to your computer, or the operating system if it was a different one on the other computer. Check the ports on your computer (try another one) and consult support personel for your particular operating system. 2. See if your camera is being detected by your computer, on Linux, open up the terminal or console and type "dmesg" before you plug in your webcam. Notice the most recent entries, and then plug in your webcam. Type "dmesg" again and see if the most recent entries differ. If the message mentions a USB device being detected, and your webcam is the only USB device that has been changed, then your computer is detecting your webcam fine. If not, then test to see if the webcam is working on another computer. This may only work with USB webcams. 3. As Cheese uses the gstreamer backend, it is most likely because gstreamer is not detecting the webcam (or gstreamer has become corrupt). Please contact support personel for the particular operating system that you are running with as many details as possible. For Ubuntu, please use the Ubuntu Forums.

### Vilka kameror stöds

Cheese uses gstreamer for video grabbing. So in principle Cheese supports any camera that works with GStreamer. In principle that should be any camera which support video4linux or video4linux2.

## Om

Cheese was initially written by daniel g. siegel dgsiegel@gmail.com. as a Google Summer of Code project. Later Jaap A. Haitsma jaap@haitsma.org and also others joined daniel in improving Cheese. To find more information about Cheese, please visit the Cheese web page.

To report a bug or make a suggestion regarding this application you can file a bug in our bug tracker.

Det här programmet distribueras under villkoren för GNU General Public License som publicerats av Free Software Foundation; antingen version 2 av licensen, eller (om du så vill) någon senare version. En kopia av den här licensen kan hittas på GNU:s webbplats, eller i filen COPYING som inkluderats i källkoden för det här programmet.