awk_adapter.h

浏览该文件的文档.

/*
 * @brief 系统适配接口
 */
 
#ifndef _AWK_ADAPATER_H
#define _AWK_ADAPATER_H
 
#include <stdbool.h>
#include <stddef.h>
#include <stdint.h>
#include "awk_defines.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*********************
 *    绘制相关适配层
*********************/
typedef enum {
  AWK_ALIGN_STYLE_NONE,
  AWK_ALIGN_STYLE_CENTER,
  AWK_ALIGN_STYLE_LEFT,
  AWK_ALIGN_STYLE_RIGHT
} awk_align_style_t;
 
typedef enum {
   AWK_FONT_WEIGHT_NORMAL,
   AWK_FONT_WEIGHT_THIN,
   AWK_FONT_WEIGHT_BOLD,
} awk_font_weight_t;
 
typedef struct _awk_text_style_t {
    awk_align_style_t align;
    uint32_t font_size;
    awk_font_weight_t font_weight;
} awk_text_style_t;
 
typedef enum {
   AWK_FILL_STYLE_DRAWING_ONLY,          // 仅填充几何图形
   AWK_FILL_STYLE_DRAWING_AND_STROKE,    // 填充几何图形和描边
   AWK_FILL_STYLE_STROKE_ONLY            // 仅填充描边
} awk_fill_style_t;
  
typedef struct _awk_dash_style_t {
    int32_t painted_length;     
    int32_t unpainted_length;   
    int32_t offset;             
} awk_dash_style_t;
 
typedef struct _awk_paint_style_t {
    uint32_t width;                 
    uint32_t color;                 
    float angle;                    
    awk_text_style_t text_style;    
    awk_fill_style_t fill_ttyle;    // 填充样式
    awk_dash_style_t dash_style;    
} awk_paint_style_t;
 
typedef struct _awk_render_context_t {
    int32_t width;         
    int32_t height;        
} awk_render_context_t;
 
typedef struct _awk_render_adapter_t awk_render_adapter_t;
struct _awk_render_adapter_t {
    void (*begin_drawing) (uint32_t map_id, awk_render_context_t status);
 
    void (*commit_drawing)(uint32_t map_id);
    
    void (*draw_point)(uint32_t map_id, awk_point_t *point, uint32_t point_size, const awk_paint_style_t *style);
 
    void (*draw_polyline)(uint32_t map_id, awk_point_t *points, uint32_t point_size, const awk_paint_style_t *style);
 
    void (*draw_polygon)(uint32_t map_id, awk_point_t *points, uint32_t point_size, const awk_paint_style_t *style);
 
    void (*draw_bitmap)(uint32_t map_id, awk_rect_area_t area, awk_bitmap_t bitmap, const awk_paint_style_t *style);
 
    void (*draw_text)(uint32_t map_id, awk_point_t center, const char *text, const awk_paint_style_t *style);
 
    void (*draw_color)(uint32_t map_id, awk_rect_area_t area, const awk_paint_style_t *style);
    
    bool (*measure_text)(uint32_t map_id, const char *text, const awk_paint_style_t *style, int32_t *width, int32_t *ascender, int32_t *descender);
};
 
/*********************
 *    文件系统相关适配层
*********************/
 
typedef struct _awk_file_node {
    char file_name[128];    
    size_t file_size;       
} awk_file_node;
 
typedef struct _awk_readdir_result {
    awk_file_node *nodes;   
    size_t size;            
} awk_readdir_result;
 
typedef struct _awk_file_adapter_t awk_file_adapter_t;
struct _awk_file_adapter_t {
    void* (*file_open) (const char *filename, const char *mode);
    int (*file_close) (void* handler);
    size_t (*file_read) (void *ptr, size_t size, void* handler);
    size_t (*file_write) (void *ptr, size_t size, void* handler);
    int (*file_seek) (void *handler, long offset, int where);
    int (*file_flush) (void *handler);
    bool (*file_exists) (const char *path);
    int (*file_remove) (const char *path);
    bool (*file_dir_exists) (const char *path);
    int (*file_mkdir) (const char *path, uint16_t model);
    int (*file_rmdir) (const char *path);
    void* (*file_opendir)(const char *path);
    int (*file_closedir)(void *dir);
    bool (*file_readdir)(void *dir, awk_readdir_result *result);
    size_t (*file_get_size) (const char *path);
    long (*file_get_last_access) (const char *path);
    int  (*file_rename) (const char *old_name, const char *new_name);
    bool (*file_unzip)(const char *zip_file, const char *out_dir);
};
 
 
/*********************
 *    内存相关适配层
*********************/
 
typedef struct _awk_memory_adapter_t awk_memory_adapter_t;
struct _awk_memory_adapter_t {
    void (*mem_free)(void* ptr);
    void* (*mem_malloc) (size_t size);
    void* (*mem_calloc) (size_t count, size_t size);
    void* (*mem_realloc) (void* ptr, size_t size);
};
    
typedef struct _awk_fast_memory_adapter_t awk_fast_memory_adapter_t;
struct _awk_fast_memory_adapter_t {
    void (*mem_free)(void* ptr);
    void* (*mem_malloc) (size_t size, int type);
};
 
/*********************
 *    网络相关适配层
*********************/
 
AWK_DATA_MAP_DEFINE(http_header_t, char*, char*);
#define awk_http_header_t awk_map_http_header_t
 
/*
 * @brief 网络请求类型
 */
typedef enum _awk_http_method {
    AWK_HTTP_METHOD_POST,
    AWK_HTTP_METHOD_GET,
} awk_http_method;
    
/*
 * @brief 网络请求优先级
 */
typedef enum _awk_http_priority {
    AWK_HTTP_PRIORITY_LOW,       
    AWK_HTTP_PRIORITY_MEDIUM,    
    AWK_HTTP_PRIORITY_HIGH,      
} awk_http_priority;
 
typedef struct _awk_http_buffer_t awk_http_buffer_t;
struct _awk_http_buffer_t {
    uint8_t *buffer;            
    size_t length;              
};
 
typedef struct _awk_http_request_t {
    char *url;                                        
    awk_http_priority priority;                       
    awk_http_method method;                           
    awk_http_buffer_t *body;                          
    awk_http_header_t headers;                        
} awk_http_request_t;
 
typedef struct _awk_http_response_t {
    uint64_t request_id;                              
    char* url;                                        
    uint32_t status_code;                             
    awk_http_buffer_t *body;                           
    awk_http_header_t headers;                         
} awk_http_response_t;
 
typedef struct _awk_http_response_callback_t awk_http_response_callback_t;
struct _awk_http_response_callback_t {
    void (*on_receive_header) (awk_http_response_callback_t *callback, const awk_http_response_t *response);
    void (*on_receive_body) (awk_http_response_callback_t *callback, const awk_http_response_t *response);
    void (*on_fail) (awk_http_response_callback_t *callback, const awk_http_response_t *response, int32_t error);
    void (*on_success) (awk_http_response_callback_t *callback, const awk_http_response_t *response);
    void (*on_canceled) (awk_http_response_callback_t *callback, const awk_http_response_t *response);
};
 
typedef struct _awk_network_adapter_t awk_network_adapter_t;
struct _awk_network_adapter_t {
    uint64_t (*send) (awk_http_request_t *request, awk_http_response_callback_t *callback);
    void (*cancel) (uint64_t request_id);
};
 
 
/*********************
 *    其他系统相关适配层
*********************/
 
typedef struct _awk_system_adapter_t awk_system_adapter_t;
struct _awk_system_adapter_t {
    uint64_t (*get_system_time)(void);
 
    int (*log_printf)(const char* __fmt, ...);
};
 
/*********************
 *    线程相关适配层
*********************/
 
typedef struct _awk_thread_adapter_t {
    uint64_t (*get_thread_id)(void);
} awk_thread_adapter_t;
 
/*********************
 *    瓦片文件
*********************/
 
typedef struct _awk_map_tile_file_adapter_t {
    bool (*on_tile_file)(const char* tile_file_key, char *file_path, size_t *file_offset, size_t *file_size);
} awk_map_tile_file_adapter_t;
 
 
/*********************
 *    定制
*********************/
 
typedef struct _awk_map_custom_adapter_t {
    int (*custom_sscanf)(const char *s, const char *format, ...);
    
    void (*custom_assert)(int expression);
} awk_map_custom_adapter_t;
#ifdef __cplusplus
}
#endif
 
#endif