Bitmap2LCD : Vector Design Module ( General Information )

Bitmap2LCD is a tool for programming small Graphic LCDs in embedded systems and a programmable graphic and text processing tool.

Bitmap2LCD : Vector Design Module ( General Information )

Update V3.7c


From Version V3.1  Bitmap2LCD is capable to run / generate code which is compatible with external vector Libraries such as GLCD.C , for example one of the many GLCD library you can download for free or buy on the Internet.

Drawing for example a Line , a circle, an ellipse or a Rectangle on your Graphic LCD becomes very easy : You just have to draw these vectors inside the Work Canvas of Bitmap2LCD (red arrow), and the tool generates the code with its coordinates. Another option is to program vectors inside the script editor and run the script in the same way as with a Graphic LCD Simulator.

This code can be exported to the Text Editor for an external use or can be moved to the Vector Script (blue arrow).

  • Draw Vectors Elements inside the Work canvas     >>  Export Code inside Text editor
  • Draw Vector Elements inside the Work canvas      >>  Export Code to the Current Vectors Script

Program Vector Elements inside the Script editor >> Run Script which is Drawing Vector elements inside the Work Canvas



There’s is a list of Vector design Elements (green arrow) you can select and then edit each of its parameters.

The vectors Elements are functions to draw a bitmap, to move the cursor, to write a number, a char or a text, to select a font with its size and style, to draw a dot , a line a rectangle or a circle etc…

The syntax of these Vector Elements can be changed in the Settings Panel to match your particular GLCD library. It’s easy then to copy the script as it is already and paste it inside your embedded app source editor.

Buttons :

vecto2  Entering Vector Design Mode

exiz  Exit special mode , quit the Vector Design Mode

Startvect  Export the vectors drawn inside the Work Canvas to Vector Code inside the Text Editor

Addvect  Add the Vectors inside the work Canvas inside the Vectors Design Script ( from cursor)

RunvectStep  Toggles Script Run Mode / Script Step by Step Run Mode

Runvect  Run Vectors Script / or one Step

reloadlastvector  Reload Last Vector Script (‘.B2L‘ file)

toolVect  Vector Data Settings

The Vector Data Settings Panel :

Bitmap2lcd_vector_design_Settings 1


In the Vector Data Settings Panel, you can set the following parameters : The Syntax of the Vector Element function, define if enabled or disabled, define if X and Y coordinates only or with length and width, where applicable, with or without fill parameter. The defined syntax will also appear as defined here in the list of Vector Elements above the Script (green arrow above fig.)

With  vecto2  you can enable the Vector Design Mode.

In the Vector Design mode, the frame around the Work Canvas becomes purple (blue arrow).

In this Example, a rectangle and a circle vectors have been drawn.



Then you can export the Vectors to Data Startvect  (purple arrow) inside the text editor / or to the script Addvect . The functions with their coordinates and parameters, and the colors are exported to the text editor of Bitmap2LCD as shown below.


Saving and loading Bitmap2LCD Vector Design files (Files with .B2L extension)

The Vector Elements inside the Work Canvas are saved to a .B2L file. These Vector Elements can be reloaded and edited later, if needed.

B2L Vector Files are saved inside the user defined Graphics Library Folder

See below how to activate the filter to view only the Vector Files inside the File Explorer.

bitmap2lcd B2L filter


In the Vector Design Mode , you can see the parameters of every vector Element inside the ‘Script + Objects‘ tab located in the Text Editor Main Tab (blue arrow).

You can select them (red arrow) and the selected vector becomes orange inside the Work Canvas.

Orange arrow points the Select Vector Element button, the yellow arrow points to the two last lines of the script. These are the rectangle and the circle drawn in the Work Canvas and exported to the script with Addvect .



Formats of the Vector Elements  ( syntaxes are user definable )

GLCD.Dot or GLCD.SetPixel (X,Y,Color)

GLCD.Rect (X1,Y1,X2,Y2,Color)

GLCD.FillRect (X1,Y1,X2,Y2,Color)

GLCD.RoundRect (X1,Y1,X2,Y2,R,Color)

GLCD.FillRoundRect (X1,Y1,X2,Y2,R,Color)

GLCD.CIrcle (X1,Y1,X2,Y2,Color)

GLCD.FillCircle (X1,Y1,X2,Y2,Color)

GLCD.Line (X1,Y1,X2,Y2,Color)

GLCD.VLine (X,Y,Height,Color)

GLCD.HLine (X,Y,Length,Color)

GLCD.DrawBitmap (Filename.bmp,X,Y)

Filename of bmp file located in the Graphics files folder. > no folder name allowed here !

GLCD.DrawBitmap (Filename*,X,Y,Width,Height)

* filename of converted *.h file located in the output files folder but without extension,

No folder allowed here, data direction and endianness must be set correctly  : this operation uses the data to graphic conversion ! Currently only monochrome data files supported !

GLCD.GotoXY or GLCD.CursorTo (X,Y)

GLCD.Puts (“text”)

” are optional and definable

GLCD.PrintNumber (numeric value)

GLCD.InvertRect (X1,Y1,X2,Y2)

GLCD.Putchar (character)

GLCD.ClearScr ()

Delay (mS)   >> max 5000 mS

GLCD.SelectFont (System Font Name, Font Size, Font Styles (max 4x)*)

*Font styles are : Bold, Italic, StrikedOut, Underlined

Currently only System Fonts supported

Monochrome :

Color = 1 is white

Color= 0  is black

Select and modify Vectors

At the right side of the Script and Objects panel, there’s a vector tree where you can find the list of the vectors having been drawn inside the Work Canvas. By clicking on a vector (blue arrow), the list of its Properties appears in the Properties view. (red arrow).

In the Properties View, you can edit the X and Y coordinates and if available, the corner radius of the selected vector.

The vectors programmed inside the script, do not appear in the vector tree and Properties list.

bitmap2lcd Vector Paramaters






2 thoughts on “Bitmap2LCD : Vector Design Module ( General Information )

  1. deepesh gupta

    how can we convert the color image into graphic vector image and we can display the same color image on graphic lcd module

    1. Bernie Post author

      You can convert a “simple image” previously drawn inside the work canvas using the drawing tools ( line, rectangle, circle etc ) into GLCD vectors but you can’t convert
      a “bitmap” into vectors. ( >> like for example the software Inkscape can vectorize graphics to SVG files [Scalable vector Graphics] >> Warning, this is not applicable to photo )

      But it is possible to convert a “bitmap” to data (hex array) and then call this hex array with GLCD_bitmap(x,y,name) from the vector program, if there is a similar function
      in the GLCD library you are using. Does this answer your question ?


Leave a Reply

Your email address will not be published. Required fields are marked *