193 lines
8.5 KiB
Plaintext
193 lines
8.5 KiB
Plaintext
/*
|
|
* Copyright (c) 2014 Amlogic, Inc. All rights reserved.
|
|
*
|
|
* This source code is subject to the terms and conditions defined in the
|
|
* file 'LICENSE' which is part of this source code package.
|
|
*
|
|
* Description:
|
|
*/
|
|
libge2d user guide
|
|
API:
|
|
int ge2d_open(void);
|
|
int ge2d_close(int fd);
|
|
int ge2d_process(int fd,aml_ge2d_info_t *pge2dinfo);
|
|
|
|
|
|
typedef struct aml_ge2d_info {
|
|
unsigned int offset;
|
|
unsigned int blend_mode;
|
|
GE2DOP ge2d_op;
|
|
buffer_info_t src_info[2];
|
|
buffer_info_t dst_info;
|
|
unsigned int color;
|
|
unsigned int gl_alpha;
|
|
unsigned int const_color;
|
|
unsigned int dst_op_cnt;
|
|
unsigned int reserved;
|
|
} aml_ge2d_info_t;
|
|
|
|
some bits of struct aml_ge2d_info:
|
|
unsigned int offset: y_offset of osd
|
|
unsigned int blend_mode: only valid when work under blend operation
|
|
unsigned int color: only valid when fillrectangle operation
|
|
GE2DOP ge2d_op: supported ge2d operation
|
|
supported ge2d operation include:
|
|
AML_GE2D_FILLRECTANGLE,
|
|
AML_GE2D_BLEND,
|
|
AML_GE2D_STRETCHBLIT,
|
|
AML_GE2D_BLIT,
|
|
|
|
typedef struct buffer_info {
|
|
unsigned int mem_alloc_type;
|
|
unsigned int memtype;
|
|
char* vaddr;
|
|
unsigned long offset;
|
|
unsigned int canvas_w;
|
|
unsigned int canvas_h;
|
|
rectangle_t rect;
|
|
int format;
|
|
unsigned int rotation;
|
|
int shared_fd;
|
|
unsigned char plane_alpha;
|
|
unsigned char layer_mode;
|
|
unsigned char fill_color_en;
|
|
unsigned int def_color;
|
|
} buffer_info_t;
|
|
some bits of struct buffer_info:
|
|
mem_alloc_type: if used as ion alloc or dma_buf alloc
|
|
memtype: if used as mem alloc:CANVAS_ALLOC
|
|
if used as OSD0/OSD1:CANVAS_OSD0/CANVAS_OSD1
|
|
char* vaddr: not need set,for debug
|
|
int shared_fd: shared buffer fd, alloc by ion or dma_buf
|
|
unsigned offset: buffer offset, default is 0
|
|
unsigned int canvas_w,
|
|
unsigned int canvas_h: if used as mem alloc,for src1, set it to rect.w, rect.h;
|
|
for dst, set it to canvas width,canvas height,
|
|
related to mem size.
|
|
if used as OSD0/OSD1,leave it unset,it will set by kernel;
|
|
int format: if used as mem alloc,set pixel format
|
|
if used as OSD0/OSD1,leave it unset,it will set by kernel;
|
|
rectangle_t rect: must be set,set it according real rect value.
|
|
unsigned int rotation: it can be set GE2D_ROTATION,rotation 0/90/180/270;
|
|
|
|
1. AML_GE2D_FILLRECTANGLE need set content:
|
|
src_info[0];
|
|
dst_info;
|
|
color;
|
|
offset;
|
|
|
|
2.AML_GE2D_BLEND need set content:
|
|
src_info[0];
|
|
src_info[1];
|
|
dst_info;
|
|
blend_mode;
|
|
offset;
|
|
|
|
3.AML_GE2D_STRETCHBLIT need set content:
|
|
src_info[0];
|
|
dst_info;
|
|
offset;
|
|
|
|
3.AML_GE2D_BLIT need set content:
|
|
src_info[0];
|
|
dst_info;
|
|
offset;
|
|
|
|
/////////////////////////////////////////////////////////////////
|
|
The test application include ge2d_load_test and ge2d_feature test.
|
|
ge2d_load_test provide ge2d loading test.
|
|
ge2d_load_test --op 2 --duration 3000 --size 1920x1080 --pixelformat 0
|
|
--op <0:fillrect, 1:blend, 2:strechblit, 3:blit> ge2d operation case.
|
|
--size <WxH> define src1/src2/dst size.
|
|
--src1_memtype <0: ion, 1: dmabuf> define memory alloc type.
|
|
--src2_memtype <0: ion, 1: dmabuf> define memory alloc type.
|
|
--dst_memtype <0: ion, 1: dmabuf> define memory alloc type.
|
|
--src1_format <num> define src1 format.
|
|
--src2_format <num> define src2 format.
|
|
--dst_format <num> define dst format.
|
|
--src1_size <WxH> define src1 size.
|
|
--src2_size <WxH> define src2 size.
|
|
--dst_size <WxH> define dst size.
|
|
--src1_file <name> define src1 file.
|
|
--src2_file <name> define src2 file.
|
|
--dst_file <name> define dst file.
|
|
--src1_canvas_alloc <num> define whether src1 need alloc mem 0:GE2D_CANVAS_OSD0 1:GE2D_CANVAS_ALLOC.
|
|
--src2_canvas_alloc <num> defien whether src2 need alloc mem 0:GE2D_CANVAS_OSD0 1:GE2D_CANVAS_ALLOC.
|
|
--src1_rect <x_y_w_h> define src1 rect.
|
|
--src2_rect <x_y_w_h> define src2 rect.
|
|
--dst_rect <x_y_w_h> define dst rect.
|
|
--bo1 <layer_mode_num> define src1_layer_mode.
|
|
--bo2 <layer_mode_num> define src2_layer_mode.
|
|
--gb1 <gb1_alpha> define src1 global alpha.
|
|
--gb2 <gb2_alpha> define src2 global alpha.
|
|
--strechblit <x0_y0_w_h-x1_y1_w1_h1> define strechblit info.
|
|
--fillrect <color_x_y_w_h> define fillrect info, color in rgba format.
|
|
--src2_planenumber <num> define src2 plane number.
|
|
--src1_planenumber <num> define src1 plane number.
|
|
--dst_planenumber <num> define dst plane number.
|
|
--help Print usage information.
|
|
note: tester can change memtype to GE2D_CANVAS_ALLOC/GE2D_CANVAS_OSD0/GE2D_CANVAS_OSD1 as your requirement
|
|
if src1 memtype is GE2D_CANVAS_ALLOC, it can read data from file via aml_read_file.
|
|
|
|
note: tester can change memtype to GE2D_CANVAS_ALLOC/GE2D_CANVAS_OSD0/GE2D_CANVAS_OSD1 as your requirement
|
|
if src1 memtype is GE2D_CANVAS_ALLOC, you can read data from file via aml_read_file_src1
|
|
if src2 memtype is GE2D_CANVAS_ALLOC, you can read data from file via aml_read_file_src2
|
|
if dst memtype is GE2D_CANVAS_ALLOC, you can write data to file aml_write_file
|
|
|
|
ge2d_feature_test provide ge2d operation example.
|
|
//src used ion alloc, dst used osd
|
|
./ge2d_feature_test --op 2 --src1_memtype 0 --dst_memtype 0 --size 1920x1080 --src1_format 1 --dst_format 1 --src1_file 1080P_RGBA8888.rgb32
|
|
//src used dma_buf alloc, dst used osd
|
|
./ge2d_feature_test --op 2 --src1_memtype 1 --dst_memtype 1 --size 1920x1080 --src1_format 1 --dst_format 1 --src1_file 1080P_RGBA8888.rgb32
|
|
|
|
//src used ion alloc, dst used dma_buf alloc
|
|
./ge2d_feature_test --op 2 --src1_memtype 0 --dst_memtype 1 --size 1920x1080 --src1_format 1 --dst_format 1 --src1_file 1080P_RGBA8888.rgb32 --dst_file out_dma.rgb32
|
|
|
|
//src used dma_buf alloc, dst used ion alloc
|
|
./ge2d_feature_test --op 2 --src1_memtype 1 --dst_memtype 0 --size 1920x1080 --src1_format 1 --dst_format 1 --src1_file 1080P_RGBA8888.rgb32 --dst_file out_ion.rgb32
|
|
|
|
//src used dma_buf alloc, dst used dma_buf alloc
|
|
./ge2d_feature_test --op 2 --src1_memtype 1 --dst_memtype 1--size 1920x1080 --src1_format 1 --dst_format 1 --src1_file 1080P_RGBA8888.rgb32 --dst_file out_ion.rgb32
|
|
|
|
|
|
|
|
|
|
if dma buffer is allocated by ge2d, please add content blow in DTS:
|
|
|
|
/ {
|
|
/* ...... */
|
|
reserved-memory {
|
|
/* ...... */
|
|
ge2d_cma_reserved:linux,ge2d_cma {
|
|
compatible = "shared-dma-pool";
|
|
reusable;
|
|
status = "okay";
|
|
size = <0x0 0x1800000>;
|
|
alignment = <0x0 0x400000>;
|
|
};
|
|
}
|
|
/* ...... */
|
|
ge2d {
|
|
/* ...... */
|
|
memory-region = <&ge2d_cma_reserved>;
|
|
};
|
|
}
|
|
|
|
|
|
usage examples:
|
|
fillrect ---
|
|
./ge2d_feature_test --op 0 --dst_size 1920x1080 --src1_format 1 --dst_format 1 --fillrect 0x00ff00ff_50_50_100_100 --dst_file fillrect.rgb32
|
|
|
|
blend ---
|
|
./ge2d_feature_test --op 1 --dst_size 1920x1080 --dst_rect 100_100_400_400 --src1_size 1920x1080 --src1_rect 100_100_400_400 --src2_size 400x400 --src2_rect 0_0_400_400 --dst_format 1 --src1_format 1 --src2_format 1 --src1_file 1080P_RGBA8888.rgb32 --src2_file 400x400_RGBA8888.rgb32 --bo1 2 --bo2 2 --gb1 150 --gb2 255 --dst_file blend.rgb32
|
|
|
|
strechblit ---
|
|
./ge2d_feature_test --op 2 --size 1920x1080 --src1_format 1 --dst_format 1 --strechblit 0_0_1920_100-50_50_200_300 --src1_file 1080P_RGBA8888.rgb32 --dst_file strechblit.rgb32
|
|
|
|
blit ---
|
|
./ge2d_feature_test --op 3 --size 1920x1080 --src1_format 1 --dst_format 1 --src1_rect 0_0_1920_100 --dst_rect 0_0_1920_100 --src1_file 1080P_RGBA8888.rgb32 --dst_file blit.rgb32
|
|
multiplane fd support:
|
|
add options para if needed:
|
|
--src1_planenumber 1 src2_planenumber 1 --dst_planenumber 1
|
|
--src1_planenumber 2 src2_planenumber 2 --dst_planenumber 2
|