Knicklenker.Lua Info zur Benutzung :


====== Was macht das Script ======
Die "Knicklenker.Lua" berechnet euch eine Umsetzung der Lenkdrehung vom Reifenmittelpunkt auf den
Knickpunkt(steeringPivot) des Knicklenkers.


====== Aufbau des i3D Files! ======

Wichtig beim Aufbau der i3D ist, das es eine TransformGroup fr jeden Reifen gibt, in der der Reifen ist.
In diese Gruppen mssen nachher auch die Teile, die sich beim Lenken bewegen sollen.

Bsp.: GIANTS Editor scenegraph:

-FAHRZEUGX			Indexwert
   -Rad_NR1_Gruppe		0
	-Rad_NR1		0|0
   -Rad_NR2_Gruppe		1
	-Rad_NR2		0|1
   -Rad_NR3_Gruppe		2
	-Rad_NR3		0|2
   -Rad_NR4_Gruppe		3
	-Rad_NR4		0|3


Die Indexwerte dieser Gruppen mssen in der XML bei "repr=XXX" eingetragen werden (insgesamt 4 mal).
Die Indexwerte der Reifen bei "driveNode=XXX"  (siehe Bsp. weiter unten!).


====== Anpassungen Des Knickpunkts i3D File! ======

----kurz---
In der i3D Datei muss es eine Gruppe/Objekt vorhanden sein, die den Knickpunkt vorgibt (X und Z Wert).
Zustzlich wird der Y-Wert fr Berechnungen benutzt und muss auf den Radius der Reifen angepasst werden!

---ausfhrlich---
-Die i3D des eigenen Fahrzeugs im GIANTS  Editor ffnen.
-Man erstelle ber das Men "Create" > "TransformGroup" eine Gruppe.
-Da neu erstellte Gruppen am Ende der Datei und landen, die neu erstellte Gruppe (Standardname ist "transform")
anwhlen, Men "Edit" > "cut"
-Im Scnenegraph (Baum links) die oberste Datei (Hauptgruppe deines Fahrzeugs) anwhlen
-Im Men "Edit" > "Paste"
-die gerade eingefgte Gruppe anwhlen
-auf der rechten Seite bei "Translate Y" den Radius der eigenen Reifen eintragen
-"Translate X" und "Translate Z" so anspassen, dass die Gruppe am Knickpunkt liegt


====== Anpassungen im XML script! ======

Damit das Script funktionieren kann, muss in die eigene XML Datei die Zeile:

    <steeringPivot index="XXX" />

eingefgt werden. "XXX" muss wie blich durch den ausgezhlten Index in der i3D ersetzt werden!


In der eigenen XML mssen alle 4 Reifen auf Lenkbar stehen.
"rotSpeed" sollte bei Forderreifen POSITIVE und bei Hinterreifen NEGATIVE werte haben.

Bsp.: Forderreifen:
<wheel rotSpeed="38" rotMax="13" rotMin="-13" driveMode="1" repr="0" driveNode="0|0" ...

Bsp.: Hinterreifen:
<wheel rotSpeed="-38" rotMax="13" rotMin="-13" driveMode="1" repr="2" driveNode="2|0" ...




Frhliches modden
Ruprecht

PS:  Wer an einer Stelle absolut nicht weiterkommt oder Fragen / Verbesserungvorschlge hat,
     kann mir eine mail schreiben an xes_mail@web.de .


==============================================================================================================================
Knicklenker.Lua usage tips :


====== what the script does ======
The "Knicklenker.Lua" calculates the steering rotation around a self defined steeringPivot.


====== i3D file Scenegraph tree setup======

It is essential each tire has a parent TransformGroup wherein the wheel is located.
Place all parts that shall be rotated while steering in these wheel groups.

example: GIANTS editor scenegraph:

-VehicleX			Indexvalue
   -wheel_1_group		0
	-wheel_1		0|0
   -wheel_2_group		1
	-wheel_2		0|1
   -wheel_3_group		2
	-wheel_3		0|2
   -wheel_4_group		3
	-wheel_4		0|3


The Indexvalues of these GROUPS must be written to your XML files "repr=XXX" (4 times in total).
The Indexvalues of the TIRES must be written to your XML files "driveNode=XXX" (see example further down!).


====== Adjusting the steeringPivot in the i3D file! ======

----brief---
You need a Group/Object in your i3D file that defines the steering pivot (x and z coordinates).
The Y coordinate is also used for calculations and therfore has to be set to the wheels radius.

---detailed---
-open the i3D file of your vehicle in GIANTS editor.
-create a transform group using the menu ("Create" > "TransformGroup").
-as newly created groups are put to the end of the file scroll down to the bottom, select the transform group (standard name is "transform") and cut it (menu: "Edit" > "cut")
-in Scenegraph (left side) select the object at the very top (main group of your vehicle)
-paste the group ( menu "Edit" > "Paste")
-select pasted group
-on the right side find "Translate Y" and enter the radius of your wheels.
-set "Translate X" and "Translate Z" as needed to get desired steering pivot point


====== XML script changes! ======

For the script to work enter the following line to your XML file

    <steeringPivot index="XXX" />

As usual replace "XXX" with the counted index value!


To get desired funcionality make all 4 wheels steerable in the XMl of your vehicle.
"rotSpeed" should be set to a POSITIVE value for frontwheels and a negative value for backwheels

example: frontwheels:
<wheel rotSpeed="38" rotMax="13" rotMin="-13" driveMode="1" repr="0" driveNode="0|0" ...

example: backwheels:
<wheel rotSpeed="-38" rotMax="13" rotMin="-13" driveMode="1" repr="2" driveNode="2|0" ...


Happy modding
Ruprecht

PS:  If someone is absolutely stuck at a certain point or if there are problems / improvement suggestions
     send a mail to xes_mail@web.de .
