--------------------------------------------------------------------------------
MODULE    IWINDOW

-------------------------------------------------------------------------------- REPLACES DAMP modules ICLIP and OSCLIP

--------------------------------------------------------------------------------

FUNCTION

IWINDOW clips IFF map data to a rectangular boundary or "window".

--------------------------------------------------------------------------------

FORMAT


--------------------------------------------------------------------------------

RESTRICTIONS

-------------------------------------------------------------------------------- PROMPTS

--------------------------------------------------------------------------------

PARAMETERS

--------------------------------------------------------------------------------

COMMAND QUALIFIERS

--------------------------------------------------------------------------------

ORDNANCE SURVEY MODE

--------------------------------------------------------------------------------

DESCRIPTION

--------------------------------------------------------------------------------

PROGRAM OPERATION

--------------------------------------------------------------------------------

EXAMPLES

$ IWINDOW/CONTROL_POINTS/WEST=9600/SOUTH=23100/LAYER_IGNORE=3 DFAD1 NEW_DFAD1
 ELAPSED: 00:00:49.0 CPU: 0:00:26.69  BUFIO: 4  DIRIO: 602  FAULTS: 177 
$
$
$ IWINDOW/MAP_HEADER/SOUTH=14100/NORTH=18600/EAST=14100/VOID/LOG
_From: DFAD2
_To: NEW_DFAD2
%LSLLIB-I-OPENED, IFF file DUA0:[JAMIE.TEST]DFAD2.IFF;0 opened for read
Bounds N =18600.0, S =14100.0, E =14100.0, W = 600.000
Clipping not suppressed for any feature codes
Clipping not suppressed for any layers
Clipping to void
 
%LSLLIB-I-OPENED, IFF file DUA0:[JAMIE.TEST]NEW_DFAD2.IFF opened for write
%IWIN-I-LAYER, layer 0 found
Layer 0: 0 features deleted, 0 clipped and 0 created
 
%IWIN-I-LAYER, layer 1 found
Feature 1 (1) split 1 time
Feature 45 (45) deleted
Feature 46 (46) deleted
Feature 47 (47) deleted
Feature 48 (48) deleted
Feature 49 (49) split 1 time
Feature 50 (50) split 3 times
Feature 51 (51) deleted
Feature 52 (52) deleted
Feature 53 (53) deleted
Feature 54 (54) deleted
Feature 55 (55) deleted
Feature 56 (56) deleted
Feature 57 (57) deleted
Feature 58 (58) deleted
Feature 59 (59) deleted
Feature 60 (60) deleted
Feature 61 (61) deleted
Feature 62 (62) deleted
Feature 63 (63) deleted
Feature 64 (64) deleted
Feature 65 (65) deleted
Feature 66 (66) deleted
Feature 67 (67) deleted
Feature 68 (68) deleted
Feature 69 (69) deleted
Feature 70 (70) deleted
Feature 71 (71) deleted
Feature 72 (72) deleted
Feature 73 (73) deleted
Feature 74 (74) deleted
Feature 75 (75) was clipped
Feature 100 (100) deleted
Feature 101 (101) deleted
Feature 102 (102) deleted
Feature 103 (103) deleted
Feature 104 (104) deleted
Feature 105 (105) deleted
Feature 106 (106) deleted
Feature 108 (108) deleted
Feature 109 (109) deleted
Feature 110 (110) deleted
Feature 111 (111) deleted
Feature 112 (112) deleted
Feature 113 (113) deleted
Feature 114 (114) split 1 time
Feature 124 (124) deleted
Feature 125 (125) split 1 time
Layer 1: 42 features deleted, 6 clipped and 7 created
%IWIN-I-LAYER, layer 2 found
Feature 346 (346) deleted
Feature 347 (347) deleted
Feature 348 (348) deleted
Feature 349 (349) deleted
Feature 350 (350) deleted
Layer 2: 5 features deleted, 0 clipped and 0 created
 
%IWIN-I-LAYER, layer 3 found
Single point feature 2576 (2576) deleted
Single point feature 2577 (2577) deleted
Single point feature 2582 (2582) deleted
Single point feature 2858 (2858) deleted
Single point feature 2859 (2859) deleted
Single point feature 2860 (2860) deleted
Feature 2910 split 1 time
Layer 3: 6 features deleted, 1 clipped and 1 created
 
Summary: 53 features deleted, 7 clipped and 8 created
         Features 10832 to 10839 were created
         No layers suppressed from clipping
 ELAPSED: 00:01:05.23  CPU: 0:00:35.55  BUFIO: 9  DIRIO: 673  FAULTS: 126 
$
$ IWINDOW/OS/NORTH=500/CLIP_GRID/LOG/OUTPUT=SP8061 SP8061 SP8061S
%LSLLIB-I-OPENED, IFF file DUA0:[LSL.IFF]SP8061.IFF;7 opened for read
%LSLLIB-I-OPENED, IFF file DUA0:[LSL.IFF]SP8061S.IFF;4 opened for write
%IWIN-I-LAYER, layer 1 found
%IWIN-I-LAYER, layer 11 found
 ELAPSED: 00:00:36.60  CPU: 0:00:18.15  BUFIO: 9  DIRIO: 341  FAULTS: 144 
$


=================================== IWINDOW ======================================

IWINDOW invoked by: JAMIE, Process: Jamie Hulme, on: 28-AUG-86 13:05:13

Input file  : LSL$IF:SP8061.IFF;0

Running in OS mode
Bounds N = 500.000, S =   0.000, E =1000.000, W =   0.000
Clipping not suppressed for any feature codes
Clipping texts
Clipping grids
 
Output file : LSL$IF:SP8061S.IFF

Feature 124 (124) was clipped
Feature 190 (190) was clipped
Feature 191 (191) was clipped
Feature 214 (214) was clipped
Feature 215 (215) was clipped
Feature 217 (217) was clipped
Feature 240 (240) was clipped
Feature 247 (247) was clipped
Feature 248 (248) was clipped
Feature 251 (251) was clipped
Feature 254 (254) was clipped
Feature 260 (260) was clipped
Feature 277 (277) was clipped
Feature 300 (300) was clipped
Single point feature 303 (303) deleted
Single point feature 304 (304) deleted
Single point feature 305 (305) deleted
Single point feature 306 (306) deleted
Single point feature 307 (307) deleted
Single point feature 308 (308) deleted
Single point feature 309 (309) deleted
Single point feature 310 (310) deleted
Single point feature 311 (311) deleted
Feature 317 (317) was clipped
Feature 351 (351) was clipped
Layer 1: 9 features deleted, 16 clipped and 0 created
 
Feature 9974 (9974) deleted
Feature 9975 (9975) deleted
Feature 9976 (9976) deleted
Feature 9977 (9977) deleted
Feature 9978 (9978) deleted
Feature 9980 (9980) was clipped
Feature 9981 (9981) was clipped
Feature 9982 (9982) was clipped
Feature 9983 (9983) was clipped
Feature 9984 (9984) was clipped
Feature 9985 (9985) deleted
Feature 9986 (9986) was clipped
Feature 9987 (9987) was clipped
Feature 9988 (9988) was clipped
Feature 9989 (9989) was clipped
Feature 9990 (9990) was clipped
Feature 9991 (9991) was clipped
Feature 9992 (9992) was clipped
Feature 9993 (9993) was clipped
Feature 9994 (9994) was clipped
Feature 9995 (9995) was clipped
Layer 11: 6 features deleted, 15 clipped and 0 created
 
Summary: 15 features deleted, 31 clipped and 0 created

--------------------------------------------------------------------------------

MESSAGES (SUCCESS)

These messages indicate that the program has completed successfully.

--------------------------------------------------------------------------------

MESSAGES (INFORMATIONAL)

These messages give information only, and require no immediate action by the user (except perhaps to verify that the correct options have been selected). Those referring to the opening and closing of IFF files, and the notification of layers, will only appear if /LOG has been specified on the command line. The messages giving boundary information are continuation messages and will appear regardless of /LOG.

--------------------------------------------------------------------------------

MESSAGES (WARNING)

These messages indicate that IWINDOW has been unable to guarantee that features can been correctly clipped.

--------------------------------------------------------------------------------

MESSAGES (ERROR)

These messages indicate an error in processing which has caused the program to terminate. The most likely causes are a corrupt or otherwise invalid input IFF file, or an error related to command line processing and file manipulation. Some of the messages may indicate a programming error. All result in the deletion of the output IFF file.

--------------------------------------------------------------------------------

MESSAGES (OTHER)

In addition to the above messages which are generated by IWINDOW itself, other messages may be produced by the command line interpreter (CLI) and by Laser-Scan libraries. In particular, messages may be generated by the IFF library. These are introduced by '%IFF' and are documented in the IFF library users' guide. In most cases IFF errors will be due to a corrupt input file, and this should be the first area of investigation. If the cause of the error cannot be traced by the user and Laser-Scan are consulted, then the input file should be preserved to facilitate diagnosis.