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
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html >
<head><title>Image processing window</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="generator" content="TeX4ht (http://www.tug.org/tex4ht/)">
<meta name="originator" content="TeX4ht (http://www.tug.org/tex4ht/)">
<!-- 3,html -->
<meta name="src" content="nipguide.tex">
<link rel="stylesheet" type="text/css" href="nipguide.css">
</head><body
>
<!--l. 186--><div class="crosslinks"><p class="noindent">[<a
href="nipguidese12.html" >next</a>] [<a
href="nipguidese10.html" >prev</a>] [<a
href="nipguidese10.html#tailnipguidese10.html" >prev-tail</a>] [<a
href="#tailnipguidese11.html">tail</a>] [<a
href="nipguidech4.html#nipguidese11.html" >up</a>] </p></div>
<h3 class="sectionHead"><span class="titlemark">4.3 </span> <a
id="x19-300004.3"></a>Image processing window</h3>
<!--l. 187--><p class="noindent" ><a name="nip_label_sec:ipwindow"></a>
<!--l. 189--><p class="indent" > Figure <a
href="#x19-300015">4.5<!--tex4ht:ref: fg:startup --></a> shows <span
class="phvr7t-x-x-80">nip2</span>’s main image processing window.
The centre area is the workspace, the left-hand area is a
pane you can reveal to write custom definitions for this
workspace (see <span
class="phvr7t-x-x-80">View </span>/ <span
class="phvr7t-x-x-80">Workspace Definitions</span>), and the
right-hand pane is the toolkit browser (see <span
class="phvr7t-x-x-80">View </span>/ <span
class="phvr7t-x-x-80">Toolkit</span>
<span
class="phvr7t-x-x-80">Browser</span>).
<!--l. 195--><p class="indent" > Drag with the middle mouse button to scroll the
workspace window. Drop a file on to the workspace
background (from your file manager) to load that file. If you
right-click on the workspace background, a useful menu
will appear.
<!--l. 199--><p class="indent" > <hr class="figure"><div class="figure"
>
<a
id="x19-300015"></a>
<div class="center"
>
<!--l. 200--><p class="noindent" >
<!--l. 200--><p class="noindent" ><img
src="figs/ir7.jpg" alt="PIC"
></div>
<br /> <div class="caption"
><span class="id">Figure 4.5: </span><span
class="content"><span
class="phvr7t-x-x-80">nip2</span>’s main image processing window</span></div><!--tex4ht:label?: x19-300015 -->
<!--l. 202--><p class="noindent" ><a name="nip_label_fg:startup"></a>
<!--l. 203--><p class="indent" > </div><hr class="endfigure">
<dl class="description"><dt class="description">
<span
class="ptmb7t-">Workspace</span> </dt><dd
class="description">A workspace is split into a set of separate
tabs. Right-click on a tab to get a useful menu.
Press the add icon at the right to make a new tab.
You can drag tabs between workspaces, or drag a
tab to the desktop to make a new workspace. Use
the syntax <span
class="phvr7t-x-x-80">tab1.A1 </span>to make references between tabs.
</dd><dt class="description">
<span
class="ptmb7t-">Tab</span> </dt><dd
class="description">This area displays the current tab. Tabs are divided
into columns of objects which each behave rather
like windows: they can be moved around, folded
away, loaded, saved and deleted.
</dd><dt class="description">
<span
class="ptmb7t-">Current column</span> </dt><dd
class="description">One column is the current column.
This is the column to which all new objects are
added. Single-left-clicking on the title bar of a
column makes that the current column. See <span
class="cmsy-10"></span><a
href="#x19-310004.3.1">4.3.1<!--tex4ht:ref: sec:column --></a>.
</dd><dt class="description">
<span
class="ptmb7t-">File, Edit, View</span> </dt><dd
class="description">Use the <span
class="phvr7t-x-x-80">File </span>menu to create or save
workspaces, to open workspaces or load other
objects into this workspace, to merge workspaces
and to search for workspace backups. Use the <span
class="phvr7t-x-x-80">Edit</span>
menu to select, group, delete and duplicate sets of
objects. Use <span
class="phvr7t-x-x-80">View </span>to show and hide elements of the
main window, and to set the object view mode.
</dd><dt class="description">
<span
class="ptmb7t-">Toolkits</span> </dt><dd
class="description">This menu contains all of
the image processing functions which are currently
loaded into <span
class="phvr7t-x-x-80">nip2</span>. They are generally grouped by
object type: all of the operations on matricies are
under <span
class="phvr7t-x-x-80">Toolkits </span>/ <span
class="phvr7t-x-x-80">Matrix</span>, for example.
<!--l. 236--><p class="noindent" >If you select one of these image processing
operations, <span
class="phvr7t-x-x-80">nip2 </span>will apply that operation to the
bottom few items in the current column (however
many are necessary — two items for <span
class="phvr7t-x-x-80">Math </span>/
<span
class="phvr7t-x-x-80">Arithmetic </span>/ <span
class="phvr7t-x-x-80">Add</span>, for example), or alternatively, if
you have selected some objects explicitly, it will try
to apply the operation to the selected objects. See
<span
class="cmsy-10"></span><a
href="#x19-340004.3.3">4.3.3<!--tex4ht:ref: sec:apply --></a>. As you move the mouse pointer over menu
items <span
class="phvr7t-x-x-80">nip2 </span>tries to display some helpful information
about the operation, including the number and type
of arguments the operation expects.
</dd><dt class="description">
<span
class="ptmb7t-">Toolkit Browser</span> </dt><dd
class="description">This side panel shows all the image processing operations again, but this time as a large
flat list you can easily browse. Type into the search
box at the top to filter operations by keyword.
Doubleclick on an item to activate it.
</dd><dt class="description">
<span
class="ptmb7t-">Tab Definitions</span> </dt><dd
class="description">
This side pane shows private definitions for this
tab. Programs you write here are loaded and saved
with this workspace. See the Programming chapter
for details on <span
class="phvr7t-x-x-80">nip2</span>’s programming language.
</dd><dt class="description">
<span
class="ptmb7t-">Free space</span> </dt><dd
class="description">This displays the amount of disc space you
have left in your temporary file area. See <span
class="cmsy-10"></span><a
href="nipguideap1.html#x48-89000A">A<!--tex4ht:ref: sec:config --></a> if
you want to change the directory <span
class="phvr7t-x-x-80">nip2 </span>uses to store
temporary files.
<!--l. 260--><p class="noindent" >If you left-click on the label, it changes to display
the space <span
class="phvr7t-x-x-80">nip2 </span>has free internally for performing
calculations. You can change this limit in the
<span
class="phvr7t-x-x-80">Preferences </span>workspace. Click again to switch back
to disc free.
<!--l. 264--><p class="noindent" >If you have objects selected, this area changes to
show the names of the selected objects.
</dd><dt class="description">
<span
class="ptmb7t-">Status bar</span> </dt><dd
class="description">As you move the mouse pointer about the
window, this bar tries to display useful information
about the thing you are pointing at.
</dd></dl>
<h4 class="subsectionHead"><span class="titlemark">4.3.1 </span> <a
id="x19-310004.3.1"></a>Columns</h4>
<!--l. 274--><p class="noindent" ><a name="nip_label_sec:column"></a>
<!--l. 276--><p class="indent" > Columns are split into a number of areas:
<dl class="description"><dt class="description">
<span
class="ptmb7t-">Column name</span> </dt><dd
class="description">Each column has a name. You can pick
any name you like when you make a new column
with <span
class="phvr7t-x-x-80">File </span>/ <span
class="phvr7t-x-x-80">New </span>/ <span
class="phvr7t-x-x-80">Column</span>. There’s no way to rename
a column, unfortunately. Objects in the column are
named using the column name, plus a number.
</dd><dt class="description">
<span
class="ptmb7t-">Column title bar</span> </dt><dd
class="description">Drag with the left mouse button held
down on the column title bar to move the column
around the workspace. Double-left-click on the
title bar to change the comment attached to the
column. Hold down the right mouse button on the
column title bar to pop up a useful menu.
<!--l. 292--><p class="noindent" >The items in the menu let you edit the caption,
select all the objects in the column, make a new
column which is a copy of this column, save the
column to a file, convert the column into a menu
item (see <span
class="cmsy-10"></span><a
href="#x19-370004.3.6">4.3.6<!--tex4ht:ref: sec:diaref --></a>) and remove the whole column.
</dd><dt class="description">
<span
class="ptmb7t-">Column fold button</span> </dt><dd
class="description">Left-clicking on the fold button
folds the column away. Use this to hide columns
which you still need, but which you are not
interested in just now.
</dd><dt class="description">
<span
class="ptmb7t-">Expression entry</span> </dt><dd
class="description">You can perform calculations by
typing expressions directly into this box. For
example, try entering the following expressions,
and pressing Return:
<div class="verbatim" id="verbatim-10">
2 + 2
 <br />A1 + 120
 <br />"My cat likes\nlasagne"
 <br />fred = 12
</div>
<!--l. 310--><p class="nopar" >
<!--l. 312--><p class="noindent" >The last example shows custom button name creation.
Normaly <span
class="phvr7t-x-x-80">nip2 </span>will pick a name for you, but you can
chose your own.
</dd></dl>
<!--l. 318--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">4.3.2 </span> <a
id="x19-320004.3.2"></a>Rows</h4>
<!--l. 319--><p class="noindent" ><a name="nip_label_sec:row"></a>
<!--l. 321--><p class="indent" > A column holds a number of rows. Each row comes
in four main parts, not all of which are visible for all
row values. Rows which represent classes have a pair
or up/down arrows to the left of the row name button
which you can use to control which parts of the row are
visible.
<!--l. 326--><p class="indent" > <hr class="figure"><div class="figure"
>
<a
id="x19-320016"></a>
<div class="center"
>
<!--l. 327--><p class="noindent" >
<!--l. 327--><p class="noindent" ><img
src="figs/ir8a.jpg" alt="PIC"
></div>
<br /> <div class="caption"
><span class="id">Figure 4.6: </span><span
class="content">Components of a workspace row</span></div><!--tex4ht:label?: x19-320016 -->
<!--l. 329--><p class="noindent" ><a name="nip_label_fg:row"></a>
<!--l. 330--><p class="indent" > </div><hr class="endfigure">
<dl class="description"><dt class="description">
<span
class="ptmb7t-">Row name button</span> </dt><dd
class="description">Each row has a name. The name
is normally formed from the name of the current
column, plus a number.
<!--l. 338--><p class="noindent" >If you double-left-click on the row name button,
<span
class="phvr7t-x-x-80">nip2 </span>will pop up a viewer or dialog box for the
value of the row. If you left-click, <span
class="phvr7t-x-x-80">nip2 </span>will select
that row and deselect all other rows. If you click on
an empty space in the workspace, it will deselect
all rows. If you Ctrl-left-click, <span
class="phvr7t-x-x-80">nip2 </span>will toggle
selection of that row. If you select one row and then
Shift-left-click on another row in the same column
it will select the second row and all the rows in
between. If you drag with the left button, you can
change the order of rows in a column. Hold down
the right mouse button for a useful menu. If you let
the mouse linger over a button, a useful tooltip will
appear.
</dd><dt class="description">
<span
class="ptmb7t-">Graphic</span> </dt><dd
class="description">If the row’s value is a class, and if the class
is an instance of one of <span
class="phvr7t-x-x-80">nip2</span>’s graphic classes, then
<span
class="phvr7t-x-x-80">nip2 </span>will draw a graphic representation of the row’s
value. See <span
class="cmsy-10"></span><a
href="nipguidese33.html#x44-830006.12.2">6.12.2<!--tex4ht:ref: sec:workspaces --></a> for a more detailed explanation.
</dd><dt class="description">
<span
class="ptmb7t-">Members</span> </dt><dd
class="description">If the row has a class for a value, then <span
class="phvr7t-x-x-80">nip2</span>
will draw a sub-column listing the class members.
Subcolumn members are in turn rows themselves.
</dd><dt class="description">
<span
class="ptmb7t-">Text</span> </dt><dd
class="description">Finally, the text part normally shows a text
representation of the row’s value. If you left-click
on the value, it changes to show the formula which
generated that value. You can edit the formula and
press Return to change it.
<!--l. 363--><p class="noindent" >Alternatively, selecting <span
class="phvr7t-x-x-80">View </span>/ <span
class="phvr7t-x-x-80">Show Formula</span>
toggles between displaying values for objects and
displaying the formula.
</dd></dl>
<h5 class="subsubsectionHead"><a
id="x19-330004.3.2"></a>Object name colours</h5>
<!--l. 370--><p class="noindent" ><span
class="phvr7t-x-x-80">nip2 </span>changes the background colour of the row name button
to show the state of the row. If background colours
are not visible (perhaps your theme turns them off),
try turning on the <span
class="phvr7t-x-x-80">Display LEDs in workspace </span>option in
<span
class="phvr7t-x-x-80">Preferences</span>. <!--l. 375--><p class="indent" > Green means the row is selected (click on the background
to unselect), red indicates an error (right-click on the row
button ans select <span
class="phvr7t-x-x-80">Recalculate </span>to see the full text of the error),
brown indicates that the row value is out of date and needs
recalculating and the various blues indicate parent and child
relationships.
<!--l. 381--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">4.3.3 </span> <a
id="x19-340004.3.3"></a>Applying operations to objects</h4>
<!--l. 382--><p class="noindent" ><a name="nip_label_sec:apply"></a>
<!--l. 384--><p class="indent" > There are three ways you can apply image processing
operations to objects in your workspace:
<!--l. 387--><p class="indent" >
<ol class="enumerate1" >
<li
class="enumerate" id="x19-34002x1">Select the object you want to apply the operation to
by single-left-clicking on the object name. When
you single-click, the object name will change
colour to show that it is selected, and <span
class="phvr7t-x-x-80">nip2 </span>will
display the name of the selected object at the left
end of the status bar (this is useful if the selected
object is scrolled off the edge of the window).
<!--l. 396--><p class="noindent" >You can
select additional objects with Ctrl-left-click and
Shift-left-click. This is necessary if you want to use
an image processing operation that takes more than
one argument.
<!--l. 400--><p class="noindent" >Once you have selected the rows (sometimes you
need to select them in a certain order), click on
the processing operation you want from the <span
class="phvr7t-x-x-80">Toolkits</span>
menu.
</li>
<li
class="enumerate" id="x19-34004x2">If there are no objects selected when you click
on an image processing operation, <span
class="phvr7t-x-x-80">nip2 </span>uses the
bottom few items (as many as are needed by the
operation) in the current column.
</li>
<li
class="enumerate" id="x19-34006x3">You can also type your formula directly into the
expresion entry line at the bottom of the selected
column. Chapter <a
href="nipguidech6.html#x31-570006">6<!--tex4ht:ref: sec:program --></a> describes the syntax in detail,
but it’s approximately C.
</li></ol>
<!--l. 416--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">4.3.4 </span> <a
id="x19-350004.3.4"></a>Batch processing</h4>
<!--l. 417--><p class="noindent" ><a name="nip_label_sec:batch"></a>
<!--l. 419--><p class="indent" > If you select a number of rows and then click <span
class="phvr7t-x-x-80">Edit </span>/ <span
class="phvr7t-x-x-80">Group</span>,
<span
class="phvr7t-x-x-80">nip2 </span>will group the rows together. Now if you select the
group and click on an item in the <span
class="phvr7t-x-x-80">Toolkits </span>menu, <span
class="phvr7t-x-x-80">nip2 </span>will
apply that operation to every item in the group. You can
group groups, and you can mix grouped and non-grouped
rows freely.
<!--l. 425--><p class="indent" > If you save a group, <span
class="phvr7t-x-x-80">nip2 </span>will write each item in the
group to a separate file, incrementing the filename each
time.
<!--l. 428--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">4.3.5 </span> <a
id="x19-360004.3.5"></a>Error handling</h4>
<!--l. 429--><p class="noindent" ><a name="nip_label_sec:error"></a>
<!--l. 431--><p class="indent" > If an object in your workspace has an error (for example,
if you are trying to join two images of different types), then
the object name button will turn red to show that this object
contains an error and the tooltip for the button will show the
error message.
<!--l. 436--><p class="noindent" >
<h4 class="subsectionHead"><span class="titlemark">4.3.6 </span> <a
id="x19-370004.3.6"></a>Making menu items out of columns</h4>
<!--l. 437--><p class="noindent" ><a name="nip_label_sec:diaref"></a>
<!--l. 439--><p class="indent" > If you make a column that does something useful,
you can make it into a menu item by following these
steps:
<!--l. 442--><p class="indent" >
<ol class="enumerate1" >
<li
class="enumerate" id="x19-37002x1">Make your column look nice. Drag with the
left mouse button on the object name buttons to
re-order items in the column, and add comments to
explain what are the input fields and what are the
output. Double-click on the column title bar to add
a helpful title to the column.
<!--l. 450--><p class="noindent" >Add a comment by typing your text (enclosed in
double quotes) into the line at the bottom of the
column. Left-drag the row to the right place.
</li>
<li
class="enumerate" id="x19-37004x2">Select <span
class="phvr7t-x-x-80">Make Column Into Menu Item </span>from the column
title-bar menu, see <span
class="cmsy-10"></span><a
href="#x19-310004.3.1">4.3.1<!--tex4ht:ref: sec:column --></a>.
<!--l. 457--><p class="noindent" >This will open up a new dialog box which you can
use to set a name for your new menu item and the name of the top level menu the item should be
added to.
</li>
<li
class="enumerate" id="x19-37006x3">That’s it. You’ll be prompted to save your new
toolkit when you try to quit <span
class="phvr7t-x-x-80">nip2</span>. We recommend
you just say <span
class="phvr7t-x-x-80">OK </span>to the suggested location for
the file. Edit your menus with the programming
window, see <span
class="cmsy-10"></span><a
href="nipguidese12.html#x20-380004.4">4.4<!--tex4ht:ref: sec:progwin --></a>.
</li></ol>
<!--l. 469--><div class="crosslinks"><p class="noindent">[<a
href="nipguidese12.html" >next</a>] [<a
href="nipguidese10.html" >prev</a>] [<a
href="nipguidese10.html#tailnipguidese10.html" >prev-tail</a>] [<a
href="nipguidese11.html" >front</a>] [<a
href="nipguidech4.html#nipguidese11.html" >up</a>] </p></div>
<!--l. 469--><p class="indent" > <a
id="tailnipguidese11.html"></a>
</body></html>
|
