Display *XOpenDisplay(char *display_name)

• display_name - строка, описывающая X-сервер, к которому необходимо подключиться.

     В POSIX-ориентированных системах, если аргумент display_name NULL, выбирается сервер по-умолчанию, данные о котором хранятся в переменной окружения DISPLAY. Формат строки следующий: <host name>:<:>[screen number], где host name - адрес машины, на которой работает X-сервер, а screen number - номер экрана по-умолчанию.

     Функция XOpenDisplay возвращает указатель на структуру типа Display, которая описывает соединение и хранит служебную информацию о сервере. Функция XOpenDisplay подключает приложение к X-серверу через TCP, DECnet или внутренний коммуникационный протокол взаимодействия процессов. Если в display_name указывается адрес машины, затем через знак двоеточия (:) указывается номер экрана, XOpenDisplay подключается при помощи протокола TCP. Если адрес машины не указывается, Xlib выбирает протокол по своему усмотрению. Если адрес машины и номер экрана разделены двумя двоеточиями (::), подключение происходит по протоколу DECnet. Один X-сервер может поддерживать несколько или все эти механизмы соединений одновременно.

     В случае удачного подключения, XOpenDisplay возвращает указатель на структуру Display, которая определена в файле заголовков <X11/Xlib.h>. Если установить соединение не удаётся, возвращается значение NULL. После успешного подключения к серверу, приложение может использовать все доступные экраны. Номер экрана, указанный в аргументе display_name, будет экраном по-умолчанию. Его можно получить через макро-определение DefaultScreen (или через функцию XDefaultScreen).

см также: XCloseDisplay.