display/config/1.19/IDisplayConfig.hal

/*
 * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted (subject to the limitations in the
 * disclaimer below) 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 Qualcomm Innovation Center, Inc. nor the names of its
 *      contributors may be used to endorse or promote products derived
 *      from this software without specific prior written permission.
 *
 * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
 * GRANTED BY THIS LICENSE. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
 * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER 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.
 */

package vendor.display.config@1.19;

import @1.18::IDisplayConfig;
import @1.0::IDisplayConfig;

interface IDisplayConfig extends @1.18::IDisplayConfig {
    struct CacChannelRect {
        float left;
        float top;
        float right;
        float bottom;
    };

    struct CacEyeConfig {
        CacChannelRect red_channel_src;
        CacChannelRect red_channel_dst;
        CacChannelRect green_channel_src;
        CacChannelRect green_channel_dst;
        CacChannelRect blue_channel_src;
        CacChannelRect blue_channel_dst;
    };

    /*
     * Sets the src and dst rect parameters of red, green and blue channels of CAC for both left
     * and right eye.
     *
     * @param disp_id display id.
     * @param left specifies the src and dst rect for each channel of CAC for left eye.
     * @param right specifies the src and dst rect for each channel of CAC for right eye.
     *
     * @return error is NONE upon success.
     */
    @callflow(next="*")
    setCacEyeConfig(uint32_t disp_id, CacEyeConfig left, CacEyeConfig right)
                    generates (int32_t error);
};