### Navigation

- index
- modules |
- next |
- previous |
- pymunk 3.0.0 documentation »
- API Reference »

# `pymunk.pygame_util` Module

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.

`pymunk.pygame_util.``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.

`pymunk.pygame_util.``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

`pymunk.pygame_util.``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

`pymunk.pygame_util.``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

`pymunk.pygame_util.``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

`pymunk.pygame_util.``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

`pymunk.pygame_util.``to_pygame`(p, surface)

  Convenience method to convert pymunk coordinates to pygame surface local coordinates

`pymunk.pygame_util.``from_pygame`(p, surface)

  Convenience method to convert pygame surface local coordinates to pymunk coordinates

### Navigation

- index
- modules |
- next |
- previous |
- pymunk 3.0.0 documentation »
- API Reference »