kfbxutilities.h File Reference

---

Detailed Description

Definition in file kfbxutilities.h.

#include <fbxfilesdk/fbxfilesdk_def.h>
#include <fbxfilesdk/kfbxplugins/kfbxscene.h>
#include <fbxfilesdk/fbxfilesdk_nsbegin.h>
#include <fbxfilesdk/fbxfilesdk_nsend.h>

Include dependency graph for kfbxutilities.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
class	KFbxFile
	Generic utility class to manipulate files on different file systems similarly. More...
Enumerations
enum	eFileMode {    KFBX_READ,    KFBX_WRITE,    KFBX_READWRITE,    KFBX_APPEND }
	File open mode. More...
enum	eSeekPos {    KFBX_BEGIN,    KFBX_CURRENT,    KFBX_END }
	File seek mode. More...
Functions
Scene cleaning
KFBX_DLL KArrayTemplate < KFbxNode * >	RemoveBadPolygonsFromMeshes (KFbxScene *pScene)
	Clean bad meshes in the scene by removing bad polygons.
Animation query functions
KFBX_DLL bool	IsAnimated (KFbxObject *pObj)
	Inspects all the properties of the given object for animation curves.
KFBX_DLL bool	IsChannelAnimated (KFbxObject *pObj, char *pPropertyName, char *pChannelName=NULL)
	Inspects the specified property of the given object for animation curves.
File utilities
KFBX_DLL char *	FBXGet_Internet_Source_File (const char *url)
	Get the content of a file from an hyper link.
KFBX_DLL void	FBXFree_Internet_Buffer (char *pBuf)
	Free the memory allocated by FBXGet_Internet_Source_File().
KFBX_DLL KString	KFbxFullPath (const char *pRelativePath)
	Get the full path of given path (if the given path is relative path, it will take current directory as default root path.
KFBX_DLL KString	KFbxExtractDirectory (const char *pFilePath)
	Extract Directory from the given file path.
KFBX_DLL KString	KFbxExtractFileName (const char *pFilePath, bool pWithExtension=true)
	Extract file name from the given file path.
KFBX_DLL KString	KFbxExtractFileExtension (const char *pFilePath)
	Extract the given file's extension.
KFBX_DLL KString	KFbxChangeFileExtension (const char *pFilePath, const char *pNewExtension)
	This function is used to change the given file's extension with given new extension, if the given file haven't extension,it will directly add the new extension at the end of given file.
KFBX_DLL KString	KFbxCleanPath (const char *pFilePath)
	Clean the redundant and useless denotations in given path name.
KFBX_DLL KString	KFbxGetRelativeFilePath (const char *pRootPath, const char *pNewFilePath)
	Get the given new path's relative path to the given root path.
KFBX_DLL bool	KFbxIsRelativePath (const char *pFilePath)
	Test if the given path is relative path, if it is return true.
KFBX_DLL bool	KFbxFileExist (const char *pFilePath)
	Find if the given file exist.If the given file without directory, it will find the file in the work directory.
KFBX_DLL bool	KFbxEnsureDirectoryExistance (const char *pFilePath)
	Test if the given directory exists, if the directory does not exist, it will create this directory.
KFBX_DLL KString	KFbxGetApplicationDirectory ()
	Get the application directory.
KFBX_DLL KString	KFbxMakeFullPath (const char *pRootPath, const char *pFilePath)
	Get the full path.
KFBX_DLL KString	KFbxGetCurrentDirectory ()
	Get the current path.
KFBX_DLL size_t	KGetProcessVirtualMemoryAvailSize ()
	Returns the amount of virtual memory available to the process; will take into account swap file, and the process address space if there are such limits (ie: Win32 process can access 2, 3 or 4gb depending on the OS they're running on, Win64 has a much larger limit, limited possibly by the swap file).

---

Enumeration Type Documentation

enum eFileMode

File open mode.

• KFBX_READ
• KFBX_WRITE
• KFBX_READWRITE
• KFBX_APPEND

Enumerator:

KFBX_READ
KFBX_WRITE
KFBX_READWRITE
KFBX_APPEND

Definition at line 204 of file kfbxutilities.h.

enum eSeekPos

File seek mode.

• KFBX_BEGIN
• KFBX_CURRENT
• KFBX_END

Enumerator:

KFBX_BEGIN
KFBX_CURRENT
KFBX_END

Definition at line 211 of file kfbxutilities.h.

---

Function Documentation

KFBX_DLL void FBXFree_Internet_Buffer

(

char *

pBuf

)

Free the memory allocated by FBXGet_Internet_Source_File().

Parameters:

pBuf

Pointer previously returned by a call to FBXGet_Internet_Source_File().

KFBX_DLL char* FBXGet_Internet_Source_File

(

const char *

url

)

Get the content of a file from an hyper link.

Parameters:

url

The hyper link to the file. The URL must start with < http:// > ex: http://www.autodesk.com.

Returns:

An allocated <char *buffer> containing the source text. You must use FBXFree_Internet_Buffer() to free the allocated memory.

KFBX_DLL bool IsAnimated

(

KFbxObject *

pObj

)

Inspects all the properties of the given object for animation curves.

Parameters:

pObj

Pointer to the object to query.

Returns:

true if at least one property is animated and false otherwise.

Remarks:

A property is animated if it contains at least one KFbxAnimCurve with keys.

KFBX_DLL bool IsChannelAnimated	(	KFbxObject *	pObj,
		char *	pPropertyName,
		char *	pChannelName = NULL
	)

Inspects the specified property of the given object for animation curves.

Parameters:

	pObj	Pointer to the object to query.
	pPropertyName	Name of the inspected property.
	pChannelName	Name of the specific channel of the inspected property.

Returns:

true if the specified channel is animated and false otherwise.

Remarks:

A property is animated if it contains at least one KFbxAnimCurve with keys.

KFBX_DLL KString KFbxChangeFileExtension	(	const char *	pFilePath,
		const char *	pNewExtension
	)

This function is used to change the given file's extension with given new extension, if the given file haven't extension,it will directly add the new extension at the end of given file.

The given new extension must add "." before the extension name.

Parameters:

	pFilePath	The old file path.
	pNewExtension	The given new extension, it must add "." before the extension name

Returns:

New file path with new extension name.

KFBX_DLL KString KFbxCleanPath

(

const char *

pFilePath

)

Clean the redundant and useless denotations in given path name.

Parameters:

pFilePath

The file path.

Returns:

Cleaned path.

KFBX_DLL bool KFbxEnsureDirectoryExistance

(

const char *

pFilePath

)

Test if the given directory exists, if the directory does not exist, it will create this directory.

Parameters:

pFilePath

The given file path

Returns:

True if the directory exists or is created successfully, False if the directory does not exist nor isn't created successfully.

KFBX_DLL KString KFbxExtractDirectory

(

const char *

pFilePath

)

Extract Directory from the given file path.

Parameters:

pFilePath

The given file path.

Returns:

The directory without file name.If there isn't any '\' or '/' in the given file path, it will directly return the given file path.

KFBX_DLL KString KFbxExtractFileExtension

(

const char *

pFilePath

)

Extract the given file's extension.

Parameters:

pFilePath

The given file path.

Returns:

The file extension.

KFBX_DLL KString KFbxExtractFileName	(	const char *	pFilePath,
		bool	pWithExtension = true
	)

Extract file name from the given file path.

Parameters:

	pFilePath	The given file path.
	pWithExtension	Decide the file name with extension or without extension. If it is true, return the file name with extension,if it is false, return the file name without extension.

Returns:

The file name.

KFBX_DLL bool KFbxFileExist

(

const char *

pFilePath

)

Find if the given file exist.If the given file without directory, it will find the file in the work directory.

Parameters:

pFilePath

The given file path.

Returns:

True if the file exists, false otherwise.

KFBX_DLL KString KFbxFullPath

(

const char *

pRelativePath

)

Get the full path of given path (if the given path is relative path, it will take current directory as default root path.

)

Parameters:

pRelativePath

The relative path.

Returns:

Full path

KFBX_DLL KString KFbxGetApplicationDirectory

(

)

Get the application directory.

Returns:

The application directory.

KFBX_DLL KString KFbxGetCurrentDirectory

(

)

Get the current path.

Returns:

The current directory.

KFBX_DLL KString KFbxGetRelativeFilePath	(	const char *	pRootPath,
		const char *	pNewFilePath
	)

Get the given new path's relative path to the given root path.

Parameters:

	pRootPath	The root path.
	pNewFilePath	The given new path.

Returns:

The relative path.

KFBX_DLL bool KFbxIsRelativePath

(

const char *

pFilePath

)

Test if the given path is relative path, if it is return true.

Parameters:

pFilePath

The given file path.

Returns:

True if it is a relative path, false otherwise.

KFBX_DLL KString KFbxMakeFullPath	(	const char *	pRootPath,
		const char *	pFilePath
	)

Get the full path.

Parameters:

	pRootPath	The root path.
	pFilePath	The file path.

KFBX_DLL size_t KGetProcessVirtualMemoryAvailSize

(

)

Returns the amount of virtual memory available to the process; will take into account swap file, and the process address space if there are such limits (ie: Win32 process can access 2, 3 or 4gb depending on the OS they're running on, Win64 has a much larger limit, limited possibly by the swap file).

KFBX_DLL KArrayTemplate<KFbxNode*> RemoveBadPolygonsFromMeshes

(

KFbxScene *

pScene

)

Clean bad meshes in the scene by removing bad polygons.

Parameters:

pScene

Pointer to the scene object.

Returns:

Array of nodes containing modified meshes.