# Manual de &spectacle;

## Introducción

&spectacle; es una aplicación para realizar capturas de pantalla del escritorio y editarlas. Puede capturar imágenes de todo el escritorio, de un único monitor, de la ventana activa actual, de la ventana que esté bajo el cursor o de una región rectangular de la pantalla. Estas imágenes pueden contener notas, se pueden imprimir, enviar a otras aplicaciones para que las procesen o guardar rápidamente en disco.

Informe de cualquier fallo o de sus peticiones de funcionalidades en el sistema de seguimiento de fallos de &kde;.

## Inicio de &spectacle;

&spectacle; se puede iniciar de diversos modos, como se describe a continuación:

- Puede encontrar &spectacle; en el menú del lanzador de aplicaciones, en Aplicaciones Utilidades Utilidad de capturas de pantalla &spectacle;

- Al pulsar el botón Imprimir Pantalla del teclado (normalmente con la etiqueta ImprPant o similar) se lanzará &spectacle; de forma inmediata. Además, dispone de tres atajos de teclado adicionales para realizar capturas de pantalla y guardarlas en la carpeta por omisión para guardar sin necesidad de mostrar la interfaz de usuario:

  - Meta Imprimir Pantalla realizará una captura de la ventana activa

  - &Shift;Imprimir Pantalla realizará una captura de todo el escritorio (es decir, de todos los monitores)

  - Meta&Shift;Imprimir Pantalla realizará una captura de una región rectangular

  Puede definir la ubicación de destino para guardar imágenes y el nombre de archivo por omisión a usar iniciando &spectacle; normalmente, pulsando el botón Configurar... y yendo a la sección «Guardar».

- También puede usar la línea de órdenes mínima de &krunner; (invocado con &Alt;F2) para lanzar &spectacle;.

- Puede iniciar &spectacle; desde la línea de órdenes. &spectacle; posee un buen juego de opciones para la línea de órdenes, incluido un modo de trabajo en segundo plano que puede usar desde un guion para realizar capturas de pantalla sin necesidad de mostrar la &GUI; ni de necesitar la intervención del usuario.

  Para iniciar &spectacle; desde la línea de órdenes, escriba:

      % spectacle &

  Para ver la lista completa de las opciones de la línea de órdenes y su explicación, escriba:

      % spectacle --help

## Uso de &spectacle;

Una vez que se inicia &spectacle;, verá una ventana como la siguiente: La ventana principal de &spectacle;

&spectacle; obtiene inmediatamente una imagen de todo su escritorio en cuanto se lanza, justo antes de que se muestre a sí mismo en la pantalla. Esto le permite crear rápidamente imágenes de capturas de todo el escritorio.

La captura obtenida por &spectacle; se muestra en la ventana de vista previa, que está situada en la parte izquierda de la ventana de la aplicación &spectacle;.

Puede guardar la imagen en cualquier lugar de su elección pulsando el botón Guardar como... o &Ctrl;&Shift;S. Esto abre el diálogo estándar para guardar, donde puede elegir un archivo, la carpeta de destino y el formato en el que se guardará la captura de pantalla. Puede cambiar el nombre del archivo a cualquier cosa que desee, incluso el nombre de una captura guardada anteriormente.

Para guardar una captura de pantalla en el lugar por omisión, pulse la parte de la flecha del botón Guardar como... y pulse el botón Guardar (&Ctrl;S). El nuevo modo de guardar capturas se recordará para la próxima vez. El lugar donde guardar y el nombre de archivo por omisión se pueden configurar, como se describirá más adelante.

Para guardar de forma inmediata la imagen y salir de &spectacle;, marque la casilla Salir tras guardar o copiar manualmente, pulse luego la parte de la flecha del botón Guardar como... y pulse la opción Guardar (&Ctrl;S). Esto hará que se guarde la imagen como archivo PNG en la carpeta `Imágenes` y se saldrá de la aplicación inmediatamente. Como antes, este modo nuevo de guardar se usará la próxima vez.

### Haciendo una captura de pantalla

Tras abrir &spectacle;, se realizará inmediatamente una captura de toda la pantalla por conveniencia, a menos que se haya indicado otra cosa en las opciones generales, y se mostrará una vista previa de ella en la ventana principal. Puede guardar esta captura usando los botones de la parte inferior de la ventana o realizar una nueva usando los controles que hay a la derecha de la vista previa.

Para descartar la captura de pantalla actual y realizar otra, pulse el botón Realizar nueva captura de pantalla (&Ctrl;N).

Tras realizar una captura de pantalla, &spectacle; le mostrará un panel informativo con un enlace al archivo que contiene la captura de pantalla y le ofrece la posibilidad de Abrir la carpeta que lo contiene.

Puede configurar ciertas opciones en la parte derecha de la ventana de la aplicación antes de realizar una captura. Estas opciones le permiten seleccionar el área de la pantalla que se debe capturar, establecer una demora antes de capturar la imagen y configurar si el cursor del ratón y las decoraciones de la ventana se deben capturar junto a la imagen.

#### Modo de captura

Las preferencias del modo de captura le permiten definir el área de la pantalla que se debe capturar y si debe existir una demora entre la pulsación del botón Realizar nueva captura de pantalla (&Ctrl;N) y la captura de la pantalla. También puede activar la casilla >Al pulsar, que desactiva la función de demora y realiza la captura en cuanto haga clic en cualquier parte de la pantalla tras pulsar el botón Realizar nueva captura de pantalla (&Ctrl;N).

La lista desplegable Área le permite definir el área de la pantalla que se debe capturar. Puede elegir cualquiera de las cinco opciones que se describen más adelante.

- La opción Pantalla completa (todos los monitores) realiza una captura de todo el escritorio, comprendiendo todas las salidas (todos los monitores, proyectores, etc.).

- La opción Pantalla actual realiza una captura de pantalla de la salida que contenga el puntero del ratón.

- La opción Región rectangular le permite seleccionar una región rectangular del escritorio con el ratón. Esta región se puede extender a más de una salida.

  Este modo lo realiza la captura de forma inmediata, sino que le permite dibujar un rectángulo en la pantalla, que puede mover o cambiar de tamaño según sus necesidades. Una vez que haya terminado de dibujar el rectángulo de selección, haga doble clic en cualquier parte de la pantalla o pulse la tecla &Enter; del teclado para realizar la captura.

  Puede usar las teclas de las flechas para mover y ajustar el rectángulo. Puede mover el rectángulo pulsando las teclas de las flechas. Si mantiene pulsada la tecla &Shift; mientras pulsa las teclas de las flechas, moverá el rectángulo lentamente para poder ajustar la selección con precisión. Si mantiene pulsada la tecla &Alt; mientras pulsa las teclas de las flechas, podrá ajustar el tamaño del rectángulo.

- La opción Ventana actual realiza una captura de la ventana actualmente activa (la que contiene el foco). Es recomendable que use una demora en este modo para que le permita seleccionar y activar una determinada ventana antes de realizar la captura.

- La opción Ventana bajo el cursor realiza una captura de la ventana que esté bajo el cursor del ratón. Si el cursor está encima de un menú emergente, &spectacle; tratará de realizar una captura del menú y de la ventana a la que pertenece.

  Aunque esto funciona bien casi siempre, en algunos casos puede fallar la obtención de información sobre la ventana que contiene el menú. Cuando ocurre esto, &spectacle; recurre al modo antiguo de capturar la imagen automáticamente, realizando solo una captura del menú emergente. También puede forzar este modo antiguo de realizar capturas marcando la casilla Capturar solo la ventana emergente actual, en Opciones.

El selector numérico Demora le permite fijar la demora entre la pulsación del botón Realizar nueva captura de pantalla (&Ctrl;N) y la toma de la captura de pantalla. Puede fijar esta demora en incrementos de 1 segundo usando los botones del control numérico o el teclado.

Al realizar una captura de pantalla con demora, &spectacle; muestra en el título de la ventana el tiempo que falta antes de realizar la captura y también hace que sea visible en el correspondiente elemento del gestor de tareas. El botón de &spectacle; en el gestor de tareas también muestra una barra de avance para que pueda hacerse una idea de cuándo se realizará la captura de pantalla.

Mientras espera a que se obtenga la captura de pantalla con demora, puede restaurar la ventana de &spectacle;, donde el botón Realizar una nueva captura de pantalla se habrá convertido en un botón Cancelar. Aquí también se mostrará la barra de avance, ofreciéndole la oportunidad de detener la cuenta atrás.

Si marca la casilla Al pulsar se ignora la demora. Cuando está marcada esta casilla, al pulsar el botón Realizar nueva captura de pantalla (&Ctrl;N) se oculta la ventana de &spectacle; y el cursor del ratón cambia a una cruceta. La captura de pantalla se realiza al pulsar el botón izquierdo del ratón, o se interrumpe si se pulsa cualquier otro botón del ratón. Tenga en cuenta que no puede interactuar con el escritorio usando el ratón mientras el cursor sea una cruceta, aunque puede usar el teclado.

#### Opciones

Las opciones le permiten seleccionar si se debe incluir el cursor del ratón en la captura de pantalla y si también se deben capturar las decoraciones de las ventanas de forma conjunta en la imagen de la ventana de la aplicación. En el modo Ventana bajo el cursor, también le permite seleccionar si &spectacle; debe capturar solo la imagen del menú emergente actual bajo el cursor, o si también se debe incluir la ventana que lo contiene. Finalmente, Salir tras guardar o copiar saldrá de &spectacle; tras cualquier operación de guardar o copiar.

- Si marca la casilla Incluir el puntero del ratón, se incluye una imagen del puntero del ratón en la captura de pantalla.

- La opción Incluir barra de título y bordes de la ventana solo está activa cuando se ha seleccionado uno de los modos Ventana activa o Ventana bajo el cursor en la lista desplegable Área. Si marca esta opción, se incluirán los bordes de la ventana y su decoración en la captura de pantalla; por el contrario, si la desmarca, solo se realizará una captura del contenido de la ventana.

- La opción Incluir sombra de la ventana solo está activa cuando se ha seleccionado uno de los modos Ventana activa o Ventana bajo el cursor en la lista desplegable Área. Si marca esta opción, se incluirá la sombra de la en la captura de pantalla; por el contrario, si la desmarca, se realizará una captura de la ventana sin su sombra.

- La opción Capturar solo la ventana emergente actual solo está activa cuando se selecciona el modo Ventana bajo el cursor en la lista desplegable Área. Si marca esta opción, solo se capturará el menú emergente situado bajo el cursor, sin la ventana que lo contiene.

- La opción Salir tras guardar o copiar de forma manual saldrá de &spectacle; tras cualquier operación de guardar o copiar. Tenga en cuenta que una captura de pantalla copiada solo permanecerá activa si está usando un gestor del portapapeles que acepte imágenes. Puede configurar Klipper de KDE para ello haciendo clic con el botón derecho del ratón sobre su icono, seleccionando Configurar el portapapeles... y desmarcando Ignorar imágenes.

## Funciones adicionales

### Botones

Existen varios botones situados en la parte inferior de la ventana de &spectacle;. Sus funciones se describen a continuación:

Ayuda

- Le proporciona los elementos de menú comunes que se describen en el menú de ayuda de los fundamentos de &kde;.

Configurar...

- Le proporciona acceso a la ventana de configuración de &spectacle;, donde puede cambiar las preferencias de la captura y el lugar y el nombre de archivo por omisión para guardar las capturas.

Anotar

- Abre una ventana de edición de notas que le ofrece varias herramientas de anotación:

  Editor de anotaciones

  Pruebe las herramientas de anotaciones. Aquí puede encontrar todo lo necesario para describir sus capturas de pantalla: flechas, lápiz, marcadores, cuadros de texto, números, e incluso emoticonos. Puede cambiar los parámetros de la herramienta y añadir efectos (sombra, escala de grises y borde).

  Cuando crea que la anotación está terminada, pulse el botón Anotación terminada.

Herramientas

- Abre un menú desplegable que le ofrece varias herramientas:

  - Abrir la carpeta predeterminada de capturas resaltará la última captura guardada en el gestor de archivos por omisión

  - Acceso al diálogo Imprimir

  - Un abanico de programas externos para grabar la pantalla

Exportar

- Abre un menú desplegable que le permitirá abrir directamente la captura de pantalla con todos los programas asociados con el tipo &MIME; PNG (gráficos de red portables). Dependiendo de los programas que tenga instalados, podrá abrir y editar la captura de pantalla en una aplicación de gráficos o en un visor.

Copiar imagen en el portapapeles/Copiar ubicación en el portapapeles

- Copia la captura de pantalla actual o su ubicación en el portapapeles. También puede usar el atajo de teclado &Ctrl;C para el mismo fin.

Guardar como

- Guarda la captura de pantalla como una imagen PNG en la carpeta «Imágenes» por omisión y se sale inmediatamente de la aplicación.

### Configurar

Use el botón Configurar... para abrir el diálogo de configuración.

#### General

General

Al iniciar Spectacle

- Permite Realizar una captura de la pantalla completa, usar el último modo de captura usado o no realizar una captura de forma automática. El último modo de captura usado es el que se indica en «Modo de captura».

Tras realizar una captura de pantalla

- Permite guardar el archivo en la carpeta predeterminada, desactivar cualquier acción del portapapeles, copiar la imagen en el portapapeles o copiar la ruta de la captura de pantalla en el portapapeles. La ubicación predeterminada se puede configurar usando la página de configuración Guardar. Se puede Copiar la ubicación del archivo en el portapapeles. Así podrá pegarla en cualquier lugar que acepte una entrada de texto. Tenga en cuenta que debe estar ejecutando un gestor del portapapeles para poder guardar la ruta en el portapapeles tras cerrar &spectacle;.

Pulsar la tecla de captura de pantalla para

- Cuando se pulsa un atajo de teclado para realizar una captura de pantalla y &spectacle; está todavía en ejecución, es posible configurar el comportamiento del sistema de capturas de pantalla. Puede escoger entre realizar una nueva captura de pantalla, abrir una nueva ventana de &spectacle; o devolver el foco a la ventana de &spectacle; existente.

Usar fondo claro

- Usar un color de fondo claro para enmascarar el área remarcada en el sector de región rectangular. Esto facilita la visibilidad de los cursores oscuros.

Mostrar la lupa

- Cuando se guarda una captura de pantalla, copiar la ubicación en la que se ha guardado el archivo en el portapapeles. Así podrá pegarla en cualquier lugar que acepte una entrada de texto. Tenga en cuenta que debe estar ejecutando un gestor del portapapeles para poder guardar la ruta en el portapapeles tras cerrar &spectacle;.

Aceptar al hacer clic y soltar

- Si se marca, aceptar la región seleccionada en cuanto se libera el botón del ratón en el modo de Región rectangular.

  Cuando se selecciona una nueva región sin que se haya guardado previamente una región, pulsar, arrastrar y soltar el botón del ratón debe capturar de forma inmediata la región seleccionada. Si se muestra una región guardada previamente, la región guardada se puede modificar, siendo necesaria confirmación manual para guardar esta región (pulse &Enter; o haga doble clic con el &LMB;). Si pulsa y arrastra fuera de la región anteriormente guardada, se captura la nueva región seleccionada de manera inmediata.

Recordar el área seleccionada

- Por omisión, &spectacle; recuerda la selección inicial cuando realice una captura de una región rectangular hasta que cierre la ventana de &spectacle;. También puede hacer que &spectacle; no recuerde el área seleccionada o que la recuerde entre sesiones de captura de pantalla.

#### Guardar

Cuando use la función Guardar, &spectacle; guardará la imagen con un nombre de archivo por omisión en la carpeta «Imágenes» que hay dentro de su carpeta personal. El nombre de archivo por omisión incluye la fecha y la hora en la que se ha realizado la captura.

La página Guardar le permite definir la ubicación y el nombre de archivo a guardar por omisión. Al pulsar sobre esta opción se le muestra un diálogo como el siguiente: Guardar

Ubicación para guardar

- En el campo de texto de la ubicación, defina la carpeta en la que desea guardar las capturas de pantalla cuando pulse Guardar.

Calidad de compresión

- Escoger la calidad de la imagen al guardarla con formatos de imagen con pérdida de calidad, como JPEG. Los valores más altos proporcionan mejor calidad, aunque aumentan el tamaño del archivo. Consulte la página de la Wikipedia para más detalles sobre los formatos de imagen que se usan en &spectacle;.

Nombre de archivo

- Definir un nombre de archivo por omisión para las capturas guardadas.

  Puede usar las siguientes variables en el nombre de archivo, que se sustituirán por su correspondiente texto cuando se guarde el archivo:

  - `<dd>`: día

  - `<hh>`: hora

  - `<MM>`: mes

  - `<ss>`: segundos

  - `<title>`: título de la ventana

  - `<yyyy>`: año (4 dígitos)

  - `<#>`: número secuencial

  - `<mm>`: minutos

  - `<yy>`: año (2 dígitos)

  Puede pulsar sobre los parámetros de sustitución en la lista de referencia inferior para insertarlos en la línea Nombre de archivo.

  Si ya existiera un archivo con este nombre, se añadirá un número de serie al nombre del archivo. Por ejemplo, si el nombre del archivo es `Captura` y ya existe `Captura.png`, la imagen se guardará como `Captura-1.png`.

  Use la lista desplegable que hay junto al campo de texto para seleccionar el formato de imagen predeterminado para las capturas de pantalla. Consulte la página de la Wikipedia para más detalles sobre los formatos de imagen que se usan en &spectacle;.

#### Atajos de teclado

Puede usar esta página de configuración para cambiar los atajos de teclado predeterminados de &spectacle;. Puede configurar atajos de teclado para iniciar &spectacle; y capturar diferentes partes del escritorio.

### Arrastrar y soltar

Puede arrastrar una imagen capturada a otra aplicación o documento. Si dicha aplicación es capaz de manejar imágenes, se insertará en ella una copia de la imagen arrastrada.

Si arrastra una captura de pantalla hasta una ventana del gestor de archivos, se le mostrará un diálogo donde podrá editar el nombre del archivo y seleccionar el formato de la imagen. El archivo se insertará en la carpeta actual.

Si arrastra la captura de pantalla a un campo de texto, se mostrará en él la ruta del archivo temporal que se ha guardado. Esto resulta útil, por ejemplo, para enviar capturas de pantalla a foros web o para adjuntar capturas de pantalla a informes de errores en el sistema de seguimiento de fallos de &kde;.

Esto funciona con todos los clientes que no recojan los datos de la imagen, sino que solo buscan un &URL; en los datos MIME de la imagen que haya arrastrado.

## Créditos y licencia

Copyright del programa © 2015 &Boudhayan.Gupta; &Boudhayan.Gupta.mail;.

Algunas partes del código están basadas directamente en código del proyecto &ksnapshot;, Copyright © 1997-2011 por los desarrolladores de &ksnapshot;. Existen declaraciones de copyright más detalladas en las cabeceras del código fuente.

Algunas partes del código están basadas directamente en código del proyecto &kwin;, Copyright © 2008, 2013 por los desarrolladores de &kwin;. Existen declaraciones de copyright más detalladas en las cabeceras del código fuente.

La documentación está basada en la documentación original de &ksnapshot;:

- Copyright © 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

- Copyright © 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;

Documentación traducida al español por Eloy Cuadra ecuadra@eloihr.net.

&underFDL; &underGPL;
&documentation.index;