DragonOS/kernel/common/printk.h

//
// Created by longjin on 2022/1/21.
//
#pragma once


#define PAD_ZERO 1 // 0填充
#define LEFT 2     // 靠左对齐
#define RIGHT 4    // 靠右对齐
#define PLUS 8     // 在正数前面显示加号
#define SPACE 16
#define SPECIAL 32 // 在八进制数前面显示 '0o'，在十六进制数前面显示 '0x' 或 '0X'
#define SMALL 64   // 十进制以上数字显示小写字母
#define SIGN 128   // 显示符号位

#define is_digit(c) ((c) >= '0' && (c) <= '9') // 用来判断是否是数字的宏

// 字体颜色的宏定义
#define WHITE 0x00ffffff  //白
#define BLACK 0x00000000  //黑
#define RED 0x00ff0000    //红
#define ORANGE 0x00ff8000 //橙
#define YELLOW 0x00ffff00 //黄
#define GREEN 0x0000ff00  //绿
#define BLUE 0x000000ff   //蓝
#define INDIGO 0x0000ffff //靛
#define PURPLE 0x008000ff //紫

// 异常的宏定义
#define EPOS_OVERFLOW 1 // 坐标溢出
#define EFB_MISMATCH 2  // 帧缓冲区与指定的屏幕大小不匹配

#include "font.h"
#include "glib.h"
//#include "linkage.h"
#include <stdarg.h>

struct screen_info
{
    int width, height; //屏幕大小

    int max_x, max_y; // 最大x、y字符数

    int x, y; //光标位置

    int char_size_x, char_size_y;

    unsigned int *FB_address; //帧缓冲区首地址
    unsigned long FB_length;  // 帧缓冲区长度
};


extern unsigned char font_ascii[256][16]; //导出ascii字体的bitmap（8*16大小） ps:位于font.h中

char buf[4096]; //vsprintf()的缓冲区

/**
 * @brief 初始化printk的屏幕信息
 * 
 * @param width 屏幕宽度
 * @param height 屏幕高度
 * @param FB_address 帧缓冲区地址
 * @param FB_length 帧缓冲区长度
 * @param char_size_x 字符的列坐标
 * @param char_size_y 字符的行坐标
 */
int init_printk(const int width, const int height, unsigned int *FB_address, const int FB_length, const int char_size_x, const int char_size_y);
/**
 * @brief Set the printk pos object
 * 
 * @param x 列坐标
 * @param y 行坐标
 */
int set_printk_pos(const int x, const int y);
/**
 * @brief 将字符串按照fmt和args中的内容进行格式化，然后保存到buf中
 * 
 * @param buf 结果缓冲区
 * @param fmt 格式化字符串
 * @param args 内容
 * @return 最终字符串的长度
 */
static int vsprintf(char *buf, const char *fmt, va_list args);

/**
 * @brief 将数字按照指定的要求转换成对应的字符串（2~36进制）
 * 
 * @param str 要返回的字符串
 * @param num 要打印的数值
 * @param base 基数
 * @param field_width 区域宽度 
 * @param precision 精度
 * @param flags 标志位
 */
static char* write_num(char *str, ull num, int base, int field_width, int precision, int flags);


static char *write_float_point_num(char *str, double num, int field_width, int precision, int flags);

/**
 * @brief 在屏幕上指定位置打印字符
 * 
 * @param fb 帧缓存线性地址
 * @param Xsize 行分辨率
 * @param x 左上角列像素点位置
 * @param y 左上角行像素点位置
 * @param FRcolor 字体颜色
 * @param BKcolor 背景颜色
 * @param font 字符的bitmap
 */
static void putchar(unsigned int *fb, int Xsize, int x, int y, unsigned int FRcolor, unsigned int BKcolor, unsigned char font);

/**
 * @brief 格式化打印字符串
 * 
 * @param FRcolor 前景色
 * @param BKcolor 背景色
 * @param ... 格式化字符串
 */


#define printk(...) printk_color( WHITE, BLACK, __VA_ARGS__ )

int printk_color(unsigned int FRcolor, unsigned int BKcolor, const char*fmt, ...);