/* Llegiume.txt
 * 21/01/2017
 *
 * @author Jordi Lagares Roset "jlagares@xtec.cat - www.lagares.org"
 * amb el suport del Departament d'Educacio de la Generalitat de Catalunya
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details (see the LICENSE file).
 */


==========================================================
KANGHOORU - (v: 117)
==========================================================
Falta documentar las versiones intermedias, pero las opciones del programa,
creemos son bastante autoexplicativas.

==========================================================
FUNCIONAMIENTO - HASTA versión 66 - 20/08/04
==========================================================
A partir de una idea original de Simón Martín - Gran Canaria.

El nombre viene de que en catalán se pronuncia como "canguro"
ya que el programa lo que hace es hacer saltar al "mouse" por
los lugares de la pantalla que desemos mediante barrido automático.

Está pensado para que personas con discapacidad motórica puedan 
controlar un programa que haga alguna cosa al ser clicado en distintas
zonas de la pantalla. 

Para ser controlado se precisa de un conmutador conectado al clic del
"mouse".

En: Català, Castellano, Galego, Euskara, Português, English

==========================================================
FUNCIONAMIENTO - HASTA versión 19
==========================================================
-Ejecutar un programa que deseeis que sea controlado mediante barrido.

-Pulsar el botón grabar o bién el menú grabar.

-Hacer clic en tantos puntos como deseis vaya el barrido autmomático.
1000 máximo.

-Parar grabación pulsando el botón derecho del ratón.

-Para empezar el barrido automático pulsar el botón ejecutar o bién el
menú, ejecutar.

-Para pararlo clic derecho del ratón.

-Se puede grabar la secuencia de puntos asociada a un programa en un archivo.
Menú, Guardar.

-Abrir dicho archivo mediante el menú. Abrir. Automàticamente se ejecuta 
el barrido automático.

-El programa asocia la extensión kan a dicho programa por lo que se puede 
ejecutar dicho tipo de archivos desde el administrador de archivos.

-Cuando se activa el barrido automático el programa se minimiza, por lo
que desaparece. Al hacer clic con el botón derecho y parar el barrido vuelve
a aparecer la ventana del programa.

-El quadro de edición con un número, 12 por defecto, indica las décimas de
segundo que dura el barrido. Dicho número puede variarse según el control
de conmutador del usuario. Dicho valor se guarda para sucesivos usos del
programa.

-Si se clica en la ventana principal se muestra la ventana de créditos. Pienso
que es bueno ejecutarla y ver la secuencia de imágenes que nos ofrece. Así
mismo si se clica en distintas partes de la ventana podemos encontrarnos con
sorpresas.

-El menú ayuda abre este archivo. Sólo funciona si no hemos cambiado el directorio
donde se halla el programa.

==========================================================
NOVEDADES - HASTA versión 41
==========================================================
-Hay un nuevo menú, Barrido &dirigido, clic derecho, Tab o teclado (0..9,A..Z)
"Cuando se activa este menú al ejecutar no se realiza barrido" automàtico se passa 
de una posición a la otra mediante el clic derecho del ratón (Barrido dirigido). 
O mediante la tecla TAB. O Las teclas 0,1,2,3,4,5,6,7,8,9,A..Z lo que permite a 
acceder directamente a 36 puntos distintos.
Para parar simplemente activar la ventana mediante las tecla ALT+TAB	

-Hay un nuevo menú, que al acceder a las distintas posiciones directamente mediante 
las teclas Barrido &dirigido, clic derecho, Tab o teclado (0..9,A..Z) se active el 
clic automàticamente. En clic puede activarse manualmente mediante la tecla RETURN.

-Hay una nueva opción de menú que si se activa no permite hacer dos clics seguidos a
menos que la separación de tiempos sea mayor que el tiempo marcado en el nuevo cuadro.
Éste está expresado en décimas de segundo. Si no hay puntos de canguro y está activada
esta opción permite controlar los clics seguidos de personas que utilicen el powerpoint
por ejemplo. Es decir controlar el salto de dos, tres o más pantallas seguidas por
realizar demasiados clics.

-Hay una nueva opción, Menú NUEVO que borra los puntos de canguro anteriormente grabados.
Para ayudar a la anterior opción.

-Hay un nuevo menú que se deberá activar si el ratón está configurado para usuarios zurdos.
Es decir estén intercambiadas las funciones de los botones del ratón.

-Hat una nueva opción de menú,"Enviar Tabs y Return" , que si se activa, en lugar de cambiar
la posición del ratón lo que hace es enviar TAB, con escaneo automàtico (o bién mediante clic 
derecho si està activada la opción) y cuando lo que hace es enviar un clic el lo traduce
en ub RETURN. Para controlar aplicaciones tipo página web que para moverse de un link
(o zona activa) a otro se haga mediante la tecla, TAB (Tabulador) y la activación mediante
la tecla RETURN

==========================================================
42-43-Hay una opción del menú, Cuadro seguimiento del mouse que hace que un cuadrado rojo 
enmarca las posiciones dle ratón por si hay dificultades de visión.

44-Se ha quitado la opción, EsperarIntervaloDetiempoEntre2Clics, está activada siempre. 
Si no sequiere que funione poner a 0 el intervalo de tiempo entre dos clics.

45-47-Optimización de código

48-En barrido dirigido se puede cambiar la posición con las teclas + y flecha derecha. 
Lo mismo que el Tab.

49-59-Optimización de código

60-Menús en catalán.

61-Optimización de código

62-Menús en Euskera. Gracias Iñaki Torices.

63-Menús en Gallego. Gracias Beatriz García Oñate y Alberto Cifuentes. www.canalciencia.com.


==========================================================
FAQ
==========================================================
PREGUNTA 1:
...tenemos una página Web de programas educativos informáticos destinada a alumnos de 
Educación Especial, Educación Infantil y Primaria.
La dirección de la página es http://perso.wanadoo.es/postigoaula
Últimamente estamos incorporando varios de tus programas destinados a los alumnos con 
Necesidades Educativas Especiales. Entre esos programas está Kanghooru. Como de cada 
programa hacemos una ficha, en este caso me gustaría saber cuál es la utilidad, 
dentro de Kanghooru de la opción "En ejecución, buscar fichero de barrido" ya que yo 
todavía no he sido capaz de descubrir su función y tampoco la encuentro en el manual 
que incorporas...
RESPUESTA 1:
-Si, efectivamente, esta opción no está muy documentada.
-Si activas esta opción verás que después de grabar los puntos de barrido te sale un menú 
guardar fichero. Como nombre de fichero pone el título de la ventana actualmente activa. 
-Si dices guardar, siempre que tengas la opción activada y estés en modalidad barrido automático,
si por la razón que sea se activa dicha ventana el barrido se producirá en los puntos 
definidos para esta ventana.
 
-¿Porqué esta opción?
-En general kanghooru sirve para hacer barrido automático en puntos fijos de la pantalla. 
Si haces clic en un punto y esto es un link a otra ventana que los puntos son otros deberiás 
volver a programar los puntos de barrido. Si los has grabado préviamente automáticamente se 
activará el barrido para los nuevos puntos.
-Es decir, imagínate que tienes, por ejemplo, toda una série de páginas web, cada uno con 
sus distintos links que se conectan unox con otros. Grabas los puntos para cada página y a 
medida que el usuario se mueva de una página a otra los puntos de barrido se adaptarán a cada 
una de ellas.
 
-Nota1: Esta opción no funciona en ventanas que no tengan título, como las creadas con el NeoBook.
-Nota2: Lo que he dicho de páginas web para moverse entre links es mejor utilizar la opción 
enviar tabs i Return que funciona en culaquier página web sin necesidad de grabar ningún punto de barrido.
==========================================================
 
==========================================================
AUTOR
==========================================================
Jordi Lagares Roset
www.lagares.org
jordi@lagares.org

==========================================================
Projecte FRESSA 2017
==========================================================
Dicho programa pertenece al, Projecte FRESSA 2017, que es un conjunto de 
programas pensados para personas discapacitadas, motríces, sensoriales y
psíquicas, por lo que recomendamos visitar la web donde se puede conocer y
descargar dichos programas.

==============================================
¿Dónde encontrar el programa?
www.lagares.org.

==============================================
Como se instala
Kanghooru es un programa Windows. Va contenido en un un archivo, Kanghooru.zip. Se puede descomprimir 
donde queramos. Al descomprimirlo lo hace en un directorio llamado Kanghhooru.
No tenemos claro que Kanghooru funcione en Linux utilizando Wine. Se puede bajar de, www.lagares.org,
el progrma JavaKanghhoru que al ser Java funciona en ese sistema operativo así como en Mac.

==============================================
¿Cómo se ejecuta?
Haciendo doble-clic en el ejecutable, Kanghooru.exe.

==============================================
¿De qué archivos está compuesto?
-Kanghooru.exe, el programa.
-LlibreriaKanghooru.dll, la libreria para controlar al ratón y al teclado.
-Kanghooru.txt, este archivo.