# El manual de &ksnapshot;

## Introducción

&ksnapshot; is a simple applet for taking screenshots. It is capable of capturing images of the whole desktop, a single window or a selected region. The images can then be saved in a variety of formats.

Please report any problems or feature requests to the KDE Bug Tracking System

## Uso de &ksnapshot;

Este capítulo describe el uso de &ksnapshot; para capturar imágenes de la pantalla.

### Iniciando &ksnapshot;

&ksnapshot; puede ser iniciado por cualquier de los siguientes métodos descritos más abajo.

- You may start &ksnapshot; by selecting it from the Graphics submenu of the panel.

- Puede iniciar &ksnapshot; introduciendo los siguiente en la línea de comandos:

      % ksnapshot &

- La mini línea de comandos (invocada con &Alt;F2) también puede ser utilizada para iniciar &ksnapshot;

Una vez que se ha iniciado &ksnapshot;, verá una ventana como la siguiente: Ventana de previsualización de &ksnapshot;

### Toma de una instantánea

&ksnapshot; toma una imagen de todo el escritorio inmediatamente después de ser iniciado, pero antes de mostrarse en la pantalla. Esto permite crear imágenes de todo el escritorio rápidamente.

La instantánea tomada por &ksnapshot; se muestra en la ventana de previsualización, que se encuentra en la zona superior izquierda de la ventana principal de &ksnapshot;. Más abajo hay un ejemplo de la ventana de previsualización de &ksnapshot;. Su previsualización variará dependiendo de lo que tenga en el escritorio.

Ventana de previsualización de &ksnapshot;

La instantánea puede ser guardada pulsando en el botón Guardar como.... Esto abre el cuadro de diálogo estándar de &kde; guardar, en el que podrá seleccionar el nombre de archivo, la carpeta y el formato con el que guardará la instantánea. Si se toman varias instantáneas, el nombre del archivo se irá incrementando automáticamente para evitar borrar instantáneas anteriores. No obstante, puede modificar el nombre del archivo como desee, incluso poniendo el nombre de un archivo ya guardado.

Para tomar una instantánea de una única ventana, active la opción Ventana bajo el cursor (al lado de la etiqueta Modo de captura:), y a continuación pinche sobre el botón Nueva instantánea.

Dependiendo de su configuración de Retardo de la instantánea, el cursor del ratón se convertirá en una cruz (si no hay retardo), o será un cursor estándar, pudiéndo trabajar con un programa hasta que el retardo haya terminado y se tome la instantánea.

With No delay, the snapshot is taken immediately when you click in a window.

&ksnapshot; mostrará la nueva instantánea en el área de previsualización, momento en el que podrá guardar la nueva imagen (pulsado Guardar como...) o capturar una nueva, pulsando el botón Nueva instantánea.

To take a new snapshot of the entire desktop, select the Full Screen combo box entry (next to the Capture mode: label), and then click on the New Snapshot button. &ksnapshot; will now capture the entire desktop if you press New Snapshot.

Similarly, to take a snapshot of a region, select the Region combo box entry (next to the Capture mode: label) and set the Snapshot delay to No delay, and then click on the New Snapshot button. The mouse cursor will then change into a cross, and you can then use the mouse to select the region you want to capture.

### Características adicionales

#### Retardo de la instantánea

La caja Retardo de la instantánea le permite introducir un tiempo de retardo arbitrario, en segundos, entre el momento en el que pinche el botón Nueva instantánea y el momento en el que se tome la instantánea.

Cuando se establece un tiempo de retardo, no hay que pulsar el botón del ratón para hacer la instantánea. Esto permite abrir un menú desplegable, y tomar una imagen de él.

#### Excluir las decoraciones de las ventana

Incluir decoraciones de las ventanas está activado de forma predeterminada.

Cuando únicamente desea capturar la aplicación, sin la decoración de la ventana que la rodea, desactive esta opción y tome una nueva instantánea.

#### Imprimir

Si desea imprimir la instantánea desde la previsualización, pulse Imprimir... y se abrirá un diálogo de impresión estándar de KDE, donde podrá imprimir directamente su instantánea.

#### Botones

Hay dos botones más situados en la parte inferior de la ventana de &ksnapshot;. Su función se describe a continuación.

Ayuda

- Gives you a menu where you can open the &ksnapshot; Handbook, report a bug or get some more information about &kde; and &ksnapshot;.

Salir

- Sale de la aplicación &ksnapshot;.

## Interfaz &DCOP;

Con &ksnapshot; se pueden utilizar scripts utilizando su interfaz &DCOP;. Este capítulo explica varias llamadas &DCOP; que pueden utilizarse, proporcionando algunos ejemplos de cómo utilizarlas.

As with all DCOP calls, you need to specify the application you want to interface with, and the particular interface. With &ksnapshot; you need to identify which particular application, which is `ksnapshot-` followed by the process number.

Para iniciar &ksnapshot; y obtener el argumento correcto, utilice `dcopstart ksnapshot`, que devolverá el argumento (por ejemplo `ksnapshot-20594` en una salida estándar.

Puede obtener una lista de las interfaces &DCOP; disponibles utilizando los argumentos adecuados, como los que se muestran en este ejemplo:

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

En los ejemplos siguientes, el proceso será siempre `ksnapshot-23151`.

### Acceso a los parámetros de &DCOP;

For each of the settings that you can control with the GUI, you can both obtain the current status of that setting, and modify the setting, using &DCOP;.

Puede obtener el modo de captura actual utilizando la llamada `grabMode`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface grabMode

Esto devolverá `0` para una captura de pantalla completa, `1` para la captura de una ventana y `2` para la de un área.

Puede asignar el modo de captura utilizando `setGrabMode`, que precisará un argumento para identificar el modo requerido (el mismo que en la llamada `grabMode`). Por tanto, para asignar el modo de captura de una ventana (`1`), se utilizará:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Puede obtener el retardo actual (elemento Retardo de la instantánea:) utilizando la llamada `timeout`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface timeout

Esto devolverá el retardo en segundos, o cero si no hay retardo (pulsando se captura).

Puede asignar el retardo utilizando `setTime`, que requerirá un argumento para identificar la duración del retardo. Por tanto, podrá establecer el retardo en 4 segundos utilizando:

    $ dcop ksnapshot-23151 interface setTime 4

You can obtain the path that the snapshot will be saved to using `url`, as shown below:

    $dcop ksnapshot-23151 interface url

This will return the filename, as a URL (eg as `file:///home/bradh/test2.png`).

Puede asignar la ruta utilizando la orden `setURL`, que precisará como argumento una cadena que contenga la ruta nueva. Por tanto para cambiar la ruta a `file:///home/bradh/snapshot.jpg` se utilizará:

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

### Hacer capturas de pantalla con &DCOP;

La clave para realizar capturas de pantalla con &DCOP; es utilizar la orden `slotGrab`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface slotGrab

Esto tomará una instantánea utilizando el modo y retardo definidos (tal y como se describe debajo). Si desea guardar la imagen de la instantánea, debe utilizar una serie de llamadas. Si desea guardar la imagen en la ruta actual (tal y como se devuelve por `url`) o cambiarla con `setURL`, puede llamar a `slotSave`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface slotSave

Si desea que el usuario pueda especificar el nombre de archivo (y de ruta), puede utilizar `slotSaveAs`, con lo que aparecerá un diálog estándar de &kde; para guardar el archivo.

If you want to save the image to a different name (or path) without changing the path with `setURL`, you can use `save`, providing the URL to save to as an argument. So if you want to save the snapshot to `file:///tmp/tempshot.png`, you can do the following:

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

Note that this will return true if the snapshot was successfully saved, and false otherwise. Also, you should be aware that if the file already exists, the user will get a standard &kde; dialog that requires the user to decide whether to overwrite or not.

Además de guardar la instantánea, también puede copiarla al portapapeles, utilizando `slotCopy`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface slotCopy

Si precisa seleccionar una ventana que no esté bajo el cursor, puede utilizar `slotMovePointer`, pasando la posición x (en pixels de pantalla) y la posición y (en pixels de pantalla) como argumentos. Por tanto para mover el ratón a la esquina superior izquierda de la pantalla (0,0), podrá hacer lo siguiente:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Imprimir instantáneas con &DCOP;

Puede imprimir la instantánea actual (que puede o no haber sido guardada) utilizando `printSlot`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface slotPrint

Tenga en cuenta que esto hará aparecer el diálogo de impresión habitual de &kde;, que requerirá interacción del usuario.

### Control de la aplicación con &DCOP;

Puede utilizar &ksnapshot; para salir utilizando `exit`, tal y como se muestra a continuación.

    $ dcop ksnapshot-23151 interface exit

## Créditos y licencia:

Copyright del programa:

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

- 2000 Matthias Ettrich ettrich@kde.org

Documentation based on the original, copyright 1997-2000 Richard J. Moore rich@kde.org

Traducido por Miguel Revilla Rodríguez yo@miguelrevilla.com y Javier Fdez. Retenagajfrtnaga@yahoo.es

&underFDL; &underGPL;
&documentation.index;