liboverlay/overlayCtrlData.h

/*
* Copyright (c) 2012-2013, The Linux Foundation. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*    * Redistributions of source code must retain the above copyright
*      notice, this list of conditions and the following disclaimer.
*    * Redistributions in binary form must reproduce the above
*      copyright notice, this list of conditions and the following
*      disclaimer in the documentation and/or other materials provided
*      with the distribution.
*    * Neither the name of The Linux Foundation nor the names of its
*      contributors may be used to endorse or promote products derived
*      from this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT
* ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS
* BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
* BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
* IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

#ifndef OVERLAY_CTRLDATA_H
#define OVERLAY_CTRLDATA_H

#include "overlayUtils.h"
#include "overlayMdp.h"
#include "gralloc_priv.h" // INTERLACE_MASK

namespace ovutils = overlay::utils;

namespace overlay {

/*
* Sequence to use:
* init
* start
* setXXX
* close
* */
class Ctrl : utils::NoCopy {
public:

    /* ctor */
    explicit Ctrl(const int& dpy);
    /* dtor close */
    ~Ctrl();

    /* set source using whf, orient and wait flag */
    void setSource(const utils::PipeArgs& args);
    /* set crop info and pass it down to mdp */
    void setCrop(const utils::Dim& d);
    /* set color for mdp pipe */
    void setColor(const uint32_t color);
    /* set orientation */
    void setTransform(const utils::eTransform& p);
    /* set mdp position using dim */
    void setPosition(const utils::Dim& dim);
    /* set mdp visual params using metadata */
    bool setVisualParams(const MetaData_t &metadata);
    /* set pipe type RGB/DMA/VG */
    void setPipeType(const utils::eMdpPipeType& pType);
    /* mdp set overlay/commit changes */
    bool commit();

    /* ctrl id */
    int  getPipeId() const;
    /* ctrl fd */
    int  getFd() const;
    /* retrieve crop data */
    utils::Dim getCrop() const;
    utils::Dim getPosition() const;
    /* Set downscale */
    void setDownscale(int dscale_factor);
    /* Update the src format based on rotator's dest */
    void updateSrcFormat(const uint32_t& rotDstFormat);
    /* return pipe priority */
    uint8_t getPriority() const;
    /* dump the state of the object */
    void dump() const;
    /* Return the dump in the specified buffer */
    void getDump(char *buf, size_t len);

    static bool validateAndSet(Ctrl* ctrlArray[], const int& count,
            const int& fbFd);
private:
    // mdp ctrl struct(info e.g.)
    MdpCtrl *mMdp;
};


class Data : utils::NoCopy {
public:
    /* init, reset */
    explicit Data(const int& dpy);
    /* calls close */
    ~Data();
    /* set overlay pipe id in the mdp struct */
    void setPipeId(int id);
    /* get overlay id in the mdp struct */
    int getPipeId() const;
    /* queue buffer to the overlay */
    bool queueBuffer(int fd, uint32_t offset);
    /* sump the state of the obj */
    void dump() const;
    /* Return the dump in the specified buffer */
    void getDump(char *buf, size_t len);

private:
    // mdp data struct
    MdpData *mMdp;
};

//-------------Inlines-------------------------------

inline Ctrl::Ctrl(const int& dpy) : mMdp(new MdpCtrl(dpy)) {
}

inline Ctrl::~Ctrl() {
    delete mMdp;
}

inline void Ctrl::setSource(const utils::PipeArgs& args)
{
    mMdp->setSource(args);
}

inline void Ctrl::setPosition(const utils::Dim& dim)
{
    mMdp->setPosition(dim);
}

inline void Ctrl::setTransform(const utils::eTransform& orient)
{
    mMdp->setTransform(orient);
}

inline void Ctrl::setCrop(const utils::Dim& d)
{
    mMdp->setCrop(d);
}

inline void Ctrl::setColor(const uint32_t color)
{
    mMdp->setColor(color);
}

inline bool Ctrl::setVisualParams(const MetaData_t &metadata)
{
    if (!mMdp->setVisualParams(metadata)) {
        ALOGE("Ctrl setVisualParams failed in MDP setVisualParams");
        return false;
    }
    return true;
}

inline void Ctrl::setPipeType(const utils::eMdpPipeType& pType)
{
    mMdp->setPipeType(pType);
}

inline void Ctrl::dump() const {
    ALOGE("== Dump Ctrl start ==");
    mMdp->dump();
    ALOGE("== Dump Ctrl end ==");
}

inline bool Ctrl::commit() {
    if(!mMdp->set()) {
        ALOGE("Ctrl commit failed set overlay");
        return false;
    }
    return true;
}

inline int Ctrl::getPipeId() const {
    return mMdp->getPipeId();
}

inline int Ctrl::getFd() const {
    return mMdp->getFd();
}

inline void Ctrl::updateSrcFormat(const uint32_t& rotDstFmt) {
    mMdp->updateSrcFormat(rotDstFmt);
}

inline bool Ctrl::validateAndSet(Ctrl* ctrlArray[], const int& count,
        const int& fbFd) {
    MdpCtrl* mdpCtrlArray[count];
    memset(&mdpCtrlArray, 0, sizeof(mdpCtrlArray));

    for(int i = 0; i < count; i++) {
        mdpCtrlArray[i] = ctrlArray[i]->mMdp;
    }

    bool ret = MdpCtrl::validateAndSet(mdpCtrlArray, count, fbFd);
    return ret;
}

inline utils::Dim Ctrl::getCrop() const {
    return mMdp->getSrcRectDim();
}

inline utils::Dim Ctrl::getPosition() const {
    return mMdp->getDstRectDim();
}

inline void Ctrl::setDownscale(int dscale_factor) {
    mMdp->setDownscale(dscale_factor);
}

inline uint8_t Ctrl::getPriority() const {
    return mMdp->getPriority();
}

inline void Ctrl::getDump(char *buf, size_t len) {
    mMdp->getDump(buf, len);
}

inline Data::Data(const int& dpy) : mMdp(new MdpData(dpy)) {
}

inline Data::~Data() {
    delete mMdp;
}

inline void Data::setPipeId(int id) { mMdp->setPipeId(id); }

inline int Data::getPipeId() const { return mMdp->getPipeId(); }

inline bool Data::queueBuffer(int fd, uint32_t offset) {
    return mMdp->play(fd, offset);
}

inline void Data::dump() const {
    ALOGE("== Dump Data MDP start ==");
    mMdp->dump();
    ALOGE("== Dump Data MDP end ==");
}

inline void Data::getDump(char *buf, size_t len) {
    mMdp->getDump(buf, len);
}

} // overlay

#endif