Miniature/Development
Miniature is based on the official Qt 4.6 for Maemo and its Graphics View framework. Most of our work focuses on developing a UI layer optimized for mobile touch devices. When it comes to the backend we want to recycle as much as possible from existing chess engines.
The development is guided by the roadmap and is organized by phases bringing new features to our users. The organization of the roadmap is based on a pragmatical implementation of the Miniature concept taking into account features missing in Maemo, existing chess projects and the requests from current and potential users.
New contributors are welcome! You can help testing and bugfixing new releases focusing on the current phase or you can pick one item more distant in the roadmap and go ahead with it. No matter what you do we recommend you to stay on focus.
Contents[hide] |
Project status
- The Miniature project was born as a proposal sent to the Maemo community on 2009-10-31.
- Phase 0: Project setup - ONGOING
- Currently working on the roadmap item Play Games Online, divided in 3 phases:
- Phase 1.0: Offline chess basics - STARTED
- Phase 1.1: Online chess basics - NOT STARTED
- Phase 1.2: Online chess advanced - NOT STARTED
- 2009-11-03: First concept of play + chat (landscape).
- 2009-11-01: First mockup.
Development Status
Phase 1
- Implementing the Board. The Board represents the current state of the game and is equivalent to a real physical chess board. It has no knowledge of legal or illegal moves. For now it will only accept chess pieces. The board does not know about the future or the past, any logic will be in the Game.
- DONE: At least a rough version, using a FEN string as model and a board composed of QGraphicsItems. I imagine that we redraw the board whenever the position changes, so as of now the board is rather stateless (YAY!).
- Creating a basic GUI to display the Board and the pieces. A piece can be moved by tapping on it and then tapping on the destination.
- TODO: Decide between a full scene graph UI (= max flexibility to customize look and feel), or use more traditional widgets?
Phase 2
- Implement a basic chess Game adapter. The basic Game adapter knows the starting position of every piece and can determine if a move was legal. The concept of alternating player moves is also implemented here. It also recognizes checkmate, stalemate and threefold repetition thus ending the game.
Ideas for future phases
Proposals and plans for future phases.
Automatic login & logoff
In the first boot of the app we can offer a dialog offering to store the login & password, create a new account or "later" (which will will go to play offline). Once the app has login & password booting will imply logging in and the way to log out will be to simply close down the app.
Menu while not playing
(Seek player will be in the main screen, below the board - a mockup will come soon)
- Settings
- Highlight last move - default SQUARES. Also NO - ARROWS?
- Show legal moves? - default NO.
- Show coordinates - default NO.
- Sounds - default NO.
- Vibra on moves - default NO.
- Board position - default RIGHT (to be implemented when landscape mode comes).
- Customization (to be implemented when customization comes).
- Piece sets selector.
- Boards selector.
Menu while playing
Items in the application menu while playing a game:
- Resign
- Request draw
- Abort
- Adjourn
- Promotion piece
- When clicking the window shows all the figures with the Queen selected by default.
- Settings
- Same as while not playing
Additional functions
- Chess clock only function: It would be great to use the N900 as a chess clock only if there is a real board and a "real" opponent is available. The functionality will be in the apllication so a nice UI for this function is all what is needed.
- Possibility to play a game human vs. human offline. In this case the board should flip 180° between two moves.
Mockups
These are the current sketches.
Old ;)
Roadmap
(Draft, sorted by priority.)
Items with "?" are to be decided upon once we focus the discussion on them. These items might be moved to later phases of development, or removed from the roadmap altogether.
Play games online
- Chess game basics, demonstrated off-line.
- Online chess basics, targeting http://www.freechess.org/ first
- Log in & out
- Register
- Search challengers / by time
- Propose a game
- Timeseal support.
- Online chess advanced
- Join tournaments
- Full access to FICS console (might make sense only in landscape mode)
Chat with your opponent
- Landscape support.
Customization
- Download and select different boards and pieces.
- Download and select different engines.
Methods of connectivity to play against human
Learn chess lessons with moves + text
- Positions can be set manually.
Play local tournaments e.g. via Telepathy Tubes
Play against computer
- TODO: Which engines???
Chess variants
Recording to log, playing back a log
Display games by you or others, live or stored
Low priority: Chessmonk is concentrating on this for Maemo 5 => not that urgent for Miniature)
- History of an opening.
- Take a picture of a printed game, process the notations with OCR and display it.
- Display several games at a time.
- Watch game via webcam stream
Technology selections
How to make the most from existing free projects avoiding forking and duplicated work as much as possible.
- Qt 4.6 for UI layer. The goal is to have Maemo as primary development platform, aiming for straight ports to Symbian and other Qt compatible platforms.
- What starting point to get the online chess features?
- What starting point for chatting?
- TP connection manager: http://telepathy.freedesktop.org/wiki/Components
- Qt 4.6 wrapper (http://telepathy.freedesktop.org/wiki/TapiocaQt) might be a good idea to look at.
- Rationale: I would like to see a "I play chess!" tag next to each contact I have. This information would of course have to come from a central server or such. Also, it would be great if we could just re-use the chat functionality that is already there with maemo5 (of course it needs a modified view to fit into our UI) --mikhas.
- TP connection manager: http://telepathy.freedesktop.org/wiki/Components
- What starting point for game analysis?
- Scid (see dependencies) would be nice by itself and as gateway to Crafty (see dependencies) and other engines.--qgil 06:22, 3 November 2009 (UTC)
Architecture
GUI:
- Board
- Chat
- Player Cards
- Online Play
Logic:
- Game - the logic for a particular game, right now that would be just chess, but other board games could be possible too. (Chess based or other)
- The current game controller can update the board, using FEN strings (we might want to wrap the QStrings in a simple Position container, if we add parsing API to it) and knows about the UI.
- Pre-Game - How to find players, select a server or engine
Domain:
- Board - Represents the data structure of the board (duh)
- Can draw a position based on a valid FEN string, say "rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1" encodes the start position.
- How it works: Each figure is a QGraphicsSvgItem. This is useful since it allows fingertouchability. The board draws its position, meaning it removes all its figures children (by deletion) and then re-reads the SVG files into new QGraphicsSvgItem. Needless to say, this is inefficient. A better way would be to let the board load all figures during its construction time, put them in a vector (using enums for the indices lookup, maybe) and instead of clearing the board by deletion, just unparent the figures from the board, then reparent them into the correct position. Or just move them around, and hide those that were removed by game moves. Both should be easy and bring a good speed-up (SVG loading is quite expensive I hear). It is bascially about killing unneeded new/delete sequences.
- Player - information about the other player, like online status, skill level
- Player "cards" would be part of this. Currently, they only exist as some HTML-formatted text in the scene view.
Communication:
- ICS
- Bluetooth
- Telepathy
- Computer Chess Engine - an offline engine should be accessed the same way any online game is, the engine does not have to be in the same task
References
- Crafty is a free, open-source computer chess program.
- EBoard and Crafty for the N810/N800/N770 - OS2007 Downloads page.
- Knights aimed to be the ultimate chess resource for the K Desktop Environment... years ago.
- pacaq is a chess game visualizing and analysis tool done with the Maemo 4.1 Qt4 port - Talk thread.
- From all programs on this list, this is the only one were reading the code is worth your time.
- SCID, a chess database application for Windows, Linux and Mac OS operating systems.
- See also SCID Pocket
- Xboard is a graphical user interface for chess in all its major forms.
- freechess.org Website of the Free Intrnet Chess Server (FICS)