GetPortrait

Kategorie: Objekte / Darstellung
Ab Engineversion: 4.9.5.0 CE

Beschreibung

Fragt Name oder ID des Portraits eines Crew-Mitglieds ab.

Syntax

any GetPortrait (object pObj, bool fGetID, bool fGetPermanent);

Parameter

pObj:
[opt] Objekt, über dessen Portrait Informationen abgefragt werden sollen. 0 bei lokalem Aufruf.
fGetID:
[opt] Wenn TRUE gibt die Funktion die ID der Definition zurück, aus der das Portrait stammt. Andernfalls wird der Name des Portraits zurückgegeben.
fGetPermanent:
[opt] Wenn TRUE gibt die Funktion die Portraitwerte des permanenten Portraits zurück, sonst die des momentan verwendeten.

Anmerkung

Hat das Crew-Mitglied ein individuelles Portrait, so gibt die Funktion "custom" bzw. die ID NONE zurück. Siehe dazu auch die Tabelle und die Beschreibung des fCopyGfx-Parameters von SetPortrait

Beispiele

if(!WildcardMatch(GetPortrait(0, 0, 1), "?") )
  SetPortrait("random", 0, GetPortrait(0, 1, 1), 1);
Weißt dem aufrufenden Clonk ein zufälliges Portrait zu, wenn der Name des momentanen Portraits nicht aus nur einem Zeichen besteht (zum Beispiel wenn die Portraits mit "1", "2", "3" etc. durchnummeriert sind), sondern länger ist (beispielsweise "Armored1" oder "Armored2").
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: SetPortrait
Clonk-Karl, Dezember 2005