2016-02-20 00:41:02 +03:00
|
|
|
//
|
|
|
|
// "$Id$"
|
|
|
|
//
|
|
|
|
// A base class for platform specific system calls
|
|
|
|
// for the Fast Light Tool Kit (FLTK).
|
|
|
|
//
|
|
|
|
// Copyright 2010-2016 by Bill Spitzak and others.
|
|
|
|
//
|
|
|
|
// This library is free software. Distribution and use rights are outlined in
|
|
|
|
// the file "COPYING" which should have been included with this file. If this
|
|
|
|
// file is missing or damaged, see the license at:
|
|
|
|
//
|
|
|
|
// http://www.fltk.org/COPYING.php
|
|
|
|
//
|
|
|
|
// Please report all bugs and problems on the following page:
|
|
|
|
//
|
|
|
|
// http://www.fltk.org/str.php
|
|
|
|
//
|
|
|
|
|
|
|
|
/** \file Fl_System_Driver.H
|
2016-03-26 21:03:10 +03:00
|
|
|
\brief declaration of class Fl_System_Driver.
|
2016-02-20 00:41:02 +03:00
|
|
|
*/
|
|
|
|
|
2016-03-26 21:36:44 +03:00
|
|
|
#ifndef FL_SYSTEM_DRIVER_H
|
|
|
|
#define FL_SYSTEM_DRIVER_H
|
|
|
|
|
2016-04-20 01:45:22 +03:00
|
|
|
#include <FL/Fl.H>
|
2016-03-26 21:36:44 +03:00
|
|
|
#include <FL/Fl_Export.H>
|
2016-04-10 09:33:19 +03:00
|
|
|
#include <FL/filename.H>
|
2016-04-10 11:15:51 +03:00
|
|
|
#include <FL/Fl_Preferences.H>
|
2016-03-31 14:01:07 +03:00
|
|
|
#include <stdio.h>
|
2016-04-10 22:37:18 +03:00
|
|
|
#include <stdlib.h>
|
2016-03-28 18:22:20 +03:00
|
|
|
#include <stdarg.h>
|
2016-04-10 21:36:47 +03:00
|
|
|
#include <string.h>
|
2016-03-26 21:36:44 +03:00
|
|
|
|
2016-04-10 09:33:19 +03:00
|
|
|
class Fl_File_Icon;
|
|
|
|
class Fl_File_Browser;
|
2016-04-14 23:44:23 +03:00
|
|
|
class Fl_Pixmap;
|
2016-04-15 17:32:13 +03:00
|
|
|
class Fl_Widget;
|
2016-03-26 17:36:11 +03:00
|
|
|
|
2016-02-20 00:41:02 +03:00
|
|
|
/**
|
2016-03-28 18:22:20 +03:00
|
|
|
\brief A base class for platform-specific system operations.
|
2016-02-20 00:41:02 +03:00
|
|
|
*/
|
2016-02-26 14:13:43 +03:00
|
|
|
class FL_EXPORT Fl_System_Driver {
|
2016-04-01 13:28:03 +03:00
|
|
|
friend class Fl;
|
2016-03-28 12:25:11 +03:00
|
|
|
protected:
|
2016-04-01 13:28:03 +03:00
|
|
|
// implement once for each platform
|
|
|
|
static Fl_System_Driver *newSystemDriver();
|
2016-02-20 00:41:02 +03:00
|
|
|
Fl_System_Driver();
|
2016-04-09 19:37:24 +03:00
|
|
|
struct Keyname {unsigned int key; const char* name;};
|
|
|
|
static Keyname table[];
|
2016-03-28 12:25:11 +03:00
|
|
|
public:
|
2016-02-20 00:41:02 +03:00
|
|
|
virtual ~Fl_System_Driver();
|
2016-03-30 07:38:27 +03:00
|
|
|
// These flags are useful after calling XParseGeometry(). They indicate which of its arguments
|
|
|
|
// contain meaningful data upon return.
|
2016-03-28 12:25:11 +03:00
|
|
|
static const int flNoValue;
|
|
|
|
static const int flWidthValue;
|
|
|
|
static const int flHeightValue;
|
|
|
|
static const int flXValue;
|
|
|
|
static const int flYValue;
|
|
|
|
static const int flXNegative;
|
|
|
|
static const int flYNegative;
|
2016-04-01 13:28:03 +03:00
|
|
|
|
2016-03-28 18:22:20 +03:00
|
|
|
// implement if the system adds unwanted program argument(s)
|
2016-03-28 12:25:11 +03:00
|
|
|
virtual int single_arg(const char *arg) { return 0; }
|
2016-03-28 18:22:20 +03:00
|
|
|
// implement if the system adds unwanted program argument pair(s)
|
2016-03-28 12:25:11 +03:00
|
|
|
virtual int arg_and_value(const char *name, const char *value) { return 0; }
|
2016-03-28 18:22:20 +03:00
|
|
|
// implement to process the -display argument
|
2016-03-28 12:25:11 +03:00
|
|
|
virtual void display_arg(const char *arg) { }
|
2016-03-28 18:22:20 +03:00
|
|
|
// default implementation should be enough
|
2016-03-30 07:38:27 +03:00
|
|
|
virtual int XParseGeometry(const char* string, int* x, int* y, unsigned int* width, unsigned int* height);
|
2016-03-28 18:22:20 +03:00
|
|
|
static void warning(const char* format, ...);
|
|
|
|
// implement to set the default effect of Fl::warning()
|
|
|
|
virtual void warning(const char* format, va_list args);
|
|
|
|
static void error(const char* format, ...);
|
|
|
|
// implement to set the default effect of Fl::error()
|
|
|
|
virtual void error(const char* format, va_list args);
|
|
|
|
static void fatal(const char* format, ...);
|
|
|
|
// implement to set the default effect of Fl::error()
|
|
|
|
virtual void fatal(const char* format, va_list args);
|
2016-03-29 22:41:14 +03:00
|
|
|
|
2016-03-30 16:59:55 +03:00
|
|
|
// implement these to support cross-platform file operations
|
2016-03-29 22:41:14 +03:00
|
|
|
virtual char *utf2mbcs(const char *s) {return (char*)s;}
|
2016-04-12 09:45:35 +03:00
|
|
|
virtual char *getenv(const char* v) {return NULL;}
|
2016-04-11 22:14:47 +03:00
|
|
|
virtual int putenv(char* v) {return -1;}
|
2016-03-29 22:41:14 +03:00
|
|
|
virtual int open(const char* f, int oflags, int pmode) {return -1;}
|
|
|
|
virtual FILE *fopen(const char* f, const char *mode) {return NULL;}
|
|
|
|
virtual int system(const char* cmd) {return -1;}
|
|
|
|
virtual int execvp(const char *file, char *const *argv) {return -1;}
|
|
|
|
virtual int chmod(const char* f, int mode) {return -1;}
|
|
|
|
virtual int access(const char* f, int mode) { return -1;}
|
|
|
|
virtual int stat(const char* f, struct stat *b) { return -1;}
|
|
|
|
virtual char *getcwd(char* b, int l) {return NULL;}
|
|
|
|
virtual int unlink(const char* f) {return -1;}
|
|
|
|
virtual int mkdir(const char* f, int mode) {return -1;}
|
|
|
|
virtual int rmdir(const char* f) {return -1;}
|
|
|
|
virtual int rename(const char* f, const char *n) {return -1;}
|
2016-03-30 16:59:55 +03:00
|
|
|
|
|
|
|
// the default implementation of these utf8... functions should be enough
|
|
|
|
virtual unsigned utf8towc(const char* src, unsigned srclen, wchar_t* dst, unsigned dstlen);
|
|
|
|
virtual unsigned utf8fromwc(char* dst, unsigned dstlen, const wchar_t* src, unsigned srclen);
|
2016-04-12 09:45:35 +03:00
|
|
|
virtual int utf8locale() {return 1;}
|
2016-03-30 16:59:55 +03:00
|
|
|
virtual unsigned utf8to_mb(const char* src, unsigned srclen, char* dst, unsigned dstlen);
|
|
|
|
virtual unsigned utf8from_mb(char* dst, unsigned dstlen, const char* src, unsigned srclen);
|
2016-03-30 18:47:23 +03:00
|
|
|
// implement to shield fprintf() from locale changes in decimal point
|
|
|
|
virtual int clocale_printf(FILE *output, const char *format, va_list args);
|
2016-04-06 23:33:53 +03:00
|
|
|
// implement functions telling whether a key is pressed
|
|
|
|
virtual int event_key(int k) {return 0;}
|
|
|
|
virtual int get_key(int k) {return 0;}
|
2016-04-07 18:10:30 +03:00
|
|
|
// implement scandir-like function
|
|
|
|
virtual int filename_list(const char *d, dirent ***list, int (*sort)(struct dirent **, struct dirent **) ) {return -1;}
|
2016-04-08 18:17:39 +03:00
|
|
|
// the default implementation of filename_expand() may be enough
|
2016-04-07 19:54:20 +03:00
|
|
|
virtual int filename_expand(char *to, int tolen, const char *from);
|
|
|
|
// to implement
|
|
|
|
virtual const char *getpwnam(const char *login) {return NULL;}
|
2016-04-08 18:17:39 +03:00
|
|
|
// the default implementation of filename_relative() is in src/filename_absolute.cxx and may be enough
|
|
|
|
virtual int filename_relative(char *to, int tolen, const char *from, const char *base);
|
|
|
|
// the default implementation of filename_absolute() is in src/filename_absolute.cxx and may be enough
|
|
|
|
virtual int filename_absolute(char *to, int tolen, const char *from);
|
2016-04-08 18:48:28 +03:00
|
|
|
// the default implementation of filename_isdir() is in src/filename_isdir.cxx and may be enough
|
|
|
|
virtual int filename_isdir(const char* n);
|
|
|
|
// the default implementation of filename_isdir_quick() is in src/filename_isdir.cxx and may be enough
|
|
|
|
virtual int filename_isdir_quick(const char* n);
|
2016-04-09 13:42:17 +03:00
|
|
|
// the default implementation of filename_ext() is in src/filename_ext.cxx and may be enough
|
2016-04-08 19:00:26 +03:00
|
|
|
virtual const char *filename_ext(const char *buf);
|
2016-04-15 17:18:37 +03:00
|
|
|
// implement to support fl_filename_name()
|
|
|
|
virtual const char *filename_name(const char *buf) {return buf;}
|
2016-04-09 12:48:34 +03:00
|
|
|
// whether a platform uses additional code in Fl_Menu::handle(int e)
|
|
|
|
virtual int need_menu_handle_part2() {return 0;}
|
|
|
|
// whether a platform uses additional code in Fl_Menu::handle_part1(int e)
|
|
|
|
virtual int need_menu_handle_part1_extra() {return 0;}
|
2016-04-09 18:15:33 +03:00
|
|
|
// implement to support fl_open_uri()
|
|
|
|
virtual int open_uri(const char *uri, char *msg, int msglen) {return 0;}
|
2016-04-09 18:37:40 +03:00
|
|
|
// the default implementation of use_tooltip_timeout_condition() may be enough
|
|
|
|
virtual int use_tooltip_timeout_condition() {return 0;}
|
|
|
|
// the default implementation of use_recent_tooltip_fix() may be enough
|
|
|
|
virtual int use_recent_tooltip_fix() {return 0;}
|
2016-04-09 19:37:24 +03:00
|
|
|
// the default implementation of shortcut_add_key_name() is in src/fl_shortcut.cxx
|
|
|
|
virtual const char *shortcut_add_key_name(unsigned key, char *p, char *buf, const char **);
|
|
|
|
// the default implementation of need_test_shortcut_extra() may be enough
|
|
|
|
virtual int need_test_shortcut_extra() {return 0;}
|
2016-04-10 09:33:19 +03:00
|
|
|
// implement to support Fl_File_Browser::load()
|
|
|
|
virtual int file_browser_load_filesystem(Fl_File_Browser *browser, char *filename, Fl_File_Icon *icon) {return 0;}
|
|
|
|
// the default implementation of file_browser_load_directory() should be enough
|
2016-04-10 20:56:53 +03:00
|
|
|
virtual int file_browser_load_directory(const char *directory, char *filename, size_t name_size, dirent ***pfiles, Fl_File_Sort_F *sort);
|
2016-04-10 11:15:51 +03:00
|
|
|
// implement to support Fl_Preferences
|
|
|
|
virtual void newUUID(char *uuidBuffer) { uuidBuffer[0] = 0; }
|
|
|
|
// implement to support Fl_Preferences
|
|
|
|
virtual char *preference_rootnode(Fl_Preferences *prefs, Fl_Preferences::Root root, const char *vendor,
|
|
|
|
const char *application) {return NULL;}
|
|
|
|
// the default implementation of preferences_need_protection_check() may be enough
|
|
|
|
virtual int preferences_need_protection_check() {return 0;}
|
|
|
|
// implement to support Fl_Plugin_Manager::load()
|
|
|
|
virtual void *dlopen(const char *filename) {return NULL;}
|
2016-04-10 21:22:57 +03:00
|
|
|
// the default implementation is most probably enough
|
|
|
|
virtual void png_extra_rgba_processing(unsigned char *array, int w, int h) {}
|
2016-04-10 21:36:47 +03:00
|
|
|
// the default implementation is most probably enough
|
|
|
|
virtual const char *next_dir_sep(const char *start) { return strchr(start, '/');}
|
2016-04-10 23:38:04 +03:00
|
|
|
// implement to support threading
|
|
|
|
virtual void awake(void*) {}
|
|
|
|
virtual int lock() {return 1;}
|
|
|
|
virtual void unlock() {}
|
|
|
|
virtual void* thread_message() {return NULL;}
|
2016-04-11 16:07:08 +03:00
|
|
|
// implement to support Fl_File_Icon
|
|
|
|
virtual int file_type(const char *filename);
|
2016-04-12 16:47:38 +03:00
|
|
|
// the default implementations of pixmap_extra_transparent_processing() and make_unused_color() and are most probably enough
|
|
|
|
virtual int pixmap_extra_transparent_processing() {return 0;}
|
|
|
|
virtual void make_unused_color(unsigned char &r, unsigned char &g, unsigned char &b) {}
|
2016-04-12 20:06:20 +03:00
|
|
|
// implement to return the user's home directory name
|
|
|
|
virtual const char *home_directory_name() { return ""; }
|
|
|
|
// the default implementation is most probably enough
|
|
|
|
virtual const char *filesystems_label() { return "File Systems"; }
|
|
|
|
// return TRUE means \ same as / in file names
|
|
|
|
virtual int backslash_as_slash() {return 0;}
|
|
|
|
// return TRUE means : indicates a drive letter in file names
|
|
|
|
virtual int colon_is_drive() {return 0;}
|
|
|
|
// return TRUE means that files whose name begins with dot are hidden
|
|
|
|
virtual int dot_file_hidden() {return 0;}
|
2016-04-13 00:32:55 +03:00
|
|
|
// return TRUE when file names are case insensitive
|
|
|
|
virtual int case_insensitive_filenames() {return 0;}
|
2016-04-13 17:05:34 +03:00
|
|
|
// the implementations of local_to_latin1() and latin1_to_local() are in fl_encoding_latin1.cxx
|
|
|
|
virtual const char *local_to_latin1(const char *t, int n);
|
|
|
|
virtual const char *latin1_to_local(const char *t, int n);
|
2016-04-13 17:19:13 +03:00
|
|
|
// the implementations of local_to_mac_roman() and mac_roman_to_local() are in fl_encoding_mac_roman.cxx
|
|
|
|
virtual const char *local_to_mac_roman(const char *t, int n);
|
|
|
|
virtual const char *mac_roman_to_local(const char *t, int n);
|
2016-04-13 17:41:55 +03:00
|
|
|
// the default implementation is most probably enough
|
|
|
|
virtual void own_colormap() {}
|
2016-04-14 23:44:23 +03:00
|
|
|
// the default implementations of tree_openpixmap() and tree_closepixmap() are
|
|
|
|
// in Fl_Tree_Prefs.cxx and can be enough
|
|
|
|
virtual Fl_Pixmap *tree_openpixmap();
|
|
|
|
virtual Fl_Pixmap *tree_closepixmap();
|
|
|
|
static const char *const tree_open_xpm[]; // used by tree_openpixmap()
|
|
|
|
static const char * const tree_close_xpm[]; // used by tree_closepixmap()
|
2016-04-14 23:58:20 +03:00
|
|
|
// the default implementation of tree_connector_style() is in Fl_Tree_Prefs.cxx and can be enough
|
|
|
|
virtual int tree_connector_style();
|
2016-04-15 17:32:13 +03:00
|
|
|
// implement to support copy-to-clipboard
|
2016-04-15 17:18:37 +03:00
|
|
|
virtual void copy(const char *stuff, int len, int clipboard, const char *type) {}
|
2016-04-15 17:32:13 +03:00
|
|
|
// implement to support paste-from-clipboard
|
|
|
|
virtual void paste(Fl_Widget &receiver, int clipboard, const char *type) {}
|
2016-04-15 17:49:46 +03:00
|
|
|
// implement to support paste-from-clipboard
|
|
|
|
virtual int clipboard_contains(const char *type) {return 0;}
|
2016-04-15 18:01:27 +03:00
|
|
|
// implement to support paste-from-clipboard
|
|
|
|
virtual void clipboard_notify_change() {}
|
2016-04-20 01:45:22 +03:00
|
|
|
virtual void add_fd(int fd, int when, Fl_FD_Handler cb, void* = 0);
|
|
|
|
virtual void add_fd(int fd, Fl_FD_Handler cb, void* = 0);
|
|
|
|
virtual void remove_fd(int, int when);
|
|
|
|
virtual void remove_fd(int);
|
2016-02-20 00:41:02 +03:00
|
|
|
};
|
|
|
|
|
|
|
|
#endif // FL_SYSTEM_DRIVER_H
|
|
|
|
|
|
|
|
//
|
|
|
|
// End of "$Id$".
|
|
|
|
//
|