Toshihiro Shimizu 890ddd
#ifndef TSTREAM_H
Toshihiro Shimizu 890ddd
#define TSTREAM_H
Toshihiro Shimizu 890ddd
Shinya Kitaoka 262a92
#include <memory></memory>
Shinya Kitaoka 262a92
Toshihiro Shimizu 890ddd
// TnzCore includes
Toshihiro Shimizu 890ddd
#include "tpixel.h"
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
// Qt includes
Toshihiro Shimizu 890ddd
#ifndef TNZCORE_LIGHT
Toshihiro Shimizu 890ddd
#include <qstring></qstring>
Toshihiro Shimizu 890ddd
#endif
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
#undef DVAPI
Toshihiro Shimizu 890ddd
#undef DVVAR
Toshihiro Shimizu 890ddd
#ifdef TSTREAM_EXPORTS
Toshihiro Shimizu 890ddd
#define DVAPI DV_EXPORT_API
Toshihiro Shimizu 890ddd
#define DVVAR DV_EXPORT_VAR
Toshihiro Shimizu 890ddd
#else
Toshihiro Shimizu 890ddd
#define DVAPI DV_IMPORT_API
Toshihiro Shimizu 890ddd
#define DVVAR DV_IMPORT_VAR
Toshihiro Shimizu 890ddd
#endif
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
//===================================================================
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
//    Forward declarations
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
class TPersist;
Toshihiro Shimizu 890ddd
class TFilePath;
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
typedef std::pair<int, int=""> VersionNumber; //!< Integer pair storing the major and minor</int,>
Toshihiro Shimizu 890ddd
										   //!  application version numbers.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
//===================================================================
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
/*!
Toshihiro Shimizu 890ddd
  \brief Toonz's XML-like \a input file parser.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
  This class is Toonz's standard \a input parser for simple XML files.
Toshihiro Shimizu 890ddd
  It is specifically designed to interact with object types derived
Toshihiro Shimizu 890ddd
  from the TPersist base class.
Toshihiro Shimizu 890ddd
*/
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
class DVAPI TIStream
Toshihiro Shimizu 890ddd
{
Toshihiro Shimizu 890ddd
	class Imp;
Shinya Kitaoka 262a92
	std::unique_ptr<imp> m_imp;</imp>
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
public:
Toshihiro Shimizu 890ddd
	/*!
Toshihiro Shimizu 890ddd
    \warning  Stream construction  may throw  on files \b compressed using
Toshihiro Shimizu 890ddd
              TOStream 's compression.
Toshihiro Shimizu 890ddd
              
Toshihiro Shimizu 890ddd
    \warning  Even if construction does not throw, the stream could still be
Toshihiro Shimizu 890ddd
              constructed with an invalid status. Remember to check the stream
Toshihiro Shimizu 890ddd
              status using operator bool().
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	TIStream(const TFilePath &is); //!< Opens the document at the specified path
Toshihiro Shimizu 890ddd
	~TIStream();				   //!< Destroys the stream
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//! \sa std::basic_istream::operator void*().
Toshihiro Shimizu 890ddd
	operator bool() const; //!< Returns whether the stream has a valid status.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	TIStream &operator>>(int &v);		//!< Reads an integer from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(double &v);	//!< Reads a double from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(string &v);	//!< Reads a string from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(wstring &v);   //!< Reads a wstring from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(TFilePath &v); //!< Reads a TFilePath from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(TPixel32 &v);  //!< Reads a TPixel32 from the stream
Toshihiro Shimizu 890ddd
	TIStream &operator>>(TPixel64 &v);  //!< Reads a TPixel64 from the stream
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
#ifndef TNZCORE_LIGHT
Toshihiro Shimizu 890ddd
	TIStream &operator>>(QString &v); //!< Reads an integer from the stream
Toshihiro Shimizu 890ddd
#endif
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	/*! \detail
Toshihiro Shimizu 890ddd
    This function dispatches the loading process to the derived class'
Toshihiro Shimizu 890ddd
    reimplementation of the TPersist::loadData() function.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
    \note Unlinke operator>>(TPersist*&), this function \a requires that
Toshihiro Shimizu 890ddd
          the passed object is of the \b correct type to read the current tag.
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	TIStream &operator>>(TPersist &v);  //!< Reads a TPersist derived object data from the stream.
Toshihiro Shimizu 890ddd
	TIStream &operator>>(TPersist *&v); //!< \a Allocates and reads a TPersist derived object data from the stream.
Toshihiro Shimizu 890ddd
										//!  \sa operator>>(TPersist&)
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//!  \deprecated
Toshihiro Shimizu 890ddd
	string getString(); //!< Returns the stream content as a string, up to the next tag.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//!  \deprecated
Toshihiro Shimizu 890ddd
	bool eos(); //!< \brief Returns \e true in case of end of string (a StreamTag::EndTag
Toshihiro Shimizu 890ddd
				//!  is encountered or the string is empty).
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	/*!
Toshihiro Shimizu 890ddd
    \param      tagName Output name of a matched tag.
Toshihiro Shimizu 890ddd
    \return     Whether a tag was found.
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	bool matchTag(string &tagName); //!< Attempts matching a tag and returns its name.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//! \return   Whether an end tag was found.
Toshihiro Shimizu 890ddd
	bool matchEndTag(); //!< Attempts matching a StreamTag::EndTag.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	/*!
Toshihiro Shimizu 890ddd
    \brief Attempts retrieval of the value associated with the
Toshihiro Shimizu 890ddd
           specified tag attribute in current tag.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
    \param paramName  Tag attribute name.
Toshihiro Shimizu 890ddd
    \param value      Output value of the attribute.
Toshihiro Shimizu 890ddd
    \return           Whether the tag attribute was found.
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	bool getTagParam(string paramName, string &value);
Toshihiro Shimizu 890ddd
	bool getTagParam(string paramName, int &value); //!< \sa getTagParam(string, string&)
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	bool isBeginEndTag(); //!< Returns whether current tag is of type StreamTag::BeginEndTag.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	bool openChild(string &tagName); //!< \deprecated Use matchTag(string&) instead.
Toshihiro Shimizu 890ddd
	void closeChild();				 //!< \deprecated Use matchEndTag() instead.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	bool match(char c) const; //! \deprecated
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	string getTagAttribute(string name) const; //!< \sa getTagParam(string, string&),
Toshihiro Shimizu 890ddd
											   //!  TOStream::openChild(string, const map<string, string="">&).</string,>
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	TFilePath getFilePath();	   //!< Returns the stream's path (i.e. the opened filename associated to the input stream).
Toshihiro Shimizu 890ddd
	TFilePath getRepositoryPath(); //!< \deprecated
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	int getLine() const; //!< Returns the line number of the stream <tt>+1</tt>.
Toshihiro Shimizu 890ddd
						 //!  \warning I've not idea why the +1, though.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	VersionNumber getVersion() const; //!< Returns the currently stored version of the opened document.
Toshihiro Shimizu 890ddd
									  //!  \sa setVersion()
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	void setVersion(const VersionNumber &version); //!< Returns the currently stored version of the opened document.
Toshihiro Shimizu 890ddd
												   //!  \sa setVersion()
Toshihiro Shimizu 890ddd
	/*!
Toshihiro Shimizu 890ddd
    \note After skipping the tag content, the stream is positioned immediately
Toshihiro Shimizu 890ddd
          after the end tag.
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	void skipCurrentTag(); //!< Silently ignores the content of currently opened tag up to its end.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
private:
Toshihiro Shimizu 890ddd
	// Not copyable
Toshihiro Shimizu 890ddd
	TIStream(const TIStream &);			   //!< Not implemented
Toshihiro Shimizu 890ddd
	TIStream &operator=(const TIStream &); //!< Not implemented
Toshihiro Shimizu 890ddd
};
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
//-------------------------------------------------------------------
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
template <class t=""></class>
Toshihiro Shimizu 890ddd
TIStream &operator>>(TIStream &is, T *&v)
Toshihiro Shimizu 890ddd
{
Toshihiro Shimizu 890ddd
	TPersist *persist = 0;
Toshihiro Shimizu 890ddd
	is >> persist;
Toshihiro Shimizu 890ddd
	v = persist ? dynamic_cast<t *="">(persist) : 0;</t>
Toshihiro Shimizu 890ddd
	return is;
Toshihiro Shimizu 890ddd
}
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
//===================================================================
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
/*!
Toshihiro Shimizu 890ddd
  \brief Toonz's XML-like \a output file parser.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
  This class is Toonz's standard \a output parser for simple XML files.
Toshihiro Shimizu 890ddd
  It is specifically designed to interact with object types derived
Toshihiro Shimizu 890ddd
  from the TPersist base class.
Toshihiro Shimizu 890ddd
*/
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
class DVAPI TOStream
Toshihiro Shimizu 890ddd
{
Toshihiro Shimizu 890ddd
	class Imp;
Shinya Kitaoka 262a92
	std::shared_ptr<imp> m_imp;</imp>
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
private:
Shinya Kitaoka 262a92
	TOStream(std::shared_ptr<imp> imp); //!< deprecated</imp>
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
public:
Toshihiro Shimizu 890ddd
	/*!
Toshihiro Shimizu 890ddd
    \param fp           Output file path
Toshihiro Shimizu 890ddd
    \param compressed   Enables compression of the whole file
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
    \note     Stream construction  does not throw . However, the stream
Toshihiro Shimizu 890ddd
              status could be invalid. Remeber to check the stream validity using
Toshihiro Shimizu 890ddd
              operator bool().
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
    \warning  Stream compression has been verified to be unsafe.
Toshihiro Shimizu 890ddd
              Please consider it \a deprecated.
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	TOStream(const TFilePath &fp, bool compressed = false); //!< Opens the specified file for write
Toshihiro Shimizu 890ddd
	~TOStream();											//!< Closes the file and destroys the stream
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//! \sa std::basic_ostream::operator void*().
Toshihiro Shimizu 890ddd
	operator bool() const; //!< Returns whether the stream has a valid status.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	TOStream &operator<<(int v);			  //!< Writes an int to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(double v);			  //!< Writes a double to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(string v);			  //!< Writes a string to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(wstring v);		  //!< Writes a wstring to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(const TFilePath &v); //!< Writes a TFilePath to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(const TPixel32 &v);  //!< Writes a TPixel32 to the stream.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(const TPixel64 &v);  //!< Writes a TPixel64 to the stream.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
#ifndef TNZCORE_LIGHT
Toshihiro Shimizu 890ddd
	TOStream &operator<<(QString v); //!< Writes a QString to the stream.
Toshihiro Shimizu 890ddd
#endif
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	TOStream &operator<<(TPersist *v); //!< deprecated Use operator<<(TPersist&) instead.
Toshihiro Shimizu 890ddd
	TOStream &operator<<(TPersist &v); //!< Saves data to the stream according
Toshihiro Shimizu 890ddd
									   //!  to the reimplemented TPersist::saveData.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	//! \deprecated Use openChild(string) instead
Toshihiro Shimizu 890ddd
	TOStream child(string tagName);
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	void openChild(string tagName); //!< Writes a <tagname> to the stream, opening a tag.</tagname>
Toshihiro Shimizu 890ddd
	void openChild(string tagName,
Toshihiro Shimizu 890ddd
				   const map<string, string=""> &attributes); //!< \brief Writes a <tagname ..="" attribute1="value1"></tagname></string,>
Toshihiro Shimizu 890ddd
														   //!  to the stream, opening a tag with embedded attributes.
Toshihiro Shimizu 890ddd
	void openCloseChild(string tagName,
Toshihiro Shimizu 890ddd
						const map<string, string=""> &attributes); //!< \brief Writes a tag <tagname ..="" attribute1="value1"></tagname></string,>
Toshihiro Shimizu 890ddd
																//!  to the stream, opening a tag with embedded attributes
Toshihiro Shimizu 890ddd
																//!  which is immediately closed.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	void closeChild(); //!< Closes current tag, writing  to the stream.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	void cr(); //!< Writes carriage return to the stream. \deprecated
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	void tab(int dt); //!< \deprecated
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	TFilePath getFilePath();	   //!< Returns the file path of the file associated to this output stream.
Toshihiro Shimizu 890ddd
	TFilePath getRepositoryPath(); //!< \deprecated
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
	/*! \detail
Toshihiro Shimizu 890ddd
    This function is similar to operator bool(), but \b flushes the stream before
Toshihiro Shimizu 890ddd
    checking the status.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
    \return   Whether the stream is in a good state (no fails in writing to).
Toshihiro Shimizu 890ddd
  */
Toshihiro Shimizu 890ddd
	bool checkStatus() const; //!< \b Flushes the stream and checks its validity.
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
private:
Toshihiro Shimizu 890ddd
	// Not copyable
Shinya Kitaoka 387b33
	TOStream(const TOStream &) = default;			      //!< Not implemented
Shinya Kitaoka 262a92
	TOStream &operator=(const TOStream &) = delete; //!< Not implemented
Toshihiro Shimizu 890ddd
};
Toshihiro Shimizu 890ddd
Toshihiro Shimizu 890ddd
#endif // TSTREAM_H