Changed setSegment to setSegmentsDigit

Also improved README

Author: DeanIsMe

README.md

@@ -102,6 +102,22 @@ void setup() {
 If you wish to use more than 8 digits, increase MAXNUMDIGITS in SevSeg.h.
 
 
+### Refreshing the display
+
+```c++
+sevseg.refreshDisplay();
+```
+
+Your program must run the refreshDisplay() function repeatedly to display the number. 
+**Warning: Any calls to delay() will interfere with the display.**
+Any delays introduced by other functions will produce undesirable effects on the display. If you need help getting away from delay() statements, I recommend the simple [Blink Without Delay][9] arduino example sketch.
+
+To blank the display, call:
+
+```c++
+sevseg.blank();
+```
+
 ### Setting a number
 #### Integer
 ```c++
@@ -127,23 +143,19 @@ Note that:
 sevseg.setChars("abcd");
 ```
 
-Character arrays can be displayed - as accurately as possible on a seven segment display. See SevSeg.cpp digitCodeMap[] to notes on each character. Only alphanumeric characters, plus ' ', '-' and '.' are supported. The character array should be NULL terminated.
-
-
-### Refreshing the display
+Character arrays can be displayed - as accurately as possible on a seven segment display. See SevSeg.cpp digitCodeMap[] to notes on each character. Only alphanumeric characters, plus ' ', '-', '_', and '.' are supported. The character array should be NULL terminated.
 
+### Custom display setting
 ```c++
-sevseg.refreshDisplay();
+// Set the segments for every digit on the display
+uint8_t segs[4] = {0, 0x5B, 0x6D, 0x63};
+sevseg.setSegments(segs);
 ```
-
-Your program must run the refreshDisplay() function repeatedly to display the number. Note that any delays introduced by other functions will produce undesirable effects on the display.
-
-To blank the display, call:
-
 ```c++
-sevseg.blank();
+// Set the segments for a single digit. Set digit 3 to 0x63. 
+sevseg.setSegmentsDigit(3, 0x63);
 ```
-
+You can manipulate individual segments if needed. Each byte represents the display of a single digit, with each bit representing a single segment. The bits represent segments in the order .GFEDCBA. See SevSeg.cpp for more examples of these 'digitCodes'.
 
 ### Setting the brightness
 
@@ -188,3 +200,4 @@ SOFTWARE.
 [6]: https://wokwi.com/arduino/libraries/SevSeg/SevSeg_Counter
 [7]: https://wokwi.com/arduino/libraries/SevSeg/stringWithPeriod
 [8]: https://wokwi.com/arduino/libraries/SevSeg/testWholeDisplay
+[9]: https://www.arduino.cc/en/Tutorial/BuiltInExamples/BlinkWithoutDelay

SevSeg.cpp

@@ -44,7 +44,7 @@ static const int32_t powersOf16[] = {
 // digitCodeMap indicate which segments must be illuminated to display
 // each number.
 static const uint8_t digitCodeMap[] = {
-  //     GFEDCBA  Segments      7-segment map:
+  // GFEDCBA  Segments      7-segment map:
   0b00111111, // 0   "0"          AAA
   0b00000110, // 1   "1"         F   B
   0b01011011, // 2   "2"         F   B
@@ -433,11 +433,14 @@ void SevSeg::setSegments(const uint8_t segs[]) {
   }
 }
 
-// setSegment
+// setSegmentsDigit
 /******************************************************************************/
-// Like setSegments above, only manipulates one segment  
-void SevSeg::setSegment(const byte segNum, const byte segs) {
-    digitCodes[segNum] = segs;
+// Like setSegments above, but only manipulates the segments for one digit
+// digitNum is 0-indexed.
+void SevSeg::setSegmentsDigit(const uint8_t digitNum, const uint8_t segs) {
+  if (digitNum < numDigits) {
+    digitCodes[digitNum] = segs;
+  }
 }
 
 // getSegments

SevSeg.h

@@ -48,7 +48,7 @@ class SevSeg
 
   void setSegments(const uint8_t segs[]);
   void getSegments(uint8_t segs[]);
-  void setSegment(const byte segNum, const byte segs);
+  void setSegmentsDigit(const uint8_t digitNum, const uint8_t segs);
   void setChars(const char str[]);
   void blank(void);
 

keywords.txt

@@ -5,6 +5,7 @@ refreshDisplay	KEYWORD2
 setBrightness	KEYWORD2
 getSegments	KEYWORD2
 setSegments	KEYWORD2
+setSegmentsDigit	KEYWORD2
 setChars	KEYWORD2
 blank	KEYWORD2
 COMMON_CATHODE	LITERAL1