GLCanvas

\class GLCanvas glcanvas.d

\brief Canvas widget for rendering OpenGL content. This widget was contributed by Jan Winkler.

Canvas widget that can be used to display arbitrary OpenGL content. This is useful to display and manipulate 3D objects as part of an interactive application. The implementation uses scissoring to ensure that rendered objects don't spill into neighboring widgets.

\rst **Usage** Override :func:nanogui.GLCanvas.drawGL in subclasses to provide custom drawing code.

\endrst

class GLCanvas : Widget {

alias Vector2f = vec2f via import nanogui.common : Vector2f, Vector2i, Vector4i;;

alias Vector2i = vec2i via import nanogui.common : Vector2f, Vector2i, Vector4i;;

alias Vector4i = vec4i via import nanogui.common : Vector2f, Vector2i, Vector4i;;

this(Widget parent);

const(Color) backgroundColor();

void backgroundColor(Color backgroundColor);

void drawBorder(bool bDrawBorder);

bool drawBorder();

void draw(NanoContext ctx);

void drawGL();

void drawWidgetBorder(NanoContext ctx);

protected

Color mBackgroundColor;

protected

bool mDrawBorder;

}

Constructors

this this(Widget parent): Creates a GLCanvas attached to the specified parent.

Members

Functions

backgroundColor const(Color) backgroundColor(): Returns the background color.
backgroundColor void backgroundColor(Color backgroundColor): Sets the background color.
draw void draw(NanoContext ctx): Draw the canvas.
drawBorder void drawBorder(bool bDrawBorder): Set whether to draw the widget border or not.
drawBorder bool drawBorder(): Return whether the widget border gets drawn or not.
drawGL void drawGL(): Draw the GL scene. Override this method to draw the actual GL content.
drawWidgetBorder void drawWidgetBorder(NanoContext ctx): Internal helper function for drawing the widget border

Variables

mBackgroundColor Color mBackgroundColor;: The background color (what is used with `glClearColor`).
mDrawBorder bool mDrawBorder;: Whether to draw the widget border or not.

Inherited Members

parent Widget parent(): Return the parent widget
parent auto parent(): Return the parent widget
parent void parent(Widget parent): Set the parent widget
layout Layout layout(): Return the used nanogui.layout.Layout generator
layout auto layout(): Return the used nanogui.layout.Layout generator
layout void layout(Layout layout): Set the used nanogui.layout.Layout generator
theme const(Theme) theme(): Return the nanogui.theme.Theme used to draw this widget
theme void theme(Theme theme): Set the nanogui.theme.Theme used to draw this widget
position Vector2i position(): Return the position relative to the parent widget
position void position(Vector2i pos): Set the position relative to the parent widget
absolutePosition Vector2i absolutePosition(): Return the absolute position on screen
size Vector2i size(): Return the size of the widget
size void size(Vector2i size): set the size of the widget
width int width(): Return the width of the widget
width void width(int width): Set the width of the widget
height int height(): Return the height of the widget
height void height(int height): Set the height of the widget
fixedSize void fixedSize(Vector2i fixedSize): Set the fixed size of this widget
fixedSize Vector2i fixedSize(): Return the fixed size
fixedWidth int fixedWidth(): Return the fixed width (see fixedSize)
fixedHeight int fixedHeight(): Return the fixed height (see fixedSize)
fixedWidth void fixedWidth(int width): Set the fixed width (see fixedSize)
fixedHeight void fixedHeight(int height): Set the fixed height (see fixedSize)
visible bool visible(): Return whether or not the widget is currently visible (assuming all parents are visible)
visible void visible(bool visible): Set whether or not the widget is currently visible (assuming all parents are visible)
visibleRecursive bool visibleRecursive(): Check if this widget is currently visible, taking parent widgets into account
childCount int childCount(): Return the number of child widgets
children auto children(): Return the list of child widgets of the current widget
addChild void addChild(int index, Widget widget): Add a child widget to the current widget at the specified index.
addChild void addChild(Widget widget): Convenience function which appends a widget at the end
removeChild void removeChild(int index): Remove a child widget by index
removeChild void removeChild(Widget widget): Remove a child widget by value
childAt auto childAt(int index): Retrieves the child at the specific position
childAt auto childAt(int index): Retrieves the child at the specific position
childIndex int childIndex(Widget widget): Returns the index of a specific child or -1 if not found
add auto add(Args args): Variadic shorthand notation to construct and add a child widget
window Window window(): Walk up the hierarchy and return the parent window
screen Screen screen(): Walk up the hierarchy and return the parent screen
setId void setId(string id): Associate this widget with an ID value (optional)
id auto id(): Return the ID value associated with this widget, if any
enabled bool enabled(): Return whether or not this widget is currently enabled
enabled void enabled(bool enabled): Set whether or not this widget is currently enabled
focused bool focused(): Return whether or not this widget is currently focused
focused void focused(bool focused): Set whether or not this widget is currently focused
requestFocus void requestFocus(): Request the focus to be moved to this widget
tooltip string tooltip(): Undocumented in source. Be warned that the author may not have intended to support it.
tooltip void tooltip(string tooltip): Undocumented in source. Be warned that the author may not have intended to support it.
fontSize int fontSize(): Return current font size. If not set the default of the current theme will be returned
fontSize void fontSize(int fontSize): Set the font size of this widget
hasFontSize bool hasFontSize(): Return whether the font size is explicitly specified for this widget
iconExtraScale float iconExtraScale(): The amount of extra scaling applied to *icon* fonts. See nanogui.Widget.mIconExtraScale.
iconExtraScale void iconExtraScale(float scale): Sets the amount of extra scaling applied to *icon* fonts. See nanogui.Widget.mIconExtraScale.
cursor Cursor cursor(): Return a pointer to the cursor of the widget
cursor void cursor(Cursor value): Set the cursor of the widget
contains bool contains(Vector2i p): Check if the widget contains a certain position
findWidget Widget findWidget(Vector2i p): Determine the widget located at the given position value (recursive)
mouseButtonEvent bool mouseButtonEvent(Vector2i p, MouseButton button, bool down, int modifiers): Handle a mouse button event (default implementation: propagate to children)
mouseMotionEvent bool mouseMotionEvent(Vector2i p, Vector2i rel, MouseButton button, int modifiers): Handle a mouse motion event (default implementation: propagate to children)
mouseDragEvent bool mouseDragEvent(Vector2i p, Vector2i rel, MouseButton button, int modifiers): Handle a mouse drag event (default implementation: do nothing)
mouseEnterEvent bool mouseEnterEvent(Vector2i p, bool enter): Handle a mouse enter/leave event (default implementation: record this fact, but do nothing)
scrollEvent bool scrollEvent(Vector2i p, Vector2f rel): Handle a mouse scroll event (default implementation: propagate to children)
focusEvent bool focusEvent(bool focused): Handle a focus change event (default implementation: record the focus status, but do nothing)
keyboardEvent bool keyboardEvent(int key, int scancode, KeyAction action, int modifiers): Handle a keyboard event (default implementation: do nothing)
keyboardCharacterEvent bool keyboardCharacterEvent(dchar codepoint): Handle text input (UTF-32 format) (default implementation: do nothing)
preferredSize Vector2i preferredSize(NanoContext ctx): Compute the preferred size of the widget
preferredSize Vector2i preferredSize(NanoContext ctx, Widget skipped): Compute the preferred size of the widget considering its child except skipped one (for example button panel of window)
performLayout void performLayout(NanoContext ctx): Invoke the associated layout generator to properly place child widgets, if any
draw void draw(NanoContext ctx): Draw the widget (and all child widgets)
~this ~this(): Free all resources used by the widget and any children
icon_scale float icon_scale(): Convenience definition for subclasses to get the full icon scale for this class of Widget. It simple returns the value mTheme.mIconScale * this.mIconExtraScale.
mParent Widget mParent;: Undocumented in source.
mTheme Theme mTheme;: Undocumented in source.
mLayout Layout mLayout;: Undocumented in source.
mId string mId;: Undocumented in source.
mPos Vector2i mPos;
mSize Vector2i mSize;
mFixedSize Vector2i mFixedSize;: Undocumented in source.
mChildren Array!Widget mChildren;: Undocumented in source.
mVisible bool mVisible;: Whether or not this Widget is currently visible. When a Widget is not currently visible, no time is wasted executing its drawing method.
mEnabled bool mEnabled;: Whether or not this Widget is currently enabled. Various different kinds of derived types use this to determine whether or not user input will be accepted. For example, when `mEnabled == false`, the state of a CheckBox cannot be changed, or a TextBox will not allow new input.
mFocused bool mFocused;
mMouseFocus bool mMouseFocus;: Undocumented in source.
mTooltip string mTooltip;: Undocumented in source.
mFontSize int mFontSize;: Undocumented in source.
mIconExtraScale float mIconExtraScale;: The amount of extra icon scaling used in addition the the theme's default icon font scale. Default value is `1.0`, which implies that icon_scale simply returns the value of nanogui.Theme.mIconScale.
mCursor Cursor mCursor;: Undocumented in source.

GLCanvas

Constructors

Members

Functions

Variables

Inherited Members

From Widget

Meta

Source