documentation index ◦ reference manual ◦ function index
| Function: | renpy.imagemap | (ground, selected, hotspots, unselected=None, overlays=False, style='imagemap', with_none=None, **properties): |
Displays an imagemap. An image map consists of two images and a list of hotspots that are defined on that image. When the user clicks on a hotspot, the value associated with that hotspot is returned. Despite the name, this takes arbitrary displayables, not just image manipulators.
ground - The name of the file containing the ground image. The ground image is displayed for areas that are not part of any hotspots.
selected - The name of the file containing the selected image. This image is displayed in hotspots when the mouse is over them.
hotspots - A list of tuples defining the hotspots in this image map. Each tuple has the format (x0, y0, x1, y1, result). (x0, y0) gives the coordinates of the upper-left corner of the hotspot, (x1, y1) gives the lower-right corner, and result gives the value returned from this function if the mouse is clicked in the hotspot.
unselected - If provided, then it is the name of a file containing the image that's used to fill in hotspots that are not selected as part of any image. If not provided, the ground image is used instead.
overlays - If True, overlays are displayed when this imagemap is active. If False, the overlays are suppressed.
with_none - If True, causes a "with None" statement to be run after each interaction. If None (the default), checks config.implicit_with_none to determine if a "with None" should be run.
$ result = renpy.imagemap("ground.png", "selected.png", [ (100, 100, 300, 400, "eileen"), (500, 100, 700, 400, "lucy") ]) if result == "eileen": e "You picked me!" elif result == "lucy": e "It looks like you picked Lucy."