Widgets

Base Class

class gpi.widgets.GenericWidgetGroup(title, parent=None)

This is the base-class for all widgets. It provides abstract methods and default behavior. From the node-developer’s perspective, this provides the widget-port, visibility, and collapsibility options.

getSettings()

These are the minimum settings required to re-instantiate each widget. Save all ‘get_<name>’ attributes as ‘<name>’. This list is also used in the GPI_PROCESS to buffer widget attributes.

get_quietval()

Don’t use/implement quietval since networks will use it to modify val.

mouseDoubleClickEvent(QMouseEvent)

mousePressEvent(QMouseEvent)

set_collapsed(col=True)

bool | Only hide the ‘collapsable’ elements of a widget within its groupbox.

set_id(value=None)

int | INTERNAL USE ONLY: used for saving network information that will aid in reinstantiation.

set_inport(st)

bool | Turn the widget inport on/off with a bool.

set_outport(st)

bool | Turn the widget outport on/off with a bool.

set_quietval(val)

(same type as val) | Set the central value of a widget without triggering an event.

set_reset()

No Arg | Widgets that need to be reset automatically implement this function (e.g. pushbuttons where the button needs to be raised again after the node compute()).

set_val(val)

type(val) | Set the central value of a widget.

set_visible(visible=True)

bool | Set the widget groupbox’s visibility within the node menu.

Numerical Controls

class gpi.widgets.Slider(title, parent=None)

A slider for integer values.

set_max(value)

int | Max integer value (<=).

set_min(value)

int | Min integer value (>=).

set_val(value)

int | The value (int).

class gpi.widgets.SpinBox(title, parent=None)

Spin box for integer values.

set_immediate(val)

bool | Make the value changes immediate with scroll wheel etc…

set_label(val)

str | Set a text left of the spinbox (str).

set_max(val)

int | Max integer value (<=).

set_min(val)

int | Min integer value (>=).

set_singlestep(val)

int | The stepsize of one up/down button click (int).

set_val(val)

int | The value (int).

set_wrapping(val)

int | The number of displayed decimal places (int).

class gpi.widgets.DoubleSpinBox(title, parent=None)

Spin box for floating point values.

set_decimals(val)

int | The number of displayed decimal places (int).

set_immediate(val)

bool | Make the value changes immediate with scroll wheel etc…

set_label(val)

str | Set a text left of the spinbox (str).

set_max(val)

float | Max float value (<=).

set_min(val)

float | Min float value (>=).

set_singlestep(val)

float | The stepsize of one up/down button click (float).

set_val(val)

float | The value (float).

set_wrapping(val)

bool | Allow the up/down buttons to cause a wrap when exceeding max or min values (bool).

Selectors

class gpi.widgets.PushButton(title, parent=None)

A simple single pushbutton box.

set_button_title(val)

str | Place a title, centered, on the button.

set_reset()

No Arg | Overrides the generic reset to specifically set the QPushButton. For oneshot functionality this gets called automatically after the node compute().

set_toggle(val)

bool | Make the pushbutton a toggle button on/off -> True/False.

set_val(val)

bool | The button state is a bool: on/off -> True/False.

class gpi.widgets.ComboBox(title, parent=None)

Provides a popup list for different labels.

set_index(index)

int | gives the corresponding index of the chosen item, starting at 0. So, for example, self.getAttr(‘myfruitbox’,index) would return a 2 if ‘orange’ were selected from the item list given in this table, while self.getVal(‘myfruitbox’) would return the string ‘orange’.

set_items(items)

list(str,str,…) | list of items to choose from. Only one item can be chosen from the list.

set_val(item_text)

int | item index

class gpi.widgets.ExclusiveRadioButtons(title, parent=None)

Provides a set of check boxes for different labels. -Buttons are stacked.

set_buttons(names)

list(str,str,…) | A list of labels (e.g. [‘b1’, ‘b2’,…]).

set_val(value)

int | The position of the chosen button (zero-based, int).

class gpi.widgets.ExclusivePushButtons(title, parent=None)

Provides a set of check boxes for different labels. -Buttons are placed side-by-side.

set_buttons(names)

list(str,str,…) | A list of labels (e.g. [‘b1’, ‘b2’,…]).

set_val(value)

int | The position of the chosen button (zero-based, int).

class gpi.widgets.NonExclusivePushButtons(title, parent=None)

Provides a set of check boxes for different labels. -Buttons are placed side-by-side.

set_buttons(names)

list(str,str,…) | A list of labels (e.g. [‘b1’, ‘b2’,…]).

set_val(value)

int or list(int,int,…) | The position of the chosen button (zero-based, int or list).

Image Display

class gpi.widgets.DisplayBox(title, parent=None)

A 2D QPixmap using a QLabel using built-in interpolation schemes.

set_collapsed(val)

bool | Only collapse the display options, not the QPixmap/QLabel window.

set_interp(val)

bool | Interpolated scaling / nearest neighbor, boolean True/False.

set_line(val)

N/A | Doesn’t do anything yet.

set_noscroll(val)

bool | Turn display window scroll on/off with boolean False/True.

set_pixmap(val)

QPixmap | A QPixmap to be displayed.

set_points(val)

N/A | Doesn’t do anything yet.

set_scale(val)

float | Pre-defined image dimension scale (float)

set_val(image)

QImage | Image is a QImage().

somethingChanged()

send a downstream event.

File Browsers

class gpi.widgets.OpenFileBrowser(title, parent=None)

Provide a QFileDialog() at the push of a button.

set_button_title(title)

str | A title centered on the pushbutton (str).

set_caption(val)

str | Set browser title-bar (str).

set_directory(val)

str | Set the default directory (str).

set_filter(val)

str | Set the file extension filter (e.g. ‘io_field (.fld);;all ()’).

set_val(value)

str | The filename and path (str).

class gpi.widgets.SaveFileBrowser(title, parent=None)

Provide a QFileDialog() at the push of a button.

set_button_title(title)

str | A title centered on the pushbutton (str).

set_caption(val)

str | Set browser title-bar (str).

set_directory(val)

str | Set the default directory (str).

set_filter(val)

str | Set the file extension filter (e.g. ‘io_field (.fld);;all ()’).

set_val(value)

str | The filename and path (str).

Text Input/Output

class gpi.widgets.StringBox(title, parent=None)

A simple single line string box.

get_maskedval()

If the string box is acting as a password then this getter must be used.

get_val()

If its in masked mode then it must be specifically handled thru get_maskedval().

set_mask(val)

bool | Toggle input mask

set_maskedval(val)

None | No setter for storing.

set_placeholder(val)

str | Set the placeholder text (str).

set_val(value)

str | Set the string (str).

class gpi.widgets.TextEdit(title, parent=None)

Provides an editable text window with scrollbar and python code syntax highlighting.

set_val(value)

str | The full plain-text to be displayed (str).

class gpi.widgets.TextBox(title, parent=None)

Provides a multi-line plain-text display.

set_openExternalLinks(val)

bool | Open hyperrefs

set_val(val)

str | The full plain-text to be displayed (str).

set_wordwrap(val)

bool | Turn on/off with boolean True/False.

class gpi.widgets.WebBox(title, parent=None)

For loading web urls.

set_passwd(passwd)

str | For login sites

set_username(usr)

str | For login sites

set_val(val)

str | The url (str).