mirror of
https://git.lyx.org/repos/lyx.git
synced 2024-11-28 04:17:43 +00:00
770aa71839
This shouldn't be necessary, but sometimes it is. git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@31014 a592a061-630c-0410-9148-cb99ea01b6c8
115 lines
3.1 KiB
C++
115 lines
3.1 KiB
C++
// -*- C++ -*-
|
|
/**
|
|
* \file GraphicsLoader.h
|
|
* This file is part of LyX, the document processor.
|
|
* Licence details can be found in the file COPYING.
|
|
*
|
|
* \author Angus Leeming
|
|
*
|
|
* Full author contact details are available in file CREDITS.
|
|
*
|
|
* The public face of the graphics cache.
|
|
*
|
|
* * The user supplies an image file and the display parameters.
|
|
* * He can change the file or the display parameters through a reset() method.
|
|
* * He must start the loading process explicitly with startLoading().
|
|
* * If he is connected through the connect() method, then he'll be informed
|
|
* when the loading status changes.
|
|
* * When (status() == Ready), he can use image() to access the loaded image
|
|
* and pass it to the Painter.
|
|
*
|
|
* What could be simpler?
|
|
*/
|
|
|
|
#ifndef GRAPHICSLOADER_H
|
|
#define GRAPHICSLOADER_H
|
|
|
|
#include "GraphicsTypes.h"
|
|
|
|
#include <boost/signal.hpp>
|
|
|
|
namespace lyx {
|
|
|
|
namespace support { class FileName; }
|
|
|
|
namespace graphics {
|
|
|
|
class Image;
|
|
class Params;
|
|
|
|
class Loader {
|
|
public:
|
|
/// Must use the reset methods to make this instance usable.
|
|
Loader();
|
|
/// The image is not transformed, just displayed as-is.
|
|
Loader(support::FileName const & file_with_path, bool display = true);
|
|
/// The image is transformed before display.
|
|
Loader(support::FileName const & file_with_path, Params const &);
|
|
///
|
|
Loader(Loader const &);
|
|
/// Needed for the pimpl
|
|
~Loader();
|
|
|
|
Loader & operator=(Loader const &);
|
|
|
|
/// The file can be changed, or the display params, or both.
|
|
void reset(support::FileName const & file_with_path, bool display = true) const;
|
|
///
|
|
void reset(support::FileName const & file_with_path, Params const &) const;
|
|
///
|
|
void reset(Params const &) const;
|
|
|
|
/// Returns the absolute path of the loaded (loading?) file.
|
|
support::FileName const & filename() const;
|
|
///
|
|
|
|
/** starting loading of the image is done by a urgency-based
|
|
* decision. Here we only call LoaderQueue::touch to request it.
|
|
*/
|
|
void startLoading() const;
|
|
|
|
/** Tries to reload the image.
|
|
*/
|
|
void reload() const;
|
|
|
|
/** Monitor any changes to the file.
|
|
* There is no point monitoring the file before startLoading() is
|
|
* invoked.
|
|
*/
|
|
void startMonitoring() const;
|
|
///
|
|
bool monitoring() const;
|
|
/** Returns the check checksum of filename() so that, for example, you can
|
|
* ascertain whether to output a new PostScript version of the file
|
|
* for a LaTeX run.
|
|
*/
|
|
unsigned long checksum() const;
|
|
|
|
/// How far have we got in loading the image?
|
|
ImageStatus status() const;
|
|
|
|
/** Connect and you'll be informed when the loading status of the image
|
|
* changes.
|
|
*/
|
|
typedef boost::signal<void()> sig_type;
|
|
typedef sig_type::slot_type slot_type;
|
|
///
|
|
boost::signals::connection connect(slot_type const &) const;
|
|
|
|
/** The loaded image with Pixmap set.
|
|
* If the Pixmap is not yet set (see status() for why...), returns 0.
|
|
*/
|
|
Image const * image() const;
|
|
|
|
private:
|
|
/// Use the Pimpl idiom to hide the internals.
|
|
class Impl;
|
|
/// The pointer never changes although *pimpl_'s contents may.
|
|
Impl * const pimpl_;
|
|
};
|
|
|
|
} // namespace graphics
|
|
} // namespace lyx
|
|
|
|
#endif // GRAPHICSLOADER_H
|