PdfToolbox_PtxSys.h File Reference

#include <stdarg.h>
#include <stdio.h>

Go to the source code of this file.

Classes
struct	TPtxSys_StreamDescriptor
	Structure that groups a set of callbacks that model streams. More...

Macros
#define	PtxSys_PathStreamDescriptor_Create   PtxSys_PathStreamDescriptor_CreateA

Typedefs
typedef pos_t(STDCALL *	TGetLength) (void *handle)
typedef int(STDCALL *	TSeek) (void *handle, pos_t iPos)
typedef pos_t(STDCALL *	TTell) (void *handle)
typedef size_t(STDCALL *	TRead) (void *handle, void *pData, size_t nSize)
typedef size_t(STDCALL *	TWrite) (void *handle, const void *pData, size_t nSize)
typedef void(STDCALL *	TRelease) (void *handle)
typedef struct TPtxSys_StreamDescriptor	TPtxSys_StreamDescriptor
	Structure that groups a set of callbacks that model streams.

Functions
static pos_t STDCALL	PtxSysFILEPtrGetLength__ (void *handle)
	Callback implementation for TPtxSys_StreamDescriptor::pfGetLength for FILE*.
static int STDCALL	PtxSysFILEPtrSeek__ (void *handle, pos_t iPos)
	Callback implementation for TPtxSys_StreamDescriptor::pfSeek for FILE*.
static pos_t STDCALL	PtxSysFILEPtrTell__ (void *handle)
	Callback implementation for TPtxSys_StreamDescriptor::pfTell for FILE*.
static size_t STDCALL	PtxSysFILEPtrRead__ (void *handle, void *pData, size_t nSize)
	Callback implementation for TPtxSys_StreamDescriptor::pfRead for FILE*.
static size_t STDCALL	PtxSysFILEPtrWrite__ (void *handle, const void *pData, size_t nSize)
	Callback implementation for TPtxSys_StreamDescriptor::pfWrite for FILE*.
static void STDCALL	PtxSysFILEPtrRelease__ (void *handle)
	Callback implementation for TPtxSys_StreamDescriptor::pfRelease for FILE*.
static void	PtxSysCreateFILEStreamDescriptor (TPtxSys_StreamDescriptor *pDescriptor, FILE *handle, int bCloseOnRelease)
	Initialization function for TPtxSys_StreamDescriptor for FILE*.
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL	PtxSys_PathStreamDescriptor_CreateA (TPtxSys_StreamDescriptor *pDescriptor, const char *szPath, BOOL bIsReadOnly)
	Initialization function for TPtxSys_StreamDescriptor for a given path.
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL	PtxSys_PathStreamDescriptor_CreateW (TPtxSys_StreamDescriptor *pDescriptor, const WCHAR *szPath, BOOL bIsReadOnly)
	Initialization function for TPtxSys_StreamDescriptor for a given path.
PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL	PtxSys_PathStreamDescriptor_Close (TPtxSys_StreamDescriptor *pDescriptor)
	Close the underlying file.
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL	PtxSys_MemoryStreamDescriptor_Create (TPtxSys_StreamDescriptor *pDescriptor)
	Initialization function for TPtxSys_StreamDescriptor for the usage as memory streams.
PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL	PtxSys_MemoryStreamDescriptor_Close (TPtxSys_StreamDescriptor *pDescriptor)
	Delete the underlying buffer.
PDFTOOLBOX_EXPORT pos_t PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_GetLength (TPtxSys_StreamDescriptor *pStreamDescriptor)
PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_Seek (TPtxSys_StreamDescriptor *pStreamDescriptor, pos_t iPos)
PDFTOOLBOX_EXPORT pos_t PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_Tell (TPtxSys_StreamDescriptor *pStreamDescriptor)
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_Read (TPtxSys_StreamDescriptor *pStreamDescriptor, void *pData, size_t nSize)
PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_Write (TPtxSys_StreamDescriptor *pStreamDescriptor, const void *pData, size_t nSize)
PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL	PtxSys_StreamDescriptor_Release (TPtxSys_StreamDescriptor *pStreamDescriptor)

Macro Definition Documentation

PtxSys_PathStreamDescriptor_Create

#define PtxSys_PathStreamDescriptor_Create   PtxSys_PathStreamDescriptor_CreateA

Typedef Documentation

TGetLength

typedef pos_t(STDCALL * TGetLength) (void *handle)

TPtxSys_StreamDescriptor

typedef struct TPtxSys_StreamDescriptor TPtxSys_StreamDescriptor

Structure that groups a set of callbacks that model streams.

TRead

typedef size_t(STDCALL * TRead) (void *handle, void *pData, size_t nSize)

TRelease

typedef void(STDCALL * TRelease) (void *handle)

TSeek

typedef int(STDCALL * TSeek) (void *handle, pos_t iPos)

TTell

typedef pos_t(STDCALL * TTell) (void *handle)

TWrite

typedef size_t(STDCALL * TWrite) (void *handle, const void *pData, size_t nSize)

Function Documentation

PtxSys_MemoryStreamDescriptor_Close()

PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL PtxSys_MemoryStreamDescriptor_Close

(

TPtxSys_StreamDescriptor *

pDescriptor

)

Delete the underlying buffer.

Parameters

[in]

pDescriptor

Pointer to the TPtxSys_StreamDescriptor that wraps the underlying buffer.

PtxSys_MemoryStreamDescriptor_Create()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxSys_MemoryStreamDescriptor_Create

(

TPtxSys_StreamDescriptor *

pDescriptor

)

Initialization function for TPtxSys_StreamDescriptor for the usage as memory streams.

Parameters

[out]

pDescriptor

Stream descriptor that is initialized.

Returns

TRUE memory stream initalized successfully; FALSE failed to initialize memory stream.

PtxSys_PathStreamDescriptor_Close()

PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL PtxSys_PathStreamDescriptor_Close

(

TPtxSys_StreamDescriptor *

pDescriptor

)

Close the underlying file.

Parameters

[in]

pDescriptor

Pointer to the TPtxSys_StreamDescriptor that wraps the file.

PtxSys_PathStreamDescriptor_CreateA()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxSys_PathStreamDescriptor_CreateA	(	TPtxSys_StreamDescriptor *	pDescriptor,
		const char *	szPath,
		BOOL	bIsReadOnly )

Initialization function for TPtxSys_StreamDescriptor for a given path.

Parameters

[out]	pDescriptor	Stream descriptor that is initialized.
[in]	szPath	Path to a file for which a stream descriptor shall be initialized.
[in]	bIsReadOnly	If set TRUE the stream only allows for reading; if set to FALSE the stream allows for reading and writing.

Returns

TRUE file opened successfully; FALSE failed to open the file.

PtxSys_PathStreamDescriptor_CreateW()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxSys_PathStreamDescriptor_CreateW	(	TPtxSys_StreamDescriptor *	pDescriptor,
		const WCHAR *	szPath,
		BOOL	bIsReadOnly )

Initialization function for TPtxSys_StreamDescriptor for a given path.

Parameters

[out]	pDescriptor	Stream descriptor that is initialized.
[in]	szPath	Path to a file for which a stream descriptor shall be initialized.
[in]	bIsReadOnly	If set TRUE the stream only allows for reading; if set to FALSE the stream allows for reading and writing.

Returns

TRUE file opened successfully; FALSE failed to open the file.

PtxSys_StreamDescriptor_GetLength()

PDFTOOLBOX_EXPORT pos_t PDFTOOLBOX_CALL PtxSys_StreamDescriptor_GetLength

(

TPtxSys_StreamDescriptor *

pStreamDescriptor

)

PtxSys_StreamDescriptor_Read()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxSys_StreamDescriptor_Read	(	TPtxSys_StreamDescriptor *	pStreamDescriptor,
		void *	pData,
		size_t	nSize )

PtxSys_StreamDescriptor_Release()

PDFTOOLBOX_EXPORT void PDFTOOLBOX_CALL PtxSys_StreamDescriptor_Release

(

TPtxSys_StreamDescriptor *

pStreamDescriptor

)

PtxSys_StreamDescriptor_Seek()

PDFTOOLBOX_EXPORT BOOL PDFTOOLBOX_CALL PtxSys_StreamDescriptor_Seek	(	TPtxSys_StreamDescriptor *	pStreamDescriptor,
		pos_t	iPos )

PtxSys_StreamDescriptor_Tell()

PDFTOOLBOX_EXPORT pos_t PDFTOOLBOX_CALL PtxSys_StreamDescriptor_Tell

(

TPtxSys_StreamDescriptor *

pStreamDescriptor

)

PtxSys_StreamDescriptor_Write()

PDFTOOLBOX_EXPORT size_t PDFTOOLBOX_CALL PtxSys_StreamDescriptor_Write	(	TPtxSys_StreamDescriptor *	pStreamDescriptor,
		const void *	pData,
		size_t	nSize )

PtxSysCreateFILEStreamDescriptor()

static void PtxSysCreateFILEStreamDescriptor ( TPtxSys_StreamDescriptor * pDescriptor, FILE * handle, int bCloseOnRelease )

static

Initialization function for TPtxSys_StreamDescriptor for FILE*.

Parameters

[out]	pDescriptor	FILE* stream descriptor that is initialized.
[in]	handle	Handle of stream.
[in]	bCloseOnRelease	Determines if the stream needs to be explicitly closed by fclose((FILE*)handle). If set TRUE the stream does not need to be explicitly closed; if set FALSE the stream needs to be explicitly closed.

PtxSysFILEPtrGetLength__()

static pos_t STDCALL PtxSysFILEPtrGetLength__ ( void * handle )

static

Callback implementation for TPtxSys_StreamDescriptor::pfGetLength for FILE*.

Parameters

[in,out]

handle

Handle of stream.

Returns

Length of stream in bytes. -1 in case of an error.

PtxSysFILEPtrRead__()

static size_t STDCALL PtxSysFILEPtrRead__ ( void * handle, void * pData, size_t nSize )

static

Callback implementation for TPtxSys_StreamDescriptor::pfRead for FILE*.

Read from stream into buffer

Parameters

[in,out]	handle	Handle of stream.
[out]	pData	Pointer to the buffer to which the data from the stream is written.
[in]	nSize	Size in bytes of the stream to be read.

Returns

Number of bytes read; 0 for end of stream, -1 in case of an error.

PtxSysFILEPtrRelease__()

static void STDCALL PtxSysFILEPtrRelease__ ( void * handle )

static

Callback implementation for TPtxSys_StreamDescriptor::pfRelease for FILE*.

Release handle to stream.

Parameters

[in,out]

handle

Handle of stream.

PtxSysFILEPtrSeek__()

static int STDCALL PtxSysFILEPtrSeek__ ( void * handle, pos_t iPos )

static

Callback implementation for TPtxSys_StreamDescriptor::pfSeek for FILE*.

Set new stream position.

Parameters

[in,out]	handle	Handle of stream.
[in]	iPos	Byte position of stream. -1 set position to end of stream.

Returns

1 for success; 0 for failure.

PtxSysFILEPtrTell__()

static pos_t STDCALL PtxSysFILEPtrTell__ ( void * handle )

static

Callback implementation for TPtxSys_StreamDescriptor::pfTell for FILE*.

Get current position of stream.

Parameters

[in,out]

handle

Handle of stream.

Returns

Current byte position of stream; -1 if position is unknown.

PtxSysFILEPtrWrite__()

static size_t STDCALL PtxSysFILEPtrWrite__ ( void * handle, const void * pData, size_t nSize )

static

Callback implementation for TPtxSys_StreamDescriptor::pfWrite for FILE*.

Write to stream from buffer

Parameters

[in,out]	handle	Handle of stream.
[in]	pData	Pointer to the buffer from which data is written to the stream.
[in]	nSize	Size in bytes to be written.

Returns

Number of bytes written to stream; 0 or -1 indicate an error.