# El manual de &ksnapshot;

Richard
J.
Moore

    rich@kde.org

Robert
L.
McCormick

    c0029131@airmail.net

Brad
Hards

    bradh@frogmouth.net

Lauri
Watts

    lauri@kde.org

Revisor
Richard
J
Moore

    rich@kde.org

Desarrollador
Matthias
Ettrich

    ettrich@kde.org

Desarrollador
Miguel
Revilla Rodríguez

    yo@miguelrevilla.com

Traductor
1997-2000
Richard J. Moore
2000
Matthias Ettrich
&FDLNotice;
2005-02-02
1.02.00

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

KDE
KSnapshot
kdegraphics
captura de pantalla
guardar pantalla

## Introducción

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

Por favor, informe de cualquier problema o petición de funcionalidad en el sistema de informe 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 submenú Gráficos del 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.... 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 si pulsa Nueva instantánea.

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

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

  Muestra un menú desde el que podrá abrir el Manual de &ksnapshot;, informar de un fallo y obtener información sobre &kde; y &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 como utilizarlas.

Con las llamadas DCOP necesitará especificar la aplicación con la que desee interactuar. Con &ksnapshot; precisará identificar qué aplicación en particular se utilizará, que será `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()
    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;

Para cada uno de los parámetros del GUI, puede tanto obtener tanto su estado como asignar su valor, utilizando &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

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

    $ 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. Por ello 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álog 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 la orden `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 la llamada `slotMovePointer`, pasando la posición x (en pixels de 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 la orden `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 la orden `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

La documentación está basada en la original, copyright 1997-2000 Richard J. Moore rich@kde.org

Traducido por Miguel Revilla Rodríguez yo@miguelrevilla.com

&underFDL; &underGPL;

&documentation.index;