private/t4_tx.h
/*
* SpanDSP - a series of DSP components for telephony
*
* private/t4_tx.h - definitions for T.4 FAX transmit processing
*
* Written by Steve Underwood <steveu@coppice.org>
*
* Copyright (C) 2003 Steve Underwood
*
* All rights reserved.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License version 2.1,
* as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this program; if not, write to the Free Software
* Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
#if !defined(_SPANDSP_PRIVATE_T4_TX_H_)
#define _SPANDSP_PRIVATE_T4_TX_H_
#define t4_tx_state_s t4_state_s
/*!
T.4 FAX compression/decompression descriptor. This defines the working state
for a single instance of a T.4 FAX compression or decompression channel.
*/
struct t4_state_s
{
/*! \brief The same structure is used for T.4 transmit and receive. This variable
records which mode is in progress. */
int rx;
/*! \brief The type of compression used between the FAX machines. */
int line_encoding;
/*! \brief The time at which handling of the current page began. */
time_t page_start_time;
/*! \brief The text which will be used in FAX page header. No text results
in no header line. */
const char *header_info;
/*! \brief Optional per instance time zone for the FAX page header timestamp. */
struct tz_s *tz;
/*! \brief The size of the compressed image on the line side, in bits. */
int line_image_size;
/*! \brief The current number of bytes per row of uncompressed image data. */
int bytes_per_row;
/*! \brief The size of the image in the image buffer, in bytes. */
int image_size;
/*! \brief The current size of the image buffer. */
int image_buffer_size;
/*! \brief A point to the image buffer. */
uint8_t *image_buffer;
/*! \brief The number of pages transferred to date. */
int current_page;
/*! \brief Column-to-column (X) resolution in pixels per metre. */
int x_resolution;
/*! \brief Row-to-row (Y) resolution in pixels per metre. */
int y_resolution;
/*! \brief Width of the current page, in pixels. */
int image_width;
/*! \brief Length of the current page, in pixels. */
int image_length;
/*! \brief Current pixel row number. */
int row;
/*! \brief This variable is set if we are treating the current row as a 2D encoded
one. */
int row_is_2d;
/*! \brief The current length of the current row. */
int row_len;
/*! \brief Black and white run-lengths for the current row. */
uint32_t *cur_runs;
/*! \brief Black and white run-lengths for the reference row. */
uint32_t *ref_runs;
/*! \brief Pointer to the buffer for the current pixel row. */
uint8_t *row_buf;
/*! \brief Encoded data bits buffer. */
uint32_t tx_bitstream;
/*! \brief The number of bits currently in tx_bitstream. */
int tx_bits;
/*! \brief The current number of bits in the current encoded row. */
int row_bits;
/*! \brief The minimum bits in any row of the current page. For monitoring only. */
int min_row_bits;
/*! \brief The maximum bits in any row of the current page. For monitoring only. */
int max_row_bits;
/*! \brief Error and flow logging control */
logging_state_t logging;
/*! \brief All TIFF file specific state information for the T.4 context. */
t4_tiff_state_t tiff;
t4_t6_decode_state_t t4_t6_rx;
t4_t6_encode_state_t t4_t6_tx;
};
#endif
/*- End of file ------------------------------------------------------------*/
logging_state_t
struct logging_state_s logging_state_t
Definition logging.h:75
t4_state_s
Definition private/t4_tx.h:36
t4_state_s::current_page
int current_page
The number of pages transferred to date.
Definition private/t4_tx.h:66
t4_state_s::row_is_2d
int row_is_2d
This variable is set if we are treating the current row as a 2D encoded one.
Definition private/t4_tx.h:80
t4_state_s::tiff
t4_tiff_state_t tiff
All TIFF file specific state information for the T.4 context.
Definition private/t4_tx.h:107
t4_state_s::tx_bitstream
uint32_t tx_bitstream
Encoded data bits buffer.
Definition private/t4_tx.h:92
t4_state_s::tx_bits
int tx_bits
The number of bits currently in tx_bitstream.
Definition private/t4_tx.h:94
t4_state_s::x_resolution
int x_resolution
Column-to-column (X) resolution in pixels per metre.
Definition private/t4_tx.h:68
t4_state_s::min_row_bits
int min_row_bits
The minimum bits in any row of the current page. For monitoring only.
Definition private/t4_tx.h:99
t4_state_s::row_len
int row_len
The current length of the current row.
Definition private/t4_tx.h:82
t4_state_s::line_image_size
int line_image_size
The size of the compressed image on the line side, in bits.
Definition private/t4_tx.h:54
t4_state_s::y_resolution
int y_resolution
Row-to-row (Y) resolution in pixels per metre.
Definition private/t4_tx.h:70
t4_state_s::row
int row
Current pixel row number.
Definition private/t4_tx.h:76
t4_state_s::image_width
int image_width
Width of the current page, in pixels.
Definition private/t4_tx.h:72
t4_state_s::image_length
int image_length
Length of the current page, in pixels.
Definition private/t4_tx.h:74
t4_state_s::header_info
const char * header_info
The text which will be used in FAX page header. No text results in no header line.
Definition private/t4_tx.h:49
t4_state_s::max_row_bits
int max_row_bits
The maximum bits in any row of the current page. For monitoring only.
Definition private/t4_tx.h:101
t4_state_s::image_buffer_size
int image_buffer_size
The current size of the image buffer.
Definition private/t4_tx.h:61
t4_state_s::logging
logging_state_t logging
Error and flow logging control.
Definition private/t4_tx.h:104
t4_state_s::row_bits
int row_bits
The current number of bits in the current encoded row.
Definition private/t4_tx.h:97
t4_state_s::row_buf
uint8_t * row_buf
Pointer to the buffer for the current pixel row.
Definition private/t4_tx.h:89
t4_state_s::bytes_per_row
int bytes_per_row
The current number of bytes per row of uncompressed image data.
Definition private/t4_tx.h:57
t4_state_s::image_buffer
uint8_t * image_buffer
A point to the image buffer.
Definition private/t4_tx.h:63
t4_state_s::rx
int rx
The same structure is used for T.4 transmit and receive. This variable records which mode is in progr...
Definition private/t4_tx.h:39
t4_state_s::line_encoding
int line_encoding
The type of compression used between the FAX machines.
Definition private/t4_tx.h:42
t4_state_s::page_start_time
time_t page_start_time
The time at which handling of the current page began.
Definition private/t4_tx.h:45
t4_state_s::cur_runs
uint32_t * cur_runs
Black and white run-lengths for the current row.
Definition private/t4_tx.h:85
t4_state_s::tz
struct tz_s * tz
Optional per instance time zone for the FAX page header timestamp.
Definition private/t4_tx.h:51
t4_state_s::image_size
int image_size
The size of the image in the image buffer, in bytes.
Definition private/t4_tx.h:59
t4_state_s::ref_runs
uint32_t * ref_runs
Black and white run-lengths for the reference row.
Definition private/t4_tx.h:87
t4_tiff_state_t
Definition private/t4_rx.h:55
tz_s
Definition private/timezone.h:82