package bogue

You can search for identifiers within the package.

in-package search v0.2.0

On This Page

Using Bogue together with another graphics loop

package bogue

bogue
- Bogue
  - Avar
  - Box
  - Button
  - Check
  - Draw
  - Image
  - Label
  - Layout
  - Long_list
  - Main
  - Menu
  - Mixer
  - Mouse
  - Popup
  - Print
  - Radiolist
  - Select
  - Selection
  - Slider
  - Snapshot
  - Space
  - Style
  - Sync
  - Table
  - Tabs
  - Text_display
  - Text_input
  - Theme
  - Time
  - Timeout
  - Trigger
  - Tvar
  - Update
  - Utils
  - Var
  - Widget

Legend:
Library
Module
Module type
Parameter
Class
Class type

Control the workflow of the GUI mainloop

Dependency graph

type board

The board is the whole universe of your GUI. It contains everything.

exception Exit

Raising the Exit exception will tell the GUI loop to terminate.

val make : Widget.connection list -> Layout.t list -> board

val run : 
  ?before_display:(unit -> unit) ->
  ?after_display:(unit -> unit) ->
  board ->
  unit

Using Bogue together with another graphics loop

See the embed example.

val make_sdl_windows : ?windows:Tsdl.Sdl.window list -> board -> unit

This is only useful if you have your own graphics loop, and do not use run. This function creates an SDL window for each top layout in the board. One can use predefined windows with the optional argument windows. They will be used by the layouts in the order they appear in the list. If there are fewer windows than layouts, new windows are created. If there are more, the excess is disregarded.

val refresh_custom_windows : board -> unit

Ask the GUI to refresh (ie. repaint) the custom windows (those that were not created by Bogue itself).

val one_step : 
  ?before_display:(unit -> unit) ->
  bool ->
  ((unit -> unit) * (unit -> unit)) ->
  ?clear:bool ->
  board ->
  bool

This is only useful if you have your own graphics loop, and do not use run. Calling one_step ~before_display anim (start_fps, fps) ~clear board is what is executed at each step of the Bogue mainloop. If anim=true this step is non blocking; this is what you want if either Bogue or your loop has an animation running. If anim=false then the function will wait until an event is received.

returns
true if the GUI currently handles an animation. In this case fps() was executed by one_step. If not, you should handle the frame rate yourself.