B3D-Exporter Version 1.4

1.Installation

1.1. Hinweise

Ich stelle das Plugin trotz eines hohen Produktionsaufwandes kostenlos als Freeware zur Verfügung. Es ist daher nur fair, wenn Du mir dafür einen Eintrag in den Credits Ihres Spiels spendierst :-) .
Die Nutzung geschieht auf eigene Gefahr, ich übernehme keine Haftung für Schäden jeglicher Art, die durch diese Software entstanden sind.

Viel Spaß wünscht:
Robert Hierl (BIG BUG)

Homepage: www.mein-murks.de
Kontakt: rhierl@gmx.de

1.2. Installation

Extrahiere einfach die Zip-Datei in Deinen Cinema4D/Plugin-Ordner.
Nach dem Neustart von Cinema4D kann dort dann der Exporter mit dem Menübefehl „Plug-Ins->Blitz3D->Export B3D-File" aufgerufen werden.

Für dieses Plugin wird mindestens Cinema4D Release 6 vorausgesetzt.

2.Anwendung

Um eine Szene als Blitzbasic B3D-Datei zu exportieren, muss hier einfach der Menübefehl „Plug-Ins->Blitz3D->Export B3D-File" aufgerufen werden.

2.1. Dialog

Darauf hin erscheint folgendes Bild:

Folgende Einstellungen können hier vorgenommen werden:

a.	Festlegen der „Animationsebene“. Bei „root node“ erhält das Objekt direkt an der Wurzel die Animationsinformation. Es kann in Blitz3D dann direkt mit „Animate“ angesprochen werden. Die zweite Option „second level“ schreibt die Animationsinformation auf die zweite Ebene. Um eine Animation dann in Blitz3D ablaufen zu lassen, muss also erst das enstprechende Unterobjekt mit „FindChild“ oder „GetChild“ ermittelt und dieses dann mit „Animate“ animiert werden.
b.	Festlegen, welche Animationsdaten geschrieben werden sollen. Rotationsdaten werden immer geschrieben, Positionsdaten normalerweise schon, Skalierungsdaten normalerweise nicht. Bei Boneobjekten werden aus technischen Gründen immer alle Daten geschrieben.
c.	Automatisches Setzen von Keys. Ist diese Option deaktiviert, werden nur die Animationskeys geschrieben, welche in C4D explizit gesetzt wurden. Interpolation für flüssige Übergänge, sowie Wiederholungssequenzen werden dabei ignoriert. Bei der Option „simple“ werden automatisch zusätzliche Keys erzeugt. Interpolation und Wiederholungssequenzen werden somit berücksichtigt. Die Option „full“ erzeugt auch automatisch Keys wie „simple“, hierbei werden aber zusätzlich noch Expressions ausgewertet. Objekte, die nur über XPresso- oder Ausrichtungstag animiert sind, werden also mit berücksichtigt.
d.	Hier wird das minimale Intervall für automatisch gesetzte Keys festgelegt. Das Plugin optimiert die Animationskeys im Nachhinein aber noch, so dass keine unnötigen Keys entstehen. Im Normalfall kann diese Option also auf „1“ gesetzt werden, ohne mit erheblich größeren Dateien rechnen zu müssen.
e.	Automatisches Konvertieren in Grundobjekte. Ist diese Option deaktiviert, so werden nur PolygonObjekte, also „in Grundobjekt konvertierte“ mit ihrer Struktur exportiert. Alles andere wird als Pivot gespeichert. Bei aktivierter Option versucht C4D alle Objekte zuerst automatisch in Grundobjekte zu konvertieren und exportiert dann z.B. auch Würfelobjekte mit Struktur. Sollte nur zum Testen verwendet werden, da es beim automatischen Konvertieren zu Fehlern in den UV-Koordinaten kommen kann.
f.	Automatisches Auftrennen der Polygone. Es treten hier dann keine Texturprobleme mehr auf, allerdings werden auch mehr Vertices erzeugt.
g.	Beleuchtung für Texturemixmode „normal“ berücksichtigen. Beim Texturmischmodus „normal“ wird die Beleuchtung in Blitz3D ignoriert, das Objekt verhält sich also wie mit der Option „leuchten“. Ist diese Option aktiviert, so wird der Modus „normal“ automatisch in „multiplizieren“ umgeändert und die Objektfarbe auf weiss gesetzt. Somit erfolgt wieder eine Beleuchtung der entsprechenden Objekte. Bei Multtexturing wird der Modus „normal“ auf „addieren“ gesetzt, um dem C4D-Verhalten zu entsprechen.
h.	Texturendung anpassen. Praktisch für PNG-Texturen, da Cinema4D diese nicht kennt.

2.2.Warnungen und Fehlermeldungen

In der Konsole von Cinema4D( Aufruf über <shift>+F10 oder das Fenster-Menü) wird eine detaillierte Protokollierung über den Verlauf des Exports geführt. Neben Infos, wie den exportierten Texturen, Materialen und Objekten, werden hier auch Warnungen und Fehlermeldungen eingetragen.

Folgende Meldungen können derzeit auftreten:

E: No parent mesh for bone!	Es wurde ein Bone gefunden, aber dieser ist keinem PolygonObjekt zugeordnet(wurde das Parentobjekt vielleicht nicht in ein Grundobjekt konvertiert?).
W:Parent mesh isn't in null position. It might be shown corrupt or displaced.	Bone-animierte Gitterobjekte sollten am Besten nicht verschoben, skaliert oder rotiert sein, sondern in der Null-Position der Weltachse liegen. Das ist dann ein Problem, wenn nicht jeder Vertexpunkt einem Bone zugeordnet ist, da diese dann in der ursprünglichen Position liegen, egal wie das Mesh positioniert oder rotiert bzw. skaliert ist und auch entsprechend deplaziert angezeigt werden.
W:There aren't any vertices affected by bone(No valid restriction found).	Für diesen Bone wurde kein Beschränkungstag gefunden, er wirkt sich also nicht direkt auf die Animation aus.
W:Multiple UV for at least one vertex. Texturemapping might not be correct.	Es wurden mehrere unterschiedliche Texturkoordinaten für einen Vertexpunkt gefunden, so dass die Textur teilweise verzerrt wird. Da Cinema4D UV-Koordinaten je Polygon, Blitz3D aber je Vertex speichert, kann es zu Fehlern in der Texturdarstellung kommen, wenn die einzelnen Polygone nicht voneinander getrennt sind. Durch Setzen der Option „Disconnect polygons“ kann dieses Problem umgangen werden.
W:UVW-tag not found. No texture mapping for this one.	Für das entsprechende Objekt wurde kein UVW-Tag gefunden. Es ist also kein Texturmapping möglich. Im Objektbrowsers kann mit der Funktion „Textur->UVW-Tag erzeugen“ ein entsprechende Tag erstellt werden.
W: Texture projection isn't set to UVW. Texture mapping might not be correct.	Bei mindestens einem Texturtag ist das Mapping nicht auf UVW gestellt. Da immer nur die UVW-Tags ausgelesen werden, könnte die Textur in Blitz3D anders als in Cinema4D erscheinen.
W: Too many textures for brush. Writing 8 texture layers.	Für ein Surface sind maximal 8 Texturlayer erlaubt. Sollte es mehr geben, werden diese ignoriert.
W:Object not recognized. Exporting as pivot.	Das Objekt ist weder Null-, Polygon- oder BoneObjekt. Es wird also als Pivot exportiert.
W:Blend/FX/Texture-Flag couldn’t be evaluated.	In den Materialoptionen wurde zwar beim Leuchten, Transparenz oder Alphakanal zwar ein Texturflag gefunden, dieses enthält aber keinen gültigen Wert.

2.3.Objekthierarchie

• B3D-Dateien dürfen nur einen Wurzelknoten enthalten. Hat die Szene mehrere Wurzelobjekte, so werden diese automatisch unterhalb eines Pivots „ROOT“ platziert.
• Soll in Blitz3D die Objekthierarchie erhalten bleiben, so ist dort die Datei mit LoadAnimMesh() zu laden.

2.4.Texturen&Materialien

• Für korrektes Texturemapping muss für jedes Mesh-Objekt auch ein UVW-Tag vorhanden sein. Dies kann im Objektbrowsers mit der Funktion „Textur->UVW-Tag erzeugen“ erstellt werden:
  
• Da Cinema4D UV-Koordinaten je Polygon, Blitz3D aber je Vertex speichert, kann es zu Fehlern in der Texturdarstellung kommen, wenn die einzelnen Polygone nicht voneinander getrennt sind. Durch Aktivieren der Exportoption „Disconnect polygons“ kann dieses Problem umgangen werden.
• Es sind mehrere Texturlayer für ein Objekt möglich(„Multitexturing“). Hat ein Objekt mehr als ein Material zugewiesen, so gilt normalerweise wie in C4D das letzte Material. Ist im TextureTag hier aber die Option „Mix Textures“ gesetzt, so wird die Textur gemäß MixMode auf das vorherige Material hinzugerechnet. Die weiteren Einstellungen wie z.B. Farbe oder Leuchten werden nur aus dem ersten Material übernommen. Die Reihenfolge der Texturen ist also sehr wichtig.
• Ein zweites UV-Set für z.B. Lightmaps wird ebenfalls mit exportiert. Dabei beziehen sich alle Materialen auf das dem Texturtag folgende UVW-Tag. Folgt kein weiteres UVW-Tag mehr, so gilt dann wiederum das erste. Da in B3D nur zwei UV-Sets unterstützt werden, bezieht sich eine Textur entweder auf das erste UV-Set(hinter oder vor dem Texturtag ist kein weiteres UVW-Tag) oder eben auf das zweite UV-Set(Die Textur ist zwischen zwei UVW-Tags platziert).
• Die Beschränkung von Texturen auf einzelne Polygonselektionen ist jetzt auch möglich. Wie in Cinema 4D überschreibt ein nachfolgendes Material ohne Beschränkung auch beim Export die weiteren Beschränkungen. Texturen ohne Beschränkung müssen also vor Texturen mit Beschränkung eingefügt werden, außer wenn es sich um eine Multitextur wie z.B. eine Lightmap handelt. Diese kann auf diese Weise automatisch Surface-übergreifend dem kompletten Mesh zugewiesen werden.
  
  
• Folgende Materialeinstellungen werden beim Export berücksichtigt:
  
• TextureTag
  Beschränkungen sind nur für Polygonselektionen möglich. Hierbei wird ein eigenes Surface kreiert. Alle Polygone, die keiner gültigen Beschränkung zugewiesen sind, werden als eigenes Surface exportiert.
  Die Option „Mix Textures“ muss für Mulitexturen gesetzt werden. Ansonsten überschreibt das Material alle vorhergehenden Materialien. Ein Surface kann bis zu 4 verschiedene Texturlayer beinhalten.
  
  
  
• Texturflags
  EntityFX, EntityBlend und Textur-Ladeflags können direkt gesetzt werden.
  Dazu muss im Eingabefeld „Textur“ des entsprechenden Kanals einfach ein Doppelpunkt und dann der gewünschte Wert eingegeben werden(z.B. „Leuchten“ mit Texturenamen „:16“ deaktiviert BackfaceCulling).
  -Um in R9 einen entsprechenden Wert eingeben zu können, muss zuerst eine Dummy-Textur ausgewählt werden. Erst dann kann das enstprechende Eingabefeld angeklickt und ein freier Wert eingegeben werden.
  Die Kanäle sind folgenden Optionen zugeordnet:

Leuchten	EntityFX
Transparenz	EntityBlend
Alpha	Texturflag (siehe LoadTexture)

• Farbe
  Neben Farbwert und der Textur wird auch der Mischmodus berücksichtigt. Normal, Addieren oder Multiplizieren wird entsprechen in Blitz3D übernommen, Subtrahieren setzt Textureblend 5 = Multiply2:
  
  
  
• Leuchten
  Leuchten wird über den gesamten Kanal entweder nur aktiviert oder deaktiviert. Im blau umrandeten Textureingabefeld kann aber direkt der EntityFX-Wert vorgegeben werden.
  
  
  
• Transparenz
  Hier spielt der Helligkeitswert sowie die Option „Additiv“ eine Rolle. RGB wird zwar auch beim Berechnen der Helligkeit herangezogen, der Farbton wird aber über die Option „Farbe“(siehe oben) geregelt. Im blau umrandeten Textureingabefeld kann direkt der EntityBlend-Wert vorgegeben werden.
  
  
  
• Alpha
  Ist Alpha aktiviviert, so werden standardmäßig schwarze Texturpixel transparent geschalten. Ist eine Eingabe im Feld Texturname vorhanden, sowie die Option „Alpha-Bild“ aktiviert, so wird der Alphakanal der Standardtextur(aus Kanal Farbe) übernommen.
  Im blau umrandeten Textureingabefeld kann auch direkt ein Wert für das Texture-Ladeflag vorgegeben werden.
  
  
  
• Glanzlicht
  Hier wird nur der Höhenwert berücksichtigt:
  

2.5.Animation

• Vorsicht bei Rotationsanimationen! Hier wird in Blitz3D immer der absolut kürzeste Weg zum nächsten Winkel gedreht, in Cinema4D dagegen ist der Wert des Winkels entscheidend.
  Beispiel: Key 1: 0°; Key 2: 350°. In Cinema erfolgt nun eine fast komplette Drehung um 350°, in Blitz3D aber entgegengesetzt um -10°. Um die gewünschte Drehung auch in B3D zu erreichen, muss also zwischen die beiden Keys noch ein dritter Key mit z.B. 175° eingefügt werden.
  Dies muss bei der Option „Auto Keyframing“ nicht berücksichtigt werden
• Die Gesamtanzahl der Animationsbilder ergibt sich aus den Dokumenteinstellungen: „Bearbeiten->Projekt Einstellungen“:
  
  Die Frame Rate wird zwar auch mitgespeichert, scheint in Blitz3D momentan aber keine Auswirkungen zu haben.
• Die Framenummern gehen in Blitz3D immer von 0 (Null) los, die Anzahl ergibt sich aus Maximum minus Minimum.

2.6.Boneobjekte

• Bone-Animierte Gitterobjekte DÜRFEN NICHT verschoben, skaliert oder rotiert worden sein, sondern MÜSSEN auf der Position 0,0,0 liegen, Skalierung MUSS 1,1,1 und Rotation 0,0,0 sein.
• Wenn Bones eingesetzt werden, dürfen Polygonobjekte nur direkt auf der Szenenebene(also nicht unterhalb anderer Objekte) platziert werden, da die Bones ansonsten von Blitz3D nicht eindeutig zugeordnet werden können. Es empfiehlt sich, jedes Bone-animierte Polygonobjekt in eine eigene Datei zu speichern.
• Es müssen alle Bones fixiert sein(dazu im Objektbrowser mit der rechten Maustaste auf das Boneobjekt klicken und Funktion "Bones fixieren" wählen).
• Es werden nur Bones mit einer gültigen Beschränkung betrachtet, derzeit ist auch nur eine Beschränkung erlaubt:
  
• Beschränkungen sind nur auf Punktselektionen und Vertexmaps möglich. Polygonselektionen bleiben außen vor.
• Gewichtete Vertexpunkte(über Vertexmap oder Stärke im Beschränkungstag) werden in Blitz3D anders als in Cinema4D behandelt.
  In Blitz3D ist die Gewichtung nur dann relevant, wenn der entsprechende Vertexpunkt von mehreren Bones genutzt wird. Ansonsten wird die Gewichtung ignoriert und dieser Vertexpunkt voll angesprochen.
  Ebenso spielt in Blitz3D die Entfernung des Bones zu den Vertexpunkten keine Rolle. Die tatsächliche Gewichtung eines Vertices für einen Bone ergibt sich aus dem Anteil an der Gesamtsumme aller relevanten Gewichtungen(da muss man etwas rumprobieren).

2.7. Vertexfarben / Vertexalpha

• Da es in Cinema4D keine Funktion für Vertexfarben gibt, können diese mittels Punktwichtungen(„Selektion->Punktewichtungen setzen“) gesetzt werden. Dazu muss eine eigene Punktwichtung je gewünschter Komponente angelegt werden, die über einen entsprechenden Namen zugeordnet wird:

Name der Punktwichtung	Wirkung
RED	Rot-Komponente der Vertexfarbe(default Materialfarbe)
GREEN	Grün-Komponente der Vertexfarbe(default Materialfarbe)
BLUE	Blau-Komponente der Vertexfarbe(default Materialfarbe)
BRIGHTNESS	Helligkeit des Vertices(default 100%)
ALPHA	Alpha-Wert des Vertices(default 100% = undurchsichtig)

• Bei der Benennung muss die Großschreibung beachtet werden!
• Ist mindestens eine der obigen Punktwichtungen für ein Objekt eingestellt, so wird für dieses automatisch einen passender EntityFX-Wert gesetzt. Dieser kann nur über Texturflags übersteuert werden.

3.Hilfs-Plug-Ins

Neben dem eigentlichen PlugIn zum Export der Dateien gibt es noch folgende praktische „Helferlein“:

H_Disconnect All Polygons	Hiermit werden alle Polygone des ausgewählten und aller untergeordneten Objekten voneinander getrennt und auf eigene Vertexpunkte gesetzt.
H_Invert Vertex Map	Hiermit kann eine Vertexmap invertiert werden. Mit der Option „Skip zero-weights“ kann verhindert werden, dass Vertices mit dem Wert „0“ auf „100“ gesetzt werden.
H_Reverse All Normals	Hiermit werden die Normalen aller Polygone des ausgewählten und aller untergeordneten Objekten umgedreht. Praktisch, wenn ein ganzes Modell falsch ausgerichtet ist(z.B. Zygote-Figuren)

4.Bekannte Probleme

- In Cinema4D Release 10 werden Wichtungsmaps noch nicht unterstützt und Animationen lassen sich nur mit aktiviertem „Autokeyframing“ exportieren, da der entsprechende Zugriff über COFFEE noch nicht möglich oder noch nicht dokumentiert ist.

5.Änderungen

Version 0.8
!Fehlerhafter Export der UV-Koordinaten behoben
!Exporter muss jetzt über das Plugin-Verzeichnis aufgerufen werden, so dass dieser jetzt sogar mit der C4D-Demo funktioniert.
+Unterstützung von Bones
+Warnungen & Fehler beim Export werden protokolliert und in der Console ausgewiesen

Version 0.9
!Bei der Dateiabfrage können jetzt auch wieder neue Dateien angegeben werden
+Animationssupport für C4D-Release 8 & 9. In Release.txt muss hierfür die korrekte Releasenummer eingegeben werden(ohne führende Leerzeichen).
+Hilfsplugin um alle Normalen aller selektierten Objekte umzukehren
+Hilfsplugin um allen Polygonen aller selektierten Objekte eigene Punkte zuzuordnen

Version 1.0

!Umfangreiche Überarbeitung

!Verbesserte Kompatibilität

+Dialog mit einigen Optionen zum Export

+Nachträgliche Verschiebung und Skalierung wird jetzt berücksichtigt

+Es kann jetzt ein zweites UV-Set je Objekt exportiert werden

+Materialparameter Alpha, Leuchten und additive Transparenz werden berücksichtigt.

+Bei den Materialkanälen Leuchten, Transparenz und Alpha können jetzt in dem Feld Texturname jeweils Flags für EntityFX, EntityBlend und Textureflags gesetzt werden. Dazu muss einfach ein Doppelpunkt und dann der gewünschte Wert eingegeben werden(z.B. „Leuchten“ mit Texturenamen „:16“ deaktiviert BackfaceCulling). Die weiteren Einstellungen im Dialog werden damit überschrieben.

Version 1.1

!Bei Bone-animierten Objekten konnte es passieren, dass der Fehler „Position/Scale/Rotation of parent mesh isn't set to zero!” fälschlicherweise angezeigt wurde und kein Export erfolgt ist.

+Zusätzliche Prüfung auf maximale Vertexanzahl pro Objekt

+Fehlermeldungen bei TextureFlags je Kanal aufgesplittet

+Demos angehängt

+Englische Dokumentation

Version 1.3

!Die Option „Enable shading for texture mix mode 'normal'” funktioniert jetzt immer korrekt.

!Dialog für bessere Darstellung bei unterschiedlichen Schriftarten überarbeitet

!Bei Boneobjekten wird jetzt immer mindestens ein Key erzeugt, da hier die „echte“ Position im Key gespeichert ist.

!Beim Hilfsplugin H_Disconnect_All_Polygons werden VertexMaps und Punktselektionen nicht mehr zerstört

+Texturbeschränkungen auf Polygonselektionen werden jetzt berücksichtigt. Hier wird dann ein eigenes Surface generiert.

+Materialkonzept überarbeitet, so dass jetzt auch Multitexturing möglich ist

+Neue Option „Disconnect polygons“ um die Polygone erst beim Export auftrennen zu können(wie Hilfsplugin H_Disconnect_All_Polygons)

Version 1.4

!Zuordnung von UVW-Tag zu Textur so geändert, dass diese jetzt wie in Cinema4D funktioniert.

+Unterstützung von Vertexcolor und –alpha mittels Punktwichtungen(siehe 2.7=

-Meldung “W:Blend/FX/Texture-Flag couldn’t be evaluated” entfernt, da nicht unterschieden warden kann, ob es sich tatsächlich um einen Fehler oder einfach nur den Wert “0” handelt.

Viel Spaß wünscht:
Robert Hierl

Homepage: www.mein-murks.de
Kontakt: rhierl@gmx.de

27.05.2007 ©Robert Hierl