Developer Documentation
FileInterface Class Referenceabstract

Interface class for file handling. More...

#include <OpenFlipper/BasePlugin/FileInterface.hh>

Inheritance diagram for FileInterface:
FileBundlePlugin FileBVHPlugin FileHeightFieldPNGPlugin FileLightPlugin FileOBJPlugin FileOFFPlugin FileOMPlugin FileOpenVolumeMeshPlugin FilePlaPlugin FilePLYPlugin FilePolyLinePlugin FilePTSPlugin FileScriptPlugin FileSKLPlugin FileSPHPlugin FileSTLPlugin FileViewPlugin FileVTKPlugin

Public Member Functions

Widgets
virtual ~FileInterface ()
 Destructor.
 
virtual QWidget * saveOptionsWidget (QString _currentFilter)=0
 
virtual QWidget * loadOptionsWidget (QString _currentFilter)=0
 
Supported types
virtual DataType supportedType ()=0
 Return your supported object type( e.g. DATA_TRIANGLE_MESH ) More...
 
virtual QString getLoadFilters ()=0
 
virtual QString getSaveFilters ()=0
 

Load Save Implementation

virtual bool saveObject (int _id, QString _filename)=0
 Save an object from the given file. More...
 
virtual bool saveObjects (IdList _ids, QString _filename)
 Save multiple objects to one file. More...
 
virtual void openedFile (int _id)
 This signal has to be emitted if an object has been loaded from a file. More...
 
virtual int loadObject (QString _filename)=0
 Load an object from the given file. More...
 
virtual int loadObject (QString _filename, DataType _type)
 Load an object from the given file. More...
 

Detailed Description

Interface class for file handling.

Detailed description
Loading and saving of files in OpenFlipper is handled via the file plugins. These have to implement this class.

Definition at line 72 of file FileInterface.hh.

Member Function Documentation

virtual QString FileInterface::getLoadFilters ( )
pure virtual
virtual QString FileInterface::getSaveFilters ( )
pure virtual
virtual int FileInterface::loadObject ( QString  _filename)
pure virtualslot

Load an object from the given file.

The Core will call this slot if you should load a file. The core will check if you support the given file type depending on the provided filters and dataTypes ( see supportedType and getLoadFilters )
If loading fails, you have to return -1. If you created an empty object and then your load procedure fails, you should remove the newly generated object.
if you just opened a file and did not create any object, return 0 here, telling the core that it was successfully loaded but no new object has been created!

virtual int FileInterface::loadObject ( QString  _filename,
DataType  _type 
)
inlinevirtualslot

Load an object from the given file.

The Core will call this slot if you should load a file. The core will check if you support the given file type depending on the provided filters and dataTypes ( see supportedType and getLoadFilters )
if you just opened a file and did not create any object, return 0 here, telling the core that it was successfully loaded but no new object has been created!

If loading fails, you have to return -1. If you created an empty object and then your load procedure fails, you should remove the newly generated object.
If the Plugin is able to open the file in different DataTypes one of these DataTypes can be forced with this function.

This forcing is used for example by the recent files function for choosing between poly or triangle mesh loading.

Definition at line 188 of file FileInterface.hh.

virtual QWidget* FileInterface::loadOptionsWidget ( QString  _currentFilter)
pure virtual

You can provide a special widget showing options for loading your file types depending on the current filter

_currentFilter: one filter from loadFilters

Return 0 when you don't need one

Implemented in FileVTKPlugin, FileOBJPlugin, FileOpenVolumeMeshPlugin, FilePTSPlugin, FileBundlePlugin, FileOFFPlugin, FilePLYPlugin, FileOMPlugin, FileSTLPlugin, FileBVHPlugin, FilePolyLinePlugin, FileSKLPlugin, FileSPHPlugin, FilePlaPlugin, FileLightPlugin, FileScriptPlugin, FileViewPlugin, and FileHeightFieldPNGPlugin.

virtual void FileInterface::openedFile ( int  _id)
inlinevirtualsignal

This signal has to be emitted if an object has been loaded from a file.

Every time a new object is added to the scene from a file, this signal has to be emitted. Emit this signal once each time a file has been completely processed.
This signal can be called from any thread.

Parameters
_idId of the new object

Definition at line 147 of file FileInterface.hh.

virtual bool FileInterface::saveObject ( int  _id,
QString  _filename 
)
pure virtual

Save an object from the given file.

The Core will call this slot if you should save an object to a file. The core will check if you support the given object depending on the provided dataTypes ( see supportedType ). Additionally to the filename you get the id of the object to save

virtual bool FileInterface::saveObjects ( IdList  _ids,
QString  _filename 
)
inlinevirtual

Save multiple objects to one file.

The Core will call this slot if the user wants to save multiple files in one file. The core will check if you support the given object depending on the provided dataTypes ( see supportedType ). Additionally to the filename you get ids of the objects to save

Definition at line 206 of file FileInterface.hh.

virtual QWidget* FileInterface::saveOptionsWidget ( QString  _currentFilter)
pure virtual

You can provide a special widget showing options for saving your file types depending on the current filter

_currentFilter: one filter from saveFilters

Return 0 when you don't need one

Implemented in FileVTKPlugin, FileOBJPlugin, FileOpenVolumeMeshPlugin, FilePTSPlugin, FileBundlePlugin, FileOFFPlugin, FilePLYPlugin, FileOMPlugin, FileSTLPlugin, FileBVHPlugin, FilePolyLinePlugin, FileSKLPlugin, FileSPHPlugin, FilePlaPlugin, FileLightPlugin, FileScriptPlugin, FileViewPlugin, and FileHeightFieldPNGPlugin.

virtual DataType FileInterface::supportedType ( )
pure virtual

Return your supported object type( e.g. DATA_TRIANGLE_MESH )

If you support multiple DataTypes you can combine them bitwise here. The function is used from the load and save code to check if your plugin can handle an object of a given dataType.

Implemented in FileVTKPlugin, FileOBJPlugin, FileOpenVolumeMeshPlugin, FilePTSPlugin, FileBundlePlugin, FileOFFPlugin, FilePLYPlugin, FileOMPlugin, FileSTLPlugin, FileBVHPlugin, FilePolyLinePlugin, FileSKLPlugin, FileSPHPlugin, FilePlaPlugin, FileLightPlugin, FileViewPlugin, FileHeightFieldPNGPlugin, and FileScriptPlugin.


The documentation for this class was generated from the following file: