Source code for pymunk.pygame_util

# ----------------------------------------------------------------------------
# pymunk
# Copyright (c) 2007-2012 Victor Blomqvist
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.
# ----------------------------------------------------------------------------

"""This submodule contains helper functions to help with quick prototyping 
using pymunk together with pygame.

Intended to help with debugging and prototyping, not for actual production use
in a full application. The methods contained in this module is opinionated 
about your coordinate system and not in any way optimized. 
"""

__version__ = "$Id$"
__docformat__ = "reStructuredText"

__all__ = ["draw_space", "draw_shape", "draw_circle", "draw_poly"
         , "draw_segment", "draw_constraint", "to_pygame", "from_pygame"]

import pygame

import pymunk
from pymunk.vec2d import Vec2d



[docs]def draw_space(surface, space): """Draw the contents of a pymunk.Space object on a pygame.Surface object This method currently supports drawing of * pymunk.Segment * pymunk.Circle * pymunk.Poly * pymunk.Constraint objects You can control the color of a shape by setting shape.color to the color you want it drawn in. >>> my_shape.color = pygame.color.THECOLORS["pink"] Not all constraints are currently drawn in a very clear way, but all the different shapes should look fine both as static and dynamic objects. See pygame_util.demo.py for a full example :Parameters: surface : pygame.Surface Surface that the space will be drawn on space : pymunk.Space The contents of this Space will be drawn on the surface. """ (width, height) = surface.get_size() for s in space.shapes: if not (hasattr(s, "ignore_draw") and s.ignore_draw): draw_shape(surface, s) for c in space.constraints: if not (hasattr(c, "ignore_draw") and c.ignore_draw): draw_constraint(surface, c)
[docs]def draw_shape(surface, shape): """Draw a pymunk.Shape object See the documentation of draw_space for full details :Parameters: surface : pygame.Surface Surface that the space will be drawn on shape : pymunk.Shape The Shape object to draw """ if isinstance(shape, pymunk.Circle): draw_circle(surface, shape) elif isinstance(shape, pymunk.Segment): draw_segment(surface, shape) elif isinstance(shape, pymunk.Poly): draw_poly(surface, shape)
[docs]def draw_circle(surface, circle): """Draw a pymunk.Circle object See help of draw_space for full details :Parameters: surface : pygame.Surface Surface that the space will be drawn on shape : pymunk.Circle The circle shape to draw """ circle_center = circle.body.position + circle.offset p = to_pygame(circle_center, surface) r = 0 if hasattr(circle, "color"): color = circle.color elif circle.body.is_static: color = pygame.color.THECOLORS["lightgrey"] r = 1 else: color = pygame.color.THECOLORS["red"] pygame.draw.circle(surface, color, p, int(circle.radius), r) circle_edge = circle_center + Vec2d(circle.radius, 0).rotated(circle.body.angle) p2 = to_pygame(circle_edge, surface) line_r = 3 if circle.radius > 20 else 1 pygame.draw.lines(surface, pygame.color.THECOLORS["blue"], False, [p,p2], line_r)
[docs]def draw_poly(surface, poly): """Draw a pymunk.Poly object See help of draw_space for full details :Parameters: surface : pygame.Surface Surface that the space will be drawn on shape : pymunk.Poly The poly shape to draw """ ps = poly.get_points() ps = [to_pygame(p, surface) for p in ps] ps += [ps[0]] if hasattr(poly, "color"): color = poly.color elif poly.body.is_static: color = pygame.color.THECOLORS["lightgrey"] else: color = pygame.color.THECOLORS["green"] pygame.draw.lines(surface, color, False, ps, 1)
[docs]def draw_segment(surface, segment): """Draw a pymunk.Segment object See help of draw_space for full details :Parameters: surface : pygame.Surface Surface that the space will be drawn on shape : pymunk.Segment The segment shape to draw """ body = segment.body pv1 = body.position + segment.a.rotated(body.angle) pv2 = body.position + segment.b.rotated(body.angle) p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) if hasattr(segment, "color"): color = segment.color elif segment.body.is_static: color = pygame.color.THECOLORS["lightgrey"] else: color = pygame.color.THECOLORS["blue"] pygame.draw.lines(surface, color, False, [p1,p2], max(int(segment.radius),1))
[docs]def draw_constraint(surface, constraint): """Draw a pymunk.Constraint object See the documentation of draw_space for full details :Parameters: surface : pygame.Surface Surface that the space will be drawn on shape : pymunk.Shape The Shape object to draw """ if isinstance(constraint, pymunk.GrooveJoint) and hasattr(constraint, "groove_a"): pv1 = constraint.a.position + constraint.groove_a pv2 = constraint.a.position + constraint.groove_b p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) pygame.draw.aalines(surface, pygame.color.THECOLORS["darkgray"], False, [p1,p2]) elif isinstance(constraint, pymunk.PinJoint): pv1 = constraint.a.position + constraint.anchr1.rotated(constraint.a.angle) pv2 = constraint.b.position + constraint.anchr2.rotated(constraint.b.angle) p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) pygame.draw.aalines(surface, pygame.color.THECOLORS["darkgray"], False, [p1,p2]) elif isinstance(constraint, pymunk.GearJoint): pv1 = constraint.a.position pv2 = constraint.a.position p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) pygame.draw.circle(surface, pygame.color.THECOLORS["darkgray"], p1, 3) pygame.draw.circle(surface, pygame.color.THECOLORS["darkgray"], p2, 3) elif hasattr(constraint, "anchr1"): pv1 = constraint.a.position + constraint.anchr1.rotated(constraint.a.angle) pv2 = constraint.b.position + constraint.anchr2.rotated(constraint.b.angle) p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) pygame.draw.aalines(surface, pygame.color.THECOLORS["darkgray"], False, [p1,p2]) else: pv1 = constraint.a.position pv2 = constraint.b.position p1 = to_pygame(pv1, surface) p2 = to_pygame(pv2, surface) pygame.draw.aalines(surface, pygame.color.THECOLORS["darkgray"], False, [p1,p2])
def get_mouse_pos(surface): """Get position of the mouse pointer in pymunk coordinates.""" p = pygame.mouse.get_pos() return from_pygame(p, surface)
[docs]def to_pygame(p, surface): """Convenience method to convert pymunk coordinates to pygame surface local coordinates """ return int(p[0]), surface.get_height()-int(p[1])
[docs]def from_pygame(p, surface): """Convenience method to convert pygame surface local coordinates to pymunk coordinates """ return to_pygame(p,surface)

Table Of Contents