/* GNUPLOT - QtGnuplotInstance.h */

/*[

 * Copyright 2009   Jérôme Lodewyck

 *

 * Permission to use, copy, and distribute this software and its

 * documentation for any purpose with or without fee is hereby granted,

 * provided that the above copyright notice appear in all copies and

 * that both that copyright notice and this permission notice appear

 * in supporting documentation.

 *

 * Permission to modify the software is granted, but not the right to

 * distribute the complete modified source code.  Modifications are to

 * be distributed as patches to the released version.  Permission to

 * distribute binaries produced by compiling modified sources is granted,

 * provided you

 *   1. distribute the corresponding source modifications from the

 *    released version in the form of a patch file along with the binaries,

 *   2. add special version identification to distinguish your version

 *    in addition to the base release version number,

 *   3. provide your name and address as the primary contact for the

 *    support of your modified version, and

 *   4. retain our contact information in regard to use of the base

 *    software.

 * Permission to distribute the released version of the source code along

 * with corresponding source modifications in the form of a patch file is

 * granted with same provisions 2 through 4 for binary distributions.

 *

 * This software is provided "as is" without express or implied warranty

 * to the extent permitted by applicable law.

 *

 *

 * Alternatively, the contents of this file may be used under the terms of the

 * GNU General Public License Version 2 or later (the "GPL"), in which case the

 * provisions of GPL are applicable instead of those above. If you wish to allow

 * use of your version of this file only under the terms of the GPL and not

 * to allow others to use your version of this file under the above gnuplot

 * license, indicate your decision by deleting the provisions above and replace

 * them with the notice and other provisions required by the GPL. If you do not

 * delete the provisions above, a recipient may use your version of this file

 * under either the GPL or the gnuplot license.

]*/

#ifndef QTGNUPLOTINSTANCE_H

#define QTGNUPLOTINSTANCE_H

#include <QtCore>

class QtGnuplotWidget;

class QtGnuplotInstance : public QObject

{

Q_OBJECT

public:

	QtGnuplotInstance(QtGnuplotWidget* widget = 0, QString gnuplotPath = "gnuplot");

	~QtGnuplotInstance();

public:

	/// Redirect the instance plotting to widget @p widget

	void setWidget(QtGnuplotWidget* widget);

	/// Returns the widget to which the instance plots

	QtGnuplotWidget* widget();

	/// Send the given command to gnuplot

	void exec(const QByteArray& command);

	/// Send the given command to gnuplot and return the result string. Timeout after @p msecs milliseconds

	QByteArray execAndRead(const QByteArray& command, int msecs = 30000);

signals:

	/// Emitted when gnuplot sends data through it standards outputs

	void gnuplotOutput(const QString& output);

private slots:

	void gnuplotDataReady();

private:

	QtGnuplotWidget* m_widget;

	QProcess m_gnuplot;

};

/// Overloaded from QtGnuplotInstance::exec

QtGnuplotInstance& operator<<(QtGnuplotInstance& instance, const QString& command);

/// Overloaded from QtGnuplotInstance::exec

QtGnuplotInstance& operator<<(QtGnuplotInstance& instance, const QVector<QPointF>& points);

#endif // QTGNUPLOTINSTANCE_H