ICursorControl.hpp

// Copyright (C) 2002-2012 Nikolaus Gebhardt
// This file is part of the "Irrlicht Engine".
// For conditions of distribution and use, see copyright notice in duckcpp/duckcpp.hpp
 
#ifndef DCPP_I_CURSOR_CONTROL_HPP_INCLUDED
#define DCPP_I_CURSOR_CONTROL_HPP_INCLUDED
 
#include <duckcpp/core/engine/IReferenceCounted.hpp>
#include <duckcpp/core/engine/position2d.hpp>
#include <duckcpp/core/engine/rect.hpp>
 
namespace dcpp
{
namespace gui
{
 
    class IGUISpriteBank;
 
    enum ECURSOR_ICON
    {
        // Following cursors might be system specific, or might use an Duckcpp icon-set. No guarantees so far.
        ECI_NORMAL, // arrow
        ECI_CROSS,  // Crosshair
        ECI_HAND,   // Hand
        ECI_HELP,   // Arrow and question mark
        ECI_IBEAM,  // typical text-selection cursor
        ECI_NO,     // should not click icon
        ECI_WAIT,   // hourclass
        ECI_SIZEALL,    // arrow in all directions
        ECI_SIZENESW,   // resizes in direction north-east or south-west
        ECI_SIZENWSE,   // resizes in direction north-west or south-east
        ECI_SIZENS, // resizes in direction north or south
        ECI_SIZEWE, // resizes in direction west or east
        ECI_UP,     // up-arrow
 
        // Implementer note: Should we add system specific cursors, which use guaranteed the system icons,
        // then I would recommend using a naming scheme like ECI_W32_CROSS, ECI_X11_CROSSHAIR and adding those
        // additionally.
 
        ECI_COUNT       // maximal of defined cursors. Note that higher values can be created at runtime
    };
 
    const dcpp::char_kt* const GUICursorIconNames[ECI_COUNT+1] =
    {
        "normal",
        "cross",
        "hand",
        "help",
        "ibeam",
        "no",
        "wait",
        "sizeall",
        "sizenesw",
        "sizenwse",
        "sizens",
        "sizewe",
        "sizeup",
        0
    };
 
    class SCursorSprite
    {
    public:
        SCursorSprite()
        : SpriteBank(0), SpriteId(-1)
        {
        }
 
        SCursorSprite( dcpp::gui::IGUISpriteBank * spriteBank, dcpp::int32_kt spriteId, const dcpp::nub::position2di &hotspot=(dcpp::nub::position2di(0,0)) )
        : SpriteBank(spriteBank), SpriteId(spriteId), HotSpot(hotspot)
        {
        }
 
    public:
        IGUISpriteBank * SpriteBank;
        dcpp::int32_kt SpriteId;
        dcpp::nub::position2di HotSpot;
    };
 
    enum ECURSOR_PLATFORM_BEHAVIOR
    {
        ECPB_NONE = 0,
 
 
        ECPB_X11_CACHE_UPDATES = 1
    };
 
    class ICursorControl : public virtual IReferenceCounted
    {
    public:
 
 
        virtual void setVisible(bool visible) = 0;
 
 
        virtual bool isVisible() const = 0;
 
 
        virtual void setPosition(const dcpp::nub::position2df &pos) = 0;
 
 
        virtual void setPosition(dcpp::float32_kt x, dcpp::float32_kt y) = 0;
 
 
        virtual void setPosition(const dcpp::nub::position2di &pos) = 0;
 
 
        virtual void setPosition(dcpp::int32_kt x, dcpp::int32_kt y) = 0;
 
 
        virtual const dcpp::nub::position2di& getPosition(bool updateCursor=true) = 0;
 
 
        virtual dcpp::nub::position2df getRelativePosition(bool updateCursor=true) = 0;
 
 
        virtual void setReferenceRect(dcpp::nub::recti* rect=0) = 0;
 
 
 
        virtual void setActiveIcon(ECURSOR_ICON iconId) {}
 
        virtual ECURSOR_ICON getActiveIcon() const { return dcpp::gui::ECI_NORMAL; }
 
 
        virtual ECURSOR_ICON addIcon(const dcpp::gui::SCursorSprite& icon) { return dcpp::gui::ECI_NORMAL; }
 
 
        virtual void changeIcon(ECURSOR_ICON iconId, const dcpp::gui::SCursorSprite& sprite) {}
 
        virtual dcpp::nub::dimension2di getSupportedIconSize() const { return dcpp::nub::dimension2di(0,0); }
 
        virtual void setPlatformBehavior(ECURSOR_PLATFORM_BEHAVIOR behavior) {}
 
 
        virtual ECURSOR_PLATFORM_BEHAVIOR getPlatformBehavior() const { return ECPB_NONE; }
    };
 
 
} // end namespace gui
} // end namespace dcpp
 
#endif