Krlek olvasd el ezt, ha krdsed van a programmal kapcsolatban.

Ennek a programnak (TCBR Keretprogram) a clja, hogy knyveket ksztsen el a mobilon trtn elolvasshoz, a TequilaCat BookReader (KnyvOlvas) midlet-et (mobil-alkalmazst) hasznlva.

Ebben a fjlban a keretprogram lersa tallhat. A BookReader midlet-rl a program honlapjt tallhatsz tovbbi rszleteket s informcikat:
http://tequilacat.narod.ru/dev/br/
Javaslom, hogy nzd meg a honlapot frissebb verzirt, amely hibajavtssal s tbb funkcival rendelkezik.

A BookReader keretprogram funkcii:
1. A keretprogrammal ksztett knyvek fejezetekre oszthatak, fejezet-fejlc vagy a maximum fejezetmret szerint, amit te hatrozhatsz meg
2. Szmtalan mobiltelefon-mrka tmogatott: Nokia, Siemens stb.
3. Egy knyv elksztsnl bettpust vlaszthatsz, melyet majd a mobilodon olvashatsz. A bettpusok kztt megtallhatod a Windows lland szlessg bettpusait is.
  Eddig csak az lland szlessg bettpusok tmogatottak, mint a Courier, a kvetkez verzikban a betszlessg-arnyos betkszletek is elrhetek lesznek.
4. El- s httrsznt is vlaszthatsz a mg knyelmesebb olvasshoz.
5. Szmos belltsi lehetsggel rendelkezhetsz.
6. Ha a keretprogram tartalmaz midlet honostst, dnthetsz, hogy honostod-e a midletet, gy az sszes parancs s men a telefonos alkalmazsodban az anyanyelveden fog megjelenni.

================================================
A BookReader keretprogram hasznlata:
================================================
1. Nyomd meg a "+" gombot szvegfjl(ok) hozzadshoz a knyvhz
2. Nyomd meg a "-" gombot szvegfjl(ok) listbl val eltvoltshoz
3. A szvegek tnevezse az "tnevezs" gombbal hajthat vgre. Ez a mobilon lthat szveg-feliratokat vltozatatja meg.
4. A "Belltsok" fln vlaszd ki a verzit a telefon-mrkdhoz s tpusodhoz
5. Vgezd el a kvnt belltsokat s mret-korltozsokat (lsd mg a Mret-korltozsok rszben lejjebb)
  A "Kijelz magassgnak kiterjesztse" bellts csak a Motorola s a Samsung telefonoknl alkalmazhat, a teljeskpernys kijelzs elrsnek rdekben, a kijelz als svjnak felhasznlsaval, ahol ltalban a menparancsok jelennek meg a mobilon.
6. A "Bettus" fln vlaszd ki a bettpusokat s szneket. Vlaszd a "A mobilod fontja" gombot hogy helyet sprolj a szveg szmra (1-2 kilobjtnyit), ha a telefonod mret-megktsekkel rendelkezik (ismteleten lsd alant)
7. Az ablak aljn rd be a knyv nevt. Ez a nv a telefonban lesz felhasznlva, gy krlek csak kezetmentes betket (latin ABC beti) hasznlj, s/vagy szmokat,alhzsjeleket (_)
8. Vlaszd ki a mappt ahova a knyvek kerlnek a "..." gomb megnyomsval. Miutn a knyvek elkszltek, megnyithatod ezt a mappt a kiemelt szn elrsi tjra val kattintssal.
9. Kattints a "Csinld !" gombra a knyvek elksztshez

Megjegyzs: A BookReader midlet csak szvegfjlokat tmogat. Ahhoz, hogy MS Word fjlokat olvass, elszr t kell konvertlni ket a Word "Ments msknt..." ("Save As...") menpontjval, majd kivlasztani a "Csak szveg" ("Text format") opcit.

A program knyveket generl: nhny JAD s ugyanannyi JAR fjlt, szmuk fgg a belltsoktl s a szveg mrettl. Minden knyv egy JAD s egy JAR fjl prosa.

A JAR fjlok a valdi knyvek - mindegyik tartalmazza a szvegfjlokat s a BookReader midletet. Valjban a JAR fjlok ZIP archvumok .JAR kiterjesztssel, s brmelyik programmal megvizsglhatak, amelyek tmogatjk a ZIP tmrtst.
A JAD fjlok rvid szvegfjlok, melyek lerjk a midletet. Alapveten mindegyik JAR fjlnak kell lennie egy megfel JAD prjnak is, ami lerja az adatait. Nhny telefonnak nincs szksge JAD fjlokra pl. Sony Ericsson T6x0 s a Motorola Accompli csald.

Ha kszen llnak a knyvek, akkor teleptsd ket a mobilodra s lvezd az olvasst.
A midlet teleptsrl tovbbi rszleteket a telefonod kezelsi tmutatjban vagy internetes frumokban tallhatsz - ilyen tmban rengeteg hozzszlst tallhatsz. Nhny tpus (pl. Nokia 3410) ami nem tmogat JAVA teleptst kbellel,IRDA-vel vagy BlueTooth-tal, prbld meg online installlni, gy, hogy a knyveket elszr feltltd egy WAP oldalra, majd onnan a telefonodra.

====================================
GYIK (Fontos!)
====================================

Mirt korltozottak a JAR fjlok s a fejezetek mretei?

A mobiltelefonok kis kszlkek korltozott kpessgekkel. Egyb megktsek kztt a memria mrete sok kszlknl meglehetsen alacsony. Ennek eredmnyekpp korltozsok vannak az alkalmazsok mretben is.

A kis memrinak ksznheten az is ki van ktve, hogy mekkora szvegfjlt tudunk megnyitni egyszerre. Ha egy fejezet mrete tl nagy, akkor a kszlk vagy nem tudja betlteni, s egy hibazenetet dob ki, vagy szpen csendesen betlti a fejezetet, de annak csak egy rszt.
Hogy kikerljk ezeket a megktseket, a TCBR Keretprogram klnbz fejezetmreteket engedlyez, ezzel vltoztatva a JAR fjlok mrett.

Problmk s megoldsok:

Problma:
A JAD s a JAR fjlok nem installlhatak a mobilra vagy nem futnak a sikeres telepts utn sem (olyan hibazenetekkel lp ki mint ezek: "Alkalmazs hiba" ("Application Error"), "A fjl tl nagy" ("file too big") stb.)

Megolds 1:
Az elksztett JAR fjl tl nagy a mobilodhoz - a "Belltsok" fln korltozd a JAR fjl mrett.

Megolds 2:
Rossz midlet verzit vlasztottl - ms telefongyrthoz vagy ms tpushoz valt. A telefontpusok klnbznek az eltr funkcik tmogatsban amit a BookReader nyjt. Egy msik tpusra tervezett BookReader verzi teleptse nagy valsznsggel sikertelen lesz.

Problma:
JAR fjl sikeresen telepl s fut is, de a tartalmazott knyvek nem nylnak meg. Vagy megnylnak, de nhny szvegrsz eltnik (a JAR fjlokban mg megtallhatak)

Megolds:
A ltrehozott fejezetek tl nagyok, ahhoz hogy a telefonod memrija kezelni tudja ket. A mret-belltsoknl korltozd a fejezet-mretet.

Problma:
Egy csom fejezet vagy JAR fjl generldott.

Megolds:
A mreteket kilobjtban adtad meg (pl. 60) holott bjtokban kellett volna (ebben az esetben 60000).

Javasolt mretek nhny telefontpushoz:

Nokia S40 (Series 40 - ezek a legelterjedtebb Nokik) - JAR maximum 64000 bjt, fejezet maximum 60000 bjt

SonyEricsson T6x0 s Motorola T720 - A JAR fjl mrete nem korltozott (vagy 200-300 kilobjt), maximum fejezetmret 120000-150000 bjt.

Ha a telefonod nincs a fentiek kztt, s hasonl problmkkal tallkozol, mint a fentebb lertak, ksrletezz sajt magad.
Vedd a Nokia mreteit (maximum JAR mret vagy maximum fejezet mret, attl fgg, milyen jelleg a problma), s emeld addig, ameddig a telefonod kpes azt futtatni.
Hls lennk (s ms Bookreader felhasznlk is) ha elkldend nekem ezeket a mreteket, hogy szerepelhessenek itt.


A program TequilaCat szerzi jogvdelme alatt ll, rszletekrt nzd meg a licence.txt-t.

A program tartalmaz ingyenes programokat (DLL-knt):
* FreeImage eljrsknyvtr
* infozip' zip eljrsknyvtr
* ZipBuilder eljrsknyvtr az infozip' -re ptve
Ksznet a szerzknek, a licenc informcit hamarosan mellkelem.
