readme.txt

/*
 * 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