===============================================================================
 OZip: OZ Interactive Player
===============================================================================

----------------
* How to Build *
----------------
This software requires following software to compile.
	gtk-- ver. 1.2.5 (C++ wrapper for gtk+)
	gcc-2.95.X
	perl-5.X
Install them first, if your system don't have.

Invoke 'make' command at top level directory of this package.
  % make


--------------
* How to Run *
--------------
  % cd bin
  % ./ozip [-h host] [-p port] [-t teamname] [--true-view] [--help] [...]
	(Detail of options are bottom of this document.)

-------------------
* How to Controll *
-------------------
You can controll player by mouse.

	* Move
		"Move Target" is set to mouse cursor position while button 1
		is pressed. Player moves to "Move Target". If player have a
		ball, player dribbles to "Move Target".

	* Kick
		When player is in kickable distance to ball and button 2 is
		pressed, player kicks a ball to mouse cursor.
		When player is far from ball and button 2 is pressed,
		"Kick Target" is set to mouse cursor position.
		While button 2 is pressed, "Kick Target" keeps up to be there.

		If player moves to ball and "Kick Target" is set, player
		kicks to "Kick Target" automatically.

		When kicking, if 'Controll Key' is pressed, ball will stop at
		"Kick Target", otherwise ball will go throuth on "Kick Target".

	* Ball Access
		Player chases a ball while button 3 is pressed.
		While player is chasing a ball, set "Kick Target" by button 2.

	* Catch (goalie only)
		If ball is in catchable area, player catches it automatically.

	* Turn Neck
		"Neck Target" is set to mouse cursor position while 'Shift Key'
		is pressed. Player turns neck to "Neck Target".

-----------
* Options *
-----------
 -h, --host HOST             : Set host that soccerserver is running.
                                (default: "localhost")

 -p, --port PORT             : Set port number that soccerserver is running.
                                (default: 6000)

 -t, --teamname TEAMNAME     : Set teamname.
                                (default: OZ-RP)

 -g, --goalie                : Connect as a goalie.

 -T, --true-view             : Use accurate ball and player information from
                               'fullstate' message from soccer server.
                               If no 'fullstate' message is received, player
                               ignores this option.

     --valid-player-threshold STEP :
                               If each player reliability is grater than STEP,
                               then that player is shown.
                                 (default -60 step)

     --base-player-size SIZE : Set player (base) size to display.
                                 (default 1.3 meter)

     --player-size-rate RATE : Set player size rate. player aditional size is
                               proportional to player reliability.
                                 (default 0.04 meter/step)

     --fixed-player-size     : Force to fix player size even if unreliable
                               player.

     --default-window-size WIDTHxHEIGHT :
                               Set window size.

     --display DISPLAY       : Set display to put window.

--help option will tell you other options.


--
Hiroki SHIMORA 
shimora@rook.fuis.fukui-u.ac.jp
