## 4.22 LED

An LED widget simulates a light emitting diodes display. It implements a few scrolling functions like those on a real LED display.

### Widget Info

Symbolic widget type | EZ_WIDGET_LED
Default class name | "Led"
Default instance name | "led"

### Widget Interface Routines

`void EZ_SetLedString(EZ_Widget *parent, char *str, char *clr);`

set the text to be displayed.

`char *EZ_GetLedString(EZ_Widget *led);`

return the text being displayed.

`void EZ_ClearLed (EZ_Widget *led);`

clear an led widget.

`void EZ_SetLedForeground (EZ_Widget *led, char *clr);`

set the foreground color.

`void EZ_SetLedBackground (EZ_Widget *led, char *clr);`

set the background color.

`void EZ_SetLedOffPixelColor (EZ_Widget *lcd, char *clr);`

set the color to display off pixels.

`void EZ_SetLedFont (EZ_Widget *lcd, char *font);`

set the font.

`void EZ_SetLedWidth (EZ_Widget *lcd, int w);`

set width, in terms of led pixels.

`void EZ_SetLedHeight (EZ_Widget *lcd, int h);`

set height, in terms of led pixels.

`void EZ_SetLedSize(EZ_Widget *lcd, int w, int h);`

set the width and height, in led pixels.

`void EZ_SetLedPixelSize (EZ_Widget *lcd, int s);`

set led pixel size.

`void EZ_RemoveLedAction(EZ_Widget *led, int action);`

remove a queued led scroll function.

`int EZ_LedIsFree (EZ_Widget *lcd);`

return the busy status of a led widget.

`void EZ_SetLedColorFunction(EZ_Widget *led,` `unsigned long (*colorf)(EZ_Widget *, int, int));`

set a pixel coloring function.

    int EZ_QueueLedAction(EZ_Widget *led, int type, int delay, int count,
                           char *msg,  char *clr);

Quene an led scroll function.

### Led Actions

Here is the list of all led actions.

    #define EZ_LED_SCROLL_LEFT        1            #define EZ_LED_SWEEP_CENTER       11
    #define EZ_LED_SCROLL_RIGHT       2            #define EZ_LED_SWEEP_CENTER_V     12
    #define EZ_LED_SCROLL_UP          3            #define EZ_LED_BOUNCE             13
    #define EZ_LED_SCROLL_DOWN        4            #define EZ_LED_BOUNCE_V           14
    #define EZ_LED_SCROLL_CENTE_H     5            #define EZ_LED_SHOW               15
    #define EZ_LED_SCROLL_CENTER_V    6            #define EZ_LED_BLINK              16
    #define EZ_LED_SWEEP_LEFT         7            #define EZ_LED_BLINK_SCROLL_LEFT  17
    #define EZ_LED_SWEEP_RIGHT        8            #define EZ_LED_BLINK_SCROLL_RIGHT 18
    #define EZ_LED_SWEEP_UP           9            #define EZ_LED_SLEEP              19
    #define EZ_LED_SWEEP_DOWN         10

### Screenshot

### Resources

Config_Option | ResourceName | DefaultValue
EZ_CLASS | class | `"Led"`
EZ_NAME | name | `"led"`

EZ_X | x |
EZ_Y | y |
EZ_WIDTH | width |
EZ_HEIGHT | height |

EZ_LOCATION | location |
EZ_SIZE | size |
EZ_GEOMETRY | geometry |

EZ_WIDTH_HINT | widthHint |
EZ_HEIGHT_HINT | heightHint |
EZ_SIZE_HINT | sizeHint |

EZ_BORDER_WIDTH | borderWidth | `0`
EZ_BORDER_TYPE | borderType | `none`
EZ_FOCUS_PAD | focusPad | `0`

EZ_CURSOR | cursor | `"XC_left_ptr"`
EZ_BUBBLE_STRING | bubbleString | `null`

EZ_CALLBACK | N/A | `null null`
EZ_DESTROY_CALLBACK | N/A | `null null`
EZ_EVENT_HANDLER | N/A | `null null`

EZ_FOREGROUND | foreground | `"black"`
EZ_BACKGROUND | background | `"gray74`
EZ_BG_IMAGE_FILE | bgImageFile | `null`
EZ_BG_PIXMAP | N/A | `none`

EZ_CLIENT_PTR_DATA | N/A | `null`
EZ_CLIENT_INT_DATA | clientIntData | `0`

EZ_DND_DRAG_CURSOR | dndDragCursor | `none`
EZ_DND_BUBBLE_STRING | dndBubbleString | `null`

EZ_LED_BACKGROUND | ledBackground | `"black"`
EZ_LED_PIXEL_COLOR | ledPixelColor |
EZ_LED_WIDTH | ledWidth | `60`
EZ_LED_HEIGHT | ledHeight | `10`
EZ_LED_PIXEL_SIZE | ledPixelSize | `2,2`
EZ_LED_COLOR_FUNCTION | ledColorFunction | `null`

HTML Documentation Maintainance:`Arturo Espinosa <arturo@nuclecu.unam.mx>`