sugar3.graphics.style module¶
The style module defines constants for spacing and sizing, as well as classes for Colors and Fonts. Text rendering is handled by Pango and colors are inputted by their HTML code (e.g. #FFFFFFFF)
All the constants are expressed in pixels. They are defined for the XO screen and are usually adapted to different resolution by applying a zoom factor.
- sugar3.graphics.style.COLOR_BLACK = <sugar3.graphics.style.Color object>¶
Black
- sugar3.graphics.style.COLOR_BUTTON_GREY = <sugar3.graphics.style.Color object>¶
Color of buttons
- sugar3.graphics.style.COLOR_HIGHLIGHT = <sugar3.graphics.style.Color object>¶
Color of highlighted text
- sugar3.graphics.style.COLOR_INACTIVE_FILL = <sugar3.graphics.style.Color object>¶
Fill colour of an inactive button
- sugar3.graphics.style.COLOR_INACTIVE_STROKE = <sugar3.graphics.style.Color object>¶
Stroke colour of an inactive button
- sugar3.graphics.style.COLOR_PANEL_GREY = <sugar3.graphics.style.Color object>¶
Default background color of a window
- sugar3.graphics.style.COLOR_SELECTION_GREY = <sugar3.graphics.style.Color object>¶
Background color of selected entry
- sugar3.graphics.style.COLOR_TEXT_FIELD_GREY = <sugar3.graphics.style.Color object>¶
Background color of entry
- sugar3.graphics.style.COLOR_TOOLBAR_GREY = <sugar3.graphics.style.Color object>¶
Color of toolbars
- sugar3.graphics.style.COLOR_TRANSPARENT = <sugar3.graphics.style.Color object>¶
Fully transparent color
- sugar3.graphics.style.COLOR_WHITE = <sugar3.graphics.style.Color object>¶
White
- class sugar3.graphics.style.Color(color, alpha=1.0)¶
Bases:
object
A Color object defines a specific color.
- Parameters
color (str) – String in the form #FFFFFF representing the color
alpha (double) – transparency of color
- get_gdk_color()¶
Returns GDK standard color
- get_html()¶
Returns string in the standard html Color format (#FFFFFF)
- get_int()¶
Returns color encoded as an int, in the form rgba
- get_rgba()¶
Returns 4-tuple of red, green, blue, and alpha levels in range 0-1
- get_svg()¶
Returns HTML formatted color, unless the color is completely transparent, in which case returns “none”
- sugar3.graphics.style.DEFAULT_PADDING = 6¶
Padding is placed around an element
- sugar3.graphics.style.DEFAULT_SPACING = 15¶
Spacing is placed in-between elements
- sugar3.graphics.style.FONT_BOLD = <sugar3.graphics.style.Font object>¶
Bold font
- sugar3.graphics.style.FONT_BOLD_H = 24¶
Height in pixels of bold font
- sugar3.graphics.style.FONT_FACE = 'Sans Serif'¶
User’s preferred font face
- sugar3.graphics.style.FONT_NORMAL = <sugar3.graphics.style.Font object>¶
Normal font
- sugar3.graphics.style.FONT_NORMAL_H = 24¶
Height in pixels of normal font
- sugar3.graphics.style.FONT_SIZE = 10¶
User’s preferred font size
- class sugar3.graphics.style.Font(desc)¶
Bases:
object
A font defines the style of how the text should be rendered.
- Parameters
desc (str) – a description of the Font object
- get_pango_desc()¶
Returns Pango description of font
- sugar3.graphics.style.GRID_CELL_SIZE = 75¶
allow elements to tile neatly within boundaries of a grid http://wiki.sugarlabs.org/go/Human_Interface_Guidelines#The_Grid_System
- sugar3.graphics.style.LARGE_ICON_SIZE = 110¶
larger than medium, used in journal empty view
- sugar3.graphics.style.LINE_WIDTH = 2¶
Thickness of a separator line
- sugar3.graphics.style.MEDIUM_ICON_SIZE = 82¶
larger than standard
- sugar3.graphics.style.MENU_WIDTH_CHARS = 60¶
Max width of text in a palette menu, in chars
- sugar3.graphics.style.PALETTE_CURSOR_DISTANCE = 10¶
Cursor invoked palettes will be placed this far from the cursor
- sugar3.graphics.style.SMALL_ICON_SIZE = 33¶
small icon, used in palette menu items
- sugar3.graphics.style.STANDARD_ICON_SIZE = 55¶
icon that fits within a grid cell
- sugar3.graphics.style.TOOLBAR_ARROW_SIZE = 24¶
Size of arrow displayed under toolbar buttons to represent their status
- sugar3.graphics.style.XLARGE_ICON_SIZE = 151¶
larger than large, used in activity pulsing launcher icon
- sugar3.graphics.style.ZOOM_FACTOR = 1.0¶
scale factor, as float (eg. 0.72, 1.0)
- sugar3.graphics.style.zoom(units)¶
Returns size of units pixels at current zoom level
- Parameters
units (int or float) – size of item at full size