U8g2库中drawCircle和drawDisk函数在反色绘制时的注意事项

问题现象描述

在使用U8g2图形库进行OLED屏幕开发时，开发者可能会遇到一个特殊现象：当使用drawCircle()和drawDisk()函数配合反色绘制模式（即设置setDrawColor(2)）时，绘制出的圆形和圆盘会出现明显的黑色线条贯穿其中，形成视觉上的"伪影"或"瑕疵"。

问题重现代码

以下代码可以重现这个问题：

#include <U8g2lib.h>
#include <Wire.h>

U8G2_SSD1306_128X64_NONAME_2_HW_I2C display(U8G2_R2, /* reset=*/ U8X8_PIN_NONE);

void setup() {
  display.begin();
  drawOnce();  
}

void drawOnce() {
  display.firstPage();
  do {
    display.setDrawColor(1);
    display.drawBox(8, 8, 102, 102);
    display.setDrawColor(2);
    display.drawCircle(91, 29, 20);
    display.drawDisc(91, 29, 16);
    display.drawCircle(120, 32, 8);
    display.drawDisc(120, 32, 4);
  } while ( display.nextPage() );
}

void loop() {
}

问题原因分析

经过深入分析，这个问题实际上并非真正的bug，而是由于对U8g2库的绘制颜色模式理解不足导致的。U8g2库的setDrawColor()函数实际上只支持两种颜色模式：

1. 0：清除像素（相当于背景色）
2. 1：设置像素（相当于前景色）

当开发者尝试使用setDrawColor(2)时，虽然库不会报错，但这是不被支持的操作模式。U8g2库的官方文档明确指出，drawCircle和drawDisc等绘图函数仅支持颜色值0和1。

正确解决方案

要实现反色效果，正确的做法是：

1. 使用setDrawColor(1)正常绘制圆形和圆盘
2. 然后通过反转背景矩形的方式实现整体反色效果

修改后的代码如下：

void drawOnce() {
  display.firstPage();
  do {
    display.setDrawColor(1);
    display.drawBox(8, 8, 102, 102);
    display.setDrawColor(0);  // 使用0而不是2
    display.drawCircle(91, 29, 20);
    display.drawDisc(91, 29, 16);
    display.drawCircle(120, 32, 8);
    display.drawDisc(120, 32, 4);
  } while ( display.nextPage() );
}

或者更推荐的方式是保持绘制颜色为1，而反转背景：

void drawOnce() {
  display.firstPage();
  do {
    display.setDrawColor(0);  // 先绘制黑色背景
    display.drawBox(8, 8, 102, 102);
    display.setDrawColor(1);  // 然后白色绘制图形
    display.drawCircle(91, 29, 20);
    display.drawDisc(91, 29, 16);
    display.drawCircle(120, 32, 8);
    display.drawDisc(120, 32, 4);
  } while ( display.nextPage() );
}

开发建议

1. 在使用U8g2库时，应当仔细阅读相关函数的文档说明
2. 避免使用未明确支持的参数值，即使库没有报错
3. 对于反色效果，优先考虑通过组合基本绘图操作来实现，而不是依赖未定义的行为
4. 在遇到类似问题时，可以先查阅库的官方文档或示例代码

理解这些绘图函数的工作原理和限制，可以帮助开发者更高效地使用U8g2库，避免出现类似的显示问题。