gtn/.venv/Lib/site-packages/pygame/examples/README.rst

These examples are a good introduction to various Pygame modules and 
techniques. They are beginner-friendly with source code in the public 
domain that can be adapted for your projects.


aacircles.py
   An example of using the gfxdraw module to drawing anti-aliased circles.

aliens.py
   An arcade-style space shooter game that showcases various common and 
   important Pygame modules and techniques.

arraydemo.py
   Showcases the use of Numpy with Pygame to perform efficient 
   pixel manipulation.

audiocapture.py
   Use the mixer module to record sound from a microphone, and 
   play back the recorded sound.

blend_fill.py
   Demonstrates how to perform surface blending and filling 
   with Pygame.

blit_blends.py
   Uses blit functions to showcase some of Pygame's different 
   blending modes.

camera.py
   Basic image capturing and display using pygame.camera

chimp.py
   A simple game featuring a chimp that showcases the use of 
   common and important Pygame modules and techniques.

cursors.py
   Demonstrates the creation of custom cursors with Pygame.

dropevent.py
   Drag and drop files using the following events:
   DROPBEGIN, DROPCOMPLETE, DROPTEXT, DROPFILE

eventlist.py
   A utility for displaying and logging real-time Pygame events, 
   useful for debugging.

font_viewer.py
   Demonstrates how to display all available fonts in a 
   scrolling window.

fonty.py
   A simple application demonstrating the different ways 
   to render fonts with the font module

freetype_misc.py
   Shows how to use the freetype module to perform font
   rendering and manipulation.

glcube.py
   Using PyOpenGL and Pygame, this creates a spinning 3D multicolored cube.

go_over_there.py
   Demonstrates the important Vector.move_towards() function.

grid.py
   A simple example of grid-based movement.

headless_no_windows_needed.py
   Shows how to run Pygame in scripts.

joystick.py
   Shows how to integrate joysticks or game controllers into Pygame.

liquid.py
   Demonstrates how to create a simple liquid effect in an image. 

mask.py
   Showcases how to use masks for collision detection and sprite 
   interaction.

midi.py
   Demonstrates how to use MIDI I/O using the midi module.

moveit.py
   Illustrates how to accomplish sprite movement and animation.

music_drop_fade.py
   Showcases dropping music files into Pygame, and how to
   apply a fade effect to music playback.

pixelarray.py
   Manipulation of individual pixels using the PixelArray module.

playmus.py
   Uses the mixer module to play music files with CLI.

prevent_display_stretching.py
   Illustrates how to maintain aspect ratio when resizing a window
   in Pygame.

resizing_new.py
   Showcases various window resizing events and how to fit graphics
   to new dimensions.

scaletest.py
   Showcases the scaling of Surfaces.

scrap_clipboard.py
   Shows how to implement clipboard interaction with Pygame's scrap module.

scroll.py
   An example that implements smooth scrolling backgrounds for side-scrolling 
   games or parallax effects.

setmodescale.py
   Handles mouse scaling and selection of a good sized window depending
   on the display.

sound.py
   Illustrates how to implement sound effects and music using Pygame.

sound_array_demos.py
   Showcases echo, delay and other array based processing of sounds.

sprite_texture.py
   Demonstrates how to use textured sprites in Pygame.

stars.py
   A simple starfield implementation in which the perspective can be
   changed by a mouse click.

testsprite.py
   Showcases the basics of sprite handling, namely collision 
   detection and animation.

textinput.py
   A little "console" where you can write in text.
   Shows how to use the TEXTEDITING and TEXTINPUT events.

vgrade.py
   Shows how to apply vertical gradients to surfaces using Pygame.

video.py
   Showcases the movie module, including the display of playback 
   controls.

data/
   Directory with the resources for the examples.


More examples can be found on the Pygame website and GitHub.
We're always looking for new examples and/or example requests. Examining
code such as this is a great way to get started with Python-based 
game development.