User:Wirr: Difference between revisions

    From KDE TechBase
    No edit summary
     
    No edit summary
    Line 1: Line 1:
    = SuperKaramba API =
    = SuperKaramba API =
    == Bar/createBar ==
     
    == Bar ==
     
    === createBar ===
    This creates a bar at x, y with width and height w, h.
    This creates a bar at x, y with width and height w, h.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 14: Line 17:
    Reference to new bar meter
    Reference to new bar meter


    == Bar/deleteBar ==
    === deleteBar ===
    This deletes the bar.
    This deletes the bar.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 24: Line 27:
    true if successful
    true if successful


    == Bar/getBarImage ==
    === getBarImage ===
    Get the path to the bar image.
    Get the path to the bar image.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 34: Line 37:
    path to bar image
    path to bar image


    == Bar/getBarMinMax ==
    === getBarMinMax ===
    Returns possible min and max values of the bar.
    Returns possible min and max values of the bar.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 44: Line 47:
    array with max & min values
    array with max & min values


    == Bar/getBarPos ==
    === getBarPos ===
    Given a reference to a bar object, this will return a array
    Given a reference to a bar object, this will return a array
    containing the x and y coordinate of a bar object.
    containing the x and y coordinate of a bar object.
    Line 55: Line 58:
    array with x and y coordinates
    array with x and y coordinates


    == Bar/getBarSensor ==
    === getBarSensor ===
    Gets the current sensor string.
    Gets the current sensor string.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 65: Line 68:
    sensor string
    sensor string


    == Bar/getBarSize ==
    === getBarSize ===
    Given a reference to a bar object, this will return a array
    Given a reference to a bar object, this will return a array
    containing the height and width of the bar object.
    containing the height and width of the bar object.
    Line 76: Line 79:
    array with width and height
    array with width and height


    == Bar/getBarValue ==
    === getBarValue ===
    Returns current bar value.
    Returns current bar value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 86: Line 89:
    value
    value


    == Bar/getBarVertical ==
    === getBarVertical ===
    Check if bar is a vertical bar.
    Check if bar is a vertical bar.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 96: Line 99:
    true if vertical
    true if vertical


    == Bar/getThemeBar ==
    === getThemeBar ===
    You can reference a bar in your python code that was created in the
    You can reference a bar in your python code that was created in the
    theme file. Basically, you just add a NAME= value to the BAR line in
    theme file. Basically, you just add a NAME= value to the BAR line in
    Line 111: Line 114:
    reference to bar
    reference to bar


    == Bar/hideBar ==
    === hideBar ===
    This hides an bar. In other words, during subsequent calls to
    This hides an bar. In other words, during subsequent calls to
    widgetUpdate(), this bar will not be drawn.
    widgetUpdate(), this bar will not be drawn.
    Line 122: Line 125:
    true if successful
    true if successful


    == Bar/moveBar ==
    === moveBar ===
    This will move the bar to new x and y coordinates.
    This will move the bar to new x and y coordinates.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 134: Line 137:
    boolean (true if successful)
    boolean (true if successful)


    == Bar/resizeBar ==
    === resizeBar ===
    This will resize bar to new height and width.
    This will resize bar to new height and width.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 146: Line 149:
    true if successful
    true if successful


    == Bar/setBarImage ==
    === setBarImage ===
    Use the image in path for the background as the bar
    Use the image in path for the background as the bar
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 157: Line 160:
    true if successful
    true if successful


    == Bar/setBarMinMax ==
    === setBarMinMax ===
    Returns current bar value.
    Returns current bar value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 169: Line 172:
    true if successful
    true if successful


    == Bar/setBarSensor ==
    === setBarSensor ===
    Sets the sensor string of the bar.
    Sets the sensor string of the bar.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 180: Line 183:
    true if successful
    true if successful


    == Bar/setBarValue ==
    === setBarValue ===
    Sets current bar value.
    Sets current bar value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 191: Line 194:
    reference to bar
    reference to bar


    == Bar/setBarVertical ==
    === setBarVertical ===
    Set bar vertical
    Set bar vertical
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 202: Line 205:
    true if successful
    true if successful


    == Bar/showBar ==
    === showBar ===
    This shows an bar. In other words, during subsequent calls to
    This shows an bar. In other words, during subsequent calls to
    widgetUpdate(), this bar will be drawn.
    widgetUpdate(), this bar will be drawn.
    Line 213: Line 216:
    true if successful
    true if successful


    == Config/addMenuConfigOption ==
     
    == Config ==
     
    === addMenuConfigOption ===
    SuperKaramba supports a simplistic configuration pop-up menu. This menu
    SuperKaramba supports a simplistic configuration pop-up menu. This menu
    appears when you right-click on a widget and choose Configure Theme.
    appears when you right-click on a widget and choose Configure Theme.
    Line 239: Line 245:
    true if successful
    true if successful


    == Config/readConfigEntry ==
    === readConfigEntry ===
    This function reads an entry from the config file with the given key.
    This function reads an entry from the config file with the given key.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 249: Line 255:
    config value for key
    config value for key


    == Config/readMenuConfigOption ==
    === readMenuConfigOption ===
    This returns whether or not the given option is checked in the theme's
    This returns whether or not the given option is checked in the theme's
    Configure Theme menu.
    Configure Theme menu.
    Line 261: Line 267:
    false is returned if it is not checked and true is returned if it is.
    false is returned if it is not checked and true is returned if it is.


    == Config/setMenuConfigOption ==
    === setMenuConfigOption ===
    This sets whether or not the given option is checked in the theme's
    This sets whether or not the given option is checked in the theme's
    Configure Theme menu. Value should be false if key should not be checked and
    Configure Theme menu. Value should be false if key should not be checked and
    Line 275: Line 281:
    true if successful
    true if successful


    == Config/writeConfigEntry ==
    === writeConfigEntry ===
    SuperKaramba automatically supports configuration files for each theme.
    SuperKaramba automatically supports configuration files for each theme.
     
    These files will be saved in /your/home/dir/.superkaramba/ and will be
    == These files will be saved in /your/home/dir/.superkaramba/ and will be==
    named themenamerc where themename is the name of the theme.
    named themenamerc where themename is the name of the theme.
    This function writes an entry into the config file with the given key and
    This function writes an entry into the config file with the given key and
    Line 293: Line 298:
    true if successful
    true if successful


    == Graph/createGraph ==
    == Graph ==
     
    === createGraph ===
    This creates a graph at x, y with width and height.
    This creates a graph at x, y with width and height.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 307: Line 314:
    reference to new graph meter
    reference to new graph meter


    == Graph/deleteGraph ==
    === deleteGraph ===
    This deletes graph.
    This deletes graph.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 317: Line 324:
    true if successful
    true if successful


    == Graph/getGraphColor ==
    === getGraphColor ===
    Gets the current graph color components.
    Gets the current graph color components.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 327: Line 334:
    (red, green, blue)
    (red, green, blue)


    == Graph/getGraphMinMax ==
    === getGraphMinMax ===
    Returns current graph minimal and maximal values.
    Returns current graph minimal and maximal values.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 337: Line 344:
    max and min values
    max and min values


    == Graph/getGraphPos ==
    === getGraphPos ===
    Given a reference to a graph object, this will return an array
    Given a reference to a graph object, this will return an array
    containing the x and y coordinates of the graph object.
    containing the x and y coordinates of the graph object.
    Line 348: Line 355:
    x and y coordinates
    x and y coordinates


    == Graph/getGraphSensor ==
    === getGraphSensor ===
    Gets the current sensor string of the graph.
    Gets the current sensor string of the graph.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 358: Line 365:
    sensor string
    sensor string


    == Graph/getGraphSize ==
    === getGraphSize ===
    Given a reference to a graph object, this will return an array
    Given a reference to a graph object, this will return an array
    containing the height and width of a graph object.
    containing the height and width of a graph object.
    Line 369: Line 376:
    width and height of the graph
    width and height of the graph


    == Graph/getGraphValue ==
    === getGraphValue ===
    Returns current graph value.
    Returns current graph value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 379: Line 386:
    value
    value


    == Graph/getThemeGraph ==
    === getThemeGraph ===
    You can reference graph in your python code that was created in the
    You can reference graph in your python code that was created in the
    theme file. Basically, you just add a NAME= value to the GRAPH line in
    theme file. Basically, you just add a NAME= value to the GRAPH line in
    Line 394: Line 401:
    reference to graph
    reference to graph


    == Graph/hideGraph ==
    === hideGraph ===
    This hides a graph. In other words, during subsequent calls to
    This hides a graph. In other words, during subsequent calls to
    widgetUpdate(), this graph will not be drawn.
    widgetUpdate(), this graph will not be drawn.
    Line 405: Line 412:
    true if successful
    true if successful


    == Graph/moveGraph ==
    === moveGraph ===
    This will move the graph to the new x and y coordinates.
    This will move the graph to the new x and y coordinates.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 417: Line 424:
    true if successful
    true if successful


    == Graph/resizeGraph ==
    === resizeGraph ===
    This will resize graph to new height and width.
    This will resize graph to new height and width.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 429: Line 436:
    true if successful
    true if successful


    == Graph/setGraphColor ==
    === setGraphColor ===
    Sets current graph color.
    Sets current graph color.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 442: Line 449:
    true if successful
    true if successful


    == Graph/setGraphMinMax ==
    === setGraphMinMax ===
    Sets the graphs min and max values.
    Sets the graphs min and max values.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 454: Line 461:
    true if successful
    true if successful


    == Graph/setGraphSensor ==
    === setGraphSensor ===
    Sets current sensor string of the graph.
    Sets current sensor string of the graph.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 465: Line 472:
    true if successful
    true if successful


    == Graph/setGraphValue ==
    === setGraphValue ===
    Sets current graph value.
    Sets current graph value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 476: Line 483:
    reference to graph
    reference to graph


    == Graph/showGraph ==
    === showGraph ===
    This shows a graph. In other words, during subsequent calls to
    This shows a graph. In other words, during subsequent calls to
    widgetUpdate(), this graph will be drawn.
    widgetUpdate(), this graph will be drawn.
    Line 487: Line 494:
    true if successful
    true if successful


    == Image/addImageTooltip ==
    == Image ==
     
    === addImageTooltip ===
    This creats a tooltip for image with text.
    This creats a tooltip for image with text.
    Note:
    Note:
    Line 502: Line 511:
    true if successful
    true if successful


    == Image/changeImageChannelIntensity ==
    === changeImageChannelIntensity ===
    Changes the "intensity" of the image color channel, which is similar to
    Changes the "intensity" of the image color channel, which is similar to
    it's brightness.
    it's brightness.
    Line 516: Line 525:
    true if successful
    true if successful


    == Image/changeImageIntensity ==
    === changeImageIntensity ===
    Changes the "intensity" of the image, which is similar to it's
    Changes the "intensity" of the image, which is similar to it's
    brightness. ratio is a floating point number from -1.0 to 1.0 that
    brightness. ratio is a floating point number from -1.0 to 1.0 that
    Line 534: Line 543:
    true if successful
    true if successful


    == Image/changeImageToGray ==
    === changeImageToGray ===
    Turns the given image into a grayscale image. Millisec specifies how
    Turns the given image into a grayscale image. Millisec specifies how
    long in milliseconds before the image is restored to it's original form.
    long in milliseconds before the image is restored to it's original form.
    Line 548: Line 557:
    1 if successful
    1 if successful


    == Image/createBackgroundImage ==
    === createBackgroundImage ===
    This creates an background image on your widget at x, y. The filename
    This creates an background image on your widget at x, y. The filename
    should be given as the path parameter. In theory the image could be
    should be given as the path parameter. In theory the image could be
    Line 564: Line 573:
    reference to new image meter
    reference to new image meter


    == Image/createImage ==
    === createImage ===
    This creates an image on your widget at x, y. The filename should be
    This creates an image on your widget at x, y. The filename should be
    given as the path parameter. In theory the image could be local or could
    given as the path parameter. In theory the image could be local or could
    Line 580: Line 589:
    reference to new image meter
    reference to new image meter


    == Image/createTaskIcon ==
    === createTaskIcon ===
    This creates a task image at x, y.
    This creates a task image at x, y.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 592: Line 601:
    reference to new image meter
    reference to new image meter


    == Image/deleteImage ==
    === deleteImage ===
    This removes the image from the widhet. Please do not call functions on "image"
    This removes the image from the widhet. Please do not call functions on "image"
    after calling deleteImage, as it does not exist anymore and that could
    after calling deleteImage, as it does not exist anymore and that could
    Line 604: Line 613:
    true if successful
    true if successful


    == Image/getImageHeight ==
    === getImageHeight ===
    This returns the height of an image. This is useful if you have rotated
    This returns the height of an image. This is useful if you have rotated
    an image and its size changed, so you do not know how big it is anymore.
    an image and its size changed, so you do not know how big it is anymore.
    Line 615: Line 624:
    height of the image
    height of the image


    == Image/getImagePath ==
    === getImagePath ===
    Returns the current image path.
    Returns the current image path.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 625: Line 634:
    path
    path


    == Image/getImagePos ==
    === getImagePos ===
    Given a reference to a image object, this will return a tuple
    Given a reference to a image object, this will return a tuple
    containing the x and y coordinate of a image object.
    containing the x and y coordinate of a image object.
    Line 636: Line 645:
    x and y coordinates of the image
    x and y coordinates of the image


    == Image/getImageSensor ==
    === getImageSensor ===
    Gets the current sensor string.
    Gets the current sensor string.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 646: Line 655:
    sensor string
    sensor string


    == Image/getImageSize ==
    === getImageSize ===
    Given a reference to a image object, this will return an array
    Given a reference to a image object, this will return an array
    containing the height and width of a image object.
    containing the height and width of a image object.
    Line 657: Line 666:
    height and width of the image
    height and width of the image


    == Image/getImageWidth ==
    === getImageWidth ===
    This returns the width of an image. This is useful if you have rotated
    This returns the width of an image. This is useful if you have rotated
    an image and its size changed, so you do not know how big it is anymore.
    an image and its size changed, so you do not know how big it is anymore.
    Line 668: Line 677:
    width of the image
    width of the image


    == Image/getThemeImage ==
    === getThemeImage ===
    You can reference an image in your python code that was created in the
    You can reference an image in your python code that was created in the
    .theme file. Basically, you just add a NAME= value to the IMAGE line in
    .theme file. Basically, you just add a NAME= value to the IMAGE line in
    Line 683: Line 692:
    reference to image
    reference to image


    == Image/hideImage ==
    === hideImage ===
    This hides an image. In other words, during subsequent calls to
    This hides an image. In other words, during subsequent calls to
    widgetUpdate(), this image will not be drawn.
    widgetUpdate(), this image will not be drawn.
    Line 694: Line 703:
    true if successful
    true if successful


    == Image/moveImage ==
    === moveImage ===
    This moves an image to a new x, y relative to your widget. In other
    This moves an image to a new x, y relative to your widget. In other
    words, (0,0) is the top corner of your widget, not the screen. The
    words, (0,0) is the top corner of your widget, not the screen. The
    Line 709: Line 718:
    true if successful
    true if successful


    == Image/removeImageEffects ==
    === removeImageEffects ===
    If you have called image effect commands on your image (ex:
    If you have called image effect commands on your image (ex:
    changeImageIntensityrobo43), you can call this to restore your image to it's
    changeImageIntensityrobo43), you can call this to restore your image to it's
    Line 721: Line 730:
    true if successful
    true if successful


    == Image/removeImageTransformations ==
    === removeImageTransformations ===
    If you have rotated or resized your image, you can call this function to restore
    If you have rotated or resized your image, you can call this function to restore
    your image to its original form.
    your image to its original form.
    Line 732: Line 741:
    true if successful
    true if successful


    == Image/resizeImage ==
    === resizeImage ===
    This resizes your image to width, height. The image parameter is
    This resizes your image to width, height. The image parameter is
    a reference to an image that you saved as the return value from
    a reference to an image that you saved as the return value from
    Line 746: Line 755:
    true if successful
    true if successful


    == Image/resizeImageSmooth ==
    === resizeImageSmooth ===
    DEPRECATED: resizeImagerobo60 now allows the user to pick whether to use fast
    DEPRECATED: resizeImagerobo60 now allows the user to pick whether to use fast
    or smooth resizing from the SuperKaramba menu - This resizes your image
    or smooth resizing from the SuperKaramba menu - This resizes your image
    Line 762: Line 771:
    true if successful
    true if successful


    == Image/rotateImage ==
    === rotateImage ===
    This rotates your image to by the specified amount of degrees. The
    This rotates your image to by the specified amount of degrees. The
    The image parameter is a reference to an image that you saved as the
    The image parameter is a reference to an image that you saved as the
    Line 775: Line 784:
    true if successful
    true if successful


    == Image/setImagePath ==
    === setImagePath ===
    This will change image of a image widget.
    This will change image of a image widget.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 786: Line 795:
    reference to the image
    reference to the image


    == Image/setImageSensor ==
    === setImageSensor ===
    Sets the current sensor string.
    Sets the current sensor string.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 797: Line 806:
    true if successful
    true if successful


    == Image/showImage ==
    === showImage ===
    This shows a previously hidden image. It does not actually refresh the
    This shows a previously hidden image. It does not actually refresh the
    image on screen. That is what redrawWidgetrobo182() does.
    image on screen. That is what redrawWidgetrobo182() does.
    Line 808: Line 817:
    true if successful
    true if successful


    == InputBox/changeInputBox ==
     
    == Input Box ==
     
    === changeInputBox ===
    This function will change the contents of a input box widget.
    This function will change the contents of a input box widget.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 819: Line 831:
    reference to input box
    reference to input box


    == InputBox/changeInputBoxBackgroundColor ==
    === changeInputBoxBackgroundColor ===
    This will change the background color of a Input Box widget.
    This will change the background color of a Input Box widget.
    InputBox is the reference to the text object to change
    InputBox is the reference to the text object to change
    Line 834: Line 846:
    true if successful
    true if successful


    == InputBox/changeInputBoxFont ==
    === changeInputBoxFont ===
    This will change the font of a Input Box widget. InputBox is the reference to the
    This will change the font of a Input Box widget. InputBox is the reference to the
    Input Box object to change. Font is a string with the name of the font to use.
    Input Box object to change. Font is a string with the name of the font to use.
    Line 846: Line 858:
    true if successful
    true if successful


    == InputBox/changeInputBoxFontColor ==
    === changeInputBoxFontColor ===
    This will change the color of a text of a Input Box widget.
    This will change the color of a text of a Input Box widget.
    InputBox is the reference to the text object to change
    InputBox is the reference to the text object to change
    Line 861: Line 873:
    true if successful
    true if successful


    == InputBox/changeInputBoxFontSize ==
    === changeInputBoxFontSize ===
    This will change the font size of a Input Box widget.
    This will change the font size of a Input Box widget.
    InputBox is the reference to the text object to change.
    InputBox is the reference to the text object to change.
    Line 874: Line 886:
    true if successful
    true if successful


    == InputBox/changeInputBoxFrameColor ==
    === changeInputBoxFrameColor ===
    This will change the frame color of a Input Box widget.
    This will change the frame color of a Input Box widget.
    InputBox is the reference to the text object to change
    InputBox is the reference to the text object to change
    Line 889: Line 901:
    true if successful
    true if successful


    == InputBox/changeInputBoxSelectedTextColor ==
    === changeInputBoxSelectedTextColor ===
    This will change the selected text color of a Input Box widget.
    This will change the selected text color of a Input Box widget.
    InputBox is the reference to the text object to change
    InputBox is the reference to the text object to change
    Line 904: Line 916:
    true if successful
    true if successful


    == InputBox/changeInputBoxSelectionColor ==
    === changeInputBoxSelectionColor ===
    This will change the color of the selection of a Input Box widget.
    This will change the color of the selection of a Input Box widget.
    InputBox is the reference to the text object to change
    InputBox is the reference to the text object to change
    Line 919: Line 931:
    true if successful
    true if successful


    == InputBox/clearInputFocus ==
    === clearInputFocus ===
    Releases the input focus from the Input Box.
    Releases the input focus from the Input Box.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 929: Line 941:
    true if successful
    true if successful


    == InputBox/createInputBox ==
    === createInputBox ===
    This creates a new Input Box at x, y with width and height w, h. You need to save
    This creates a new Input Box at x, y with width and height w, h. You need to save
    the return value of this function to call other functions on your Input Box
    the return value of this function to call other functions on your Input Box
    Line 946: Line 958:
    reference to new Input Box
    reference to new Input Box


    == InputBox/deleteInputBox ==
    === deleteInputBox ===
    This removes the Input Box object from the widget. Please do not call functions of
    This removes the Input Box object from the widget. Please do not call functions of
    the Input Box after calling deleteInputBox, as it does not exist anymore and that
    the Input Box after calling deleteInputBox, as it does not exist anymore and that
    Line 960: Line 972:
    true if successful
    true if successful


    == InputBox/getInputBoxBackgroundColor ==
    === getInputBoxBackgroundColor ===
    Gets the current background color of a Input Box
    Gets the current background color of a Input Box
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 970: Line 982:
    (red, green, blue)
    (red, green, blue)


    == InputBox/getInputBoxFont ==
    === getInputBoxFont ===
    Gets the current Input Box font name
    Gets the current Input Box font name
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 980: Line 992:
    font name
    font name


    == InputBox/getInputBoxFontColor ==
    === getInputBoxFontColor ===
    Gets the current text color of a Input Box
    Gets the current text color of a Input Box
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 990: Line 1,002:
    (red, green, blue)
    (red, green, blue)


    == InputBox/getInputBoxFontSize ==
    === getInputBoxFontSize ===
    Gets the current text font size.
    Gets the current text font size.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,000: Line 1,012:
    text font size
    text font size


    == InputBox/getInputBoxFrameColor ==
    === getInputBoxFrameColor ===
    Gets the current frame color of a Input Box
    Gets the current frame color of a Input Box
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,010: Line 1,022:
    (red, green, blue)
    (red, green, blue)


    == InputBox/getInputBoxPos ==
    === getInputBoxPos ===
    Given a reference to a Input Box object, this will return an array
    Given a reference to a Input Box object, this will return an array
    containing the x and y coordinate of an Input Box.
    containing the x and y coordinate of an Input Box.
    Line 1,021: Line 1,033:
    x and y coordinates of the inputBox
    x and y coordinates of the inputBox


    == InputBox/getInputBoxSelectedTextColor ==
    === getInputBoxSelectedTextColor ===
    Gets the current selected text color of a Input Box.
    Gets the current selected text color of a Input Box.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,031: Line 1,043:
    (red, green, blue)
    (red, green, blue)


    == InputBox/getInputBoxSelectionColor ==
    === getInputBoxSelectionColor ===
    Gets the current selection color of a Input Box
    Gets the current selection color of a Input Box
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,041: Line 1,053:
    (red, green, blue)
    (red, green, blue)


    == InputBox/getInputBoxSize ==
    === getInputBoxSize ===
    Given a reference to a Input Box object, this will return an array
    Given a reference to a Input Box object, this will return an array
    containing the height and width of a Input Box object.
    containing the height and width of a Input Box object.
    Line 1,052: Line 1,064:
    width and hight of the input box
    width and hight of the input box


    == InputBox/getInputBoxValue ==
    === getInputBoxValue ===
    Returns current Input Box text.
    Returns current Input Box text.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,062: Line 1,074:
    input box text
    input box text


    == InputBox/getInputFocus ==
    === getInputFocus ===
    Gets the Input Box that is currently focused.
    Gets the Input Box that is currently focused.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,071: Line 1,083:
    the input box or 0
    the input box or 0


    == InputBox/getThemeInputBox ==
    === getThemeInputBox ===
    You can reference text in your python code that was created in the
    You can reference text in your python code that was created in the
    theme file. Basically, you just add a NAME= value to the INPUT line in
    theme file. Basically, you just add a NAME= value to the INPUT line in
    Line 1,086: Line 1,098:
    reference to Input Box
    reference to Input Box


    == InputBox/hideInputBox ==
    === hideInputBox ===
    Hides a Input Box that is visible.
    Hides a Input Box that is visible.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,096: Line 1,108:
    true if successful
    true if successful


    == InputBox/moveInputBox ==
    === moveInputBox ===
    This moves a Input Box object to a new x, y relative to your widget. In other
    This moves a Input Box object to a new x, y relative to your widget. In other
    words, (0,0) is the top corner of your widget, not the screen.
    words, (0,0) is the top corner of your widget, not the screen.
    Line 1,109: Line 1,121:
    true if successful
    true if successful


    == InputBox/resizeInputBox ==
    === resizeInputBox ===
    This will resize Input Box to the new height and width.
    This will resize Input Box to the new height and width.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,121: Line 1,133:
    true if successful
    true if successful


    == InputBox/setInputFocus ==
    === setInputFocus ===
    Sets the input focus to the Input Box.
    Sets the input focus to the Input Box.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,131: Line 1,143:
    true if successful
    true if successful


    == InputBox/showInputBox ==
    === showInputBox ===
    Shows Input Box that has been hidden with hideInputBoxrobo89()
    Shows Input Box that has been hidden with hideInputBoxrobo89()
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,141: Line 1,153:
    true if successful
    true if successful


    == Menu/addMenuItem ==
    == Menu ==
     
    === addMenuItem ===
    This adds an entry to the given menu with label text and with given icon.
    This adds an entry to the given menu with label text and with given icon.
    Icon can be just an application name in which case the user's current
    Icon can be just an application name in which case the user's current
    Line 1,158: Line 1,172:
    reference to the menu item
    reference to the menu item


    == Menu/addMenuSeparator ==
    === addMenuSeparator ===
    This adds an menu separator to the given menu.
    This adds an menu separator to the given menu.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,168: Line 1,182:
    reference to the separator
    reference to the separator


    == Menu/createMenu ==
    === createMenu ===
    This creates an empty popup menu and returns a reference to the menu.
    This creates an empty popup menu and returns a reference to the menu.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,177: Line 1,191:
    reference to menu
    reference to menu


    == Menu/deleteMenu ==
    === deleteMenu ===
    This deletes the referenced menu if that menu exists.
    This deletes the referenced menu if that menu exists.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,187: Line 1,201:
    true if menu existed and was deleted, returns false otherwise.
    true if menu existed and was deleted, returns false otherwise.


    == Menu/popupMenu ==
    === popupMenu ===
    This pops up the given menu at the given co-ordinates. The co-ordinates
    This pops up the given menu at the given co-ordinates. The co-ordinates
    are relative to the widget, not the screen. You can use negative
    are relative to the widget, not the screen. You can use negative
    Line 1,201: Line 1,215:
    true if the menu existed and was popped up, returns false otherwise.
    true if the menu existed and was popped up, returns false otherwise.


    == Menu/removeMenuItem ==
    === removeMenuItem ===
    This removes the menu if it exists.
    This removes the menu if it exists.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,212: Line 1,226:
    1 if the menu item existed and was removed or returns zero otherwise.
    1 if the menu item existed and was removed or returns zero otherwise.


    == Misc/acceptDrops ==
    == Misc ==
     
    === acceptDrops ===
    Calling this enables your widget to receive Drop events. In other words,
    Calling this enables your widget to receive Drop events. In other words,
     
    the user will be able to drag icons from his/her desktop and drop them on
    == the user will be able to drag icons from his/her desktop and drop them on==
    your widget. The "itemDropped" callback is called as a result with the
    your widget. The "itemDropped" callback is called as a result with the
    data about the icon that was dropped on your widget. This allows, for
    data about the icon that was dropped on your widget. This allows, for
    Line 1,227: Line 1,242:
    true if successful
    true if successful


    == Misc/attachClickArea ==
    === attachClickArea ===
    It is possible to attach a clickarea to a meter (image or text field),
    It is possible to attach a clickarea to a meter (image or text field),
    which is moved and resized correctly if the meter is moved or resized.
    which is moved and resized correctly if the meter is moved or resized.
    Line 1,253: Line 1,268:
    true if successful
    true if successful


    == Misc/callTheme ==
    === callTheme ===
    Calls a theme - identified by the pretty name - and passes it a string to it.
    Calls a theme - identified by the pretty name - and passes it a string to it.
    This will work, despite superkaramba being multithreaded, because it
    This will work, despite superkaramba being multithreaded, because it
    Line 1,268: Line 1,283:
    true if successful
    true if successful


    == Misc/changeInterval ==
    === changeInterval ===
    This function changes your widget's refresh rate (ms)
    This function changes your widget's refresh rate (ms)
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,278: Line 1,293:
    true if successful
    true if successful


    == Misc/createClickArea ==
    === createClickArea ===
    This creates a clickable area at x, y with width and height w, h. When
    This creates a clickable area at x, y with width and height w, h. When
    this area is clicked, cmd_to_run will be executed. The mouse will change over this area.
    this area is clicked, cmd_to_run will be executed. The mouse will change over this area.
    Line 1,293: Line 1,308:
    reference to the new click area
    reference to the new click area


    == Misc/createServiceClickArea ==
    === createServiceClickArea ===
    This creates a clickable area at x, y with width and height w, h. When
    This creates a clickable area at x, y with width and height w, h. When
    this area is clicked, cmd_to_run will be executed. The mouse will change
    this area is clicked, cmd_to_run will be executed. The mouse will change
    Line 1,314: Line 1,329:
    reference to the new click area
    reference to the new click area


    == Misc/execute ==
    === execute ===
    This command simply executes a program or command on the system. This is
    This command simply executes a program or command on the system. This is
    just for convience (IE you could accomplish this directly through python,
    just for convience (IE you could accomplish this directly through python,
    Line 1,326: Line 1,341:
    process id of the executed command
    process id of the executed command


    == Misc/executeInteractive ==
    === executeInteractive ===
    This command executes a program or command on the system. Additionally it allows
    This command executes a program or command on the system. Additionally it allows
    you to get any text that the program outputs. Futhermore, it won't freeze
    you to get any text that the program outputs. Futhermore, it won't freeze
    Line 1,349: Line 1,364:
    process id of the executed command
    process id of the executed command


    == Misc/getIncomingData ==
    === getIncomingData ===
    Obtains the last data received by any other theme that set the
    Obtains the last data received by any other theme that set the
    "incoming data" of this theme. This isn't particularly sophisticated
    "incoming data" of this theme. This isn't particularly sophisticated
    Line 1,360: Line 1,375:
    string containing the last information received from setIncomingDatarobo124
    string containing the last information received from setIncomingDatarobo124


    == Misc/getIp ==
    === getIp ===
    Gets the current IP address of the interface_name interface.
    Gets the current IP address of the interface_name interface.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,370: Line 1,385:
    ip address as string
    ip address as string


    == Misc/getNumberOfDesktop ==
    === getNumberOfDesktop ===
    Returns number of desktops
    Returns number of desktops
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,379: Line 1,394:
    number of desktops
    number of desktops


    == Misc/getPrettyThemeName ==
    === getPrettyThemeName ===
    When a theme is created (with openNamedThemerobo118), there is an
    When a theme is created (with openNamedThemerobo118), there is an
    option to give the theme an alternative name.
    option to give the theme an alternative name.
    Line 1,392: Line 1,407:
    the pretty name of the theme
    the pretty name of the theme


    == Misc/getServiceGroups ==
    === getServiceGroups ===
    This function returns a list of services and service groups
    This function returns a list of services and service groups
    that are in the user's KDE Menu.  It is not a recursive
    that are in the user's KDE Menu.  It is not a recursive
    Line 1,408: Line 1,423:
    To fully understand the return results of this function,
    To fully understand the return results of this function,


    == it is thoroughly recommended //  that you look up the==
    === it is thoroughly recommended //  that you look up the===
    KDE documentation on KServiceGroup and KService.
    KDE documentation on KServiceGroup and KService.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,418: Line 1,433:
    List of Dictionaries of services and service groups
    List of Dictionaries of services and service groups


    == Misc/getThemePath ==
    === getThemePath ===
    Returns a string containing the directory where your theme was loaded
    Returns a string containing the directory where your theme was loaded
    from.
    from.
    Line 1,428: Line 1,443:
    path to theme
    path to theme


    == Misc/getUpdateTime ==
    === getUpdateTime ===
    Returns the last stored update time. Intended for use
    Returns the last stored update time. Intended for use
    so that the next refresh interval can work out how long ago
    so that the next refresh interval can work out how long ago
    Line 1,439: Line 1,454:
    last stored update time (from setUpdateTimerobo125)
    last stored update time (from setUpdateTimerobo125)


    == Misc/hide ==
    === hide ===
    Hides the widget.
    Hides the widget.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,448: Line 1,463:
    true if successful
    true if successful


    == Misc/language ==
    === language ===
    Returns a string containing the default language of a translation file.
    Returns a string containing the default language of a translation file.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,457: Line 1,472:
    default language or empty string if no translation files found.
    default language or empty string if no translation files found.


    == Misc/managementPopup ==
    === managementPopup ===
    The right click menu of SuperKaramba allows themes
    The right click menu of SuperKaramba allows themes
    to be loaded, closed, moved to other screens.
    to be loaded, closed, moved to other screens.
    Line 1,469: Line 1,484:
    true if successful
    true if successful


    == Misc/openNamedTheme ==
    === openNamedTheme ===
    Opens a new theme, giving it a pretty (alternative and by your
    Opens a new theme, giving it a pretty (alternative and by your
    own choice _unique_) name.
    own choice _unique_) name.
    Line 1,488: Line 1,503:
    reference to the new widget
    reference to the new widget


    == Misc/openTheme ==
    === openTheme ===
    Opens a new theme.
    Opens a new theme.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,497: Line 1,512:
    reference to the new widget
    reference to the new widget


    == Misc/readThemeFile ==
    === readThemeFile ===
    Returns a string with the contents of the theme file
    Returns a string with the contents of the theme file
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,507: Line 1,522:
    file contents
    file contents


    == Misc/reloadTheme ==
    === reloadTheme ===
    Reloads the current theme.
    Reloads the current theme.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,516: Line 1,531:
    true if successful
    true if successful


    == Misc/removeClickArea ==
    === removeClickArea ===
    This function deletes a clickable area.
    This function deletes a clickable area.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,526: Line 1,541:
    true if successful
    true if successful


    == Misc/run ==
    === run ===
    This command simply executes a program or command on the system.
    This command simply executes a program or command on the system.
    The difference between run and executerobo106 is that run takes arguments,
    The difference between run and executerobo106 is that run takes arguments,
    Line 1,540: Line 1,555:
    true if successful
    true if successful


    == Misc/setIncomingData ==
    === setIncomingData ===
    Contacts a theme - identified by the pretty name - and stores a string
    Contacts a theme - identified by the pretty name - and stores a string
    to be associated with the remote theme. The difference between
    to be associated with the remote theme. The difference between
    Line 1,558: Line 1,573:
    true if successful
    true if successful


    == Misc/setUpdateTime ==
    === setUpdateTime ===
    Sets the update time. Intended for use
    Sets the update time. Intended for use
    so that the next refresh interval can work out how long ago
    so that the next refresh interval can work out how long ago
    Line 1,570: Line 1,585:
    true if successful
    true if successful


    == Misc/show ==
    === show ===
    Shows the widget.
    Shows the widget.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,579: Line 1,594:
    true if successful
    true if successful


    == Misc/toggleShowDesktop ==
    === toggleShowDesktop ===
     
    This shows/hides the current desktop just like the Show Desktop button on
    == This shows/hides the current desktop just like the Show Desktop button on==
    kicker. Basically, it minimizes all the windows on the current desktop.
    kicker. Basically, it minimizes all the windows on the current desktop.
    Call it once to showrobo126 the desktop and again to hiderobo115 it.
    Call it once to showrobo126 the desktop and again to hiderobo115 it.
    Line 1,591: Line 1,605:
    true if successful
    true if successful


    == Misc/translateAll ==
    === translateAll ===
    Moves all widgets within a theme in a particular direction relative from
    Moves all widgets within a theme in a particular direction relative from
    the previous spot without moving the parent theme widget.
    the previous spot without moving the parent theme widget.
    Line 1,603: Line 1,617:
    true if successful
    true if successful


    == Misc/userLanguage ==
    === userLanguage ===
    Returns a string containing the global KDE user languagerobo116.
    Returns a string containing the global KDE user languagerobo116.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,612: Line 1,626:
    user languagerobo116 or empty string
    user languagerobo116 or empty string


    == Misc/userLanguages ==
    === userLanguages ===
    Returns an array containing the languagerobo116 name abbreviations for the
    Returns an array containing the languagerobo116 name abbreviations for the
    preferred interface languages user chose for KDE session in Region &
    preferred interface languages user chose for KDE session in Region &
    Line 1,627: Line 1,641:
    list (array) with user languages in the order of preference.
    list (array) with user languages in the order of preference.


    == Misc/wantRightButton ==
    === wantRightButton ===
    The right click menu of SuperKaramba allows themes
    The right click menu of SuperKaramba allows themes
    to be loaded, closed, moved to other screens.
    to be loaded, closed, moved to other screens.
    Line 1,641: Line 1,655:
    true if successful
    true if successful


    == RichText/changeRichText ==
    == Rich Text ==
     
    === changeRichText ===
    This will change the contents of a rich text meter. richText is the
    This will change the contents of a rich text meter. richText is the
    reference to the text object to change that you saved from the
    reference to the text object to change that you saved from the
    Line 1,649: Line 1,665:
    text fields can display HTML code embedded in your text.
    text fields can display HTML code embedded in your text.


    == In a <a href="command"> ... </a> tag command is executed if the link is==
    === In a <a href="command"> ... </a> tag command is executed if the link is===
    click with the left mouse button.
    click with the left mouse button.
    Except if command starts with an '#' (ie: href="#value" ) the callback
    Except if command starts with an '#' (ie: href="#value" ) the callback
    Line 1,664: Line 1,680:
    true if successful
    true if successful


    == RichText/changeRichTextFont ==
    === changeRichTextFont ===
    This will change the font of a richtext meter.
    This will change the font of a richtext meter.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,675: Line 1,691:
    1 if successful
    1 if successful


    == RichText/changeRichTextSize ==
    === changeRichTextSize ===
    Sets the font size of a richtext meter.
    Sets the font size of a richtext meter.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,686: Line 1,702:
    true if successful
    true if successful


    == RichText/createRichText ==
    === createRichText ===
    This creates creates a new rich text meter. underlineLinks is a boolean that
    This creates creates a new rich text meter. underlineLinks is a boolean that
    determines if html links will be automatically underlined so that the
    determines if html links will be automatically underlined so that the
    Line 1,695: Line 1,711:
    text fields can display HTML code embedded in your text.
    text fields can display HTML code embedded in your text.


    == In a <a href="command"> ... </a> tag command is executed if the link is==
    === In a <a href="command"> ... </a> tag command is executed if the link is===
    click with the left mouse button.
    click with the left mouse button.
    Except if command starts with an '#' (ie: href="#value" ) the callback
    Except if command starts with an '#' (ie: href="#value" ) the callback
    Line 1,710: Line 1,726:
    reference to new richtext meter
    reference to new richtext meter


    == RichText/deleteRichText ==
    === deleteRichText ===
    This removes the rich text from the widget. Please do not call
    This removes the rich text from the widget. Please do not call
    functions on "text" after calling deleteRichText, as it does not exist
    functions on "text" after calling deleteRichText, as it does not exist
    Line 1,722: Line 1,738:
    true if successful
    true if successful


    == RichText/getRichTextFont ==
    === getRichTextFont ===
    Gets the font name of a richtext meter.
    Gets the font name of a richtext meter.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,732: Line 1,748:
    font name
    font name


    == RichText/getRichTextFontSize ==
    === getRichTextFontSize ===
    Gets the font size of the richtext meter.
    Gets the font size of the richtext meter.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,742: Line 1,758:
    font point size
    font point size


    == RichText/getRichTextPos ==
    === getRichTextPos ===
    Given a reference to a richtext object, this will return an array
    Given a reference to a richtext object, this will return an array
    containing the x and y coordinate of a richtext object.
    containing the x and y coordinate of a richtext object.
    Line 1,753: Line 1,769:
    x and y coordinates
    x and y coordinates


    == RichText/getRichTextSensor ==
    === getRichTextSensor ===
    Gets the current sensor string
    Gets the current sensor string
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,763: Line 1,779:
    current sensor string
    current sensor string


    == RichText/getRichTextSize ==
    === getRichTextSize ===
    Given a reference to a richtext object, this will return a tuple
    Given a reference to a richtext object, this will return a tuple
    containing the height and width of a richtext object.
    containing the height and width of a richtext object.
    Line 1,774: Line 1,790:
    width and height of the richtext
    width and height of the richtext


    == RichText/getRichTextValue ==
    === getRichTextValue ===
    Returns the current richtext value.
    Returns the current richtext value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,784: Line 1,800:
    text that is displayed in the rich text
    text that is displayed in the rich text


    == RichText/getThemeRichText ==
    === getThemeRichText ===
    You can reference richtext in your python code that was created in the
    You can reference richtext in your python code that was created in the
    theme file. Basically, you just add a NAME= value to the GRAPH line in
    theme file. Basically, you just add a NAME= value to the GRAPH line in
    Line 1,799: Line 1,815:
    reference to richtext
    reference to richtext


    == RichText/hideRichText ==
    === hideRichText ===
    This hides the richtext. In other words, during subsequent calls to
    This hides the richtext. In other words, during subsequent calls to
    widgetUpdate(), this richtext will not be drawn.
    widgetUpdate(), this richtext will not be drawn.
    Line 1,810: Line 1,826:
    true if successful
    true if successful


    == RichText/moveRichText ==
    === moveRichText ===
    This moves the rich text to a new x, y relative to your widget. In other
    This moves the rich text to a new x, y relative to your widget. In other
    words, (0,0) is the top corner of your widget, not the screen.
    words, (0,0) is the top corner of your widget, not the screen.
    Line 1,823: Line 1,839:
    true if successful
    true if successful


    == RichText/resizeRichText ==
    === resizeRichText ===
    This will resize richtext to the new height and width.
    This will resize richtext to the new height and width.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,835: Line 1,851:
    true if successful
    true if successful


    == RichText/setRichTextSensor ==
    === setRichTextSensor ===
    Sets a new sensor string
    Sets a new sensor string
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,846: Line 1,862:
    true if successful
    true if successful


    == RichText/setRichTextWidth ==
    === setRichTextWidth ===
    Given a reference to a rich text object, this function changes it's width
    Given a reference to a rich text object, this function changes it's width
    to the specified value in pixels.
    to the specified value in pixels.
    Line 1,860: Line 1,876:
    true if successful
    true if successful


    == RichText/showRichText ==
    === showRichText ===
    This shows the richtext. In other words, during subsequent calls to
    This shows the richtext. In other words, during subsequent calls to
    widgetUpdate(), this richtext will be drawn.
    widgetUpdate(), this richtext will be drawn.
    Line 1,871: Line 1,887:
    true if successful
    true if successful


    == Task/getStartupInfo ==
    == Task ==
     
    === getStartupInfo ===
    This returns all of the info about a certain starting task in the form of
    This returns all of the info about a certain starting task in the form of
    a list. Widget is a reference to the current widget. task is a
    a list. Widget is a reference to the current widget. task is a
    Line 1,888: Line 1,906:
    * 3 = A reference back to the task you got info on
    * 3 = A reference back to the task you got info on


    == Task/getStartupList ==
    === getStartupList ===
    This returns a list with references to all the current
    This returns a list with references to all the current
    windows that are in the process of loading on this system. You can then
    windows that are in the process of loading on this system. You can then
    Line 1,899: Line 1,917:
    list with references to startups
    list with references to startups


    == Task/getTaskInfo ==
    === getTaskInfo ===
    This returns all of the info about a certain task in the form of a  
    This returns all of the info about a certain task in the form of a  
    list. widget is a reference to the current widget. Task is a reference to
    list. widget is a reference to the current widget. Task is a reference to
    Line 1,922: Line 1,940:
    * 8 = A reference back to the task you got info on
    * 8 = A reference back to the task you got info on


    == Task/getTaskList ==
    === getTaskList ===
    This returns a list with references to all the current
    This returns a list with references to all the current
    windows open on this system. You can then call performTaskActionrobo155() or
    windows open on this system. You can then call performTaskActionrobo155() or
    Line 1,933: Line 1,951:
    list with references to the tasks
    list with references to the tasks


    == Task/getTaskNames ==
    === getTaskNames ===
    This returns a list containing the String names of all open
    This returns a list containing the String names of all open
    windows on the system. This is for convience if you want to list open
    windows on the system. This is for convience if you want to list open
    Line 1,945: Line 1,963:
    list with task names
    list with task names


    == Task/performTaskAction ==
    === performTaskAction ===
    This peforms the given action on a task object. widget is a reference to
    This peforms the given action on a task object. widget is a reference to
    the current widget. Task is a reference to a task object you got from
    the current widget. Task is a reference to a task object you got from
    Line 1,957: Line 1,975:
    * 6 = Raise the window
    * 6 = Raise the window
    * 7 = Lower the window
    * 7 = Lower the window
     
    * 8 = Smart Focus/Minimize - This will what the KDE taskbar does when you
    == * 8 = Smart Focus/Minimize - This will what the KDE taskbar does when you==
    click on a window. If it is iconified, raise it. If it has focus,
    click on a window. If it is iconified, raise it. If it has focus,
    iconify it.
    iconify it.
    Line 1,972: Line 1,989:
    boolean if successful
    boolean if successful


    == Text/changeText ==
    == Text ==
     
    === changeText ===
    This will change the contents of a text widget.
    This will change the contents of a text widget.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 1,983: Line 2,002:
    true if successful
    true if successful


    == Text/changeTextColor ==
    === changeTextColor ===
    This will change the color of a text widget (only ones you created
    This will change the color of a text widget (only ones you created
    through python currently). textToChange is the reference to the text
    through python currently). textToChange is the reference to the text
    Line 1,999: Line 2,018:
    true if successful
    true if successful


    == Text/changeTextFont ==
    === changeTextFont ===
    This will change the font of a text widget (only ones you created
    This will change the font of a text widget (only ones you created
    through python currently). Text is the reference to the text
    through python currently). Text is the reference to the text
    Line 2,013: Line 2,032:
    true if successful
    true if successful


    == Text/changeTextShadow ==
    === changeTextShadow ===
    This will change the shadow size of a text widget (only ones you
    This will change the shadow size of a text widget (only ones you
    created through python currently). textToChange is the reference to the
    created through python currently). textToChange is the reference to the
    Line 2,028: Line 2,047:
    true if successful
    true if successful


    == Text/changeTextSize ==
    === changeTextSize ===
    This will change the font size of a text widget (only ones you created
    This will change the font size of a text widget (only ones you created
    through python currently). text is the reference to the text
    through python currently). text is the reference to the text
    Line 2,042: Line 2,061:
    true if successful
    true if successful


    == Text/createText ==
    === createText ===
    This creates a new text at x, y with width and height w, h. You need to save
    This creates a new text at x, y with width and height w, h. You need to save
    the return value of this function to call other functions on your text
    the return value of this function to call other functions on your text
    Line 2,058: Line 2,077:
    Pointer to new text meter
    Pointer to new text meter


    == Text/deleteText ==
    === deleteText ===
    This removes a text object from the widget. Please do not call functions on
    This removes a text object from the widget. Please do not call functions on
    "text" after calling deleteText, as it does not exist anymore and that
    "text" after calling deleteText, as it does not exist anymore and that
    Line 2,070: Line 2,089:
    true if successful
    true if successful


    == Text/getTextAlign ==
    === getTextAlign ===
    Gets the current text alignment.
    Gets the current text alignment.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,080: Line 2,099:
    LEFT, CENTER or RIGHT as string
    LEFT, CENTER or RIGHT as string


    == Text/getTextColor ==
    === getTextColor ===
    Gets the current text color
    Gets the current text color
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,090: Line 2,109:
    (red, green, blue)
    (red, green, blue)


    == Text/getTextFont ==
    === getTextFont ===
    Gets the current text font name
    Gets the current text font name
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,100: Line 2,119:
    font name
    font name


    == Text/getTextFontSize ==
    === getTextFontSize ===
    Gets the current text font size.
    Gets the current text font size.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,110: Line 2,129:
    text font size
    text font size


    == Text/getTextPos ==
    === getTextPos ===
    Given a reference to a text object, this will return an array
    Given a reference to a text object, this will return an array
    containing the x and y coordinate of the text object.
    containing the x and y coordinate of the text object.
    Line 2,121: Line 2,140:
    x and y coordinate
    x and y coordinate


    == Text/getTextSensor ==
    === getTextSensor ===
    Gets the current sensor string
    Gets the current sensor string
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,131: Line 2,150:
    currently used sensor string
    currently used sensor string


    == Text/getTextShadow ==
    === getTextShadow ===
    Gets the current shadow offset
    Gets the current shadow offset
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,141: Line 2,160:
    shadow offset
    shadow offset


    == Text/getTextSize ==
    === getTextSize ===
    Given a reference to a text object, this will return an array
    Given a reference to a text object, this will return an array
    containing the height and width of a text object.
    containing the height and width of a text object.
    Line 2,152: Line 2,171:
    height and width of the text
    height and width of the text


    == Text/getTextValue ==
    === getTextValue ===
    Returns there current text value.
    Returns there current text value.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,162: Line 2,181:
    value
    value


    == Text/getThemeText ==
    === getThemeText ===
    You can reference text in your python code that was created in the
    You can reference text in your python code that was created in the
    theme file. Basically, you just add a NAME= value to the TEXT line in
    theme file. Basically, you just add a NAME= value to the TEXT line in
    Line 2,177: Line 2,196:
    reference to text
    reference to text


    == Text/hideText ==
    === hideText ===
    Hides text that is visible. You need to call redrawWidgetrobo182() afterwords
    Hides text that is visible. You need to call redrawWidgetrobo182() afterwords
    to actually hiderobo115 the text on screen.
    to actually hiderobo115 the text on screen.
    Line 2,188: Line 2,207:
    true if successful
    true if successful


    == Text/moveText ==
    === moveText ===
    This moves a text object to a new x, y relative to your widget. In other
    This moves a text object to a new x, y relative to your widget. In other
    words, (0,0) is the top corner of your widget, not the screen.
    words, (0,0) is the top corner of your widget, not the screen.
    Line 2,201: Line 2,220:
    true if successful
    true if successful


    == Text/resizeText ==
    === resizeText ===
    This will resize text to the new height and width.
    This will resize text to the new height and width.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,213: Line 2,232:
    true if successful
    true if successful


    == Text/setTextAlign ==
    === setTextAlign ===
    Sets the text label align.
    Sets the text label align.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,224: Line 2,243:
    true if successful
    true if successful


    == Text/setTextSensor ==
    === setTextSensor ===
    Sets a new sensor string
    Sets a new sensor string
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,235: Line 2,254:
    true if successful
    true if successful


    == Text/showText ==
    === showText ===
    Shows text that has been hidden with hideTextrobo173().
    Shows text that has been hidden with hideTextrobo173().
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,245: Line 2,264:
    true if successful
    true if successful


    == Widget/createWidgetMask ==
    == Widget ==
     
    === createWidgetMask ===
    This function doesn't work currently due to a bug in KDE. Please use
    This function doesn't work currently due to a bug in KDE. Please use
    MASK= in your .theme file for the time being.
    MASK= in your .theme file for the time being.
    Line 2,258: Line 2,279:
    true if successful
    true if successful


    == Widget/getWidgetPosition ==
    === getWidgetPosition ===
    Returns an array containing the x and y position of you widget.
    Returns an array containing the x and y position of you widget.
    widget is a reference to the current widget.
    widget is a reference to the current widget.
    Line 2,268: Line 2,289:
    position of the widget
    position of the widget


    == Widget/moveWidget ==
    === moveWidget ===
    Moves the widget to the new screen location.
    Moves the widget to the new screen location.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,279: Line 2,300:
    true if successful
    true if successful


    == Widget/redrawWidget ==
    === redrawWidget ===
    This is THE most important function. After you do a bunch of other calls
    This is THE most important function. After you do a bunch of other calls
    (moving images, adding images or text, etc), you call this to update the
    (moving images, adding images or text, etc), you call this to update the
    Line 2,291: Line 2,312:
    true if successful
    true if successful


    == Widget/redrawWidgetBackground ==
    === redrawWidgetBackground ===
    Redraws the widget background.
    Redraws the widget background.
    WARNING
    WARNING
    Line 2,302: Line 2,323:
    true if successful
    true if successful


    == Widget/resizeWidget ==
    === resizeWidget ===
    Resizes the widget to the new width and height.
    Resizes the widget to the new width and height.
    <br><br>'''Synopsis:'''<br>  
    <br><br>'''Synopsis:'''<br>  
    Line 2,313: Line 2,334:
    true if successful
    true if successful


    == Widget/toggleWidgetRedraw ==
    === toggleWidgetRedraw ===
    Toggles widget redraw.
    Toggles widget redraw.
    This function does nothing in SuperKaramba 0.50 and later
    This function does nothing in SuperKaramba 0.50 and later

    Revision as of 18:49, 28 April 2007

    SuperKaramba API

    Bar

    createBar

    This creates a bar at x, y with width and height w, h.

    Synopsis:
    reference createBar(widget, x, y, w, h, image)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • string image -- Path to image


    Return Value:
    Reference to new bar meter

    deleteBar

    This deletes the bar.

    Synopsis:
    boolean deleteBar(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    true if successful

    getBarImage

    Get the path to the bar image.

    Synopsis:
    string getBarImage(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    path to bar image

    getBarMinMax

    Returns possible min and max values of the bar.

    Synopsis:
    array getBarMinMax(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference bar -- bar


    Return Value:
    array with max & min values

    getBarPos

    Given a reference to a bar object, this will return a array containing the x and y coordinate of a bar object.

    Synopsis:
    array getBarPos(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    array with x and y coordinates

    getBarSensor

    Gets the current sensor string.

    Synopsis:
    string getBarSensor(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    sensor string

    getBarSize

    Given a reference to a bar object, this will return a array containing the height and width of the bar object.

    Synopsis:
    array getBarSize(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    array with width and height

    getBarValue

    Returns current bar value.

    Synopsis:
    integer getBarValue(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    value

    getBarVertical

    Check if bar is a vertical bar.

    Synopsis:
    boolean getBarVertical(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    true if vertical

    getThemeBar

    You can reference a bar in your python code that was created in the theme file. Basically, you just add a NAME= value to the BAR line in the .theme file. Then if you want to use that object, instead of calling createBarrobo0, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    reference getThemeBar(widget, name)

    Arguments:

    • reference to widget -- karamba
    • string name -- name of the bar in the theme file


    Return Value:
    reference to bar

    hideBar

    This hides an bar. In other words, during subsequent calls to widgetUpdate(), this bar will not be drawn.

    Synopsis:
    boolean hideBar(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    true if successful

    moveBar

    This will move the bar to new x and y coordinates.

    Synopsis:
    boolean moveBar(widget, bar, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    boolean (true if successful)

    resizeBar

    This will resize bar to new height and width.

    Synopsis:
    boolean resizeBar(widget, bar, w, h)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • integer w -- new width
    • integer h -- new height


    Return Value:
    true if successful

    setBarImage

    Use the image in path for the background as the bar

    Synopsis:
    boolean setBarImage(widget, bar, image)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • string image -- path to the new image


    Return Value:
    true if successful

    setBarMinMax

    Returns current bar value.

    Synopsis:
    boolean setBarMinMax(widget, bar, min, max)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • integer min -- min value
    • integer max -- max value


    Return Value:
    true if successful

    setBarSensor

    Sets the sensor string of the bar.

    Synopsis:
    boolean setBarSensor(widget, bar, sensor)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • string sensor -- new sensor string as in theme files


    Return Value:
    true if successful

    setBarValue

    Sets current bar value.

    Synopsis:
    reference setBarValue(widget, bar, value)

    Arguments:

    • long widget -- karamba
    • long bar -- pointer to bar
    • long value -- new value


    Return Value:
    reference to bar

    setBarVertical

    Set bar vertical

    Synopsis:
    boolean setBarVertical(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar
    • boolean vertical -- true to draw the bar vertically


    Return Value:
    true if successful

    showBar

    This shows an bar. In other words, during subsequent calls to widgetUpdate(), this bar will be drawn.

    Synopsis:
    boolean showBar(widget, bar)

    Arguments:

    • reference to widget -- karamba
    • reference to bar -- bar


    Return Value:
    true if successful


    Config

    addMenuConfigOption

    SuperKaramba supports a simplistic configuration pop-up menu. This menu appears when you right-click on a widget and choose Configure Theme. Basically, it allows you to have check-able entries in the menu to allow the user to enable or disable features in your theme. Before you use any configuration menu stuff, you NEED to add a new callback to your script: def menuOptionChanged(widget, key, value): This will get called whenever a config menu option is changed. Now you can add items to the config menu: addMenuConfigOption(widget, String key, String name) Key is the name of a key value where the value will be saved automatically into the widget's config file. Name is the actual text that will showrobo126 up in the config menu. For example, I could allow the user to enable or disable a clock showing up in my theme: karamba.addMenuConfigOption(widget, "showclock", "Display a clock")

    Synopsis:
    boolean addMenuConfigOption(widget, key, name)

    Arguments:

    • reference to widget -- karamba
    • string key -- key for menu item
    • string name -- name of the graph to get


    Return Value:
    true if successful

    readConfigEntry

    This function reads an entry from the config file with the given key.

    Synopsis:
    string readConfigEntry(widget, key, value)

    Arguments:

    • reference to widget -- karamba
    • string key -- key for config item


    Return Value:
    config value for key

    readMenuConfigOption

    This returns whether or not the given option is checked in the theme's Configure Theme menu. See addMenuConfigOptionrobo19 for a more detailed explanation.

    Synopsis:
    boolean readMenuConfigOption(widget, key)

    Arguments:

    • reference to widget -- karamba
    • string key -- key for menu item


    Return Value:
    false is returned if it is not checked and true is returned if it is.

    setMenuConfigOption

    This sets whether or not the given option is checked in the theme's Configure Theme menu. Value should be false if key should not be checked and true if key should be checked. See addMenuConfigOptionrobo19 for a more detailed explanation.

    Synopsis:
    boolean setMenuConfigOption(widget, key, value)

    Arguments:

    • referencce to widget -- karamba
    • string key -- key for menu item
    • boolean value -- true for checked


    Return Value:
    true if successful

    writeConfigEntry

    SuperKaramba automatically supports configuration files for each theme. These files will be saved in /your/home/dir/.superkaramba/ and will be named themenamerc where themename is the name of the theme. This function writes an entry into the config file with the given key and value. For example, to save my favorite color, I would do karamba.writeConfigEntry(widget, "FavColor", "Red")

    Synopsis:
    boolean writeConfigEntry(widget, key, value)

    Arguments:

    • reference to widget -- karamba
    • string key -- key for config item
    • string value -- config value


    Return Value:
    true if successful

    Graph

    createGraph

    This creates a graph at x, y with width and height.

    Synopsis:
    reference createGraph(widget, x, y, width, height, points)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • integer points -- Number of points in graph


    Return Value:
    reference to new graph meter

    deleteGraph

    This deletes graph.

    Synopsis:
    boolean deleteGraph(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    true if successful

    getGraphColor

    Gets the current graph color components.

    Synopsis:
    array getGraphColor(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    (red, green, blue)

    getGraphMinMax

    Returns current graph minimal and maximal values.

    Synopsis:
    array getGraphMinMax(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    max and min values

    getGraphPos

    Given a reference to a graph object, this will return an array containing the x and y coordinates of the graph object.

    Synopsis:
    array getGraphPos(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    x and y coordinates

    getGraphSensor

    Gets the current sensor string of the graph.

    Synopsis:
    string getGraphSensor(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    sensor string

    getGraphSize

    Given a reference to a graph object, this will return an array containing the height and width of a graph object.

    Synopsis:
    array getGraphSize(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    width and height of the graph

    getGraphValue

    Returns current graph value.

    Synopsis:
    integer getGraphValue(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    value

    getThemeGraph

    You can reference graph in your python code that was created in the theme file. Basically, you just add a NAME= value to the GRAPH line in the .theme file. Then if you want to use that object, instead of calling createGraphrobo24, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    reference getThemeGraph(widget, name)

    Arguments:

    • reference to widget -- karamba
    • string name -- name of the graph in the theme file


    Return Value:
    reference to graph

    hideGraph

    This hides a graph. In other words, during subsequent calls to widgetUpdate(), this graph will not be drawn.

    Synopsis:
    boolean hideGraph(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    true if successful

    moveGraph

    This will move the graph to the new x and y coordinates.

    Synopsis:
    boolean moveGraph(widget, graph, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    resizeGraph

    This will resize graph to new height and width.

    Synopsis:
    boolean resizeGraph(widget, graph, width, height)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph
    • integer width -- new width
    • integer height -- new height


    Return Value:
    true if successful

    setGraphColor

    Sets current graph color.

    Synopsis:
    boolean setGraphColor(widget, graph, red, green, blue)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- pointer to graph
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    setGraphMinMax

    Sets the graphs min and max values.

    Synopsis:
    boolean setGraphMinMax(widget, graph, min, max)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph
    • integer min -- min value
    • integer max -- max value


    Return Value:
    true if successful

    setGraphSensor

    Sets current sensor string of the graph.

    Synopsis:
    boolean setGraphSensor(widget, graph, sensor)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph
    • string sensor -- new sensor string as in theme files


    Return Value:
    true if successful

    setGraphValue

    Sets current graph value.

    Synopsis:
    reference setGraphValue(widget, graph, value)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph
    • integer value -- new value


    Return Value:
    reference to graph

    showGraph

    This shows a graph. In other words, during subsequent calls to widgetUpdate(), this graph will be drawn.

    Synopsis:
    boolean showGraph(widget, graph)

    Arguments:

    • reference to widget -- karamba
    • reference to graph -- graph


    Return Value:
    true if successful

    Image

    addImageTooltip

    This creats a tooltip for image with text. Note:

    • If you move the image, the tooltip does not move! It stays! Do not

    create a tooltip if the image is off-screen because you will not be able to ever see it.

    Synopsis:
    boolean addImageTooltip(widget, image, text)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • string text -- tooltip text


    Return Value:
    true if successful

    changeImageChannelIntensity

    Changes the "intensity" of the image color channel, which is similar to it's brightness.

    Synopsis:
    boolean changeImageChannelIntensity(widget, image, ratio, channel, millisec)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • decimal ratio -- -1.0 to 1.0 (dark to bright)
    • string channel -- color channel (red|green|blue)
    • integer millisec -- milliseconds before the image is restored (optional)


    Return Value:
    true if successful

    changeImageIntensity

    Changes the "intensity" of the image, which is similar to it's brightness. ratio is a floating point number from -1.0 to 1.0 that determines how much to brighten or darken the image. Millisec specifies how long in milliseconds before the image is restored to it's original form. This is useful for "mouse over" type animations. Using 0 for millisec disables this feature and leaves the image permanently affected.

    Synopsis:
    boolean changeImageIntensity(widget, image, ratio, millisec)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • decimal ratio -- -1.0 to 1.0 (dark to bright)
    • integer millisec -- milliseconds before the image is restored (optional)


    Return Value:
    true if successful

    changeImageToGray

    Turns the given image into a grayscale image. Millisec specifies how long in milliseconds before the image is restored to it's original form. This is useful for "mouse over" type animations. Using 0 for millisec disables this feature and leaves the image permanently affected.

    Synopsis:
    boolean changeImageToGray(widget, image, millisec)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • integer millisec -- milliseconds before the image is restored (optional)


    Return Value:
    1 if successful

    createBackgroundImage

    This creates an background image on your widget at x, y. The filename should be given as the path parameter. In theory the image could be local or could be a url. It works just like adding an image in your theme file. You will need to save the return value to be able to call other functions on your image, such as moveImagerobo57()

    Synopsis:
    reference createBackgroundImage(widget, x, y, w, h, image)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • string image -- path to the image for the background


    Return Value:
    reference to new image meter

    createImage

    This creates an image on your widget at x, y. The filename should be given as the path parameter. In theory the image could be local or could be a url. It works just like adding an image in your theme file. You will need to save the return value to be able to call other functions on your image, such as moveImagerobo57()

    Synopsis:
    reference createImage(widget, x, y, image)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • string image -- image for the imagelabel


    Return Value:
    reference to new image meter

    createTaskIcon

    This creates a task image at x, y.

    Synopsis:
    reference createTaskIcon(widget, x, y, ctask)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer task -- task


    Return Value:
    reference to new image meter

    deleteImage

    This removes the image from the widhet. Please do not call functions on "image" after calling deleteImage, as it does not exist anymore and that could cause crashes in some cases.

    Synopsis:
    boolean deleteImage(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    true if successful

    getImageHeight

    This returns the height of an image. This is useful if you have rotated an image and its size changed, so you do not know how big it is anymore.

    Synopsis:
    integer getImageHeight(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    height of the image

    getImagePath

    Returns the current image path.

    Synopsis:
    string getImagePath(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    path

    getImagePos

    Given a reference to a image object, this will return a tuple containing the x and y coordinate of a image object.

    Synopsis:
    array getImagePos(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    x and y coordinates of the image

    getImageSensor

    Gets the current sensor string.

    Synopsis:
    string getImageSensor(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    sensor string

    getImageSize

    Given a reference to a image object, this will return an array containing the height and width of a image object.

    Synopsis:
    array getImageSize(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    height and width of the image

    getImageWidth

    This returns the width of an image. This is useful if you have rotated an image and its size changed, so you do not know how big it is anymore.

    Synopsis:
    integer getImageWidth(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    width of the image

    getThemeImage

    You can reference an image in your python code that was created in the .theme file. Basically, you just add a NAME= value to the IMAGE line in the .theme file. Then if you want to use that object, instead of calling createImagerobo46, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    long getThemeImage(widget, name)

    Arguments:

    • reference to widget -- karamba
    • string name -- name of the image in the theme files


    Return Value:
    reference to image

    hideImage

    This hides an image. In other words, during subsequent calls to widgetUpdate(), this image will not be drawn.

    Synopsis:
    boolean hideImage(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    true if successful

    moveImage

    This moves an image to a new x, y relative to your widget. In other words, (0,0) is the top corner of your widget, not the screen. The imageToMove parameter is a reference to the image to move that you saved as the return value from createImagerobo46()

    Synopsis:
    boolean moveImage(widget, image, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    removeImageEffects

    If you have called image effect commands on your image (ex: changeImageIntensityrobo43), you can call this to restore your image to it's original form.

    Synopsis:
    boolean removeImageEffects(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    true if successful

    removeImageTransformations

    If you have rotated or resized your image, you can call this function to restore your image to its original form.

    Synopsis:
    boolean removeImageTransformations(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    true if successful

    resizeImage

    This resizes your image to width, height. The image parameter is a reference to an image that you saved as the return value from createImagerobo46()

    Synopsis:
    boolean resizeImage(widget, image, w, h)

    Arguments:

    • reference widget -- karamba
    • reference image -- image
    • integer w -- width
    • integer h -- height


    Return Value:
    true if successful

    resizeImageSmooth

    DEPRECATED: resizeImagerobo60 now allows the user to pick whether to use fast or smooth resizing from the SuperKaramba menu - This resizes your image to width, height. The imageToResize parameter is a reference to an image that you saved as the return value from createImagerobo46() In version 0.50 and later this function works exactly as resizeImagerobo60().

    Synopsis:
    boolean resizeImageSmooth(widget, image, w, h)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • integer w -- width
    • integer h -- height


    Return Value:
    true if successful

    rotateImage

    This rotates your image to by the specified amount of degrees. The The image parameter is a reference to an image that you saved as the return value from createImagerobo46()

    Synopsis:
    long rotateImage(widget, image, deg)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • integer deg -- degrees to rotate


    Return Value:
    true if successful

    setImagePath

    This will change image of a image widget.

    Synopsis:
    reference setImagePath(widget, image, path)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • string path -- new path of the image


    Return Value:
    reference to the image

    setImageSensor

    Sets the current sensor string.

    Synopsis:
    long setImageSensor(widget, image, sensor)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image
    • string sensor -- new sensor string as in theme files


    Return Value:
    true if successful

    showImage

    This shows a previously hidden image. It does not actually refresh the image on screen. That is what redrawWidgetrobo182() does.

    Synopsis:
    boolean showImage(widget, image)

    Arguments:

    • reference to widget -- karamba
    • reference to image -- image


    Return Value:
    true if successful


    Input Box

    changeInputBox

    This function will change the contents of a input box widget.

    Synopsis:
    reference changeInputBox(widget, inputBox, value)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • string value -- new text of the input box


    Return Value:
    reference to input box

    changeInputBoxBackgroundColor

    This will change the background color of a Input Box widget. InputBox is the reference to the text object to change r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    reference changeInputBoxBackgroundColor(widget, inputBox, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    changeInputBoxFont

    This will change the font of a Input Box widget. InputBox is the reference to the Input Box object to change. Font is a string with the name of the font to use.

    Synopsis:
    boolean changeInputBoxFont(widget, inputBox, font)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- inputBox
    • string font -- font name


    Return Value:
    true if successful

    changeInputBoxFontColor

    This will change the color of a text of a Input Box widget. InputBox is the reference to the text object to change r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    boolean changeInputBoxFontColor(widget, inputBox, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    changeInputBoxFontSize

    This will change the font size of a Input Box widget. InputBox is the reference to the text object to change. Size is the new font point size.

    Synopsis:
    boolean changeInputBoxFontSize(widget, text, size)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer size -- new font size for text


    Return Value:
    true if successful

    changeInputBoxFrameColor

    This will change the frame color of a Input Box widget. InputBox is the reference to the text object to change r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    boolean changeInputBoxFrameColor(widget, inputBox, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    changeInputBoxSelectedTextColor

    This will change the selected text color of a Input Box widget. InputBox is the reference to the text object to change r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    boolean changeInputBoxSelectedTextColor(widget, inputBox, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    changeInputBoxSelectionColor

    This will change the color of the selection of a Input Box widget. InputBox is the reference to the text object to change r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    boolean changeInputBoxSelectionColor(widget, inputBox, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    clearInputFocus

    Releases the input focus from the Input Box.

    Synopsis:
    boolean clearInputFocus(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- pointer to Input Box


    Return Value:
    true if successful

    createInputBox

    This creates a new Input Box at x, y with width and height w, h. You need to save the return value of this function to call other functions on your Input Box field, such as changeInputBoxrobo66(). The karamba widget is automatically set active, to allow user interactions.

    Synopsis:
    reference createInputBox(widget, x, y, w, h, text)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • string text -- text for the Input Box


    Return Value:
    reference to new Input Box

    deleteInputBox

    This removes the Input Box object from the widget. Please do not call functions of the Input Box after calling deleteInputBox, as it does not exist anymore and that could cause crashes in some cases. The karamba widget ist automatically set passive, when no more Input Boxes are on the karamba widget.

    Synopsis:
    boolean deleteInputBox(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference widget -- InputBox


    Return Value:
    true if successful

    getInputBoxBackgroundColor

    Gets the current background color of a Input Box

    Synopsis:
    array getInputBoxBackgroundColor(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    (red, green, blue)

    getInputBoxFont

    Gets the current Input Box font name

    Synopsis:
    string getInputBoxFont(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    font name

    getInputBoxFontColor

    Gets the current text color of a Input Box

    Synopsis:
    array getInputBoxFontColor(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    (red, green, blue)

    getInputBoxFontSize

    Gets the current text font size.

    Synopsis:
    integer getInputBoxFontSize(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    text font size

    getInputBoxFrameColor

    Gets the current frame color of a Input Box

    Synopsis:
    array getInputBoxFrameColor(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    (red, green, blue)

    getInputBoxPos

    Given a reference to a Input Box object, this will return an array containing the x and y coordinate of an Input Box.

    Synopsis:
    array getInputBoxPos(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    x and y coordinates of the inputBox

    getInputBoxSelectedTextColor

    Gets the current selected text color of a Input Box.

    Synopsis:
    array getInputBoxSelectedTextColor(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- pointer to Input Box


    Return Value:
    (red, green, blue)

    getInputBoxSelectionColor

    Gets the current selection color of a Input Box

    Synopsis:
    array getInputBoxSelectionColor(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    (red, green, blue)

    getInputBoxSize

    Given a reference to a Input Box object, this will return an array containing the height and width of a Input Box object.

    Synopsis:
    array getInputBoxSize(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    width and hight of the input box

    getInputBoxValue

    Returns current Input Box text.

    Synopsis:
    string getInputBoxValue(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    input box text

    getInputFocus

    Gets the Input Box that is currently focused.

    Synopsis:
    boolean getInputFocus(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    the input box or 0

    getThemeInputBox

    You can reference text in your python code that was created in the theme file. Basically, you just add a NAME= value to the INPUT line in the .theme file. Then if you want to use that object, instead of calling createInputBoxrobo75, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    reference getThemeInputBox(widget, name)

    Arguments:

    • reference to widget -- karamba
    • string name -- name of the Input Box in the theme file


    Return Value:
    reference to Input Box

    hideInputBox

    Hides a Input Box that is visible.

    Synopsis:
    boolean hideInputBox(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    true if successful

    moveInputBox

    This moves a Input Box object to a new x, y relative to your widget. In other words, (0,0) is the top corner of your widget, not the screen.

    Synopsis:
    long moveInputBox(widget, inputBox, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    resizeInputBox

    This will resize Input Box to the new height and width.

    Synopsis:
    boolean resizeInputBox(widget, inputBox, w, h)

    Arguments:

    • reference to widget -- karamba
    • referenc to inputBox -- Input Box
    • integer w -- new width
    • integer h -- new height


    Return Value:
    true if successful

    setInputFocus

    Sets the input focus to the Input Box.

    Synopsis:
    boolean setInputFocus(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    true if successful

    showInputBox

    Shows Input Box that has been hidden with hideInputBoxrobo89()

    Synopsis:
    boolean showInputBox(widget, inputBox)

    Arguments:

    • reference to widget -- karamba
    • reference to inputBox -- Input Box


    Return Value:
    true if successful

    Menu

    addMenuItem

    This adds an entry to the given menu with label text and with given icon. Icon can be just an application name in which case the user's current icon set is used, or can be a path to a 16x16 png file. The function returns the reference to the menu item, which identifies that popup menu item uniquely among popupmenu items application-wide or returns 0 if the given menu doesn't exist.

    Synopsis:
    reference addMenuItem(widget, menu, text, icon)

    Arguments:

    • reference to widget -- karamba
    • reference to menu -- menu
    • string text -- text for menu item
    • string icon -- icon name or path


    Return Value:
    reference to the menu item

    addMenuSeparator

    This adds an menu separator to the given menu.

    Synopsis:
    reference addMenuSeparator(widget, menu)

    Arguments:

    • reference to widget -- karamba
    • reference to menu -- menu


    Return Value:
    reference to the separator

    createMenu

    This creates an empty popup menu and returns a reference to the menu.

    Synopsis:
    reference createMenu(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    reference to menu

    deleteMenu

    This deletes the referenced menu if that menu exists.

    Synopsis:
    boolean deleteMenu(widget, menu)

    Arguments:

    • reference to widget -- karamba
    • reference to menu -- pointer to menu


    Return Value:
    true if menu existed and was deleted, returns false otherwise.

    popupMenu

    This pops up the given menu at the given co-ordinates. The co-ordinates are relative to the widget, not the screen. You can use negative co-ordinates to make a menu appear to the right of or above your theme.

    Synopsis:
    boolean popupMenu(widget, menu, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to menu -- menu
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if the menu existed and was popped up, returns false otherwise.

    removeMenuItem

    This removes the menu if it exists.

    Synopsis:
    boolean removeMenuItem(widget, menu, id)

    Arguments:

    • reference to widget -- karamba
    • reference to menu -- pointer to menu
    • reference to menu item -- menu item


    Return Value:
    1 if the menu item existed and was removed or returns zero otherwise.

    Misc

    acceptDrops

    Calling this enables your widget to receive Drop events. In other words, the user will be able to drag icons from his/her desktop and drop them on your widget. The "itemDropped" callback is called as a result with the data about the icon that was dropped on your widget. This allows, for example, icon bars where items are added to the icon bar by Drag and Drop.

    Synopsis:
    boolean acceptDrops(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    attachClickArea

    It is possible to attach a clickarea to a meter (image or text field), which is moved and resized correctly if the meter is moved or resized. There is also a callback meterClicked(widget, meter, button) which is called whenever a meter is clicked (if something is attached to it). Given an Image or a TextLabel, this call makes it clickable. When a mouse click is detected, the callback meterClicked is called. lB, mB, and rB are strings that specify what command is executed when this meter is clicked with the left mouse button, middle mouse button, and right mouse button respectively. If given, the appropriate command is executed when the mouse click is received. The keyword arguments are all optional. If command is an empty string nothing is executed. For now the command given to RightButton has obviosly no effect (because that brings up the SuperKaramba menu).

    Synopsis:
    boolean attachClickArea(widget, meter, lB, mB, rB)

    Arguments:

    • reference to widget -- karamba
    • reference to meter -- meter
    • string lB -- command to left mouse button
    • string mB -- command to middle mouse button
    • string rB -- command to right mouse button


    Return Value:
    true if successful

    callTheme

    Calls a theme - identified by the pretty name - and passes it a string to it. This will work, despite superkaramba being multithreaded, because it uses the DBus interface to contact the other theme. If you need to pass complex arguments (dictionaries, lists etc.) then use the python "repr" and "eval" functions to marshall and unmarshall the data structure.

    Synopsis:
    boolean callTheme(widget, theme, info)

    Arguments:

    • reference to widget -- karamba
    • string theme -- pretty theme name
    • string info -- a string containing the info to be passed to the theme


    Return Value:
    true if successful

    changeInterval

    This function changes your widget's refresh rate (ms)

    Synopsis:
    boolean changeInterval(widget, interval)

    Arguments:

    • reference to widget -- karamba
    • integer interval -- interval, in ms


    Return Value:
    true if successful

    createClickArea

    This creates a clickable area at x, y with width and height w, h. When this area is clicked, cmd_to_run will be executed. The mouse will change over this area.

    Synopsis:
    reference createClickArea(widget, x, y, w, h, cmdToRun)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • string cmdToRun -- command to be runrobo123


    Return Value:
    reference to the new click area

    createServiceClickArea

    This creates a clickable area at x, y with width and height w, h. When this area is clicked, cmd_to_run will be executed. The mouse will change to the clickable icon when over this area. For more information on the difference between createClickArearobo104 and createServiceClickArea, see the KDE documentation about KService, and the difference between KRun::runrobo123 and KRun::runCommand.

    Synopsis:
    reference createServiceClickArea(widget, x, y, w, h, name_of_command, cmd_to_run, icon_to_display)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • string name_of_command -- name to be displayed
    • string cmd_to_run -- command to be runrobo123
    • string icon_to_display -- name of icon to be displayed


    Return Value:
    reference to the new click area

    execute

    This command simply executes a program or command on the system. This is just for convience (IE you could accomplish this directly through python, but sometimes threading problems crop up that way). The only option is a string containing the command to execute.

    Synopsis:
    integer execute(command)

    Arguments:

    • string command -- command to execute


    Return Value:
    process id of the executed command

    executeInteractive

    This command executes a program or command on the system. Additionally it allows you to get any text that the program outputs. Futhermore, it won't freeze up your widget while the command executes. To use it, call executeInteractive with the reference to your widget and a list of command options. The array is simply a list that contains the command as the first entry, and each option as a separate list entry. Output from the command is returned via the commandOutput callback. The command returns the process number of the command. This is useful if you want to runrobo123 more than one program at a time. The number will allow you to figure out which program is outputting in the commandOutput callback. Example: Run the command "ls -la *.zip" myCommand = ["ls", "-la", "*.zip"] karamba.executeInteractive(widget, myCommand)

    Synopsis:
    integer executeInteractive(widget, command)

    Arguments:

    • reference to widget -- karamba
    • list command -- command to executerobo106


    Return Value:
    process id of the executed command

    getIncomingData

    Obtains the last data received by any other theme that set the "incoming data" of this theme. This isn't particularly sophisticated and could benefit from the data being placed in an FIFO queue instead.

    Synopsis:
    string getIncomingData(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    string containing the last information received from setIncomingDatarobo124

    getIp

    Gets the current IP address of the interface_name interface.

    Synopsis:
    string getIp(widget, interface_name)

    Arguments:

    • reference to widget -- karamba
    • string interface_name -- name of the interface


    Return Value:
    ip address as string

    getNumberOfDesktop

    Returns number of desktops

    Synopsis:
    integer getNumberOfDesktop(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    number of desktops

    getPrettyThemeName

    When a theme is created (with openNamedThemerobo118), there is an option to give the theme an alternative name. This is useful if you open several widgets from the same theme: you need to give them unique names in order to contact them (for example, with callThemerobo102 or with setIncomingDatarobo124)

    Synopsis:
    string getPrettyName(theme)

    Arguments:

    • string theme -- path to new theme


    Return Value:
    the pretty name of the theme

    getServiceGroups

    This function returns a list of services and service groups that are in the user's KDE Menu. It is not a recursive function, so if there are submenus (service groups) in the returned results, you must call getServiceGroups with the path of the submenu in order to obtain the information in that submenu. The return result is complex: it's a list of tuples. The tuple contains two elements - a 1 if the second element is a service, and a 0 if it's a service group. The second element is a dictionary, with keys (if they exist) of caption, comment, icon, and relpath if it's a service group, and keys (if they exist) of exec, menuid, name, path, icon, library, comment, type and genericname. To fully understand the return results of this function,

    it is thoroughly recommended // that you look up the

    KDE documentation on KServiceGroup and KService.

    Synopsis:
    list getServiceGroups(widget, path)

    Arguments:

    • reference to widget -- karamba
    • string path -- path to the Service Group you wish to retrieve


    Return Value:
    List of Dictionaries of services and service groups

    getThemePath

    Returns a string containing the directory where your theme was loaded from.

    Synopsis:
    string getThemePath(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    path to theme

    getUpdateTime

    Returns the last stored update time. Intended for use so that the next refresh interval can work out how long ago the mouse was last moved over the widget.

    Synopsis:
    decimal getUpdateTime(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    last stored update time (from setUpdateTimerobo125)

    hide

    Hides the widget.

    Synopsis:
    boolean hide(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    language

    Returns a string containing the default language of a translation file.

    Synopsis:
    string language(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    default language or empty string if no translation files found.

    managementPopup

    The right click menu of SuperKaramba allows themes to be loaded, closed, moved to other screens. If you want this popup menu to appear, call this function.

    Synopsis:
    boolean managementPopup(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    openNamedTheme

    Opens a new theme, giving it a pretty (alternative and by your own choice _unique_) name. If you do not want the theme to be loaded when SuperKaramba is first started up (but instead want it to only be opened by this function call) then set is_sub_theme to 1. Themes opened with openNamedTheme will be unique. If a theme with the same pretty name already exists, openNamedTheme will have no effect. If you want duplicate themes (and a bit of a mess), use openThemerobo119, instead.

    Synopsis:
    reference openNamedTheme(theme, pretty_name, is_sub_theme)

    Arguments:

    • string theme -- path to new theme
    • string pretty_name -- the name to be associated with the new widget
    • boolean is_sub_theme -- sets persistence (save state) of the theme


    Return Value:
    reference to the new widget

    openTheme

    Opens a new theme.

    Synopsis:
    reference openTheme(theme)

    Arguments:

    • string theme -- path to theme that will be opened


    Return Value:
    reference to the new widget

    readThemeFile

    Returns a string with the contents of the theme file

    Synopsis:
    string readThemeFile(widget, file)

    Arguments:

    • reference to widget -- karamba
    • string file -- name of the file to read


    Return Value:
    file contents

    reloadTheme

    Reloads the current theme.

    Synopsis:
    boolean reloadTheme(theme)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    removeClickArea

    This function deletes a clickable area.

    Synopsis:
    boolean removeClickArea(widget, clickarea)

    Arguments:

    • reference to widget -- karamba
    • reference to clickarea -- click area


    Return Value:
    true if successful

    run

    This command simply executes a program or command on the system. The difference between run and executerobo106 is that run takes arguments, and the name of the icon to be displayed.

    Synopsis:
    boolean run(name, command, icon, list_of_args)

    Arguments:

    • string name -- name to be displayed
    • string command -- command to executerobo106
    • string icon -- name of icon to be displayed
    • string list_of_args -- arguments to be passed to the command


    Return Value:
    true if successful

    setIncomingData

    Contacts a theme - identified by the pretty name - and stores a string to be associated with the remote theme. The difference between setIncomingData and callThemerobo102 is that the theme is not notified by setIncomingData that the data has arrived. Previous information, if any, is overwritten. Use getIncomingDatarobo108 to retrieve the last stored information. setIncomingData is not very sophisticated, and could benefit from having info passed to it put into a queue, instead of being overwritten.

    Synopsis:
    boolean setIncomingData(widget, theme, info)

    Arguments:

    • reference to widget -- karamba
    • string theme -- path to theme to have information passed to it.
    • string info -- a string containing the info to be passed to the theme


    Return Value:
    true if successful

    setUpdateTime

    Sets the update time. Intended for use so that the next refresh interval can work out how long ago the mouse was last moved over the widget.

    Synopsis:
    boolean getUpdateTimerobo114(widget, updated_time)

    Arguments:

    • reference to widget -- karamba
    • integer updated_time -- the update time to be associated with the widget


    Return Value:
    true if successful

    show

    Shows the widget.

    Synopsis:
    boolean show(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    toggleShowDesktop

    This shows/hides the current desktop just like the Show Desktop button on kicker. Basically, it minimizes all the windows on the current desktop. Call it once to showrobo126 the desktop and again to hiderobo115 it.

    Synopsis:
    boolean toggleShowDesktop(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    translateAll

    Moves all widgets within a theme in a particular direction relative from the previous spot without moving the parent theme widget.

    Synopsis:
    boolean translateAll(widget, relative_x, relative_y)

    Arguments:

    • reference to widget -- karamba
    • integer translate_x -- move horizontally
    • integer translate_y -- move vertically


    Return Value:
    true if successful

    userLanguage

    Returns a string containing the global KDE user languagerobo116.

    Synopsis:
    string userLanguage(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    user languagerobo116 or empty string

    userLanguages

    Returns an array containing the languagerobo116 name abbreviations for the preferred interface languages user chose for KDE session in Region & Language settings. Having the whole array of preferred languages available is important for cases when you cannot provide interface translation for the 1st preferred languagerobo116, but can for consecutive languages. (Implemented in version 0.42.)

    Synopsis:
    array userLanguages(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    list (array) with user languages in the order of preference.

    wantRightButton

    The right click menu of SuperKaramba allows themes to be loaded, closed, moved to other screens. Not all themes will want the right click menu. Call karamba.wantRightButton(widget, 1) if you want to receive MouseUpdate button notifications.

    Synopsis:
    boolean wantRightButton(widget, want_receive_right_button)

    Arguments:

    • reference to widget -- karamba
    • boolean want_receive_right_button -- whether the widget will receive right clicks


    Return Value:
    true if successful

    Rich Text

    changeRichText

    This will change the contents of a rich text meter. richText is the reference to the text object to change that you saved from the createRichTextrobo135() call. text is a string containing the new value for the rich text object. The differance between Rich Text and a regular text field is that rich text fields can display HTML code embedded in your text.

    In a <a href="command"> ... </a> tag command is executed if the link is

    click with the left mouse button. Except if command starts with an '#' (ie: href="#value" ) the callback meterClicked is called with value (without the #) as the meter argument. Also inline images work. Unfortunately currently only when using absolute paths.

    Synopsis:
    reference changeRichText(widget, richtext, value)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext
    • string value -- new text


    Return Value:
    true if successful

    changeRichTextFont

    This will change the font of a richtext meter.

    Synopsis:
    long changeRichTextFont(widget, richtext, font)

    Arguments:

    • long widget -- karamba
    • long richtext -- richtext
    • string font -- name of the new font


    Return Value:
    1 if successful

    changeRichTextSize

    Sets the font size of a richtext meter.

    Synopsis:
    boolean changeRichTextSize(widget, richtext, size)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext
    • long size -- new font point size


    Return Value:
    true if successful

    createRichText

    This creates creates a new rich text meter. underlineLinks is a boolean that determines if html links will be automatically underlined so that the user knows that the links can be clicked on. You need to save the return value of this function to call other functions on your rich text field, such as changeRichTextrobo132(). The differance between Rich Text and a regular text field is that rich text fields can display HTML code embedded in your text.

    In a <a href="command"> ... </a> tag command is executed if the link is

    click with the left mouse button. Except if command starts with an '#' (ie: href="#value" ) the callback meterClicked is called with value (without the #) as the meter argument. Also inline images work. Unfortunately currently only when using absolute paths.

    Synopsis:
    reference createRichText(widget, text, underlineLinks)

    Arguments:

    • reference to widget -- karamba
    • string text -- text for richtext
    • boolean underlineLinks -- should the links be underlined


    Return Value:
    reference to new richtext meter

    deleteRichText

    This removes the rich text from the widget. Please do not call functions on "text" after calling deleteRichText, as it does not exist anymore and that could cause crashes in some cases.

    Synopsis:
    boolean deleteRichText(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to widget -- richtext


    Return Value:
    true if successful

    getRichTextFont

    Gets the font name of a richtext meter.

    Synopsis:
    string getRichTextFont(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    font name

    getRichTextFontSize

    Gets the font size of the richtext meter.

    Synopsis:
    integer getRichTextFontSize(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    font point size

    getRichTextPos

    Given a reference to a richtext object, this will return an array containing the x and y coordinate of a richtext object.

    Synopsis:
    array getRichTextPos(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    x and y coordinates

    getRichTextSensor

    Gets the current sensor string

    Synopsis:
    string getRichTextSensor(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    current sensor string

    getRichTextSize

    Given a reference to a richtext object, this will return a tuple containing the height and width of a richtext object.

    Synopsis:
    array getRichTextSize(widget, richtext)

    Arguments:

    • long widget -- karamba
    • long richtext -- richtext


    Return Value:
    width and height of the richtext

    getRichTextValue

    Returns the current richtext value.

    Synopsis:
    string getRichTextValue(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    text that is displayed in the rich text

    getThemeRichText

    You can reference richtext in your python code that was created in the theme file. Basically, you just add a NAME= value to the GRAPH line in the .theme file. Then if you want to use that object, instead of calling createRichTextrobo135, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    reference getThemeRichText(widget, name)

    Arguments:

    • long widget -- karamba
    • string name -- name of the richtext in the theme file


    Return Value:
    reference to richtext

    hideRichText

    This hides the richtext. In other words, during subsequent calls to widgetUpdate(), this richtext will not be drawn.

    Synopsis:
    boolean hideRichText(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    true if successful

    moveRichText

    This moves the rich text to a new x, y relative to your widget. In other words, (0,0) is the top corner of your widget, not the screen.

    Synopsis:
    boolean moveRichText(widget, richtext, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference richtext -- richtext
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    resizeRichText

    This will resize richtext to the new height and width.

    Synopsis:
    boolean resizeRichText(widget, richtext, w, h)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext
    • integer w -- new width
    • integer h -- new height


    Return Value:
    true if successful

    setRichTextSensor

    Sets a new sensor string

    Synopsis:
    boolean setRichTextSensor(widget, richtext, sensor)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext
    • string sensor -- new sensor string as in theme files


    Return Value:
    true if successful

    setRichTextWidth

    Given a reference to a rich text object, this function changes it's width to the specified value in pixels. The height adjusts automatically as the contents are changed with changeRichTextrobo132.

    Synopsis:
    boolean setRichTextWidth(widget, richtext, width)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext
    • integer width -- new width in pixels


    Return Value:
    true if successful

    showRichText

    This shows the richtext. In other words, during subsequent calls to widgetUpdate(), this richtext will be drawn.

    Synopsis:
    boolean showRichText(widget, richtext)

    Arguments:

    • reference to widget -- karamba
    • reference to richtext -- richtext


    Return Value:
    true if successful

    Task

    getStartupInfo

    This returns all of the info about a certain starting task in the form of a list. Widget is a reference to the current widget. task is a reference to the window you want info about which you obtain by calling getStartupListrobo151().

    Synopsis:
    list getStartupInfo(widget, task)

    Arguments:

    • reference to widget -- karamba
    • reference to task -- task


    Return Value:
    Here is the format of the returned list by index value:

    • 0 = Task name (The full name of the window)
    • 1 = Icon name
    • 2 = Executable name
    • 3 = A reference back to the task you got info on

    getStartupList

    This returns a list with references to all the current windows that are in the process of loading on this system. You can then call getStartupInforobo150() on any of the entries in the list.

    Synopsis:
    list getTaskListrobo153(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    list with references to startups

    getTaskInfo

    This returns all of the info about a certain task in the form of a list. widget is a reference to the current widget. Task is a reference to the window you want info about which you obtain by calling getTaskListrobo153().

    Synopsis:
    list getTaskInfo(widget, task)

    Arguments:

    • reference to widget -- karamba
    • reference to task -- task


    Return Value:
    Here is the format of the returned list by index value:

    • 0 = Task name (The full name of the window)
    • 1 = Icon name
    • 2 = Class name - This is for grouping tasks. All tasks with the same

    name can be grouped together because they are instances of the same program.

    • 3 = Desktop number - The desktop number this window is on
    • 4 = Is this window maximized? false = no, true = yes
    • 5 = Is this window iconified (minimized)? false = no, true = yes
    • 6 = Is this window shaded (rolled up)? false = no, true = yes
    • 7 = Is this window focused? fale = no, true = yes
    • 8 = A reference back to the task you got info on

    getTaskList

    This returns a list with references to all the current windows open on this system. You can then call performTaskActionrobo155() or getTaskInforobo152() on any of the entries in the list.

    Synopsis:
    list getTaskList(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    list with references to the tasks

    getTaskNames

    This returns a list containing the String names of all open windows on the system. This is for convience if you want to list open windows or see if a window by a certain name exists. Anything else requires the reference to the window you would obtain from getTaskListrobo153()

    Synopsis:
    list getTaskNames(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    list with task names

    performTaskAction

    This peforms the given action on a task object. widget is a reference to the current widget. Task is a reference to a task object you got from getTaskListrobo153(). Action is a number from 1 to 10. See the list below. Possible actions:

    • 1 = Maximize the window
    • 2 = Restore the window (use on iconified windows)
    • 3 = Iconify the window (minimize it)
    • 4 = Close the window
    • 5 = Activate (give focus to) the window
    • 6 = Raise the window
    • 7 = Lower the window
    • 8 = Smart Focus/Minimize - This will what the KDE taskbar does when you

    click on a window. If it is iconified, raise it. If it has focus, iconify it.

    • 9 = Toggle whether this window is always on top
    • 10 = Toggle whether this window is shaded (rolled up)



    Synopsis:
    boolean performTaskAction(widget, task, action)

    Arguments:

    • reference to widget -- karamba
    • reference to task -- task
    • integer action -- action number


    Return Value:
    boolean if successful

    Text

    changeText

    This will change the contents of a text widget.

    Synopsis:
    reference changeText(widget, text, value)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • long value -- new text to display


    Return Value:
    true if successful

    changeTextColor

    This will change the color of a text widget (only ones you created through python currently). textToChange is the reference to the text object to change that you saved from the createTextrobo161() call. r, g, b are ints from 0 to 255 that represent red, green, and blue.

    Synopsis:
    boolean changeTextColor(widget, text, r, g, b)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • integer red -- red component of color
    • integer green -- green component of color
    • integer blue -- blue component of color


    Return Value:
    true if successful

    changeTextFont

    This will change the font of a text widget (only ones you created through python currently). Text is the reference to the text object to change that you saved from the createTextrobo161() call. Font is a string the the name of the font to use.

    Synopsis:
    boolean changeTextFont(widget, text, font)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • string font -- font name


    Return Value:
    true if successful

    changeTextShadow

    This will change the shadow size of a text widget (only ones you created through python currently). textToChange is the reference to the text object to change that you saved from the createTextrobo161() call. size is the offset of the shadow in pixels. 1 or 2 is a good value in most cases.

    Synopsis:
    boolean changeTextShadow(widget, text, shadow)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • integer shadow -- shadow offset


    Return Value:
    true if successful

    changeTextSize

    This will change the font size of a text widget (only ones you created through python currently). text is the reference to the text object to change that you saved from the createTextrobo161() call. size is the new font point size.

    Synopsis:
    boolean changeTextSize(widget, text, size)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • integer size -- new size for text


    Return Value:
    true if successful

    createText

    This creates a new text at x, y with width and height w, h. You need to save the return value of this function to call other functions on your text field, such as changeTextrobo156()

    Synopsis:
    reference createText(widget, x, y, w, h, text)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate
    • integer w -- width
    • integer h -- height
    • string text -- text for the textlabel


    Return Value:
    Pointer to new text meter

    deleteText

    This removes a text object from the widget. Please do not call functions on "text" after calling deleteText, as it does not exist anymore and that could cause crashes in some cases.

    Synopsis:
    boolean deleteText(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to widget -- text meter


    Return Value:
    true if successful

    getTextAlign

    Gets the current text alignment.

    Synopsis:
    string getTextAlign(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    LEFT, CENTER or RIGHT as string

    getTextColor

    Gets the current text color

    Synopsis:
    array getTextColor(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    (red, green, blue)

    getTextFont

    Gets the current text font name

    Synopsis:
    string getTextFont(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    font name

    getTextFontSize

    Gets the current text font size.

    Synopsis:
    integer getTextFontSize(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    text font size

    getTextPos

    Given a reference to a text object, this will return an array containing the x and y coordinate of the text object.

    Synopsis:
    array getTextPos(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    x and y coordinate

    getTextSensor

    Gets the current sensor string

    Synopsis:
    string getTextSensor(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    currently used sensor string

    getTextShadow

    Gets the current shadow offset

    Synopsis:
    integer getTextShadow(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    shadow offset

    getTextSize

    Given a reference to a text object, this will return an array containing the height and width of a text object.

    Synopsis:
    array getTextSize(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    height and width of the text

    getTextValue

    Returns there current text value.

    Synopsis:
    string getTextValue(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    value

    getThemeText

    You can reference text in your python code that was created in the theme file. Basically, you just add a NAME= value to the TEXT line in the .theme file. Then if you want to use that object, instead of calling createTextrobo161, you can call this function. The name you pass to the function is the same one that you gave it for the NAME= parameter in the .theme file.

    Synopsis:
    reference getThemeText(widget, name)

    Arguments:

    • long widget -- karamba
    • string name -- name of the text in the theme file


    Return Value:
    reference to text

    hideText

    Hides text that is visible. You need to call redrawWidgetrobo182() afterwords to actually hiderobo115 the text on screen.

    Synopsis:
    boolean hideText(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    true if successful

    moveText

    This moves a text object to a new x, y relative to your widget. In other words, (0,0) is the top corner of your widget, not the screen.

    Synopsis:
    boolean moveText(widget, text, x, y)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    resizeText

    This will resize text to the new height and width.

    Synopsis:
    boolean resizeText(widget, text, w, h)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • integer w -- new width
    • integer h -- new height


    Return Value:
    true if successful

    setTextAlign

    Sets the text label align.

    Synopsis:
    boolean setTextAlign(widget, text, align)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • string align -- LEFT, CENTER or RIGHT as string


    Return Value:
    true if successful

    setTextSensor

    Sets a new sensor string

    Synopsis:
    boolean setTextSensor(widget, text, sensor)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter
    • string sensor -- new sensor string as in theme files


    Return Value:
    true if successful

    showText

    Shows text that has been hidden with hideTextrobo173().

    Synopsis:
    boolean showText(widget, text)

    Arguments:

    • reference to widget -- karamba
    • reference to text -- text meter


    Return Value:
    true if successful

    Widget

    createWidgetMask

    This function doesn't work currently due to a bug in KDE. Please use MASK= in your .theme file for the time being. WARNING This function does nothing in SuperKaramba 0.50 and later

    Synopsis:
    long createWidgetMask(widget, mask)

    Arguments:

    • reference to widget -- karamba
    • string mask -- The path to the widget mask file.


    Return Value:
    true if successful

    getWidgetPosition

    Returns an array containing the x and y position of you widget. widget is a reference to the current widget.

    Synopsis:
    array getWidgetPosition(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    position of the widget

    moveWidget

    Moves the widget to the new screen location.

    Synopsis:
    boolean moveWidget(widget, x, y)

    Arguments:

    • reference to widget -- karamba
    • integer x -- x coordinate
    • integer y -- y coordinate


    Return Value:
    true if successful

    redrawWidget

    This is THE most important function. After you do a bunch of other calls (moving images, adding images or text, etc), you call this to update the widget display area. You will not see your changes until you call this. Redraws all meters.

    Synopsis:
    boolean redrawWidget(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    redrawWidgetBackground

    Redraws the widget background. WARNING This function does nothing in SuperKaramba 0.50 and later

    Synopsis:
    boolean redrawWidgetBackground(widget)

    Arguments:

    • reference to widget -- karamba


    Return Value:
    true if successful

    resizeWidget

    Resizes the widget to the new width and height.

    Synopsis:
    boolean resizeWidget(widget, w, h)

    Arguments:

    • reference to widget -- karamba
    • integer w -- width
    • integer h -- height


    Return Value:
    true if successful

    toggleWidgetRedraw

    Toggles widget redraw. This function does nothing in SuperKaramba 0.50 and later

    Synopsis:
    boolean toggleWidgetRedraw(widget, b)

    Arguments:

    • reference to widget -- karamba
    • boolean b -- 1 = widget is drawn


    Return Value:
    true if successful