// -*- C++ -*-
/**
 * \file lyx_gui.h
 * This file is part of LyX, the document processor.
 * Licence details can be found in the file COPYING.
 *
 * \author John Levon
 *
 * Full author contact details are available in file CREDITS.
 */

#ifndef LYX_GUI_H
#define LYX_GUI_H

#include "support/std_string.h"
#include "FuncStatus.h"

#include <vector>

class Dialogs;
class LColor_color;
class LyXFont;
class LyXComm;
class FuncRequest;

/// GUI interaction
namespace lyx_gui {

/// are we using the GUI at all
extern bool use_gui;

/// return a suitable serif font name (called from non-gui context too !)
string const roman_font_name();

/// return a suitable sans serif font name (called from non-gui context too !)
string const sans_font_name();

/// return a suitable monospaced font name (called from non-gui context too !)
string const typewriter_font_name();

/// parse command line and do basic initialisation
void parse_init(int & argc, char * argv[]);

/**
 * set up GUI parameters. At this point lyxrc may
 * be used.
 */
void parse_lyxrc();

/**
 * Start the main event loop, after executing the given
 * batch commands, and loading the given documents
 */
void start(string const & batch, std::vector<string> const & files);

/**
 * Synchronise all pending events.
 */
void sync_events();

/**
 * quit running LyX
 */
void exit();

/**
 * return the status flag for a given action. This can be used to tell
 * that a given lfun is not implemented by a frontend
 */
FuncStatus getStatus(FuncRequest const & ev);

/** Eg, passing LColor::black returns "000000",
 *      passing LColor::white returns "ffffff".
 */
string const hexname(LColor_color col);

/**
 * update an altered GUI color
 */
void update_color(LColor_color col);

/**
 * update the font cache
 */
void update_fonts();

/**
 * is the given font available ?
 */
bool font_available(LyXFont const & font);

/**
 * add a callback for I/O read notification
 */
void set_read_callback(int fd, LyXComm * comm);

/**
 * remove a I/O read callback
 * @param fd file descriptor
 */
void remove_read_callback(int fd);

} // namespace lyx_gui

#endif // LYX_GUI_H