• Stars
    star
    77
  • Rank 401,709 (Top 9 %)
  • Language
    Swift
  • License
    MIT License
  • Created over 9 years ago
  • Updated over 4 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

An iOS / Mac view controller for chess boards

FDChessboardView

CI Status Version License Platform Carthage compatible

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)

Installation

Add FDChessboardView to your project using Swift Package Manager. In Xcode that is simply: File > Swift Packages > Add Package Dependency... and you're done. Alternative installations options are shown below for legacy projects.

CocoaPods

If you are already using CocoaPods, just add 'FDChessboardView' to your Podfile then run pod install.

Carthage

If you are already using Carthage, just add to your Cartfile:

github "fulldecent/FDChessboardView" ~> 0.1

Then run carthage update to build the framework and drag the built FDChessboardView.framework into your Xcode project.

Usage

Import the project and implement a data source:

import FDChessboardView

public protocol FDChessboardViewDataSource: class {
    /// What piece is on the square?
    func chessboardView(_ board: FDChessboardView, pieceForSquare square: FDChessboardSquare) -> FDChessboardPiece?

    /// The last move
    func chessboardViewLastMove(_ board: FDChessboardView) -> (from:FDChessboardSquare, to:FDChessboardSquare)?

    /// The premove
    func chessboardViewPremove(_ board: FDChessboardView) -> (from:FDChessboardSquare, to:FDChessboardSquare)?
}

If your application will allow the pieces to be moved, implement a delegate:

public protocol FDChessboardViewDelegate: class {
    /// Where can this piece move to?
    func chessboardView(_ board: FDChessboardView, legalDestinationsForPieceAtSquare from: FDChessboardSquare) -> [FDChessboardSquare]

    /// Before a move happenes
    func chessboardView(_ board: FDChessboardView, canMoveFrom from: FDChessboardSquare, to: FDChessboardSquare, withPromotion promotion: FDChessboardPiece?) -> Bool

    /// After a move happened
    func chessboardView(_ board: FDChessboardView, didMoveFrom from: FDChessboardSquare, to: FDChessboardSquare, withPromotion promotion: FDChessboardPiece?)
}

Then you can customize the view or call certain actions:

/// The location of a square on a chess board
public struct FDChessboardSquare: Hashable {
    /// From 0...7 (a...h)
    public let file: Int
    
    /// From 0...7 (white king starting position to black king starting position)
    public let rank: 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
}

/// Display for a chess board
@IBDesignable open class FDChessboardView: UIView {
    @IBInspectable open var lightBackgroundColor: UIColor
    @IBInspectable open var darkBackgroundColor: UIColor
    open var targetBackgroundColor: UIColor
    open var legalBackgroundColor: UIColor
    open var lastMoveColor: UIColor
    open var premoveColor: UIColor
    open weak var dataSource: FDChessboardViewDataSource?
    open weak var delegate: FDChessboardViewDelegate?
    open var doesAnimate: Bool
    open var doesShowLegalSquares: Bool
    open var doesShowLastMove: Bool
    open var doesShowPremove: Bool

    /// Add a piece onto the board
    open func setPiece(_ piece: FDChessboardPiece?, forSquare square: FDChessboardSquare)

    /// Repull all board information from data source
    open func reloadData()

    /// Move a piece on the board, clears any prior premove
    open func move(_ piece: FDChessboardPiece, from: FDChessboardSquare, to: FDChessboardSquare, promotedTo promoted: FDChessboardPiece?)
    
    /// Premove a piece on the board, clears any prior premove
    open func premove(_ piece: FDChessboardPiece, from: FDChessboardSquare, to: FDChessboardSquare, promotedTo promoted: FDChessboardPiece?)
    
    /// Removes any premove on the board
    open func clearPremove()
    
    /// Move a piece on the board, clears any prior premove
    open func unmove(_ piece: FDChessboardPiece, from: FDChessboardSquare, to: FDChessboardSquare, promotedTo promoted: FDChessboardPiece?, capturing: FDChessboardPiece)
}

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

License

FDChessboardView is available under the MIT license. See the LICENSE file for more information.

More Repositories

1

system-bus-radio

Transmits AM radio on computers without radio transmitting hardware.
C
6,115
star
2

FDWaveformView

Reads an audio file and displays the waveform
Swift
1,202
star
3

swift5-module-template

An opinionated starting point for awesome, reusable Swift 5 modules
Swift
437
star
4

FDTake

Easily take a photo or video or choose from library
Swift
322
star
5

FDSoundActivatedRecorder

Start recording when the user speaks
Swift
278
star
6

corelocationcli

Command line program to print location information from CoreLocation
Swift
206
star
7

formant-analyzer

iOS application for finding formants in spoken sounds
Swift
51
star
8

spend-ERC20-create-ERC721

Tech demo: customers spend your ERC-20 tokens to create their ERC-721 certificates
Solidity
49
star
9

cameralife

Camera Life -- Run your own photo website
PHP
40
star
10

github-pages-template

An opinionated starting point and build system for awesome, collaboratively-edited HTML websites
JavaScript
31
star
11

opensea-shared-storefront-backdoor

Demonstration of a backdoor in OpenSea Shared Storefront
JavaScript
30
star
12

FDTextFieldTableViewCell

A UITableViewCell with an editable text field
Swift
26
star
13

FDBarGauge

The successor to F3BarGauge
Swift
25
star
14

google-voice-numbers

Retrieves the full list of available Google Voice numbers and finds the best ones
HTML
24
star
15

erc721-example

A scalable example of the ERC-721 standard
Solidity
19
star
16

solidity-template

The starting point for every Solidity project
Solidity
18
star
17

19-questions

A machine learning / bayesian inference engine assigning attributes to objects
PHP
16
star
18

eavesdrop

Listen in on TCP conversations on the network your computer is attached to
Objective-C
16
star
19

google-sheets-etl

Live import all your Google Sheets to your data warehouse
PHP
15
star
20

8-ball

A delightfully simple iOS + watchOS app for answering questions
Swift
14
star
21

freescout-sidebar-webhook

Sidebar Webhook asynchronously injects HTML from your server into conversation sidebars
PHP
14
star
22

philadelphia-traffic-court-rtk

Every traffic violation in the city of Philadelphia issued from 2006 to 2014
Python
12
star
23

pro-penetration

Penetration research against NSFW websites
PHP
11
star
24

structured-acceptance-test

An open format definition for static analysis tools
Ruby
10
star
25

lightning-sites

โ˜๏ธ Lightning deployment for your ~/Sites folders
Ruby
10
star
26

footballbetting

Automatically exported from code.google.com/p/footballbetting
9
star
27

pizzaman

The iOS game
Swift
8
star
28

contract-scanner

A tool to find all NFT contracts on an EVM blockchain
JavaScript
6
star
29

linkbuilding-spider

A PHP project to check if websites are linking to your website
PHP
6
star
30

web-puc

Validate your web project uses the latest CSS & JS includes
Ruby
6
star
31

custodial721

A token that holds other tokens / Can also create and transfer 721s in batch
5
star
32

pawn-bfs

A breadth-first enumeration of all reachable chess diagrams
C
5
star
33

solidity-monolithic-flattener

A tool to flatten solidity contracts for runtime optimization
4
star
34

thin-pdo

A minimal wrapper for PHP's PDO class to make database access easier
PHP
3
star
35

fedex-ship-manager-api

Documentation for hidden FedEx Ship Managerยฎ API
HTML
3
star
36

voicemail-remote

Continuously update your voicemail outgoing message
Shell
3
star
37

live-testing-with-estimateGas

Code examples from the article published with 0xcert
HTML
3
star
38

aion-aip040

Reference implementation for Aion non-fungible tokens
Java
3
star
39

podcast.phor.net

HTML
2
star
40

html-proofer-mailto_awesome

A custom html-proofer test that makes your mailto links awesome
Ruby
2
star
41

chess-upper-bound-armies

An upper bound of Chess positions by counting army configurations
C
2
star
42

wrapped-number-board

Solidity
2
star
43

Nineteen-Eighty-Five

A novel by William Entriken, based on the public domain work of George Orwell
CSS
2
star
44

tmp-swift5-module

Swift
2
star
45

versioned_database_template

A demonstration of versioned, hashable, attestable databases
2
star
46

sillyutility.net

Compare Utility Bills With Neighbors.
HTML
2
star
47

echo

The best way to practice speaking English or Spanish
Swift
2
star
48

alephcrypto.xyz

https://alephcrypto.xyz
HTML
2
star
49

septa-regionalrail-otp

These reports use every train's arrival time from 2009 until present to recommend schedule changes for chronically late service
HTML
2
star
50

you-cant-leave-this-page

Proof of concept where you can't leave a web page
HTML
1
star
51

phor.net

HTML
1
star
52

open-location-code-wiki

1
star
53

vulnerability-demo.justjavac.com

https://privacylog.blogspot.com/2021/04/upcoming-event-zero-day-live-2021-05-01.html
1
star
54

e-zpass-v-toll-batch-dispute

Documentation to quickly dispute E-ZPass V-TOLL violations
1
star
55

jump-qrs

QR codes which redirect to a destination website as configured in this repository
HTML
1
star
56

rubygems-issue-6214

1
star
57

beginner-project-php-sql

You will learn to create your first meaningful PHP project which connects to a database
1
star
58

blog.phor.net

William Entriken Blog โ€” Analysis of all
CSS
1
star
59

aip-xxx-implementation

Java playground illustrating all best practices for Aion development
Java
1
star
60

blackjack-simulator

JavaScript implementation of blackjack rules and player betting strategies
C
1
star
61

qr-radiation

An optimizer that makes your QR code look like a target graphic by manipulating your URL
JavaScript
1
star
62

impostor

Who's the impostor?
HTML
1
star