From 2b6c40f6c6a87661cfdde26dd483d282d341a00a Mon Sep 17 00:00:00 2001 From: "Matthias P. Braendli" Date: Fri, 8 Jul 2016 11:50:26 +0200 Subject: Add doxygen configuration and target --- src/charset.h | 16 ++++++------- src/mot-encoder.cpp | 65 ++++++++++++++++++++++++++++++----------------------- 2 files changed, 45 insertions(+), 36 deletions(-) diff --git a/src/charset.h b/src/charset.h index 82d81cf..8d1e1a2 100644 --- a/src/charset.h +++ b/src/charset.h @@ -13,13 +13,13 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . +*/ +/*! + \file charset.h + \brief Define the EBU charset according to ETSI TS 101 756v1.8.1 for DLS encoding - charset.h - Define the EBU charset according to ETSI TS 101 756v1.8.1 for DLS encoding - - Authors: - Matthias P. Braendli - Lindsay Cornell + \author Matthias P. Braendli + \author Lindsay Cornell */ #ifndef __CHARSET_H_ @@ -65,7 +65,7 @@ class CharsetConverter { public: CharsetConverter() { - /* Build the converstion table that contains the known code points, + /*! Build the converstion table that contains the known code points, * at the indices corresponding to the EBU Latin table */ using namespace std; @@ -77,7 +77,7 @@ class CharsetConverter } } - /* Convert a UTF-8 encoded text line into an EBU Latin encoded byte stream + /*! Convert a UTF-8 encoded text line into an EBU Latin encoded byte stream */ std::string convert(std::string line_utf8) { using namespace std; diff --git a/src/mot-encoder.cpp b/src/mot-encoder.cpp index 8d8d9ce..00757f6 100644 --- a/src/mot-encoder.cpp +++ b/src/mot-encoder.cpp @@ -17,14 +17,14 @@ You should have received a copy of the GNU General Public License along with this program. If not, see . +*/ +/*! + \file mot-encoder.c + \brief Generete PAD data for MOT Slideshow and DLS - mot-encoder.c - Generete PAD data for MOT Slideshow and DLS - - Authors: - Sergio Sagliocco - Matthias P. Braendli - Stefan Pöschel + \author Sergio Sagliocco + \author Matthias P. Braendli + \author Stefan Pöschel */ #include @@ -82,12 +82,12 @@ extern "C" { #define MINQUALITY 40 // Charsets from TS 101 756 -#define CHARSET_COMPLETE_EBU_LATIN 0 // Complete EBU Latin based repertoire -#define CHARSET_EBU_LATIN_CY_GR 1 // EBU Latin based common core, Cyrillic, Greek -#define CHARSET_EBU_LATIN_AR_HE_CY_GR 2 // EBU Latin based core, Arabic, Hebrew, Cyrillic and Greek -#define CHARSET_ISO_LATIN_ALPHABET_2 3 // ISO Latin Alphabet No 2 -#define CHARSET_UCS2_BE 6 // ISO/IEC 10646 using UCS-2 transformation format, big endian byte order -#define CHARSET_UTF8 15 // ISO Latin Alphabet No 2 +#define CHARSET_COMPLETE_EBU_LATIN 0 //!< Complete EBU Latin based repertoire +#define CHARSET_EBU_LATIN_CY_GR 1 //!< EBU Latin based common core, Cyrillic, Greek +#define CHARSET_EBU_LATIN_AR_HE_CY_GR 2 //!< EBU Latin based core, Arabic, Hebrew, Cyrillic and Greek +#define CHARSET_ISO_LATIN_ALPHABET_2 3 //!< ISO Latin Alphabet No 2 +#define CHARSET_UCS2_BE 6 //!< ISO/IEC 10646 using UCS-2 transformation format, big endian byte order +#define CHARSET_UTF8 15 //!< ISO Latin Alphabet No 2 typedef std::vector uint8_vector_t; @@ -121,7 +121,7 @@ struct MSCDG { unsigned short int crc; // 16 bits }; -/* Between collection of slides and transmission, the slide data is saved +/*! Between collection of slides and transmission, the slide data is saved * in this structure. */ struct slide_metadata_t { @@ -138,7 +138,7 @@ struct slide_metadata_t { } }; -/* A simple fingerprint for each slide transmitted. +/*! A simple fingerprint for each slide transmitted. * Allows us to reuse the same fidx if the same slide * is transmitted more than once. */ @@ -153,8 +153,9 @@ struct fingerprint_t { // assigned fidx, -1 means invalid int fidx; - // The comparison is not done on fidx, only - // on the file-specific data + /*! The comparison is not done on fidx, only + * on the file-specific data + */ bool operator==(const fingerprint_t& other) const { return (((s_name == other.s_name && s_size == other.s_size) && @@ -183,6 +184,13 @@ struct fingerprint_t { } }; +/*! We keep track of transmitted files so that we can retransmit + * identical slides with the same index, in case the receivers cache + * them. + * + * \c MAXHISTORYLEN defines for how how many slides we want to keep this + * history. + */ class History { public: History(size_t hist_size) : @@ -594,7 +602,7 @@ void PADPacketizer::AddCI(int apptype, int len_index) { int PADPacketizer::OptimalSubFieldSizeIndex(size_t available_bytes) { - /* Return the index of the optimal sub-field size by stepwise search (regards only Variable Size X-PAD): + /*! Return the index of the optimal sub-field size by stepwise search (regards only Variable Size X-PAD): * - find the smallest sub-field able to hold (at least) all available bytes * - find the biggest regarding sub-field we have space for (which definitely exists - otherwise previously the PAD would have been flushed) * - if the wasted space is at least as big as the smallest possible sub-field, use a sub-field one size smaller @@ -620,7 +628,7 @@ int PADPacketizer::WriteDGToSubField(DATA_GROUP* dg, size_t len) { bool PADPacketizer::AppendDG(DATA_GROUP* dg) { - /* use X-PAD w/o CIs instead of X-PAD w/ CIs, if we can save some bytes or at least do not waste additional bytes + /*! use X-PAD w/o CIs instead of X-PAD w/ CIs, if we can save some bytes or at least do not waste additional bytes * * Omit CI list in case: * 1. no pending data sub-fields @@ -1051,12 +1059,13 @@ void warnOnSmallerImage(size_t height, size_t width, std::string& fname) { } -// Scales the image down if needed, -// so that it is 320x240 pixels. -// Automatically reduces the quality to make sure the -// blobsize is not too large. -// -// Returns: the blobsize +/*! Scales the image down if needed, + * so that it is 320x240 pixels. + * Automatically reduces the quality to make sure the + * blobsize is not too large. + * + * \return the blobsize + */ #if HAVE_MAGICKWAND size_t resizeImage(MagickWand* m_wand, unsigned char** blob, std::string& fname) { @@ -1127,17 +1136,17 @@ int encodeFile(int output_fd, std::string& fname, int fidx, bool raw_slides) size_t orig_quality; char* orig_format = NULL; - /* We handle JPEG differently, because we want to avoid recompressing the + /*! We handle JPEG differently, because we want to avoid recompressing the * image if it is suitable as is */ bool orig_is_jpeg = false; - /* If the original is a PNG, we transmit it as is, if the resolution is correct + /*! If the original is a PNG, we transmit it as is, if the resolution is correct * and the file is not too large. Otherwise it gets resized and sent as JPEG. */ bool orig_is_png = false; - /* By default, we do resize the image to 320x240, with a quality such that + /*! By default, we do resize the image to 320x240, with a quality such that * the blobsize is at most MAXSLIDESIZE. * * For JPEG input files that are already at the right resolution and at the -- cgit v1.2.3