Final exam version

venv/lib/python3.12/site-packages/pygame/examples/README.rst

@@ -0,0 +1,154 @@
+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.