Weihnachten vorbei, Renovierung vorbei: Zeit zum Nachholen der offenen Dinge und Ideen. Und hier geht es um das Presence-Flag in KMP/GOBJ.

Als @Tock vor einer Woche "GCN Sherbet Land v4" in 2 Versionen rausbrachte, hatte ich da so eine Idee, die ich hier gerne diskutieren würde. Für KMP-Objekte gibt es das Presence-Flag, bei denen 6 von 16 Bits definiert sind, aber nicht alle genutzt werden. Wie wäre es nun, weitere 4 Bits zu definieren, die nur LE-CODE auswertet:
* Bit 8 gesetzt: Objekt aktivieren, falls Offline
* Bit 9 gesetzt: Objekt aktivieren, falls Online
* Bit 10 gesetzt: Objekt deaktivieren, falls Offline
* Bit 11 gesetzt: Objekt deaktivieren, falls Online
Falls eines dieser Bits aktiviert ist, dann werden die andere Bits 0-5 ignoriert.




Christmas over, renovation over: time to catch up on the open things and ideas. And this is about the presence flag in KMP/GOBJ.

When @Tock released "GCN Sherbet Land v4" in two versions a week ago, I had an idea that I would like to discuss here. For KMP objects there exxists the presence flag, in which 6 of 16 bits are defined, but not all are used. How about defining 4 more bits that only LE-CODE evaluates:
* Bit 8 set: activate object, if offline
* Bit 9 set: activate object, if online
* Bit 10 set: deactivate object if offline
* Bit 11 set: deactivate object if online
If one of these bits is set, than bits 0-5 will be ignored.

Ich hatte extra wenige Bits verwendet, um ein paar für "Trigger" freizuhalten. Und die gehen so (auch nur ne Idee, die mit @Leseratte noch auf Machbarkeit überprüft werden muss:

Beispiel mit 4 Bits (A+0 bis A+3): Die 4 Bits geben einen Ereignis-Index zwischen 1 und 15. (0 ist reserviert für keinEreignis). In der LEX-Datei steht drin, was das Ereignis auslöst. Und das ist dann ein beliebige Kombination aus:
* Trigger X [nach A Frames] [für B Frames] setzten.
* Trigger X zurücksetzen.
* Zähler X erhöhen.
* Zähler X erniedrigen.
* Zähler X zurücksetzen.
* Objekt aktiv, falls Trigger X gesetzt.
* Objekt aktiv, falls von N Triggern (X1,X2,...) ≥M gesetzt.
* ...

Das bedeutet, man sollte die Bits nicht zu sehr verschwenden. Evtl geht auch: Falls Bit 6 gesetzt: Nutze Bits 7-15 (=512 Varianten) als Index in eine Lookup-Tabelle, die alles weitere definiert. Ist Bit 6 nicht gesetzt, dann verwende Bits 7-15 als Spezialeigenschaft. Damit wäre man dann offen für zukünftige Erweiterungen.

Ich mache mal einen anderen Vorschlag, bei dem ich Tocks Ideen aufgenommen habe, sofern ich sie richtig verstanden habe. Mit ist z.B. "More than 6 players off" nicht wirklich klar. Und auch bei einigen Kombinationen weiß ich nicht, was Tock will.



Grundaufteilung:
* Bits 0-5 (0x003f): Klassische Werte
* Bits 6-7 (0x00c0): MODUS 0 bis 3
* Bits 8-15 (0xff00): PARAMETER, abhängig vom MODUS
Die neuen Flags werden unter LE-CODE aktiv, falls MODUS>0 oder PARAMETER>0

MODI:
* 0: PARAMETER=0: Klassisch / PARAMETER>0: Index für LEX
* 1: SPIELMODUS, siehe unten
* 2: reserviert
* 3: reserviert

MODUS=1, SPIELMODI für Rennen → PARAMETER:
* Bit 0: Offline, Versus, 1 Spieler
* Bit 1: Offline, Versus, 2 Spieler
* Bit 2: Offline, Versus, 3 oder 4 Spieler
* Bit 3: Offline, Zeitrennen
* Bit 4: 2-6 Spieler Online, Versus, 1 Spieler an Konsole
* Bit 5: 2-6 Spieler Online, Versus, 2 Spieler an Konsole (?)
* Bit 6: 7-12 Spieler Online, Versus, 1 Spieler an Konsole
* Bit 7: 7-12 Spieler Online, Versus, 2 Spieler an Konsole (?)
Ist das das Bit für einen SPIELMODUS gesetzt, dann und nur dann ist das Objekt aktiv.

MODUS=1, SPIELMODI für Battle → PARAMETER:
* Bit 0: Offline, Ballon, 1 Spieler
* Bit 1: Offline, Ballon, 2-4 Spieler
* Bit 2: Offline, Münzjäger, 1 Spieler
* Bit 3: Offline, Münzjäger, 2-4 Spieler
* Bit 4: 2-6 Spieler Online, Ballon
* Bit 5: 2-6 Spieler Online, Münzjäger
* Bit 6: 7-12 Spieler Online, Ballon
* Bit 7: 7-12 Spieler Online, Münzjäger
Ist das das Bit für einen SPIELMODUS gesetzt, dann und nur dann ist das Objekt aktiv.

[/b]Zur weiteren Erklärung von MODUS=1:[/b]
* Unterscheidung zwischen Battle (hier zwischen Ballon+Münz), Race und Zeitrennen.
* Unterscheidung zwischen Offline und Online.
* Online: Unterscheidung zwischen 2-6 und 7-12 Mitspielern.
* Bei (?) bin ich mir unsicher, ob man diese überhaupt unterstützen sollte. Stattdessen könnte man z.B. die Einteilung 1-5, 6-8, 9-10, 11-12 Mitspieler verwenden.



Wie geschrieben, ist ein Vorschlag, der auch noch auf mögliche Umsetzung geprüft werden muss. Er lässt aber Platz für zukünftige Erweiterungen.



Mögliche technische Umsetzung
Nach dem Laden der Strecke werden die GOBJ durch iteriert und die Presence-Flags je nach Bedingung auf 0 oder 0x3f gesetzt.

Ich habe gerade mal 8124 Strecken aus meinem Archiv auf das Presence Flag überprüft und dabei die folgenden Häufigkeiten gezählt:

Nur eine Strecke verwendet unübliche Flags, und das auch nur für 1 Objekt (group_monte_a):
* Snowy Circuit II v2.6 (Putinas,Wiimm) [r23,maczkopeti].szs
Das Flag sollte wohl auf 0x09 stehen.

Damit steht der Erweiterung um die 10 anderen Bits nichts entgegen.

Ich habe obiges mal als Tabellen im CT-Wiki zusammengefasst: wiki.tockdom.com/wiki/Talk:Pre…DE_Extension:_First_ideas

@Tock: Wie schon geschrieben, habe ich bei einigen Punkten von Dir Verständnisprobleme. Habe ich dennoch all deine Wünsche untergrbracht?

Der "or"-Teil in Klammern ist eine alternative Auswahlmöglichkeit. Steht auch so unter der Tabelle. Für eine müssen wir uns letztendlich entscheiden.

Das mit dem 2-Spieler-Split-Screen-Online muss ich nochmals überdenken. Ist evtl wichtiger als die 4 Kategorien für die Spieleranzahl.

Apropos "Spieleranzahl": Habe ich dich hier richtig interpretiert, dass Objekte in Abhängigkeit der Anzahl der Mitspieler aktiviert werden sollen?

EDIT:
Besser? wiki.tockdom.com/wiki/Talk:Pre…ag#Mode_1_.28Variant_B.29

Wir können auch gleich im TS ein wenig diskutieren .... und nebenher spielen

Du meinst also: Deaktiviert, falls mindestens einer der Eigenschaften zutrifft:
* Ballon
* Coin
* 1 human player at Wii (offline or online)
* 2 human players (offline or online)
* Offline, 3+4 human players
* Online, 2-6 players
* Online, 7-9 players
* Online, 10-12 players
Man könnte es auch positiv ausdrücken (im Sinne der Presence flags). Dann mussten man aber mit UND und ODER und Gruppen rumhantieren.

Dann sollte man auch die Bedingungen für Rennstrecken anpassen, um nicht 2 Systeme zu haben → Deaktiviert, falls mindestens einer der Eigenschaften zutrifft:
* Offline, 1 human player
* Offline, 2 human players
* Offline, 3+4 human players
* Offline, time trial
* Online, 1 player at Wii
* Online, 2 players at Wii
* Online, 2-8 players in match
* Online, 9-12 players in match



Eine ganz andere Idee:
Leider nimmt man sich bei der Deaktivierung die Möglichkeit, gewissen Kombinationen anders zu behandeln. Möchte man z.B. ein Objekt bei "2 humans" und "10-12 players" austauschen, dann muss man 4 Fälle (Objekte) eintragen:
* 1 human player + Online, 2-6 players + Online, 7-9 players
* 1 human player + Online, 10-12 players
* 2 human players + Online, 2-6 players + Online, 7-9 players
* 2 human players + Online, 10-12 players
Bei meinem Erstvorschlag mit Kombinationen sind es nur 2 Objekte.

EDIT: Falscher Gedanke! Das Folgende funktioniert nur, wann man die 16-Bit von "Padding" verwendet.
Die andere Idee ist nun, dass man nur Bit 6 als erste Entscheidung für diesen Modus nimmt. Falls gesetzt, dann hat man 9 anstatt 8 Bits zur Verfügung und somit 16 Bedingungen für Rennen und 16 für Battle:

Rennen:
* Offline, Versus, 1 human player.
* Offline, Versus, 2 human players.
* Offline, Versus, 3 human players.
* Offline, Versus, 4 human players.
* Offline, Time trial
* Online, Versus, 2–4 players, 1 player at Wii.
* Online, Versus, 5–6 players, 1 player at Wii.
* Online, Versus, 7–8 players, 1 player at Wii.
* Online, Versus, 9–10 players, 1 player at Wii.
* Online, Versus, 11–12 players, 1 player at Wii.
* Online, Versus, 2–4 players, 2 players at Wii.
* Online, Versus, 5–6 players, 2 players at Wii.
* Online, Versus, 7–8 players, 2 players at Wii.
* Online, Versus, 9–10 players, 2 players at Wii.
* Online, Versus, 11–12 players, 2 players at Wii.
* (unused)

Battle:
* Offline, Ballon Battle, 1 player.
* Offline, Ballon Battle, 2 players.
* Offline, Ballon Battle, 3+4 players.
* Online, Ballon Battle, 2–8 players, 1 player at Wii.
* Online, Ballon Battle, 9–12 players, 1 player at Wii.
* Online, Ballon Battle, 1–6 players, 2 players at Wii.
* Online, Ballon Battle, 7–9 players, 2 players at Wii.
* Online, Ballon Battle, 10–12 players, 2 players at Wii.
* Offline, Coin Runners, 1 player.
* Offline, Coin Runners, 2 players.
* Offline, Coin Runners, 3+4 players.
* Online, Coin Runners, 2–8 players, 1 player at Wii.
* Online, Coin Runners, 9–12 players, 1 player at Wii.
* Online, Coin Runners, 1–6 players, 2 players at Wii.
* Online, Coin Runners, 7–9 players, 2 players at Wii.
* Online, Coin Runners, 10–12 players, 2 players at Wii.

Damit sollten doch alle Kombinationen erschlagen sein.

Zum Deaktivieren könnte zusätzlich die Objekt-ID auf 0 setzten.
Das wäre natürlich eine elegante Möglichkeit zum Erweitern der Möglichkeiten. Dann hätten wir 26 anstatt 10 Bits zur freien Verfügung. Ich werde gleich mal untersuchen, ob überhaupt diese 16 Bits genutzt wurden und welche Auswirkungen es auf MKWii hat.

Ich hatte auch schon an die Verwendung der oberen 6 Bits der Objekt-ID zu verwenden, Solche Objekte wären dann nur unter LE-CODE verfügbar (ohne LE-CODE wäre es eine ungültige Objekt-ID). Hier müsste man prüfen, welche Auswirkungen solche ungültigen Objekt-IDs haben.

Die Idee mit dem Padding finde ich allerdings besser.

Im großen und ganzen steht das Padding immer auf 0. Ausnahmen:
* Wario's Lair (Thondam) in allen Original-Versionen inkl Vorgänger mit anderen Namen
* Shifting Sand Land (kHacker) in den RC* Versionen.
Die Nutzung sollte daher möglich sein. Wario's Lair werden ich anpassen. Wario's Lair mus nichrt angepasst werden, da hier im Presence Flags alle Zusatzbits auf 0 stehen.

Hier die komplette Liste:

Mit dem Padding könnte man das ganze viel systematischer angehen:

Falls im Presence-Flag ein bestimmter Modus gesetzt, dann wird das Padding in 2 Schritten ausgewertet:
1.Schritt: Zustand klären:
* Offline (Wert 0)/Online (Wert
* Versus (0)/Timetrial (4) bzw. Ballon (0)/Coin (4)
* 2 Bit Spieleranzahl: Offline=1-4 Spieler (Werte 0-3), Online=1-2 Spieler an Wii (Werte 0|1) + 2-8 oder 9-12 Spieler total (Werte 0|2).
Dann addiert man die in Klammern angegebenen Werte und erhält eine Summe aus dem Bereich 0-15.
2.Schritt: Ist genau dieses Bit im Padding gesetzt, dann wird das Objekt aktiviert, sonst deaktiviert.

Die restlichen Bits der PFlags könnte man dann für weitere Modifikatoren verwenden/reservieren.

Ich habe in meinen Tools eine versteckte Option eingebaut, die alle GOBJ.padding auf einen Zufallswert setzt. Damit habe ich dann alle Strecken des aktuellen Intermezzos bearbeitet und bin ca 10 Offline Versus gefahren. Ich konnte keine Unterschiede feststellen.

Ich habe noch ein wenig rumgespielt:

1. Alle möglichen ungültigen Objekt-IDs deaktivieren das Objekt. Hiermit kann man z.B. mit Bit 12 (Wert 0x1000) ein Objekt komplett deaktivieren, und LE-CODE könnte ihn unter Bedinungen mit richtiger Id aktivieren.
   
2. Altes Wissen: Die Wii interessiert sich nicht für Bits 6-15 der Presence-Flags. Diese können für Erweiterungen verwendet werden.
   
3. Für jedes Objekt gibt es am Offset 0x02 ein 16-Bit Padding. Dieses könnte man als Erweiterung der Presence-Flags verwenden. Somit stehen dann 26 Bits zur freien Verfügung.
   

Das alles habe ich heute ausgiebig offline getestet. Morgen, am Sonntag, ab 15:00 Uhr CET, wollen @Leseratte und ich ein neues Intermezzo für einen Online-Test spielen. Evtl. findet sich ja noch der eine oder andere. Das Intermezzo wird es dann ein paar Stunden vorher geben.

Intermezzo für den heutigen Test in ca 100 Minuten um 15:00 CET:
* Wiimms Mario Kart Fun — Intermezzo

Nach diversen Tests in dieser Woche habe ich vorerst die Definitions-Phase abgeschlossen.
* wiki.tockdom.com/wiki/Presence_flag/Extension
* wiki.tockdom.com/wiki/LEX_(Fil…EST:_Define_test_settings
Ergänzungen und Aufdeckung von logischen Fehlern sind aber immer willkommen.

Wer den Software-Teil studiert, der wird u.a. feststellen,
… dass Test-Szenarios für alle Mehrspieler-Modi auch alleine durchgeführt werden können.
… dass bis auf den alten SZS-Modifier und meinen Tools alle andren Tools unbekannte Werte einfach überschreiben (schlechter Stil).
… dass ich diverse Dinge zur Unterstützung plane.

Wer aufmerksam mitgelesen hat (es war Vorschlag 1), der weiß, dass ich genau ans solche Dinge gedacht habe. Dafür habe ich MODE=2 und MODE=3 reserviert. Ich habe auch schon Ideen von Triggern, Zählern und logischen Ausdrücken. Dieses wäre aber der nächste Schritt. Und dazu muss die Machbarkeit ergründet werden, Objekte zu aktivieren und zu deaktivieren. Hier haben Leseratte und ich auch schon kurz drüber gesprochen. Positionierung ist bestimmt eine Möglichkeit. Ein weiteres Problem könnte die Synchronisierung zwischen den Wiis sein.

Oder in kurzen Worten:
Bereits dran Gedacht, Definition im Kopf und Platz im neuen Konzept, Machbarkeit unklar, Angehen in ferner Zukunft.

Ich habe in den letzten 2 Tagen diese Erweiterung meinen Tools beigebracht. Herausgekommen ist auch ein Analyse-Kommando, welches mir alle unterschiedlichen Szenarios über aktivierte Objekte liefert, also alle Varianten, die zu testen sind. Hier ist das Ergebnis für alle 32 Orig-Strecken in 2 Formaten:
* download.wiimm.de/misc/2020-01/track-modes.txt (einfache Liste)
* download.wiimm.de/misc/2020-01/track-modes-long.txt (Mit Status für jedes Objekt)

Ganz unter befindet sich eine Liste meiner KMP-Testdatei. Diese sieht so aus:
std1 und std2 besagen, wie es der Standard-Code für 1 und 2 Spieler sieht. Da std3 und std4 nicht genannt werden, sind diese bereits abgedeckt. Darüber hinaus gibt es noch andere Kombinationen für Versus mit 1 oder 2 Spielern und Zeitrennen. "V1,2" bedeutet "1 Spieler an der Wii, 2 Online" Es gibt übrigens hier keinen Unterschied zwischen Versus/Battle — die würden sonst einen eigenen Eintrag erhalten.

Zum Status:
0: Objekt deaktiviert.
1: Objekt dir PFlags deaktiviert, daher teilweise sichtbar.
2: Objekt aktiviert.


EDIT:
Statuszeile geändert, Online-Status für mein Beispiel ergänzt.