PEXtInitialize(3PEXt)

NAME
PEXtInitialize — a function that initializes the PEX toolkit, the X toolkit and returns a top-level shell.

SYNOPSIS
#include <PEXt/PEXt.h>

Widget PEXtInitialize (app_context_return, application_class, options, num_options, argc_in_out, argv_in_out, fallback_resources, args, num_args)
    XtAppContext    * app_context_return;
    String    application_class;
    XrmOptionDescRec    options;
    Cardinal    num_options;
    Cardinal    * argc_in_out;
    String    argv_in_out;
    String    * fallback_resources;
    ArgList    args;
    Cardinal    num_args;

  Required PHIGS Operating States
(PHCL, *, *, *)

DESCRIPTION
The PEX Toolkit must be initialized before calling any other PEX toolkit routines. PEXtInitialize is a convenience routine that calls XtAppIntialize to create an application context and a toplevel shell widget. PEXtRegisterConverters is then called to register the resource converters for most PHIGS data types. Finally, PEXtOpenPEX is called on the display of the toplevel widget with an error file of NULL and a memory size of PDEFAULT_MEM_SIZE. If PEX was successfully opened on the widget's display, then PEXtInitialize returns the toplevel widget created by XtAppInitialize. Should a client program wish to create its own toplevel shell widget, it should call the PEXtRegisterConverters and PEXtOpenPEX routines itself.

RETURN VALUE
Returns the widget ID of the top-level shell. The class of the shell is ApplicationShellWidgetClass.

SEE ALSO
XtAppInitialize(3)
PEXtRegisterConverters(3)
PEXtOpenPEX(3)

AUTHOR
Rich Thomson <rthomson@dsd.es.com>
Design Systems Division
Evans & Sutherland Computer Corporation