]> Pileus Git - ~andy/gtk/blob - docs/reference/gtk/windows.sgml
Document im_module_file and settings assignments as toplevel statements.
[~andy/gtk] / docs / reference / gtk / windows.sgml
1 <refentry id="gtk-windows" revision="4 Feb 2001">
2 <refmeta>
3 <refentrytitle>Using GTK+ on Windows</refentrytitle>
4 <manvolnum>3</manvolnum>
5 <refmiscinfo>GTK Library</refmiscinfo>
6 </refmeta>
7
8 <refnamediv>
9 <refname>Using GTK+ on Windows</refname>
10 <refpurpose>
11 Windows-specific aspects of using GTK+
12 </refpurpose>
13 </refnamediv>
14
15 <refsect1>
16 <title>Using GTK+ on Windows</title>
17
18 <para>
19 The Windows port of GTK+ is an implementation of GDK (and therefore GTK+) 
20 on top of the Win32 API. 
21 </para>
22
23 <!-- 
24 <refsect2><title>Build requirements</title>
25 <para>
26 FIXME: explain with-wintab, with-ie55
27 </para>
28 </refsect2>
29 -->
30
31 <refsect2 id="win32-cmdline">
32 <title>Windows-specific commandline options</title>
33
34 <para>
35 The Windows GDK backend can be influenced with some
36 additional command line arguments.
37 </para>
38
39 <formalpara>
40 <title><systemitem>--sync</systemitem></title>
41
42 <para>
43 Don't batch GDI requests. This is a useful option for 
44 debugging, but it will slow down the performance considerably.
45 </para>
46 </formalpara>
47
48 <formalpara>
49 <title><systemitem>--no-wintab</systemitem>, 
50        <systemitem>--ignore-wintab</systemitem></title>
51
52 <para>
53 Don't use the Wintab API for tablet support. This is the default.
54 </para>
55 </formalpara>
56
57 <formalpara>
58 <title><systemitem>--use-wintab</systemitem></title>
59
60 <para>
61 Use the Wintab API for tablet support, if GTK+ has been compiled 
62 with the <option>--with-wintab</option> option.
63 </para>
64 </formalpara>
65
66 <formalpara>
67 <title><systemitem>--max-colors <replaceable>number</replaceable></systemitem></title>
68
69 <para>
70 In 256 color mode, restrict the size of the color palette to 
71 the specified number of colors.
72 </para>
73 </formalpara>
74
75 </refsect2>
76
77 <refsect2 id="win32-envar">
78 <title>Windows-specific environment variables</title>
79
80 <para>
81 The Win32 GDK backend can be influenced with some
82 additional environment variables.
83 </para>
84
85 <formalpara>
86 <title><envar>GDK_IGNORE_WINTAB</envar></title>
87
88 <para>
89 If this variable is set, GTK+ doesn't use 
90 the Wintab API for tablet support. This is the default.
91 </para>
92 </formalpara>
93
94 <formalpara>
95 <title><envar>GDK_USE_WINTAB</envar></title>
96
97 <para>
98 If this variable is set, GTK+ uses the Wintab API for 
99 tablet support, if GTK+ has been compiled with the 
100 <option>--with-wintab</option> option.
101 </para>
102 </formalpara>
103
104 <formalpara>
105 <title><envar>GDK_WIN32_MAX_COLORS</envar></title>
106
107 <para>
108 Specifies the size of the color palette used
109 in 256 color mode.
110 </para>
111 </formalpara>
112
113 <formalpara>
114 <title><envar>G_WIN32_PRETEND_WIN9X</envar></title>
115
116 <para>
117 Only use the Windows 9x API.
118 </para>
119 </formalpara>
120
121 </refsect2>
122
123 </refsect1>
124
125 </refentry>