Home » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » Zap » !Zap/Docs/E-Windows
!Zap/Docs/E-Windows
This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.
Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.
| Tape/disk: | Home » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » Zap |
| Filename: | !Zap/Docs/E-Windows |
| Read OK: | ✔ |
| File size: | 1527 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
************************************************************************* * >E-Windows Documents a zap window block format. * ************************************************************************* By convention, window blocks are pointed to by R8. However, as with files, the pointer address may change whenever a window is created. Thus, as for files, block pointers should be changed to window offsets for storing. Use the calls Zap_GetWindOff, Zap_ConvWindOff. The first two paragraphs of E-File hold if you replace 'file block' by 'window block' and R9 by R8. Please read the E-File file first. Window block offsets have names beginning 'w_'. See E-Library for a complete list. Each window determines uniquely a file via the offset w_file. As far as Zap and the extension modes are concerned, a zap text window consists of a rectangle of characters. Coordinates are usually given in terms of row and column in R2,R3. Ie, by convention, R2=column offset from left hand edge, in characters. R3=offset in lines from the top of the display, in lines. R2 includes the margin which may contain the line numbers. The line numbers are handled automatically by zap. Thus a window looks like: 0 w_margin w_width 0 ------------------------- | | | | | | | | | | | | | | | w_height ------------------------- The quantity w_width-w_margin is usually stored in the mode dependent byte w_bpl (bytes per line). However for byte/word modes this is not true, and the number of bytes in the file that the line represents is stored in w_bpl. A further complication is that the window text display is cached. The start of the cached area is used as a reference point for working out the file offset of a given physical or logical line number. Thus it is not necessary to start counting from the start of the file to find out where a line is. All line references work locally from this value, which is the start of the cached display, which is where the user is likely to be editing! The calls Zap_FindOffset and Zap_OffLineCol use this fact. These calls use the mode entry points 'e_cln*'. Thus these entry points should use this reference point. Thus the mode will need a piece of code (usually called cln_backward) for tracing lines backwards up the file. The cache itself consists of a number of lines of width w_txtw. This width is usually w_width rounded up to the next multiple of 8. An extension mode need not usually concern itself with this cache unless it is drawing its own display. See the mode entry point e_redrawline in which you are asked to fill a line in the cache. The window block offsets are described below. Use E-Library to set up the definitions. w_handle w_minx w_miny w_maxx w_maxy w_scrollx w_scrolly w_infront w_windowflags These are as for a wimp window block. See PRM if in doubt. w_file Gives the file offset of the associated file. Use Zap_ConvFileOff to convert this to a file pointer in R9. This is done automatically for you by Zap_ConvWindOff. w_format Gives the display format flags and the mode the window is in. See E-Flags for details. w_width Width of window in columns (including the margin). w_height Height of window in lines. w_txt Address of text cache. w_txth Number of lines claimed for txt cache. w_txtw Width of a text cache line in characters. Must be a multiple of 8. w_txtn Number of lines cached in the txt cache. w_coff Reference point giving the file offset of the start of the first cached physical line. w_cline Reference point giving the physical line number (first line 0) of the start of the first cached physical line. w_clogl As for w_cline but gives the logical line number. w_tab Gives the coltab width. w_tabc Gives the character code tab mask (x4) eg &09090909. Set this to the same as w_cr if you want the tabs to be invisible. w_cr Gives the line terminator mask (x4) eg &0A0A0A0A. w_flags Gives the flags status for this window. See E-Flags. When a window is created the default value is taken from opt_flags. w_title Points to the window title. w_bpl Mode dependent word. Usually stores the width of the display in characters. Byte mode stores the number of bytes shown on each line etc. w_margin Width of the left hand margin in characters. w_rl Height in pixels of each character including the line spacing. w_rw Width in pixels of each character. w_rh Height in pixels of each character excluding line spacing. w_addr Address to show in margin for file offset 0. w_stline Line number to show in margin for line offset 0. w_titlelen w_titbuf w_titlen Used internally for title update. w_mwidth User required margin width before space for line numbers added. w_tabchar User required tab character code x4 (eg &09090909) before tab visibility taken into account. w_linesp User required line spacing in 1/8ths char. w_savedo w_savedl w_savedc w_savedh w_savedlc Used internally by Zap_DoCommand and Zap_SaveWinStatus w_wrapwidth Wordwrap width. w_togminx w_togminy w_togmaxx w_togmaxy These save the 'small' window position for the toggle size key (scG). w_res0-w_res15 Reserved words w_mode0-w_mode15 Mode words. Each mode has one word in each in window in which to store the options pertaining to that mode. See the E-Flags file for the suggested format of this word. The default values of these words are stored in opt_mode0-opt_mode15. Use Zap_ReadVar to get at these.
00000000 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a |****************| * 00000040 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 2a 20 3e 45 2d 57 |*********.* >E-W| 00000050 69 6e 64 6f 77 73 09 44 6f 63 75 6d 65 6e 74 73 |indows.Documents| 00000060 20 61 20 7a 61 70 20 77 69 6e 64 6f 77 20 62 6c | a zap window bl| 00000070 6f 63 6b 20 66 6f 72 6d 61 74 2e 09 09 09 2a 0a |ock format....*.| 00000080 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a |****************| * 000000c0 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 42 79 20 63 6f |*********..By co| 000000d0 6e 76 65 6e 74 69 6f 6e 2c 20 77 69 6e 64 6f 77 |nvention, window| 000000e0 20 62 6c 6f 63 6b 73 20 61 72 65 20 70 6f 69 6e | blocks are poin| 000000f0 74 65 64 20 74 6f 20 62 79 20 52 38 2e 20 48 6f |ted to by R8. Ho| 00000100 77 65 76 65 72 2c 20 61 73 20 77 69 74 68 20 66 |wever, as with f| 00000110 69 6c 65 73 2c 0a 74 68 65 20 70 6f 69 6e 74 65 |iles,.the pointe| 00000120 72 20 61 64 64 72 65 73 73 20 6d 61 79 20 63 68 |r address may ch| 00000130 61 6e 67 65 20 77 68 65 6e 65 76 65 72 20 61 20 |ange whenever a | 00000140 77 69 6e 64 6f 77 20 69 73 20 63 72 65 61 74 65 |window is create| 00000150 64 2e 20 54 68 75 73 2c 20 61 73 20 66 6f 72 0a |d. Thus, as for.| 00000160 66 69 6c 65 73 2c 20 62 6c 6f 63 6b 20 70 6f 69 |files, block poi| 00000170 6e 74 65 72 73 20 73 68 6f 75 6c 64 20 62 65 20 |nters should be | 00000180 63 68 61 6e 67 65 64 20 74 6f 20 77 69 6e 64 6f |changed to windo| 00000190 77 20 6f 66 66 73 65 74 73 20 66 6f 72 20 73 74 |w offsets for st| 000001a0 6f 72 69 6e 67 2e 20 55 73 65 0a 74 68 65 20 63 |oring. Use.the c| 000001b0 61 6c 6c 73 20 5a 61 70 5f 47 65 74 57 69 6e 64 |alls Zap_GetWind| 000001c0 4f 66 66 2c 20 5a 61 70 5f 43 6f 6e 76 57 69 6e |Off, Zap_ConvWin| 000001d0 64 4f 66 66 2e 20 54 68 65 20 66 69 72 73 74 20 |dOff. The first | 000001e0 74 77 6f 20 70 61 72 61 67 72 61 70 68 73 20 6f |two paragraphs o| 000001f0 66 20 45 2d 46 69 6c 65 0a 68 6f 6c 64 20 69 66 |f E-File.hold if| 00000200 20 79 6f 75 20 72 65 70 6c 61 63 65 20 27 66 69 | you replace 'fi| 00000210 6c 65 20 62 6c 6f 63 6b 27 20 62 79 20 27 77 69 |le block' by 'wi| 00000220 6e 64 6f 77 20 62 6c 6f 63 6b 27 20 61 6e 64 20 |ndow block' and | 00000230 52 39 20 62 79 20 52 38 2e 20 50 6c 65 61 73 65 |R9 by R8. Please| 00000240 20 72 65 61 64 0a 74 68 65 20 45 2d 46 69 6c 65 | read.the E-File| 00000250 20 66 69 6c 65 20 66 69 72 73 74 2e 0a 0a 57 69 | file first...Wi| 00000260 6e 64 6f 77 20 62 6c 6f 63 6b 20 6f 66 66 73 65 |ndow block offse| 00000270 74 73 20 68 61 76 65 20 6e 61 6d 65 73 20 62 65 |ts have names be| 00000280 67 69 6e 6e 69 6e 67 20 27 77 5f 27 2e 20 53 65 |ginning 'w_'. Se| 00000290 65 20 45 2d 4c 69 62 72 61 72 79 20 66 6f 72 20 |e E-Library for | 000002a0 61 20 63 6f 6d 70 6c 65 74 65 0a 6c 69 73 74 2e |a complete.list.| 000002b0 20 45 61 63 68 20 77 69 6e 64 6f 77 20 64 65 74 | Each window det| 000002c0 65 72 6d 69 6e 65 73 20 75 6e 69 71 75 65 6c 79 |ermines uniquely| 000002d0 20 61 20 66 69 6c 65 20 76 69 61 20 74 68 65 20 | a file via the | 000002e0 6f 66 66 73 65 74 20 77 5f 66 69 6c 65 2e 0a 0a |offset w_file...| 000002f0 41 73 20 66 61 72 20 61 73 20 5a 61 70 20 61 6e |As far as Zap an| 00000300 64 20 74 68 65 20 65 78 74 65 6e 73 69 6f 6e 20 |d the extension | 00000310 6d 6f 64 65 73 20 61 72 65 20 63 6f 6e 63 65 72 |modes are concer| 00000320 6e 65 64 2c 20 61 20 7a 61 70 20 74 65 78 74 20 |ned, a zap text | 00000330 77 69 6e 64 6f 77 0a 63 6f 6e 73 69 73 74 73 20 |window.consists | 00000340 6f 66 20 61 20 72 65 63 74 61 6e 67 6c 65 20 6f |of a rectangle o| 00000350 66 20 63 68 61 72 61 63 74 65 72 73 2e 20 43 6f |f characters. Co| 00000360 6f 72 64 69 6e 61 74 65 73 20 61 72 65 20 75 73 |ordinates are us| 00000370 75 61 6c 6c 79 20 67 69 76 65 6e 20 69 6e 20 74 |ually given in t| 00000380 65 72 6d 73 0a 6f 66 20 72 6f 77 20 61 6e 64 20 |erms.of row and | 00000390 63 6f 6c 75 6d 6e 20 69 6e 20 52 32 2c 52 33 2e |column in R2,R3.| 000003a0 20 49 65 2c 20 62 79 20 63 6f 6e 76 65 6e 74 69 | Ie, by conventi| 000003b0 6f 6e 2c 0a 0a 09 52 32 3d 63 6f 6c 75 6d 6e 20 |on,...R2=column | 000003c0 6f 66 66 73 65 74 20 66 72 6f 6d 20 6c 65 66 74 |offset from left| 000003d0 20 68 61 6e 64 20 65 64 67 65 2c 20 69 6e 20 63 | hand edge, in c| 000003e0 68 61 72 61 63 74 65 72 73 2e 0a 09 52 33 3d 6f |haracters...R3=o| 000003f0 66 66 73 65 74 20 69 6e 20 6c 69 6e 65 73 20 66 |ffset in lines f| 00000400 72 6f 6d 20 74 68 65 20 74 6f 70 20 6f 66 20 74 |rom the top of t| 00000410 68 65 20 64 69 73 70 6c 61 79 2c 20 69 6e 20 6c |he display, in l| 00000420 69 6e 65 73 2e 0a 09 0a 52 32 20 69 6e 63 6c 75 |ines....R2 inclu| 00000430 64 65 73 20 74 68 65 20 6d 61 72 67 69 6e 20 77 |des the margin w| 00000440 68 69 63 68 20 6d 61 79 20 63 6f 6e 74 61 69 6e |hich may contain| 00000450 20 74 68 65 20 6c 69 6e 65 20 6e 75 6d 62 65 72 | the line number| 00000460 73 2e 20 54 68 65 20 6c 69 6e 65 20 6e 75 6d 62 |s. The line numb| 00000470 65 72 73 0a 61 72 65 20 68 61 6e 64 6c 65 64 20 |ers.are handled | 00000480 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 |automatically by| 00000490 20 7a 61 70 2e 20 54 68 75 73 20 61 20 77 69 6e | zap. Thus a win| 000004a0 64 6f 77 20 6c 6f 6f 6b 73 20 6c 69 6b 65 3a 0a |dow looks like:.| 000004b0 0a 09 09 09 30 09 77 5f 6d 61 72 67 69 6e 09 77 |....0.w_margin.w| 000004c0 5f 77 69 64 74 68 0a 09 09 20 20 20 20 20 20 30 |_width... 0| 000004d0 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d | ---------------| 000004e0 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 09 09 09 7c 09 |----------....|.| 000004f0 7c 09 09 7c 0a 09 09 09 7c 09 7c 09 09 7c 0a 09 ||..|....|.|..|..| 00000500 09 09 7c 09 7c 09 09 7c 0a 09 09 09 7c 09 7c 09 |..|.|..|....|.|.| 00000510 09 7c 0a 09 09 09 7c 09 7c 09 09 7c 0a 09 20 20 |.|....|.|..|.. | 00000520 20 20 20 20 20 77 5f 68 65 69 67 68 74 09 2d 2d | w_height.--| 00000530 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d |----------------| 00000540 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 65 20 71 75 61 |-------..The qua| 00000550 6e 74 69 74 79 20 77 5f 77 69 64 74 68 2d 77 5f |ntity w_width-w_| 00000560 6d 61 72 67 69 6e 20 69 73 20 75 73 75 61 6c 6c |margin is usuall| 00000570 79 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 |y stored in the | 00000580 6d 6f 64 65 20 64 65 70 65 6e 64 65 6e 74 20 62 |mode dependent b| 00000590 79 74 65 0a 77 5f 62 70 6c 20 28 62 79 74 65 73 |yte.w_bpl (bytes| 000005a0 20 70 65 72 20 6c 69 6e 65 29 2e 20 48 6f 77 65 | per line). Howe| 000005b0 76 65 72 20 66 6f 72 20 62 79 74 65 2f 77 6f 72 |ver for byte/wor| 000005c0 64 20 6d 6f 64 65 73 20 74 68 69 73 20 69 73 20 |d modes this is | 000005d0 6e 6f 74 20 74 72 75 65 2c 20 61 6e 64 20 74 68 |not true, and th| 000005e0 65 0a 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 |e.number of byte| 000005f0 73 20 69 6e 20 74 68 65 20 66 69 6c 65 20 74 68 |s in the file th| 00000600 61 74 20 74 68 65 20 6c 69 6e 65 20 72 65 70 72 |at the line repr| 00000610 65 73 65 6e 74 73 20 69 73 20 73 74 6f 72 65 64 |esents is stored| 00000620 20 69 6e 20 77 5f 62 70 6c 2e 0a 0a 41 20 66 75 | in w_bpl...A fu| 00000630 72 74 68 65 72 20 63 6f 6d 70 6c 69 63 61 74 69 |rther complicati| 00000640 6f 6e 20 69 73 20 74 68 61 74 20 74 68 65 20 77 |on is that the w| 00000650 69 6e 64 6f 77 20 74 65 78 74 20 64 69 73 70 6c |indow text displ| 00000660 61 79 20 69 73 20 63 61 63 68 65 64 2e 20 54 68 |ay is cached. Th| 00000670 65 20 73 74 61 72 74 0a 6f 66 20 74 68 65 20 63 |e start.of the c| 00000680 61 63 68 65 64 20 61 72 65 61 20 69 73 20 75 73 |ached area is us| 00000690 65 64 20 61 73 20 61 20 72 65 66 65 72 65 6e 63 |ed as a referenc| 000006a0 65 20 70 6f 69 6e 74 20 66 6f 72 20 77 6f 72 6b |e point for work| 000006b0 69 6e 67 20 6f 75 74 20 74 68 65 20 66 69 6c 65 |ing out the file| 000006c0 0a 6f 66 66 73 65 74 20 6f 66 20 61 20 67 69 76 |.offset of a giv| 000006d0 65 6e 20 70 68 79 73 69 63 61 6c 20 6f 72 20 6c |en physical or l| 000006e0 6f 67 69 63 61 6c 20 6c 69 6e 65 20 6e 75 6d 62 |ogical line numb| 000006f0 65 72 2e 20 54 68 75 73 20 69 74 20 69 73 20 6e |er. Thus it is n| 00000700 6f 74 20 6e 65 63 65 73 73 61 72 79 0a 74 6f 20 |ot necessary.to | 00000710 73 74 61 72 74 20 63 6f 75 6e 74 69 6e 67 20 66 |start counting f| 00000720 72 6f 6d 20 74 68 65 20 73 74 61 72 74 20 6f 66 |rom the start of| 00000730 20 74 68 65 20 66 69 6c 65 20 74 6f 20 66 69 6e | the file to fin| 00000740 64 20 6f 75 74 20 77 68 65 72 65 20 61 20 6c 69 |d out where a li| 00000750 6e 65 20 69 73 2e 20 41 6c 6c 0a 6c 69 6e 65 20 |ne is. All.line | 00000760 72 65 66 65 72 65 6e 63 65 73 20 77 6f 72 6b 20 |references work | 00000770 6c 6f 63 61 6c 6c 79 20 66 72 6f 6d 20 74 68 69 |locally from thi| 00000780 73 20 76 61 6c 75 65 2c 20 77 68 69 63 68 20 69 |s value, which i| 00000790 73 20 74 68 65 20 73 74 61 72 74 20 6f 66 20 74 |s the start of t| 000007a0 68 65 0a 63 61 63 68 65 64 20 64 69 73 70 6c 61 |he.cached displa| 000007b0 79 2c 20 77 68 69 63 68 20 69 73 20 77 68 65 72 |y, which is wher| 000007c0 65 20 74 68 65 20 75 73 65 72 20 69 73 20 6c 69 |e the user is li| 000007d0 6b 65 6c 79 20 74 6f 20 62 65 20 65 64 69 74 69 |kely to be editi| 000007e0 6e 67 21 20 54 68 65 20 63 61 6c 6c 73 0a 5a 61 |ng! The calls.Za| 000007f0 70 5f 46 69 6e 64 4f 66 66 73 65 74 20 61 6e 64 |p_FindOffset and| 00000800 20 5a 61 70 5f 4f 66 66 4c 69 6e 65 43 6f 6c 20 | Zap_OffLineCol | 00000810 75 73 65 20 74 68 69 73 20 66 61 63 74 2e 20 54 |use this fact. T| 00000820 68 65 73 65 20 63 61 6c 6c 73 20 75 73 65 20 74 |hese calls use t| 00000830 68 65 20 6d 6f 64 65 0a 65 6e 74 72 79 20 70 6f |he mode.entry po| 00000840 69 6e 74 73 20 27 65 5f 63 6c 6e 2a 27 2e 20 54 |ints 'e_cln*'. T| 00000850 68 75 73 20 74 68 65 73 65 20 65 6e 74 72 79 20 |hus these entry | 00000860 70 6f 69 6e 74 73 20 73 68 6f 75 6c 64 20 75 73 |points should us| 00000870 65 20 74 68 69 73 20 72 65 66 65 72 65 6e 63 65 |e this reference| 00000880 0a 70 6f 69 6e 74 2e 20 54 68 75 73 20 74 68 65 |.point. Thus the| 00000890 20 6d 6f 64 65 20 77 69 6c 6c 20 6e 65 65 64 20 | mode will need | 000008a0 61 20 70 69 65 63 65 20 6f 66 20 63 6f 64 65 20 |a piece of code | 000008b0 28 75 73 75 61 6c 6c 79 20 63 61 6c 6c 65 64 20 |(usually called | 000008c0 63 6c 6e 5f 62 61 63 6b 77 61 72 64 29 0a 66 6f |cln_backward).fo| 000008d0 72 20 74 72 61 63 69 6e 67 20 6c 69 6e 65 73 20 |r tracing lines | 000008e0 62 61 63 6b 77 61 72 64 73 20 75 70 20 74 68 65 |backwards up the| 000008f0 20 66 69 6c 65 2e 0a 0a 54 68 65 20 63 61 63 68 | file...The cach| 00000900 65 20 69 74 73 65 6c 66 20 63 6f 6e 73 69 73 74 |e itself consist| 00000910 73 20 6f 66 20 61 20 6e 75 6d 62 65 72 20 6f 66 |s of a number of| 00000920 20 6c 69 6e 65 73 20 6f 66 20 77 69 64 74 68 20 | lines of width | 00000930 77 5f 74 78 74 77 2e 20 54 68 69 73 20 77 69 64 |w_txtw. This wid| 00000940 74 68 20 69 73 0a 75 73 75 61 6c 6c 79 20 77 5f |th is.usually w_| 00000950 77 69 64 74 68 20 72 6f 75 6e 64 65 64 20 75 70 |width rounded up| 00000960 20 74 6f 20 74 68 65 20 6e 65 78 74 20 6d 75 6c | to the next mul| 00000970 74 69 70 6c 65 20 6f 66 20 38 2e 20 41 6e 20 65 |tiple of 8. An e| 00000980 78 74 65 6e 73 69 6f 6e 20 6d 6f 64 65 20 6e 65 |xtension mode ne| 00000990 65 64 0a 6e 6f 74 20 75 73 75 61 6c 6c 79 20 63 |ed.not usually c| 000009a0 6f 6e 63 65 72 6e 20 69 74 73 65 6c 66 20 77 69 |oncern itself wi| 000009b0 74 68 20 74 68 69 73 20 63 61 63 68 65 20 75 6e |th this cache un| 000009c0 6c 65 73 73 20 69 74 20 69 73 20 64 72 61 77 69 |less it is drawi| 000009d0 6e 67 20 69 74 73 20 6f 77 6e 0a 64 69 73 70 6c |ng its own.displ| 000009e0 61 79 2e 20 53 65 65 20 74 68 65 20 6d 6f 64 65 |ay. See the mode| 000009f0 20 65 6e 74 72 79 20 70 6f 69 6e 74 20 65 5f 72 | entry point e_r| 00000a00 65 64 72 61 77 6c 69 6e 65 20 69 6e 20 77 68 69 |edrawline in whi| 00000a10 63 68 20 79 6f 75 20 61 72 65 20 61 73 6b 65 64 |ch you are asked| 00000a20 20 74 6f 20 66 69 6c 6c 0a 61 20 6c 69 6e 65 20 | to fill.a line | 00000a30 69 6e 20 74 68 65 20 63 61 63 68 65 2e 0a 0a 54 |in the cache...T| 00000a40 68 65 20 77 69 6e 64 6f 77 20 62 6c 6f 63 6b 20 |he window block | 00000a50 6f 66 66 73 65 74 73 20 61 72 65 20 64 65 73 63 |offsets are desc| 00000a60 72 69 62 65 64 20 62 65 6c 6f 77 2e 20 55 73 65 |ribed below. Use| 00000a70 20 45 2d 4c 69 62 72 61 72 79 20 74 6f 20 73 65 | E-Library to se| 00000a80 74 20 75 70 20 74 68 65 0a 64 65 66 69 6e 69 74 |t up the.definit| 00000a90 69 6f 6e 73 2e 0a 0a 77 5f 68 61 6e 64 6c 65 0a |ions...w_handle.| 00000aa0 77 5f 6d 69 6e 78 0a 77 5f 6d 69 6e 79 0a 77 5f |w_minx.w_miny.w_| 00000ab0 6d 61 78 78 0a 77 5f 6d 61 78 79 0a 77 5f 73 63 |maxx.w_maxy.w_sc| 00000ac0 72 6f 6c 6c 78 0a 77 5f 73 63 72 6f 6c 6c 79 0a |rollx.w_scrolly.| 00000ad0 77 5f 69 6e 66 72 6f 6e 74 0a 77 5f 77 69 6e 64 |w_infront.w_wind| 00000ae0 6f 77 66 6c 61 67 73 0a 54 68 65 73 65 20 61 72 |owflags.These ar| 00000af0 65 20 61 73 20 66 6f 72 20 61 20 77 69 6d 70 20 |e as for a wimp | 00000b00 77 69 6e 64 6f 77 20 62 6c 6f 63 6b 2e 20 53 65 |window block. Se| 00000b10 65 20 50 52 4d 20 69 66 20 69 6e 20 64 6f 75 62 |e PRM if in doub| 00000b20 74 2e 0a 0a 77 5f 66 69 6c 65 0a 47 69 76 65 73 |t...w_file.Gives| 00000b30 20 74 68 65 20 66 69 6c 65 20 6f 66 66 73 65 74 | the file offset| 00000b40 20 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74 | of the associat| 00000b50 65 64 20 66 69 6c 65 2e 20 55 73 65 20 5a 61 70 |ed file. Use Zap| 00000b60 5f 43 6f 6e 76 46 69 6c 65 4f 66 66 20 74 6f 20 |_ConvFileOff to | 00000b70 63 6f 6e 76 65 72 74 0a 74 68 69 73 20 74 6f 20 |convert.this to | 00000b80 61 20 66 69 6c 65 20 70 6f 69 6e 74 65 72 20 69 |a file pointer i| 00000b90 6e 20 52 39 2e 20 54 68 69 73 20 69 73 20 64 6f |n R9. This is do| 00000ba0 6e 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 |ne automatically| 00000bb0 20 66 6f 72 20 79 6f 75 20 62 79 0a 5a 61 70 5f | for you by.Zap_| 00000bc0 43 6f 6e 76 57 69 6e 64 4f 66 66 2e 0a 0a 77 5f |ConvWindOff...w_| 00000bd0 66 6f 72 6d 61 74 0a 47 69 76 65 73 20 74 68 65 |format.Gives the| 00000be0 20 64 69 73 70 6c 61 79 20 66 6f 72 6d 61 74 20 | display format | 00000bf0 66 6c 61 67 73 20 61 6e 64 20 74 68 65 20 6d 6f |flags and the mo| 00000c00 64 65 20 74 68 65 20 77 69 6e 64 6f 77 20 69 73 |de the window is| 00000c10 20 69 6e 2e 20 53 65 65 20 45 2d 46 6c 61 67 73 | in. See E-Flags| 00000c20 20 66 6f 72 0a 64 65 74 61 69 6c 73 2e 0a 0a 77 | for.details...w| 00000c30 5f 77 69 64 74 68 0a 57 69 64 74 68 20 6f 66 20 |_width.Width of | 00000c40 77 69 6e 64 6f 77 20 69 6e 20 63 6f 6c 75 6d 6e |window in column| 00000c50 73 20 28 69 6e 63 6c 75 64 69 6e 67 20 74 68 65 |s (including the| 00000c60 20 6d 61 72 67 69 6e 29 2e 0a 0a 77 5f 68 65 69 | margin)...w_hei| 00000c70 67 68 74 0a 48 65 69 67 68 74 20 6f 66 20 77 69 |ght.Height of wi| 00000c80 6e 64 6f 77 20 69 6e 20 6c 69 6e 65 73 2e 0a 0a |ndow in lines...| 00000c90 77 5f 74 78 74 0a 41 64 64 72 65 73 73 20 6f 66 |w_txt.Address of| 00000ca0 20 74 65 78 74 20 63 61 63 68 65 2e 0a 0a 77 5f | text cache...w_| 00000cb0 74 78 74 68 0a 4e 75 6d 62 65 72 20 6f 66 20 6c |txth.Number of l| 00000cc0 69 6e 65 73 20 63 6c 61 69 6d 65 64 20 66 6f 72 |ines claimed for| 00000cd0 20 74 78 74 20 63 61 63 68 65 2e 0a 0a 77 5f 74 | txt cache...w_t| 00000ce0 78 74 77 0a 57 69 64 74 68 20 6f 66 20 61 20 74 |xtw.Width of a t| 00000cf0 65 78 74 20 63 61 63 68 65 20 6c 69 6e 65 20 69 |ext cache line i| 00000d00 6e 20 63 68 61 72 61 63 74 65 72 73 2e 20 4d 75 |n characters. Mu| 00000d10 73 74 20 62 65 20 61 20 6d 75 6c 74 69 70 6c 65 |st be a multiple| 00000d20 20 6f 66 20 38 2e 0a 0a 77 5f 74 78 74 6e 0a 4e | of 8...w_txtn.N| 00000d30 75 6d 62 65 72 20 6f 66 20 6c 69 6e 65 73 20 63 |umber of lines c| 00000d40 61 63 68 65 64 20 69 6e 20 74 68 65 20 74 78 74 |ached in the txt| 00000d50 20 63 61 63 68 65 2e 0a 0a 77 5f 63 6f 66 66 0a | cache...w_coff.| 00000d60 52 65 66 65 72 65 6e 63 65 20 70 6f 69 6e 74 20 |Reference point | 00000d70 67 69 76 69 6e 67 20 74 68 65 20 66 69 6c 65 20 |giving the file | 00000d80 6f 66 66 73 65 74 20 6f 66 20 74 68 65 20 73 74 |offset of the st| 00000d90 61 72 74 20 6f 66 20 74 68 65 20 66 69 72 73 74 |art of the first| 00000da0 20 63 61 63 68 65 64 0a 70 68 79 73 69 63 61 6c | cached.physical| 00000db0 20 6c 69 6e 65 2e 0a 0a 77 5f 63 6c 69 6e 65 0a | line...w_cline.| 00000dc0 52 65 66 65 72 65 6e 63 65 20 70 6f 69 6e 74 20 |Reference point | 00000dd0 67 69 76 69 6e 67 20 74 68 65 20 70 68 79 73 69 |giving the physi| 00000de0 63 61 6c 20 6c 69 6e 65 20 6e 75 6d 62 65 72 20 |cal line number | 00000df0 28 66 69 72 73 74 20 6c 69 6e 65 20 30 29 20 6f |(first line 0) o| 00000e00 66 20 74 68 65 20 73 74 61 72 74 0a 6f 66 20 74 |f the start.of t| 00000e10 68 65 20 66 69 72 73 74 20 63 61 63 68 65 64 20 |he first cached | 00000e20 70 68 79 73 69 63 61 6c 20 6c 69 6e 65 2e 0a 0a |physical line...| 00000e30 77 5f 63 6c 6f 67 6c 0a 41 73 20 66 6f 72 20 77 |w_clogl.As for w| 00000e40 5f 63 6c 69 6e 65 20 62 75 74 20 67 69 76 65 73 |_cline but gives| 00000e50 20 74 68 65 20 6c 6f 67 69 63 61 6c 20 6c 69 6e | the logical lin| 00000e60 65 20 6e 75 6d 62 65 72 2e 0a 0a 77 5f 74 61 62 |e number...w_tab| 00000e70 0a 47 69 76 65 73 20 74 68 65 20 63 6f 6c 74 61 |.Gives the colta| 00000e80 62 20 77 69 64 74 68 2e 0a 0a 77 5f 74 61 62 63 |b width...w_tabc| 00000e90 0a 47 69 76 65 73 20 74 68 65 20 63 68 61 72 61 |.Gives the chara| 00000ea0 63 74 65 72 20 63 6f 64 65 20 74 61 62 20 6d 61 |cter code tab ma| 00000eb0 73 6b 20 28 78 34 29 20 65 67 20 26 30 39 30 39 |sk (x4) eg &0909| 00000ec0 30 39 30 39 2e 20 53 65 74 20 74 68 69 73 20 74 |0909. Set this t| 00000ed0 6f 20 74 68 65 20 73 61 6d 65 20 61 73 0a 77 5f |o the same as.w_| 00000ee0 63 72 20 69 66 20 79 6f 75 20 77 61 6e 74 20 74 |cr if you want t| 00000ef0 68 65 20 74 61 62 73 20 74 6f 20 62 65 20 69 6e |he tabs to be in| 00000f00 76 69 73 69 62 6c 65 2e 0a 0a 77 5f 63 72 0a 47 |visible...w_cr.G| 00000f10 69 76 65 73 20 74 68 65 20 6c 69 6e 65 20 74 65 |ives the line te| 00000f20 72 6d 69 6e 61 74 6f 72 20 6d 61 73 6b 20 28 78 |rminator mask (x| 00000f30 34 29 20 65 67 20 26 30 41 30 41 30 41 30 41 2e |4) eg &0A0A0A0A.| 00000f40 0a 0a 77 5f 66 6c 61 67 73 0a 47 69 76 65 73 20 |..w_flags.Gives | 00000f50 74 68 65 20 66 6c 61 67 73 20 73 74 61 74 75 73 |the flags status| 00000f60 20 66 6f 72 20 74 68 69 73 20 77 69 6e 64 6f 77 | for this window| 00000f70 2e 20 53 65 65 20 45 2d 46 6c 61 67 73 2e 20 57 |. See E-Flags. W| 00000f80 68 65 6e 20 61 20 77 69 6e 64 6f 77 20 69 73 20 |hen a window is | 00000f90 63 72 65 61 74 65 64 0a 74 68 65 20 64 65 66 61 |created.the defa| 00000fa0 75 6c 74 20 76 61 6c 75 65 20 69 73 20 74 61 6b |ult value is tak| 00000fb0 65 6e 20 66 72 6f 6d 20 6f 70 74 5f 66 6c 61 67 |en from opt_flag| 00000fc0 73 2e 0a 0a 77 5f 74 69 74 6c 65 0a 50 6f 69 6e |s...w_title.Poin| 00000fd0 74 73 20 74 6f 20 74 68 65 20 77 69 6e 64 6f 77 |ts to the window| 00000fe0 20 74 69 74 6c 65 2e 0a 0a 77 5f 62 70 6c 0a 4d | title...w_bpl.M| 00000ff0 6f 64 65 20 64 65 70 65 6e 64 65 6e 74 20 77 6f |ode dependent wo| 00001000 72 64 2e 20 55 73 75 61 6c 6c 79 20 73 74 6f 72 |rd. Usually stor| 00001010 65 73 20 74 68 65 20 77 69 64 74 68 20 6f 66 20 |es the width of | 00001020 74 68 65 20 64 69 73 70 6c 61 79 20 69 6e 20 63 |the display in c| 00001030 68 61 72 61 63 74 65 72 73 2e 0a 42 79 74 65 20 |haracters..Byte | 00001040 6d 6f 64 65 20 73 74 6f 72 65 73 20 74 68 65 20 |mode stores the | 00001050 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 20 |number of bytes | 00001060 73 68 6f 77 6e 20 6f 6e 20 65 61 63 68 20 6c 69 |shown on each li| 00001070 6e 65 20 65 74 63 2e 0a 0a 77 5f 6d 61 72 67 69 |ne etc...w_margi| 00001080 6e 0a 57 69 64 74 68 20 6f 66 20 74 68 65 20 6c |n.Width of the l| 00001090 65 66 74 20 68 61 6e 64 20 6d 61 72 67 69 6e 20 |eft hand margin | 000010a0 69 6e 20 63 68 61 72 61 63 74 65 72 73 2e 0a 0a |in characters...| 000010b0 77 5f 72 6c 0a 48 65 69 67 68 74 20 69 6e 20 70 |w_rl.Height in p| 000010c0 69 78 65 6c 73 20 6f 66 20 65 61 63 68 20 63 68 |ixels of each ch| 000010d0 61 72 61 63 74 65 72 20 69 6e 63 6c 75 64 69 6e |aracter includin| 000010e0 67 20 74 68 65 20 6c 69 6e 65 20 73 70 61 63 69 |g the line spaci| 000010f0 6e 67 2e 0a 0a 77 5f 72 77 0a 57 69 64 74 68 20 |ng...w_rw.Width | 00001100 69 6e 20 70 69 78 65 6c 73 20 6f 66 20 65 61 63 |in pixels of eac| 00001110 68 20 63 68 61 72 61 63 74 65 72 2e 0a 0a 77 5f |h character...w_| 00001120 72 68 0a 48 65 69 67 68 74 20 69 6e 20 70 69 78 |rh.Height in pix| 00001130 65 6c 73 20 6f 66 20 65 61 63 68 20 63 68 61 72 |els of each char| 00001140 61 63 74 65 72 20 65 78 63 6c 75 64 69 6e 67 20 |acter excluding | 00001150 6c 69 6e 65 20 73 70 61 63 69 6e 67 2e 0a 0a 77 |line spacing...w| 00001160 5f 61 64 64 72 0a 41 64 64 72 65 73 73 20 74 6f |_addr.Address to| 00001170 20 73 68 6f 77 20 69 6e 20 6d 61 72 67 69 6e 20 | show in margin | 00001180 66 6f 72 20 66 69 6c 65 20 6f 66 66 73 65 74 20 |for file offset | 00001190 30 2e 0a 0a 77 5f 73 74 6c 69 6e 65 0a 4c 69 6e |0...w_stline.Lin| 000011a0 65 20 6e 75 6d 62 65 72 20 74 6f 20 73 68 6f 77 |e number to show| 000011b0 20 69 6e 20 6d 61 72 67 69 6e 20 66 6f 72 20 6c | in margin for l| 000011c0 69 6e 65 20 6f 66 66 73 65 74 20 30 2e 0a 0a 77 |ine offset 0...w| 000011d0 5f 74 69 74 6c 65 6c 65 6e 0a 77 5f 74 69 74 62 |_titlelen.w_titb| 000011e0 75 66 0a 77 5f 74 69 74 6c 65 6e 0a 55 73 65 64 |uf.w_titlen.Used| 000011f0 20 69 6e 74 65 72 6e 61 6c 6c 79 20 66 6f 72 20 | internally for | 00001200 74 69 74 6c 65 20 75 70 64 61 74 65 2e 0a 0a 77 |title update...w| 00001210 5f 6d 77 69 64 74 68 0a 55 73 65 72 20 72 65 71 |_mwidth.User req| 00001220 75 69 72 65 64 20 6d 61 72 67 69 6e 20 77 69 64 |uired margin wid| 00001230 74 68 20 62 65 66 6f 72 65 20 73 70 61 63 65 20 |th before space | 00001240 66 6f 72 20 6c 69 6e 65 20 6e 75 6d 62 65 72 73 |for line numbers| 00001250 20 61 64 64 65 64 2e 0a 0a 77 5f 74 61 62 63 68 | added...w_tabch| 00001260 61 72 0a 55 73 65 72 20 72 65 71 75 69 72 65 64 |ar.User required| 00001270 20 74 61 62 20 63 68 61 72 61 63 74 65 72 20 63 | tab character c| 00001280 6f 64 65 20 78 34 20 28 65 67 20 26 30 39 30 39 |ode x4 (eg &0909| 00001290 30 39 30 39 29 20 62 65 66 6f 72 65 20 74 61 62 |0909) before tab| 000012a0 20 76 69 73 69 62 69 6c 69 74 79 0a 74 61 6b 65 | visibility.take| 000012b0 6e 20 69 6e 74 6f 20 61 63 63 6f 75 6e 74 2e 0a |n into account..| 000012c0 0a 77 5f 6c 69 6e 65 73 70 0a 55 73 65 72 20 72 |.w_linesp.User r| 000012d0 65 71 75 69 72 65 64 20 6c 69 6e 65 20 73 70 61 |equired line spa| 000012e0 63 69 6e 67 20 69 6e 20 31 2f 38 74 68 73 20 63 |cing in 1/8ths c| 000012f0 68 61 72 2e 0a 0a 77 5f 73 61 76 65 64 6f 0a 77 |har...w_savedo.w| 00001300 5f 73 61 76 65 64 6c 0a 77 5f 73 61 76 65 64 63 |_savedl.w_savedc| 00001310 0a 77 5f 73 61 76 65 64 68 0a 77 5f 73 61 76 65 |.w_savedh.w_save| 00001320 64 6c 63 0a 55 73 65 64 20 69 6e 74 65 72 6e 61 |dlc.Used interna| 00001330 6c 6c 79 20 62 79 20 5a 61 70 5f 44 6f 43 6f 6d |lly by Zap_DoCom| 00001340 6d 61 6e 64 20 61 6e 64 20 5a 61 70 5f 53 61 76 |mand and Zap_Sav| 00001350 65 57 69 6e 53 74 61 74 75 73 0a 0a 77 5f 77 72 |eWinStatus..w_wr| 00001360 61 70 77 69 64 74 68 0a 57 6f 72 64 77 72 61 70 |apwidth.Wordwrap| 00001370 20 77 69 64 74 68 2e 0a 0a 77 5f 74 6f 67 6d 69 | width...w_togmi| 00001380 6e 78 0a 77 5f 74 6f 67 6d 69 6e 79 0a 77 5f 74 |nx.w_togminy.w_t| 00001390 6f 67 6d 61 78 78 0a 77 5f 74 6f 67 6d 61 78 79 |ogmaxx.w_togmaxy| 000013a0 0a 54 68 65 73 65 20 73 61 76 65 20 74 68 65 20 |.These save the | 000013b0 27 73 6d 61 6c 6c 27 20 77 69 6e 64 6f 77 20 70 |'small' window p| 000013c0 6f 73 69 74 69 6f 6e 20 66 6f 72 20 74 68 65 20 |osition for the | 000013d0 74 6f 67 67 6c 65 20 73 69 7a 65 20 6b 65 79 20 |toggle size key | 000013e0 28 73 63 47 29 2e 0a 0a 77 5f 72 65 73 30 2d 77 |(scG)...w_res0-w| 000013f0 5f 72 65 73 31 35 0a 52 65 73 65 72 76 65 64 20 |_res15.Reserved | 00001400 77 6f 72 64 73 0a 0a 77 5f 6d 6f 64 65 30 2d 77 |words..w_mode0-w| 00001410 5f 6d 6f 64 65 31 35 0a 4d 6f 64 65 20 77 6f 72 |_mode15.Mode wor| 00001420 64 73 2e 20 45 61 63 68 20 6d 6f 64 65 20 68 61 |ds. Each mode ha| 00001430 73 20 6f 6e 65 20 77 6f 72 64 20 69 6e 20 65 61 |s one word in ea| 00001440 63 68 20 69 6e 20 77 69 6e 64 6f 77 20 69 6e 20 |ch in window in | 00001450 77 68 69 63 68 20 74 6f 20 73 74 6f 72 65 20 74 |which to store t| 00001460 68 65 0a 6f 70 74 69 6f 6e 73 20 70 65 72 74 61 |he.options perta| 00001470 69 6e 69 6e 67 20 74 6f 20 74 68 61 74 20 6d 6f |ining to that mo| 00001480 64 65 2e 20 53 65 65 20 74 68 65 20 45 2d 46 6c |de. See the E-Fl| 00001490 61 67 73 20 66 69 6c 65 20 66 6f 72 20 74 68 65 |ags file for the| 000014a0 20 73 75 67 67 65 73 74 65 64 0a 66 6f 72 6d 61 | suggested.forma| 000014b0 74 20 6f 66 20 74 68 69 73 20 77 6f 72 64 2e 20 |t of this word. | 000014c0 54 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 |The default valu| 000014d0 65 73 20 6f 66 20 74 68 65 73 65 20 77 6f 72 64 |es of these word| 000014e0 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e 0a |s are stored in.| 000014f0 6f 70 74 5f 6d 6f 64 65 30 2d 6f 70 74 5f 6d 6f |opt_mode0-opt_mo| 00001500 64 65 31 35 2e 20 55 73 65 20 5a 61 70 5f 52 65 |de15. Use Zap_Re| 00001510 61 64 56 61 72 20 74 6f 20 67 65 74 20 61 74 20 |adVar to get at | 00001520 74 68 65 73 65 2e 0a |these..| 00001527
.