curses 1.6.0 → 1.7.0

data/vendor/PDCursesMod/sdl2/Makefile

@@ -0,0 +1,207 @@
+# GNU MAKE Makefile for PDCurses for SDL2
+#
+# Usage: [g]make [DEBUG=Y] [WIDE=Y] [UTF8=Y] [LIBNAME=(name)]
+#                [DLLNAME=(name)] [target]
+#
+# where target can be any of:
+# [all|demos|libpdcurses.a|testcurs]...
+
+O = o
+
+ifndef PDCURSES_SRCDIR
+	PDCURSES_SRCDIR	= ..
+endif
+
+osdir		= $(PDCURSES_SRCDIR)/sdl2
+common		= $(PDCURSES_SRCDIR)/common
+
+include $(common)/libobjs.mif
+
+ifdef _w32
+	PREFIX = i686-w64-mingw32
+	E = .exe
+endif
+
+ifdef _w64
+	PREFIX = x86_64-w64-mingw32
+	E = .exe
+endif
+
+ifdef _a64
+	PREFIX = aarch64-w64-mingw32
+	E = .exe
+endif
+
+ifeq ($(OS),Windows_NT)
+	E = .exe
+	RM = cmd /c del
+
+	include $(osdir)/versions.mif
+
+	PLATFORM = $(shell $(CC) -dumpmachine)
+
+	SFLAGS = -I$(SDLBASE)/$(PLATFORM)/include/SDL2
+	SLIBS = -L$(SDLBASE)/$(PLATFORM)/lib -lSDL2main -lSDL2
+
+	TFLAGS = -I$(TTFBASE)/$(PLATFORM)/include/SDL2
+	TLIBS = -L$(TTFBASE)/$(PLATFORM)/lib -lSDL2_ttf
+
+	DEMOFLAGS = -mwindows
+else
+	RM = rm -f
+
+	SFLAGS = $(shell sdl2-config --cflags)
+	SLIBS = $(shell sdl2-config --libs)
+
+	TFLAGS = -I$(TTFBASE)/$(PREFIX)/include/SDL2
+	TLIBS = -L$(TTFBASE)/$(PREFIX)/lib -lSDL2_ttf
+endif
+
+CC		= $(PREFIX)-gcc
+WINDRES		= windres
+
+PDCURSES_SDL_H	= $(osdir)/pdcsdl.h
+
+CFLAGS  = -Wall -Wextra -Werror -pedantic -fPIC
+ifeq ($(DEBUG),Y)
+	CFLAGS  += -g -DPDCDEBUG
+else
+	CFLAGS  += -O2
+endif
+
+ifeq ($(WIDE),Y)
+	CFLAGS += -DPDC_WIDE
+	SFLAGS += $(TFLAGS)
+	SLIBS  += $(TLIBS)
+endif
+
+ifeq ($(UTF8),Y)
+	CFLAGS += -DPDC_FORCE_UTF8
+	ifneq ($(WIDE),Y)
+		SFLAGS += $(TFLAGS)
+		SLIBS  += $(TLIBS)
+	endif
+endif
+
+ifdef CHTYPE_32
+	CFLAGS += -DCHTYPE_32
+endif
+
+ifdef CHTYPE_16
+	CFLAGS += -DCHTYPE_16
+endif
+
+LIBNAME=pdcurses
+DLLNAME=pdcurses
+
+ifeq ($(DLL),Y)
+	ifeq ($(OS),Windows_NT)
+		CFLAGS += -DPDC_DLL_BUILD
+		LIBEXE = $(CC)
+		LIBFLAGS = -Wl,--out-implib,lib$(LIBNAME).a -shared -o
+		LIBCURSES = $(DLLNAME).dll
+		CLEAN = $(LIBCURSES) *.a
+		RESOURCE = pdcurses.o
+		LIBLIBS = $(SLIBS)
+		LDFLAGS = $(LIBCURSES)
+	else
+		ifeq ($(shell uname -s),Darwin)
+			DLL_SUFFIX = .dylib
+		else
+			DLL_SUFFIX = .so
+		endif
+		LIBEXE = $(CC)
+		LIBFLAGS = -shared -o
+		LIBCURSES = lib$(DLLNAME)$(DLL_SUFFIX)
+		LIBLIBS = $(SLIBS)
+		LDFLAGS = $(LIBCURSES)
+		CLEAN = *$(DLL_SUFFIX)
+	endif
+else
+	LIBEXE = $(PREFIX)-$(AR)
+	LIBFLAGS = rcv
+	LIBCURSES = lib$(LIBNAME).a
+	LDFLAGS = $(LIBCURSES) $(SLIBS)
+	CLEAN = *.a
+endif
+
+BUILD		= $(CC) $(CFLAGS) -I$(PDCURSES_SRCDIR)
+
+LINK		= $(CC)
+
+DEMOS		+= sdltest$(E)
+
+.PHONY: all libs clean demos tests
+
+all:	libs
+
+libs:	$(LIBCURSES)
+
+clean:
+	-$(RM) *.o trace $(CLEAN) $(DEMOS) $(TESTS) vt0$(E)
+
+demos:	$(DEMOS)
+ifneq ($(DEBUG),Y)
+	$(PREFIX)-strip $(DEMOS)
+endif
+
+tests:	$(TESTS)
+ifneq ($(DEBUG),Y)
+	$(PREFIX)-strip $(TESTS)
+endif
+
+install:
+ifneq ($(OS),Windows_NT)
+	cp lib$(DLLNAME).so /usr/local/lib
+	ldconfig /usr/local/lib
+endif
+
+uninstall:
+ifneq ($(OS),Windows_NT)
+	$(RM) /usr/local/lib/lib$(DLLNAME).so
+	ldconfig /usr/local/lib
+endif
+
+$(LIBCURSES) : $(LIBOBJS) $(PDCOBJS) $(RESOURCE)
+	$(LIBEXE) $(LIBFLAGS) $@ $? $(LIBLIBS)
+
+pdcurses.o: $(common)/pdcurses.rc
+	$(WINDRES) -i $(common)/pdcurses.rc pdcurses.o
+
+$(LIBOBJS) $(PDCOBJS) : $(PDCURSES_HEADERS)
+$(PDCOBJS) : $(PDCURSES_SDL_H)
+$(DEMOS) : $(PDCURSES_CURSES_H) $(LIBCURSES)
+$(TESTS) : $(PDCURSES_CURSES_H) $(LIBCURSES)
+vt0$(E)  : $(PDCURSES_CURSES_H) $(LIBCURSES)
+tui.o tuidemo.o : $(PDCURSES_CURSES_H)
+terminfo.o : $(TERM_HEADER)
+panel.o ptest$(E) test_pan$(E): $(PANEL_HEADER)
+
+$(LIBOBJS) : %.o: $(srcdir)/%.c
+	$(BUILD) -c $<
+
+$(PDCOBJS) : %.o: $(osdir)/%.c
+	$(BUILD) $(SFLAGS) -c $<
+
+$(TESTS): %: $(testdir)/%.c
+	$(BUILD) $(DEMOFLAGS) -o$@ $< $(LDFLAGS)
+
+$(DEMOS_EXCEPT_TUIDEMO): %: $(demodir)/%.c
+	$(BUILD) $(DEMOFLAGS) -o$@ $< $(LDFLAGS)
+
+vt0$(E): %: $(testdir)/%.c
+	$(BUILD) $(DEMOFLAGS) -o$@ $< $(LDFLAGS)
+
+tuidemo$(E): tuidemo.o tui.o
+	$(LINK) tui.o tuidemo.o -o $@ $(LDFLAGS)
+
+sdltest$(E): $(osdir)/sdltest.c
+	$(BUILD) $(SFLAGS) $(DEMOFLAGS) -o $@ $< $(LIBCURSES) $(SLIBS)
+
+tui.o: $(demodir)/tui.c $(demodir)/tui.h
+	$(BUILD) -c $(DEMOFLAGS) $(demodir)/tui.c
+
+tuidemo.o: $(demodir)/tuidemo.c
+	$(BUILD) -c $(DEMOFLAGS) $(demodir)/tuidemo.c
+
+include $(demodir)/nctests.mif

data/vendor/PDCursesMod/sdl2/Makefile.vc

@@ -0,0 +1,132 @@
+# Visual C++ Makefile for PDCurses - SDL2
+#
+# Usage: nmake -f [path\]Makefile.vc [DEBUG=Y] [DLL=Y] [WIDE=Y] [UTF8=Y]
+#                   [target]
+#
+# where target can be any of:
+# [all|demos|pdcurses.lib|testcurs.exe...]
+
+O = obj
+E = .exe
+RM = del
+
+!ifndef PDCURSES_SRCDIR
+PDCURSES_SRCDIR = ..
+!endif
+
+osdir		= $(PDCURSES_SRCDIR)\sdl2
+common		= $(PDCURSES_SRCDIR)\common
+
+!include $(common)\libobjs.mif
+!include $(osdir)\versions.mif
+
+SDL2_INCLUDE = -I$(SDLBASE)\include
+SDL2_LIB = $(SDLBASE)\lib\$(PLATFORM)\SDL2.lib
+SDL2_LIBMAIN = $(SDLBASE)\lib\$(PLATFORM)\SDL2main.lib
+
+PDCURSES_WIN_H	= $(osdir)\pdcsdl.h
+
+CC		= cl.exe -nologo
+
+!ifndef PLATFORM
+PLATFORM 	= $(VSCMD_ARG_TGT_ARCH)
+!endif
+
+!ifdef DEBUG
+CFLAGS		= -Z7 -W4 -DPDCDEBUG -D_CRT_SECURE_NO_DEPRECATE
+LDFLAGS		= -debug -pdb:none
+!else
+CFLAGS		= -Ox -W4 -D_CRT_SECURE_NO_DEPRECATE
+LDFLAGS		=
+!endif
+
+!ifdef WIDE
+WIDEOPT		= -DPDC_WIDE
+!endif
+
+!ifdef UTF8
+WIDEOPT		= -DPDC_FORCE_UTF8
+!endif
+
+!ifdef WIDEOPT
+TTF_INCLUDE	= -I$(TTFBASE)\include
+TTF_LIB		= $(TTFBASE)\lib\$(PLATFORM)\SDL2_ttf.lib
+!endif
+
+SHL_LD = link $(LDFLAGS) -nologo -dll -machine:$(PLATFORM) -out:pdcurses.dll
+
+LINK		= link.exe -nologo -subsystem:windows
+
+LIBEXE		= lib -nologo
+
+LIBCURSES	= pdcurses.lib
+CURSESDLL	= pdcurses.dll
+
+!ifdef DLL
+DLLOPT		= -DPDC_DLL_BUILD
+PDCLIBS		= $(CURSESDLL)
+LIBLIBS		= $(SDL2_LIB) $(TTF_LIB)
+CCLIBS		= $(SDL2_LIBMAIN) $(SDL2_LIB) shell32.lib
+!else
+PDCLIBS		= $(LIBCURSES)
+CCLIBS		= $(SDL2_LIBMAIN) $(SDL2_LIB) $(TTF_LIB) shell32.lib
+!endif
+
+BUILD		= $(CC) -I$(PDCURSES_SRCDIR) \
+-c $(CFLAGS) $(DLLOPT) $(WIDEOPT) $(INFOPT)
+
+all:	$(PDCLIBS)
+
+clean:
+	-$(RM) *.obj
+	-$(RM) $(LIBCURSES)
+	-$(RM) *.exe
+	-$(RM) $(CURSESDLL)
+	-$(RM) *.exp
+	-$(RM) pdcurses.res
+
+demos:	$(PDCLIBS) $(DEMOS) sdltest.exe
+
+DEMOOBJS = $(DEMOS:.exe=.obj) tui.obj sdltest.obj
+
+$(LIBOBJS) $(PDCOBJS) : $(PDCURSES_HEADERS)
+$(PDCOBJS) : $(PDCURSES_WIN_H)
+$(DEMOOBJS) : $(PDCURSES_CURSES_H)
+$(DEMOS) : $(LIBCURSES)
+panel.obj : $(PANEL_HEADER)
+
+!ifndef DLL
+$(LIBCURSES) : $(LIBOBJS) $(PDCOBJS)
+	$(LIBEXE) -out:$@ $(LIBOBJS) $(PDCOBJS)
+!endif
+
+$(CURSESDLL) : $(LIBOBJS) $(PDCOBJS) pdcurses.obj
+	$(SHL_LD) $(LIBOBJS) $(PDCOBJS) pdcurses.obj $(LIBLIBS)
+
+pdcurses.res pdcurses.obj: $(common)\pdcurses.rc
+	rc -r -fopdcurses.res $(common)\pdcurses.rc
+	cvtres -machine:$(PLATFORM) -nologo -out:pdcurses.obj pdcurses.res
+
+{$(srcdir)\}.c{}.obj::
+	$(BUILD) $<
+
+{$(osdir)\}.c{}.obj::
+	$(BUILD) -Dmain=SDL_main $(SDL2_INCLUDE) $(TTF_INCLUDE) $<
+
+{$(demodir)\}.c{}.obj::
+	$(BUILD) -Dmain=SDL_main $<
+
+.obj.exe:
+	$(LINK) $(LDFLAGS) $< $(LIBCURSES) $(CCLIBS)
+
+tuidemo.exe: tuidemo.obj tui.obj pdcurses.lib
+	$(LINK) $(LDFLAGS) $*.obj tui.obj $(LIBCURSES) $(CCLIBS)
+
+tui.obj: $(demodir)\tui.c $(demodir)\tui.h
+	$(BUILD) -I$(demodir) $(demodir)\tui.c
+
+tuidemo.obj: $(demodir)\tuidemo.c
+	$(BUILD) -Dmain=SDL_main -I$(demodir) $(demodir)\tuidemo.c
+
+sdltest.exe: sdltest.obj pdcurses.obj pdcurses.lib
+	$(LINK) $(LDFLAGS) $*.obj $(LIBCURSES) $(LIBLIBS) $(CCLIBS)

data/vendor/PDCursesMod/sdl2/README.md

@@ -0,0 +1,215 @@
+PDCurses for SDL 2.x
+====================
+
+This is a port of PDCurses for version 2.x of SDL (aka SDL2).
+
+
+Building
+--------
+
+- On *nix (including Linux and Mac OS X), run "make" in the sdl2
+  directory. There is no configure script (yet?) for this port. This
+  assumes a working sdl-config, and GNU make. It builds the library
+  pdcurses.a (or pdcurses.so/pdcurses.dylib with DLL=Y).
+
+- With MinGW, edit the Makefile to point to the appropriate include and
+  library paths, and then run "mingw32-make".
+
+- With MSVC, edit Makefile.vc if needed, and do "nmake -f Makefile.vc".
+
+- The makefile recognizes the optional PDCURSES_SRCDIR environment
+  variable, and the option "DEBUG=Y", as with the console ports.
+  "WIDE=Y" builds a version that not only uses 32-bit Unicode
+  characters, but depends on the SDL2_ttf library, instead of using
+  simple bitmap fonts. "UTF8=Y" makes PDCurses ignore the system locale,
+  and treat all narrow-character strings as UTF-8; this option has no
+  effect unless WIDE=Y is also set. You can specify "DLL=Y" to build a dynamic
+  rather than static library. The dynamic library is called pdcurses.dll,
+  pdcurses.so, or pdcurses.dylib on Windows, Linux, or Mac OS X respectively.
+  And on all platforms, add the target "demos" to build the sample programs.
+
+
+Usage
+-----
+
+There are no special requirements to use PDCurses for SDL -- all
+PDCurses-compatible code should work fine. Nothing extra is needed
+beyond the base SDL library. However, there are some optional special
+features, described here.
+
+The SDL ports operate in one of two ways, depending on whether or not
+they were built with WIDE=Y:
+
+
+### 8-bit mode
+
+The font is a simple BMP, 32 characters wide by 8 characters tall,
+preferably with a palette. (BMPs without palettes still work, but in
+that case, no attributes will be available, nor will the cursor work.)
+The first entry in the palette (usually black) is treated as the
+background color; the last entry (usually white) is treated as the
+foreground. These are changed or made transparent as appropriate; any
+other colors in the palette are passed through unchanged. So -- although
+a one-bit depth is sufficient for a normal font -- you could redraw some
+characters as multi-colored tiles.
+
+The font must be monospaced. The size of each character is derived by
+dividing the width of the BMP by 32 and the height by 8. There is no
+constraint on the dimensions.
+
+As provided in the default font and expected by acs_map[], the font is
+in Code Page 437 form. But you can of course use any layout if you're
+not relying on correct values for the ACS_* macros.
+
+The font can be set via the environment variable PDC_FONT. If it's not
+set, PDCurses looks for a file named "pdcfont.bmp" in the current
+directory at the time of initscr(). If neither is found, it uses the
+built-in default font encoded in font437.h.
+
+
+### 32-bit mode
+
+Instead of a BMP, PDC_FONT points to a TrueType font. Only true
+monospaced fonts work well. The font can be set at compile time via
+PDC_FONT_PATH, and/or at runtime via pdc_ttffont. The environment
+variable PDC_FONT_SIZE is also available to control the font size (also
+as a compile-time define, and at runtime as pdc_font_size.) The
+character mapping for chtypes is UTF-32. However, with SDL2_ttf versions
+older than 2.0.18, only the Basic Multilingual Plane characters are
+available.
+
+
+The default font (if not redefined) is based on the OS:
+
+- Windows: C:/Windows/Fonts/consola.ttf
+
+- Mac: /Library/Fonts/Menlo.ttc
+
+- Other: /usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf
+
+
+Backgrounds
+-----------
+
+PDCurses for SDL supports an optional background image BMP. This is used
+whenever start_color() has not been called (see the ptest demo for an
+example), or when use_default_colors() has been called after
+start_color(), and the background color of a pair has been set to -1
+(see ozdemo, worm, and rain for examples). The usage parallels that of
+ncurses in an appropriate terminal (e.g., Gnome Terminal). The image is
+tiled to cover the PDCurses window, and can be any size or depth.
+
+As with the font, you can point to a location for the background via the
+environment variable PDC_BACKGROUND; "pdcback.bmp" is the fallback.
+(There is no default background.)
+
+
+Icons
+-----
+
+The icon (used with SDL_SetWindowIcon() -- not used for the executable
+file) can be set via the environment variable PDC_ICON, and falls back
+to "pdcicon.bmp", and then to the built-in icon from iconbmp.h. The
+built-in icon is the PDCurses logo, as seen in ../common/icon32.xpm.
+
+If pdc_screen is preinitialized (see below), PDCurses does not attempt
+to set the icon.
+
+
+Screen size
+-----------
+
+The default screen size is 80x25 characters (whatever size they may be),
+but you can override this via the environment variables PDC_COLS and/or
+PDC_LINES. If pdc_screen is preinitialized (see below), these are
+ignored.
+
+
+Integration with SDL
+--------------------
+
+If you want to go further, you can mix PDCurses and SDL functions. (Of
+course this is extremely non-portable!) To aid you, there are several
+external variables and functions specific to the SDL ports; you could
+include pdcsdl.h, or just add the declarations you need in your code:
+
+    PDCEX SDL_Window *pdc_window;
+    PDCEX SDL_Surface *pdc_screen, *pdc_font, *pdc_icon, *pdc_back;
+    PDCEX int pdc_sheight, pdc_swidth, pdc_yoffset, pdc_xoffset, pdc_sdl_render_mode;
+
+    PDCEX void PDC_update_rects(void);
+    PDCEX void PDC_retile(void);
+
+pdc_window is the main window, created by SDL_CreateWindow(), unless
+it's preset before initscr(); and pdc_screen is the main surface, set by
+SDL_GetWindowSurface(pdc_window). (See sdltest.c for examples.) You can
+perform normal SDL operations on this surface, but PDCurses won't
+respect them when it updates. (For that, see PDC_retile().) As an
+alternative, you can preinitialize this surface before calling
+initscr(). In that case, you can use pdc_sheight, pdc_swidth,
+pdc_yoffset and/or pdc_xoffset (q.v.) to confine PDCurses to only a
+specific area of the surface, reserving the rest for other SDL
+operations. If you preinitialize pdc_window, you'll have to close it
+yourself; PDCurses will ignore resize events, and won't try to set the
+icon. Also note that if you preinitialize pdc_screen, it need not be the
+display surface.
+
+pdc_font (in 8-bit mode), pdc_icon, and pdc_back are the SDL_surfaces
+for the font, icon, and background, respectively. You can set any or all
+of them before initscr(), and thus override any of the other ways to set
+them. But note that pdc_icon will be ignored if pdc_screen is preset.
+
+pdc_sdl_render_mode (in 32-bit mode) can be set to `PDC_SDL_RENDER_SOLID`, 
+`PDC_SDL_RENDER_SHADED` or `PDC_SDL_RENDER_BLENDED`. This determines which SDL TTF
+render mode will be used for rendering text: `TTF_RenderGlyph32_Solid()`,
+`TTF_RenderGlyph32_Shaded()` or `TTF_RenderGlyph32_Blended()` respectively.
+This will default to `PDC_SDL_RENDER_BLENDED`. If you wish to use this feature 
+without including `pdcsdl.h`, you must define the following constants:
+
+```
+#define PDC_SDL_RENDER_SOLID 1
+#define PDC_SDL_RENDER_SHADED 2
+#define PDC_SDL_RENDER_BLENDED 3
+```
+
+pdc_sheight and pdc_swidth are the dimensions of the area of pdc_screen
+to be used by PDCurses. You can preset them before initscr(); if either
+is not set, it defaults to the full screen size minus the x or y offset,
+as appropriate.
+
+pdc_xoffset and pdc_yoffset are the x and y offset for the area of
+pdc_screen to be used by PDCurses. See the sdltest demo for an example.
+
+PDC_retile() makes a copy of pdc_screen, then tiles it with the
+background image, if any. The resulting surface is used as the
+background for transparent character cells. PDC_retile() is called from
+initscr() and resize_term(). However, you can also use it at other
+times, to take advantage of the way it copies pdc_screen: Draw some SDL
+stuff; call PDC_retile(); do some curses stuff -- it will use whatever
+was on pdc_screen as the background. Then you can erase the curses
+screen, do some more SDL stuff, and call PDC_retile() again to make a
+new background. (If you don't erase the curses screen, it will be
+incorporated into the background when you call PDC_retile().) But this
+only works if no background image is set.
+
+
+Interaction with stdio
+----------------------
+
+As with X11, it's a bad idea to mix curses and stdio calls. (In fact,
+that's true for PDCurses on any platform; but especially these two,
+which don't run under terminals.) Depending on how SDL is built, stdout
+and stderr may be redirected to files.
+
+
+Distribution Status
+-------------------
+
+The files in this directory are released to the public domain.
+
+
+Acknowledgements
+----------------
+
+Original SDL port was provided by William McBrine
+SDL2 modifications by Laura Michaels and Robin Gustafsson

data/vendor/PDCursesMod/sdl2/pdcclip.c

@@ -0,0 +1,93 @@
+/* PDCurses */
+
+#include "pdcsdl.h"
+
+#include <stdlib.h>
+#include <string.h>
+
+/*man-start**************************************************************
+
+clipboard
+---------
+
+### Synopsis
+
+    int PDC_getclipboard(char **contents, long *length);
+    int PDC_setclipboard(const char *contents, long length);
+    int PDC_freeclipboard(char *contents);
+    int PDC_clearclipboard(void);
+
+### Description
+
+   PDC_getclipboard() gets the textual contents of the system's
+   clipboard. This function returns the contents of the clipboard in the
+   contents argument. It is the responsibility of the caller to free the
+   memory returned, via PDC_freeclipboard(). The length of the clipboard
+   contents is returned in the length argument.
+
+   PDC_setclipboard() copies the supplied text into the system's
+   clipboard, emptying the clipboard prior to the copy.
+
+   PDC_clearclipboard() clears the internal clipboard.
+
+### Return Values
+
+   indicator of success/failure of call.
+   PDC_CLIP_SUCCESS        the call was successful
+   PDC_CLIP_MEMORY_ERROR   unable to allocate sufficient memory for
+                           the clipboard contents
+   PDC_CLIP_EMPTY          the clipboard contains no text
+   PDC_CLIP_ACCESS_ERROR   no clipboard support
+
+### Portability
+                             X/Open  ncurses  NetBSD
+    PDC_getclipboard            -       -       -
+    PDC_setclipboard            -       -       -
+    PDC_freeclipboard           -       -       -
+    PDC_clearclipboard          -       -       -
+
+**man-end****************************************************************/
+
+int PDC_getclipboard(char **contents, long *length)
+{
+    PDC_LOG(("PDC_getclipboard() - called\n"));
+
+    if (SDL_HasClipboardText() == SDL_FALSE)
+        return PDC_CLIP_EMPTY;
+    *contents = SDL_GetClipboardText();
+    *length = (long)strlen(*contents);
+
+    return PDC_CLIP_SUCCESS;
+}
+
+int PDC_setclipboard(const char *contents, long length)
+{
+    PDC_LOG(("PDC_setclipboard() - called\n"));
+
+    INTENTIONALLY_UNUSED_PARAMETER( length);
+    if (SDL_SetClipboardText(contents) != 0)
+        return PDC_CLIP_ACCESS_ERROR;
+
+    return PDC_CLIP_SUCCESS;
+}
+
+int PDC_freeclipboard(char *contents)
+{
+    PDC_LOG(("PDC_freeclipboard() - called\n"));
+
+    SDL_free(contents);
+
+    return PDC_CLIP_SUCCESS;
+}
+
+int PDC_clearclipboard(void)
+{
+    PDC_LOG(("PDC_clearclipboard() - called\n"));
+
+    if (SDL_HasClipboardText() == SDL_TRUE)
+    {
+        SDL_SetClipboardText(NULL);
+    }
+
+    return PDC_CLIP_SUCCESS;
+}