Example 3 - Bitmaps

An example that shows drawing bitmaps using the SparkFun Qwiic OLED Library.

Key Demo Features

• Understanding bitmap structure
• Bitmap objects
• Drawing Bitmap

Setup

After installing this library in your local Arduino environment, begin with a standard Arduino sketch, and include the header file for this library.

// Include the SparkFun qwiic OLED Library
#include <SparkFun_Qwiic_OLED.h>

The next step is to declare the object for the SparkFun qwiic OLED device used. Like most Arduino sketches, this is done at a global scope (after the include file declaration), not within the setup() or loop() functions.

The user selects from one of the following classes:

Class	Qwiic OLED Device
QwiicMicroOLED	SparkFun Qwiic Micro OLED
QwiicNarrowOLED	SparkFun Qwiic OLED Display (128x32)
QwiicTransparentOLED	SparkFun Transparent Graphical OLED
Qwiic1in3OLED	SparkFun Qwiic OLED 1.3" Display (128x32)

The Example code supports all of the SparkFun Qwiic OLED boards. To select the board being used, uncomment the #define for the demo board.

For this example, the Qwiic Micro OLED is used.

#define MICRO
//#define NARROW
//#define TRANSPARENT

Which results in myOLED being declared as:

QwiicMicroOLED myOLED;

Initialization

In the setup() function of this sketch, like all of the SparkFun qwiic libraries, the device is initialized by calling the begin() method. This method returns a value of true on success, or false on failure.

void setup()
{

    delay(500);   //Give display time to power on

    // Serial on!
    Serial.begin(115200);

    Serial.println("\n\r-----------------------------------");

    Serial.print("Running Example 01 on: ");
    Serial.println(String(deviceName));

    // Initalize the OLED device and related graphics system
    if(!myOLED.begin()){

        Serial.println(" - Device Begin Failed");
        while(1);
    }

    Serial.println("- Begin Success");

Drawing Bitmaps