# Manuale di &ksnapshot;

## Introduzione

&ksnapshot; è un semplice programma per scattare foto allo schermo. È in grado di acquisire immagini di tutto il desktop, di una sola finestra o di una regione selezionata. Le immagini così ottenute possono in seguito essere salvate in vari formati.

Segnala qualsiasi problema o richiesta di miglioramenti sul Sistema di gestione dei bug di KDE

## Uso di &ksnapshot;

Questo capitolo spiega come usare &ksnapshot; per scattare foto allo schermo.

### Avvio di &ksnapshot;

&ksnapshot; può essere avviato in uno dei seguenti modi.

- È possibile avviare &ksnapshot; selezionandolo dal sottomenu Grafica del pannello.

- È possibile avviare &ksnapshot; immettendo il seguente comando al prompt dei comandi:

      % ksnapshot &

- È possibile anche usare la mini riga dei comandi (ottenibile con &Alt;F2) per avviare &ksnapshot;

All'avvio di &ksnapshot;, apparirà una finestra simile alla seguente: Finestra di anteprima di &ksnapshot;

### Scattare una foto

&ksnapshot; scatta una foto dell'intero desktop non appena viene avviato, ma prima di apparire a schermo. In questo modo è possibile scattare velocemente foto dell'intero desktop.

La foto scattata da &ksnapshot; è mostrata nella finestra di anteprima, che si trova in alto a sinistra nella finestra di &ksnapshot;. Qui sotto c'è un esempio di finestra di anteprima di &ksnapshot;. La tua anteprima dipenderà da come si presenta il tuo desktop.

Finestra di anteprima di &ksnapshot;

La foto può essere salvata facendo clic sul pulsante Salva con nome.... Se sono fatte più foto, il nome del file è automaticamente incrementato per impedirti di sovrascrivere le foto precedenti. Puoi comunque modificare il nome del file in qualsiasi modo tu voglia, incluso il nome di una foto salvata precedentemente.

Per scattare una foto ad una singola finestra, seleziona la voce della casella combinata Finestra sotto il cursore (di fianco a Modalità di acquisizione) e premi il pulsante Nuova foto.

A seconda di come hai impostato Ritardo per la foto:, il puntatore del mouse diventerà una crocetta (nel caso di Nessun ritardo) oppure un cursore del mouse normale che puoi usare per lavorare con un programma finché non scadrà il tempo e la foto verrà scattata.

Se ha scelto Nessun ritardo, la foto sarà scattata non appena farai clic su una finestra.

&ksnapshot; mostrerà la nuova foto nella finestra di anteprima. A questo punto puoi scegliere se salvare l'immagine (premendo Salva con nome...) o scattarne una nuova premendo ancora il pulsante Nuova schermata.

Per scattare una nuova foto di tutto il desktop, seleziona la voce della casella combinata Schermo intero (di fianco a Modalità di acquisizione), e fai clic sul pulsante Nuova foto. &ksnapshot; acquisirà tutto il desktop se premi Nuova foto.

Similmente, per fare una foto a una regione, seleziona la voce della casella combinata Regione (di fianco a Modalità di acquisizione), e imposta il Ritardo per la foto a Nessun ritardo, e fai clic sul pulsante Nuova foto. Il cursore del mouse diventerà una crocetta, e potrai usare il mouse per selezionare la regione che vuoi acquisire.

### Funzionalità aggiuntive

#### Ritardo per la foto

L'opzione Ritardo per la foto ti permette di impostare un ritardo, in secondi, tra l'istante in cui premi il pulsante Nuova schermata e quello in cui verrà effettivamente scattata la foto.

Se imposti un ritardo, non è necessario che tu faccia clic con il tasto del mouse per scattare una foto. Ciò ti permette di aprire un menu a tendina e di scattarne una foto.

#### Escludi le decorazioni della finestra

Includi le decorazioni della finestra è l'opzione preimpostata.

Se, invece, vuoi fotografare solo l'applicazione senza le decorazioni circostanti della finestra, puoi disabilitare questa opzione prima di scattare la foto.

#### Stampa

Quando vuoi stampare la foto presente nell'anteprima, ti basta fare clic su Stampa... e comparirà l'abituale finestra di dialogo per la stampa in KDE, dalla quale potrai stampare direttamente la tua foto.

#### Pulsanti

Ci sono due ulteriori pulsanti in fondo alla finestra di &ksnapshot;. Qui di seguito è descritta la loro funzione.

Aiuto

- Fornisce un menu dal quale potrai aprire questo Manuale di &ksnapshot;, segnalare un bug o ricevere ulteriori informazioni su &kde; e &ksnapshot;.

Esci

- Chiude il programma &ksnapshot;.

## Interfaccia &DCOP;

&ksnapshot; può essere gestito da script usando la sua interfaccia &DCOP;. Questo capitolo spiega le varie chiamate &DCOP; che puoi usare, e dà alcuni esempi su come usarle.

Come per tutte le chiamate DCOP, devi specificare l'applicazione con cui vuoi interagire, e l'interfaccia specifica. Con &ksnapshot; devi identificare l'applicazione specifica, che è `ksnapshot` seguito dal numero del processo.

Per avviare &ksnapshot; e ottenere l'argomento giusto, usa `dcopstart ksnapshot`, che restituisce l'argomento (come `ksnapshot-20594`) nello standard output.

Puoi ottenere un elenco di tutte le interfacce &DCOP; disponibili usando gli argomenti giusti, come mostrato in questo esempio:

    $ dcop `dcopstart ksnapshot` interface
    QCStringList interfaces()
    QCStringList functions()
    QString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(QString filename)
    void slotSaveAs()
    void slotCopy()
    void setTime(int newTime)
    int timeout()
    void setURL(QString newURL)
    void setGrabMode(int grab)
    int grabMode()
    void slotMovePointer(int x,int y)
    void exit()

Negli esempi seguenti, il processo è sempre `ksnapshot-23151`.

### Accesso &DCOP; alle impostazioni

Di ciascuna delle impostazioni che controlli con la GUI puoi sia ottenere lo stato attuale che modificarla usando &DCOP;.

Puoi ottenere l'attuale modalità di acquisizione usando la chiamata `grabMode`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface grabMode

Ciò restituirà `0` per l'acquisizione di un'intera schermata, `1` per l'aquisizione di una finestra, e `2` per l'acquisizione di una regione.

Puoi impostare la modalità di acquisizione usando `setGrabMode`, che richiede un argomento per identificare la modalità richiesta (come nella chiamata `grabMode`). In questo modo puoi impostare la modalità di acquisizione di una finestra (`1`) usando:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Puoi ottenere l'attuale impostazione del ritardo (l'elemento della GUI Ritardo per la foto:) usando la chiamata `timeout`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface timeout

Ciò restituirà l'impostazione del ritardo in secondi, o zero se non c'è nessun ritardo (acquisizione al clic).

Puoi impostare il ritardo usando `setTime`, che richiede un argomento per identificare la durata del ritardo. Quindi puoi impostare un ritardo di quattro secondi usando:

    $ dcop ksnapshot-23151 interface setTime 4

Puoi ottenere il percorso a cui la schermata sarà salvata usando la chiamata `url`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface url

Ciò restituirà il nome del file in forma di URL (per esempio come `file:///home/pippo/prova2.png`).

Puoi impostare il percorso usando il comando `setURL`, che richiede un argomento in forma di stringa per identificare il nuovo percorso. Quindi puoi impostare il percorso a `file:///home/pippo/schermata4.jpg` usando:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg

### Scattare foto con &DCOP;

Il trucco per scattare foto con &DCOP; è usare il comando `slotGrab`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotGrab

Ciò scatterà una foto usando la modalità di acquisizione e impostazioni del ritardo attuali (come descritto sopra). Se vuoi salvare l'immagine acquisita, ci sono delle chiamate che puoi usare. Se vuoi solo salvare l'immagine nel percorso attuale (come restituito da `url` o cambiato con `setURL`), puoi chiamare `slotSave`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotSave

Se vuoi che l'utente possa specificare un nome file (e percorso), puoi usare `slotSaveAs`, che farà apparire una finestra di salvataggio dei file standard di &kde;.

Se vuoi salvare l'immagine con un nome (o percorso) diverso senza cambiare il percorso con `setURL`, puoi usare `save`, dando l'URL su cui salvare come argomento. Se vuoi salvare la schermata in `file:///tmp/tempshot.png`, puoi fare come segue:

    $ dcop ksnapshot-23151 interface save file:///tmp/tempshot.png

Nota che ciò restituirà vero se la schermata sarà stata salvata correttamente, e falso altrimenti. Inoltre dovresti tener presente che se il file esiste già, l'utente riceverà una finestra standard di &kde; che gli chiederà di decidere se sovrascrivere o meno.

Oltre a salvare la schermata, puoi anche copiarla negli appunti, usando il comando `slotCopy`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotCopy

Se devi selezionare una finestra che potrebbe non essere sotto il cursore del mouse, puoi usare la chiamata `slotMovePointer`, passando la coordinate x e y (in pixel dello schermo) come argomenti. Quindi, per spostare il mouse nell'angolo in alto a sinistra dello schermo (0,0), puoi fare come segue:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Stampare schermate con &DCOP;

Puoi stampare la schermata attuale (che può essere salvata o meno) usando il comando `printSlot`, come mostrato sotto:

    $ dcop ksnapshot-23151 interface slotPrint

Nota che questo farà apparire la finestra di stampa standard di &kde;, che può richiedere interazione con l'utente.

### Controllo dell'applicazione con &DCOP;

Puoi terminare &ksnapshot; usando il comando `exit`, come mostrato sotto.

    $ dcop ksnapshot-23151 interface exit

## Riconoscimenti e licenza

Copyright del programma

- 1997-2000 Richard J. Moore rich@kde.org

- 2000 Matthias Ettrich ettrich@kde.org

Documentazione basata sull'originale, copyright 1997-2000 Richard J. Moore rich@kde.org

Federico Zenithzenith@chemeng.ntnu.no

Federico Cozzi

Matteo Merli

Andrea Celli

&underFDL; &underGPL;
&documentation.index;