fec Struct Reference

#include <fec.h>

Inheritance diagram for fec:

Collaboration diagram for fec:

Public Member Functions
virtual	~fec ()
virtual bool	decode (char *in, int in_len, char **out, int *out_len, const std::map< int, int > &)=0
virtual audio_frame2	encode (audio_frame2 const &)
virtual std::shared_ptr< video_frame >	encode (std::shared_ptr< video_frame >)=0

Static Public Member Functions
static fec *	create_from_config (const char *str, bool is_audio) noexcept
static fec *	create_from_desc (struct fec_desc) noexcept
static enum fec_type	fec_type_from_pt (int pt) throw ()
static int	pt_from_fec_type (enum tx_media_type media_type, enum fec_type fec_type, bool encrypted) throw ()

Detailed Description

Definition at line 51 of file fec.h.

Constructor & Destructor Documentation

~fec()

virtual fec::~fec ( )

inlinevirtual

Definition at line 65 of file fec.h.

{}

Member Function Documentation

create_from_config()

fec * fec::create_from_config ( const char * str, bool is_audio )

staticnoexcept

Definition at line 62 of file fec.cpp.

{
        try {
                if (strncmp(c_str, "LDGM percents ", strlen("LDGM percents ")) == 0) {
                        char *str = strdup(c_str);
                        char *ptr = str + strlen("LDGM percents ");
                        char *save_ptr = nullptr;
                        char *item = nullptr;
                        item = strtok_r(ptr, " ", &save_ptr);
                        assert (item != nullptr);
                        int mtu_len = stoi(item);
                        assert(mtu_len > 0);
                        item = strtok_r(nullptr, " ", &save_ptr);
                        assert (item != nullptr);
                        int data_len = stoi(item);
                        assert(data_len > 0);
                        item = strtok_r(nullptr, " ", &save_ptr);
                        assert (item != nullptr);
                        double loss_pct = stof(item);
                        assert(loss_pct > 0.0);
                        fec *ret = new ldgm(mtu_len, data_len, loss_pct);
                        free(str);
                        return ret;
                }
                if (strncmp(c_str, "LDGM cfg ", strlen("LDGM cfg ")) == 0) {
                        return new ldgm(c_str + strlen("LDGM cfg "));
                }
                if (strncmp(c_str, "RS cfg ", strlen("RS cfg ")) == 0) {
                        return new rs(c_str + strlen("rs cfg "), is_audio);
                }
                throw ug_runtime_error("Unrecognized FEC configuration!");
        } catch (string const &s) {
                LOG(LOG_LEVEL_ERROR) << s << "\n";
        } catch (exception const &e) {
                LOG(LOG_LEVEL_ERROR) << e.what() << "\n";
        } catch (int i) {
                if (i != 0) {
                        LOG(LOG_LEVEL_ERROR) << "FEC initialization returned " << i << "\n";
                }
        } catch (...) {
                LOG(LOG_LEVEL_ERROR) << "Unknown FEC error!\n";
        }
        return nullptr;
}

References LOG, and LOG_LEVEL_ERROR.

Referenced by audio_sender_process_message(), and rtp_video_rxtx::process_sender_message().

create_from_desc()

fec * fec::create_from_desc ( struct fec_desc desc )

staticnoexcept

Definition at line 107 of file fec.cpp.

{
        try {
                switch (desc.type) {
                        case FEC_LDGM:
                                return new ldgm(desc.k, desc.m, desc.c, desc.seed);
                        case FEC_RS:
                                return new rs(desc.k, desc.k + desc.m);
                        default:
                                abort();
                }
        } catch (string const &s) {
                LOG(LOG_LEVEL_ERROR) << s << "\n";
        } catch (exception const &e) {
                LOG(LOG_LEVEL_ERROR) << e.what() << "\n";
        } catch (int i) {
                if (i != 0) {
                        LOG(LOG_LEVEL_ERROR) << "FEC initialization returned " << i << "\n";
                }
        } catch (...) {
                LOG(LOG_LEVEL_ERROR) << "Unknown FEC error!\n";
        }
        return nullptr;
 
}

References desc, FEC_LDGM, FEC_RS, LOG, and LOG_LEVEL_ERROR.

Referenced by audio_fec_decode(), and fec_thread().

decode()

virtual bool fec::decode ( char * in, int in_len, char ** out, int * out_len, const std::map< int, int > &  )

pure virtual

Return values

true	if whole frame was reconstructed
false	if decoder was unable to reconstruct the frame However, if it was reconstructed at least partially (or the code is a systematic one) and length can be read, set len to a non-zero value.

Implemented in ldgm, and rs.

Referenced by audio_fec_decode(), and fec_thread().

encode() [1/2]

virtual audio_frame2 fec::encode ( audio_frame2 const & )

inlinevirtual

Reimplemented in rs.

Definition at line 53 of file fec.h.

                                                          {
                throw std::logic_error("Selected FEC not implemented for audio!");
        }

encode() [2/2]

virtual std::shared_ptr< video_frame > fec::encode ( std::shared_ptr< video_frame > )

pure virtual

Implemented in ldgm, and rs.

Referenced by audio_sender_thread().

fec_type_from_pt()

enum fec_type fec::fec_type_from_pt ( int pt ) throw (  )

static

Definition at line 157 of file fec.cpp.

{
        switch (pt) {
        case PT_VIDEO:
        case PT_ENCRYPT_VIDEO:
                return FEC_NONE;
        case PT_VIDEO_LDGM:
        case PT_ENCRYPT_VIDEO_LDGM:
                return FEC_LDGM;
        case PT_VIDEO_RS:
        case PT_ENCRYPT_VIDEO_RS:
                return FEC_RS;
        default:
                abort();
        }
}

References FEC_LDGM, FEC_NONE, FEC_RS, PT_ENCRYPT_VIDEO, PT_ENCRYPT_VIDEO_LDGM, PT_ENCRYPT_VIDEO_RS, PT_VIDEO, PT_VIDEO_LDGM, and PT_VIDEO_RS.

Referenced by decode_video_frame().

pt_from_fec_type()

int fec::pt_from_fec_type ( enum tx_media_type media_type, enum fec_type fec_type , bool encrypted ) throw (  )

static

Definition at line 133 of file fec.cpp.

{
        if (media_type == TX_MEDIA_VIDEO) {
                switch (fec_type) {
                case FEC_NONE:
                        return encrypted ? PT_ENCRYPT_VIDEO : PT_VIDEO;
                case FEC_LDGM:
                        return encrypted ? PT_ENCRYPT_VIDEO_LDGM : PT_VIDEO_LDGM;
                case FEC_RS:
                        return encrypted ? PT_ENCRYPT_VIDEO_RS : PT_VIDEO_RS;
                default: break;
                }
        } else {
                switch (fec_type) {
                case FEC_NONE:
                        return encrypted ? PT_ENCRYPT_AUDIO : PT_AUDIO;
                case FEC_RS:
                        return encrypted ? PT_ENCRYPT_AUDIO_RS : PT_AUDIO_RS;
                default: break;
                }
        }
        UG_ASSERT(0 && "Unsupported media/FEC type combination");
}

References FEC_LDGM, FEC_NONE, FEC_RS, PT_AUDIO, PT_AUDIO_RS, PT_ENCRYPT_AUDIO, PT_ENCRYPT_AUDIO_RS, PT_ENCRYPT_VIDEO, PT_ENCRYPT_VIDEO_LDGM, PT_ENCRYPT_VIDEO_RS, PT_VIDEO, PT_VIDEO_LDGM, PT_VIDEO_RS, TX_MEDIA_VIDEO, and UG_ASSERT.

Referenced by fec_pt_from_fec_type().

---

The documentation for this struct was generated from the following files:

• src/rtp/fec.h
• src/rtp/fec.cpp