STNE-Wiki - Benutzerbeiträge [de]

API:EBeamResource

2010-09-03T08:17:27Z

SimonSlater:

{{Vorlage:ApiMenu}}

[[API:EBeamResource|EBeamResource]] ist ein [[API:Enum|Enumerator]].

Jeder Enumerator ist sozusagen mit einer Liste von möglichen Werten versehen.
'''Hinter diesen Werten verstecken sich eigentlich nur Integer-Werte, mehr dazu siehe unter [[API:Enum|Enumerator]]

[[API:EBeamResource|EBeamResource]] enthält alle Waren, die man per Skriptengine beamen bzw. Transportieren kann.

Beispiel:
Die Funktion [[API:CBaseShipManager|Ship.Action.TransferToShip(ShipID As Integer, Menge As Integer, WarenTyp As EBeamResource)]]
verlangt als dritten Paramater eine Variable vom Typ [[API:EBeamResource|EBeamResource]]. Möchte man z.B. Deuterium beamen, ist der Parameter wie folgt anzugeben:

Var meinSchiff As New CMyShip(12345);
meinSchiff.Action.TransferToShip(54321, 100, EBeamResource.Deuterium);

EBeamResource ist mit folgenden Werten definiert:
{|
! Name !! Übersetzung
|-
| Antimatter || Antimaterie
|-
| Contrabands || Schmuggelgüter
|-
| Credits ||
|-
| Crew ||
|-
| Deuterium ||
|-
| Dilithium ||
|-
| Duranium ||
|-
| Energy || Energie
|-
| EscapePods || Rettungskapseln
|-
| Food || Nahrung
|-
| Gifts || Geschenke
|-
| IridiumOre || Iridiumerz
|-
| IsoChips ||
|-
| Item ||
|-
| Larne ||
|-
| Latinum ||
|-
| Nitrium ||
|-
| PhotonTorpedoes ||
|-
| Plasma ||
|-
| PlasmaTorpedoes ||
|-
| Plasteel || Baumaterial
|-
| QuantumTorpedoes ||
|-
| Sorium ||
|-
| Tribbels ||
|-
| Tritanium ||
|}

Spieler Diskussion:SimonSlater

2010-09-02T17:28:15Z

SimonSlater: Die Seite wurde neu angelegt: „open for discussion“

open for discussion

API:Math

2010-09-02T17:26:55Z

SimonSlater: /* Methoden */

{{Vorlage:ApiMenu}}

Mit Hilfe der Klasse [[API:Math|Math]] ist es möglich, mathematische Ausdrücke zu berechnen, z.B Auf-/ und Abrunden, Logarithmische und Exponentialfunktionen, Beträge berechnen und vieles mehr.

Beispiele:

Var d As Double = -2.55;
Var e As Double = -4.00

WriteLine(Math.Abs(d)); // Gibt 2.55 zurück
WriteLine(Math.Max(d,e)); //Gibt -2.55 zurück
WriteLine(Math.Min(d,e)); //Gibt -4 zurück
WriteLine(Math.Truncate(d); //Gibt -2 zurück

WriteLine(Math.Pow(e, 3)); //-4 hoch 3 = -64

Var f As Double = 3.75;
Var g As Double = 3.25;

WriteLine(Math.Floor(f)); // Gibt 3 zurück
WriteLine(Math.Ceiling(g)); // Gibt 4 zurück

WriteLine("Ein Kreis mit dem Durchmesser 30cm hat einen Umfang von " & (Math.PI*30) & " cm!");
WriteLine(Math.Pow(Math.E, 1)); //Was ist wohl e hoch 1?
== Methoden ==

* Diese Funktion kann mit Double, Integer, Short oder Long-Variablen aufgerufen werden

{|
|-
! Name !! Parameter !! Beschreibung
|-
| Abs || * || Gibt den Betrag, also den Wert ohne Vorzeichen zurück.
|-
| Acos || [[API:Double|Double]] || Arcuscosinus
|-
| Asin || [[API:Double|Double]] || Arcussinus
|-
| Atan || [[API:Double|Double]] || Arcuscosinus
|-
| BigMul || [[API:Integer|Integer]], [[API:Integer|Integer]] || Multipliziert zwei Integer und gibt eine Variable vom Typ Long zurück
|-
| Ceiling || [[API:Double|Double]] || Rundet die Zahl auf
|-
| Cos || [[API:Double|Double]] || Cosinus
|-
| Cosh || [[API:Double|Double]] || Cosinushyperbolicus
|-
| E || - || Gibt eine Double-Variable mit der eulerischen Zahl zurück
|-
| Exp || [[API:Double|Double]] || "e-hoch", also die e-Funktion
|-
| Floor || [[API:Double|Double]] || Rundet die gegebene Zahl ab
|-
| IEEERemainder || * ||
|-
| Log || [[API:Double|Double]] || Berechnet den Logarithmus zur Basis der eulerischen Zahl
|-
| Log || [[API:Double|Double]], [[API:Double|Double]] || Berechnet Logarithmus zur angegeben Basis
|-
| Log10 || * || Berechnet den Logarithmus zur 10er Basis
|-
| Max || *, * || Gibt die größere der beiden gegebenen Zahlen zurück
|-
| Min || *, * || Gibt die kleienre de rbeiden gegebenen Zahlen zurück
|-
| PI || - || Gibt eine Double-Variable mit der Kreiszahl Pi zurück
|-
| Pow || [[API:Double|Double]], [[API:Double|Double]] || Potenzrechnung
|-
| Round || [[API:Double|Double]] || Gegebenen Wert runden
|-
| Round || [[API:Double|Double]], [[API:Integer|Integer]] || Gegebenen Wert auf die Anzahl der gewünschten Stellen runden
|-
| Sign || * || Gibt das Vorzeichen einer Zahl zurück
|-
| Sin || [[API:Double|Double]] || Sinus
|-
| Sinh || [[API:Double|Double]] || Sinushyperbolicus
|-
| Sqrt || [[API:Double|Double]] || Zieht die Wurzel aus der gegebenen Zahl
|-
| Tan || [[API:Double|Double]] || Tangens
|-
| Tanh || [[API:Double|Double]] || Tangenshyperbolicus
|-
| Truncated || [[API:Double|Double]] || Gibt die Zahl vor dem Komma zurück

API:CHtmlSubmitButton

2010-08-21T13:18:01Z

SimonSlater: Die Seite wurde neu angelegt: „{{Vorlage:ApiMenu}} == Allgemein == {{Code|CHtmlSubmitButton}} ist dazu da, ein Portal interaktiv zu gestalten. In Verbindung mit einem Html-Formular [[API:CHt…“

{{Vorlage:ApiMenu}}

== Allgemein ==

{{Code|CHtmlSubmitButton}} ist dazu da, ein Portal interaktiv zu gestalten. In Verbindung mit einem Html-Formular [[API:CHtmlForm|CHtmlForm]] mit zugehöriger Url [[API:CScriptUrl|CScriptUrl]] kann man Buttons erstellen, mit denen man verschiedene Seiten anzeigen oder auch Aktionen auslösen kann.

Wenn du einen Button einfügen willst, solltest du das wenn möglich als Formular tun, vor allem wenn du noch zusätzliche Parameter übergeben willst (siehe [[API:CHtmlForm|CHtmlForm]]).

Var Form As New CHtmlForm(New CScriptUrl());
form.Add(New CHtmlSubmitButton('Drück mich', 'Aktion'));
Response.Add(Form);

Mit diesen drei Zeilen hast du deinen Button erstellt. Der erste Parameter gibt den Text der auf dem Button stehen soll an, der zweite den internen Namen des Buttons (wichtig für Abfrage ob der Button gedrückt, s.u.).
Es muss natürlich nur ein [[API:CHtmlForm|CHtmlForm]] erstellt werden, dem dann mit ''form.Add'' die verschiedensten Sachen hinzufgefügt werden können.

Nun muss das ganze Formular noch der Ausgabe Response ([[API:CWebResponse|CWebResponse]]) hinzugefügt werden. Es können auch nach Response.Add noch Sachen zum Formular hinzugefügt werden.

Um nun nach dem Klick auf den Button auch eine Aktion auszuführen musst du dein Skript noch überprüfen lassen, ob der Button gedrückt wurde:

If(Request.Form.ContainsKey('Aktion'))
{
Response.Add('Du hast auf den Button "Aktion" gedrückt!');
}

Mit Request ([[API:CWebRequest|CWebRequest]]) lassen sich die Parameter abrufen, die beim "Anfordern" der Seite mit übergeben wurden. Diese sind in Form einer [[API:CCStringHashTable|CStringHashTable]] gespeichert und lassen sich leicht mit deren Funktion ''ContainsKey'' abfragen.

Hier wird der Text in den geschweiften Klammern ausgegeben, wenn der Button zuvor gedrückt wurde. Natürlich kann dort dann beliebiger Code ausgeführt werden, z.B. aus [[API:CBaseShipManager|CBaseShipManager]].

--[[Spieler:SimonSlater|SimonSlater]] 15:18, 21. Aug. 2010 (CEST)

API:CDataNodeList

2010-08-20T17:00:32Z

SimonSlater:

{{Vorlage:ApiMenu}}

== Allgemein ==

{{Code|CDataNodeList}} ist ein Listenobjekt, welches Objekte vom Typ [[API:CDataNode|CDataNode]] aufnimmt. Es ist das "Arbeitstier" der Datenbank-Verwaltung und kommt bei jeder Abfrage oder beim Schreiben in eine Datenbank vor.

In den meisten Fällen erstellt man keine {{Code|CDataNodeList}} direkt, sondern erhält diese direkt aus einem [[API:CDataNodeStorage|CDataNodeStorage]] oder [[API:CDataNode|CDataNode]]:

{{Code|Var Liste As New CDataNodeList;}}

Parameter hat die "New" Funktion nicht.

Man kann nun entweder einzelne [[API:CDataNode|CDataNodes]] manuell zur Liste hinzufügen

Liste.Add(Node);

wobei "Node" hier vom Typ [[API:CDataNode|CDataNode]] sein muss

oder man erstellt eine Liste aus einem [[API:CDataNode|CDataNode]]

Liste = Node.Items;

oder übernimmt die oberste Ebene eines [[API:CDataNodeStorage|CDataNodeStorage]]

Liste = Storage.Items;

"Storage" ist hier vom Typ [[API:CDataNodeStorage|CDataNodeStorage]].

== Typisches Beispiel ==

Var Storage As New CDataNodeStorage('Mein Datenspeicher', 1);
Storage.Items.Add('BerechtigteUser');
If( not Storage.Items.Item('BerechtigteUser').Items.ContainsKey(CStr(MyShip.UserID)))
{
Storage.Items.Item('BerechtigteUser').Items.Add(CStr(MyShip.UserID));
}
An jeder Stelle wo ''Items'' steht wird eine {{Code|CDataNodeList}} "verwendet". Diese Zeilen öffnen bzw. erstellen eine Datenbank mit dem Namen "Mein Datenspeicher", fügen der obersten Ebene des Speichers (Ebenen siehe [[API:CDataNodeStorage|CDataNodeStorage]]) einen Knoten "BerechtigteUser" hinzu und fügen diesem Knoten (auch wieder über "Items"/{{Code|CDataNodeList}}) einen Unterknoten mit der UserID des Users der das Portal installiert hat hinzu. Vorher wird noch geprüft, ob dieser Knoten evtl. schon vorhanden ist (sollte immer gemacht werden sonst gibt es Laufzeitfehler).

== Methoden ==

Die wichtigsten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Add || Fügt einen [[API:CDataNode|CDataNode]] ein. Es gbt dabei mehrere Möglichkeiten (siehe Objektexplorer)
|-
| AddDate || Nützlich um Objekte vom Typ [[API:Date|Date]] hinzuzufügen. Es gibt noch weitere Add-Methoden im Objektexplorer aufgelistet.
|-
| Clear || Löscht den Listeninhalt ('''VORSICHT:''' Es werden auch alle Unterknoten gelöscht!)
|-
| ContainsKey || Sehr wichtig. Übernimmt einen [[API:String|String]] und gibt einen [[API:Boolean|Boolean]]-Wert zurück ob der Knoten mit diesem Namen in der Liste ist
|-
| Count || Gibt einen [[API:Integer|Integer]]-Wert zurück mit der Anzahl der Knoten in der Liste
|-
| Item || Gibt den entsprechenden [[API:CDataNode|CDataNode]] zurück. Beispiel: '''Storage.Items.Item('Knoten');''' (siehe [[API:CDataNodeStorage|CDataNodeStorage]])
|-
| Parent || Liefert den übergeordneten [[API:CDataNode|CDataNode]] zurück.
|-
| Remove || Löscht einen bestimmten [[API:CDataNode|CDataNode]] in der Liste.
|-
| Rename || Benennt einen [[API:CDataNode|CDataNode]] aus der Liste um.
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeList)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

API:CDataNodeList

2010-08-20T16:48:42Z

SimonSlater: Erster Entwurf zu CDataNodeList

{{Vorlage:ApiMenu}}

== Allgemein ==

{{Code|CDataNodeList}} ist ein Listenobjekt, welches Objekte vom Typ [[API:CDataNode|CDataNode]] aufnimmt. Es ist das "Arbeitstier" der Datenbank-Verwaltung und kommt bei jeder Abfrage oder beim Schreiben in eine Datenbank vor.

In den meisten Fällen erstellt man keine {{Code|CDataNodeList}} direkt, sondern erhält diese direkt aus einem [[API:CDataNodeStorage|CDataNodeStorage]] oder [[API:CDataNode|CDataNode]]:

{{Code|Var Liste As New CDataNodeList;}}

Parameter hat die "New" Funktion nicht.

Man kann nun entweder einzelne [[API:CDataNode|CDataNodes]] manuell zur Liste hinzufügen

Liste.Add(Node);

wobei "Node" hier vom Typ [[API:CDataNode|CDataNode]] sein muss

oder man erstellt eine Liste aus einem [[API:CDataNode|CDataNode]]

Liste = Node.Items;

oder übernimmt die oberste Ebene eines [[API:CDataNodeStorage|CDataNodeStorage]]

Liste = Storage.Items;

"Storage" ist hier vom Typ [[API:CDataNodeStorage|CDataNodeStorage]].

== Methoden ==

Die wichtigsten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Add || Fügt einen [[API:CDataNode|CDataNode]] ein. Es gbt dabei mehrere Möglichkeiten (siehe Objektexplorer)
|-
| AddDate || Nützlich um Objekte vom Typ [[API:Date|Date]] hinzuzufügen. Es gibt noch weitere Add-Methoden im Objektexplorer aufgelistet.
|-
| Clear || Löscht den Listeninhalt ('''VORSICHT:''' Es werden auch alle Unterknoten gelöscht!)
|-
| ContainsKey || Sehr wichtig. Übernimmt einen [[API:String|String]] und gibt einen [[API:Boolean|Boolean]]-Wert zurück ob der Knoten mit diesem Namen in der Liste ist
|-
| Count || Gibt einen [[API:Integer|Integer]]-Wert zurück mit der Anzahl der Knoten in der Liste
|-
| Item || Gibt den entsprechenden [[API:CDataNode|CDataNode]] zurück. Beispiel: '''Storage.Items.Item('Knoten');''' (siehe [[API:CDataNodeStorage|CDataNodeStorage]])
|-
| Parent || Liefert den übergeordneten [[API:CDataNode|CDataNode]] zurück.
|-
| Remove || Löscht einen bestimmten [[API:CDataNode|CDataNode]] in der Liste.
|-
| Rename || Benennt einen [[API:CDataNode|CDataNode]] aus der Liste um.
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeList)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

API:CMyShip

2010-08-20T14:49:02Z

SimonSlater: /* Methoden (Auszug) */

{{Vorlage:ApiMenu}}
== Allgemein ==
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].

Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.

{{Code|Var Schiff As New CMyShip(123456);}}

Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:

{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}

Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.

Beispiel:

{{Code|Schiff.Action.ActivateSRS(True);}}

== Methoden (Auszug) ==

Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Action || [[API:CBaseShipManager|CBaseShipManager]]
|-
| Energy || gibt eine Zahl zurück
|-
| Definition || ist ein Objekt vom Typ [[API:CMyShipDefinition|CMyShipDefinition]]. Damit lassen sich Eigenschaften des aktuellen Schiffstyps auslesen
|-
| Docked || gibt True/False zurück
|-
| FlightRange || gibt die Anzahl der geflogenen Felder (Tick) zurück
|-
| Name || -
|-
| StockRoom || Gibt dir eine Instanz der Klasse [[API:CStockRoom|CStockRoom]] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst
|-
| SRS || Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück
|-
| WarpCore || Wert des Warpkerns
|}
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)

== Beispiel ==

Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel (falls vorhanden) den Warpkern auffüllen zu lassen:

Var Schiff As CMyShip(12345);

If (Schiff.Definition.HasWarpCore = True) {
If (Schiff.WarpCore < 100) {
If (Schiff.Docked = False) {
Schiff.Action.DockTo(54321);
}
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);
Schiff.Action.RefilWarpCore(10);
}
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");
} Else {
WriteLine("Das Schiff " & Schiff.Name & " hat keinen Warpkern.");
}

''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''

API:CMyShip

2010-08-20T14:47:59Z

SimonSlater: /* Methoden (Auszug) */

{{Vorlage:ApiMenu}}
== Allgemein ==
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].

Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.

{{Code|Var Schiff As New CMyShip(123456);}}

Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:

{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}

Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.

Beispiel:

{{Code|Schiff.Action.ActivateSRS(True);}}

== Methoden (Auszug) ==

Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Action || [[CBaseShipManager]]
|-
| Energy || gibt eine Zahl zurück
|-
| Definition || ist ein Objekt vom Typ [[API:CMyShipDefinition|CMyShipDefinition]]. Damit lassen sich Eigenschaften des aktuellen Schiffstyps auslesen
|-
| Docked || gibt True/False zurück
|-
| FlightRange || gibt die Anzahl der geflogenen Felder (Tick) zurück
|-
| Name || -
|-
| StockRoom || Gibt dir eine Instanz der Klasse [[API:CStockRoom|CStockRoom]] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst
|-
| SRS || Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück
|-
| WarpCore || Wert des Warpkerns
|}
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)

== Beispiel ==

Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel (falls vorhanden) den Warpkern auffüllen zu lassen:

Var Schiff As CMyShip(12345);

If (Schiff.Definition.HasWarpCore = True) {
If (Schiff.WarpCore < 100) {
If (Schiff.Docked = False) {
Schiff.Action.DockTo(54321);
}
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);
Schiff.Action.RefilWarpCore(10);
}
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");
} Else {
WriteLine("Das Schiff " & Schiff.Name & " hat keinen Warpkern.");
}

''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''

API:CMyShip

2010-08-20T14:47:48Z

SimonSlater: /* Methoden (Auszug) */

{{Vorlage:ApiMenu}}
== Allgemein ==
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].

Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.

{{Code|Var Schiff As New CMyShip(123456);}}

Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:

{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}

Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.

Beispiel:

{{Code|Schiff.Action.ActivateSRS(True);}}

== Methoden (Auszug) ==

Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Action || [[CBaseShipManager]]
|-
| Energy || gibt eine Zahl zurück
|-
| Definition || ist ein Objekt vom Typ [[API:CMyShipDefinition|CMyShipDefinition]]. Damit lassen sich Eigenschaften des aktuellen Schiffstyps auslesen
|-
| Docked || gibt True/False zurück
|-
| FlightRange || gibt die Anzahl der geflogenen Felder (Tick) zurück
|-
| Name || -
|-
| StockRoom || Gibt dir eine Instanz der Klasse [[API:|CStockRoom|CStockRoom]] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst
|-
| SRS || Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück
|-
| WarpCore || Wert des Warpkerns
|}
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)

== Beispiel ==

Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel (falls vorhanden) den Warpkern auffüllen zu lassen:

Var Schiff As CMyShip(12345);

If (Schiff.Definition.HasWarpCore = True) {
If (Schiff.WarpCore < 100) {
If (Schiff.Docked = False) {
Schiff.Action.DockTo(54321);
}
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);
Schiff.Action.RefilWarpCore(10);
}
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");
} Else {
WriteLine("Das Schiff " & Schiff.Name & " hat keinen Warpkern.");
}

''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''

API:CMyShip

2010-08-20T14:46:49Z

SimonSlater: /* Methoden (Auszug) */

{{Vorlage:ApiMenu}}
== Allgemein ==
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].

Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.

{{Code|Var Schiff As New CMyShip(123456);}}

Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:

{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}

Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.

Beispiel:

{{Code|Schiff.Action.ActivateSRS(True);}}

== Methoden (Auszug) ==

Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Action || [[CBaseShipManager]]
|-
| Energy || gibt eine Zahl zurück
|-
| Definition || ist ein Objekt vom Typ [[API:CMyShipDefinition|CMyShipDefinition]]. Damit lassen sich Eigenschaften des aktuellen Schiffstyps auslesen
|-
| Docked || gibt True/False zurück
|-
| FlightRange || gibt die Anzahl der geflogenen Felder (Tick) zurück
|-
| Name || -
|-
| StockRoom || Gibt dir eine Instanz der Klasse [[API:|SStockRoom|SStockRoom]] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst
|-
| SRS || Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück
|-
| WarpCore || Wert des Warpkerns
|}
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)

== Beispiel ==

Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel (falls vorhanden) den Warpkern auffüllen zu lassen:

Var Schiff As CMyShip(12345);

If (Schiff.Definition.HasWarpCore = True) {
If (Schiff.WarpCore < 100) {
If (Schiff.Docked = False) {
Schiff.Action.DockTo(54321);
}
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);
Schiff.Action.RefilWarpCore(10);
}
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");
} Else {
WriteLine("Das Schiff " & Schiff.Name & " hat keinen Warpkern.");
}

''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''

API:CMyShip

2010-08-20T14:46:30Z

SimonSlater: /* Methoden (Auszug) */

{{Vorlage:ApiMenu}}
== Allgemein ==
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].

Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.

{{Code|Var Schiff As New CMyShip(123456);}}

Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:

{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}

Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.

Beispiel:

{{Code|Schiff.Action.ActivateSRS(True);}}

== Methoden (Auszug) ==

Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Action || [[CBaseShipManager]]
|-
| Energy || gibt eine Zahl zurück
|-
| Definition || ist ein Objekt vom Typ [[API:CMyShipDefinition|CMyShipDefinition]]. Damit lassen sich Eigenschaften des aktuellen Schiffstyps auslesen
|-
| Docked || gibt True/False zurück
|-
| FlightRange || gibt die Anzahl der geflogenen Felder (Tick) zurück
|-
| Name || -
|-
| StockRoom || Gibt dir eine Instanz der Klasse [[API:|SStockRoom]] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst
|-
| SRS || Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück
|-
| WarpCore || Wert des Warpkerns
|}
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)

== Beispiel ==

Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel (falls vorhanden) den Warpkern auffüllen zu lassen:

Var Schiff As CMyShip(12345);

If (Schiff.Definition.HasWarpCore = True) {
If (Schiff.WarpCore < 100) {
If (Schiff.Docked = False) {
Schiff.Action.DockTo(54321);
}
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);
Schiff.Action.RefilWarpCore(10);
}
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");
} Else {
WriteLine("Das Schiff " & Schiff.Name & " hat keinen Warpkern.");
}

''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''

API:CDataNodeStorage

2010-08-20T14:39:11Z

SimonSlater:

{{Vorlage:ApiMenu}}

== Allgemein ==

{{Code|CDataNodeStorage}} ermöglicht es, Daten dauerhaft zu speichern. Diese sind dann auch noch vorhanden, wenn das Script nicht gerade ausgeführt wird. Mögliche Daten sind Texte ([[API:String|Strings]]) und Zahlen (z.B. [[API:Integer|Integer]]).

Zum Einrichten einer Datenbank ist lediglich folgende Zeile nötig:

{{Code|Var Speicher As New CDataNodeStorage('ScriptName_Speicher', 1);}}

Wenn als zweiter Parameter eine 1 gesetzt ist, wird unter Datenbank->Scripting->Daten ein neuer Eintrag mit dem Namen des ersten Parameters (hier: ScriptName_Speicher) erstellt. Dieser lässt sich auch nicht wieder löschen. Überlege dir also vorher, ob du eine Datenbank anlegen willst.

Mit der Variable ''Speicher'' kannst du nun auf die Datenbank zugreifen und Werte reinschreiben.

Beispiel:

{{Code|Speicher.Items.Add('Knoten');}}

Damit wird in der Datenbank ein neuer Knoten mit dem Namen ''Knoten'' angelegt.

''Beachte: Speicher.Items gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück! Darin sind alle Elemente der obersten Ebene der Datenbank enthalten.''

== Struktur ==

Die Struktur der Datenbank ist folgendermaßen aufgebaut:

Knoten
{
KindKnoten1
{
KindKindKnoten='Wert1';
}
KindKnoten2='Wert2';
}

Das Anlegen der oben gezeigten Struktur funktioniert so:

Speicher.Items.Add('Knoten');
Speicher.Item('Knoten').Items.Add('KindKnoten1');
Speicher.Item('Knoten').Items.Add('KindKnoten2');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Add('KindKindKnoten');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Item('KindKindKnoten').Value = 'Wert1';
Speicher.Item('Knoten').Items.Item('KindKnoten2').Value = 'Wert2';

Das mag natürlich auf den ersten Blick noch etwas verwirrend sein, deshalb jetzt Schritt für Schritt:

- In der ersten Zeile wird der obersten Ebene der Datenbank der Knoten 'Knoten' hinzugefügt.

- In der zweiten Zeile wird nun der gerade neu erstellten Ebene 'Knoten' ein Knoten hinzugefügt ('KindKnoten1') und somit eine neue Ebene erstellt.

- In der dritten Zeile passiert wieder das Gleiche, nur dass diesmal ein zweiter Knoten in die gleiche Ebene wie KindKnoten1 eingefügt wird.

- In der vierten Zeile wir eine weitere Ebene eingefügt, diesmal als Unterebene von 'KindKnoten1'.

- In der fünften Zeile wird dem 'KindKindKnoten' der Wert "Wert1" zugewiesen.

- In der letzten Zeile wird schließlich dem Knoten 'KindKnoten2' der Wert "Wert2" zugewiesen.

Jeder Knoten in der Datenbank kann einen Wert haben. Es muss aber keiner eingetragen werden. Um einen Wert auszulesen verfährt man ähnlich wie beim Eintragen eines Wertes:
{{Code|Speicher.Item('Knoten').Items.Item('KindKnoten2').Value;}}

gibt den Wert "Wert2" zurück, welcher im Script wie gewohnt verwendet werden kann.

Für eine detailliertere Beschreibung, was man mit der Datenbank so alles machen kann, schau dir den Eintrag zur [[API:CDataNodeList|CDataNodeList]] an, sowie [[API:CDataNode|CDataNode]]

== Methoden ==

Die wichtigsten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Copy || Kopiert die Datenbank und erstellt eine neue mit dem angegebenem Namen
|-
| Delete || Löscht den '''Inhalt''' der Datenbank
|-
| Items || Gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück ('''wichtigster Parameter''')
|-
| LoadFromUser || Damit kann man eine Datenbank von einem anderen User laden, wenn diese freigegben wurde. ACHTUNG: Fehlermeldung wenn die Datenbank nicht existiert!
|-
| Rename || Ändert den Namen der Datenbank
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeStorage)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

API:CDataNodeStorage

2010-08-20T14:38:38Z

SimonSlater: /* Methoden */

{{Vorlage:ApiMenu}}
{{Code|CDataNodeStorage}} ermöglicht es, Daten dauerhaft zu speichern. Diese sind dann auch noch vorhanden, wenn das Script nicht gerade ausgeführt wird. Mögliche Daten sind Texte ([[API:String|Strings]]) und Zahlen (z.B. [[API:Integer|Integer]]).

Zum Einrichten einer Datenbank ist lediglich folgende Zeile nötig:

{{Code|Var Speicher As New CDataNodeStorage('ScriptName_Speicher', 1);}}

Wenn als zweiter Parameter eine 1 gesetzt ist, wird unter Datenbank->Scripting->Daten ein neuer Eintrag mit dem Namen des ersten Parameters (hier: ScriptName_Speicher) erstellt. Dieser lässt sich auch nicht wieder löschen. Überlege dir also vorher, ob du eine Datenbank anlegen willst.

Mit der Variable ''Speicher'' kannst du nun auf die Datenbank zugreifen und Werte reinschreiben.

Beispiel:

{{Code|Speicher.Items.Add('Knoten');}}

Damit wird in der Datenbank ein neuer Knoten mit dem Namen ''Knoten'' angelegt.

''Beachte: Speicher.Items gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück! Darin sind alle Elemente der obersten Ebene der Datenbank enthalten.''

== Struktur ==

Die Struktur der Datenbank ist folgendermaßen aufgebaut:

Knoten
{
KindKnoten1
{
KindKindKnoten='Wert1';
}
KindKnoten2='Wert2';
}

Das Anlegen der oben gezeigten Struktur funktioniert so:

Speicher.Items.Add('Knoten');
Speicher.Item('Knoten').Items.Add('KindKnoten1');
Speicher.Item('Knoten').Items.Add('KindKnoten2');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Add('KindKindKnoten');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Item('KindKindKnoten').Value = 'Wert1';
Speicher.Item('Knoten').Items.Item('KindKnoten2').Value = 'Wert2';

Das mag natürlich auf den ersten Blick noch etwas verwirrend sein, deshalb jetzt Schritt für Schritt:

- In der ersten Zeile wird der obersten Ebene der Datenbank der Knoten 'Knoten' hinzugefügt.

- In der zweiten Zeile wird nun der gerade neu erstellten Ebene 'Knoten' ein Knoten hinzugefügt ('KindKnoten1') und somit eine neue Ebene erstellt.

- In der dritten Zeile passiert wieder das Gleiche, nur dass diesmal ein zweiter Knoten in die gleiche Ebene wie KindKnoten1 eingefügt wird.

- In der vierten Zeile wir eine weitere Ebene eingefügt, diesmal als Unterebene von 'KindKnoten1'.

- In der fünften Zeile wird dem 'KindKindKnoten' der Wert "Wert1" zugewiesen.

- In der letzten Zeile wird schließlich dem Knoten 'KindKnoten2' der Wert "Wert2" zugewiesen.

Jeder Knoten in der Datenbank kann einen Wert haben. Es muss aber keiner eingetragen werden. Um einen Wert auszulesen verfährt man ähnlich wie beim Eintragen eines Wertes:
{{Code|Speicher.Item('Knoten').Items.Item('KindKnoten2').Value;}}

gibt den Wert "Wert2" zurück, welcher im Script wie gewohnt verwendet werden kann.

Für eine detailliertere Beschreibung, was man mit der Datenbank so alles machen kann, schau dir den Eintrag zur [[API:CDataNodeList|CDataNodeList]] an, sowie [[API:CDataNode|CDataNode]]

== Methoden ==

Die wichtigsten Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Copy || Kopiert die Datenbank und erstellt eine neue mit dem angegebenem Namen
|-
| Delete || Löscht den '''Inhalt''' der Datenbank
|-
| Items || Gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück ('''wichtigster Parameter''')
|-
| LoadFromUser || Damit kann man eine Datenbank von einem anderen User laden, wenn diese freigegben wurde. ACHTUNG: Fehlermeldung wenn die Datenbank nicht existiert!
|-
| Rename || Ändert den Namen der Datenbank
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeStorage)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

API:CDataNodeStorage

2010-08-20T14:34:21Z

SimonSlater:

{{Vorlage:ApiMenu}}
{{Code|CDataNodeStorage}} ermöglicht es, Daten dauerhaft zu speichern. Diese sind dann auch noch vorhanden, wenn das Script nicht gerade ausgeführt wird. Mögliche Daten sind Texte ([[API:String|Strings]]) und Zahlen (z.B. [[API:Integer|Integer]]).

Zum Einrichten einer Datenbank ist lediglich folgende Zeile nötig:

{{Code|Var Speicher As New CDataNodeStorage('ScriptName_Speicher', 1);}}

Wenn als zweiter Parameter eine 1 gesetzt ist, wird unter Datenbank->Scripting->Daten ein neuer Eintrag mit dem Namen des ersten Parameters (hier: ScriptName_Speicher) erstellt. Dieser lässt sich auch nicht wieder löschen. Überlege dir also vorher, ob du eine Datenbank anlegen willst.

Mit der Variable ''Speicher'' kannst du nun auf die Datenbank zugreifen und Werte reinschreiben.

Beispiel:

{{Code|Speicher.Items.Add('Knoten');}}

Damit wird in der Datenbank ein neuer Knoten mit dem Namen ''Knoten'' angelegt.

''Beachte: Speicher.Items gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück! Darin sind alle Elemente der obersten Ebene der Datenbank enthalten.''

== Struktur ==

Die Struktur der Datenbank ist folgendermaßen aufgebaut:

Knoten
{
KindKnoten1
{
KindKindKnoten='Wert1';
}
KindKnoten2='Wert2';
}

Das Anlegen der oben gezeigten Struktur funktioniert so:

Speicher.Items.Add('Knoten');
Speicher.Item('Knoten').Items.Add('KindKnoten1');
Speicher.Item('Knoten').Items.Add('KindKnoten2');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Add('KindKindKnoten');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Item('KindKindKnoten').Value = 'Wert1';
Speicher.Item('Knoten').Items.Item('KindKnoten2').Value = 'Wert2';

Das mag natürlich auf den ersten Blick noch etwas verwirrend sein, deshalb jetzt Schritt für Schritt:

- In der ersten Zeile wird der obersten Ebene der Datenbank der Knoten 'Knoten' hinzugefügt.

- In der zweiten Zeile wird nun der gerade neu erstellten Ebene 'Knoten' ein Knoten hinzugefügt ('KindKnoten1') und somit eine neue Ebene erstellt.

- In der dritten Zeile passiert wieder das Gleiche, nur dass diesmal ein zweiter Knoten in die gleiche Ebene wie KindKnoten1 eingefügt wird.

- In der vierten Zeile wir eine weitere Ebene eingefügt, diesmal als Unterebene von 'KindKnoten1'.

- In der fünften Zeile wird dem 'KindKindKnoten' der Wert "Wert1" zugewiesen.

- In der letzten Zeile wird schließlich dem Knoten 'KindKnoten2' der Wert "Wert2" zugewiesen.

Jeder Knoten in der Datenbank kann einen Wert haben. Es muss aber keiner eingetragen werden. Um einen Wert auszulesen verfährt man ähnlich wie beim Eintragen eines Wertes:
{{Code|Speicher.Item('Knoten').Items.Item('KindKnoten2').Value;}}

gibt den Wert "Wert2" zurück, welcher im Script wie gewohnt verwendet werden kann.

Für eine detailliertere Beschreibung, was man mit der Datenbank so alles machen kann, schau dir den Eintrag zur [[API:CDataNodeList|CDataNodeList]] an, sowie [[API:CDataNode|CDataNode]]

== Methoden ==

Die Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Copy || Kopiert die Datenbank und erstellt eine neue mit dem angegebenem Namen
|-
| Delete || Löscht den '''Inhalt''' der Datenbank
|-
| Items || Gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück ('''wichtigster Parameter''')
|-
| LoadFromUser || Damit kann man eine Datenbank von einem anderen User laden, wenn diese freigegben wurde. ACHTUNG: Fehlermeldung wenn die Datenbank nicht existiert!
|-
| Rename || Ändert den Namen der Datenbank
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeStorage)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

API:CDataNodeStorage

2010-08-20T14:28:30Z

SimonSlater: Erster Entwurf zu CDataNodeStorage

{{Vorlage:ApiMenu}}
{{Code|CDataNodeStorage}} ermöglicht es, Daten dauerhaft zu speichern. Diese sind dann auch noch vorhanden, wenn das Script nicht gerade ausgeführt wird. Mögliche Daten sind Texte ([[API:String|Strings]]) und Zahlen (z.B. [[API:Integer|Integer]]).

Zum Einrichten einer Datenbank ist lediglich folgende Zeile nötig:

{{Code|Var Speicher As New CDataNodeStorage('ScriptName_Speicher', 1);}}

Wenn als zweiter Parameter eine 1 gesetzt ist, wird unter Datenbank->Scripting->Daten ein neuer Eintrag mit dem Namen des ersten Parameters (hier: ScriptName_Speicher) erstellt. Dieser lässt sich auch nicht wieder löschen. Überlege dir also vorher, ob du eine Datenbank anlegen willst.

Mit der Variable ''Speicher'' kannst du nun auf die Datenbank zugreifen und Werte reinschreiben.

Beispiel:

{{Code|Speicher.Items.Add('Knoten');}}
Damit wird in der Datenbank ein neuer Knoten mit dem Namen ''Knoten'' angelegt.

''Beachte: Speicher.Items gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück! Darin sind alle Elemente der obersten Ebene der Datenbank enthalten.''

== Struktur ==

Die Struktur der Datenbank ist folgendermaßen aufgebaut:

Knoten
{
KindKnoten1
{
KindKindKnoten='Wert1';
}
KindKnoten2='Wert2';
}

Das Anlegen der oben gezeigten Struktur funktioniert so:

Speicher.Items.Add('Knoten');
Speicher.Item('Knoten').Items.Add('KindKnoten1');
Speicher.Item('Knoten').Items.Add('KindKnoten2');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Add('KindKindKnoten');
Speicher.Item('Knoten').Items.Item('KindKnoten1').Items.Item('KindKindKnoten').Value = 'Wert1';
Speicher.Item('Knoten').Items.Item('KindKnoten2').Value = 'Wert2';

Das mag natürlich auf den ersten Blick noch etwas verwirrend sein, deshalb jetzt Schritt für Schritt:

- In der ersten Zeile wird der obersten Ebene der Datenbank der Knoten 'Knoten' hinzugefügt.

- In der zweiten Zeile wird nun der gerade neu erstellten Ebene 'Knoten' ein Knoten hinzugefügt ('KindKnoten1') und somit eine neue Ebene erstellt.

- In der dritten Zeile passiert wieder das Gleiche, nur dass diesmal ein zweiter Knoten in die gleiche Ebene wie KindKnoten1 eingefügt wird.

- In der vierten Zeile wir eine weitere Ebene eingefügt, diesmal als Unterebene von 'KindKnoten1'.

- In der fünften Zeile wird dem 'KindKindKnoten' der Wert "Wert1" zugewiesen.

- In der letzten Zeile wird schließlich dem Knoten 'KindKnoten2' der Wert "Wert2" zugewiesen.

Jeder Knoten in der Datenbank kann einen Wert haben. Es muss aber keiner eingetragen werden. Um einen Wert auszulesen verfährt man ähnlich wie beim Eintragen eines Wertes:
{{Code|Speicher.Item('Knoten').Items.Item('KindKnoten2').Value;}} gibt den Wert "Wert2" zurück, welcher im Script wie gewohnt verwendet werden kann.

Für eine detailliertere Beschreibung, was man mit der Datenbank so alles machen kann, schau dir den Eintrag zur [[API:CDataNodeList|CDataNodeList]] an, sowie [[API:CDataNode|CDataNode]]

== Methoden ==

Die Eigenschaften oder Methoden sind die folgenden:
{| cellpadding="4"
! Methode !! Erklärung
|-
| Copy || Kopiert die Datenbank und erstellt eine neue mit dem angegebenem Namen
|-
| Delete || Löscht den '''Inhalt''' der Datenbank
|-
| Items || Gibt ein Objekt des Typs [[API:CDataNodeList|CDataNodeList]] zurück ('''wichtigster Parameter''')
|-
| LoadFromUser || Damit kann man eine Datenbank von einem anderen User laden, wenn diese freigegben wurde. ACHTUNG: Fehlermeldung wenn die Datenbank nicht existiert!
|-
| Rename || Ändert den Namen der Datenbank
|}
Die vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CDataNodeStorage)

--[[Spieler:SimonSlater|SimonSlater]] 16:28, 20. Aug. 2010 (CEST)

Scripting:Funktionen

2008-10-01T08:18:52Z

SimonSlater: Erstellung

== Funktionen ==

Ich möchte hier, speziell für Anfänger, einige Basisfunktionen zeigen. Diese dürfen natürlich gerne auch für eigene Scripte verwendet werden.
Manche Dinge braucht man fast immer, daher wäre es doch Zeitverschwendung, alles jedes Mal neu zu schreiben. Ich hoffe, dass aus diesem Artikel eine kleine Sammlung von Basisfunktionen wird.

<pre>Function GetDistance(id1 As Integer, id2 As Integer) As Integer
{
Var iDistance As Integer = 0;
Var iDistanceX As Integer = 0;
Var iDistanceY As Integer = 0;
Var iX1 As Integer = 0;
Var iX2 As Integer = 0;
Var iY1 As Integer = 0;
Var iY2 As Integer = 0;

Var Ship1 As New CMyShip (id1);
Var Ship2 As New CMyShip (id2);

iX1 = Ship1.MapPosition.X;
iY1 = Ship1.MapPosition.Y;
iX2 = Ship2.MapPosition.X;
iY2 = Ship2.MapPosition.Y;

iDistanceX = Math.Abs(iX1 - iX2);
iDistanceY = Math.Abs(iY1 - iY2);

iDistance = iDistanceX + iDistanceX
Return iDistance;
}</pre>
Diese Funktion berechnet die Distanz zwischen zwei Schiffen. Aufgerufen wird sie mit '''GetDistance(123456,654321)''', wobei zwei Schiffs-IDs eingegeben werden müssen. Die Funktion liefert dann den absoluten Abstandswert als Ganzzahl.
Mit '''abstand = GetDistance....''' erhält die Variable "abstand" den Wert der Entfernung, z.B. "14".

<pre>Function GetPosition(id As Integer) As String
{
Var sPos As String = '';
Var iX As Integer = 0;
Var iY As Integer = 0;
Var bOrbit As Boolean = 0;

Var Ship As New CMyShip (id);

iX = Ship.MapPosition.X;
iY = Ship.MapPosition.Y;

If(Ship.MapPosition.InOrbit) {sPos = '@';}
sPos = sPos & CStr(iX) & '|' & CStr(iY);

Return sPos;
}</pre>
Diese Funktion gibt die Position eines Schiffes als '''String''' aus. Aufgerufen wird sie mit '''GetPosition(123456)''', wobei eine Schiffs-ID eingegeben werden muss. Die Funktion liefert dann einen String mit den Koordinaten, also z.B. '''187|433'''. Ist das Schiff im Orbit, wird ein '''@''' vor den String gesetzt. Mit dieser Funktion kann dan z.B. '''myShip.Aktion.FliegeZu(GetPosition(123456))''' ausgeführt werden.

----

Weitere Funktionen folgen.