HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
SdfTextFileFormat Class Reference

#include <textFileFormat.h>

+ Inheritance diagram for SdfTextFileFormat:

Public Member Functions

virtual SDF_API bool CanRead (const std::string &file) const override
 Returns true if file can be read by this format. More...
 
virtual SDF_API bool Read (SdfLayer *layer, const std::string &resolvedPath, bool metadataOnly) const override
 
virtual SDF_API bool WriteToFile (const SdfLayer &layer, const std::string &filePath, const std::string &comment=std::string(), const FileFormatArguments &args=FileFormatArguments()) const override
 
virtual SDF_API bool ReadFromString (SdfLayer *layer, const std::string &str) const override
 
virtual SDF_API bool WriteToString (const SdfLayer &layer, std::string *str, const std::string &comment=std::string()) const override
 
virtual SDF_API bool WriteToStream (const SdfSpecHandle &spec, std::ostream &out, size_t indent) const override
 Write the provided spec to out indented indent levels. More...
 
- Public Member Functions inherited from SdfFileFormat
 SdfFileFormat (const SdfFileFormat &)=delete
 
SdfFileFormatoperator= (const SdfFileFormat &)=delete
 
SDF_API const SdfSchemaBaseGetSchema () const
 Returns the schema for this format. More...
 
SDF_API const TfTokenGetFormatId () const
 Returns the format identifier. More...
 
SDF_API const TfTokenGetTarget () const
 Returns the target for this file format. More...
 
SDF_API const std::stringGetFileCookie () const
 Returns the cookie to be used when writing files with this format. More...
 
SDF_API const TfTokenGetVersionString () const
 Returns the current version of this file format. More...
 
SDF_API bool IsPrimaryFormatForExtensions () const
 
SDF_API const std::vector
< std::string > & 
GetFileExtensions () const
 Returns a list of extensions that this format supports. More...
 
SDF_API const std::stringGetPrimaryFileExtension () const
 
SDF_API bool IsSupportedExtension (const std::string &extension) const
 
virtual SDF_API bool IsPackage () const
 
virtual SDF_API std::string GetPackageRootLayerPath (const std::string &resolvedPath) const
 
virtual SDF_API FileFormatArguments GetDefaultFileFormatArguments () const
 
virtual SDF_API
SdfAbstractDataRefPtr 
InitData (const FileFormatArguments &args) const
 
SDF_API SdfAbstractDataRefPtr InitDetachedData (const FileFormatArguments &args) const
 
SDF_API SdfLayerRefPtr NewLayer (const SdfFileFormatConstPtr &fileFormat, const std::string &identifier, const std::string &realPath, const ArAssetInfo &assetInfo, const FileFormatArguments &args) const
 Instantiate a layer. More...
 
SDF_API bool ShouldSkipAnonymousReload () const
 
SDF_API bool ShouldReadAnonymousLayers () const
 
SDF_API bool ReadDetached (SdfLayer *layer, const std::string &resolvedPath, bool metadataOnly) const
 
virtual SDF_API std::set
< std::string
GetExternalAssetDependencies (const SdfLayer &layer) const
 
SDF_API bool SupportsReading () const
 
SDF_API bool SupportsWriting () const
 
SDF_API bool SupportsEditing () const
 
- Public Member Functions inherited from TfRefBase
 TfRefBase ()
 
size_t GetCurrentCount () const
 Return the current reference count of this object. More...
 
bool IsUnique () const
 Return true if only one TfRefPtr points to this object. More...
 
const TfRefCountGetRefCount () const
 
void SetShouldInvokeUniqueChangedListener (bool shouldCall)
 
- Public Member Functions inherited from TfWeakBase
 TfWeakBase ()
 
 TfWeakBase (const TfWeakBase &)
 
const TfWeakBase__GetTfWeakBase__ () const
 
const TfWeakBaseoperator= (const TfWeakBase &)
 
void EnableNotification2 () const
 
TF_API void constGetUniqueIdentifier () const
 

Protected Member Functions

virtual SDF_API ~SdfTextFileFormat ()
 Destructor. More...
 
SDF_API SdfTextFileFormat ()
 Constructor. More...
 
SDF_API SdfTextFileFormat (const TfToken &formatId, const TfToken &versionString=TfToken(), const TfToken &target=TfToken())
 
SDF_API bool _CanReadFromAsset (const std::string &resolvedPath, const std::shared_ptr< ArAsset > &asset) const
 Return true if layer can be read from asset at resolvedPath. More...
 
SDF_API bool _ReadFromAsset (SdfLayer *layer, const std::string &resolvedPath, const std::shared_ptr< ArAsset > &asset, bool metadataOnly) const
 Read layer from asset at resolvedPath into layer. More...
 
- Protected Member Functions inherited from SdfFileFormat
SDF_API SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::string &extension)
 Constructor. More...
 
SDF_API SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::string &extension, const SdfSchemaBase &schema)
 
 SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::string &extension, const SdfSchemaBase &&schema)=delete
 Disallow temporary SdfSchemaBase objects being passed to the c'tor. More...
 
SDF_API SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::vector< std::string > &extensions)
 Constructor. More...
 
SDF_API SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::vector< std::string > &extensions, const SdfSchemaBase &schema)
 
 SdfFileFormat (const TfToken &formatId, const TfToken &versionString, const TfToken &target, const std::vector< std::string > &extensions, const SdfSchemaBase &&schema)=delete
 Disallow temporary SdfSchemaBase objects being passed to the c'tor. More...
 
virtual SDF_API ~SdfFileFormat ()
 Destructor. More...
 
SDF_API bool _ReadAndCopyLayerDataToMemory (SdfLayer *layer, const std::string &resolvedPath, bool metadataOnly, bool *didCopyData=nullptr) const
 
virtual SDF_API SdfLayer_InstantiateNewLayer (const SdfFileFormatConstPtr &fileFormat, const std::string &identifier, const std::string &realPath, const ArAssetInfo &assetInfo, const FileFormatArguments &args) const
 
virtual SDF_API bool _ShouldReadAnonymousLayers () const
 
virtual SDF_API
SdfAbstractDataRefPtr 
_InitDetachedData (const FileFormatArguments &args) const
 
virtual SDF_API bool _ReadDetached (SdfLayer *layer, const std::string &resolvedPath, bool metadataOnly) const
 
- Protected Member Functions inherited from TfRefBase
virtual TF_API ~TfRefBase ()
 
- Protected Member Functions inherited from TfWeakBase
 ~TfWeakBase ()
 
TfRefPtr< Tf_Remnant_Register () const
 
template<class T >
TfRefPtr< Tf_Remnant_Register (T *tempRmnt) const
 
bool _HasRemnant () const
 

Protected Attributes

 SDF_FILE_FORMAT_FACTORY_ACCESS
 

Additional Inherited Members

- Public Types inherited from SdfFileFormat
typedef std::map< std::string,
std::string
FileFormatArguments
 
- Public Types inherited from TfRefBase
typedef void(* UniqueChangedFuncPtr )(TfRefBase const *, bool)
 
- Static Public Member Functions inherited from SdfFileFormat
static SDF_API std::string GetFileExtension (const std::string &s)
 
static SDF_API std::set
< std::string
FindAllFileFormatExtensions ()
 
static SDF_API std::set
< std::string
FindAllDerivedFileFormatExtensions (const TfType &baseType)
 
static SDF_API bool FormatSupportsReading (const std::string &extension, const std::string &target=std::string())
 
static SDF_API bool FormatSupportsWriting (const std::string &extension, const std::string &target=std::string())
 
static SDF_API bool FormatSupportsEditing (const std::string &extension, const std::string &target=std::string())
 
static SDF_API
SdfFileFormatConstPtr 
FindById (const TfToken &formatId)
 
static SDF_API
SdfFileFormatConstPtr 
FindByExtension (const std::string &path, const std::string &target=std::string())
 
static SDF_API
SdfFileFormatConstPtr 
FindByExtension (const std::string &path, const FileFormatArguments &args)
 
- Static Public Member Functions inherited from TfRefBase
static TF_API void SetUniqueChangedListener (UniqueChangedListener listener)
 
- Static Protected Member Functions inherited from SdfFileFormat
static SDF_API void _SetLayerData (SdfLayer *layer, SdfAbstractDataRefPtr &data)
 
static SDF_API void _SetLayerData (SdfLayer *layer, SdfAbstractDataRefPtr &data, SdfLayerHints hints)
 
static SDF_API
SdfAbstractDataConstPtr 
_GetLayerData (const SdfLayer &layer)
 Get the internal data for layer. More...
 

Detailed Description

Sdf text file format

Definition at line 58 of file textFileFormat.h.

Constructor & Destructor Documentation

virtual SDF_API SdfTextFileFormat::~SdfTextFileFormat ( )
protectedvirtual

Destructor.

SDF_API SdfTextFileFormat::SdfTextFileFormat ( )
protected

Constructor.

SDF_API SdfTextFileFormat::SdfTextFileFormat ( const TfToken formatId,
const TfToken versionString = TfToken(),
const TfToken target = TfToken() 
)
explicitprotected

Constructor. This form of the constructor may be used by formats that use the .sdf text format as their internal representation. If a non-empty versionString and target are provided, they will be used as the file format version and target; otherwise the .sdf format version and target will be implicitly used.

Member Function Documentation

SDF_API bool SdfTextFileFormat::_CanReadFromAsset ( const std::string resolvedPath,
const std::shared_ptr< ArAsset > &  asset 
) const
protected

Return true if layer can be read from asset at resolvedPath.

SDF_API bool SdfTextFileFormat::_ReadFromAsset ( SdfLayer layer,
const std::string resolvedPath,
const std::shared_ptr< ArAsset > &  asset,
bool  metadataOnly 
) const
protected

Read layer from asset at resolvedPath into layer.

virtual SDF_API bool SdfTextFileFormat::CanRead ( const std::string file) const
overridevirtual

Returns true if file can be read by this format.

Implements SdfFileFormat.

virtual SDF_API bool SdfTextFileFormat::Read ( SdfLayer layer,
const std::string resolvedPath,
bool  metadataOnly 
) const
overridevirtual

Reads scene description from the asset specified by resolvedPath into the layer layer.

metadataOnly is a flag that asks for only the layer metadata to be read in, which can be much faster if that is all that is required. Note that this is just a hint: some FileFormat readers may disregard this flag and still fully populate the layer contents.

Returns true if the asset is successfully read into layer, false otherwise.

Implements SdfFileFormat.

virtual SDF_API bool SdfTextFileFormat::ReadFromString ( SdfLayer layer,
const std::string str 
) const
overridevirtual

Reads data in the string str into the layer layer. If the file is successfully read, this method returns true. Otherwise, false is returned and errors are posted.

Reimplemented from SdfFileFormat.

virtual SDF_API bool SdfTextFileFormat::WriteToFile ( const SdfLayer layer,
const std::string filePath,
const std::string comment = std::string(),
const FileFormatArguments args = FileFormatArguments() 
) const
overridevirtual

Writes the content in layer into the file at filePath. If the content is successfully written, this method returns true. Otherwise, false is returned and errors are posted. The default implementation returns false.

Reimplemented from SdfFileFormat.

virtual SDF_API bool SdfTextFileFormat::WriteToStream ( const SdfSpecHandle &  spec,
std::ostream &  out,
size_t  indent 
) const
overridevirtual

Write the provided spec to out indented indent levels.

Reimplemented from SdfFileFormat.

virtual SDF_API bool SdfTextFileFormat::WriteToString ( const SdfLayer layer,
std::string str,
const std::string comment = std::string() 
) const
overridevirtual

Writes the content in layer to the string str. This function should write a textual representation of layer to the stream that can be read back in via ReadFromString.

Reimplemented from SdfFileFormat.

Member Data Documentation

SdfTextFileFormat::SDF_FILE_FORMAT_FACTORY_ACCESS
protected

Definition at line 96 of file textFileFormat.h.


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