Debug Traces

MicroUI logs several actions when traces are enabled. This chapter explains the traces identifiers.

Trace format

The trace output format is the following:

[TRACE: MicroUI] Event AA(BB[CC],DD[EE])

where:

  • AA is the event identifier. See next table.
  • BB is the first event data.
  • CC is the index of the first event data (0x0).
  • DD is the second event data.
  • EE is the index of the second event data (0x1).
  • etc.

For example, given the following trace output:

[TRACE: MicroUI] Event 0x2(1[0x0],2[0x1],117571586[0x2])

  • 0x2 -> Execute native input event
  • 1 -> Event “Button” (index 0x0)
  • 2 -> Generator Id (index 0x1)
  • 117571586 -> event data (index 0x2)

Trace identifiers

The following tables describe some events data.

MicroUI Traces
Event ID Description End of event
0x0 (0) Execute EventGenerator event %0% (see Event Type). Generator id is %1% and data is %2%. End of %0% (see Event Type).
0x1 (1) Drop event %0%.  
0x2 (2) Execute native input event %0% (see Event Type). Generator id is %1% and data is %2%. End of %0% (see Event Type).
0x3 (3) Execute display event %0% (see Event Type). Event is %1%. End of %0% (see Event Type).
0x4 (4) Execute user event %0%. End of %0%.
0x5 (5) Create new image using %0% algorithm (see Create Image). Image created, image identifier is %0%.
0x6 (6) New image characteristics %0% (see Image Type), identifier is %1% and memory size is %2%.  
0xa (10) Flush back buffer; position (%0%, %1%) size (%2% * %3%).  
0xb (11) Flush done.  
0xc (12) Start internal drawing operation %0% (see Drawing Type). End of drawing %0% (see Drawing Type)
0xd (13) Start drawing operation %0% (see Drawing Type). End of drawing %0% (see Drawing Type)
0xe (14) Unknown event.  
0xf (15) Asynchronous drawing operation done.  
0x14 (20) Invalid input event %0%.  
0x15 (21) Event queue is full, cannot add event %0%.  
0x16 (22) Add event %0% at index %1%; queue length is %2%.  
0x17 (23) Replace event %0% by %1% at index %2%; queue length is %3%.  
0x18 (24) Read event %0% at index %1%.  
Event Type
Event ID Description
0x0 (0) Event “Command”
0x1 (1) Event “Button”
0x2 (2) Event “Pointer”
0x3 (3) Event “State”
0x4 (4) Event “Unknwon”
0x5 (5) Event “Call Serially”
0x6 (6) Event “MicroUI Stop”
0x7 (7) Event “Input”
0x8 (8) Event “Show Displayable”
0x9 (9) Event “Hide Displayable”
0xb (11) Event “Pending Flush”
0xc (12) Event “Force Flush”
0xd (13) Event “Repaint Displayable”
0xe (14) Event “Repaint Current Displayable”
0xf (15) Event “KF Stop Feature”
Create Image
Event ID Description
0x0 (0) Create BufferedImage
0x1 (1) Create Image from path
0x2 (2) Create Image from InputStream
Image Type
Event ID Description
0x0 (0) New BufferedImage
0x1 (1) Load MicroEJ Image from RAW file
0x2 (2) New MicroEJ Image from encoded image
0x3 (3) New MicroEJ Image from RAW image in external memory
0x4 (4) New MicroEJ Image from encoded image in external memory
0x5 (5) New MicroEJ Image from memory InputStream
0x6 (6) New MicroEJ Image from byte array InputStream
0x7 (7) New MicroEJ Image from generic InputStream
0x8 (8) Link Image
Drawing Type
Event ID Description
0x1 (1) Write pixel
0x2 (2) Draw line
0x3 (3) Draw horizontal line
0x4 (4) Draw vertical line
0x5 (5) Draw rectangle
0x6 (6) Fill rectangle
0x7 (7) Unknown
0x8 (8) Draw rounded rectangle
0x9 (9) Fill rounded rectangle
0xa (10) Draw circle arc
0xb (11) Fill circle arc
0xc (12) Draw ellipse arc
0xd (13) Fill ellipse arc
0xe (14) Draw ellipse
0xf (15) Fill ellipse
0x10 (16) Draw circle
0x11 (17) Fill circle
0x12 (18) Draw ARGB array
0x13 (19) Draw image
0x32 (50) Draw polygon
0x33 (51) Fill polygon
0x34 (52) Get ARGB image data
0x35 (53) Draw string
0x36 (54) Draw deformed string
0x37 (55) Draw deformed image
0x38 (56) Draw character with rotation (bilinear)
0x39 (57) Draw character with rotation (simple)
0x3a (58) Get string width
0x3b (59) Get pixel
0x64 (100) Draw thick faded point
0x65 (101) Draw thick faded line
0x66 (102) Draw thick faded circle
0x67 (103) Draw thick faded circle arc
0x68 (104) Draw thick faded ellipse
0x69 (105) Draw thick line
0x6a (106) Draw thick circle
0x6b (107) Draw thick ellipse
0x6c (108) Draw thick circle arc
0xc8 (200) Draw image with fli
0xc9 (201) Draw image with rotation (simple)
0xca (202) Draw image with rotation (bilinear)
0xcb (203) Draw image with scalling (simple)
0xcc (204) Draw image with scalling (bilinear)

SystemView Integration

The traces are SystemView compatible.

MicroUI Traces displayed in SystemView

MicroUI Traces displayed in SystemView

The following text can be copied in a file called SYSVIEW_MicroUI.txt and copied in SystemView installation folder (e.g. SEGGER/SystemView_V252a/Description/).

NamedType UIEvent 0=COMMAND
NamedType UIEvent 1=BUTTON
NamedType UIEvent 2=POINTER
NamedType UIEvent 3=STATE
NamedType UIEvent 4=UNKNOWN
NamedType UIEvent 5=CALLSERIALLY
NamedType UIEvent 6=STOP
NamedType UIEvent 7=INPUT
NamedType UIEvent 8=SHOW_DISPLAYABLE
NamedType UIEvent 9=HIDE_DISPLAYABLE
NamedType UIEvent 11=PENDING_FLUSH
NamedType UIEvent 12=FORCE_FLUSH
NamedType UIEvent 13=REPAINT_DISPLAYABLE
NamedType UIEvent 14=REPAINT_CURRENT_DISPLAYABLE
NamedType UIEvent 15=KF_STOP_FEATURE

NamedType UINewImage 0=MUTABLE_IMAGE
NamedType UINewImage 1=IMAGE_FROM_PATH
NamedType UINewImage 2=IMAGE_FROM_INPUTSTREAM

NamedType UIImageData 0=NEW_IMAGE
NamedType UIImageData 1=LOAD_MICROEJ
NamedType UIImageData 2=NEW_ENCODED
NamedType UIImageData 3=NEW_MICROEJ_EXTERNAL
NamedType UIImageData 4=NEW_ENCODED_EXTERNAL
NamedType UIImageData 5=MEMORY_INPUTSTREAM
NamedType UIImageData 6=BYTEARRAY_INPUTSTREAM
NamedType UIImageData 7=GENERIC_INPUTSTREAM
NamedType UIImageData 8=LINK_IMAGE

NamedType GEDraw 1=WRITE_PIXEL
NamedType GEDraw 2=DRAW_LINE
NamedType GEDraw 3=DRAW_HORIZONTALLINE
NamedType GEDraw 4=DRAW_VERTICALLINE
NamedType GEDraw 5=DRAW_RECTANGLE
NamedType GEDraw 6=FILL_RECTANGLE
NamedType GEDraw 7=UNKNOWN
NamedType GEDraw 8=DRAW_ROUNDEDRECTANGLE
NamedType GEDraw 9=FILL_ROUNDEDRECTANGLE
NamedType GEDraw 10=DRAW_CIRCLEARC
NamedType GEDraw 11=FILL_CIRCLEARC
NamedType GEDraw 12=DRAW_ELLIPSEARC
NamedType GEDraw 13=FILL_ELLIPSEARC
NamedType GEDraw 14=DRAW_ELLIPSE
NamedType GEDraw 15=FILL_ELLIPSE
NamedType GEDraw 16=DRAW_CIRCLE
NamedType GEDraw 17=FILL_CIRCLE
NamedType GEDraw 18=DRAW_ARGB
NamedType GEDraw 19=DRAW_IMAGE

NamedType GEDraw 50=DRAW_POLYGON
NamedType GEDraw 51=FILL_POLYGON
NamedType GEDraw 52=GET_IMAGEARGB
NamedType GEDraw 53=DRAW_STRING
NamedType GEDraw 54=DRAW_DEFORMED_STRING
NamedType GEDraw 55=DRAW_IMAGE_DEFORMED
NamedType GEDraw 56=DRAW_CHAR_ROTATION_BILINEAR
NamedType GEDraw 57=DRAW_CHAR_ROTATION_SIMPLE
NamedType GEDraw 58=STRING_WIDTH
NamedType GEDraw 59=GET_PIXEL

NamedType GEDraw 100=DRAW_THICKFADEDPOINT
NamedType GEDraw 101=DRAW_THICKFADEDLINE
NamedType GEDraw 102=DRAW_THICKFADEDCIRCLE
NamedType GEDraw 103=DRAW_THICKFADEDCIRCLEARC
NamedType GEDraw 104=DRAW_THICKFADEDELLIPSE
NamedType GEDraw 105=DRAW_THICKLINE
NamedType GEDraw 106=DRAW_THICKCIRCLE
NamedType GEDraw 107=DRAW_THICKELLIPSE
NamedType GEDraw 108=DRAW_THICKCIRCLEARC

NamedType GEDraw 200=DRAW_FLIPPEDIMAGE
NamedType GEDraw 201=DRAW_ROTATEDIMAGENEARESTNEIGHBOR
NamedType GEDraw 202=DRAW_ROTATEDIMAGEBILINEAR
NamedType GEDraw 203=DRAW_SCALEDIMAGENEARESTNEIGHBOR
NamedType GEDraw 204=DRAW_SCALEDIMAGEBILINEAR

#
# MicroUI
#
0        UI_EGEvent                  (MicroUI) Execute EventGenerator event %UIEvent (generatorID = %u, data = %p)   | (MicroUI) EventGenerator event %UIEvent done
1        UI_DROPEvent        (MicroUI) Drop event %p
2        UI_InputEvent       (MicroUI) Execute native input event %UIEvent (generatorID = %u, event = %p)    | (MicroUI) Native input event %UIEvent done
3        UI_DisplayEvent    (MicroUI) Execute display event %UIEvent (event = %p)                                    | (MicroUI) Display event %UIEvent done
4        UI_UserEvent        (MicroUI) Execute user event %p                                                                         | (MicroUI) User event %p done
5        UI_OpenImage       (MicroUI) Create %UINewImage                                                             | (MicroUI) Image created; id = %p
6        UI_ImageData       (MicroUI) %UINewImage ( %UIImageData ): id = %p; size = %d*%d

#
# MicroUI Graphics Engine
#
10       GE_FlushStart      (MicroUI GraphicalEngine) Flush back buffer (%u,%u) (%u*%u)
11       GE_FlushDone       (MicroUI GraphicalEngine) Flush done
12       GE_DrawInternal    (MicroUI GraphicalEngine) Drawing operation %GEDraw                   | (MicroUI GraphicalEngine) Drawing operation %GEDraw done
13       GE_Draw            (MicroUI GraphicalEngine) Drawing operation %GEDraw                   | (MicroUI GraphicalEngine) Drawing operation %GEDraw done
14       GE_Unknown                  (MicroUI GraphicalEngine) Unknown event
15       GE_GPUDrawDone     (MicroUI GraphicalEngine) Asynchronous drawing operation done

#
# MicroUI Input Engine
#
20       IE_InvalidEvent    (MicroUI Input Engine) Invalid event: %p
21       IE_QueueFull       (MicroUI Input Engine) Queue full, cannot add event %p
22       IE_AddEvent        (MicroUI Input Engine) Add event %p (index = %u / queue length = %u)
23       IE_ReplaceEvent    (MicroUI Input Engine) Replace event %p by %p (index = %u / queue length = %u)
24       IE_ReadEvent       (MicroUI Input Engine) Read event %p (index %u)