Inline image support of w3m
2002/01/31
H. Sakamoto
Introduction
This is the extension for w3m to support inline image.
The patch for w3m-0.2.4 is available on the following site.
http://www2u.biglobe.ne.jp/~hsaka/w3m/index.html#img
patch/w3m-0.2.4-2.2.patch.gz
patch/README.img
Support
* Display inline image (GIF,PNG,JPEG, etc.) on terminals
(xterm,rxvt, etc.) of X11.
* 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.
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.
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
* w3m-0.2.4
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.
Install
gunzip -c DIST/w3m-0.2.4.tar.gz | tar -xvf -
cd w3m-0.2.4
gunzip -c DIST/w3m-0.2.4-img-2.2.patch.gz | patch -p1
configure
# When you are asked "Inline image support (you need Imlib library)",
# answer "y".
# Select menu.
make
# To make "w3mimgdisplay" and "w3mimgsize", Imlib is required.
make install
# Must install "w3mimgdisplay" and "w3mimgsize" to $LIB(PREFIX/lib/w3m).
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 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.
-y <offset_y>
The Y origin of display of image on terminal. The default value is 2.
If the terminal is "Eterm", it may be better to specify 5.
-bg <background>
Background color of terminal. The default value is automatically
detected. When the color is specified as #RRGGBB, escape '#'.
ex.)
w3m -o 'imgdisplay=w3mimgdisplay -x 5 -bg "#cccccc"'
Change log
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/
