HOWTO · Pygame

surface.blit() Funktion in Pygame

Erfahren Sie, wie Surface.blit() Pixel zwischen Pygame-Oberflächen kopiert, das Ergebnis positioniert und einen Quellbereich auswählt.

Auf dieser Seite

Surface.blit() kopiert Pixel von einer Quell-Surface auf eine Ziel-Surface. Bei einer Pygame-Anzeige ist der Bildschirm die Zieloberfläche; Sie können auch auf eine Oberfläche außerhalb des Bildschirms zeichnen und dieses Ergebnis dann auf dem Bildschirm platzieren. Die kurzen Operationsbeispiele unten erläutern die Argumente, während der letzte Abschnitt sie in ein vollständiges Fenster mit Ereignisschleife einbettet.

Diese Beispiele konzentrieren sich auf das Kopieren und Positionieren von Pixeln. Sie demonstrieren kein Blending. Anweisungen zur Einrichtung finden Sie im Beispiel für ein minimales Pygame-Fenster; die Beispiele hier konzentrieren sich auf das Zeichnen zwischen Oberflächen und nicht auf das Erstellen eines Fensters.

Wie Surface.blit() eine Oberfläche auf eine andere zeichnet

Rufen Sie blit() auf der Oberfläche auf, die die Pixel empfangen soll. Ihr erstes Argument ist die Quelloberfläche, und ihr zweites Argument gibt die Zielposition an: die obere linke Ecke, an der die Quelle gezeichnet wird. Beispielsweise platziert destination.blit(source, (20, 30)) die Quelle an der x-Koordinate 20 und der y-Koordinate 30 auf dem Ziel. Ein Tupel mit zwei Elementen ist eine klare Art, diese Position auszudrücken.

Die Methode akzeptiert außerdem einen optionalen Quellbereich und einen Wert für spezielle Flags. Der Quellbereich ist ein Rechteck, das von der oberen linken Ecke der Quelloberfläche aus gemessen wird; er legt fest, welcher Teil kopiert wird. Wenn Sie ihn weglassen, wird die gesamte Quelloberfläche verwendet. Spezielle Flags wählen eine Pygame-Blit-Operation aus, beispielsweise eine Blend-Operation. Sie sind von den Argumenten für Zielposition und Quellbereich getrennt, und das Beispiel hier belässt sie auf ihrem Standardwert.

Die Aufrufform lautet destination.blit(source, destination_position, source_area=None, special_flags=0). Die Methode blit() gibt ein Rechteck zurück, das den betroffenen Bereich auf dem Ziel beschreibt, was nützlich sein kann, wenn nur ein Teil einer Anzeige aktualisiert wird. Eine Zielposition außerhalb der Zieloberfläche kann dazu führen, dass nur der überlappende Teil gezeichnet wird.

Surface.blit() mit einem Quellbereich verwenden

Erstellen Sie Oberflächen mit pygame.Surface((width, height)) und füllen Sie sie dann mit einem RGB-Farbtupel wie (200, 100, 100). Um einen ausgewählten Quellbereich zu kopieren, übergeben Sie als drittes Argument ein Rechteck in der Form (x, y, width, height). Beispielsweise wählt (0, 0, 10, 5) ein Rechteck von 10 mal 5, das an der oberen linken Ecke der Quelle beginnt. Die kopierten Pixel beginnen an der Zielposition, die Sie als zweites Argument übergeben.

Nachdem Sie auf eine Oberfläche außerhalb des Bildschirms gezeichnet haben, zeichnen Sie diese Oberfläche innerhalb der Ereignisschleife auf die Anzeige. Löschen oder zeichnen Sie die Anzeige in jedem Frame neu, bevor Sie pygame.display.flip() aufrufen; andernfalls können Inhalte früherer Frames sichtbar bleiben. Die Abbildung zeigt die Idee, einen Quellbereich auf eine andere Oberfläche zu kopieren.

Blit-Funktion in Pygame

Ein vollständiges Pygame-Beispiel ausführen

Das folgende Programm erstellt ein Fenster, füllt zwei Oberflächen, kopiert einen ausgewählten Bereich von einer auf die andere und zeichnet das Ergebnis für 60 Frames, bevor es sich schließt. Es initialisiert nur das Anzeige-Subsystem, da dieses Beispiel kein Audio verwendet. Installieren Sie Pygame in der Python-Umgebung, die Sie zum Ausführen verwenden. Ersetzen Sie range(60) durch while running, wenn das Fenster geöffnet bleiben soll, bis Sie es schließen. Der bereitgestellte Lauf gab die Pygame-Startmeldungen und die unten gezeigte Kopierbestätigung aus.

import sys
import warnings

warnings.filterwarnings(
    "ignore",
    message="Your system is avx2 capable but pygame was not built with support for it.*",
    category=RuntimeWarning,
)

import pygame

pygame.display.init()
screen = pygame.display.set_mode((640, 480), pygame.RESIZABLE)
pygame.display.set_caption("Surface.blit() example")
clock = pygame.time.Clock()

destination = pygame.Surface((100, 100))
destination.fill((200, 100, 100))

source = pygame.Surface((30, 30))
source.fill((100, 200, 100))

# Copy a 10-by-5 region from source to destination at (10, 10).
destination.blit(source, (10, 10), (0, 0, 10, 5))
print("Copied a 10-by-5 source area to (10, 10).")

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

    if not running:
        break

    screen.fill((20, 20, 20))
    screen.blit(destination, (10, 10))
    pygame.display.flip()
    clock.tick(60)

pygame.quit()
sys.exit()
pygame 2.6.1 (SDL 2.26.5, Python 3.14.7)
Hello from the pygame community. https://www.pygame.org/contribute.html
Copied a 10-by-5 source area to (10, 10).