--- title: OLED Display Functions slug: gpc/gpc-scripting-oled-display-functions description: Here are the OLED Display Functions. icon: ◽ docTags: createdAt: 2021-12-08T18:02:02.000Z --- The functions below allow you to control the output display on the Zen. These are specific only to the Cronus Zen. | Function | Description | | ------------ | ------------------------------------------------------------------- | | pixel\_oled | Draws a pixel on the OLED display. | | line\_oled | Draws a line on the OLED display. | | rect\_oled | Draws a rectangle on the OLED display. | | circle\_oled | Draws a circle on the OLED display. | | putc\_oled | Puts a character into the string buffer for puts\_oled. | | puts\_oled | Draws the characters supplied using putc\_oled on the OLED display. | | cls\_oled | Sets the entire OLED display to a single color. | | print | Draws a string on the OLED display. | # pixel\_oled `pixel_oled` draws a pixel on the OLED display :::CodeblockTabs GPC ```apex pixel_oled(x, y, color); ``` ::: 🔴 **Syntax** pixel\_oled( , , ); ⚪ **Parameters** : The X coordinate of the pixel : The Y coordinate of the pixel : The color flag to set the pixel to 0 means Black and 1 means White 🔵 **Returns** Nothing # line\_oled `line_oled` draws a line of pixels :::CodeblockTabs GPC ```apex line_oled(x, y, tox, toy, thickness, color); ``` ::: 🔴 **Syntax** line\_oled( \ , \ , \ , \ , \ , \ ); ⚪ **Parameters** \ : The starting X coordinate \ : The starting Y coordinate \ : The ending X coordinate \ : The ending Y coordinate \: The thickness of the line \: The color flag to set the pixels to 0 means Black and 1 means White 🔵 **Returns** Nothing # rect\_oled `rect_oled` draws a rectangle on the OLED screen of the Cronus Zen :::CodeblockTabs GPC ```apex rect_oled(x, y, width, height, fill, color); ``` ::: 🔴 **Syntax** ** **rect\_oled( \ , \, \, \, \, \ ); ⚪ **Parameters** \ : The X coordinate of the upper left corner of the rectangle \ : The Y coordinate of the upper left corner of the rectangle \ : The width of the rectangle to draw \ : The height of the rectangle to draw \ : A flag saying if the rectangle should be filled or just outlined (1 means fill it, 0 means only draw the outline) \ : The color flag to set the pixels to 0 means Black and 1 means White 🔵 **Returns** Nothing # circle\_oled `circle_oled` draws a circle on the Cronus Zen OLED screen. :::CodeblockTabs GPC ```apex circle_oled(x, y, radius, fill, color); ``` ::: 🔴 **Syntax** circle\_oled( \ , \, \, \, \ ); ⚪ **Parameters** \ : The X coordinate of the center of the circle? \ : The Y coordinate of the center of the circle? \ : The radius of the circle to draw (the distance from the center point to the outer edge) \ : A flag saying if the rectangle should be filled or just outlined (1 means fill it, 0 means only draw the outline) \ : The color flag to set the pixels to 0 means Black and 1 means White 🔵 **Returns** Nothing # putc\_oled `putc_oled` puts a character into the string buffer for puts\_oled :::CodeblockTabs GPC ```apex putc_oled(position, ascii); ``` ::: 🔴 **Syntax** putc\_oled( \ , \ ); ⚪ **Parameters** \ : The 1 based index where to put the character in the buffer \ : The ASCII code value to put into the buffer, see table of supported characters/constants here 🔵 **Returns** Nothing # puts\_oled `puts_oled` draws the characters supplied using putc\_oled on the OLED display :::CodeblockTabs GPC ```apex puts_oled(x, y, font, length, color); ``` ::: 🔴 **Syntax** ** **puts\_oled( \ , \ , \ , \ , \ ); ⚪ **Parameters** ** **\ : The X coordinate of the upper left corner of where the text will be drawn \ : The Y coordinate of the upper left corner of where the text will be drawn \ : The font constant to use when drawing the text see table of supported fonts \ \ : The color flag to set the pixels to 0 means Black and 1 means White 🔵 **Returns** ** **Nothing # cls\_oled `cls_oled` sets the entire OLED display to a single color :::CodeblockTabs GPC ```apex cls_oled(color); ``` ::: 🔴 **Syntax** cls\_oled( \ ); ⚪ **Parameters** \ : any defined variable. 🔵 **Returns** Nothing # print `print` draws a string on the OLED display :::CodeblockTabs GPC ```apex print(x, y, font, color, stringaddr); ``` ::: 🔴 **Syntax** print( \ , \ , \ , \ , \ ); ⚪ **Parameters** \ : The X coordinate of the upper left corner of where the text will be drawn \ : The Y coordinate of the upper left corner of where the text will be drawn \ : The font constant to use when drawing the text see table of supported fonts here \ : The color flag to set the pixels to 0 means Black and 1 means White \ : The offset in the data section where the 0 terminated string is located, usually used with the string constant type 🔵 **Returns** Nothing