Author
|
Matrix Ltd
|
Version
|
1.8
|
Category
|
Graphical Monochrome
|
GLCD (SSD1305) component
Graphical display component based on the SSD1305 monochrome graphical controller IC.
Component Source Code
Please click here for the component source code: FC_Comp_Source_GLCD_SSD1305.fcfx
Detailed description
No detailed description exists yet for this component
Examples
No additional examples
Downloadable macro reference
|
ReadFontWidth
|
Reads the number of pixel columns used in the selected font
|
- BYTE
|
Font
|
Font selection range: 0 to (NumFonts - 1)
|
- BYTE
|
Character
|
ASCII character to get the pixel width e.g. 'A' or 65
|
- BYTE
|
Return
|
|
SetFontScaler
|
Allows the fonts to be scaled up by multiplying the number of pixels on the X and Y.
|
- BYTE
|
ScaleX
|
Sets the horizontal scale of the font, default 1
|
- BYTE
|
ScaleY
|
Sets the vertical scale of the font, default 1
|
- VOID
|
Return
|
|
PrintNumber
|
This macro prints a decimal number to the Graphical LCD.
|
- INT
|
Number
|
Byte or Integer number to send to the display.
|
- UINT
|
X
|
X pixel coordinate to set the output string position.
|
- UINT
|
Y
|
Y pixel coordinate to set the output string position.
|
- BYTE
|
Font
|
Range: 0 to 31 - 0=5x8, 1=10x8, 2=10x16, 3=5x16, 4-31=Extended Sizes
|
- BYTE
|
Transparent
|
Specifies if the background of the text is drawn - 0 = Background colour is drawn, 1 = Background colour not drawn.
|
- VOID
|
Return
|
|
DrawLine
|
Draws a line with the current foreground colour from pixel location X1, Y1 to pixel location X2, Y2.
|
- UINT
|
X1
|
|
- UINT
|
Y1
|
|
- UINT
|
X2
|
|
- UINT
|
Y2
|
|
- VOID
|
Return
|
|
DrawEllipse
|
Draws an ellipse object on the display with the center of the ellipse at the location X,Y
|
- UINT
|
X
|
X Coordinate for the center of the circle
|
- UINT
|
Y
|
Y coordinate for the center of the circle
|
- UINT
|
XRadius
|
Radius of the circle on the X axis specified in pixels
|
- UINT
|
YRadius
|
Radius of the circle on the Y axis specified in pixels
|
- BYTE
|
Transparent
|
0=Fill inside circle using background colour / 1=Draw outer circle only
|
- BYTE
|
Solid
|
0=Use Transparent Setting / 1=Fill with foreground colour
|
- VOID
|
Return
|
|
Plot
|
Sets a pixel with the current foreground colour at pixel location X, Y.
|
- UINT
|
X1
|
|
- UINT
|
Y1
|
|
- VOID
|
Return
|
|
SetDisplayOrientation
|
Controls the way data is printed out on the display allowing multiple different viewing orientations. Default is 0.
|
- BYTE
|
Orientation
|
0=Default, 1=90°CW, 2=180°CW, 3=270°CW
|
- VOID
|
Return
|
|
BPlot
|
Sets a pixel with the current background colour at pixel location X, Y.
|
- UINT
|
X1
|
|
- UINT
|
Y1
|
|
- VOID
|
Return
|
|
ReadFontStat
|
Gets a stat from the selected embedded ASCII font data.
|
- BYTE
|
Font
|
Font selection range: 0 to (NumFonts - 1)
|
- BYTE
|
Index
|
0=SpaceWidth, 1=PixelHeight
|
- BYTE
|
Return
|
|
Print
|
This macro prints a string of characters to the Graphical LCD.
|
- STRING
|
Str
|
String of characters to send to the display.
|
- UINT
|
X1
|
X pixel coordinate to set the output string position.
|
- UINT
|
Y1
|
Y pixel coordinate to set the output string position.
|
- BYTE
|
Font
|
Selects which Font to use Range: 0 to Font Count
|
- BYTE
|
Transparent
|
Specifies if the background of the text is drawn - 0 = Background colour is drawn, 1 = Background colour not drawn.
|
- VOID
|
Return
|
|
ClearDisplay
|
This macro clears the display of any previous output by overwriting the entire display with the background colour.
|
- VOID
|
Return
|
|
SetBackgroundColour
|
Specifies the colour of the background by creating a mixture of red, green and blue.
|
- BYTE
|
PixelColour
|
0=White, 1=Black
|
- VOID
|
Return
|
|
DrawCircle
|
Draws a circle object on the display with the center of the circle at the location X,Y
|
- UINT
|
X
|
X Coordinate for the center of the circle
|
- UINT
|
Y
|
Y coordinate for the center of the circle
|
- UINT
|
Radius
|
Radius of the circle specified in pixels
|
- BYTE
|
Transparent
|
0=Fill inside circle using background colour / 1=Draw outer circle only
|
- BYTE
|
Solid
|
0=Use Transparent Setting / 1=Fill with foreground colour
|
- VOID
|
Return
|
|
SetForegroundColour
|
Specifies the colour of the foreground by creating a mixture of red, green and blue.
|
- BYTE
|
PixelColour
|
0=White, 1=Black
|
- VOID
|
Return
|
|
DrawRectangle
|
Draws a rectangle with the current foreground colour from pixel loaction X1, Y1 to pixel location X2, Y2
|
- UINT
|
X1
|
|
- UINT
|
Y1
|
|
- UINT
|
X2
|
|
- UINT
|
Y2
|
|
- BYTE
|
Transparent
|
Chooses the transparency of the box - 0 = Box contains background colour, 1 = Box contains previous pixel data.
|
- BYTE
|
Solid
|
Chooses to fill the box with colour - 0 = Box contains transparency data, 1 = Box contains foreground colour.
|
- VOID
|
Return
|
|
Initialise
|
The Init macro must be called once to initialise the Graphical LCD display before any other Graphical LCD component macros are called.
|
- VOID
|
Return
|
Property reference
|
Properties
|
|
Dimensions
|
|
Pixel Width
|
Width of gLCD canvas measured in pixels.
|
|
Pixel Height
|
Heigt of gLCD canvas measured in pixels.
|
|
H Offset
|
Offset from the edge of the display, default 0.
|
|
Colour
|
|
Monochrome
|
Specifies if the display is capable of colour or monochrome only.
|
|
Foreground Color
|
Specifies the initial foreground color.
|
|
Background Color
|
Specifies the initial background color.
|
|
Bit Depth
|
|
Colour Bit Depth
|
Total color bit depth for the display.
|
|
Red Bit Depth
|
Specifies the red bit depth for the display.
|
|
Green Bit Depth
|
Specifies the green bit depth for the display.
|
|
Blue Bit Depth
|
Specifies the blue bit depth for the display.
|
|
Connections
|
|
Chip Select (CS)
|
Chip select pin connection
|
|
Read / Write (R/W)
|
|
|
Reg Select (RS)
|
|
|
Data (SD)
|
LED backlight strobe pin connection
|
|
Serial Clock (SCK)
|
Reset pin connection
|
|
Reset (RST)
|
Instruction / Command pin connection
|
|
Fonts
|
|
Font Count
|
Specifies the number of fonts available to use on the display.
|
|
Font 0
|
|
Font
|
Font picker to decide which font to use on your display.
|
|
Character Spacing
|
Sets the number of blank pixels between each character when printing text. Default 1.
|
|
Space Width
|
Sets the number of horizontal pixels used to represent a space character.
|
|
Simulation
|
|
Component Label
|
|
|
User Label Text
|
Text to display
|
|
Component Label Scale
|
The label scale can be change if the amout of text is too wide for the display
|
|
Physical Orientation
|
Rotates the simulated canvas to match the orientation of real world hardware.
|