# El manual de &ksnapshot;

## Introducción

&ksnapshot; es una sencilla utilidad para tomar instantáneas. Es capaz de capturar imágenes de todo el escritorio, de una sola ventana, de parte de una ventana o del área seleccionada. Las imágenes pueden almacenarse en diversos formatos.

Por favor, informe de cualquier problema o petición de funcionalidad en , el sistema de información de fallos de &kde;

## 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.

- Puede iniciar &ksnapshot; seleccionándolo en el Menú K Gráficos Capturador de pantalla (&ksnapshot;).

- 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.

Con la opción Ningún retardo, la instantánea se tomará inmediatamente después de pulsar en una ventana.

&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.

Para tomar una nueva instantánea de todo el escritorio, active la opción Pantalla completa (al lado de la etiqueta Modo de captura:), y a continuación pulse sobre el botón Nueva instantánea. &ksnapshot; hará una captura de todo el escritorio.

De forma parecida, para hacer una captura de un área, active la entrada Área (al lado de la etiqueta Modo de captura:), en Retardo de la instantánea, seleccione Ningún retardo, y a continuación pulse el botón Nueva instantánea. El cursor del ratón se convertirá en una cruz, y podrá utilizarlo para seleccionar la región que se desee capturar.

Para hacer una captura de la sección de una ventana, seleccione Sección de ventana y a continuación pulse el botón Nueva instantánea. Con la opción Ningún retardo, el cursor del ratón se convertirá en una cruz y tendrá que pulsar con el &LMB; en la ventana deseada. La sección de la ventana situada bajo el cursor del ratón quedará entonces resaltada con un borde rojo. Coloque el ratón en la sección deseada y pulse con el &LMB; para hacer la captura.

### 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.

#### Copiar al portapapeles

Cuando quiera editar su captura de pantalla en un programa de tratamiento de imágenes sin guardar la captura, pulse en Copiar al portapapeles e inserte la imagen en el visor o programa de edición de gráficos.

#### 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

- Muestra un menú desde el que podrá abrir el Manual de &ksnapshot;, informar de un fallo y obtener más información Acerca de &ksnapshot; y Acerca de &kde;.

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.

Como en toda llamada &DCOP;, tendrá que especificar la aplicación con la que desea interactuar y la interfaz concreta. Con &ksnapshot; tendrá que señalar qué aplicación particular se utilizará, para lo cual escribirá `ksnapshot-` seguido del número de proceso.

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()
    TQString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(TQString nombrearchivo)
    void slotSaveAs()
    void slotCopy()
    void setTime(int nuevaHora)
    int timeout()
    void setURL(TQString 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;

Para cada uno de los parámetros que puede controlar mediante el &GUI;, utilizando &DCOP; puede obtener el estado actual del parámetro, así como modificarlo.

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

Puede obtener la ruta en la que se guardará la instántanea utilizando la llamada `url`, tal y como se muestra a continuación:

    $ dcop ksnapshot-23151 interface url

Esto devolverá el nombre del archivo en forma de &URL; (por ejemplo, `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.

Si desea guardar la imagen con un nombre diferente (o ruta) sin cambiar la ruta con `setURL`, puede utilizar `save`, proporcionando la &URL; como argumento. De modo que si desea guardar la instantánea en `file:///tmp/tempshot.png`, puede hacer lo siguiente:

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

Tenga en cuenta que esto devolverá 'true' si la instantánea se guardó correctamente, y 'false' en cualquier otro caso. Además, si el archivo existiera, al usuario se le mostrará un diálogo estándar de &kde; que le permitirá decidir si quiere sobreescribirlo o no.

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:

- &Richard.J.Moore; &Richard.J.Moore.mail;, 1997-2000

- &Matthias.Ettrich; &Matthias.Ettrich.mail;, 2000

Documentación basada en la original, copyright: &Richard.J.Moore; &Richard.J.Moore.mail;, 1997-2000

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

&underFDL; &underGPL;
&documentation.index;