SetPortrait

Kategorie: Objekte / Darstellung
Ab Engineversion: 4.9.5.0 CE

Beschreibung

Ändert das Portrait eines Crew-Mitglieds während des Spiels.

Syntax

bool SetPortrait (string szPortrait, object pTarget, id idSrcDef, bool fPermanent, bool fCopyGfx);

Parameter

szPortrait:
Name des zu setzenden Portraits. Dabei wird die Datei "PortraitX.png" benutzt (wobei X der Name ist). Dieser Parameter kann die folgenden Spezialwerte annehmen:
Wert Bedeutung
"none" Portrait wird entfernt.
"random" Aus den vorhandenen Portraits wird eines zufällig ausgewählt.
"custom" Das Portrait wird auf das individuelle Portrait des Objekts, sofern vorhanden, geändert.
pTarget:
[opt] Objekt, dessen Portrait geändert werden soll. 0 bei lokalem Aufruf.
idSrcDef:
[opt] Definition, von der das Portrait entnommen werden soll. Wenn nicht angegeben, gilt die Definition des Objekts, dessen Grafik geändert wird.
fPermanent:
[opt] Wenn TRUE wird das neue Portrait in der Spielerdatei vermerkt und bei weiteren Runden ebenfalls verwendet. Andernfalls verfällt das Portrait nach dem Ende der Runde.
fCopyGfx:
[opt] Kopiert die Grafik des neuen Portraits in die Spielerdatei des Spielers und setzt das Portrait auf "custom". Dies bewirkt, dass das Portrait auch dann noch erhalten bleibt, wenn die Definition, aus der das Objekt kommt, nicht mehr vorhanden ist. Allerdings lässt sich dann nicht mehr zurückverfolgen, woher das Portrait stammt oder wie es heißt.

Beispiele

SetPortrait("random", FindObject(0, 0,0,0,0, OCF_CrewMember) );
Weißt einem Clonk ein zufälliges Portrait zu.
SetPortrait(GetPortrait(0, 0, 1), 0, GetPortrait(0, 1, 1) );
Stellt das Standardportrait eines Clonkes wieder her, falls es zwischenzeitlich durch andere SetPortrait-Aufrufe geändert wurde.
Siehe auch: GetPortrait
Clonk-Karl, Dezember 2005