lyx_mirror/src/Format.h
Vincent van Ravesteijn a31df78133 Do not sort formats in BufferParams::exportableFormats
We only need to sort the formats when it is really necessary, i.e. for GUI
purposes.

This also prevents 11000 requests for translation everytime the toolbars
are updated.
2013-03-24 18:06:32 +01:00

228 lines
6.7 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/docstring.h"
#include "OutputParams.h"
#include <vector>
namespace lyx {
namespace support { class FileName; }
class Buffer;
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
};
///
Format(std::string const & n, std::string const & e, std::string 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);
///
std::string const & prettyname() const { return prettyname_; }
///
void setPrettyname(std::string 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 zippedNative() const { return flags_ & zipped_native; }
///
static bool formatSorter(Format const * lhs, Format const * rhs);
private:
/// Internal name. Needs to be unique.
std::string name_;
/// Filename extensions, the first one being the default
std::vector<std::string> extension_list_;
/// Name presented to the user. Needs to be unique.
std::string prettyname_;
/// Keyboard shortcut for the View and Export menu.
std::string 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.
*/
std::string viewer_;
/// Editor for this format. \sa viewer_.
std::string 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.
*/
std::string 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;
/*!
* 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.
*/
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;
/// Finds a format by pretty name. Returns string() if not found.
std::string getFormatFromPrettyName(std::string const & prettyname) 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,
std::string 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(OutputParams::FLAVOR flavor);
// Not currently used.
// OutputParams::FLAVOR format2flavor(std::string fmt);
extern Formats formats;
extern Formats system_formats;
} // namespace lyx
#endif //FORMAT_H