XGCValues - параметры контекста вывода графики

       Эта структура используется для создания, изменения и получения сведений о графическом контексте.

Формат структуры:

    typedef struct {
	int function;
	unsigned long plane_mask;
	unsigned long foreground;
	unsigned long background;
	int line_width;
	int line_style;
	int cap_style;
	int join_style;
	int fill_style;
	int fill_rule;
	int arc_mode;
	Pixmap tile;
	Pixmap stipple;
	int ts_x_origin;
	int ts_y_origin;
	Font font;
	int subwindow_mode;
	Bool graphics_exposures;
	int clip_x_origin;
	int clip_y_origin;
	Pixmap clip_mask;
	int dash_offset;
	char dashes;
    } XGCValues;

       При запросе визульных характеристик совместно с этой структурой используется битовая маска, указывающая, из каких полей необходимо заносить значения в графический контекст. Для каждого разряда этой маски определены следующие символьные значения:

#define   GCFunction           (1L<<0)    /* function           */
#define   GCPlaneMask          (1L<<1)    /* plane_mask         */
#define   GCForeground         (1L<<2)    /* foreground         */
#define   GCBackground         (1L<<3)    /* background         */
#define   GCLineWidth          (1L<<4)    /* line_width         */
#define   GCLineStyle          (1L<<5)    /* line_style         */
#define   GCCapStyle           (1L<<6)    /* cap_style          */
#define   GCJoinStyle          (1L<<7)    /* join_style         */
#define   GCFillStyle          (1L<<8)    /* fill_style         */
#define   GCFillRule           (1L<<9)    /* fill_rule          */
#define   GCTile               (1L<<10)   /* tile               */
#define   GCStipple            (1L<<11)   /* stipple            */
#define   GCTileStipXOrigin    (1L<<12)   /* ts_x_origin        */
#define   GCTileStipYOrigin    (1L<<13)   /* ts_y_origin        */
#define   GCFont               (1L<<14)   /* font               */
#define   GCSubwindowMode      (1L<<15)   /* subwindow_mode     */
#define   GCGraphicsExposures  (1L<<16)   /* graphics_exposures */
#define   GCClipXOrigin        (1L<<17)   /* clip_x_origin      */
#define   GCClipYOrigin        (1L<<18)   /* clip_y_origin      */
#define   GCClipMask           (1L<<19)   /* clip_mask          */
#define   GCDashOffset         (1L<<20)   /* dash_offset        */
#define   GCDashList           (1L<<21)   /* dashes             */
#define   GCArcMode            (1L<<22)   /* arc_mode           */

       Поле function хранит логическую функцию вывода, которая выполняется над данными из видеопамяти и выводимыми данными и результат которой помещается в видеопамять. Для программы это выглядит как поразрядная логическая операция над цветовыми индексами в видеопамяти и цветовыми индексами, которыми производится вывод в видеопамять. Логические функции Определено несколько таких функций:

• GXclear 0x0 0
  - просто обнулять информацию в видеопамяти;

• GXand 0x1 src AND dst
  - производить логическое умножение;

• GXandReverse 0x2 src AND NOT dst
  - производить инверсию данных в видеопамяти и логически перемножать с выводимыми данными;

• GXcopy 0x3 src
  - помещать данные в видеопамять без изменений;

• GXandInverted 0x4 (NOT src) AND dst
  - инвертировать выводимые данные и логически перемножать с данными из видеопамяти;

• GXnoop 0x5 dst
  - оставлять видеопамять без изменений;

• GXxor 0x6 src XOR dst
  - производить логическое иключающее ИЛИ;

• GXor 0x7 src OR dst
  - производить логическое сложение;

• GXnor 0x8 (NOT src) AND (NOT dst)
  - производить логическое умножение между инверсиями выводимых данных и данных видепамяти;

• GXequiv 0x9 (NOT src) XOR dst
  - исключающее ИЛИ между данными видеопамяти и инверсией выводимых данных;

• GXinvert 0xa NOT dst
  - производить инверсию данных в видеопамяти;

• GXorReverse 0xb src OR (NOT dst)
  - логическое сложение выводимых данных с инверсией данных в видеопамяти;

• GXcopyInverted 0xc NOT src
  - инвертировать данные вывода;

• GXorInverted 0xd (NOT src) OR dst
  - логическое сложение данных видеопамять с инверсией выводимых данных;

• GXnand 0xe (NOT src) OR (NOT dst)
  - производить логическое сложение между инверсиями выводимых данных и данных видепамяти;

• GXset 0xf 1
  - устанавливать в единицы информацию в видеопамяти;

       Поле plane_mask разрешает операции вывода графики для определенных плоскостей. Один разряд маски обозначает одну плоскость. Можно разрешить использование всех плоскостей сразу, указав значение AllPlanes.

       Поле foreground указывает цвет, используемый как основной цвет при выводе графики.

       Поле background указывает фоновый цвет, используемый при выводе графики.

       Поле line_width указывает ширину линий в точках. Обычно, если указывается это значение, оно больше либо равно единицы. Обычная тонкая линия соответствует нулевому значению ширины. Линия рисуется симметрично относительно оси, указанной в запросе рисования линии. Если не оговорено другое в полях cap_style или join_style, то линия с конечными точками в координатах [x1, y1], [x2, y2] и толщиной w будет ограничена прямоугольником, углы которого будут расположенны в координатах:

    [x1-(w*sn/2), y1+(w*cs/2)], [x1+(w*sn/2), y1-(w*cs/2)],
    [x2-(w*sn/2), y2+(w*cs/2)], [x2+(w*sn/2), y2-(w*cs/2)],

где sn - синус угла наклона линии, а cs - косинус угла наклона линии. Для отрисовки линии на экране отображаются только те точки, которые принадлежат этому прямоугольнику. Точка считается принадлежащей прямоугольнику, если её центр находится полностью внутри прямоугольника (рёбра прямоугольника принимаются бесконечно тонкими). Если точка находится на одном из ребер, то она считается принадлежащей прямоугольнику только в том случае, если внутренняя часть прямоугольника находится непосредственно справа от точки.

       Точки на горизонтальных и вертикальных ребрах являются особым случаем. Они считаются принадлежащими прямоугольнику, если внутренняя часть его находится непосредственно снизу от точки и непосредственно справа от точки соответственно.

       Тонкие линии, для которых указана нулевая ширина, рисуются шириной, равной одной точке, как правило с использованием аппаратных средств, что может привести к разным результатам на разном аппаратном обеспечении. Существуют лишь два ограничения на алгоритмы отрисовки линий:

1. Допустим рисуется линия, координаты которой обозначены точками [x1,y1] и [x2,y2], причем линия полностью входит в разрешенную область рисования. Также рисуется линия тоже полностью входящая в разрешенную область рисования, координаты которой заданы точками [x1+dx,y1+dy] и [x2+dx,y2+dy]. Тогда точка [x+dx,y+dy] будет принадлежать второй линии тогда и только тогда, когда точка [x,y] будет принадлежать первой линии.

2. Видимый набор точек линии не может быть искажен ограничениями на область рисования. Это значит, что все точки линии, находящиеся внури разрешенной области рисования находятся именно в тех координатах, в которых они находились бы, если бы не было оганичений на область рисования.

       Толстая линия, начинающаяся в точке [x1,y1] и заканчивающаяся в точке [x2,y2] состоит из тех же точек, что и линия, нарисованная от точки [x2,y2] до точки [x1,y1]. Это правило рекомендуется и для тонких линий, но не является для них обязательным.

       Тонкая линия, толщина которой указана равной нулю и линия, толщина которой указана равной единице могут отличаться по составу точек. Это может быть связано с тем, что тонкие линии рисуются при помощи аппаратного обеспечения графического адаптера, которое позволяет производить отрисовку линий во много раз быстрее, нежели более точный алгоритм отрисовки толстых линий.

       В силу этих различий, тонкие линие могут не совсем вписыватся в картину, нарисованную толстыми линиями. Если необходима точность отрисовки и однородная отрисовка по всему экрану, лучше использовать линии с толщиной равной единице, чем тонкие линии.

       Поле line_style определяет стиль рисования линий на экране:

• LineSolid - линия рисуется цельной от начальной точки до конечной

• LineDoubleDash - линия рисуется цельной от начальной точки до конечной, но при этом разбивается на секции и заполнение четных секций определяется значением поля fill_style.

• LineOnOffDash - только четные секции линии отрисовываются на экране, причем поле cap_style работает применительно к каждой видимой секции, за исключением того, что значение этого поля CapNotLast воспринимается как CapButt.

       Поле cap_style описывает каким образом отрисовывать концы линий:

• CapNotLast - Эквивалент CapButt, за исключением того, что для тонких линий нулевой ширины не отрисовывается последняя точка линии.

• CapButt - У линии будут прямые углы на конечных точках. Границы линии не выходят за пределы указанных координат.

• CapRound - Линия на концах будет иметь закругления с диаметрами, равными толщине линии и центрами в конечных точках линии. Для линий нулевой толщины эффект будет эквивалентен CapButt.

• CapProjecting - У линии будут прямые углы на конечных точках, но сама линия будет продолжена за указанные конечные точки на длину, равную половине ширины. Для линий нулевой толщины эффект будет эквивалентен CapButt.

       В случае рисования линии, у которой конечные точки имеют одинаковые координаты (x1=x2, y1=y2) и когда используется значение cap_style, результат зависит от толщины линии и значения cap_style:

CapNotLast	тонкая линия	Результат зависит от графического адаптера. Подразумевается, что ничего не должно быть нарисовано.
CapButt	тонкая линия	Результат зависит от графического адаптера. Подразумевается, что должна быть нарисована только одна точка.
CapRound	тонкая линия	Результат аналогичен значению CapButt с тонкой линией.
CapProjecting	тонкая линия	Результат аналогичен значению CapButt с тонкой линией.
CapButt	толстая линия	Не рисуется ничего.
CapRound	толстая линия	Рисуется заполненная окружность, центр которой находится в конечной точке линии. Диаметром окружности берется равным толщине линии.
CapProjecting	толстая линия	Рисуется заполненный квадрат, стороны которого расположены параллельно осям координат. Центр квадрата находится в конечной точке лини. Стороны квадрата равны толщине линии.

       Поле join_style описывает каким образом производить состыковку широких линий:

• JoinMiter - Внешние углы двух линий продолжаются до встречи их друг с другом. Если угол между линиями получается меньше 11 градусов, принудительно выбирается метод JoinBewel.

• JoinRound - Угол между линиями закругляется окружностью с диаметром, равным толщине линии и центром в точке обьединения линий.

• JoinBevel - Для конечных точек выбирается стиль CapButt, а образующийся вырез заполняется.

       В случае рисования линии, у которой конечные точки имеют одинаковые координаты (x1=x2, y1=y2) и когда используется join-style для одного или обоих концов линии, отрисовка линии не происходит. Однако, если все объединяемые линии вырождаются в одну точку, то эффект аналогичен наложению cap_style на обе конечные точки.

       Поля tile/stipple являются графическими образами, представляющими плоскость, в которых они размножены по всем направлениям. Нулевые координаты в этой плоскости соответствуют левому верхнему углу этих изображений. Положение нулевых координат этой плоскости в системе координат объекта, в котором происходит отображение графической информации указывается в полях ts_x_origin и ts_y_origin для координат x и y соответственно. При выполнении графических операций, работающих с этими полями, графическая информация из этой плоскости по выбранным алгоритмам копируется в соответствующие координаты указанного для рисования обьекта. Графический образ tile должен принадлежать одному и тому же корневому окну, которому принадлежит контекст GC и иметь ту же глубину цветности, иначе возникнет ошибка BadMatch. Графический образ stipple также должен принадлежать тому же корневому окну, но глубина цветности должна быть равна единице. Для графических операций, использующих графический образ stipple и и использующих стиль заполнения FillStippled, stipple используется просто как дополнительная маска, которая логически перемножается с маской clip_mask. Допускается использование графических образов tile и stipple с разными размерами.

       После того, как графический образ начал использоваться в контексте графического вывода, лучше воздержаться от внесения в него каких-либо изменений, поскольку результат получится неопределённым. Возможно, изменения отразятся на графическом контексте, а возможно, что контекст останется без изменений.

       Поле fill_style определяет стиль заполнения для запросов рисования линий, текста и запросов заполнения. Для всех запросов рисования текста и запросов заполнения (XDrawText, XDrawText16, XFillRectangle, XFillPolygon, и XFillArc), для рисования линий со стилем LineSolid (XDrawLine, XDrawSegments, XDrawRectangle, XDrawArc), а также для четных секций линий, рисуемых со стилями LineOnOffDash или LineDoubleDash работают следующие стили заполнения: