platform.h

robocup rcssserver 运行防真机器人足球比赛所用的服务器端

        /**
         * This method either adds a colour to the list of wanted colours (want==true)
         * or retrieves the allocated colour back to the ColourPair.
         * This is one method to make it easier to keep the code for wanting and retrieving in sync.
         */
        void WantFind(ColourPair &cp, bool want);

        void Allocate(Window &w);
};

/**
 * Font management.
 */
class Font {
protected:
        FontID id;
#if PLAT_WX
        int ascent;
#endif
        // Private so Font objects can not be copied
        Font(const Font &) {}
        Font &operator=(const Font &) { id=0; return *this; }
public:
        Font();
        virtual ~Font();

        virtual void Create(const char *faceName, int characterSet, int size,
                bool bold, bool italic, bool extraFontFlag=false);
        virtual void Release();

        FontID GetID() { return id; }
        // Alias another font - caller guarantees not to Release
        void SetID(FontID id_) { id = id_; }
        friend class Surface;
        friend class SurfaceImpl;
};

/**
 * A surface abstracts a place to draw.
 */
class Surface {
private:
        // Private so Surface objects can not be copied
        Surface(const Surface &) {}
        Surface &operator=(const Surface &) { return *this; }
public:
        Surface() {};
        virtual ~Surface() {};
        static Surface *Allocate();

        virtual void Init(WindowID wid)=0;
        virtual void Init(SurfaceID sid, WindowID wid)=0;
        virtual void InitPixMap(int width, int height, Surface *surface_, WindowID wid)=0;

        virtual void Release()=0;
        virtual bool Initialised()=0;
        virtual void PenColour(ColourAllocated fore)=0;
        virtual int LogPixelsY()=0;
        virtual int DeviceHeightFont(int points)=0;
        virtual void MoveTo(int x_, int y_)=0;
        virtual void LineTo(int x_, int y_)=0;
        virtual void Polygon(Point *pts, int npts, ColourAllocated fore, ColourAllocated back)=0;
        virtual void RectangleDraw(PRectangle rc, ColourAllocated fore, ColourAllocated back)=0;
        virtual void FillRectangle(PRectangle rc, ColourAllocated back)=0;
        virtual void FillRectangle(PRectangle rc, Surface &surfacePattern)=0;
        virtual void RoundedRectangle(PRectangle rc, ColourAllocated fore, ColourAllocated back)=0;
        virtual void AlphaRectangle(PRectangle rc, int cornerSize, ColourAllocated fill, int alphaFill,
                ColourAllocated outline, int alphaOutline, int flags)=0;
        virtual void Ellipse(PRectangle rc, ColourAllocated fore, ColourAllocated back)=0;
        virtual void Copy(PRectangle rc, Point from, Surface &surfaceSource)=0;

        virtual void DrawTextNoClip(PRectangle rc, Font &font_, int ybase, const char *s, int len, ColourAllocated fore, ColourAllocated back)=0;
        virtual void DrawTextClipped(PRectangle rc, Font &font_, int ybase, const char *s, int len, ColourAllocated fore, ColourAllocated back)=0;
        virtual void DrawTextTransparent(PRectangle rc, Font &font_, int ybase, const char *s, int len, ColourAllocated fore)=0;
        virtual void MeasureWidths(Font &font_, const char *s, int len, int *positions)=0;
        virtual int WidthText(Font &font_, const char *s, int len)=0;
        virtual int WidthChar(Font &font_, char ch)=0;
        virtual int Ascent(Font &font_)=0;
        virtual int Descent(Font &font_)=0;
        virtual int InternalLeading(Font &font_)=0;
        virtual int ExternalLeading(Font &font_)=0;
        virtual int Height(Font &font_)=0;
        virtual int AverageCharWidth(Font &font_)=0;

        virtual int SetPalette(Palette *pal, bool inBackGround)=0;
        virtual void SetClip(PRectangle rc)=0;
        virtual void FlushCachedState()=0;

        virtual void SetUnicodeMode(bool unicodeMode_)=0;
        virtual void SetDBCSMode(int codePage)=0;
};

/**
 * A simple callback action passing one piece of untyped user data.
 */
typedef void (*CallBackAction)(void*);

/**
 * Class to hide the details of window manipulation.
 * Does not own the window which will normally have a longer life than this object.
 */
class Window {
protected:
        WindowID id;
public:
        Window() : id(0), cursorLast(cursorInvalid) {}
        Window(const Window &source) : id(source.id), cursorLast(cursorInvalid) {}
        virtual ~Window();
        Window &operator=(WindowID id_) {
                id = id_;
                return *this;
        }
        WindowID GetID() const { return id; }
        bool Created() const { return id != 0; }
        void Destroy();
        bool HasFocus();
        PRectangle GetPosition();
        void SetPosition(PRectangle rc);
        void SetPositionRelative(PRectangle rc, Window relativeTo);
        PRectangle GetClientPosition();
        void Show(bool show=true);
        void InvalidateAll();
        void InvalidateRectangle(PRectangle rc);
        virtual void SetFont(Font &font);
        enum Cursor { cursorInvalid, cursorText, cursorArrow, cursorUp, cursorWait, cursorHoriz, cursorVert, cursorReverseArrow, cursorHand };
        void SetCursor(Cursor curs);
        void SetTitle(const char *s);
private:
        Cursor cursorLast;
};

/**
 * Listbox management.
 */

class ListBox : public Window {
public:
        ListBox();
        virtual ~ListBox();
        static ListBox *Allocate();

        virtual void SetFont(Font &font)=0;
        virtual void Create(Window &parent, int ctrlID, Point location, int lineHeight_, bool unicodeMode_)=0;
        virtual void SetAverageCharWidth(int width)=0;
        virtual void SetVisibleRows(int rows)=0;
        virtual int GetVisibleRows() const=0;
        virtual PRectangle GetDesiredRect()=0;
        virtual int CaretFromEdge()=0;
        virtual void Clear()=0;
        virtual void Append(char *s, int type = -1)=0;
        virtual int Length()=0;
        virtual void Select(int n)=0;
        virtual int GetSelection()=0;
        virtual int Find(const char *prefix)=0;
        virtual void GetValue(int n, char *value, int len)=0;
        virtual void RegisterImage(int type, const char *xpm_data)=0;
        virtual void ClearRegisteredImages()=0;
        virtual void SetDoubleClickAction(CallBackAction, void *)=0;
        virtual void SetList(const char* list, char separator, char typesep)=0;
};

/**
 * Menu management.
 */
class Menu {
        MenuID id;
public:
        Menu();
        MenuID GetID() { return id; }
        void CreatePopUp();
        void Destroy();
        void Show(Point pt, Window &w);
};

class ElapsedTime {
        long bigBit;
        long littleBit;
public:
        ElapsedTime();
        double Duration(bool reset=false);
};

/**
 * Dynamic Library (DLL/SO/...) loading
 */
class DynamicLibrary {
public:
        virtual ~DynamicLibrary() {};

        /// @return Pointer to function "name", or NULL on failure.
        virtual Function FindFunction(const char *name) = 0;

        /// @return true if the library was loaded successfully.
        virtual bool IsValid() = 0;

        /// @return An instance of a DynamicLibrary subclass with "modulePath" loaded.
        static DynamicLibrary *Load(const char *modulePath);
};

/**
 * Platform class used to retrieve system wide parameters such as double click speed
 * and chrome colour. Not a creatable object, more of a module with several functions.
 */
class Platform {
        // Private so Platform objects can not be copied
        Platform(const Platform &) {}
        Platform &operator=(const Platform &) { return *this; }
public:
        // Should be private because no new Platforms are ever created
        // but gcc warns about this
        Platform() {}
        ~Platform() {}
        static ColourDesired Chrome();
        static ColourDesired ChromeHighlight();
        static const char *DefaultFont();
        static int DefaultFontSize();
        static unsigned int DoubleClickTime();
        static bool MouseButtonBounce();
        static void DebugDisplay(const char *s);
        static bool IsKeyDown(int key);
        static long SendScintilla(
                WindowID w, unsigned int msg, unsigned long wParam=0, long lParam=0);
        static long SendScintillaPointer(
                WindowID w, unsigned int msg, unsigned long wParam=0, void *lParam=0);
        static bool IsDBCSLeadByte(int codePage, char ch);
        static int DBCSCharLength(int codePage, const char *s);
        static int DBCSCharMaxLength();

        // These are utility functions not really tied to a platform
        static int Minimum(int a, int b);
        static int Maximum(int a, int b);
        // Next three assume 16 bit shorts and 32 bit longs
        static long LongFromTwoShorts(short a,short b) {
                return (a) | ((b) << 16);
        }
        static short HighShortFromLong(long x) {
                return static_cast<short>(x >> 16);
        }
        static short LowShortFromLong(long x) {
                return static_cast<short>(x & 0xffff);
        }
        static void DebugPrintf(const char *format, ...);
        static bool ShowAssertionPopUps(bool assertionPopUps_);
        static void Assert(const char *c, const char *file, int line);
        static int Clamp(int val, int minVal, int maxVal);
};

#ifdef  NDEBUG
#define PLATFORM_ASSERT(c) ((void)0)
#else
#define PLATFORM_ASSERT(c) ((c) ? (void)(0) : Platform::Assert(#c, __FILE__, __LINE__))
#endif

// Shut up annoying Visual C++ warnings:
#ifdef _MSC_VER
#pragma warning(disable: 4244 4309 4514 4710)
#endif

#endif