NAME

make_X11_gopen_string − create a path string associated with an existing X window

SYNOPSIS

C Syntax:

#include <X11/Xlib.h>
char *make_X11_gopen_string(display, drawable);
Display *display;
Drawable drawable;

FORTRAN77 Syntax

subroutine make_X11_gopen_string(display, drawable, dev_string)
integer*4 display
integer*4 drawable
character*(*) dev_string

DESCRIPTION

Input Parameters

display The display where the drawable exists. 

drawable The drawable that is to be gopened. 

Output Parameters

dev_string The string, associated with an existing X.11 window, that can be passed as the path parameter to gopen(3G).

Returned Value

If successful, make_X11_gopen_string returns the address of a string.  If unsuccessful, make_X11_gopen_string returns NULL.  For FORTRAN77 programs, the memory for the display string must be provided as a third parameter. 

Discussion

This routine provides support for associating an existing X.11 Window with a string that can be passed as the path parameter to gopen(3G). 

The display argument specifies the X.11 display that the drawable was created on.  The drawable argument specifies the id of the Window that gopen should access.  The memory for the string is obtained, by the routine, using malloc(3C), malloc(3X), and can be released using free(3C).  This is not necessary for programs using the FORTRAN77 entry point. 

Note that no Pascal syntax is shown above.  This is because there are X-lib bindings for C and FORTRAN77 only, so a Pascal program would need to use the C bindings in order to call this routine.  Refer to the appendixes of Programming With Xlib for more information. 

SEE ALSO

Starbase Reference: gopen(3G). 
Starbase Graphics Techniques: "Using Starbase with the X Window System". 
HP-UX Reference: malloc(3C), malloc(3X). 

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992