hpm_display_common.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 HPMicro
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */
 
#ifndef HPM_DISPLAY_COMMON_H
#define HPM_DISPLAY_COMMON_H
 
#include "hpm_common.h"
 
typedef enum display_alphablend_mode {
    display_alphablend_mode_clear = 0,
    display_alphablend_mode_src = 1,
    display_alphablend_mode_dst = 2,
    display_alphablend_mode_src_over = 3,
    display_alphablend_mode_dst_over = 4,
    display_alphablend_mode_src_in = 5,
    display_alphablend_mode_dst_in = 6,
    display_alphablend_mode_src_out = 7,
    display_alphablend_mode_dst_out = 8,
    display_alphablend_mode_src_at_top = 9,
    display_alphablend_mode_dst_at_top = 10,
    display_alphablend_mode_xor = 11,
    display_alphablend_mode_plus = 12,
    display_alphablend_mode_modulate = 13,
    display_alphablend_mode_src_org = 14,
    display_alphablend_mode_dst_org = 15,
} display_alphablend_mode_t;
 
typedef enum display_pixel_format {
    display_pixel_format_argb8888,
    display_pixel_format_rgb565,
    display_pixel_format_rgb555,
    display_pixel_format_rgb444,
    display_pixel_format_gbr422,
    display_pixel_format_yuv422,
    display_pixel_format_ycbcr422,
    display_pixel_format_y8,
    display_pixel_format_raw8,
} display_pixel_format_t;
 
typedef enum display_byteorder {
    display_byteorder_a3a2a1a0 = 0,
    display_byteorder_a2a3a0a1 = 1,
    display_byteorder_a1a0a3a2 = 2,
    display_byteorder_a0a1a2a3 = 3,
} display_byteorder_t;
 
typedef enum display_yuv_format {
    display_yuv_mode_422_u1y1v1y2 = 0,
    display_yuv_mode_422_v1y1u1y2,
    display_yuv_mode_422_y1u1y2v1,
    display_yuv_mode_422_y1v1y2u1,
} display_yuv_format_t;
 
typedef union display_color_32b {
    uint32_t u;
    struct {
        uint8_t b;
        uint8_t g;
        uint8_t r;
        uint8_t alpha;
    };
} display_color_32b_t;
 
typedef enum display_alpha_op {
    display_alpha_op_invalid = 0,
    display_alpha_op_override = 1,
    display_alpha_op_scale = 2,
} display_alpha_op_t;
 
typedef struct dispaly_alphablend_option {
    uint8_t dst_alpha;
    uint8_t src_alpha;
    display_alpha_op_t dst_alpha_op;
    display_alpha_op_t src_alpha_op;
    display_alphablend_mode_t mode;
} display_alphablend_option_t;
 
typedef struct dispaly_yuv2rgb_coef {
    uint16_t c0;
    uint16_t c1;
    uint16_t c2;
    uint16_t c3;
    uint16_t c4;
    uint16_t uv_offset;
    uint16_t y_offset;
} display_yuv2rgb_coef_t;
 
typedef struct display_yuv2rgb_config {
    bool enable;
    bool ycbcr_mode;
    display_yuv2rgb_coef_t yuv2rgb_coef;
} display_yuv2rgb_config_t;
 
typedef struct display_rgb2yuv_config {
    bool enable;
    bool ycbcr_mode;
    uint16_t c0;
    uint16_t c1;
    uint16_t c2;
    uint16_t c3;
    uint16_t c4;
    uint16_t c5;
    uint16_t c6;
    uint16_t c7;
    uint16_t c8;
    uint16_t uv_offset;
    uint16_t y_offset;
} display_rgb2yuv_config_t;
 
typedef enum display_buf_format {
    display_buf_format_argb8888, 
    display_buf_format_bgra8888, 
    display_buf_format_rgb565, 
    display_buf_format_rgb565_swap, 
    display_buf_format_yuyv, 
    display_buf_format_uyvy, 
    display_buf_format_y8, 
    display_buf_format_max,
} display_buf_format_t;
 
typedef struct display_buf {
    void *buf; 
    uint16_t width; 
    uint16_t height; 
    uint32_t stride; 
    display_buf_format_t format;
    struct {
        display_alpha_op_t op;
        uint8_t val;
    } alpha;
} display_buf_t;
 
#ifdef __cplusplus
extern "C" {
#endif
 
static inline
    uint8_t display_get_pixel_size_in_bit(display_pixel_format_t format)
{
    switch (format) {
    case display_pixel_format_argb8888:
        return 32;
    case display_pixel_format_rgb565:
        return 16;
    case display_pixel_format_yuv422:
        return 16;
    case display_pixel_format_ycbcr422:
        return 16;
    case display_pixel_format_y8:
        return 8;
    case display_pixel_format_raw8:
        return 8;
    default:
        return 0;
    }
}
 
static inline bool display_pixel_format_is_yuv_format(display_pixel_format_t format)
{
    switch (format) {
    case display_pixel_format_yuv422:
        return true;
    case display_pixel_format_ycbcr422:
        return true;
    default:
        return false;
    }
}
 
static inline
    uint8_t display_get_pixel_size_in_byte(display_pixel_format_t format)
{
    return display_get_pixel_size_in_bit(format) >> 3;
}
 
static inline
    uint32_t display_get_pitch_length_in_byte(display_pixel_format_t format,
                                            uint32_t width_in_pixel)
{
    return width_in_pixel * (display_get_pixel_size_in_bit(format) >> 3);
}
 
#ifdef __cplusplus
}
#endif
#endif /* HPM_DISPLAY_COMMON_H */