IupOpen

IUP - Portable User Interface

IupOpen

Initializes the IUP toolkit. Must be called before any other IUP function.

Parameters/Return

int IupOpen(int *argc, char ***argv); [in C]
[There is no equivalent in Lua]

This function returns IUP_OPENED (already opened), IUP_ERROR or IUP_NOERROR.

Only in UNIX can fail to open, because X-Windows may be not initialized.

Notes

In Windows, CoInitializeEx(COINIT_APARTMENTTHREADED) and InitCommonControlsEx(ICC_WIN95_CLASSES) functions are called.

In Motif, XtOpenApplication function is called.

For a more detailed explanation on the system control, please refer to Guide / System Control.

Environment Variables

The toolkit's initialization depends also on platform-dependent environment variables, see each driver documentation.

QUIET

When this variable is set to NO, IUP will generate a message in console indicating the driver’s version when initializing. Default: YES.

VERSION

When this variable is set to YES, IUP generates a message dialog indicating the driver's version when initializing.  Default: NO.

Lua Binding 

This function must be called by the host program and before the Binding Lua initialization function, iuplua_open.

See Also

iuplua_open, IupClose, Guide / System Control