This reference page is linked to from the following overview topics: Customizing the FBX SDK, Customizing File Formats, Customizing File Formats with FBX SDK I/O Plug-ins, List of Python Fbx classes.
#include <fbxreader.h>
Base class of other readers used internally.
This class provides the interfaces for reading files.
The role of the reader is to effectively "read" specific file data vs the role of the importer is to select a specific reader and launch the reading of a file through that reader.
ex:
A SDK user should - normally - not use this class, except if a custom reader must be created for plug-in extension, then FbxReader must be the base class for the new custom reader in that particular situation.
MyOwnWriterReader/MyOwnReader.cxx, MyOwnWriterReader/MyOwnReader.h, MyOwnWriterReader/MyOwnWriterReader.cxx, and MyOwnWriterReader/MyOwnWriterReader.h.
Definition at line 64 of file fbxreader.h.
Public Types |
|
| enum | EInfoRequest { eInfoExtension, eInfoDescriptions, eReserved1 = 0xFBFB } |
| Information type to request. More... |
|
| enum | EFileOpenSpecialFlags { eParseForGlobalSettings = 1, eParseForStatistics = 2 } |
| Flags for reading parts of file. More... |
|
| typedef FbxReader *(* | CreateFuncType )(FbxManager &pManager, FbxImporter &pImporter, int pSubID, int pPluginID) |
| typedef void(* | IOSettingsFillerFuncType )(FbxIOSettings &pIOS) |
| typedef void *(* | GetInfoFuncType )(EInfoRequest pRequest, int pReaderTypeId) |
Public Member Functions |
|
| FbxReader (FbxManager &pManager, int pID, FbxStatus &pStatus) | |
| Constructor. |
|
| virtual | ~FbxReader () |
| Destructor. |
|
| virtual void | GetVersion (int &pMajor, int &pMinor, int &pRevision) |
| Returns the file version. |
|
| virtual bool | FileOpen (char *pFileName)=0 |
| Opens the file with default flag. |
|
| virtual bool | FileOpen (FbxStream *pStream, void *pStreamData) |
| Opens the stream with default flag. |
|
| virtual bool | FileClose ()=0 |
| Closes the file stream. |
|
| virtual bool | IsFileOpen ()=0 |
| Checks if the file stream is open. |
|
| virtual bool | GetReadOptions (bool pParseFileAsNeeded=true)=0 |
| Returns file stream options. |
|
| virtual bool | Read (FbxDocument *pDocument)=0 |
| Reads file with stream options. |
|
| virtual void | PluginReadParameters (FbxObject &pParams) |
| Reads extension plug-ins name, version and
parameters, so that we can remember if a plug-in was used during
export. |
|
| virtual bool | FileOpen (char *pFileName, EFileOpenSpecialFlags) |
| Opens the file with specific
EFileOpenSpecialFlags. |
|
| virtual bool | GetAxisInfo (FbxAxisSystem *, FbxSystemUnit *) |
| Returns the system axis information and file
system units from the file. |
|
| virtual bool | GetStatistics (FbxStatistics *) |
| Returns statistics from the file. |
|
| virtual bool | GetFrameRate (FbxTime::EMode &pTimeMode) |
| Get FBX file time mode read from
GlobalSettings in FBX 6.n and FBX 7.n. |
|
| virtual FbxDocumentInfo * | GetSceneInfo () |
| Returns the scene info from the file.
|
|
| virtual FbxArray< FbxTakeInfo * > * | GetTakeInfo () |
| Returns the list of take infos from the
file. |
|
| virtual bool | GetDefaultRenderResolution (FbxString &pCamName, FbxString &pResolutionMode, double &pW, double &pH) |
| If default camera resolution is OK, returns
information about the resolution of the render. |
|
| bool | IsGenuine () |
| Judges if the format of the file is was
created by an Autodesk plug-in. |
|
| virtual FbxIOSettings * | GetIOSettings () |
| Access to a IOSettings object. |
|
| virtual void | SetIOSettings (FbxIOSettings *pIOSettings) |
| Set the IOSettings pointer to be used for
this reader instance. |
|
| virtual void | SetProgressHandler (FbxProgress *) |
| Pass a progress handler to the reader.
|
|
| virtual void | SetEmbeddingExtractionFolder (const char *) |
| virtual bool | SupportsStreams () const |
| Returns true if this reader supports
FbxStream I/O. |
|
| typedef FbxReader*(* CreateFuncType)(FbxManager &pManager, FbxImporter &pImporter, int pSubID, int pPluginID) |
Helper typedef for passing FbxReader creator function as argument (used internally)
Definition at line 98 of file fbxreader.h.
| typedef void(* IOSettingsFillerFuncType)(FbxIOSettings &pIOS) |
Helper typedef for passing FbxIOSettings creator function as argument (used internally)
Definition at line 101 of file fbxreader.h.
| typedef void*(* GetInfoFuncType)(EInfoRequest pRequest, int pReaderTypeId) |
Helper typedef for passing EInfoRequest function as argument (used internally)
Definition at line 104 of file fbxreader.h.
| enum EInfoRequest |
Information type to request.
| eInfoExtension |
To get the file ext for a reader ex: "FBX". |
| eInfoDescriptions |
To get the file description for a reader ex: "Autodesk FBX (*.fbx)". |
| eReserved1 |
Definition at line 81 of file fbxreader.h.
{
eInfoExtension,
eInfoDescriptions,
eReserved1 = 0xFBFB,
};
Flags for reading parts of file.
| eParseForGlobalSettings |
Used for reading the Global settings section when an importer is initialized. |
| eParseForStatistics |
Used for reading a group of statistics when an importer is initialized. |
Definition at line 91 of file fbxreader.h.
{
eParseForGlobalSettings = 1,
eParseForStatistics = 2
};
| FbxReader | ( | FbxManager & | pManager, |
| int | pID, | ||
| FbxStatus & | pStatus | ||
| ) |
Constructor.
| pManager | The FbxManager Object. |
| pID | Id for current reader. |
| pStatus | The FbxStatus object to hold error codes. |
| virtual ~FbxReader | ( | ) | [virtual] |
Destructor.
| virtual void GetVersion | ( | int & | pMajor, |
| int & | pMinor, | ||
| int & | pRevision | ||
| ) | [inline, virtual] |
Returns the file version.
| pMajor | Major version. |
| pMinor | Minor version. |
| pRevision | Revision version. |
Reimplemented in FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 111 of file fbxreader.h.
{ pMajor = pMinor = pRevision = 0; }
| virtual bool FileOpen | ( | char * | pFileName | ) | [pure virtual] |
Opens the file with default flag.
| pFileName | Name of the File to open |
true,
otherwise return false.Implemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool FileOpen | ( | FbxStream * | pStream, |
| void * | pStreamData | ||
| ) | [virtual] |
Opens the stream with default flag.
| pStream | stream to open |
| pStreamData | user-defined stream data |
true,
otherwise return false.Reimplemented in FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool FileClose | ( | ) | [pure virtual] |
Closes the file stream.
falseImplemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool IsFileOpen | ( | ) | [pure virtual] |
Checks if the file stream is open.
false.Implemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool GetReadOptions | ( | bool | pParseFileAsNeeded =
true |
) | [pure virtual] |
Returns file stream options.
| pParseFileAsNeeded | Sets whether to parse file as read options |
Implemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool Read | ( | FbxDocument * | pDocument | ) | [pure virtual] |
Reads file with stream options.
| pDocument | FbxDocument to store the file data |
false.Implemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
| virtual void PluginReadParameters | ( | FbxObject & | pParams | ) | [virtual] |
Reads extension plug-ins name, version and parameters, so that we can remember if a plug-in was used during export.
This is especially useful for extension plug-ins that modify the scene and also to warn users during import if an extension plug-in was used that could be missing.
| pParams | The parameters of the extension plug-in. The properties of the objects are used as the parameters of the extension plug-in. |
Reimplemented in FbxReaderFbx6, and FbxReaderFbx7.
| virtual bool FileOpen | ( | char * | pFileName, |
| EFileOpenSpecialFlags | |||
| ) | [inline, virtual] |
Opens the file with specific EFileOpenSpecialFlags.
| pFileName | Name of the File to open. |
| pFlags | The EFileOpenSpecialFlags to open with |
Reimplemented in FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 165 of file fbxreader.h.
{ return FileOpen(pFileName); }
| virtual bool GetAxisInfo | ( | FbxAxisSystem * | , |
| FbxSystemUnit * | |||
| ) | [inline, virtual] |
Returns the system axis information and file system units from the file.
| pAxisSystem | Axis system in file |
| pSystemUnits | System unit in file |
false.Reimplemented in FbxReaderCollada, FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 172 of file fbxreader.h.
{ return false; }
| virtual bool GetStatistics | ( | FbxStatistics * | ) | [inline, virtual] |
Returns statistics from the file.
| pStats | Statistics in the file. |
false.Reimplemented in FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 178 of file fbxreader.h.
{ return false; }
| virtual bool GetFrameRate | ( | FbxTime::EMode & | pTimeMode | ) | [inline, virtual] |
Get FBX file time mode read from GlobalSettings in FBX 6.n and FBX 7.n.
| pTimeMode | ref to a FbxTime::EMode enum |
true on success, false
otherwise.Reimplemented in FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 186 of file fbxreader.h.
{ pTimeMode = FbxTime::eDefaultMode; return false; }
| virtual FbxDocumentInfo* GetSceneInfo | ( | ) | [inline, virtual] |
Returns the scene info from the file.
Reimplemented in FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 192 of file fbxreader.h.
{return NULL;}
| virtual FbxArray<FbxTakeInfo*>* GetTakeInfo | ( | ) | [inline, virtual] |
Returns the list of take infos from the file.
Reimplemented in FbxReaderCollada, FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 197 of file fbxreader.h.
{return NULL;}
| virtual bool GetDefaultRenderResolution | ( | FbxString & | pCamName, |
| FbxString & | pResolutionMode, | ||
| double & | pW, | ||
| double & | pH | ||
| ) | [virtual] |
If default camera resolution is OK, returns information about the resolution of the render.
| pCamName | Default camera name. |
| pResolutionMode | Default resolution mode. |
| pW | Default resolution width. |
| pH | Default resolution height. |
true If default camera resolution is OK,
false Otherwise.| bool IsGenuine | ( | ) |
Judges if the format of the file is was created by an Autodesk plug-in.
An internal (genuine) plug-in is one created by the Autodesk FBX product team.
true If the file format is internal plug-in ,
false Otherwise.| virtual FbxIOSettings* GetIOSettings | ( | ) | [virtual] |
Access to a IOSettings object.
| virtual void SetIOSettings | ( | FbxIOSettings * | pIOSettings | ) | [virtual] |
Set the IOSettings pointer to be used for this reader instance.
| pIOSettings |
| virtual void SetProgressHandler | ( | FbxProgress * | ) | [inline, virtual] |
Pass a progress handler to the reader.
| pProgress | FbxProgress to store the progress information. |
Reimplemented in FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 228 of file fbxreader.h.
{}
| virtual void SetEmbeddingExtractionFolder | ( | const char * | ) | [inline, virtual] |
Reimplemented in FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.
Definition at line 230 of file fbxreader.h.
{}
| virtual bool SupportsStreams | ( | ) | const [virtual] |
Returns true if this reader supports FbxStream I/O.
Default value is false.
Reimplemented in FbxReaderFbx5, FbxReaderFbx6, and FbxReaderFbx7.