.. Automatically generated file - do not modify.

.. function:: gui.button_properties(kind)
    
    Given a `kind` of button, returns a dictionary giving standard style
    properties for that button. This sets:
    
    :propref:`background`
        As described below.
    
    :propref:`padding`
        To gui.kind_borders.padding (if it exists).
    
    :propref:`xsize`
        To gui.kind_width (if it exists).
    
    :propref:`ysize`
        To gui.kind_height (if it exists).
    
    (Note that if `kind` is the string "nvl_button", this will look for
    the gui.nvl_button_background variable.)
    
    The background is a frame that takes its background picture from
    the first existing one of:
    
    * gui/button/kind_[prefix\_].background.png
    * gui/button/[prefix\_].background.png
    
    If a gui variables named gui.kind_borders exists, it's
    used. Otherwise, :var:`gui.button_borders` is used. If gui.kind_tile
    exists, it determines if the borders are tiled, else :var:`gui.button_tile`
    controls tiling.
    
    For what [prefix\_] means, check out the :ref:`style prefix search <style-prefix-search>`
    documentation.

.. function:: gui.button_text_properties(kind=None, accent=False)
    
    Given a `kind` of button, returns a dictionary giving standard style
    properties for that button. This sets:
    
    :propref:`font`
        To gui.kind_text_font, if it exists.
    
    :propref:`size`
        To gui.kind_text_size, if it exists.
    
    :propref:`xalign`
        To gui.kind_text_xalign, if it exists.
    
    :propref:`text_align`
        To gui.kind_text_xalign, if it exists.
    
    :propref:`layout`
        To "subtitle" if gui.kind_text_xalign is greater than zero
        and less than one.
    
    There are also a number of variables that set the text
    :propref:`color` style property:
    
    color
        To gui.kind_text_color, if it exists. If the variable is not
        set, and `accent` is True, sets the text color to the default
        accent color.
    
    insensitive_color
        To gui.kind_text_insensitive_color, if it exists.
    
    idle_color
        To gui.kind_text_idle_color, if it exists.
    
    hover_color
        To gui.kind_text_hover_color, if it exists.
    
    selected_color
        To gui.kind_text_selected_color, if it exists.
    
    All other :ref:`text style properties <text-style-properties>` are also available. For
    example, gui.kind_text_outlines sets the outlines style property,
    gui.kind_text_kerning sets kerning, and so on.

.. function:: gui.init(width, height)
    
    Initializes the gui.
    
    `width`
        The width of the default window.
    
    `height`
        The height of the default window.

.. function:: gui.text_properties(kind=None, accent=False)
    
    Given a `kind` of button, returns a dictionary giving standard style
    properties for that button. This sets:
    
    :propref:`font`
        To gui.kind_text_font, if it exists.
    
    :propref:`size`
        To gui.kind_text_size, if it exists.
    
    :propref:`xalign`
        To gui.kind_text_xalign, if it exists.
    
    :propref:`text_align`
        To gui.kind_text_xalign, if it exists.
    
    :propref:`layout`
        To "subtitle" if gui.kind_text_xalign is greater than zero
        and less than one.
    
    There are also a number of variables that set the text
    :propref:`color` style property:
    
    color
        To gui.kind_text_color, if it exists. If the variable is not
        set, and `accent` is True, sets the text color to the default
        accent color.
    
    insensitive_color
        To gui.kind_text_insensitive_color, if it exists.
    
    idle_color
        To gui.kind_text_idle_color, if it exists.
    
    hover_color
        To gui.kind_text_hover_color, if it exists.
    
    selected_color
        To gui.kind_text_selected_color, if it exists.
    
    All other :ref:`text style properties <text-style-properties>` are also available. For
    example, gui.kind_text_outlines sets the outlines style property,
    gui.kind_text_kerning sets kerning, and so on.

