Merge branch 'release/0.1.0'

Author: XenGi

README.md

@@ -1,4 +1,29 @@
-pymlgame
-========
+# pymlgame
 
-pymlgame is an abstraction layer to easily build games for Mate Light inspired by pygame.
+pymlgame is an abstraction layer to easily build games for Mate Light inspired
+by pygame.
+
+You need 3 parts to actually have a running game on Mate Light.
+
+## The game
+
+You can build a game using the pymlgame library. If you know the pygame
+library this should meen nothing new to you. Use the game_example.py to find
+out how to to so.
+
+## A controller
+
+If you want players, your game needs a controller to have some inputs. You
+can use anything as a controller that can trigger the JSONRPC calls in your
+game. As an example you can use the controller_example.py and adapt it to
+your controller.
+
+## Mate Light
+
+Last but not least you need Mate Light as your display. If you are not at
+c-base space station but still want to tinker around with this you can use
+the emulator.py to do so.
+
+---
+
+Have fun while playing pymlgames on Mate Light! :D

controller_example.py

@@ -0,0 +1,99 @@
+#!/usr/bin/env python2.7
+# -*- coding: utf-8 -*-
+
+"""
+pymlgame - controller example
+=============================
+
+This example shows how you can use a controller connected to a laptop or any
+other machine capable of pygame to connect to a pymlgame instance.
+"""
+
+__author__ = 'Ricardo Band'
+__copyright__ = 'Copyright 2013, Ricardo Band'
+__credits__ = ['Ricardo Band']
+__license__ = 'MIT'
+__version__ = '0.1.0'
+__maintainer__ = 'Ricardo Band'
+__email__ = '[email protected]'
+__status__ = 'Development'
+
+import sys
+
+import pygame
+import jsonrpclib
+
+
+class Controller(object):
+    def __init__(self, host, port):
+        self.host = host
+        self.port = port
+        pygame.init()
+        self.joysticks = [[pygame.joystick.Joystick(j), None, None]
+                          for j in range(pygame.joystick.get_count())]
+        self.screen = pygame.display.set_mode((100, 10))
+        pygame.display.set_caption("pymlgame_ctlr")
+        self.clock = pygame.time.Clock()
+        self.server = jsonrpclib.Server('http://' + self.host + ':' +
+                                        str(self.port))
+        for joy in self.joysticks:
+            joy[0].init()
+            joy[1] = self.server.init()
+            if joy[0].get_name() == 'Xbox 360 Wireless Receiver':
+                joy[2] = {0: 'A',
+                          1: 'B',
+                          2: 'X',
+                          3: 'Y',
+                          4: 'L1',
+                          5: 'R1',
+                          6: 'Select',
+                          7: 'Start',
+                          11: 'Left',
+                          12: 'Right',
+                          13: 'Up',
+                          14: 'Down'}
+
+    def handle_events(self):
+        for event in pygame.event.get():
+            if event.type == pygame.QUIT:
+                pygame.joystick.quit()
+                pygame.quit()
+                sys.exit()
+            if event.type == pygame.KEYDOWN:
+                if event.key == pygame.K_ESCAPE:
+                    pygame.event.post(pygame.event.Event(pygame.QUIT))
+            if event.type == pygame.JOYBUTTONDOWN:
+                print('joy', self.joysticks[event.joy][0].get_name(),
+                      '(uid:', self.joysticks[event.joy][1], ')button pressed:',
+                      event.button)
+                self.server.trigger_button(self.joysticks[event.joy][1],
+                                           'KeyDown',
+                                           self.joysticks[event.joy][2][event.button])
+            if event.type == pygame.JOYBUTTONUP:
+                print('joy', self.joysticks[event.joy][0].get_name(),
+                      '(uid:', self.joysticks[event.joy][1], ')button released:',
+                      event.button)
+                self.server.trigger_button(self.joysticks[event.joy][1],
+                                           'KeyUp',
+                                           self.joysticks[event.joy][2][event.button])
+
+    def update(self):
+        pass
+
+    def render(self):
+        pygame.display.update()
+        pygame.display.flip()
+
+    def gameloop(self):
+        try:
+            while True:
+                self.handle_events()
+                self.update()
+                self.render()
+        except KeyboardInterrupt:
+            pass
+
+
+if __name__ == '__main__':
+    CTLR = Controller('127.0.0.1', 1338)
+    CTLR.gameloop()

emulator.py

@@ -0,0 +1,102 @@
+#!/usr/bin/env python2.7
+# -*- coding: utf-8 -*-
+
+"""
+pymlgame - Mate Light emulator
+==============================
+
+This little program emulates the awesome Mate Light, just in case you're not
+at c-base but want to code something for it.
+"""
+
+__author__ = 'Ricardo Band'
+__copyright__ = 'Copyright 2013, Ricardo Band'
+__credits__ = ['Ricardo Band']
+__license__ = 'MIT'
+__version__ = '0.1.0'
+__maintainer__ = 'Ricardo Band'
+__email__ = '[email protected]'
+__status__ = 'Development'
+
+import sys
+import socket
+
+import pygame
+
+
+class Emu(object):
+    """
+    The Emulator is a simple pygame game.
+    """
+    def __init__(self, width=40, height=40, ip='127.0.0.1', port=1337):
+        """
+        Creates a screen with the given size, generates the matrix for the
+        Mate bottles and binds the socket for incoming frames.
+        """
+        self.width = width
+        self.height = height
+        pygame.init()
+        self.screen = pygame.display.set_mode([self.width * 10,
+                                               self.height * 10])
+        pygame.display.set_caption("Mate Light Emu")
+        self.clock = pygame.time.Clock()
+        self.matrix = []
+        for c in range(self.width * self.height * 3):
+            self.matrix.append(0)
+
+        self.sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        self.sock.bind((ip, port))
+
+    def recv_data(self):
+        """
+        Grab the next frame and put it on the matrix.
+        """
+        data, addr = self.sock.recvfrom(self.width * self.height * 3 + 4)
+        self.matrix = map(ord, data.strip())[:-4]
+
+    def update(self):
+        """
+        Generate the output from the matrix.
+        """
+        pixels = len(self.matrix)
+        for x in range(self.width):
+            for y in range(self.height):
+                pixel = y * self.width * 3 + x * 3
+                #TODO: sometimes the matrix is not as big as it should
+                if pixel < pixels:
+                    pygame.draw.circle(self.screen, (self.matrix[pixel],
+                                                     self.matrix[pixel + 1],
+                                                     self.matrix[pixel + 2]),
+                                       (x * 10 + 5, y * 10 + 5), 5, 0)
+
+    def render(self):
+        """
+        Output the current screen.
+        """
+        pygame.display.update()
+        pygame.display.flip()
+
+    def gameloop(self):
+        """
+        Loop through all the necessary stuff and end execution when Ctrl+C
+        was hit.
+        """
+        try:
+            while True:
+                for event in pygame.event.get():
+                    if event.type == pygame.QUIT:
+                        sys.exit()
+                    if event.type == pygame.KEYDOWN:
+                        if event.key == pygame.K_ESCAPE:
+                            pygame.event.post(pygame.event.Event(pygame.QUIT))
+
+                self.recv_data()
+                self.update()
+                self.render()
+        except KeyboardInterrupt:
+            pass
+
+
+if __name__ == '__main__':
+    EMU = Emu()
+    EMU.gameloop()