<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1-Based Variant V1.0//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kooka;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE"
> <!-- change language only here --> 
]>

<book lang="&language;">

<bookinfo>
<title
>El manual de &kooka;</title>

<authorgroup>
<author
> <firstname
>Martin</firstname
> <surname
>Sommer</surname
> <affiliation
><address
><email
>msommer@suse.de</email
></address
></affiliation
> </author>
<othercredit role="developer">
<firstname
>Klaas</firstname>
<surname
>Freitag</surname>
<affiliation>
<address
><email
>freitag@suse.de</email
></address>
</affiliation>
<contrib
>Desarrollador</contrib>
</othercredit>

<othercredit role="translator"
> <firstname
>Miguel</firstname
> <surname
>Revilla Rodríguez</surname
> <affiliation
><address
><email
>yo@miguelrevilla.com</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit>

</authorgroup>

<copyright>
<year
>2002</year>
<holder
>Klaas Freitag, Martin Sommer</holder>
</copyright>

<legalnotice

>&FDLNotice;</legalnotice>

<date
>2002-02-04</date>
<releaseinfo
>0.33.00</releaseinfo>

<abstract
><para
>&kooka; es una útil aplicación para escanear en &kde;</para
></abstract
> 


<keywordset>
<keyword
>KDE</keyword>
<keyword
>Escáner</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducción</title>

<para
>&kooka; es una aplicación de &kde; que facilita la adquisición de imágenes mediante las bibliotecas <acronym
>SANE</acronym
>. Por lo tanto, para que &kooka; funcione es necesario que el paquete <acronym
>SANE</acronym
> esté instalado. El objetivo de este desarrollo ha sido el de ser claros y concisos.</para>

<para
>También se proporciona reconocimiento de caracteres mediante el programa gorc incluido. Instale <application
>gocr</application
> para hacer uso de esta funcionalidad. Una vez finalizado el reconocimiento de los caracteres, el material resultante se puede abrir con el editor &kate; con una sola pulsación de ratón, donde se podrá modificar el contenido.</para>

</chapter>

<chapter id="how-to-use">
<title
>Instrucciones de la aplicación</title>

<para
>La página web <ulink url="http://www.mostang.com/sane"
>http://www.mostang.com/sane</ulink
> tiene información sobre los escáneres admitidos. Si le resulta posible, consúltelo antes de adquirir un escáner.</para>

<sect1 id="screen">
<title
>La ventana principal de &kooka;</title>

<screenshot
> <screeninfo
>La ventana principal de &kooka; </screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="common/kooka_mainctrl.png" format="PNG"/></imageobject
> </mediaobject
> </screenshot
>  

<para
>Inicie &kooka; desde la consola mediante la introducción del comando <userinput
><command
>kooka</command
></userinput
>. Si lo desea, puede añadir un enlace en el escritorio de &kde; que esté representado por un icono que muestre un escáner.</para>

<para
>La ventana principal de &kooka; consta de tres marcos. En el superior se encuentran tanto los iconos como los paneles de menú. Utilice el ratón para aumentar o reducir la ventana si es necesario.</para>

<itemizedlist
> <listitem
> <para
>La ventana de navegación consta de dos apartados, que le permiten cambiar entre <guilabel
>Previsualización</guilabel
> y el navegador de archivos incorporado que se denomina la <guilabel
>Galería</guilabel
>. El directorio de trabajo aparece en la parte inferior de la ventana junto con el directorio en el que se guardarán las imágenes obtenidas.</para
> </listitem
> <listitem
> <para
>Establezca las opciones concretas para su escáner, dependiendo de qué modelo tenga, en la ventana de la parte inferior izquierda. Normalmente los parámetros tendrán que ver con la resolución, brillo y contraste, modo de exploración (&eg;, color, gris o binario), y con valores de gamma.</para
> <para
>Lo primero que debe hacer es configurar aquí sus opciones. Después de eso, inicie la exploración de previsualización con <guimenuitem
>Previsualización</guimenuitem
>. Si el apartado <guilabel
>Previsualización</guilabel
> está seleccionado, podrá ver ahí los resultados.</para
> <para
>Seleccione los diversos formatos en la propia imagen previsualizada para definir las dimensiones finales. Para esto se recomienda la opción <guilabel
>Usuario</guilabel
>, así que seleccione con el ratón el área a explorar en la imagen previa.</para
> <para
>Una vez hecho esto, pulse en <guimenu
>Explorar</guimenu
> para realizar la adquisición del área selecciona en la previsualización. Una vez finalizada la exploración, se le preguntará en qué formato desea guardar la imagen para que este sea su formado predeterminado (sin que se le pida que confirme la selección en posteriores ocasiones).</para
> <note
><para
>Si ha seleccionado la opción de no ser preguntado acerca del formato de almacenamiento, el asistente no volverá a aparecer. Para cambiar el formato en el futuro, selecciones <menuchoice
> <guimenu
>Opciones</guimenu
> <guimenuitem
>Configurar Kooka...</guimenuitem
> <guimenuitem
>Guardar imagen</guimenuitem
> <guimenuitem
>Mostrar siempre el asistente de almacenamiento de imágenes</guimenuitem
> </menuchoice
></para
></note
> </listitem
> <listitem
> <para
>La ventana más grande muestra cómo aparece la imagen tras la exploración final.</para
> </listitem
> </itemizedlist>

</sect1>

</chapter>

<chapter id="prefs">
<title
>Opciones</title>

<para
>Los iconos del panel han vuelto al panel de menú, excepto el de la impresora, bajo <guilabel
>Opciones de la imagen</guilabel
>. La opción para imprimir se encuentra en el menú <guilabel
>Archivo</guilabel
>. Cada elemento del menú en las opciones de imagen se describe brevemente más adelante.</para>

<variablelist
> <varlistentry
> <term
> <menuchoice
> <shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Abrir imagen en aplicación gráfica</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Introduzca una aplicación gráfica para abrir directamente las imágenes exploradas. Entre otras recomendadas se incluye <application
>The GIMP</application
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Imagen OCR...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Inicia la ventana del reconocimiento óptico de caracteres (<acronym
>OCR</acronym
>). Si usted tiene instalado <application
>gocr</application
>, la ruta para accederlo debe estar correctamente configurada en el sistema. De esta forma se iniciará el reconocimiento de caracteres de la imagen previa o del área seleccionada.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>OCR en selección...</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Reaparecerá una ventana para el reconocimiento de caracteres. Aquí, sin embargo, el reconocimiento sólo se produce en el área seleccionada en la exploración final.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>I</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Ajustar al ancho</guimenuitem
> </menuchoice
></term
> <listitem 
> <para
>Se redimensiona de forma proporcional el lienzo tomando como anchura la de la pantalla.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Ajustar a la altura</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Se redimensiona la imagen de forma proporcional en función de la altura de la pantalla.</para
> </listitem 
> </varlistentry
> <varlistentry
> <term 
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Tamaño original</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Recupera el tamaño de exploración original aumentando o disminuyendo la imagen en la pantalla.</para
> <para
>Existen métodos adicionales para redimensionar una imagen: Pinchar sobre la imagen con el botón <mousebutton
>derecho</mousebutton
> del ratón. Redefinir las tres opciones nombradas y establecer la propia ampliación. Esto también se puede hacer en la ventana de <guilabel
>Previsualización</guilabel
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Crear desde la selección</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Si la imagen explorada incluye más información de la que usted quiere que aparezca en la imagen final, utilice esta herramienta para recortar la imagen marcando la selección en la versión grande de la derecha y después seleccionando esta herramienta. La imagen será recortada de acuerdo con su selección. Puede que esta función se resulte familiar si está habituado a trabajar con <application
>The GIMP</application
>.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>V</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Crear imagen especular vertical</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Voltea la imagen verticalmente.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>M</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Crear imagen especular horizontal</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
>Voltea la imagen horizontalmente.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>B</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Crear imagen especular en ambas direcciones</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Voltea la imagen tanto vertical como horizontalmente.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Rotar imagen en la dirección de las agujas del reloj</guimenuitem
> </menuchoice
></term
> <listitem
> <para
>Gira la imagen noventa grados hacia la derecha.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>W</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Rotar imagen en contra de la dirección de las agujas del reloj</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
>Gira la imagen noventa grados hacia la izquierda.</para
> </listitem
> </varlistentry
> <varlistentry
> <term
> <menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>D</keycap
></keycombo
> </shortcut
> <guimenu
>Lienzo de imagen</guimenu
> <guimenuitem
>Rotar imagen 180 grados</guimenuitem
> </menuchoice
> </term
> <listitem
> <para
>Gira la imagen 180 grados.</para
> </listitem
> </varlistentry
> </variablelist>

</chapter>

<chapter id="save">
<title
>Guardar</title>

<para
>El método de almacenamiento de una imagen difiere en &kooka; un poco con respecto a la mayoría de aplicaciones. Pinche en el apartado <guilabel
>Galería</guilabel
> para abrir un pequeño navegador de archivos. Este es el directorio <filename class="directory"
>~/.kde/share/apps/ScanImages/</filename
>. En la parte inferior de la ventana, se mostrará el subdirectorio de galería actual. Este es el lugar en el que se almacenan por primera vez las imágenes como archivos. Al iniciar &kooka; por primera vez, sólo verá el directorio <filename class="directory"
>ScanImages</filename
>. Puede crear subdirectorios pinchando en la carpeta con el botón <mousebutton
>derecho</mousebutton
> del ratón. La carpeta seleccionada, destacada en azul, es el lugar de almacenamiento primario de las imágenes obtenidas. Estas se nombran en orden numérico ascendente como <filename
>kscan_0001</filename
> y<filename
>kscan_0002</filename
>.</para>

<para
>Para guardar una imagen permanentemente, pinche sobre el nombre con el botón <mousebutton
>izquierdo</mousebutton
> del ratón. A continuación, introduzca un nuevo nombre al archivo y una extensión acorde con el formato elegido al iniciar la exploración. Si introduce una extensión diferente, recibirá un mensaje de error indicando que ese formato no corresponde con el explorado. Aunque sí puede guardar una imagen bajo ese nombre, esta conservará su formato original. En este momento no está disponible la conversión <quote
>al vuelo</quote
>.</para

><para
>Si no desea utilizar este método para administrar su imágenes en <filename class="directory"
>~/.kde/share/apps/ScanImages/</filename
>, siempre puede, desde luego, guardarlas en otro lugar. Para hacerlo, pinche sobre el nombre de la imagen con el botón <mousebutton
>derecho</mousebutton
> del ratón y seleccione <guilabel
>Guardar</guilabel
>. Elija aquí cualquier ruta. Además también puede cerrar o eliminar imágenes desde el mismo menú.</para>

<para
>Para incorporar otras imágenes a la galeróa, añádalas en &konqueror; por el método de arrastrar y soltar. Abra &konqueror; y sitúese en el directorio que contenga las imágenes deseadas. Para añadirlas a la galería de &kooka; arrástrelas y suéltelas sobre la misma.</para>

</chapter>

<chapter id="ocr">
<title
>Reconocimiento de caracteres</title>

<para
>Como ya se ha mencionado, en necesario que <application
>gocr</application
> esté instalado. Explore una previsualización de su documento en escala de grises o color. Sólo podrá explorar en modo binario si tiene una página totalmente blanca impresa en tinta totalmente negra. A continuación resalte en la ventana de previsualización el texto que se debe reconocer. Por último haga la última exploración en modo binario con el botón <guibutton
>Explorar</guibutton
>.</para>

<para
>Ahora pinche en el segundo icono de la izquierda en el panel de iconos, <guilabel
>Reconocimiento de caracteres en imagen...</guilabel
>, o seleccione este mismo elemento en el menú <guilabel
>Lienzo de imagen</guilabel
>. En su primer intento, no cambie los parámetros por defecto que se muestran en la ventana <acronym
>OCR</acronym
> emergente. Normalmente son adecuados para la mayoría de las necesidades. Después pinche en <guimenuitem
>Iniciar reconocimiento de caracteres</guimenuitem
>. Por último verá una ventana que contendrá los resultados del <acronym
>OCR</acronym
>. La calidad depende mucho del propio documento explorado. </para>

<screenshot
> <screeninfo
>La ventana gocr</screeninfo
> <mediaobject
> <imageobject
><imagedata fileref="common/kooka_gocr.png" format="PNG"/></imageobject
> </mediaobject
> </screenshot>

<para
>El texto se puede abrir con el editor &kate; pinchando en el botón. Después de la exploración final, haga una selección en la imagen mostrada a la derecha para cargar sólo una parte del texto o la imagen en el <acronym
>OCR</acronym
>. A continuación, en el panel de iconos, pinche en el tercero por la izquierda o en el menú la opción <guimenuitem
>OCR en selección</guimenuitem
>. A continuación proceda como se describe en la sección anterior.</para>

<screenshot
> <screeninfo
>Los resultados del <acronym
>OCR</acronym
></screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="common/kooka_gocr_result.png" format="PNG"/></imageobject
> </mediaobject
> </screenshot>

</chapter>

<chapter id="credits">
<title
>Créditos y licencia</title>
 
<para
>&kooka;</para>

<para
> Copyright de la aplicación 2001-2002 Klaas Freitag <email
>freitag@suse.de</email
></para>

<para
>Copyright de la documentación 2002 Martin Sommer <email
>msommer@suse.de</email
></para>

<para
>Traducido por Miguel Revilla Rodríguez <email
>yo@miguelrevilla.com</email
></para>

&underFDL;
&underGPL;

</chapter
>  

<appendix id="installation">
<title
>Instalación</title>

&install.intro.documentation;

&install.compile.documentation;
                
</appendix>

</book>

