Ptex
Public Types | Public Member Functions | Protected Member Functions | List of all members
PtexInputHandler Class Referenceabstract

Custom handler interface for intercepting and redirecting Ptex input stream calls. More...

#include <Ptexture.h>

Inheritance diagram for PtexInputHandler:
PtexReader::DefaultInputHandler

Public Types

typedef void * Handle
 

Public Member Functions

virtual Handle open (const char *path)=0
 Open a file in read mode.
 
virtual void seek (Handle handle, int64_t pos)=0
 Seek to an absolute byte position in the input stream.
 
virtual size_t read (void *buffer, size_t size, Handle handle)=0
 Read a number of bytes from the file.
 
virtual bool close (Handle handle)=0
 Close a file.
 
virtual const char * lastError ()=0
 Return the last error message encountered.
 

Protected Member Functions

virtual ~PtexInputHandler ()
 

Detailed Description

Custom handler interface for intercepting and redirecting Ptex input stream calls.

A custom instance of this class can be defined and supplied to the PtexCache class. Files accessed through the cache will have their input streams redirected through this interface.

Definition at line 619 of file Ptexture.h.

Member Typedef Documentation

◆ Handle

typedef void* PtexInputHandler::Handle

Definition at line 624 of file Ptexture.h.

Constructor & Destructor Documentation

◆ ~PtexInputHandler()

virtual PtexInputHandler::~PtexInputHandler ( )
inlineprotectedvirtual

Definition at line 621 of file Ptexture.h.

Member Function Documentation

◆ close()

virtual bool PtexInputHandler::close ( Handle  handle)
pure virtual

Close a file.

Returns false if an error occurs, and the error string is available via lastError().

Implemented in PtexReader::DefaultInputHandler.

Referenced by PtexReader::closeFP().

◆ lastError()

virtual const char * PtexInputHandler::lastError ( )
pure virtual

Return the last error message encountered.

Implemented in PtexReader::DefaultInputHandler.

Referenced by PtexReader::open().

◆ open()

virtual Handle PtexInputHandler::open ( const char *  path)
pure virtual

Open a file in read mode.

Returns null if there was an error. If an error occurs, the error string is available via lastError().

Implemented in PtexReader::DefaultInputHandler.

Referenced by PtexReader::open(), and PtexReader::reopenFP().

◆ read()

virtual size_t PtexInputHandler::read ( void *  buffer,
size_t  size,
Handle  handle 
)
pure virtual

Read a number of bytes from the file.

Returns the number of bytes successfully read. If less than the requested number of bytes is read, the error string is available via lastError().

Implemented in PtexReader::DefaultInputHandler.

Referenced by PtexReader::readBlock().

◆ seek()

virtual void PtexInputHandler::seek ( Handle  handle,
int64_t  pos 
)
pure virtual

Seek to an absolute byte position in the input stream.

Implemented in PtexReader::DefaultInputHandler.

Referenced by PtexReader::seek().


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