CreateCamera()

Syntax

Ergebnis = CreateCamera(#Camera, x, y, Breite, Hoehe)

Erstellt eine neue Kamera in der aktuellen Welt an der Position 'x, y' mit den angegebenen Dimensionen. Beachten Sie, dass diese angegebene Position und Größe die Position und Größe der Anzeige ("Display") auf Ihrem Bildschirm sind, nicht die Position und Größe der Kamera in der Welt.

Im Gegensatz zu anderen grafikrelevanten Befehlen werden diese Koordinaten und Dimensionen in Prozent (von 0 bis 100) angegeben (für eine genauere Platzierung können Fließkommazahlen verwendet werden). Dies erscheint Ihnen vielleicht merkwürdig, aber 3D-Applikationen sollten unabhängig von der Bildschirmauflösung arbeiten und die Prozent-Methode ist eine gute Möglichkeit, dies zu erreichen. Wenn eine Kamera mit einer Höhe von 50% erstellt wird, dann wird sie immer 50% der Höhe des Bildschirms füllen, unabhängig davon, ob Sie einen Bildschirm mit 640*480 oder 1600*1200 verwenden. Wenn eine Kamera mit dem gleichen numerischen Bezeichner bereits erstellt wurde, dann wird die vorherige Kamera automatisch freigegeben und durch die neue ersetzt.

Kameras können überlappt werden. Dies bedeutet: es ist möglich eine Kamera anzuzeigen, die den gesamten Bildschirm füllt und darin eine weitere kleinere Kamera, die einen anderen Platz in der Welt anzeigt. Um dies zu erreichen, ist die Reihenfolge der Erstellung sehr wichtig: die Kamera, welche obenauf angezeigt werden soll, sollte als letzte erstellt werden.

Parameter

#Camera - Der numerische Wert, den Sie zum Identifizieren der Kamera bei der Benutzung der anderen Befehle dieser Library verwenden möchten.

x - Die prozentuale Position des linken Randes der Kamera-Anzeige auf dem Bildschirm. 0% bedeutet am linken Rand des Bildschirms, 100% bedeutet am rechten Rand des Bildschirms.

y - Die prozentuale Position des oberen Randes der Kamera-Anzeige auf dem Bildschirm. 0% bedeutet am oberen Rand des Bildschirms, 100% bedeutet am unteren Rand des Bildschirms.

Breite - Der Prozentanteil der Breite des Bildschirms, den die Anzeige dieser Kamera nutzen soll.

Hoehe - Der Prozentanteil der Höhe des Bildschirms, den die Anzeige dieser Kamera nutzen soll.

Rückgabewert

Gibt '0' zurück, wenn die #Camera nicht erstellt werden konnte. Wenn #PB_Any als Parameter '#Camera' verwendet wird, dann wird die Nummer der neuen Kamera als 'Ergebnis' zurückgegeben.

Beispiel:

  CreateCamera(0, 0, 0, 100, 100) ; Erstellt eine Kamera, welche den gesamten Bildschirm ausfüllt
  
  CreateCamera(0, 0,  0, 100, 50) ; Erstellt einen horizontalen Splitscreen Effekt, für einen
  CreateCamera(1, 0, 50, 100, 50) ; 2 Spieler-Modus auf dem gleichen Bildschirm

  CreateCamera(0, 0, 0, 100, 100) ; Erstellt einen "Fullscreen"-Kamera
  CreateCamera(1, 25, 0, 50, 10)  ; und einen Rückspiegel-Effekt.
                                  ; Beachte: der Rückspiegel wird zuletzt erstellt und wird so
                                  ; auf der "Fullscreen"-Kamera angezeigt

Unterstützte OS

Alle