MrSID Decode SDK for Raster Reference Manual 9.5.5.5244
UsingCStream.c
//
// This code is property of Celartem, Inc dba Extensis.
// Copyright (c) 1995-2023. All rights reserved.
// Use permitted only under license from Extensis.
//
/* PUBLIC */
/*
* This demonstrates how to use the C-callable stream class. We provide
* functions which implement a FILE*-based stream, similar in spirit to
* the example class derived in DerivedStream.cpp. Note also that the
* test workflow in this example is the same as in UsingStreams.cpp.
*/
#include "main.h"
#include "support.h"
#include "lt_ioCStream.h"
/*---------------------------------------------------------------------------
* user-level object storing stream data
*-------------------------------------------------------------------------*/
typedef struct StreamData
{
FILE* fp;
char* name;
char* mode;
} StreamData;
static StreamData*
createStreamData(const char* name, const char* mode)
{
StreamData *streamData = (StreamData *)calloc(1, sizeof(StreamData));
streamData->fp = NULL;
streamData->name = strdup(name);
streamData->mode = strdup(mode);
return streamData;
}
static void
deleteStreamData(StreamData *streamData)
{
free(streamData->name);
free(streamData->mode);
free(streamData);
}
/*---------------------------------------------------------------------------
* user functions for C stream
*-------------------------------------------------------------------------*/
static LT_STATUS myOpen(void *user)
{
StreamData *streamData = (StreamData *)user;
streamData->fp = fopen(streamData->name, streamData->mode);
return streamData->fp ? LT_STS_Success : LT_STS_Failure;
}
static LT_STATUS myClose(void *user)
{
StreamData *streamData = (StreamData *)user;
fclose(streamData->fp);
streamData->fp = NULL;
}
static lt_uint32 myRead(void *user, lt_uint8* buf, lt_uint32 len)
{
StreamData *streamData = (StreamData *)user;
return (lt_uint32)fread(buf, 1, len, streamData->fp);
}
static lt_uint32 myWrite(void *user, const lt_uint8* buf, lt_uint32 len)
{
StreamData *streamData = (StreamData *)user;
return (lt_uint32)fwrite(buf, 1, len, streamData->fp);
}
static LT_STATUS mySeek(void *user, lt_int64 pos, LTIOSeekDir dir)
{
StreamData *streamData = (StreamData *)user;
int mydir = 0;
switch (dir)
{
case LTIO_SEEK_DIR_BEG: mydir = SEEK_SET; break;
case LTIO_SEEK_DIR_CUR: mydir = SEEK_CUR; break;
case LTIO_SEEK_DIR_END: mydir = SEEK_END; break;
default: return LT_STS_BadParam;
};
return fseek(streamData->fp, (long)pos, mydir) ?
}
static lt_int64 myTell(void *user)
{
StreamData *streamData = (StreamData *)user;
return ftell(streamData->fp);
}
static lt_uint8 myIsEOF(void *user)
{
StreamData *streamData = (StreamData *)user;
return feof(streamData->fp) != 0;
}
static lt_uint8 myIsOpen(void *user)
{
StreamData *streamData = (StreamData *)user;
return streamData->fp != NULL;
}
static void *myDuplicate(void *user)
{
/* this will leak -- proper implementation would keep a list of
* allocated StreamData objects...
*/
StreamData *streamData = (StreamData *)user;
return createStreamData(streamData->name, streamData->mode);
}
/*---------------------------------------------------------------------------
* show use of C streams
*-------------------------------------------------------------------------*/
LT_STATUS UsingCStream(void)
{
lt_uint8 buf[5];
/* make and open a file-based stream */
StreamData *streamData = createStreamData(INPUT_PATH("meg.hdr"), "r");
LTIOStreamH stream = lt_ioCallbackStreamCreate(myOpen, myClose,
myRead, myWrite,
mySeek, myTell,
myIsEOF, myIsOpen,
myDuplicate,
streamData);
TEST_BOOL(stream != NULL);
TEST_SUCCESS(lt_ioCStreamOpen(stream));
TEST_BOOL(streamData->fp!=NULL);
/* read the first five bytes */
TEST_BOOL(lt_ioCStreamRead(stream,buf, 5) == 5);
TEST_BOOL(strncmp((char*)buf, "NROWS", 5) == 0);
/* seek ahead two bytes */
TEST_SUCCESS(lt_ioCStreamSeek(stream, 2, LTIO_SEEK_DIR_CUR));
TEST_BOOL(lt_ioCStreamTell(stream) == 7);
/* read two more bytes */
TEST_BOOL(lt_ioCStreamRead(stream,buf, 2) == 2);
TEST_BOOL(strncmp((char*)buf, "80", 2)==0);
{
/* duplicate the stream */
TEST_SUCCESS(lt_ioCStreamOpen(stream2));
TEST_BOOL(lt_ioCStreamRead(stream2,buf, 5) == 5);
TEST_BOOL(strncmp((char*)buf, "NROWS", 5)==0);
}
/* all done */
TEST_SUCCESS(lt_ioCStreamClose(stream));
deleteStreamData(streamData);
}
void * LTIOStreamH
opaque pointer to an LTIOStreamInf
lt_int64 lt_ioCStreamTell(LTIOStreamH stream)
tell for C stream
LT_STATUS lt_ioCStreamClose(LTIOStreamH stream)
close C stream
LTIOStreamH lt_ioCStreamDuplicate(LTIOStreamH stream)
duplicate C stream
LT_STATUS lt_ioCStreamSeek(LTIOStreamH stream, lt_int64 offset, LTIOSeekDir dir)
seek for C stream
LT_STATUS lt_ioCStreamOpen(LTIOStreamH stream)
open C stream
lt_uint32 lt_ioCStreamRead(LTIOStreamH stream, lt_uint8 *buf, lt_uint32 len)
read C stream
LTIOStreamH lt_ioCallbackStreamCreate(LTIOCallbackStream_Open open, LTIOCallbackStream_Close close, LTIOCallbackStream_Read read, LTIOCallbackStream_Write write, LTIOCallbackStream_Seek seek, LTIOCallbackStream_Tell tell, LTIOCallbackStream_IsEOF isEOF, LTIOCallbackStream_IsOpen isOpen, LTIOCallbackStream_Duplicate duplicate, void *userData)
create callback stream
LTIOSeekDir
Stream seek directions.
Definition: lt_lib_io.h:26
@ LTIO_SEEK_DIR_BEG
Offset from the beginning of the file.
Definition: lt_lib_io.h:31
@ LTIO_SEEK_DIR_CUR
Offset from the current read/write position.
Definition: lt_lib_io.h:34
@ LTIO_SEEK_DIR_END
Offset from the end of the file (offsets need to be negative to be valid)
Definition: lt_lib_io.h:37
lt_uint32 LT_STATUS
An integral status code.
Definition: lt_status.h:30
#define LT_STS_Uninit
status code indicating unintialized variable
Definition: lt_status.h:60
#define LT_STS_Failure
status code indicating failure
Definition: lt_status.h:51
#define LT_STS_Success
status code indicating success
Definition: lt_status.h:43
#define LT_STS_BadParam
status code indicating bad function parameter
Definition: lt_status.h:70
unsigned char lt_uint8
unsigned 8-bit integer
Definition: lt_types.h:36
unsigned int lt_uint32
unsigned 32-bit integer
Definition: lt_types.h:44
long long int lt_int64
signed 64-bit integer
Definition: lt_types.h:57

Extensis