FDChessboardView
Features
- High resolution graphics
- Customizable themes and game graphics
- Supports all single board chess variants: suicide, losers, atomic, etc.
- Supports games with odd piece arrangement and non-standard castling (Fisher 960)
- Very clean API, this is just a view
- Supports a minimum deployment target of iOS 8 or OS X Mavericks (10.9)
Usage
Import, add the view to your storyboard and then set it up with:
import FDChessboardView
...
self.chessboard.dataSource = self
Then implement the data source:
func chessboardView(board: FDChessboardView, pieceForSquare square: FDChessboardSquare) -> FDChessboardPiece? {
return piecesByIndex[square.index] // you figure out which piece to show
}
Here is the full API:
/// The location of a square on a chess board
public struct FDChessboardSquare {
/// From 0...7
public var file: Int
/// From 0...7
public var rank: Int
/// A format like a4
public var algebriac: String { get }
public var index: Int { get set }
public init(index newIndex: Int)
}
/// The pieces on a chess board
public enum FDChessboardPiece : String {
case WhitePawn
case BlackPawn
case WhiteKnight
case BlackKnight
case WhiteBishop
case BlackBishop
case WhiteRook
case BlackRook
case WhiteQueen
case BlackQueen
case WhiteKing
case BlackKing
}
public protocol FDChessboardViewDataSource : class {
/// What piece is on the square?
public func chessboardView(board: FDChessboardView, pieceForSquare square: FDChessboardSquare) -> FDChessboardView.FDChessboardPiece?
/// The last move
public func chessboardViewLastMove(board: FDChessboardView) -> (from: FDChessboardView.FDChessboardSquare, to: FDChessboardView.FDChessboardSquare)?
/// The premove
public func chessboardViewPremove(board: FDChessboardView) -> (from: FDChessboardView.FDChessboardSquare, to: FDChessboardView.FDChessboardSquare)?
}
public protocol FDChessboardViewDelegate : class {
/// Where can this piece move to?
public func chessboardView(board: FDChessboardView, legalDestinationsForPieceAtSquare from: FDChessboardSquare) -> [FDChessboardView.FDChessboardSquare]
/// Before a move happens (cannot be stopped)
public func chessboardView(board: FDChessboardView, willMoveFrom from: FDChessboardSquare, to: FDChessboardSquare)
/// After a move happened
public func chessboardView(board: FDChessboardView, didMoveFrom from: FDChessboardSquare, to: FDChessboardSquare)
/// Before a move happens (cannot be stopped)
public func chessboardView(board: FDChessboardView, willMoveFrom from: FDChessboardSquare, to: FDChessboardSquare, withPromotion promotion: FDChessboardPiece)
/// After a move happened
public func chessboardView(board: FDChessboardView, didMoveFrom from: FDChessboardSquare, to: FDChessboardSquare, withPromotion promotion: FDChessboardPiece)
}
/// Display for a chess board
public class FDChessboardView : UIView {
/// Color for "white" board squares
public var lightBackgroundColor: UIColor
/// Color for "black" board squares
public var darkBackgroundColor: UIColor
/// Color for where a piece is moving to
public var targetBackgroundColor: UIColor
/// Color for a legal square target
public var legalBackgroundColor: UIColor
/// Color for the last move square
public var lastMoveColor: UIColor
/// Color for a premove square
public var premoveColor: UIColor
/// Path for custom piece graphics
public var pieceGraphicsDirectoryPath: String?
/// Datasource to say which pieces are on each square
public weak var dataSource: FDChessboardViewDataSource? { get set }
/// Handler for user interaction with the view
public weak var delegate: FDChessboardViewDelegate?
/// Should piece moves be animated?
public var doesAnimate: Bool
/// Should legal squares be shown when a piece is selected?
public var doesShowLegalSquares: Bool
/// Should the lash move be shown?
public var doesShowLastMove: Bool
/// Should premove be shown?
public var doesShowPremove: Bool
/// UIView initializer
public override init(frame: CGRect)
/// UIView initializer
required public init?(coder aDecoder: NSCoder)
/// Add a piece onto the board
public func setPiece(piece: FDChessboardPiece?, forSquare square: FDChessboardSquare)
/// Repull all board information from data source
public func reloadData()
/// Move a piece on the board
public func movePieceAtCoordinate(from: FDChessboardSquare, toCoordinate to: FDChessboardSquare) -> Bool
/// Move a piece on the board
public func movePieceAtCoordinate(from: FDChessboardSquare, toCoordinate to: FDChessboardSquare, andPromoteTo piece: FDChessboardPiece) -> Bool
/// Premove a piece on the board
public func premovePieceAtCoordinate(from: FDChessboardSquare, toCoordinate to: FDChessboardSquare) -> Bool
/// Premove a piece on the board
public func premovePieceAtCoordinate(from: FDChessboardSquare, toCoordinate to: FDChessboardSquare, andPromoteTo piece: FDChessboardPiece) -> Bool
}
Installation
Installation
CocoaPods
CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:
$ gem install cocoapods
CocoaPods 0.39.0+ is required to build FDChessboardView 0.1.0+.
To integrate FDChessboardView into your Xcode project using CocoaPods, specify it in your Podfile
:
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0'
use_frameworks!
pod 'FDChessboardView', '~> 0.1'
Then, run the following command:
$ pod install
Carthage
Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.
You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate FDChessboardView into your Xcode project using Carthage, specify it in your Cartfile
:
github "fulldecent/FDChessboardView" ~> 0.1
Run carthage update
to build the framework and drag the built FDChessboardView.framework
into your Xcode project.
Upcoming Features
These following items are in the API for discussion and awaiting implementation:
- Display for last move
- Mutable game state (i.e. can move the pieces)
- Animation for piece moves
- Highlighting of legal squares for a piece after begin dragging
- Premove
See Also
See also Kibitz for Mac which is making a comeback https://github.com/fulldecent/kibitz