/**************************************************************************** * boards/arm/cxd56xx/spresense/include/cxd56_imageproc.h * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #ifndef __BOARDS_ARM_CXD56XX_SPRESENSE_INCLUDE_CXD56_IMAGEPROC_H #define __BOARDS_ARM_CXD56XX_SPRESENSE_INCLUDE_CXD56_IMAGEPROC_H #include #ifdef __cplusplus extern "C" { #endif /**************************************************************************** * Public Types ****************************************************************************/ /* Structure of rectangle coordinates from left top point to * right bottom point. */ struct imageproc_rect_s { uint16_t x1; /* X coordinate of left top point */ uint16_t y1; /* Y coordinate of left top point */ uint16_t x2; /* X coordinate of rignt bottom point */ uint16_t y2; /* Y coordinate of rignt bottom point */ }; typedef struct imageproc_rect_s imageproc_rect_t; /* Enumeration of image type */ enum imageproc_imginfo_e { IMAGEPROC_IMGTYPE_SINGLE = 0, /* All pixels have the same value */ IMAGEPROC_IMGTYPE_1BPP = 1, /* 1 bit per pixel */ IMAGEPROC_IMGTYPE_BINARY = 1, /* deprecated, use 1BPP instead. */ IMAGEPROC_IMGTYPE_8BPP = 2, /* 8 bits per pixel */ IMAGEPROC_IMGTYPE_16BPP = 3, /* 16 bits per pixel */ }; /* Structure of binary image */ struct imageproc_binary_img_s { uint8_t *p_u8; /* 1bpp image */ uint8_t multiplier; /* alpha value (255 = 100% src, 0 = 0%) */ }; typedef struct imageproc_binary_img_s imageproc_binary_img_t; /* Structure of image information. */ struct imageproc_imginfo_s { enum imageproc_imginfo_e type; /* Type of image data */ int w; /* Image width */ int h; /* Image height */ imageproc_rect_t *rect; /* Clipping rectangle */ union { uint8_t single; /* for IMAGEPROC_IMGTYPE_SINGLE */ imageproc_binary_img_t binary; /* for IMAGEPROC_IMGTYPE_1BPP */ uint8_t *p_u8; /* for IMAGEPROC_IMGTYPE_{8,16}BPP */ } img; }; typedef struct imageproc_imginfo_s imageproc_imginfo_t; /**************************************************************************** * Public Functions Prototypes ****************************************************************************/ /* Initialize imageproc library */ void imageproc_initialize(void); /* Finalize imageproc library */ void imageproc_finalize(void); /* Convert color format (YUV to RGB) * * TODO: need more description here * * [in,out] ibuf: image * [in] hsize: Horizontal size * [in] vsize: Vertical size * * return 0 on success, otherwise error code. */ int imageproc_convert_yuv2rgb(uint8_t *ibuf, uint32_t hsize, uint32_t vsize); /* Convert color format (RGB to YUV) * * [in,out] ibuf: image * [in] hsize: Horizontal size * [in] vsize: Vertical size * * return 0 on success, otherwise error code. */ int imageproc_convert_rgb2yuv(uint8_t *ibuf, uint32_t hsize, uint32_t vsize); /* Convert color format (YUV to grayscale) * * TODO: need more description here * * [in] ibuf: Input image * [out] obuf: Output buffer * [in] hsize: Horizontal size * [in] vsize: Vertical size */ void imageproc_convert_yuv2gray(uint8_t *ibuf, uint8_t *obuf, size_t hsize, size_t vsize); /* Resize image * * Resize image specified by ibuf to ohsize, ovsize. Processed * image will be stored to obuf. * * For ohsize and ovsize, specify output size calculated by multiply * in range from x1/64 to x64 against ihsize and ivsize. * * This function can be processing for YUV422 color format. * So all of specified horizontal size must be multiple of 2. * * And there is limitation about output size below. * * * Shrink * + Horizontal size least 12 pixels * + Vertical size least 12 pixels * * Enlarge * + Horizontal size up to 768 pixels * + Vertical size up to 1024 pixels * * [in] ibuf: Input image * [in] ihsize: Input horizontal size * [in] ivsize: Input vertical size * [out] obuf: Output buffer * [in] ohsize: Output horizontal size * [in] ovsize: Output vertical size * [in] bpp: Bits per pixel (16 or 8) * * return 0 on success, otherwise error code. * * CAUTION: In enlarge by higher scaling ratio, it may not be output * all of the pixels. */ int imageproc_resize(uint8_t *ibuf, uint16_t ihsize, uint16_t ivsize, uint8_t *obuf, uint16_t ohsize, uint16_t ovsize, int bpp); /* Clip and Resize image * * [in] ibuf: Input image * [in] ihsize: Input horizontal size * [in] ivsize: Input vertical size * [out] obuf: Output buffer * [in] ohsize: Output horizontal size * [in] ovsize: Output vertical size * [in] bpp: Bits per pixel (16 or 8) * [in] clip_rect: Clipping rectangle on input image. * * return 0 on success, otherwise error code. */ int imageproc_clip_and_resize(uint8_t *ibuf, uint16_t ihsize, uint16_t ivsize, uint8_t *obuf, uint16_t ohsize, uint16_t ovsize, int bpp, imageproc_rect_t *clip_rect); /* Execute alpha blending * * dst image will be overwritten by src image masked with alpha. * * [in,out] dst: Destination image. * dst->type = IMAGEPROC_IMGTYPE_16BPP. * rect parameter can specify the blending area. * * [in] pos_x: x-coordinate of blending position from origin. * Negative value is allowed, out of bounds src image will * be clipped. * [in] pos_y: y-coordinate of blending position from origin. * Negative value is allowed, out of bounds src image will * be clipped. * [in] src: Source image can be input as following formats. * * - IMAGEPROC_IMGTYPE_16BPP * - IMAGEPROC_IMGTYPE_SINGLE * * single image is emulated a fixed monotone color image * without image buffer. * [in] alpha: Alpha plane can be input as following formats. * * - IMAGEPROC_IMGTYPE_SINGLE * - IMAGEPROC_IMGTYPE_1BPP * - IMAGEPROC_IMGTYPE_8BPP * * SINGLE is specify a fixed alpha value (255 = 100%, * 0 = 0%) applying whole image size. * 1BPP is 1 bit per pixel map. 0 will be masked and 1 is * blending with multiplier (255 = 100%). * 1bpp bit order is LSB first. * * (0,0) (7,0) (x, y) * 0x03 = |1|1|0|0|0|0|0|0| * * return 0 on success, otherwise error code. */ int imageproc_alpha_blend(imageproc_imginfo_t *dst, int pos_x, int pos_y, imageproc_imginfo_t *src, imageproc_imginfo_t *alpha); #ifdef __cplusplus } #endif #endif /* __BOARDS_ARM_CXD56XX_SPRESENSE_INCLUDE_CXD56_IMAGEPROC_H */