DUI Function Reference

Distributed User Interface
Function Reference

Release 1.1

Introduction

The Distributed User Interface library is a set of simple socket-based message-passing routines designed to allow PGL application programs to communicate with user interface components on remote workstations. DUI implements a "remote callback" paradigm, in which user interface events are relayed as commands to the parallel application to perform some action, such as modifying the viewpoint or re-rendering the scene.

Initialization Routines
Low-Level Communication Routines
Message-Passing Routines
Command Routines
Command Definition Macros

Initialization Routines

    void DUIStartInterface(int s, int appcmds)
    int DUIStartApp(char *interface, char *hostname, int appcmds)
    void DUIValidate(int s)

Low-Level Communication Routines

    int DUIOpen(char *hostname)
    void DUISend(int s, void *buf, int n)
    int DUIRecv(int s, void *buf, int n)

Message-Passing Routines

    void DUIInitMsg(DUIMsgBuf *msg)
    void DUIPackC(DUIMsgBuf *msg, char *addr, int n)
    void DUIPackI(DUIMsgBuf *msg, int *addr, int n)
    void DUIPackF(DUIMsgBuf *msg, float *addr, int n)
    void DUIPackD(DUIMsgBuf *msg, double *addr, int n)
    void DUIUnpackC(DUIMsgBuf *msg, char *addr, int n)
    void DUIUnpackI(DUIMsgBuf *msg, int *addr, int n)
    void DUIUnpackF(DUIMsgBuf *msg, float *addr, int n)
    void DUIUnpackD(DUIMsgBuf *msg, double *addr, int n)
    void DUISendMsg(int s, DUIMsgBuf *msg)
    void DUIRecvMsg(int s, DUIMsgBuf *msg)
    Logical DUIMsgRdy(int s)
    void DUIMsgWait(int s)

Command Routines

    void DUIAck(int s)
    void DUISetCmdCallback(int cmd, void (*handler)())
    void DUIGetCmd(int s)
    void DUIGetCmds(int s)
    void DUIRender(int s)

Command Definition Macros