Viewing file:  __init__.py (4.34 KB) -rw-r--r--
Select action/file-type:
 (+) |  (+) |  (+) | Code (+) | Session (+) |  (+) | SDB (+) |  (+) |  (+) |  (+) |  (+) |  (+) |
# -*- coding: utf-8 -*-
__author__ = 'Robert Ancell <bob27@users.sourceforge.net>'
__license__ = 'GNU General Public License Version 2'
__copyright__ = 'Copyright 2005-2006 Robert Ancell'
# Highlight types
HIGHLIGHT_SELECTED = 'selected'
HIGHLIGHT_CAN_MOVE = 'canMove'
HIGHLIGHT_THREATENED = 'threatened'
HIGHLIGHT_CAN_TAKE = 'canTake'
class ChessSet:
"""
"""
def drawPiece(self, pieceName, state, context = None):
"""Draw a piece.
'pieceName' is the piece name (string).
'state' is the piece state (string).
'context' is a reference to the rendering context being used (user-defined).
"""
pass
class ChessPieceFeedback:
"""
"""
def onDeleted(self):
"""Called when this piece is deleted"""
pass
def onMoved(self):
"""Called when this piece reaches its destination"""
pass
class ChessPiece:
"""Abstract class for a glChess chess piece model"""
def move(self, coord, delete = False, animate = True):
"""Move this piece to a board location.
'coord' is the algebraic location to move to (string).
'delete' is a flag to show if this piece should be deleted once it arrives there.
'animate' is a flag to show if this piece should be animated as it moves.
"""
pass
class SceneFeedback:
""""""
def onRedraw(self):
"""This method is called when the scene needs redrawing"""
pass
def startAnimation(self):
"""Called when the animate() method should be called"""
pass
class Scene:
"""Abstract class for glChess scenes
Extend this class to make a scene
"""
def __init__(self, feedback):
"""
"""
pass
def reshape(self, width, height):
"""Resize the viewport into the scene.
'width' is the width of the viewport in pixels.
'height' is the width of the viewport in pixels.
"""
pass
def addChessPiece(self, chessSet, name, coord, feedback):
"""Add a chess piece model into the scene.
'chessSet' is the name of the chess set (string).
'name' is the name of the piece (string).
'coord' is the the chess board location of the piece (tuple, (file,rank)).
'feedback' is th (extends ChessPieceFeedback)
Returns a reference to this chess piece or raises an exception.
"""
raise Exception('Not implemented')
def setBoardHighlight(self, coords):
"""Highlight a square on the board.
'coords' is a dictionary of highlight types keyed by square co-ordinates.
The co-ordinates are a tuple in the form (file,rank).
If None the highlight will be cleared.
"""
pass
def setBoardRotation(self, angle, faceToFace = False, animate = True):
"""Set the rotation on the board.
'angle' is the angle the board should be drawn at in degress (float, [0.0, 360.0]).
'faceToFace' is True if the top pieces should be drawn upside down.
'animate' is True if the rotation shoule be animated.
"""
pass
def showSmooth(self, doNumbering):
pass
def showBoardNumbering(self, showNumbering):
"""
"""
pass
def showBoardDarker(self, showDarker):
"""
"""
pass
def animate(self, timeStep):
"""Animate the scene.
'timeStep' is the time since this method has last been called in seconds (float).
Returns False once all animation is complete otherwise returns True. Once animation
is complete do not call this method again until startAnimation() is called.
"""
pass
def render(self, context):
"""Manually render the scene.
'context' TODO
"""
pass
def getSquare(self, x, y):
"""Find the chess square at a given 2D location.
'x' is the number of pixels from the left of the scene to select.
'y' is the number of pixels from the bottom of the scene to select.
This requires an OpenGL context.
Return the co-ordinate in LAN format (string) or None if no square at this point.
"""
return None
|