/netlib/old-e2/9win

README

Hello 9fans!

I have written a patch to 8.5 window.
The outlook is completely different from that of original window.
The patch adds the followings:
1. title bar and resizing bar similar to that of NEXTSTEP
	Operations using middle/right mouse button is kept available.
2. improved Move operation under right mouse button.
3. scrolling nob that enables smooth scrolling using middle mouse button.
4. Grab menu to copy image in the window.
5. Look menu to search text using regular expression.

The URL of the patch is:
ftp://plan9.aichi-u.ac.jp/9win/9win.bod

I observe some problems in this patch that happen rarely.
It may take much time to fix it.
Your help is welcome.

1998/04/12
Kenji Arisawa
E-mail: arisawa@aichi-u.ac.jp (Kenji Arisawa)


What is Grab?
Grab enables to copy the image in selected rectangle of screen.
The output is created in /tmp with the name grab.3c.
You can see the result by: fb/9v /tmp/grab.3c

How Grab is operated?
Click right mouse button, then you will see new menu item "Grab".
Select Grab then button operations are as follows:
Left button determines the rectangle to cut.
Middle button and right button work the same;
they show menu: OK, Redo, Abort

What is Look?
"Look" is a menu for text searching. 
You can search strings using regular expression.

How Look is operated?
Determine a regular expression in one line using left mouse button,
and then select "look" menu using middle mouse button.
If expression is not selected then snarf buffer is used instead.
You can search again and again by selecting "look" menu.


How to install?
1. cd somewhere
2. mkdir 9win
3. cp /sys/src/cmd/8½/* 9win
4. rc 9win.bod -X
5. Merger the extracted files to 9win.
6. cd 9win; mk
Operation 6 produces $O.out and this is a new 8½.
You can install it giving a name you prefer;
I am using the new 8½ giving a name 9win.

#
#	NEW COMMAND OPTION
#
Laurent Bodet sent me an additional patch;
the patch adds command option for background color.
I have added his option to this release.  The usage is:
	9win -g RGB
where 9win is the name of this patch - you can put any name -,
and R,G,B are letters in [0-9,a-f,A-F] that mean the intensity of
red, green, blue colors. ( white is fff, for example. )
This option is effective only in color mode, i.e.,
	vgasize=XxYx8
in plan9.ini.

#
#	NOTE ON SCROLLER
#
Sometimes you will see that scrolling nob suddenly flips.
This is not a bug.
The phenomena is under 'noscroll' option on terminal.
Flipping will happen when total size of text on the terminal is changed.
You will find my comments on scroller in scroll.c.

#
#	NOTE ON GRAPHICAL APPLICATIONS
#
Programming interfaces are changed a little.
See the file NOTE for detail.

#
#	NOTE ON COMMENTS
#
If you add something, you are wise to distinguish two types of comments:
reliable original comments and, perhaps, less reliable my comments.
Comments with the name '-Kenar-' is mine.
Comments in my functions are mine.
Functions in the new file (wframe.c and grab.c) are mine except the functions that are commented 'moved from *.c'.

#
#	BUGS
#

INDEX

9win.1.0.bod

A patch to 8.5 window that enables Grab.
auther: arisawa@aichi-u.ac.jp
source: ftp://plan9.aichi-u.ac.jp/9win

9win.1.1.bod

A patch to 8.5 window that enables Grab and Look
auther: arisawa@aichi-u.ac.jp
source: ftp://plan9.aichi-u.ac.jp/9win

9win.2.1.bod

A patch to 8.5 window.
The patch adds the followings:
1. title bar and resizing bar similar to that of NEXTSTEP
Operations using middle/right mouse button is kept available.
2. improved Move operation under right mouse button.
3. scrolling nob that enables smooth scrolling
using middle mouse button.
4. Grab menu to copy image in the window.
5. Look menu to search text using regular expression.
For details, see README.
auther: arisawa@aichi-u.ac.jp
source: ftp://plan9.aichi-u.ac.jp/9win

9win.bod

current version - v.2.2
1. Bug fix to rdbitmap and wrbitmap.
2. A change to resize when 9win is used recursively.