Tutorial 22: Material Viewer

This example can be used to play around with material settings and watch the results. Only the default non-shader materials are used in here.

You have two nodes to make it easier to see which difference your settings will make. Additionally you have one lightscenenode and you can set the global ambient values.

#include <irrlicht.h>
#include "driverChoice.h"

using namespace irr;

#ifdef _MSC_VER
#pragma comment(lib, "Irrlicht.lib")
#endif

Variables within the empty namespace are globals which are restricted to this file.

namespace
{
    const wchar_t* const DriverTypeNames[] =
    {
        L"NULL",
        L"SOFTWARE",
        L"BURNINGSVIDEO",
        L"DIRECT3D8",
        L"DIRECT3D9",
        L"OPENGL",
        0,
    };

    // For the gui id's
    enum EGUI_IDS
    {
        GUI_ID_OPEN_TEXTURE = 1,
        GUI_ID_QUIT,
        GUI_ID_MAX
    };

    // Name used in texture selection to clear the textures on the node
    const core::stringw CLEAR_TEXTURE = L"CLEAR texture";

    // some useful color constants
    const video::SColor SCOL_BLACK     = video::SColor(255, 0,   0,   0);
    const video::SColor SCOL_BLUE      = video::SColor(255, 0,   0,  255);
    const video::SColor SCOL_CYAN      = video::SColor(255, 0,  255, 255);
    const video::SColor SCOL_GRAY      = video::SColor(255, 128,128, 128);
    const video::SColor SCOL_GREEN     = video::SColor(255, 0,  255,  0);
    const video::SColor SCOL_MAGENTA   = video::SColor(255, 255, 0,  255);
    const video::SColor SCOL_RED       = video::SColor(255, 255, 0,   0);
    const video::SColor SCOL_YELLOW    = video::SColor(255, 255, 255, 0);
    const video::SColor SCOL_WHITE     = video::SColor(255, 255, 255, 255);
};  // namespace

Returns a new unique number on each call.

s32 makeUniqueId()
{
    static int unique = GUI_ID_MAX;
    ++unique;
    return unique;
}

Find out which vertex-type is needed for the given material type.

video::E_VERTEX_TYPE getVertexTypeForMaterialType(video::E_MATERIAL_TYPE materialType)
{
    using namespace video;

    switch ( materialType )
    {
        case EMT_SOLID:
            return EVT_STANDARD;

        case EMT_SOLID_2_LAYER:
            return EVT_STANDARD;

        case EMT_LIGHTMAP:
        case EMT_LIGHTMAP_ADD:
        case EMT_LIGHTMAP_M2:
        case EMT_LIGHTMAP_M4:
        case EMT_LIGHTMAP_LIGHTING:
        case EMT_LIGHTMAP_LIGHTING_M2:
        case EMT_LIGHTMAP_LIGHTING_M4:
            return EVT_2TCOORDS;

        case EMT_DETAIL_MAP:
            return EVT_2TCOORDS;

        case EMT_SPHERE_MAP:
            return EVT_STANDARD;

        case EMT_REFLECTION_2_LAYER:
            return EVT_2TCOORDS;

        case EMT_TRANSPARENT_ADD_COLOR:
            return EVT_STANDARD;

        case EMT_TRANSPARENT_ALPHA_CHANNEL:
            return EVT_STANDARD;

        case EMT_TRANSPARENT_ALPHA_CHANNEL_REF:
            return EVT_STANDARD;

        case EMT_TRANSPARENT_VERTEX_ALPHA:
            return EVT_STANDARD;

        case EMT_TRANSPARENT_REFLECTION_2_LAYER:
            return EVT_2TCOORDS;

        case EMT_NORMAL_MAP_SOLID:
        case EMT_NORMAL_MAP_TRANSPARENT_ADD_COLOR:
        case EMT_NORMAL_MAP_TRANSPARENT_VERTEX_ALPHA:
        case EMT_PARALLAX_MAP_SOLID:
        case EMT_PARALLAX_MAP_TRANSPARENT_ADD_COLOR:
        case EMT_PARALLAX_MAP_TRANSPARENT_VERTEX_ALPHA:
            return EVT_TANGENTS;

        case EMT_ONETEXTURE_BLEND:
            return EVT_STANDARD;

        case EMT_FORCE_32BIT:
            return EVT_STANDARD;
    }
    return EVT_STANDARD;
}

Custom GUI-control to edit colorvalues.

class CColorControl : public gui::IGUIElement
{
public:
    // Constructor
    CColorControl(gui::IGUIEnvironment* guiEnv, const core::position2d<s32> & pos, const wchar_t *text, IGUIElement* parent, s32 id=-1 )
        : gui::IGUIElement(gui::EGUIET_ELEMENT, guiEnv, parent,id, core::rect< s32 >(pos, pos+core::dimension2d<s32>(80, 75)))
        , DirtyFlag(true)
        , ColorStatic(0)
        , EditAlpha(0)
        , EditRed(0)
        , EditGreen(0)
        , EditBlue(0)
    {
        using namespace gui;
        ButtonSetId = makeUniqueId();

        const core::rect< s32 > rectControls(0,0,AbsoluteRect.getWidth(),AbsoluteRect.getHeight() );
        IGUIStaticText * groupElement = guiEnv->addStaticText (L"", rectControls, true, false, this, -1, false);
        groupElement->setNotClipped(true);

        guiEnv->addStaticText (text, core::rect<s32>(0,0,80,15), false, false, groupElement, -1, false);

        EditAlpha = addEditForNumbers(guiEnv, core::position2d<s32>(0,15), L"a", -1, groupElement );
        EditRed = addEditForNumbers(guiEnv, core::position2d<s32>(0,30), L"r", -1, groupElement );
        EditGreen = addEditForNumbers(guiEnv, core::position2d<s32>(0,45), L"g", -1, groupElement );
        EditBlue = addEditForNumbers(guiEnv, core::position2d<s32>(0,60), L"b", -1, groupElement );

        ColorStatic = guiEnv->addStaticText (L"", core::rect<s32>(60,15,80,75), true, false, groupElement, -1, true);

        guiEnv->addButton (core::rect<s32>(60,35,80,50), groupElement, ButtonSetId, L"set");
        SetEditsFromColor(Color);
    }

    // event receiver
    virtual bool OnEvent(const SEvent &event)
    {
        if ( event.EventType != EET_GUI_EVENT )
            return false;

        if ( event.GUIEvent.Caller->getID() == ButtonSetId && event.GUIEvent.EventType == gui::EGET_BUTTON_CLICKED )
        {
            Color = GetColorFromEdits();
            SetEditsFromColor(Color);
        }

        return false;
    }

    // set the color values
    void setColor(const video::SColor& col)
    {
        DirtyFlag = true;
        Color = col;
        SetEditsFromColor(Color);
    }

    // get the color values
    const video::SColor& getColor() const
    {
        return Color;
    }

    // To reset the dirty flag
    void resetDirty()
    {
        DirtyFlag = false;
    }

    // when the color was changed the dirty flag is set
    bool isDirty() const
    {
        return DirtyFlag;
    };

protected:

    // Add a staticbox for a description + an editbox so users can enter numbers
    gui::IGUIEditBox* addEditForNumbers(gui::IGUIEnvironment* guiEnv, const core::position2d<s32> & pos, const wchar_t *text, s32 id, gui::IGUIElement * parent)
    {
        using namespace gui;

        core::rect< s32 > rect(pos, pos+core::dimension2d<s32>(10, 15));
        guiEnv->addStaticText (text, rect, false, false, parent, -1, false);
        rect += core::position2d<s32>( 20, 0 );
        rect.LowerRightCorner.X += 20;
        gui::IGUIEditBox* edit = guiEnv->addEditBox(L"0", rect, true, parent, id);
        return edit;
    }

    // Get the color value from the editfields
    video::SColor GetColorFromEdits()
    {
        video::SColor col;

        if (EditAlpha)
        {
            u32 alpha = core::strtoul10(core::stringc(EditAlpha->getText()).c_str());
            if (alpha > 255)
                alpha = 255;
            col.setAlpha(alpha);
        }

        if (EditRed)
        {
            u32 red = core::strtoul10(core::stringc(EditRed->getText()).c_str());
            if (red > 255)
                red = 255;
            col.setRed(red);
        }

        if (EditGreen)
        {
            u32 green = core::strtoul10(core::stringc(EditGreen->getText()).c_str());
            if (green > 255)
                green = 255;
            col.setGreen(green);
        }

        if (EditBlue)
        {
            u32 blue = core::strtoul10(core::stringc(EditBlue->getText()).c_str());
            if (blue > 255)
                blue = 255;
            col.setBlue(blue);
        }

        return col;
    }

    // Fill the editfields with the value for the given color
    void SetEditsFromColor(video::SColor col)
    {
        DirtyFlag = true;
        if ( EditAlpha )
            EditAlpha->setText( core::stringw(col.getAlpha()).c_str() );
        if ( EditRed )
            EditRed->setText( core::stringw(col.getRed()).c_str() );
        if ( EditGreen )
            EditGreen->setText( core::stringw(col.getGreen()).c_str() );
        if ( EditBlue )
            EditBlue->setText( core::stringw(col.getBlue()).c_str() );
        if ( ColorStatic )
            ColorStatic->setBackgroundColor(col);
    }

private:

    bool DirtyFlag;
    video::SColor Color;
    s32 ButtonSetId;
    gui::IGUIStaticText * ColorStatic;
    gui::IGUIEditBox * EditAlpha;
    gui::IGUIEditBox * EditRed;
    gui::IGUIEditBox * EditGreen;
    gui::IGUIEditBox * EditBlue;
};

Custom GUI-control for to edit all colors typically used in materials and lights

class CAllColorsControl : public gui::IGUIElement
{
public:
    // Constructor
    CAllColorsControl(gui::IGUIEnvironment* guiEnv, const core::position2d<s32> & pos, const wchar_t * description, bool hasEmissive, IGUIElement* parent, s32 id=-1)
        : gui::IGUIElement(gui::EGUIET_ELEMENT, guiEnv, parent,id, core::rect<s32>(pos,pos+core::dimension2d<s32>(60,250)))
        , ControlAmbientColor(0), ControlDiffuseColor(0), ControlSpecularColor(0), ControlEmissiveColor(0)
    {
        core::rect<s32> rect(0, 0, 60, 15);
        guiEnv->addStaticText (description, rect, false, false, this, -1, false);
        createColorControls(guiEnv, core::position2d<s32>(0, 15), hasEmissive);
    }

    // Destructor
    virtual ~CAllColorsControl()
    {
        ControlAmbientColor->drop();
        ControlDiffuseColor->drop();
        if ( ControlEmissiveColor )
            ControlEmissiveColor->drop();
        ControlSpecularColor->drop();
    }

    // Set the color values to those within the material
    void setColorsToMaterialColors(const video::SMaterial & material)
    {
        ControlAmbientColor->setColor(material.AmbientColor);
        ControlDiffuseColor->setColor(material.DiffuseColor);
        ControlEmissiveColor->setColor(material.EmissiveColor);
        ControlSpecularColor->setColor(material.SpecularColor);
    }

    // Update all changed colors in the material
    void updateMaterialColors(video::SMaterial & material)
    {
        if ( ControlAmbientColor->isDirty() )
            material.AmbientColor = ControlAmbientColor->getColor();
        if ( ControlDiffuseColor->isDirty() )
            material.DiffuseColor = ControlDiffuseColor->getColor();
        if ( ControlEmissiveColor->isDirty() )
            material.EmissiveColor = ControlEmissiveColor->getColor();
        if ( ControlSpecularColor->isDirty() )
            material.SpecularColor = ControlSpecularColor->getColor();
    }

    // Set the color values to those from the light data
    void setColorsToLightDataColors(const video::SLight & lightData)
    {
        ControlAmbientColor->setColor(lightData.AmbientColor.toSColor());
        ControlAmbientColor->setColor(lightData.DiffuseColor.toSColor());
        ControlAmbientColor->setColor(lightData.SpecularColor.toSColor());
    }

    // Update all changed colors in the light data
    void updateLightColors(video::SLight & lightData)
    {
        if ( ControlAmbientColor->isDirty() )
            lightData.AmbientColor = video::SColorf( ControlAmbientColor->getColor() );
        if ( ControlDiffuseColor->isDirty() )
            lightData.DiffuseColor = video::SColorf( ControlDiffuseColor->getColor() );
        if ( ControlSpecularColor->isDirty() )
            lightData.SpecularColor = video::SColorf(ControlSpecularColor->getColor() );
    }

    // To reset the dirty flags
    void resetDirty()
    {
        ControlAmbientColor->resetDirty();
        ControlDiffuseColor->resetDirty();
        ControlSpecularColor->resetDirty();
        if ( ControlEmissiveColor )
            ControlEmissiveColor->resetDirty();
    }

protected:
    void createColorControls(gui::IGUIEnvironment* guiEnv, const core::position2d<s32> & pos, bool hasEmissive)
    {
        ControlAmbientColor = new CColorControl( guiEnv, pos, L"ambient", this);
        ControlDiffuseColor = new CColorControl( guiEnv, pos + core::position2d<s32>(0, 75), L"diffuse", this );
        ControlSpecularColor = new CColorControl( guiEnv, pos + core::position2d<s32>(0, 150), L"specular", this );
        if ( hasEmissive )
        {
            ControlEmissiveColor = new CColorControl( guiEnv, pos + core::position2d<s32>(0, 225), L"emissive", this );
        }
    }

private:
    CColorControl*  ControlAmbientColor;
    CColorControl*  ControlDiffuseColor;
    CColorControl*  ControlSpecularColor;
    CColorControl*  ControlEmissiveColor;
};

GUI-Control to offer a selection of available textures.

class CTextureControl : public gui::IGUIElement
{
public:
    CTextureControl(gui::IGUIEnvironment* guiEnv, video::IVideoDriver * driver, const core::position2d<s32> & pos, IGUIElement* parent, s32 id=-1)
    : gui::IGUIElement(gui::EGUIET_ELEMENT, guiEnv, parent,id, core::rect<s32>(pos,pos+core::dimension2d<s32>(100,15)))
    , DirtyFlag(true), ComboTexture(0)
    {
        core::rect<s32> rectCombo(0, 0, AbsoluteRect.getWidth(),AbsoluteRect.getHeight());
        ComboTexture = guiEnv->addComboBox (rectCombo, this);
        updateTextures(driver);
    }

    virtual bool OnEvent(const SEvent &event)
    {
        if ( event.EventType != EET_GUI_EVENT )
            return false;

        if ( event.GUIEvent.Caller == ComboTexture && event.GUIEvent.EventType == gui::EGET_COMBO_BOX_CHANGED )
        {
            DirtyFlag = true;
        }

        return false;
    }

    // Workaround for a problem with comboboxes.
    // We have to get in front when the combobox wants to get in front or combobox-list might be drawn below other elements.
    virtual bool bringToFront(IGUIElement* element)
    {
        bool result = gui::IGUIElement::bringToFront(element);
        if ( Parent && element == ComboTexture )
            result &= Parent->bringToFront(this);
        return result;
    }

    // return selected texturename (if any, otherwise 0)
    const wchar_t * getSelectedTextureName() const
    {
        s32 selected = ComboTexture->getSelected();
        if ( selected < 0 )
            return 0;
        return ComboTexture->getItem(selected);
    }

    // reset the dirty flag
    void resetDirty()
    {
        DirtyFlag = false;
    }

    // when the texture was changed the dirty flag is set
    bool isDirty() const
    {
        return DirtyFlag;
    };

    // Put the names of all currently loaded textures in a combobox
    void updateTextures(video::IVideoDriver * driver)
    {
        s32 oldSelected = ComboTexture->getSelected();
        s32 selectNew = -1;
        core::stringw oldTextureName;
        if ( oldSelected >= 0 )
        {
            oldTextureName = ComboTexture->getItem(oldSelected);
        }
        ComboTexture->clear();
        for ( u32 i=0; i < driver->getTextureCount(); ++i )
        {
            video::ITexture * texture = driver->getTextureByIndex(i);
            core::stringw name( texture->getName() );
            ComboTexture->addItem( name.c_str() );
            if ( !oldTextureName.empty() && selectNew < 0 && name == oldTextureName )
                selectNew = i;
        }

        // add another name which can be used to clear the texture
        ComboTexture->addItem( CLEAR_TEXTURE.c_str() );
        if ( CLEAR_TEXTURE == oldTextureName )
            selectNew = ComboTexture->getItemCount()-1;

        if ( selectNew >= 0 )
            ComboTexture->setSelected(selectNew);

        DirtyFlag = true;
    }

private:
    bool DirtyFlag;
    gui::IGUIComboBox * ComboTexture;
};

Control which allows setting some of the material values for a meshscenenode

struct SMeshNodeControl
{
    // constructor
    SMeshNodeControl()
        : Initialized(false), Driver(0), MeshManipulator(0), SceneNode(0), SceneNode2T(0), SceneNodeTangents(0)
        , AllColorsControl(0), ButtonLighting(0), InfoLighting(0), ComboMaterial(0), TextureControl1(0), TextureControl2(0), ControlVertexColors(0)
    {
    }

    // Destructor
    virtual ~SMeshNodeControl()
    {
        if ( TextureControl1 )
            TextureControl1->drop();
        if ( TextureControl2 )
            TextureControl2->drop();
        if ( ControlVertexColors )
            ControlVertexColors->drop();
        if ( AllColorsControl )
            AllColorsControl->drop();
    }

    void init(scene::IMeshSceneNode* node, IrrlichtDevice * device, const core::position2d<s32> & pos, const wchar_t * description)
    {
        if ( Initialized || !node || !device) // initializing twice or with invalid data not allowed
            return;

        Driver = device->getVideoDriver ();
        gui::IGUIEnvironment* guiEnv = device->getGUIEnvironment();
        scene::ISceneManager* smgr = device->getSceneManager();
        MeshManipulator = smgr->getMeshManipulator();

        SceneNode = node;
        scene::IMeshManipulator * meshManip = smgr->getMeshManipulator();

        scene::IMesh * mesh2T = meshManip->createMeshWith2TCoords(node->getMesh());
        SceneNode2T = smgr->addMeshSceneNode(mesh2T, 0, -1, SceneNode->getPosition(), SceneNode->getRotation(), SceneNode->getScale() );
        mesh2T->drop();

        scene::IMesh * meshTangents = meshManip->createMeshWithTangents(node->getMesh(), false, false, false);
        SceneNodeTangents = smgr->addMeshSceneNode(meshTangents, 0, -1
                                            , SceneNode->getPosition(), SceneNode->getRotation(), SceneNode->getScale() );
        meshTangents->drop();

        video::SMaterial & material = SceneNode->getMaterial(0);
        material.Lighting = true;
        AllColorsControl = new CAllColorsControl(guiEnv, pos, description, true, guiEnv->getRootGUIElement());
        AllColorsControl->setColorsToMaterialColors(material);

        core::rect<s32> rectBtn(pos + core::position2d<s32>(0, 320), core::dimension2d<s32>(60, 15));
        ButtonLighting = guiEnv->addButton (rectBtn, 0, -1, L"Lighting");
        ButtonLighting->setIsPushButton(true);
        ButtonLighting->setPressed(material.Lighting);
        core::rect<s32> rectInfo( rectBtn.LowerRightCorner.X, rectBtn.UpperLeftCorner.Y, rectBtn.LowerRightCorner.X+40, rectBtn.UpperLeftCorner.Y+15 );
        InfoLighting = guiEnv->addStaticText(L"", rectInfo, true, false );
        InfoLighting->setTextAlignment(gui::EGUIA_CENTER, gui::EGUIA_CENTER );

        core::rect<s32> rectCombo(pos.X, rectBtn.LowerRightCorner.Y, pos.X+100, rectBtn.LowerRightCorner.Y+15);
        ComboMaterial = guiEnv->addComboBox (rectCombo);
        for ( int i=0; i <= (int)video::EMT_ONETEXTURE_BLEND; ++i )
        {
            ComboMaterial->addItem( core::stringw(video::sBuiltInMaterialTypeNames[i]).c_str() );
        }
        ComboMaterial->setSelected( (s32)material.MaterialType );

        core::position2d<s32> posTex(rectCombo.UpperLeftCorner.X,rectCombo.LowerRightCorner.Y);
        TextureControl1 = new CTextureControl(guiEnv, Driver, posTex, guiEnv->getRootGUIElement());
        posTex.Y += 15;
        TextureControl2 = new CTextureControl(guiEnv, Driver, posTex, guiEnv->getRootGUIElement());

        core::position2d<s32> posVertexColors( posTex.X, posTex.Y + 15);
        ControlVertexColors = new CColorControl( guiEnv, posVertexColors, L"Vertex colors", guiEnv->getRootGUIElement());

        video::S3DVertex * vertices =  (video::S3DVertex *)node->getMesh()->getMeshBuffer(0)->getVertices();
        if ( vertices )
        {
            ControlVertexColors->setColor(vertices[0].Color);
        }

        Initialized = true;
    }

    void update()
    {
        if ( !Initialized )
            return;

        video::SMaterial & material = SceneNode->getMaterial(0);
        video::SMaterial & material2T = SceneNode2T->getMaterial(0);
        video::SMaterial & materialTangents = SceneNodeTangents->getMaterial(0);

        s32 selectedMaterial = ComboMaterial->getSelected();
        if ( selectedMaterial >= (s32)video::EMT_SOLID && selectedMaterial <= (s32)video::EMT_ONETEXTURE_BLEND)
        {
            video::E_VERTEX_TYPE vertexType = getVertexTypeForMaterialType((video::E_MATERIAL_TYPE)selectedMaterial);
            switch ( vertexType )
            {
                case video::EVT_STANDARD:
                    material.MaterialType = (video::E_MATERIAL_TYPE)selectedMaterial;
                    SceneNode->setVisible(true);
                    SceneNode2T->setVisible(false);
                    SceneNodeTangents->setVisible(false);
                    break;
                case video::EVT_2TCOORDS:
                    material2T.MaterialType = (video::E_MATERIAL_TYPE)selectedMaterial;
                    SceneNode->setVisible(false);
                    SceneNode2T->setVisible(true);
                    SceneNodeTangents->setVisible(false);
                    break;
                case video::EVT_TANGENTS:
                    materialTangents.MaterialType = (video::E_MATERIAL_TYPE)selectedMaterial;
                    SceneNode->setVisible(false);
                    SceneNode2T->setVisible(false);
                    SceneNodeTangents->setVisible(true);
                    break;
            }
        }

        updateMaterial(material);
        updateMaterial(material2T);
        updateMaterial(materialTangents);

        if ( ButtonLighting->isPressed() )
            InfoLighting->setText(L"on");
        else
            InfoLighting->setText(L"off");

        AllColorsControl->resetDirty();
        TextureControl1->resetDirty();
        TextureControl2->resetDirty();
        ControlVertexColors->resetDirty();
    }

    void updateTextures()
    {
        TextureControl1->updateTextures(Driver);
        TextureControl2->updateTextures(Driver);
    }

protected:

    void updateMaterial(video::SMaterial & material)
    {
        AllColorsControl->updateMaterialColors(material);
        material.Lighting = ButtonLighting->isPressed();
        if ( TextureControl1->isDirty() )
        {
            material.TextureLayer[0].Texture = Driver->getTexture( io::path(TextureControl1->getSelectedTextureName()) );
        }
        if ( TextureControl2->isDirty() )
        {
            material.TextureLayer[1].Texture = Driver->getTexture( io::path(TextureControl2->getSelectedTextureName()) );
        }
        if ( ControlVertexColors->isDirty() )
        {
            MeshManipulator->setVertexColors (SceneNode->getMesh(), ControlVertexColors->getColor());
            MeshManipulator->setVertexColors (SceneNode2T->getMesh(), ControlVertexColors->getColor());
            MeshManipulator->setVertexColors (SceneNodeTangents->getMesh(), ControlVertexColors->getColor());
        }
    }

    bool Initialized;
    video::IVideoDriver *       Driver;
    scene::IMeshManipulator*    MeshManipulator;
    scene::IMeshSceneNode*      SceneNode;
    scene::IMeshSceneNode*      SceneNode2T;
    scene::IMeshSceneNode*      SceneNodeTangents;
    CAllColorsControl*          AllColorsControl;
    gui::IGUIButton *           ButtonLighting;
    gui::IGUIStaticText*        InfoLighting;
    gui::IGUIComboBox *         ComboMaterial;
    CTextureControl*            TextureControl1;
    CTextureControl*            TextureControl2;
    CColorControl*              ControlVertexColors;
};

Control to allow setting the color values of a lightscenenode.

struct SLightNodeControl
{
    // constructor
    SLightNodeControl() : Initialized(false), SceneNode(0), AllColorsControl(0)
    {
    }

    virtual ~SLightNodeControl()
    {
        if ( AllColorsControl )
            AllColorsControl->drop();
    }

    void init(scene::ILightSceneNode* node, gui::IGUIEnvironment* guiEnv, const core::position2d<s32> & pos, const wchar_t * description)
    {
        if ( Initialized || !node || !guiEnv) // initializing twice or with invalid data not allowed
            return;
        SceneNode = node;
        AllColorsControl = new CAllColorsControl(guiEnv, pos, description, false, guiEnv->getRootGUIElement());
        const video::SLight & lightData = SceneNode->getLightData();
        AllColorsControl->setColorsToLightDataColors(lightData);
        Initialized = true;
    }

    void update()
    {
        if ( !Initialized )
            return;

        video::SLight & lightData = SceneNode->getLightData();
        AllColorsControl->updateLightColors(lightData);
    }

protected:
    bool Initialized;
    scene::ILightSceneNode* SceneNode;
    CAllColorsControl* AllColorsControl;
};

Application configuration

struct SConfig
{
    SConfig()
    : RenderInBackground(true)
    , DriverType(video::EDT_BURNINGSVIDEO)
    , ScreenSize(640, 480)
    {
    }

    bool RenderInBackground;
    video::E_DRIVER_TYPE DriverType;
    core::dimension2d<u32> ScreenSize;
};

Main application class

class CApp : public IEventReceiver
{
    friend int main(int argc, char *argv[]);

public:
    // constructor
    CApp()
    : IsRunning(false)
    , Device(0)
    , Camera(0)
    , GlobalAmbient(0)
    {
    }

    // destructor
    ~CApp()
    {
    }

    // stop running - will quit at end of mainloop
    void stopApp()
    {
        IsRunning = false;
    }

    // Event handler
    virtual bool OnEvent(const SEvent &event)
    {
        if (event.EventType == EET_GUI_EVENT)
        {
            gui::IGUIEnvironment* env = Device->getGUIEnvironment();

            switch(event.GUIEvent.EventType)
            {
                case gui::EGET_MENU_ITEM_SELECTED:
                {
                    gui::IGUIContextMenu* menu = (gui::IGUIContextMenu*)event.GUIEvent.Caller;
                    s32 id = menu->getItemCommandId(menu->getSelectedItem());

                    switch(id)
                    {
                        case GUI_ID_OPEN_TEXTURE: // File -> Open Texture
                            env->addFileOpenDialog(L"Please select a texture file to open");
                        break;
                        case GUI_ID_QUIT: // File -> Quit
                            stopApp();
                        break;
                    }
                }
                break;

                case gui::EGET_FILE_SELECTED:
                {
                    // load the model file, selected in the file open dialog
                    gui::IGUIFileOpenDialog* dialog =
                        (gui::IGUIFileOpenDialog*)event.GUIEvent.Caller;
                    loadTexture(io::path(dialog->getFileName()).c_str());
                }
                break;

                default:
                break;
            }
        }

        return false;
    }

protected:

    // Application initialization
    // returns true when it was successful initialized, otherwise false.
    bool init(int argc, char *argv[])
    {
        // ask user for driver
        Config.DriverType=driverChoiceConsole();
        if (Config.DriverType==video::EDT_COUNT)
            return false;

        // create the device with the settings from our config
        Device = createDevice(Config.DriverType, Config.ScreenSize);
        if (!Device)
            return false;
        Device->setWindowCaption( DriverTypeNames[Config.DriverType] );
        Device->setEventReceiver(this);

        scene::ISceneManager* smgr = Device->getSceneManager();
        video::IVideoDriver * driver = Device->getVideoDriver ();
        gui::IGUIEnvironment* guiEnv = Device->getGUIEnvironment();

        // set a nicer font
        gui::IGUISkin* skin = guiEnv->getSkin();
        gui::IGUIFont* font = guiEnv->getFont("../../media/fonthaettenschweiler.bmp");
        if (font)
            skin->setFont(font);

        // remove some alpha value because it makes those menus harder to read otherwise
        video::SColor col3dHighLight( skin->getColor(gui::EGDC_APP_WORKSPACE) );
        col3dHighLight.setAlpha(255);
        video::SColor colHighLight( col3dHighLight );
        skin->setColor(gui::EGDC_HIGH_LIGHT, colHighLight );
        skin->setColor(gui::EGDC_3D_HIGH_LIGHT, col3dHighLight );

        // Add some textures which are useful to test material settings
        createDefaultTextures(driver);

        // create a menu
        gui::IGUIContextMenu * menuBar = guiEnv->addMenu();
        menuBar->addItem(L"File", -1, true, true);

        gui::IGUIContextMenu* subMenuFile = menuBar->getSubMenu(0);
        subMenuFile->addItem(L"Open texture ...", GUI_ID_OPEN_TEXTURE);
        subMenuFile->addSeparator();
        subMenuFile->addItem(L"Quit", GUI_ID_QUIT);

        // a static camera
        Camera = smgr->addCameraSceneNode (0, core::vector3df(0, 0, 0),
                                            core::vector3df(0, 0, 100),
                                            -1);

        // add the nodes which are used to show the materials
        scene::IMeshSceneNode* nodeL = smgr->addCubeSceneNode (30.0f, 0, -1,
                                           core::vector3df(-35, 0, 100),
                                           core::vector3df(0, 0, 0),
                                           core::vector3df(1.0f, 1.0f, 1.0f));
        NodeLeft.init( nodeL, Device, core::position2d<s32>(10,20), L"left node" );

        scene::IMeshSceneNode* nodeR = smgr->addCubeSceneNode (30.0f, 0, -1,
                                           core::vector3df(35, 0, 100),
                                           core::vector3df(0, 0, 0),
                                           core::vector3df(1.0f, 1.0f, 1.0f));
        NodeRight.init( nodeR, Device, core::position2d<s32>(530,20), L"right node" );

        // add one light
        scene::ILightSceneNode* nodeLight = smgr->addLightSceneNode(0, core::vector3df(0, 0, 0),
                                                        video::SColorf(1.0f, 1.0f, 1.0f),
                                                        100.0f);
        LightControl.init(nodeLight, guiEnv, core::position2d<s32>(270,20), L"light" );

        // one large cube around everything. That's mainly to make the light more obvious.
        scene::IMeshSceneNode* backgroundCube = smgr->addCubeSceneNode (200.0f, 0, -1, core::vector3df(0, 0, 0),
                                           core::vector3df(45, 0, 0),
                                           core::vector3df(1.0f, 1.0f, 1.0f));
        backgroundCube->getMaterial(0).BackfaceCulling = false;         // we are within the cube, so we have to disable backface culling to see it
        backgroundCube->getMaterial(0).EmissiveColor.set(255,50,50,50); // we keep some self lighting to keep texts visible

        // set the ambient light value
        GlobalAmbient = new CColorControl( guiEnv, core::position2d<s32>(270, 300), L"global ambient", guiEnv->getRootGUIElement());
        GlobalAmbient->setColor( smgr->getAmbientLight().toSColor() );

        return true;
    }

    // Update one frame
    bool update()
    {
        using namespace irr;

        video::IVideoDriver* videoDriver =  Device->getVideoDriver();
        if ( !Device->run() )
            return false;

        if ( Device->isWindowActive() || Config.RenderInBackground )
        {
            gui::IGUIEnvironment* guiEnv = Device->getGUIEnvironment();
            scene::ISceneManager* smgr = Device->getSceneManager();
            gui::IGUISkin * skin = guiEnv->getSkin();

            // update our controls
            NodeLeft.update();
            NodeRight.update();
            LightControl.update();

            // update ambient light settings
            if ( GlobalAmbient->isDirty() )
            {
                smgr->setAmbientLight( GlobalAmbient->getColor() );
                GlobalAmbient->resetDirty();
            }

            // draw everything
            video::SColor bkColor( skin->getColor(gui::EGDC_APP_WORKSPACE) );
            videoDriver->beginScene(true, true, bkColor);

            smgr->drawAll();
            guiEnv->drawAll();

            videoDriver->endScene();
        }

        return true;
    }

    // Run the application. Our main loop.
    void run()
    {
        IsRunning = true;

        if ( !Device )
            return;

        // main application loop
        while(IsRunning)
        {
            if ( !update() )
                break;

            Device->sleep( 5 );
        }
    }

    // Close down the application
    void quit()
    {
        IsRunning = false;
        GlobalAmbient->drop();
        GlobalAmbient = NULL;
        if ( Device )
        {
            Device->closeDevice();
            Device->drop();
            Device = NULL;
        }
    }

    // Create some useful textures.
    // Note that the function put readability over speed, you shouldn't use setPixel at runtime but for initialization it's nice.
    void createDefaultTextures(video::IVideoDriver * driver)
    {
        const u32 width = 256;
        const u32 height = 256;
        video::IImage * imageA8R8G8B8 = driver->createImage (video::ECF_A8R8G8B8, core::dimension2d<u32>(width, height));
        if ( !imageA8R8G8B8 )
            return;
        const u32 pitch = imageA8R8G8B8->getPitch();

        // some nice square-pattern with 9 typical colors
        for ( u32 y = 0; y < height; ++ y )
        {
            for ( u32 x = 0; x < pitch; ++x )
            {
                if ( y < height/3 )
                {
                    if ( x < width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_BLACK);
                    else if ( x < 2*width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_BLUE);
                    else
                        imageA8R8G8B8->setPixel (x, y, SCOL_CYAN);
                }
                else if ( y < 2*height/3 )
                {
                    if ( x < width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_GRAY);
                    else if ( x < 2*width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_GREEN);
                    else
                        imageA8R8G8B8->setPixel (x, y, SCOL_MAGENTA);
                }
                else
                {
                    if ( x < width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_RED);
                    else if ( x < 2*width/3 )
                        imageA8R8G8B8->setPixel (x, y, SCOL_YELLOW);
                    else
                        imageA8R8G8B8->setPixel (x, y, SCOL_WHITE);
                }
            }
        }
        driver->addTexture (io::path("CARO_A8R8G8B8"), imageA8R8G8B8);

        // all white
        imageA8R8G8B8->fill(SCOL_WHITE);
        driver->addTexture (io::path("WHITE_A8R8G8B8"), imageA8R8G8B8);

        // all black
        imageA8R8G8B8->fill(SCOL_BLACK);
        driver->addTexture (io::path("BLACK_A8R8G8B8"), imageA8R8G8B8);

        // gray-scale
        for ( u32 y = 0; y < height; ++ y )
        {
            for ( u32 x = 0; x < pitch; ++x )
            {
                imageA8R8G8B8->setPixel (x, y, video::SColor(y, x,x,x) );
            }
        }
        driver->addTexture (io::path("GRAYSCALE_A8R8G8B8"), imageA8R8G8B8);

        imageA8R8G8B8->drop();
    }

    // Load a texture and make sure nodes know it when more textures are available.
    void loadTexture(const io::path &name)
    {
        Device->getVideoDriver()->getTexture(name);
        NodeLeft.updateTextures();
        NodeRight.updateTextures();
    }

private:
    SConfig                     Config;
    volatile bool               IsRunning;
    IrrlichtDevice *            Device;
    scene::ICameraSceneNode *   Camera;
    SMeshNodeControl            NodeLeft;
    SMeshNodeControl            NodeRight;
    SLightNodeControl           LightControl;
    CColorControl *             GlobalAmbient;
};

A very short main as we do everything else in classes.

int main(int argc, char *argv[])
{
    CApp APP;

    if ( !APP.init(argc, argv) )
    {
        printf("init failed\n");
        return 1;
    }

    APP.run();
    APP.quit();

    return 0;
}