/* 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 versin 66 - 20/08/04
==========================================================
A partir de una idea original de Simn Martn - Gran Canaria.

El nombre viene de que en cataln 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 automtico.

Est pensado para que personas con discapacidad motrica 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, Portugus, English

==========================================================
FUNCIONAMIENTO - HASTA versin 19
==========================================================
-Ejecutar un programa que deseeis que sea controlado mediante barrido.

-Pulsar el botn grabar o bin el men grabar.

-Hacer clic en tantos puntos como deseis vaya el barrido autmomtico.
1000 mximo.

-Parar grabacin pulsando el botn derecho del ratn.

-Para empezar el barrido automtico pulsar el botn ejecutar o bin el
men, ejecutar.

-Para pararlo clic derecho del ratn.

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

-Abrir dicho archivo mediante el men. Abrir. Automticamente se ejecuta 
el barrido automtico.

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

-Cuando se activa el barrido automtico el programa se minimiza, por lo
que desaparece. Al hacer clic con el botn derecho y parar el barrido vuelve
a aparecer la ventana del programa.

-El quadro de edicin con un nmero, 12 por defecto, indica las dcimas de
segundo que dura el barrido. Dicho nmero puede variarse segn 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 crditos. Pienso
que es bueno ejecutarla y ver la secuencia de imgenes que nos ofrece. As
mismo si se clica en distintas partes de la ventana podemos encontrarnos con
sorpresas.

-El men ayuda abre este archivo. Slo funciona si no hemos cambiado el directorio
donde se halla el programa.

==========================================================
NOVEDADES - HASTA versin 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" automtico se passa 
de una posicin a la otra mediante el clic derecho del ratn (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 automticamente. En clic puede activarse manualmente mediante la tecla RETURN.

-Hay una nueva opcin de men que si se activa no permite hacer dos clics seguidos a
menos que la separacin de tiempos sea mayor que el tiempo marcado en el nuevo cuadro.
ste est expresado en dcimas de segundo. Si no hay puntos de canguro y est activada
esta opcin permite controlar los clics seguidos de personas que utilicen el powerpoint
por ejemplo. Es decir controlar el salto de dos, tres o ms pantallas seguidas por
realizar demasiados clics.

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

-Hay un nuevo men que se deber activar si el ratn est configurado para usuarios zurdos.
Es decir estn intercambiadas las funciones de los botones del ratn.

-Hat una nueva opcin de men,"Enviar Tabs y Return" , que si se activa, en lugar de cambiar
la posicin del ratn lo que hace es enviar TAB, con escaneo automtico (o bin mediante clic 
derecho si est activada la opcin) y cuando lo que hace es enviar un clic el lo traduce
en ub RETURN. Para controlar aplicaciones tipo pgina web que para moverse de un link
(o zona activa) a otro se haga mediante la tecla, TAB (Tabulador) y la activacin mediante
la tecla RETURN

==========================================================
42-43-Hay una opcin del men, Cuadro seguimiento del mouse que hace que un cuadrado rojo 
enmarca las posiciones dle ratn por si hay dificultades de visin.

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

45-47-Optimizacin de cdigo

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

49-59-Optimizacin de cdigo

60-Mens en cataln.

61-Optimizacin de cdigo

62-Mens en Euskera. Gracias Iaki Torices.

63-Mens en Gallego. Gracias Beatriz Garca Oate y Alberto Cifuentes. www.canalciencia.com.


==========================================================
FAQ
==========================================================
PREGUNTA 1:
...tenemos una pgina Web de programas educativos informticos destinada a alumnos de 
Educacin Especial, Educacin Infantil y Primaria.
La direccin de la pgina 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 gustara saber cul es la utilidad, 
dentro de Kanghooru de la opcin "En ejecucin, buscar fichero de barrido" ya que yo 
todava no he sido capaz de descubrir su funcin y tampoco la encuentro en el manual 
que incorporas...
RESPUESTA 1:
-Si, efectivamente, esta opcin no est muy documentada.
-Si activas esta opcin vers que despus de grabar los puntos de barrido te sale un men 
guardar fichero. Como nombre de fichero pone el ttulo de la ventana actualmente activa. 
-Si dices guardar, siempre que tengas la opcin activada y ests en modalidad barrido automtico,
si por la razn que sea se activa dicha ventana el barrido se producir en los puntos 
definidos para esta ventana.
 
-Porqu esta opcin?
-En general kanghooru sirve para hacer barrido automtico 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 deberis 
volver a programar los puntos de barrido. Si los has grabado prviamente automticamente se 
activar el barrido para los nuevos puntos.
-Es decir, imagnate que tienes, por ejemplo, toda una srie de pginas web, cada uno con 
sus distintos links que se conectan unox con otros. Grabas los puntos para cada pgina y a 
medida que el usuario se mueva de una pgina a otra los puntos de barrido se adaptarn a cada 
una de ellas.
 
-Nota1: Esta opcin no funciona en ventanas que no tengan ttulo, como las creadas con el NeoBook.
-Nota2: Lo que he dicho de pginas web para moverse entre links es mejor utilizar la opcin 
enviar tabs i Return que funciona en culaquier pgina web sin necesidad de grabar ningn 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, motrces, sensoriales y
psquicas, por lo que recomendamos visitar la web donde se puede conocer y
descargar dichos programas.

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

==============================================
Cmo 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 ratn y al teclado.
-Kanghooru.txt, este archivo.