aboutsummaryrefslogtreecommitdiffstats
path: root/doc/README.img
blob: 1df86f2900e8c9f661b787d134701c5b11a04ea5 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
Inline image support of w3m
                                                              2002/02/04
                                                              H. Sakamoto
                                                              2002/10/16
                                                              H. Ito

Introduction

  This is the extension for w3m to support inline image.

Support

  * Display inline image (GIF,PNG,JPEG, etc.) on terminals
    (xterm,rxvt, etc.) of X11 or Linux framebuffer device.
  * Support inline image of <img> tag.
    Support of attributes "width", "height", and "align".
  * Direct display of image file which header is "Content-type: image/*"
  * Support of <map> tag.
    Support of attributes "shape" and "coords" of <area> tag. 
  * Support of an attribute "ismap" of <img> tag.
    "w3m" adds coordinate of the cursor as ?<x>,<y> to url, and sends url.
  * Support of an attribute "type=image" of <input> tag.
    "w3m" sends coordinate of the cursor as <name>.x=<x>&<name>.y=<y>.
  * Asynchronous loading of image files.
  * Using cache of image file as pixmap.
  * Support of GIF animation when use GdkPixbuf.


Key functions

  DISPLAY_IMAGE
      Restart loading and drawing of images.
  STOP_IMAGE
      Stop loading and drawing of images in the current buffer.
  SET_OPTION  display_image=toggle
      Toggle loading and drawing of images.

  These functions are not keybinded as default.
  Specify the following keymaps in ~/.w3m/keymap.
      keymap  X    DISPLAY_IMAGE
      keymap  C-c  STOP_IMAGE
      keyamp  t    SET_OPTION  display_image=toggle

Comandline options

  -ppc <pixel>
      # of pixels per character. The default value is automatically
      detected. Must fit the width of font of terminal.
  -ppl <pixel>
      # of pixels per character. The default value is automatically
      detected. Must fit the height of font of terminal.

Option panel

  pixel_per_char
      # of pixels per character. The default value is automatically
      detected. Must fit the width of font of terminal.
  pixel_per_line
      # of pixels per character. The default value is automatically
      detected. Must fit the height of font of terminal.
  display_image
      Display of inline image. The default is ON.
  auto_image
      Automatic loading of inline image. The default is ON.
      If it is OFF, loading starts with a command DISPLAY_IMAGE.
  max_load_image
      Maximum process for downloading of inline image. The default is 4.
      1 to 8 can be set.
  ext_image_viewer
      Use external image viewer, when a command VIEW_IMAGE or
      view of image file which header is "Content-type: image/*".
      The default is ON. If it is OFF, the image is directly displaied.
  image_scale
      Scale of image (%). The default value is 100(%).
  imgdisplay
      External command to display image". The default value is "w3mimgdisplay".
      See "Setting w3mimgdisplay".
  imgsize
      External command to get size of image. The default value is "w3mimgsize".

Required programs

  for X11
    * GdkPixbuf-0.16 or later

    or

    * w3m-0.2.5+cvs-1.287 or later
      http://w3m.sourceforge.net/
      http://sourceforge.net/projects/w3m/
      http://prdownloads.sourceforge.net/w3m/
    * Imlib-1.9.8 (1.9.10 is recommendable.)
      libungif-4.1.0b1 is recommendable.

  for Linux framebuffer device
    * GdkPixbuf-0.16 or later

    or

    * Imlib2-1.0.6 or later

    * Framebuffer device(packed pixels with 8 bpp pseudocolor
      and 16/24/32 bpp truecolor/directcolor)


Setting w3mimgdisplay

  "w3mimgdisplay" has the following options. Set options to fit terminal.

  -x <offset_x>
      The X origin of display of image on terminal. The default value
      for X11 is 2.
      If the terminal is "xterm", the width of scroll bar is added.
      If the terminal is "Eterm", it may be better to specify 5.
      The default value for Linux framebuffer device is 0.
  -y <offset_y>
      The Y origin of display of image on terminal. The default value
      for X11 is 2.
      If the terminal is "Eterm", it may be better to specify 5.
      The default value for Linux framebuffer device is 0.
  -bg <background>
      Background color of terminal. The default value for X11 is
      automatically detected.
      The default value for Linux framebuffer device is #000000 (black).
      When the color is specified as #RRGGBB, escape '#'.

  ex.)
    w3m -o 'imgdisplay=w3mimgdisplay -x 5 -bg "#cccccc"'

Notice
    If you want to see GIF animation, please hit a suitable key, such
    as 'h', 'l', etc., repeatedly, because a frame is rewritten
    according to the re-drawing demand from w3m.

    Some code in w3mimg/fb/fb.c was originally written by Mr. Yamasaki.
    http://www.sainet.or.jp/~yamasaki/download/fb-sample.tar.gz

Change log

2002/02/04
 * Revised this document.

2002/02/01	w3m-0.2.5+cvs-1.287
 * Merged in the CVS repository of the original w3m.

2002/01/31	w3m-0.2.4-img-2.2
 * Based on w3m-0.2.4+cvs-1.278.

2002/01/29	w3m-0.2.4-img-2.1
 * Based on w3m-0.2.4+cvs-1.268.

2002/01/28	w3m-0.2.4-img-2.0
 * Based on w3m-0.2.4+cvs-1.265.
 * pixel_per_char and pixel_per_line are automatically detected.
 * The bckground color of terminal is automatically detected.
 * The source code to display images is moved to image.c

2002/01/08	w3m-0.2.4-img-1.18
 * Based on w3m-0.2.4

2001/12/29	w3m-0.2.3.2-img-1.17
 * Based on w3m-0.2.3.2+cvs-1.196.

2001/12/25	w3m-0.2.3.2-img-1.16.1
 * [w3m-dev 02698] Thanks > Kazuhiko-san

2001/12/22	w3m-0.2.3.2-img-1.16
 * Based on w3m-0.2.3.2.

2001/12/20	w3m-0.2.3.1-img-1.15
 * Based on w3m-0.2.3.1.
 * Support display of image with Content-Transfer-Encoding.

2001/11/29
 * Start merge against CVS source (ChangeLog 1.71)

2001/11/17	w3m-0.2.2-img-1.14
 * Based on w3m-0.2.2.

2001/11/14	w3m-0.2.1-inu-1.6-img-1.13
 * Based on w3m-0.2.1-inu-1.6.

2001/11/05	w3m-0.2.1-inu-1.5-img-1.12
 * Based on w3m-0.2.1-inu-1.5.
 * Fixed the bug for <area>, <map>.
 * Fixed the problem with xwnmo on kterm.

2001/10/03	w3m-0.2.1-inu-1.4-img-1.11
 * Based on w3m-0.2.1-inu-1.4.
 * Fixed bug when reading from stdin.
 * Fixed "configure". Thanks > Fukagawa-san.

2001/08/01	w3m-0.2.1-img-1.10
 * Adjust image position.
 * Fixed scaling image.

2001/07/31	w3m-0.2.1-img-1.9
 * Fixed initImgdisplay(). Thanks > David.

2001/07/29	w3m-0.2.1-img-1.8
 * Fixed "configure".

2001/07/28	w3m-0.2.1-img-1.7
 * Sorry, w3m-0.2.1-img-1.6 is not complete.
 * Added "configure" and "Makefile" to the patch.

2001/07/27	w3m-0.2.1-img-1.6
 * Created doc/README.img.

-------------------------------------------
Hironori Sakamoto <hsaka@mth.biglobe.ne.jp>
 http://www2u.biglobe.ne.jp/~hsaka/