115 lines
3.0 KiB
C
115 lines
3.0 KiB
C
|
/*
|
||
|
|
|
||
|
|
Copyright (c) 2011, 2012, Simon Howard
|
||
|
|
|
||
|
|
Permission to use, copy, modify, and/or distribute this software
|
||
|
|
for any purpose with or without fee is hereby granted, provided
|
||
|
|
that the above copyright notice and this permission notice appear
|
||
|
|
in all copies.
|
||
|
|
|
||
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
|
||
|
|
WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
|
||
|
|
WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
|
||
|
|
AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR
|
||
|
|
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
||
|
|
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
|
||
|
|
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
||
|
|
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||
|
|
|
||
|
|
*/
|
||
|
|
|
||
|
|
#ifndef LHASA_LHA_DECODER_H
|
||
|
|
#define LHASA_LHA_DECODER_H
|
||
|
|
|
||
|
|
#include "public/lha_decoder.h"
|
||
|
|
|
||
|
|
struct _LHADecoderType {
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Callback function to initialize the decoder.
|
||
|
|
*
|
||
|
|
* @param extra_data Pointer to the extra data area allocated for
|
||
|
|
* the decoder.
|
||
|
|
* @param callback Callback function to invoke to read more
|
||
|
|
* compressed data.
|
||
|
|
* @param callback_data Extra pointer to pass to the callback.
|
||
|
|
* @return Non-zero for success.
|
||
|
|
*/
|
||
|
|
|
||
|
|
int (*init)(void *extra_data,
|
||
|
|
LHADecoderCallback callback,
|
||
|
|
void *callback_data);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Callback function to free the decoder.
|
||
|
|
*
|
||
|
|
* @param extra_data Pointer to the extra data area allocated for
|
||
|
|
* the decoder.
|
||
|
|
*/
|
||
|
|
|
||
|
|
void (*free)(void *extra_data);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Callback function to read (ie. decompress) data from the
|
||
|
|
* decoder.
|
||
|
|
*
|
||
|
|
* @param extra_data Pointer to the decoder's custom data.
|
||
|
|
* @param buf Pointer to the buffer in which to store
|
||
|
|
* the decompressed data. The buffer is
|
||
|
|
* at least 'max_read' bytes in size.
|
||
|
|
* @return Number of bytes decompressed.
|
||
|
|
*/
|
||
|
|
|
||
|
|
size_t (*read)(void *extra_data, uint8_t *buf);
|
||
|
|
|
||
|
|
/** Number of bytes of extra data to allocate for the decoder. */
|
||
|
|
|
||
|
|
size_t extra_size;
|
||
|
|
|
||
|
|
/** Maximum number of bytes that might be put into the buffer by
|
||
|
|
a single call to read() */
|
||
|
|
|
||
|
|
size_t max_read;
|
||
|
|
|
||
|
|
/** Block size. Used for calculating number of blocks for
|
||
|
|
progress bar. */
|
||
|
|
|
||
|
|
size_t block_size;
|
||
|
|
};
|
||
|
|
|
||
|
|
struct _LHADecoder {
|
||
|
|
|
||
|
|
/** Type of decoder (algorithm) */
|
||
|
|
|
||
|
|
LHADecoderType *dtype;
|
||
|
|
|
||
|
|
/** Callback function to monitor decoder progress. */
|
||
|
|
|
||
|
|
LHADecoderProgressCallback progress_callback;
|
||
|
|
void *progress_callback_data;
|
||
|
|
|
||
|
|
/** Last announced block position, for progress callback. */
|
||
|
|
|
||
|
|
unsigned int last_block, total_blocks;
|
||
|
|
|
||
|
|
/** Current position in the decode stream, and total length. */
|
||
|
|
|
||
|
|
size_t stream_pos, stream_length;
|
||
|
|
|
||
|
|
/** Output buffer, containing decoded data not yet returned. */
|
||
|
|
|
||
|
|
unsigned int outbuf_pos, outbuf_len;
|
||
|
|
uint8_t *outbuf;
|
||
|
|
|
||
|
|
/** If true, the decoder read() function returned zero. */
|
||
|
|
|
||
|
|
unsigned int decoder_failed;
|
||
|
|
|
||
|
|
/** Current CRC of the output stream. */
|
||
|
|
|
||
|
|
uint16_t crc;
|
||
|
|
};
|
||
|
|
|
||
|
|
#endif /* #ifndef LHASA_LHA_DECODER_H */
|
||
|
|
|