ImGuiStyle

Static Members #

Scale all spacing/padding/thickness values. Do not scale fonts. See comments in definition. Consider not calling this if your initial scale factor if <1.0.

Instance Members #

Current base font size before external global factors are applied. Use PushFont(NULL, size) to modify. Use ImGui::GetFontSize() to obtain scaled value.

Main global scale factor. May be set by application once, or exposed to end-user.

Additional global scale factor from viewport/monitor contents scale. In docking branch: when io.ConfigDpiScaleFonts is enabled, this is automatically overwritten when changing monitor DPI.

Global alpha applies to everything in Dear ImGui.

Additional alpha multiplier applied by BeginDisabled(). Multiply over current value of Alpha.

Padding within a window.

Radius of window corners rounding. Set to 0.0f to have rectangular windows. Large values tend to lead to variety of artifacts and are not recommended.

Thickness of border around windows. Generally set to 0.0f or 1.0f. (Other values are not well tested and more CPU/GPU costly).

Hit-testing extent outside/inside resizing border. Also extend determination of hovered window. Generally meaningfully larger than WindowBorderSize to make it easy to reach borders.

Minimum window size. This is a global setting. If you want to constrain individual windows, use SetNextWindowSizeConstraints().

Alignment for title bar text. Defaults to (0.0f,0.5f) for left-aligned,vertically centered.

Side of the collapsing/docking button in the title bar (None/Left/Right). Defaults to ImGuiDir_Left.

Radius of child window corners rounding. Set to 0.0f to have rectangular windows.

Thickness of border around child windows. Generally set to 0.0f or 1.0f. (Other values are not well tested and more CPU/GPU costly).

Radius of popup window corners rounding. (Note that tooltip windows use WindowRounding)

Thickness of border around popup/tooltip windows. Generally set to 0.0f or 1.0f. (Other values are not well tested and more CPU/GPU costly).

Padding within a framed rectangle (used by most widgets).

Radius of frame corners rounding. Set to 0.0f to have rectangular frame (used by most widgets).

Thickness of border around frames. Generally set to 0.0f or 1.0f. (Other values are not well tested and more CPU/GPU costly).

Horizontal and vertical spacing between widgets/lines.

Horizontal and vertical spacing between within elements of a composed widget (e.g. a slider and its label).

Padding within a table cell. Cellpadding.x is locked for entire table. CellPadding.y may be altered between different rows.

Expand reactive bounding box for touch-based system where touch position is not accurate enough. Unfortunately we don't sort widgets so priority on overlap will always be given to the first widget. So don't grow this too much!

Horizontal indentation when e.g. entering a tree node. Generally == (FontSize + FramePadding.x*2).

Minimum horizontal spacing between two columns. Preferably > (FramePadding.x + 1).

Width of the vertical scrollbar, Height of the horizontal scrollbar.

Radius of grab corners for scrollbar.

Padding of scrollbar grab within its frame (same for both axes).

Minimum width/height of a grab box for slider/scrollbar.

Radius of grabs corners rounding. Set to 0.0f to have rectangular slider grabs.

The size in pixels of the dead-zone around zero on logarithmic sliders that cross zero.

Rounding of Image() calls.

Thickness of border around Image() calls.

Radius of upper corners of a tab. Set to 0.0f to have rectangular tabs.

Thickness of border around tabs.

Minimum tab width, to make tabs larger than their contents. TabBar buttons are not affected.

Minimum tab width after shrinking, when using ImGuiTabBarFlags_FittingPolicyMixed policy.

-1: always visible. 0.0f: visible when hovered. >0.0f: visible when hovered if minimum width. FLT_MAX: never shrink, will behave like ImGuiTabBarFlags_FittingPolicyScroll.

-1: always visible. 0.0f: visible when hovered. >0.0f: visible when hovered if minimum width. FLT_MAX: never show close button when unselected.

Thickness of tab-bar separator, which takes on the tab active color to denote focus.

Thickness of tab-bar overline, which highlights the selected tab-bar.

Angle of angled headers (supported values range from -50.0f degrees to +50.0f degrees).

Alignment of angled headers within the cell

Default way to draw lines connecting TreeNode hierarchy. ImGuiTreeNodeFlags_DrawLinesNone or ImGuiTreeNodeFlags_DrawLinesFull or ImGuiTreeNodeFlags_DrawLinesToNodes.

Thickness of outlines when using ImGuiTreeNodeFlags_DrawLines.

Radius of lines connecting child nodes to the vertical line.

Radius of the drag and drop target frame. When <0.0f: use FrameRounding.

Thickness of the drag and drop target border.

Size to expand the drag and drop target from actual target item size.

Size of R/G/B/A color markers for ColorEdit4() and for Drags/Sliders when using ImGuiSliderFlags_ColorMarkers.

Side of the color button in the ColorEdit4 widget (left/right). Defaults to ImGuiDir_Right.

Alignment of button text when button is larger than text. Defaults to (0.5f, 0.5f) (centered).

Alignment of selectable text. Defaults to (0.0f, 0.0f) (top-left aligned). It's generally important to keep this left-aligned if you want to lay multiple items on a same line.

Thickness of border in Separator(). Must be >= 1.0f.

Thickness of border in SeparatorText()

Alignment of text within the separator. Defaults to (0.0f, 0.5f) (left aligned, center).

Horizontal offset of text from each edge of the separator + spacing on other axis. Generally small values. .y is recommended to be == FramePadding.y.

Apply to regular windows: amount which we enforce to keep visible when moving near edges of your screen.

Apply to every windows, menus, popups, tooltips: amount where we avoid displaying contents. Adjust if you cannot see the edges of your screen (e.g. on a TV where scaling has not been configured).

Docking node has their own CloseButton() to close all docked windows.

Thickness of resizing border between docked windows

Scale software rendered mouse cursor (when io.MouseDrawCursor is enabled). We apply per-monitor DPI scaling over this scale. May be removed later.

Enable anti-aliased lines/borders. Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).

Enable anti-aliased lines/borders using textures where possible. Require backend to render with bilinear filtering (NOT point/nearest filtering). Latched at the beginning of the frame (copied to ImDrawList).

Enable anti-aliased edges around filled shapes (rounded rectangles, circles, etc.). Disable if you are really tight on CPU/GPU. Latched at the beginning of the frame (copied to ImDrawList).

Tessellation tolerance when using PathBezierCurveTo() without a specific number of segments. Decrease for highly tessellated curves (higher quality, more polygons), increase to reduce quality.

Maximum error (in pixels) allowed when using AddCircle()/AddCircleFilled() or drawing rounded corner rectangles with no explicit segment count specified. Decrease for higher quality but more geometry.

Delay for IsItemHovered(ImGuiHoveredFlags_Stationary). Time required to consider mouse stationary.

Delay for IsItemHovered(ImGuiHoveredFlags_DelayShort). Usually used along with HoverStationaryDelay.

Delay for IsItemHovered(ImGuiHoveredFlags_DelayNormal). "

Default flags when using IsItemHovered(ImGuiHoveredFlags_ForTooltip) or BeginItemTooltip()/SetItemTooltip() while using mouse.

Default flags when using IsItemHovered(ImGuiHoveredFlags_ForTooltip) or BeginItemTooltip()/SetItemTooltip() while using keyboard/gamepad.

Metadata #