The games module defines functions for working with images, sound, and music, which I list in Table A.9.
Function | Description |
---|---|
load_image(file_name [, transparent]) | Returns an image object loaded from the file named in the string file_name and sets transparency if transparent is equal to a value that can be treated as True. The default value of transparent is a value that can be treated as True. |
scale_image(image, x_scale [, y_scale]) | Returns a new image object scaled in the x direction by a factor of x_scale and in the y direction by a factor of y_scale. If no value is passed to y_scale, then the image is scaled by a factor of x_scale in both directions. The original image image is unchanged. |
load_sound(file_name) | Returns a sound object from a WAV file named in the string file_name. |
load_music(file_name) | Loads music from the file named in the string file_name. |
play_music([loop]) | Plays the current music loop number of times in addition to its initial playing. A value of -1 means loop forever. The default value of loop is 0. |
fade_out_music(millisec) | Fades out the current music in millisec milliseconds. |
stop_music() | Stops the current music. |
The sound object returned by load_sound() has several methods available to it, which are listed in Table A.10.
Method | Description |
---|---|
play([loop]) | Plays the sound loop number of times in addition to its initial playing. A value of -1 means loop forever. The default value of loop is 0. |
fadeout(millisec) | Fades out the sound in millisec milliseconds. |
stop() | Stops the sound on all channels. |