upnphelpers.h

Go to the documentation of this file.

#ifndef _UPNP_HELPERS_H_
#define _UPNP_HELPERS_H_

#include <QString>
#include <QDateTime>
#include <QDate>
#include <QTime>
#include <QSize>

#include <cstdint>

#include "upnpexp.h"
#include "compat.h"

// NOTE These are for formatting to the UPnP related specs or extracting data
//      from UPnP formatted strings ONLY.
//
//      * Do NOT clutter it up with stuff which is unrelated to those tasks.
//
//      * If adding or editing please cite the reference to the corresponding
//        part of the specification or RFC alongside the changes and in any
//        commit message.
//
//      * Any changes which fail to cite the specs may be reverted.

namespace UPnPDateTime
{
    //-----------------------------------------------------------------------
    // UPnP ContentDirectory Service 2008, 2013
    //-----------------------------------------------------------------------

    //-----------------------------------------------------------------------
    //    Appendix B. AV Working Committee Properties
    //             B.2 Resource Encoding Characteristics Properties
    //-----------------------------------------------------------------------

    UPNP_PUBLIC QString resDurationFormat(uint32_t msec);

    //-----------------------------------------------------------------------
    //    Appendix D. EBNF Syntax Definitions
    //             D.1 Date&Time Syntax
    //-----------------------------------------------------------------------

    UPNP_PUBLIC QString DurationFormat(uint32_t msec);

    UPNP_PUBLIC QString TimeFormat(const QTime &time);

    UPNP_PUBLIC QString TimeFormat(uint32_t msec);

    UPNP_PUBLIC QString DateTimeFormat(const QDateTime &dateTime);

    UPNP_PUBLIC QString NamedDayFormat(const QDateTime &dateTime);

    UPNP_PUBLIC QString NamedDayFormat(const QDate &date);
};

namespace UPNPProtocol
{
    enum TransferProtocol
    {
        kHTTP,
        kRTP
    };
}

namespace DLNA
{
    UPNP_PUBLIC QString DLNAProfileName( const QString &mimeType,
                                         const QSize &resolution = QSize(),
                                         double videoFrameRate = 0.0,
                                         const QString &container = "",
                                         const QString &vidCodec = "",
                                         const QString &audioCodec = "");


    UPNP_PUBLIC QString DLNAFourthField( UPNPProtocol::TransferProtocol protocol,
                                         const QString &mimeType,
                                         const QSize &resolution,
                                         double videoFrameRate,
                                         const QString &container,
                                         const QString &vidCodec,
                                         const QString &audioCodec,
                                         bool isTranscoded);

    UPNP_PUBLIC QString ProtocolInfoString( UPNPProtocol::TransferProtocol protocol,
                                            const QString &mimeType,
                                            const QSize &resolution = QSize(),
                                            double videoFrameRate = 0.0,
                                            const QString &container = "",
                                            const QString &vidCodec = "",
                                            const QString &audioCodec = "",
                                            bool isTranscoded = false);

    enum UPNP_PUBLIC DLNA_Flags
    {
        // NAME                    BIT             BIT #      REFERENCE

        // Sender Pacing (server controls the playback speed)
        //
        // Not currently applicable to MythTV. We don't control the rate of data
        // to the client.
        ksp_flag             = 0x80000000,   // #31 : 7.4.1.3.28 MM sp-flag (sender paced flag)

        // Limited Operations Model
        //
        // NOTE The following are for use under the Limited Operations Model ONLY
        // where the server only supports seeking within limited ranges
        //
        // They don't apply to MythTV which supports the Full Operations Model
        klop_npt             = 0x40000000,  // #30 : 7.4.1.3.29 MM lop-npt (limited operations flags)
        klop_bytes           = 0x20000000,  // #29 : 7.4.1.3.29 MM lop-bytes (limited operations flags)

        // DLNA Play Container support
        kplaycontainer_param = 0x10000000,  // #28 : 7.4.1.3.32 MM playcontainer-param (DLNA PlayContainer flag)

        // In-progress recording or sliding window (circular buffer)
        ks0_increasing       = 0x8000000,   // #27 : 7.4.1.3.33 MM s0-increasing (UCDAM s0 increasing flag)
        ksn_increasing       = 0x4000000,   // #26 : 7.4.1.3.34 MM sn-increasing (UCDAM sn increasing flag)

        // RTP Only
        krtsp_pause          = 0x2000000,   // #25 : (Pause media operation support for RTP Serving Endpoints)

        // Transfer Modes
        ktm_s                = 0x1000000,   // #24 : 7.4.1.3.35 MM tm-s (Streaming Mode Transfer flag)
        ktm_i                = 0x800000,    // #23 : 7.4.1.3.36 MM tm-i (Interactive Mode Transfer flag)
        ktm_b                = 0x400000,    // #22 : 7.4.1.3.37 MM tm-b (Background Mode Transfer flag)

        // TCP Flow & Keep-Alive support
        khttp_stalling       = 0x200000,    // #21 : 7.4.1.3.38 MM http-stalling (HTTP Connection Stalling flag)

        // DLNA 1.5+ Support - Should always be enabled
        kv1_5_flag           = 0x100000,    // #20 : 7.4.1.3.25 MM dlna-v1.5-flag (DLNAv1.5 version flag)

        //
        // Bits 19-18 are currently unused but reserved
        //

        // Link Protection related. DRM basically, not relevant to MythTV
        kLP_flag                = 0x10000,  // #16 : 7.5.3.5 in IEC 62481-3:2013 (Link Protection flag)
        kcleartextbyteseek_full = 0x8000,   // #15 : 7.5.3.6 (GUN TLQ89) in IEC 62481-3:2013 (Byte based full seek data availability with the Cleartext Byte Seek Request Header)
        klop_cleartextbytes     = 0x4000,   // #14 : 7.4.1.3.29 MM lop-cleartextbytes (limited operations flags)

        //
        // Bits 13-1 are currently unused but reserved
        //
    };

    UPNP_PUBLIC QString FlagsString(uint32_t flags);

    UPNP_PUBLIC QString OpParamString(UPNPProtocol::TransferProtocol protocol);

    UPNP_PUBLIC QString ConversionIndicatorString(bool wasConverted);
};

#endif