Por favor, lee esto si tienes alguna pregunta sobre el programa.

El propsito de este programa (TCBR Shell) es el de preparar libros para su lectura en telfonos mviles, usando el midlet de TequilaCat "BookReader".

A continuacin, se describir la interfaz del programa. Puedes encontrar ms detalles e informacin en el mismo Midlet o en la pgina del programa:
http://tequilacat.narod.ru/dev/br/
Te recomiendo que visites la pgina frecuentemente para actualizaciones del programa, con ms funciones y ms libre de fallos.

Caractersticas de la interfaz de "BookReader":
1. El libro preparado con esta interfaz puede ser dividido en captulos, por cabeceras en los captulos o por el tamao mximo que se especifique.
2. Son soportadas diversas marcas de mviles: Nokia, Siemens, etc...
3. Mientras ests preparando un libro, puedes elegir una fuente para leerlo en tu mvil, entre todos los diferentes tamaos de fuentes que tengas instalado en tu sistema.
Por ahora, tan solo las fuentes fijas estn soportadas, como Courier, en las prximas     versiones las fuentes proporcionales estarn disponibles tambin.
4. Puedes seleccionar el color del fondo y del primer plano para una lectura ms cmoda.
5. Puedes establecer numerosas opciones de lecturas.
6. Si la interfaz incluye la localizacin del midlet, puedes optar por localizarlo, as como todos los comandos y mens en el telfono. Las aplicaciones se mostraran en tu lenguaje nativo.

================================================
Como usar la Interfaz de "BookReader":
================================================
1. Presionar el botn "+" para aadir el archivo(s) a incluir en el libro.
2. Presionar "-" para eliminar textos de la lista.
3. Renombrar el texto usando el botn "Renombrar" para cambiar las etiquetas que se vern en el telfono.
4. En la pestaa "Opcin", seleccionar la versin para tu marca y modelo de telfono.
5. Configurar las opciones deseadas para las restricciones de tamao (ver ms en las restricciones de tamao, ms abajo)
La opcin "Extender pantalla al tamao por" es tan solo aplicable a los telfonos Motorotas y Samsung, para activar la visualizacin a pantalla completa, usando los bordes de la pantalla donde normalmente estn los comandos.
6. En "Fuentes", seleccionar la fuente y el color. Seleccionar "Usar fuentes del mvil" para salvar espacio en el libro (1  2 Kb de texto), si tu telfono tiene restricciones en el tamao (ver ms abajo).
7. Introducir el nombre del libro en el botn de la ventana. Este nombre ser el usado en tu  mvil, pero asegurarse de usar tan solo nmeros latinos, dgitos y subrayados.
8. Seleccionar la carpeta donde el libro ser creado presionando l botn "..." Despus puedes acceder a esta carpeta presionando en el vnculo azul.
9. Clic en "Build!" para crear el libro.

Por favor: el Midlet "BookReader" soporta tan solo archivos de texto. Para leer archivos de MS Word debes de convertirlos antes en texto plano txt salvndolo con "Guardar como..." y seleccionando formato de texto plano .TXT

La generacin de libros: Dos tipos de archivos son los creados, JAD y JAR, sus nmeros dependen de las opciones seleccionas sobre el tamao de archivos. Cada libro es una pareja de estos dos archivos.

El archivo JAR es el libro completo - Cada uno incluye los archivos de textos y el midlet del BookReader. De hecho los archivos JAR son archivos ZIP con una extensin .JAR, y pueden ser examinados como cualquier archivo de esta clase usando la compresin ZIP.
Los archivos JAD son pequeos archivos de texto que describen cada uno de los Midlets. Generalmente cada archivo JAR debera de tener su correspondiente JAD que describa sus detalles. No todos los telfonos necesitan estos JAD, p.e. SE T6x0 y la familia Motorola.

Ahora tan pronto tengas el libro generado, instlalo en tu mvil y a leer.
Para encontrar ms detalles sobre la instalacin del Midlet mira el manual de tu terminal o incluso tambin en foros de internet, donde hay gran informacin sobre esto. Para algunos modelos (como Nokia 3410) que no tienen soporte directo para los Midlet Java mediante cable, IRDA o BlueTooth, debers instalarlo al 'aire', subiendo a algn sitio WAP tu libro generado para descargarlo ms tarde.

====================================
FAQ (Importante!)
====================================
Por qu  restringir el tamao de los archivos jar y el texto de los captulos?

Los telfonos mviles son pequeos dispositivos con ciertas restricciones de capacidad. A menos de otras descripciones, el tamao de la memoria de la mayora de estos dispositivos es pequea. Como resultado, el fabricante del telfono mvil incorpora restricciones en el tamao aceptado de las aplicaciones.

Tambin la memoria es pequea, con lo que afecta a como de grande podr ser el archivo para abrirlo de golpe si el captulo es demasiado grande. Si lo es el dispositivo fallar al abrirlo, sacando a pantalla un mensaje de error o simplemente obiando la parte excesiva del texto de forma silenciosa.

Para pasar estas restricciones, la interfaz TCBR permite separar por tamao de captulos y resultando el tamao JAR deseado.

Si tienes los siguientes problemas:

Problema:
Los archivos JAD y JAR no pueden instalarse en el telfono o no pueden ejecutarse despus de haberlos instalados (error como "error de aplicacin", "archivo demasiado grande" etc)

Solucin 1:
El archivo generado JAR file es demasiado grande para tu mvil - Restringe el tamao del archivo JAR en la pestaa de las opciones.

Solucin 2:
Has escogido una versin de Midlet errnea - Para diferentes marcas de telfonos o modelos se debe seleccionar el Midlet adecuado, dado que cada cual puede tener opciones diferentes en BookReader

Problema:
El archivo JAR se instala y ejecuta perfectamente, pero contiene libros q no pueden abrirse, o libros q se abren pero con partes del texto q desaparecen.

Solucin:
La generacin de captulos son demasiados grandes para colocarlos en memoria. Restringe el tamao de los captulos en las opciones.

Problema:
Hay demasiados captulos generados o demasiados archivos jar.

Solucin:
A menos que sea porque es un libro enorme, debes introducir el tamao especfico en bytes, no KiloBytes (p.e 60, cuando en realidad el tamao introducido debera de ser 60000).

Los tamaos recomendados para los telfonos:

Nokia S40 (estos valores son aplicables para la mayora de Nokia) - Mx tamao del JAR 64000, y de tamao del captulo 60000

SonyEricsson T6x0 y Motorola T720 - El tamao del jar no hace falta restringirlo (200-300 kilos), y el mximo para cada captulo en unos 120000-150000.

Si tu telfono no est listado arriba y experimentas problemas similares a los descritos, prueba con tamaos menores. El tamao de los Nokia (max tamao JAR o de los captulos, dependiendo del problema) puede ser fallo de la compatibilidad.
Estar encantado de que me mandis los tamaos que vayis probando y as tener la lista actualizada de modelos.


Este programa tiene copyrighted por TequilaCat, ver la licencia en license.txt para ms detalles.

Incluye otros archivos como software libre (como DLL):
* Libreras FreeImage
* Libreras ZIP infozip
* Libreras ZIP ZipBuilder librerias para construir en infozip
Gracias a sus autores, aadir las licencias pronto.
