/HackRPI-Pygame-Template

Primary LanguagePython

Project Template: Getting Started with Pygame

Setup and Installation:

  1. Ensure you have Python on your machine: Download Python

  2. Install Pygame using pip:

    pip install pygame

  3. Verify the installation by running the following Python commands:

    import pygame
print("Pygame version:", pygame.__version__)

Getting Started:

  1. To get started, you will first want to initalize a Pygame window:

    # https://www.pygame.org/docs/
import pygame

# Initialize the pygame library
pygame.init()

SCREEN_DIMENSIONS = (750, 750)

# Creating the base pygame screen
screen = pygame.display.set_mode(SCREEN_DIMENSIONS)

  2. You may notice that the window only appears briefly. This is because we have not established a render loop yet:

    ...

# Creating the base pygame screen
screen = pygame.display.set_mode(SCREEN_DIMENSIONS)

# Creating the clock used to frame rate management
clock = pygame.time.Clock()

running = True
while (running):
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # Updates the screen
    pygame.display.flip()

    clock.tick(60)

  3. We now have a proper screen! But what if we want to change the color? We can do this by utilizing the fill() command:

    # Creating the base pygame screen
screen = pygame.display.set_mode(SCREEN_DIMENSIONS)

# Creating the clock used to frame rate management
clock = pygame.time.Clock()

running = True
while (running):
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # Fills the screen in (r, g, b) format
    screen.fill((255, 0, 0))

    # Updates the screen
    pygame.display.flip()

    clock.tick(60)

  4. Now, lets try adding an external image using the pygame.image.load() and blit() functions:

    # Creating the base pygame screen
screen = pygame.display.set_mode(SCREEN_DIMENSIONS)

# Creating the clock used to frame rate management
clock = pygame.time.Clock()

logo = pygame.image.load('logo.png')

running = True
while (running):
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # Fills the screen in (r, g, b) format
    screen.fill((255, 0, 0))

    # Displays the HackRPI logo in (x, y) format
    screen.blit(logo, (60, 60))

    # Updates the screen
    pygame.display.flip()

    clock.tick(60)

  5. Now, it is up to you! There are many more features that Pygame presents and I recommend that you explore them! Pygame Documentation

Template Author: