Ajagoc(JagoClient Android Version) v1.12    2013/05/21

====================
This is jagoclient v5.1 porting to Android.
(Original was made by rene-grothmann@de.)
And Bluetooth comunication function is added.

Go is a board game played from ancient times at east Asia.
There are 4 playing mode.

(1) Through Go server such as WING.
      Connect to selected server on top panel,
      request match to the slected 'who' on 'whoes' panel.
      WING server(wing.gr.jp) port is 1515(2525 for Japanese user). 
      It is editable by "Edit" button.
      You can observe other player's match selecting from 'games' panel.

   At first, select server, push 'Connect' button then enter 'guest'.

(2) Match with the known partner.
      Without server, pear to pear matching with partner IP address is known.
      (Your IP address is shown by "Partner Connection"-->"Open Partners")
      One starts server by Menu --> Partner --> "Start Server".
      The other, after switching to partner list panel, "Connect" to the partner.
      Match will start when client "Game" --> "Request", then server replys "Accept" 
      Partner connection panel with "Match" button is message board.
      See also (Note) bellow and Menu button --> Help --> Partner Connections.
      Rooter's setting "Privacy Separator" will prohibit communication among terminals under it.
      Bluetooth enables Peer-to-peer matching without wireless-LAN environment.
      See Note:"Partner Connection Using Bluetooth" bellow.
(3) LocalView
      Top panel menu, Action-->LocalView.
      This is symply a board view.
      Use it to study Go-Meister's record, review sgf file.
      It may be for also training of board operation,
      or face-to-face matching if your terminal screen is big enough.
(4) Match with Robot
      Top panel menu, Action-->GMP match
      Your opponent is Agnugo which is my Android porting of gnugo.
      Current GnuGo version is 3.8
                               sakachin2@gmail.com
====================
Operation
  "Menu"   : Diaply Option-Menu.
               Stop :terminate application
               Close:close current panel.
               Help :display Help-Menu
  "Back"   : Back to previous panel.
             Menu/Dialog is closed if opened.
  "Search" : Treated  as "Enter" (Default setting)
             To google, use it after switching to home by "Home" button.
             Back to Go by "Apps now running" button. 

  "TitleBar" touch
      Center   :display Context-Menu(Menu for each panel).
                ex. on top Panel, Action-->Select playing mode.
      LeftEdge :back to previous panel. up to TitlebarHeight*2 from left edge. 
      RightEdge:back to next panel. up to TitlebarHeight*4 from right edge.
                For landscape Local-View panel, free upto TitlebarHeight*2 from right edge.
      long press(1 second) shows Option-Menu.

  On Go-Board
    Buttons
      "Direction"(Up/Down/Left/Right) buttons move Cursor.
      "Center" button or "Enter"/"Search" key  sets a stone.
    Touch
      A Click on board moves Cursor at the position.
      Slide(drag) moves Cursor to the direction. 
      Touch on the Cursor position set stone.
      Click on small yellow button bellow the board also set stone.

      Iconbar is rather small, see Help of "keyboard-shortcut"
      if you have keyboard.
      Direction key is not avail because it is intercepted by Ajagoc as default.

  Whos and Games panel shows list of who and match,
  long press on a line shows Context-Menu about the Who/Game.

Note.
  .WING server is wing.gr.jp/1515 for Non-Japanese user.
   set Langauge:en_US by TopPanel-ContextMenu:Options-->Set Language
   once enter "term e" command just after login successed.

  .Portrait or Lanscape is fixed to the status at board opened.

  .Context-Menu will be pop-up also by long press at non-clickable position
   such as button, list except on Go-board panel.

  .Fn key is used to set pre-defined string (through Menu--FunctionKey) to input field.
   When your terminal has no Fn key,
   use Center-button or Enter-key just after only one digit "0"-->"9".("0" is for F10)

  .Font Change Reference, roughly speaking, used as following. 
     (Menu Item is Android native, is not changed)
     Board  : Text on Board such as coordinates.
     Fixed  : Server/partner/Whos/Games list, Message Display.
     Big    : Optional Clock showing remaining time.
     Normal : Button, Input field, Choice(DdropDownList), Dialog,
              Information line on Board panel.
    
  .Partner Connection setup sample
     Server:
       Top panel --> Menu --> Partner --> Server Port:6970 
     Client:
       Top panel --> Menu --> Partner --> Your Name  :foo-c
       Top panel --> Partner Connections --> Add
                 Name   :foo-s
                 Server :server IP address
                 Port   :6070

  .Partner Connection Using Bluetooth
     (Menu:Bluetooth is from android:2.0)
     Server:(on side of partner)
       Top panel --> Menu --> Bluetooth --> Accept Connect
     Then 
     Client:(the other size)
       Top panel --> Menu --> Bluetooth --> Connect
       (If ,by "Connect", server-device is not listed on device selection dialog,
       push "Scan Device" after "Make Discoverable" at Server device.)

     Reply "Yes" if pairing confirmation dialog is opened.
     (Pairing can be set previously from android's "Settings".)
     Request "Game" from one of device on Connection panel.
     Menu-->Finish Game->End Game,then prisoners will be removed.

  .Change of Board Color or Cordinates option are time consuming process.
   It is so for Reconection after line-error or End-of-Game panel, be patient.

  .Memory size limit may be severe, close ended game board.

  .Ajagoc Options.
   Added to menu of top panel.
     Direction Key as Shortcut.
       Set ON to use direction keys as shortcut key
       if your terminal has trackball.
     Use Serach key as Enter
       Set OFF not to use Search button as Enter key,
       if your terminal has hardware keyboard.

====================
Install

  Except through Android Market, you can install apk file you have. 
    (1)through micro SD
       1.Install installer such as "Apkinstaller" from Android Market
         into your terminal.
       2.Copy your apk file into micro SD card
       3.Install your apk by starting the installer
  OR
    (2)using adb(one of android SDK tools)
       1.Connect your terminal to a PC SDK was installed
         (Install USB driver from <SDK>usb_driver folder)
       2.On your terminal, set ON "Unknown sources"("Settings"-->"Applications")
       3.On PC, execute "adb install apk-file-fullpath"

  When you got strengthen renewal version of gnugo(or other GMP protocol robot),
  change name other than Agnugo or install it to other than /data/data/com.Ajagoc/files.
  And specify fullpath name on GMP connection panel.

====================
Nationalization and Configuration.

  Original help text files are included.
  You can add or modify help text by placing another file
  on the foloowing folder.
  If you use multiple locale, put file with name suffixed
  like as about_de.txt.
  Originally _de,_fr,_it,_pl,_ru,_ja is prepared.(aboutAjagoc is _ja only)

  (See help about Locale Switching)

    /sdcard/Ajagoc/jagoclient/helptexts/xxxxx.txt

         about.txt  aboutAjagoc.txt  advanced.txt  board.txt  channels.txt configure.txt
         confpartner.txt  encoding.txt filter.txt  firewall.txt  fkeys.txt  games.txt
         gmp.txt  help.txt  keyboard.txt  language.txt  mail.txt  moves.txt  obsplay.txt
         overview.txt  partner.txt  playing.txt  port.txt  relayserver.txt  server.txt
         sgf.txt  sound.txt  teaching.txt  terminal.txt variations.txt  who.txt
         windows.txt yourname.txt

  Button label is modified by following folder.
    /sdcard/Ajagoc/jagoclient/foreign/JagoRsource.properties"
  For multiple locale prepare following file.
    /sdcard/Ajagoc/jagoclient/foreign/JagoRsource_xx.properties

  Server list is modified by following file.(Panel operation enable to add/modify list)
    /sdcard/Ajagoc/xxxx.cfg
      go.cfg, server.cfg, partner.cfg, filter.cfg

====================
  Open Source
    http://www.geocities.jp/sakachin2/index.htm