Brugervejledning for Microstation til OpenSceneGraph konverter - sidste rettelse: 10/06/2005 side 1
Indholdsfortegnelse Kort oversigt over dgn2osg... 3 Systemkrav... 3 Funktionalitet...4 Geometri...4 Materialer... 4 At gemme meshes fra Microstation...6 Fil-placering... 6 Bruger Interface...7 Åbning af filer I visualiseringspakken five...9 side 2
Kort oversigt over dgn2osg Dgn2Osg er en loader til OpenSceneGraph, der gør det muligt at loade Microstation filer direkte i alle OSG-baserede applikationer, herunder five. Dgn2Osg er i stand til at håndtere meshes fra.dgn-filer, og læser tillige Microstation materialer. Dgn2Osg giver yderligere let tilgang til at inspicere objekterne efter konvertering. Dgn2Osg baserer sig på OpenDGN, der er en åben DGN-læser fra OpenDesignAlliance. Dgn2Osg er udviklet af Virtual Reality Centeret under UNI C, i samarbejde med PLH Arkitekter A/S. Denne dokumentation knytter sig til version 1.0 af dgn2osg-konverteren. Systemkrav Konverterringsprogrammet kræver en PC med opdateret installation af Windows98, Windows 2000 eller Windows XP, samt en installation af Microsoft.NET 1.1. Yderligere er det nødvendigt at anvende et grafikkort med hardwareunderstøttelse af OpenGL. side 3
Funktionalitet Formålet med konverteren er, at oversætte scener fra Microstation til et format der let kan anvendes til visualisering med værktøjet five. Til dette er opbygget en konverter, der læser Microstation.dgn-filer, og gemmer OpenSceneGraph.osg-filer. Geometri - Geometri læses fra meshes i dgn-filerne. - For hvert objekt læses yderligere: o Navn o Beskrivelse o Farve o Level - XREFs er understøttet. Også nesting er understøttet. Dog er rekursiv nesting ikke tilladt (filer må ikke have en xref til en model tidligere i sit eget hierarki). Når filen loades dannes der et OSG-hieraki, der opbygges efter følgende skabelon. Modeller loadet ved referencer fra XREFs loades kun en enkelt gang hver. På denne måde holdes ressourcerne til multiple instanser af samme model minimale. Materialer - Materialer læses fra Microstation.mat og.pal filer..mat-filen skal have samme fornavn som.dgn-filen. - Gennemsigtighed dannes ud fra transmit -parametren i Microstationmaterialer. - Den spekulære eksponent (hvor skarpt højlyset er), dannes tilsvarende ud fra finish -parametren. - Patterns (textures) tages der på nuværende tidspunkt ikke hensyn til. side 4
Kun assignede materialer understøttes altså, materialer der tildeles på baggrund af level/color og lægges parallelt med.dgn-filen i.mat/.pal filer. Attachede materialer, f.eks. på per-face niveau, er på nuværende tidspunkt ikke muligt via OpenDGN (v.0.98). Der tages under konverteringen højde for den anvendte målestok i Microstation dgnfilerne. OSG-filerne gemmes altid i millimeter, og konverteringen foretages automatisk. Det er dog en nødvendighed, at alle filer refereret vis XREFs anvender samme målestok. side 5
At gemme meshes fra Microstation. Hvis de scener der ønskes konverteret inderholder højniveau -geometri, hvilket typisk vil være tilfældet, er det nødvendigt at forberede scenen til eksportering inden konvertering. For at eksporteren kan læse en model, skal denne være et såkaldt mesh. I Microstation kan alle modeller konverteres til meshes til tider skal de dog droppes først (hvis du ikke ved hvordan, bør du nok ikke bruge dette værktøj). Det viste vindue hvor facet kan findes, åbnes under Tools->Tool Boxes->3D Utility. Når en model er facetteret til et mesh, skal det se således ud. At konverteringen til mesh er sket korrekt kan også undersøges under Element information I Microstation. Fil-placering Det er vigtigt at filerne placeres et sted så systemet kan finde dem. Det vil sige, at alle Microstation (.dgn), materiale (.mat) og palette (.pal) filer enten skal ligge i den samme mappe på computeren, eller at stier der er angivet i filerne passer, f.eks. y:\myfiles\tower_bridge.pal. Det er vigtigt at også XREF-dgn filer lægges et sted hvor konverteren kan finde dem. Den sikreste løsning er at lægge alle filerne samlet i en enkelt folder. side 6
Bruger Interface Dgn2Osg kan startes på to forskellige måder. Den første måde er ved at filen osg_dgnimporter.exe startes, f.eks. ved at dobbeltklikke på navnet i windows explorer. Hvis programmet åbnes på denne måde, vil en fildialog åbnes, hvori det er muligt at vælge den Microstation dgn-fil der ønskes konverteret. Den anden måde at starte programmet, er ved at drag-droppe en dgn-fil over på osg_dgnimporter.exe, eller et shortcut til denne fil. På denne måde vil den drag-droppede fil automatisk blive valgt til konvertering. Når programmet er åbnet med en relevant fil, åbnes et vindue der viser eventuelle kommentarer til konverteringen. Dette kan f.eks. være advarsler hvis dele af Microstation-filen ikke er konverteret, eller hvis materiale-filer mangler. Disse advarsler vil også blive lagt i en log fil, med samme fornavn som den konverterede Microstation-fil. Eksempelvis vil konvertering af stor_bygning.dgn, resultere i to filer: Den konverterede fil stor_bygning.osg, og en log fil, stor_bygning.log. Log-filen er ren tekst, og kan læses med eksempelvis notepad. Efter endt konvertering, bliver der spurgt om et preview-vindue skal åbnes. I previewvinduet vises modellen i en simpel viewer. Dette kan være praktisk hvis man ønsker nærmere at undersøge om alle dele af konverteringen er lykkedes. Det kan eksempelvis se således ud side 7
I denne viewer kan kameraet flyttes rundt således at det konverterede objekt kan inspiceres. Input Venstre museknap Midterste museknap Højre museknap Funktion roterer modellen. panner modellen. zoomer modellen 1 vælger trackball -motionmodel 2 vælger paraglider-motionmodel 3 vælger walk -motionmodel Spacebar W F O L S Z nulstiller kameraet skifter måden at tegne modellen på, imellem solid/wireframe/punkt skifter imellem fuldskærm / vindue skriver modellen (en gang til), til saved_model.osg slår belysning til / fra. giver forskellig teknisk status på skærmen optager en animation der senere kan afspilles. (ikke brugbart) side 8
Åbning af filer I visualiseringspakken five Efter konverteringen, er filen blevet gemt i.osg format, der er et åbent filformat til OpenSceneGraph. Det vil sige, at filen kan læses af alle programmer der anvender OSG til håndtering af modeller. Det er blandt andet tilfældet for visualiseringspakken five, der dog internet anvender et bedre format,.ive muligheden for at hente.osg - filer eksisterer dog stadig, om end ikke umiddelbart tilgængelig: På sædvanlig vis åbnes five, og der trykkes på ikonet Open øverst til venstre. Herefter åbnes en fildialog, der spørger efter den ønskede fil. Bemærk at denne dialog kun viser.ive filer. For at ændre dette, kan man i tekstfeltet File name skrive *, eller *.osg. Nu vises alle filer, og de ønskede.osg-filer kan loades. Navigation i five sker på sædvanlig vis, og der henvises til dokumentationen på http://five.vr-c.dk side 9
Under konverteringen dannes et default view, der viser hele modellen. Dette anvendes som udgangspunkt ved visualisering af modellen. Ønskes at vende tilbage til dette view, kan viewpoints importeres. Dette gøres ved under Viewpoint -fanebladet, at vælge Choose edit -> Viewpoint, og i det nye faneblad, nederst at vælge Import Views. Herefter kan udgangsviewpointet tilgås via viewpoint-listen under navnet default view. side 10