mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-11-25 10:58:52 +00:00
238 lines
7.0 KiB
C++
238 lines
7.0 KiB
C++
// -*- C++ -*-
|
|
/**
|
|
* \file Format.h
|
|
* This file is part of LyX, the document processor.
|
|
* Licence details can be found in the file COPYING.
|
|
*
|
|
* \author Dekel Tsur
|
|
*
|
|
* Full author contact details are available in file CREDITS.
|
|
*/
|
|
|
|
#ifndef FORMAT_H
|
|
#define FORMAT_H
|
|
|
|
#include "support/strfwd.h"
|
|
#include "support/trivstring.h"
|
|
|
|
#include <vector>
|
|
#include <string>
|
|
|
|
namespace lyx {
|
|
|
|
namespace support { class FileName; }
|
|
|
|
class Buffer;
|
|
|
|
enum class Flavor : int;
|
|
|
|
class Format {
|
|
public:
|
|
/// Flags for some format properties
|
|
enum Flags {
|
|
none = 0,
|
|
/// Set if this format is a document format (as opposed to
|
|
/// e.g. image formats).
|
|
/// Some formats are both (e.g. pdf), they have this flag set.
|
|
document = 1,
|
|
/// Set if this format can contain vector graphics.
|
|
vector = 2,
|
|
/// This format should appear in the File > Export menu
|
|
export_menu = 4,
|
|
/// This may be a compressed file but doesn't need decompression
|
|
zipped_native = 8,
|
|
/// This format should not appear in a menu at all
|
|
no_menu = 16
|
|
};
|
|
///
|
|
Format(std::string const & n, std::string const & e, docstring const & p,
|
|
std::string const & s, std::string const & v, std::string const & ed,
|
|
std::string const & m, int);
|
|
///
|
|
bool dummy() const;
|
|
/// Is \p ext a valid filename extension for this format?
|
|
bool hasExtension(std::string const & ext) const;
|
|
/// Tell whether this format is a child format.
|
|
/// Child formats inherit settings like the viewer from their parent.
|
|
bool isChildFormat() const;
|
|
/// Name fo the parent format
|
|
std::string const parentFormat() const;
|
|
///
|
|
std::string const name() const { return name_; }
|
|
///
|
|
void setName(std::string const & v) { name_ = v; }
|
|
///
|
|
std::string const extension() const
|
|
{
|
|
return extension_list_.empty() ? empty_string() : extension_list_[0];
|
|
}
|
|
///
|
|
std::string const extensions() const;
|
|
///
|
|
void setExtensions(std::string const & v);
|
|
///
|
|
docstring const prettyname() const { return prettyname_; }
|
|
///
|
|
void setPrettyname(docstring const & v) { prettyname_ = v; }
|
|
///
|
|
std::string const shortcut() const { return shortcut_; }
|
|
///
|
|
void setShortcut(std::string const & v) { shortcut_ = v; }
|
|
///
|
|
std::string const viewer() const { return viewer_; }
|
|
///
|
|
void setViewer(std::string const & v) { viewer_ = v; }
|
|
///
|
|
std::string const editor() const { return editor_; }
|
|
///
|
|
void setEditor(std::string const & v) { editor_ = v; }
|
|
///
|
|
std::string const mime() const { return mime_; }
|
|
///
|
|
void setMime(std::string const & m) { mime_ = m; }
|
|
///
|
|
bool documentFormat() const { return flags_ & document; }
|
|
///
|
|
bool vectorFormat() const { return flags_ & vector; }
|
|
///
|
|
void setFlags(int v) { flags_ = v; }
|
|
///
|
|
bool inExportMenu() const { return flags_ & export_menu; }
|
|
///
|
|
bool noMenu() const { return flags_ & no_menu; }
|
|
///
|
|
bool zippedNative() const { return flags_ & zipped_native; }
|
|
///
|
|
static bool formatSorter(Format const * lhs, Format const * rhs);
|
|
|
|
private:
|
|
/// Internal name. Needs to be unique.
|
|
trivstring name_;
|
|
/// Filename extensions, the first one being the default
|
|
std::vector<std::string> extension_list_;
|
|
/// Name presented to the user. Needs to be unique.
|
|
trivdocstring prettyname_;
|
|
/// Keyboard shortcut for the View and Export menu.
|
|
trivstring shortcut_;
|
|
/*!
|
|
* Viewer for this format. Needs to be in the PATH or an absolute
|
|
* filename.
|
|
* This format cannot be viewed if \c viewer_ is empty.
|
|
* If it is \c auto the default viewer of the OS for this format is
|
|
* used.
|
|
*/
|
|
trivstring viewer_;
|
|
/// Editor for this format. \sa viewer_.
|
|
trivstring editor_;
|
|
/*!
|
|
* Full MIME type, e.g. "text/x-tex".
|
|
* Only types listed by the shared MIME database of freedesktop.org
|
|
* should be added.
|
|
* This field may be empty, but it must be unique across all formats
|
|
* if it is set.
|
|
*/
|
|
trivstring mime_;
|
|
///
|
|
int flags_;
|
|
};
|
|
|
|
|
|
bool operator<(Format const & a, Format const & b);
|
|
|
|
|
|
///
|
|
class Formats {
|
|
public:
|
|
///
|
|
typedef std::vector<Format> FormatList;
|
|
///
|
|
typedef FormatList::const_iterator const_iterator;
|
|
///
|
|
Format const & get(FormatList::size_type i) const { return formatlist_[i]; }
|
|
///
|
|
Format & get(FormatList::size_type i) { return formatlist_[i]; }
|
|
/// \returns format named \p name if it exists, otherwise 0
|
|
Format const * getFormat(std::string const & name) const;
|
|
/// \returns format named \p name if it exists, otherwise 0
|
|
Format * getFormat(std::string const & name);
|
|
/*!
|
|
* Get the format of \p filename from file contents or, if this
|
|
* fails, from file extension.
|
|
* \returns file format if it could be found, otherwise an empty
|
|
* string.
|
|
* This function is expensive.
|
|
*/
|
|
std::string getFormatFromFile(support::FileName const & filename) const;
|
|
/// Finds a format from a file extension. Returns string() if not found.
|
|
std::string getFormatFromExtension(std::string const & ext) const;
|
|
/** Returns true if the file referenced by \p filename is zipped and
|
|
** needs to be unzipped for being handled
|
|
** @note For natively zipped formats, such as dia/odg, this returns false.
|
|
**/
|
|
bool isZippedFile(support::FileName const & filename) const;
|
|
/// check for zipped file format
|
|
static bool isZippedFileFormat(std::string const & format);
|
|
/// check for PostScript file format
|
|
static bool isPostScriptFileFormat(std::string const & format);
|
|
/// Set editor and/or viewer to "auto" for formats that can be
|
|
/// opened by the OS.
|
|
void setAutoOpen();
|
|
///
|
|
int getNumber(std::string const & name) const;
|
|
///
|
|
void add(std::string const & name);
|
|
///
|
|
void add(std::string const & name, std::string const & extensions,
|
|
docstring const & prettyname, std::string const & shortcut,
|
|
std::string const & viewer, std::string const & editor,
|
|
std::string const & mime, int flags);
|
|
///
|
|
void erase(std::string const & name);
|
|
///
|
|
void sort();
|
|
///
|
|
void setViewer(std::string const & name, std::string const & command);
|
|
///
|
|
void setEditor(std::string const & name, std::string const & command);
|
|
/// View the given file. Buffer used for DVI's paper orientation.
|
|
bool view(Buffer const & buffer, support::FileName const & filename,
|
|
std::string const & format_name) const;
|
|
///
|
|
bool edit(Buffer const & buffer, support::FileName const & filename,
|
|
std::string const & format_name) const;
|
|
///
|
|
docstring const prettyName(std::string const & name) const;
|
|
///
|
|
std::string const extension(std::string const & name) const;
|
|
///
|
|
std::string const extensions(std::string const & name) const;
|
|
///
|
|
const_iterator begin() const { return formatlist_.begin(); }
|
|
///
|
|
const_iterator end() const { return formatlist_.end(); }
|
|
///
|
|
bool empty() const { return formatlist_.empty(); }
|
|
///
|
|
FormatList::size_type size() const { return formatlist_.size(); }
|
|
private:
|
|
///
|
|
FormatList formatlist_;
|
|
};
|
|
|
|
///
|
|
std::string flavor2format(Flavor flavor);
|
|
// Not currently used.
|
|
// Flavor format2flavor(std::string fmt);
|
|
|
|
/// The global instance.
|
|
/// Implementation is in LyX.cpp.
|
|
extern Formats & theFormats();
|
|
|
|
/// The global copy after reading lyxrc.defaults.
|
|
/// Implementation is in LyX.cpp.
|
|
extern Formats & theSystemFormats();
|
|
|
|
} // namespace lyx
|
|
|
|
#endif //FORMAT_H
|