Bitmaps and Displays¶
Under extra/common/bitmap.fs there is optional code for supporting bitmap operations. Under extra/common/ssd1306.fs there is optional code for supporting I2C SSD1306-based displays, and similarly under extra/common/ch1116.fs there is optional code for supporting I2C CH1116-based displays. The <bitmap> class is defined under the bitmap module in extra/common/bitmap.fs. The <ssd1306> class inherits from the <bitmap> class and is defined under the ssd1306 module in extra/common/ssd1306.fs, and similarly the <ch1116> class inherits from the <bitmap> class and is defined under the ch1116 module in extra/common/ch1116.fs.
Under extra/common/pixmap16.fs there is optional code for supporting 5-bit red, 6-bit green, 5-bit blue 16-bit pixmap operations, and under extra/common/st7735s.fs there is optional code for supporting SPI ST7735S-based displays with 16-bit color. The <pixmap16> class is defined under the pixmap16 module in extra/common/pixmap16.fs. The <st7735s> class inherits from the <pixmap16> class and is defined under the st7735s module in extra/common/st7735s.fs.
Under extra/common/pixmap8.fs there is optional code for supporting 3-bit red, 3-bit green, 2-bit blue 8-bit pixmap operations. Under extra/common/st7735s_8.fs there is optional code for supporting SPI ST7735S-based displays using 8-bit backing buffers. Under extra/rp_common/st7789v_parallel_8.fs there is optional code for supporting parallel ST7789V-based displays using 8-bit backing buffers. Under extra/common/st7789v_spi_8.fs there is optional code for supporting SPI ST7789V-based displays using 8-bit backing buffers. Note that all of these convert the image data to 16-bit color internally on an as-needed basis. The <pixmap8> class is defined under the pixmap8 module in extra/common/pixmap8.fs. The <st7735s-8> class is defined under the st7735s-8 module in extra/common/st7735s_8.fs. The <st7789v-8> class is defined under the st7789v-8 module in extra/common/st7789v_parallel_8.fs. The <st7789v-8-spi> class is defined under the st7789v-8-spi module in extra/common/st7789v_spi_8.fs. All of these classes inherit from the <pixmap8> class.
The <bitmap> class is a general class for bitmaps and supports both drawing (including setting, or-ing, and-ing, bit-clearing, and exclusive or-ing) individual pixels and rectangles to bitmaps and drawing (including setting, or-ing, and-ing, bit-clearing, and exclusive or-ing) image data from one bitmap onto another bitmap. For bitmaps with dirty state information, i.e. <ssd1306> and <ch1116> objects, drawing operations on bitmaps automatically update their dirty state. Note that the user must provide their own backing bitmap buffer for bitmap objects, whose size must be the number of columns in the bitmap times the number of rows divided by eight (as eight bits are in a byte) rounded up to the next full byte.
The <pixmap16> class is a general class for 5-bit red, 6-bit green, 5-bit blue 16-bit pixmaps and supports both drawing individual pixels and rectangles to pixmaps and drawing image data from one pixmap onto another pixmap; these operations also support using bitmaps as masks. For pixmaps with dirty state information, i.e.
The <pixmap8> class is a general class for 3-bit red, 3-bit green, 2-bit blue 8-bit pixmaps and supports both drawing individual pixels and rectangles to pixmaps and drawing image data from one pixmap onto another pixmap; these operations also support using bitmaps as masks. For pixmaps with dirty state information, i.e.
The <ssd1306> class implements an SSD1306 device interface and the <ch1116> class implements a CH1116 device interface; they support all the drawing operations implemented by the <bitmap> superclass along with maintaining dirty rectangles for optimizing updates. Drawing operations upon <ssd1306> and <ch1116> objects do not immediately update the display; rather the display must be manually updated after drawing to its backing bitmap. This allows the user to carry out multiple drawing operations in sequence before updating the display at once.
The <st7735s> class implements a 16-bit ST7735S device interface and supports all the drawing operations implemented by the <pixmap16> superclass along with maintaining dirty rectangles for optimizing updates. Drawing operations upon <st7735s> objects do not immediately update the display; rather the display must be manually updated after drawing to its backing pixmap. This allows the user to carry out multiple drawing operations in sequence before updating the display at once.
The <st7735s-8> class implements a 16-bit ST7735S device interface with a 3-bit red, 3-bit green, 2-bit blue 8-bit backing buffer and supports all the drawing operations implemented by the <pixmap8> superclass along with maintaining dirty rectangles for optimizing updates. Drawing operations upon <st7735s-8> objects do not immediately update the display; rather the display must be manually updated after drawing to its backing pixmap. This allows the user to carry out multiple drawing operations in sequence before updating the display at once.
The <st7735s-1> class implements a 16-bit ST7735S device interface with fixed 16-bit foreground and background colors with a bitmap backing buffer and supports all the drawing operations implemented by the <bitmap> superclass along with maintaining dirty rectangles for optimizing updates. Drawing operations upon <st7735s-1> objects do not immediately update the display; rather the display must be manually after drawing to its backing bitmap. This allows the user to carry out multiple drawing operations in sequence before updating the display at once.
The <st7789v-8> and <st7789v-8-spi> classes implement 16-bit ST7789V device interfaces, parallel and SPI respectively, with 3-bit red, 3-bit green, 2-bit blue 8-bit backing buffers and support all the drawing operations implemented by the <pixmap8> superclass along with maintaining dirty rectangles for optimizing updates. Drawing operations upon <st7735s-8> and <st7789-v-spi> objects do not immediately update the display; rather the display must be manually updated after drawing to its backing pixmap. This allows the user to carry out multiple drawing operations in sequence before updating the display at once.
bitmap¶
The bitmap module contains the following words:
op-set¶
( – operation )
The set bits operation.
op-or¶
( – operation )
The or bits operation.
op-and¶
( – operation )
The and bits operation.
op-bic¶
( – operation )
The clear bits (i.e not-and) operation.
op-xor¶
( – operation )
The exclusive-or bits operation.
x-invalid-op¶
( – )
This exception is raised if an invalid drawing operation is specified.
bitmap-buf-size¶
( columns rows – bytes )
Get the size of a bitmap buffer in bytes for a given number of columsn and rows.
<bitmap>¶
( – class )
The <bitmap> class is the base class for bitmaps. It can be used directly, e.g. for offscreen bitmaps, or through its subclasses <ssd1306> and <ch1116>.
The <bitmap> class includes the following constructor:
new¶
( buffer-addr columns rows bitmap – )
This constructor initializes a <bitmap> instance to have columns columns, rows rows, and a bitmap buffer at address buffer-addr. Note that the buffer pointed to by buffer-addr must be of size columns times rows divided by eight rounded up to the next integer. When this is called, the buffer will be zeroed and the entire bitmap will be marked as dirty.
The <bitmap> class includes the following members:
bitmap-cols¶
( bitmap – addr )
The address of a cell containing the number of columns in a bitmap.
bitmap-rows¶
( bitmap – addr )
The address of a cell containing the number of rows in a bitmap.
The <bitmap> class includes the following methods:
dim@¶
( bitmap – columns rows )
Get the number of columns and rows in a bitmap.
clear-bitmap¶
( bitmap – )
Set an entire bitmap to zero and mark it as dirty.
dirty?¶
( bitmap – dirty? )
Get whether a bitmap is dirty. Note that if a bitmap does not have support for dirty state tracking this will always return true.
pixel@¶
( column row bitmap – state )
Get whether a pixel at column and row in bitmap is on or off, returning true or false respectively. If the pixel is outside the bounds of bitmap, false is returned.
draw-pixel-const¶
( constant dst-column dst-row op dst-bitmap – )
Apply an operation op to a pixel at dst-column and dst-row of dst-bitmap with a constant value consisting of the bit dst-row modulo eight of constant and mark that pixel as dirty.
draw-rect-const¶
( constant dst-column dst-row column-count row-count op dst-bitmap – )
Apply an operation op to a rectangle at dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-bitmap with a constant value consisting of the bit row modulo eight of constant and mark that rectangle as dirty.
draw-rect¶
( src-column src-row dst-column dst-row column-count row-count op src-bitmap dst-bitmap – )
Apply an operation op to a rectangle in dst-bitmap at dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-bitmap with the contents of a rectangle in src-bitmap at src-column to src-column plus column-count minus one and src-row to src-row plus row-count minus one.
pixmap16¶
Thie pixmap16 module contains the following words:
rgb16¶
( r g b – color )
Constructs a 16-bit color from three 8-bit components.
pixmap16-buf-size¶
( cols rows – bytes )
Get the size of a pixmap buffer in bytes for a given number of columns and rows.
The <pixmap16> class is the base class for 16-bit pixmaps. It can be used directly, e.g. for offscreen pixmaps, or through its subclass <st7735s>
The <pixmap16> class includes the following constructor:
new¶
( buffer-addr columns rows pixmap – )
This constructor initializes a <pixmap16> instance to have columns columns, rows rows, and a pixmap buffer at address buffer-addr. Note that the buffer pointed to by buffer-addr must be of size columns times rows times two. When this is called, the buffer will be zeroed out and the entire pixmap will be marked as dirty.
The <pixmap16> class includes the following members:
pixmap-cols¶
( pixmap – addr )
The address of a cell containing the number of columns in a pixmap.
pixmap-rows¶
( pixmap – addr )
The address of a cell containing the number of rows in a pixmap.
The <pixmap16> class includes the following methods:
dim@¶
( pixmap – columns rows )
Get the number of columns and rows in a pixmap.
clear-pixmap¶
( pixmap – )
Set an entire pixmap to zero and mark it as dirty.
pixel-addr¶
( column row pixmap – addr )
Get the address of a pixel in a pixmap’s buffer.
dirty-pixel¶
( column row pixmap – )
Dirty a pixel in a pixmap; note that this is a no-op in <pixmap16>, but may be overridden in subclasses such as <st7735s>.
dirty-area¶
( start-column end-column start-row end-row pixmap – )
Dirty a rectangle in a pixmap; note that this is a no-op in <pixmap16>, but may be overridden in subclasses such as <st7735s>.
pixel@¶
( column row pixmap – color )
Get the color of a pixel at column and row in pixmap. If the pixel is outside the bounds of pixmap, 0 is returned.
draw-pixel-const¶
( color dst-column dst-row dst-pixmap – )
Draw a single pixel of color *color at dst-column and dst-row on dst-pixmap and mark that pixel as dirty.
draw-rect-const¶
( color dst-column dst-row column-count row-count dst-pixmap – )
Draw a rectangle of color color at dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect¶
( src-column src-row dst-column dst-row column-count row-count src-pixmap dst-pixmap – )
Copy a rectangle of src-column to src-column plus column-count minus one and src-row to src-row plus row-count minus one of src-pixmap to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect-const-mask¶
( color mask-column mask-row dst-column dst-row column-count row-count mask-bitmap dst-pixmap – )
Draw a rectangle of color where mask-column to mask-column plus column-count minus one and mask-row to mask-row plus row-count minus one of mask-bitmap is set to one to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect-mask¶
( mask-column mask-row src-column src-row dst-column dst-row column-count row-count mask-bitmap src-pixmap dst-pixmap – )
Copy a rectangle of src-column to src-column plus column-count minus one and src-row to src-row plus row-count minus one where mask-column to mask-column plus column-count minus one and mask-row to mask-row plus row-count minus one of mask-bitmap is set to one to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
pixmap8¶
Thie pixmap8 module contains the following words:
rgb8¶
( r g b – color )
Constructs a 8-bit color from three 8-bit components.
pixmap8-buf-size¶
( cols rows – bytes )
Get the size of a pixmap buffer in bytes for a given number of columns and rows.
The <pixmap8> class is the base class for 8-bit pixmaps. It can be used directly, e.g. for offscreen pixmaps, or through its subclass <st7735s-8>
The <pixmap8> class includes the following constructor:
new¶
( buffer-addr columns rows pixmap – )
This constructor initializes a <pixmap8> instance to have columns columns, rows rows, and a pixmap buffer at address buffer-addr. Note that the buffer pointed to by buffer-addr must be of size columns times rows. When this is called, the buffer will be zeroed out and the entire pixmap will be marked as dirty.
The <pixmap8> class includes the following members:
pixmap-cols¶
( pixmap – addr )
The address of a cell containing the number of columns in a pixmap.
pixmap-rows¶
( pixmap – addr )
The address of a cell containing the number of rows in a pixmap.
The <pixmap8> class includes the following methods:
dim@¶
( pixmap – columns rows )
Get the number of columns and rows in a pixmap.
clear-pixmap¶
( pixmap – )
Set an entire pixmap to zero and mark it as dirty.
pixel-addr¶
( column row pixmap – addr )
Get the address of a pixel in a pixmap’s buffer.
dirty-pixel¶
( column row pixmap – )
Dirty a pixel in a pixmap; note that this is a no-op in <pixmap8>, but may be overridden in subclasses such as <st7735s-8>.
dirty-area¶
( start-column end-column start-row end-row pixmap – )
Dirty a rectangle in a pixmap; note that this is a no-op in <pixmap8>, but may be overridden in subclasses such as <st7735s-8>.
pixel@¶
( column row pixmap – color )
Get the color of a pixel at column and row in pixmap. If the pixel is outside the bounds of pixmap, 0 is returned.
draw-pixel-const¶
( color dst-column dst-row dst-pixmap – )
Draw a single pixel of color *color at dst-column and dst-row on dst-pixmap and mark that pixel as dirty.
draw-rect-const¶
( color dst-column dst-row column-count row-count dst-pixmap – )
Draw a rectangle of color color at dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect¶
( src-column src-row dst-column dst-row column-count row-count src-pixmap dst-pixmap – )
Copy a rectangle of src-column to src-column plus column-count minus one and src-row to src-row plus row-count minus one of src-pixmap to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect-const-mask¶
( color mask-column mask-row dst-column dst-row column-count row-count mask-bitmap dst-pixmap – )
Draw a rectangle of color where mask-column to mask-column plus column-count minus one and mask-row to mask-row plus row-count minus one of mask-bitmap is set to one to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
draw-rect-mask¶
( mask-column mask-row src-column src-row dst-column dst-row column-count row-count mask-bitmap src-pixmap dst-pixmap – )
Copy a rectangle of src-column to src-column plus column-count minus one and src-row to src-row plus row-count minus one where mask-column to mask-column plus column-count minus one and mask-row to mask-row plus row-count minus one of mask-bitmap is set to one to dst-column to dst-column plus column-count minus one and dst-row to dst-row plus row-count minus one of dst-pixmap and mark that rectangle as dirty.
ssd1306¶
The ssd1306 module contains the following words:
SSD1306_I2C_ADDR¶
( – i2c-addr )
The default I2C address for SSD1306-based displays, $3C.
<ssd1306>¶
( – class )
The <ssd1306> class is the class for I2C SSD1306-based displays. It inherits from the <bitmap> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <ssd1306> class includes the following constructor:
new¶
( pin0 pin1 buffer-addr columns rows i2c-addr i2c-device ssd1306 – )
This constructor initializes an I2C SSD1306 display with the SDA and SCK pins specified as GPIO pins pin0 and pin1 (it does not matter which is which), a backing buffer at buffer-addr (with the same considerations as backing buffers for other <bitmap> instances), columns columns, rows rows, the I2C address i2c-addr, the I2C device index i2c-device (note that this must match the I2C device index for pins pin0 and pin1), and the <ssd1306> instance being initialized, ssd1306.
The <ssd1306> class includes the following methoda:
update-display¶
( ssd1306 – )
This updates the SSD1306-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
display-contrast!¶
( constrast ssd1306 – )
This sets the contrast of an SSD1306-based display to a value from 0 to 255.
ch1116¶
The ch1116 module contains the following words:
CH1116_I2C_ADDR¶
( – i2c-addr )
The default I2C address for CH1116-based displays, $3C.
<ch1116>¶
( – class )
The <ch1116> class is the class for I2C CH1116-based displays. It inherits from the <bitmap> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <ch1116> class includes the following constructor:
new¶
( pin0 pin1 buffer-addr columns rows i2c-addr i2c-device ch1116 – )
This constructor initializes an I2C CH1116 display with the SDA and SCK pins specified as GPIO pins pin0 and pin1 (it does not matter which is which), a backing buffer at buffer-addr (with the same considerations as backing buffers for other <bitmap> instances), columns columns, rows rows, the I2C address i2c-addr, the I2C device index i2c-device (note that this must match the I2C device index for pins pin0 and pin1), and the <ch1116> instance being initialized, ch1116.
The <ch1116> class includes the following methoda:
update-display¶
( ch1116 – )
This updates the CH1116-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
display-contrast!¶
( constrast ch1116 – )
This sets the contrast of an CH1116-based display to a value from 0 to 255.
st7735s¶
The st7735s module contains the following words:
<st7735s>¶
( – class )
The <st7735s> class is the class for 5-bit red, 6-bit green, 5-bit blue 16-bit SPI ST7735S-based displays. It inherits from the <pixmap16> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <st7735s> class includes the following constructor:
new¶
( din-pin clk-pin dc-pin cs-pin backlight-pin reset-pin buffer-addr columns rows spi-device st7735s – )
This constructor initializes an SPI ST7735S display at the SPI device spi-device, a backing buffer at buffer-addr (with the same considerations as backing buffers for other <pixmap16> instances), columns columns, rows rows, the DIN pin din-pin, the CLK pin clk-pin, the DC pin dc-pin, the chip-select pin cs-pin, the backlight pin backlight-pin, the reset pin reset-pin, and the <st7735s> instance being initialized, st7735s. Note that din-pin and clk-pin must match the SPI device spi-device specified.
The <st7735s> class includes the following method:
update-display¶
( st7735s – )
This updates the ST7735S-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
backlight!¶
( backlight st7735s – )
Set the on/off state of the ST7735S-based display’s backlight.
st7735s-8¶
The st7735s-8 module contains the following words:
<st7735s-8>¶
( – class )
The <st7735s-8> class is the class for 16-bit SPI ST7735S-based displays with 3-bit red, 3-bit green, 2-bit blue 8-bit backing buffers. It inherits from the <pixmap8> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <st7735s-8> class includes the following constructor:
new¶
( din-pin clk-pin dc-pin cs-pin backlight-pin reset-pin buffer-addr columns rows spi-device st7735s – )
This constructor initializes an SPI ST7735S display at the SPI device spi-device, a backing buffer at buffer-addr (with the same considerations as backing buffers for other <pixmap16> instances), columns columns, rows rows, the DIN pin din-pin, the CLK pin clk-pin, the DC pin dc-pin, the chip-select pin cs-pin, the backlight pin backlight-pin, the reset pin reset-pin, and the <st7735s-8> instance being initialized, st7735s. Note that din-pin and clk-pin must match the SPI device spi-device specified.
The <st7735s-8> class includes the following method:
update-display¶
( st7735s – )
This updates the ST7735S-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
backlight!¶
( backlight st7735s – )
Set the on/off state of the ST7735S-based display’s backlight.
st7735s-1¶
The st7735s-1 module contains the following words:
rgb16¶
( r g b – color )
Create a 16-bit color with 5 bits for red, 6 bits for green, and 5 bits for blue from a red/green/blue triplet of values from 0 to 255 each.
<st7735s-1>¶
( – class )
The <st7735s-1> class is the class for 16-bit SPI ST7735S-based displays with 5-bit red, 6-bit green, 5-bit blue foreground and background colors and bitmap backing buffers. It inherits from the <bitmap> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <st7735s-1> class includes the following constructor:
new¶
( fg-color bg-color din-pin clk-pin dc-pin cs-pin backlight-pin reset-pin buffer-addr columns rows spi-device st7735s – )
This constructor initializes an SPI ST7735S display at the SPI device spi-device, a backing buffer at buffer-addr (with the same considerations as backing buffers for other <bitmap> instances), columns columns, rows rows, the DIN pin din-pin, the CLK pin clk-pin, the DC pin dc-pin, the chip-select pin cs-pin, the backlight pin backlight-pin, the reset pin reset-pin, a 16-bit foreground color fg-color, a 16-bit background color bg-color, and the <st7735s> instance being initialized, st7735s. Note that din-pin and clk-pin must match the SPI device spi-device specified.
The <st7735s> class includes the following method:
update-display¶
( st7735s – )
This updates the ST7735S-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
backlight!¶
( backlight st7735s – )
Set the on/off state of the ST7735S-based display’s backlight.
fg-color!¶
( fg-color st7735s – )
Set the foreground color of the ST7735S-based display and dirty the display.
bg-color!¶
( bg-color st7735s – )
Set the background color of the ST7735S-based display and dirty the display.
fg-color@¶
( st7735s – fg-color )
Get the foreground color of the ST7735S-based display.
bg-color@¶
( st7735s – bg-color )
Get the background color of the ST7735S-based display.
st7789v-8¶
The st7789v-8 module contains the following words:
<st7789v-8>¶
( – class )
The <st7789v-8> class is the class for 16-bit parallel ST7789V-based displays with 3-bit red, 3-bit green, 2-bit blue 8-bit backing buffers. It inherits from the <pixmap8> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <st7789v-8> class includes the following constructor:
new¶
( din-base-pin write-clk-pin read-clk-pin dc-pin cs-pin backlight-pin buffer-addr round? columns rows state-machine pio-device st7789v – )
This constructor initializes a parallel ST7789V display at the PIO device pio-device, the PIO state machine state-machine, a backing buffer at buffer-addr (with the same considerations as backing buffers for other <pixmap16> instances), columns columns, rows rows, whether the display is round?, the base DIN pin din-base-pin (note that there are 8 DIN pins with parallel ST7789V displays), the write CLK pin write-clk-pin, the read CLK in read-clk-pin, the DC pin dc-pin, the chip-select pin cs-pin, the backlight pin backlight-pin, and the <st7789v-8> instance being initialized, st7789v.
The <st7789v-8> class includes the following method:
update-display¶
( st7789v – )
This updates the ST7789V-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
backlight!¶
( backlight st7789v – )
Set the on/off state of the ST7789V-based display’s backlight.
st7789v-8-spi¶
The st7789v-8-spi module contains the following words:
<st7789v-8-spi>¶
( – class )
The <st7789v-8-spi> class is the class for 16-bit SPI ST7789V-based displays with 3-bit red, 3-bit green, 2-bit blue 8-bit backing buffers. It inherits from the <pixmap8> class and can be drawn to using the operations defined in that class. It maintains a dirty rectangle, which is updated when the user invokes its update-display method. Note that column zero is on the lefthand side of the display and row zero is on the top of the display.
The <st7789v-8-spi> class includes the following constructor:
new¶
( din-pin clk-pin dc-pin cs-pin backlight-pin reset-pin buffer-addr round? columns rows spi-device st7789v – )
This constructor initializes an SPI ST7789V display at the SPI device spi-device, a backing buffer at buffer-addr (with the same considerations as backing buffers for other <pixmap16> instances), columns columns, rows rows, whether the display is round?, the DIN pin din-pin, the CLK pin clk-pin, the DC pin dc-pin, the chip-select pin cs-pin, the backlight pin backlight-pin, the reset pin reset-pin, and the <st7789v-8-spi> instance being initialized, st7789v. Note that din-pin and clk-pin must match the SPI device spi-device specified.
The <st7789v-8-spi> class includes the following method:
update-display¶
( st7789v – )
This updates the ST7789V-based display with the current contents of its dirty rectangle, and then clears its dirty state. This must be called to update the display’s contents after drawing to the display, which otherwise has no effect on the display itself.
backlight!¶
( backlight st7789v – )
Set the on/off state of the ST7789V-based display’s backlight.