camera/QCamera2/stack/common/mm_jpeg_interface.h - device/moto/shamu - Git at Google

 /* Copyright (c) 2012, 2014, 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 MM_JPEG_INTERFACE_H_
 #define MM_JPEG_INTERFACE_H_
 #include "QOMX_JpegExtensions.h"
 #include "cam_intf.h"

 #define MM_JPEG_MAX_PLANES 3
 #define MM_JPEG_MAX_BUF CAM_MAX_NUM_BUFS_PER_STREAM
 #define QUANT_SIZE 64
 #define QTABLE_MAX 2

 typedef enum {
   MM_JPEG_FMT_YUV,
   MM_JPEG_FMT_BITSTREAM
 } mm_jpeg_format_t;

 typedef struct {
   cam_3a_params_t cam_3a_params;
   cam_sensor_params_t sensor_params;
 } mm_jpeg_exif_params_t;

 typedef struct {
   uint32_t sequence;          /* for jpeg bit streams, assembling is based on sequence. sequence starts from 0 */
   uint8_t *buf_vaddr;        /* ptr to buf */
   int fd;                    /* fd of buf */
   uint32_t buf_size;         /* total size of buf (header + image) */
   mm_jpeg_format_t format;   /* buffer format*/
   cam_frame_len_offset_t offset; /* offset of all the planes */
   int index; /* index used to identify the buffers */
 } mm_jpeg_buf_t;

 typedef struct {
   uint8_t *buf_vaddr;        /* ptr to buf */
   int fd;                    /* fd of buf */
   uint32_t buf_filled_len;   /* used for output image. filled by the client */
 } mm_jpeg_output_t;

 typedef enum {
   MM_JPEG_COLOR_FORMAT_YCRCBLP_H2V2,
   MM_JPEG_COLOR_FORMAT_YCBCRLP_H2V2,
   MM_JPEG_COLOR_FORMAT_YCRCBLP_H2V1,
   MM_JPEG_COLOR_FORMAT_YCBCRLP_H2V1,
   MM_JPEG_COLOR_FORMAT_YCRCBLP_H1V2,
   MM_JPEG_COLOR_FORMAT_YCBCRLP_H1V2,
   MM_JPEG_COLOR_FORMAT_YCRCBLP_H1V1,
   MM_JPEG_COLOR_FORMAT_YCBCRLP_H1V1,
   MM_JPEG_COLOR_FORMAT_MONOCHROME,
   MM_JPEG_COLOR_FORMAT_BITSTREAM_H2V2,
   MM_JPEG_COLOR_FORMAT_BITSTREAM_H2V1,
   MM_JPEG_COLOR_FORMAT_BITSTREAM_H1V2,
   MM_JPEG_COLOR_FORMAT_BITSTREAM_H1V1,
   MM_JPEG_COLOR_FORMAT_MAX
 } mm_jpeg_color_format;

 typedef enum {
   JPEG_JOB_STATUS_DONE = 0,
   JPEG_JOB_STATUS_ERROR
 } jpeg_job_status_t;

 typedef void (*jpeg_encode_callback_t)(jpeg_job_status_t status,
   uint32_t client_hdl,
   uint32_t jobId,
   mm_jpeg_output_t *p_output,
   void *userData);

 typedef struct {
   /* src img dimension */
   cam_dimension_t src_dim;

   /* jpeg output dimension */
   cam_dimension_t dst_dim;

   /* crop information */
   cam_rect_t crop;
 } mm_jpeg_dim_t;

 typedef struct {
   /* num of buf in src img */
   uint32_t num_src_bufs;

   /* num of src tmb bufs */
   uint32_t num_tmb_bufs;

   /* num of buf in src img */
   uint32_t num_dst_bufs;

   int8_t encode_thumbnail;

   /* src img bufs */
   mm_jpeg_buf_t src_main_buf[MM_JPEG_MAX_BUF];

   /* this will be used only for bitstream */
   mm_jpeg_buf_t src_thumb_buf[MM_JPEG_MAX_BUF];

   /* this will be used only for bitstream */
   mm_jpeg_buf_t dest_buf[MM_JPEG_MAX_BUF];

   /* mainimage color format */
   mm_jpeg_color_format color_format;

   /* thumbnail color format */
   mm_jpeg_color_format thumb_color_format;

   /* jpeg quality: range 0~100 */
   uint32_t quality;

   /* jpeg thumbnail quality: range 0~100 */
   uint32_t thumb_quality;

   /* buf to exif entries, caller needs to
    * take care of the memory manage with insider ptr */
   QOMX_EXIF_INFO exif_info;

   /*Callback registered to be called after encode*/
   jpeg_encode_callback_t jpeg_cb;

   /*Appdata passed by the user*/
   void* userdata;

   /* thumbnail dimension */
   mm_jpeg_dim_t thumb_dim;

   /* rotation informaiton */
   int rotation;

   /* thumb rotation informaiton */
   int thumb_rotation;

   /* main image dimension */
   mm_jpeg_dim_t main_dim;

   /* enable encoder burst mode */
   int8_t burst_mode;

   /*jpeg orientation information*/
   int jpeg_orientation;

   /* get memory function ptr */
   int (*get_memory)( omx_jpeg_ouput_buf_t *p_out_buf);
 } mm_jpeg_encode_params_t;

 typedef struct {
   /* num of buf in src img */
   uint32_t num_src_bufs;

   /* num of buf in src img */
   uint32_t num_dst_bufs;

   /* src img bufs */
   mm_jpeg_buf_t src_main_buf[MM_JPEG_MAX_BUF];

   /* this will be used only for bitstream */
   mm_jpeg_buf_t dest_buf[MM_JPEG_MAX_BUF];

   /* color format */
   mm_jpeg_color_format color_format;

   jpeg_encode_callback_t jpeg_cb;
   void* userdata;

 } mm_jpeg_decode_params_t;

 typedef struct {
   /* active indices of the buffers for encoding */
   int32_t src_index;
   int32_t dst_index;
   uint32_t thumb_index;
   mm_jpeg_dim_t thumb_dim;

   /* rotation informaiton */
   int rotation;

   /* main image dimension */
   mm_jpeg_dim_t main_dim;

   /*session id*/
   uint32_t session_id;

   /*Metadata stream*/
   metadata_buffer_t *p_metadata;

   /*HAL version*/
   cam_hal_version_t hal_version;

   /* buf to exif entries, caller needs to
    * take care of the memory manage with insider ptr */
   QOMX_EXIF_INFO exif_info;

   /* 3a parameters */
   mm_jpeg_exif_params_t cam_exif_params;

   /* jpeg encoder QTable */
   uint8_t qtable_set[QTABLE_MAX];
   OMX_IMAGE_PARAM_QUANTIZATIONTABLETYPE qtable[QTABLE_MAX];
 } mm_jpeg_encode_job_t;

 typedef struct {
   /* active indices of the buffers for encoding */
   uint32_t src_index;
   uint32_t dst_index;
   uint32_t tmb_dst_index;

   /* rotation informaiton */
   int rotation;

   /* main image  */
   mm_jpeg_dim_t main_dim;

   /*session id*/
   uint32_t session_id;
 } mm_jpeg_decode_job_t;

 typedef enum {
   JPEG_JOB_TYPE_ENCODE,
   JPEG_JOB_TYPE_DECODE,
   JPEG_JOB_TYPE_MAX
 } mm_jpeg_job_type_t;

 typedef struct {
   mm_jpeg_job_type_t job_type;
   union {
     mm_jpeg_encode_job_t encode_job;
     mm_jpeg_decode_job_t decode_job;
   };
 } mm_jpeg_job_t;

 typedef struct {
   uint32_t w;
   uint32_t h;
 } mm_dimension;

 typedef struct {
   /* config a job -- async call */
   int (*start_job)(mm_jpeg_job_t* job, uint32_t* job_id);

   /* abort a job -- sync call */
   int (*abort_job)(uint32_t job_id);

   /* create a session */
   int (*create_session)(uint32_t client_hdl,
     mm_jpeg_encode_params_t *p_params, uint32_t *p_session_id);

   /* destroy session */
   int (*destroy_session)(uint32_t session_id);

   /* close a jpeg client -- sync call */
   int (*close) (uint32_t clientHdl);
 } mm_jpeg_ops_t;

 typedef struct {
   /* config a job -- async call */
   int (*start_job)(mm_jpeg_job_t* job, uint32_t* job_id);

   /* abort a job -- sync call */
   int (*abort_job)(uint32_t job_id);

   /* create a session */
   int (*create_session)(uint32_t client_hdl,
     mm_jpeg_decode_params_t *p_params, uint32_t *p_session_id);

   /* destroy session */
   int (*destroy_session)(uint32_t session_id);

   /* close a jpeg client -- sync call */
   int (*close) (uint32_t clientHdl);
 } mm_jpegdec_ops_t;

 /* open a jpeg client -- sync call
  * returns client_handle.
  * failed if client_handle=0
  * jpeg ops tbl will be filled in if open succeeds */
 uint32_t jpeg_open(mm_jpeg_ops_t *ops, mm_dimension picture_size);

 /* open a jpeg client -- sync call
  * returns client_handle.
  * failed if client_handle=0
  * jpeg ops tbl will be filled in if open succeeds */
 uint32_t jpegdec_open(mm_jpegdec_ops_t *ops);

 #endif /* MM_JPEG_INTERFACE_H_ */
	/* Copyright (c) 2012, 2014, 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 MM_JPEG_INTERFACE_H_
	#define MM_JPEG_INTERFACE_H_
	#include "QOMX_JpegExtensions.h"
	#include "cam_intf.h"

	#define MM_JPEG_MAX_PLANES 3
	#define MM_JPEG_MAX_BUF CAM_MAX_NUM_BUFS_PER_STREAM
	#define QUANT_SIZE 64
	#define QTABLE_MAX 2

	typedef enum {
	MM_JPEG_FMT_YUV,
	MM_JPEG_FMT_BITSTREAM
	} mm_jpeg_format_t;

	typedef struct {
	cam_3a_params_t cam_3a_params;
	cam_sensor_params_t sensor_params;
	} mm_jpeg_exif_params_t;

	typedef struct {
	uint32_t sequence; /* for jpeg bit streams, assembling is based on sequence. sequence starts from 0 */
	uint8_t buf_vaddr; / ptr to buf */
	int fd; /* fd of buf */
	uint32_t buf_size; /* total size of buf (header + image) */
	mm_jpeg_format_t format; /* buffer format*/
	cam_frame_len_offset_t offset; /* offset of all the planes */
	int index; /* index used to identify the buffers */
	} mm_jpeg_buf_t;

	typedef struct {
	uint8_t buf_vaddr; / ptr to buf */
	int fd; /* fd of buf */
	uint32_t buf_filled_len; /* used for output image. filled by the client */
	} mm_jpeg_output_t;

	typedef enum {
	MM_JPEG_COLOR_FORMAT_YCRCBLP_H2V2,
	MM_JPEG_COLOR_FORMAT_YCBCRLP_H2V2,
	MM_JPEG_COLOR_FORMAT_YCRCBLP_H2V1,
	MM_JPEG_COLOR_FORMAT_YCBCRLP_H2V1,
	MM_JPEG_COLOR_FORMAT_YCRCBLP_H1V2,
	MM_JPEG_COLOR_FORMAT_YCBCRLP_H1V2,
	MM_JPEG_COLOR_FORMAT_YCRCBLP_H1V1,
	MM_JPEG_COLOR_FORMAT_YCBCRLP_H1V1,
	MM_JPEG_COLOR_FORMAT_MONOCHROME,
	MM_JPEG_COLOR_FORMAT_BITSTREAM_H2V2,
	MM_JPEG_COLOR_FORMAT_BITSTREAM_H2V1,
	MM_JPEG_COLOR_FORMAT_BITSTREAM_H1V2,
	MM_JPEG_COLOR_FORMAT_BITSTREAM_H1V1,
	MM_JPEG_COLOR_FORMAT_MAX
	} mm_jpeg_color_format;

	typedef enum {
	JPEG_JOB_STATUS_DONE = 0,
	JPEG_JOB_STATUS_ERROR
	} jpeg_job_status_t;

	typedef void (*jpeg_encode_callback_t)(jpeg_job_status_t status,
	uint32_t client_hdl,
	uint32_t jobId,
	mm_jpeg_output_t *p_output,
	void *userData);

	typedef struct {
	/* src img dimension */
	cam_dimension_t src_dim;

	/* jpeg output dimension */
	cam_dimension_t dst_dim;

	/* crop information */
	cam_rect_t crop;
	} mm_jpeg_dim_t;

	typedef struct {
	/* num of buf in src img */
	uint32_t num_src_bufs;

	/* num of src tmb bufs */
	uint32_t num_tmb_bufs;

	/* num of buf in src img */
	uint32_t num_dst_bufs;

	int8_t encode_thumbnail;

	/* src img bufs */
	mm_jpeg_buf_t src_main_buf[MM_JPEG_MAX_BUF];

	/* this will be used only for bitstream */
	mm_jpeg_buf_t src_thumb_buf[MM_JPEG_MAX_BUF];

	/* this will be used only for bitstream */
	mm_jpeg_buf_t dest_buf[MM_JPEG_MAX_BUF];

	/* mainimage color format */
	mm_jpeg_color_format color_format;

	/* thumbnail color format */
	mm_jpeg_color_format thumb_color_format;

	/* jpeg quality: range 0~100 */
	uint32_t quality;

	/* jpeg thumbnail quality: range 0~100 */
	uint32_t thumb_quality;

	/* buf to exif entries, caller needs to
	* take care of the memory manage with insider ptr */
	QOMX_EXIF_INFO exif_info;

	/Callback registered to be called after encode/
	jpeg_encode_callback_t jpeg_cb;

	/Appdata passed by the user/
	void* userdata;

	/* thumbnail dimension */
	mm_jpeg_dim_t thumb_dim;

	/* rotation informaiton */
	int rotation;

	/* thumb rotation informaiton */
	int thumb_rotation;

	/* main image dimension */
	mm_jpeg_dim_t main_dim;

	/* enable encoder burst mode */
	int8_t burst_mode;

	/jpeg orientation information/
	int jpeg_orientation;

	/* get memory function ptr */
	int (get_memory)( omx_jpeg_ouput_buf_t p_out_buf);
	} mm_jpeg_encode_params_t;

	typedef struct {
	/* num of buf in src img */
	uint32_t num_src_bufs;

	/* num of buf in src img */
	uint32_t num_dst_bufs;

	/* src img bufs */
	mm_jpeg_buf_t src_main_buf[MM_JPEG_MAX_BUF];

	/* this will be used only for bitstream */
	mm_jpeg_buf_t dest_buf[MM_JPEG_MAX_BUF];

	/* color format */
	mm_jpeg_color_format color_format;

	jpeg_encode_callback_t jpeg_cb;
	void* userdata;

	} mm_jpeg_decode_params_t;

	typedef struct {
	/* active indices of the buffers for encoding */
	int32_t src_index;
	int32_t dst_index;
	uint32_t thumb_index;
	mm_jpeg_dim_t thumb_dim;

	/* rotation informaiton */
	int rotation;

	/* main image dimension */
	mm_jpeg_dim_t main_dim;

	/session id/
	uint32_t session_id;

	/Metadata stream/
	metadata_buffer_t *p_metadata;

	/HAL version/
	cam_hal_version_t hal_version;

	/* buf to exif entries, caller needs to
	* take care of the memory manage with insider ptr */
	QOMX_EXIF_INFO exif_info;

	/* 3a parameters */
	mm_jpeg_exif_params_t cam_exif_params;

	/* jpeg encoder QTable */
	uint8_t qtable_set[QTABLE_MAX];
	OMX_IMAGE_PARAM_QUANTIZATIONTABLETYPE qtable[QTABLE_MAX];
	} mm_jpeg_encode_job_t;

	typedef struct {
	/* active indices of the buffers for encoding */
	uint32_t src_index;
	uint32_t dst_index;
	uint32_t tmb_dst_index;

	/* rotation informaiton */
	int rotation;

	/* main image */
	mm_jpeg_dim_t main_dim;

	/session id/
	uint32_t session_id;
	} mm_jpeg_decode_job_t;

	typedef enum {
	JPEG_JOB_TYPE_ENCODE,
	JPEG_JOB_TYPE_DECODE,
	JPEG_JOB_TYPE_MAX
	} mm_jpeg_job_type_t;

	typedef struct {
	mm_jpeg_job_type_t job_type;
	union {
	mm_jpeg_encode_job_t encode_job;
	mm_jpeg_decode_job_t decode_job;
	};
	} mm_jpeg_job_t;

	typedef struct {
	uint32_t w;
	uint32_t h;
	} mm_dimension;

	typedef struct {
	/* config a job -- async call */
	int (start_job)(mm_jpeg_job_t job, uint32_t* job_id);

	/* abort a job -- sync call */
	int (*abort_job)(uint32_t job_id);

	/* create a session */
	int (*create_session)(uint32_t client_hdl,
	mm_jpeg_encode_params_t p_params, uint32_t p_session_id);

	/* destroy session */
	int (*destroy_session)(uint32_t session_id);

	/* close a jpeg client -- sync call */
	int (*close) (uint32_t clientHdl);
	} mm_jpeg_ops_t;

	typedef struct {
	/* config a job -- async call */
	int (start_job)(mm_jpeg_job_t job, uint32_t* job_id);

	/* abort a job -- sync call */
	int (*abort_job)(uint32_t job_id);

	/* create a session */
	int (*create_session)(uint32_t client_hdl,
	mm_jpeg_decode_params_t p_params, uint32_t p_session_id);

	/* destroy session */
	int (*destroy_session)(uint32_t session_id);

	/* close a jpeg client -- sync call */
	int (*close) (uint32_t clientHdl);
	} mm_jpegdec_ops_t;

	/* open a jpeg client -- sync call
	* returns client_handle.
	* failed if client_handle=0
	* jpeg ops tbl will be filled in if open succeeds */
	uint32_t jpeg_open(mm_jpeg_ops_t *ops, mm_dimension picture_size);

	/* open a jpeg client -- sync call
	* returns client_handle.
	* failed if client_handle=0
	* jpeg ops tbl will be filled in if open succeeds */
	uint32_t jpegdec_open(mm_jpegdec_ops_t *ops);

	#endif /* MM_JPEG_INTERFACE_H_ */