============================================== Collada Viewer AR 0.5.0 Demo - README.TXT ============================================== Collada Viewer show 3D models stored in a Collada XML file (.dae). You can use AR (Augmented Reality) to see your model. You can see geometry hierarchy (meshes, submeshes) of a model. You can edit materials and textures in real-time. Collada Viewer is written in c# .net. Direct3DRenderer and 3D Engine (Hanami Engine) are written in C++. Collada Viewer AR use ARtoolkitPlus library (C++). Usage: >.\ColladaViewer.exe [file] 'file' must have a '.dae' extention. Controls: --------- Mouse wheel: Zoom in/out. Move mouse while pressing left button: rotate model. Move mouse While pressing right button: moving camera. Move mouse While pressing left and right buttons: Precise Zoom in/out. Main Buttons: ------------- On bottom: Play/Pause: Plays or pause animation (if present in model). Previous: Plays previous animation (if more than 1 animation are present in model). Next: Plays next animation (if more than 1 animation are present in model). Stop: Stops animation. Full/Wireframe: switch between 2 fill modes, wireframe fill mode and full textured and shaded fill mode . Rotate: Rotates the camera around the centered model. Center: Centers the model in the screen. Augmended Reality: Start the viwer in AR mode. LandScape: Changes background from a plan to a sky box and an additionnal static light (sun). On top-right: Open File: Open a new collada model from a file (.dae). Library: Shows the model hierarchy and materials. Lights: ------- Two ligths are available. One on the left and one on the right, - It is possible to switch on/off a light by clicking on corresponding button on the left or the right. - Change the brigthness (light intensity) and the hue for each light with corresponding sliders. Note: Place the "hue slider" on maximum value (right) to get a white light. (other light parameters (saturation, lightness, attenuation...) are not available actually). Lights are fixed with the camera in AR mode. Library: -------- When button 'Library' is clicked, a new window with meshes ans materials used by the model in a treeview is opened. - When you select a mesh or one of its subsets, you can see the mesh being transparent blue in main window making easy to identifiate it. - You can edit a material if you clic on "Edit" link in a material node. - You can replace a texture directly in treeview by clinging on the texture image. Note: Material and textures changes cannot be saved in this program. Augmented Reality: ------------------ Markers: Prior to use AR function you need to print some markers. Markers are present in 'Markers' folder: - Single-Double.pdf give you simple markers with credit card format, so you can glue them on some old unused cards. Double is more easy to detect: only one marker needs to be detected. - Map.pdf is a map marker. It premits to show model even is some markers are occulted. - Cube.pdf is a cube template. You have to make some handicraft. With cube marker always at least one tag can be seen by camera. This permit to see your model in all direction. Commands: In AR mode, you have some specific functionalities: On right: The marker type in use, the percent of detection (confidence number) and the number of detected markers. Size slider: Changes the scale of the model. Luminance slider: change ambient luminance applied to the model. Luminance Auto checkbox: Check this if you want the program automaticaly set the luminance of the model. Luminance: Automatic luminance is computed in different ways depending maker used. Luminance formula used is "L = (R + G + B) / 3" for each scanned pixel. Local luminace is computed on a projected square around the detected marker (using the white borders of the marker). Global luminance is computed on the entire video image. If no markers are detected the number shown in Luminance Slider is global. For instance only single marker use local luminance. Next version will use local luminace to detect light source direction. Note: You have always the control of the right and left lights and can adjust respective brightness to compensate if model seens too dark. Requirements: ------------- - Microsoft .net framework 3.5 SP1 must be installed on your PC to run this program. - Microsoft DirectX9 or above must be installed on your PC to run this program. - DirectX9 graphic card supporting Shader Model 3 is required to run this program. - To use AR functionality you need a USB DirectShow compatible camera or an IEEE1394/i-Link/Firewire camera (DV camera). Notes: ------ This program have been tested on Nvidia GeFroce6800GT, Nvidia Geforce7800GT, 2x Geforce7800GT with SLI, Nvidia Geforce9800GT and ATi RadeonHD5450. AR functions have been tested with differents PS2 EyeToys (Logitech, Namtai), logitech cameras and Sony DV camera. Contact: -------- hanami.engine(at_symbol)gmail.com ---------- 10/10/2010 (c) Copyright 2010, Christophe Paris.