← Back to branch summary

~ubuntu-branches/ubuntu/saucy/kde-l10n-et/saucy-proposed

« back to all changes in this revision

Viewing changes to docs/kdeedu/rocs/index.docbook

  • Committer: Package Import Robot
  • Author(s): Jonathan Riddell
  • Date: 2012-01-24 20:43:54 UTC
  • mto: This revision was merged to the branch mainline in revision 55.
  • Revision ID: package-import@ubuntu.com-20120124204354-dwhbgzbx5g0fn2eq
Tags: upstream-4.8.0
Import upstream version 4.8.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/kdeedu/rocs/index.docbook
4
4
  <!ENTITY kappname "&rocs;">
5
5
  <!ENTITY package "kdeedu">
6
6
  <!ENTITY % addindex "IGNORE">
7
 
  <!ENTITY % Estonian  "INCLUDE"
8
 
> 
 
7
  <!ENTITY % Estonian  "INCLUDE">
9
8
]>
10
9
<book lang="&language;">
11
10
 
23
22
> <email
24
23
>tomaz.canabrava@gmail.com</email
25
24
> </author>
 
25
<author
 
26
><personname
 
27
> <firstname
 
28
>Andreas</firstname
 
29
> <surname
 
30
>Cord-Landwehr</surname
 
31
> </personname
 
32
> <email
 
33
>cordlandwehr@googlemail.com</email
 
34
> </author>
 
35
 
26
36
<othercredit role="translator"
27
37
><firstname
28
38
>Marek</firstname
40
50
> 
41
51
</authorgroup>
42
52
 
43
 
<copyright>
44
 
<year
45
 
>2009</year>
46
 
<holder
47
 
>Tomaz Canabrava</holder>
48
 
</copyright>
 
53
<copyright
 
54
><year
 
55
>2009</year
 
56
><holder
 
57
>Tomaz Canabrava</holder
 
58
></copyright>
 
59
<copyright
 
60
><year
 
61
>2011</year
 
62
><holder
 
63
>Andreas Cord-Landwehr</holder
 
64
></copyright>
 
65
 
 
66
<date
 
67
>2011-12-04</date>
 
68
<releaseinfo
 
69
>1.1 &kde; 4.8</releaseinfo>
 
70
 
49
71
<legalnotice
50
72
>&FDLNotice;</legalnotice>
51
73
 
52
 
<date
53
 
>2009-11-05</date>
54
 
<releaseinfo
55
 
>1.0</releaseinfo>
56
 
 
57
74
<abstract>
58
75
<para
59
 
>&rocs; on KDE graafiteooria kujutamise tööriist. </para>
 
76
>&rocs; on KDE graafiteooria tööriist. </para>
60
77
</abstract>
61
78
 
62
79
<keywordset>
82
99
<title
83
100
>Sissejuhatus</title>
84
101
<para
85
 
>&rocs;i eesmärk on olla graafiteooria arenduskeskkond, mis aitab professoritel kuvada graafialgoritmi tulemusi ning tudengitel iseseisvalt algoritme koostada.</para>
 
102
>&rocs; on graafiteooria arenduskeskkond kõigile, keda huvitab graafialgoritmide loomine ja analüüs. See hõlmab muu hulgas</para>
 
103
<itemizedlist>
 
104
        <listitem
 
105
><para
 
106
>õppejõude, kes soovivad demonstreerida algoritme oma õpilastele,</para
 
107
></listitem>
 
108
        <listitem
 
109
><para
 
110
>õppureid, kes soovivad mõista ja näha algoritmide tööd,</para
 
111
></listitem>
 
112
        <listitem
 
113
><para
 
114
>kõiki, kes peavad mis tahes põhjusel looma graafialgoritme ja vajavad tööriista prototüüpide testimiseks.</para
 
115
></listitem>
 
116
</itemizedlist>
 
117
<para
 
118
>Kõigile neile pakub &rocs; hõlpsasti pruugitava graafiredaktori, millega graafe luua, võimsa QTScripti mootori algoritmide täitmiseks ja mitu abitööriista graafide ja andmestruktuuride loomiseks enda katsete tarbeks. Tavaliselt käib asi nii, et kõigepealt kirjutatakse algoritm, siis luuakse graaf ja siis uuritakse reaalajas, kuidas algoritm graafi peal toimib.</para>
86
119
 
87
 
<para
88
 
>&rocs;il on oma skriptimoodul, mille aluseks on Qt Script, mis teeb koostööd kujutatud graafiga, nii et iga graafiga seotud skriptis tehtud muudatus kajastub kohe ka näidataval graafil.</para>
 
120
<screenshot>
 
121
<screeninfo
 
122
>&rocs;i pilt.</screeninfo>
 
123
<mediaobject>
 
124
<imageobject>
 
125
<imagedata fileref="rocs-screenshot.png" format="PNG"/>
 
126
</imageobject>
 
127
<textobject>
 
128
<phrase
 
129
>&rocs;i pilt.</phrase>
 
130
</textobject>
 
131
</mediaobject>
 
132
</screenshot>
89
133
</chapter>
90
134
 
91
 
<chapter id="using-rocs">
92
 
<title
93
 
>&rocs;i kasutamine</title>
94
 
<para
95
 
>Kasutajaliides jaguneb kaheks: </para
96
 
> 
97
 
 
98
 
<itemizedlist>
99
 
<listitem
100
 
><para
101
 
>ülal paremal kuvatakse graafi, all paremal aga saab luua algoritmi, </para
102
 
></listitem>
103
 
<listitem
104
 
><para
105
 
>vasakul külgribal on näha kõik avatud graafid (graafe võib ühes failis olla ka mitu). </para
106
 
></listitem>
107
 
</itemizedlist>
108
 
 
109
 
 
110
 
<sect1 id="rocs-features">
111
 
<title
112
 
>&rocs;i globaalsed seadistused</title>
113
 
<para
 
135
<chapter id="user-interface">
 
136
<title
 
137
>&rocs;i kasutajaliides</title>
 
138
 
 
139
<sect1 id="user-interface-all">
 
140
<title
 
141
>Kasutajaliidese põhielemendid</title>
 
142
<para
 
143
>Kasutajaliides jaguneb mitmeks loogiliseks osaks, nagu on näha ka juuresoleval pildil. </para>
 
144
<screenshot>
 
145
        <screeninfo
 
146
>&rocs;i liidese graafilised elemendid.</screeninfo>
 
147
        <mediaobject>
 
148
        <imageobject>
 
149
        <imagedata fileref="rocs-interfaces.png" format="PNG"/>
 
150
        </imageobject>
 
151
        <textobject>
 
152
        <phrase
 
153
>&rocs;i liidese graafilised elemendid.</phrase>
 
154
        </textobject>
 
155
        </mediaobject>
 
156
</screenshot>
 
157
<variablelist>
 
158
<varlistentry>
 
159
        <term
 
160
>Visuaalse graafiredaktori riba</term>
 
161
        <listitem
 
162
><para
 
163
>Graafi loomiseks või muutmiseks visuaalses graafiredaktoris tuleb siin kõigepealt valida tööriist</para
 
164
></listitem>
 
165
</varlistentry>
 
166
<varlistentry>
 
167
        <term
 
168
>Visuaalne graafiredaktor</term>
 
169
        <listitem
 
170
><para
 
171
>Siin saab graafid joonistada. Paremklõps tühjal alal, graafi elementidel või valitud graafi elementidel avab kontekstimenüü, mis mõnevõrra erineb sõltuvalt sellest, kus klõpsati.</para
 
172
></listitem>
 
173
</varlistentry>
 
174
<varlistentry>
 
175
        <term
 
176
>Graafi omadused</term>
 
177
        <listitem
 
178
><para
 
179
>Siin näeb kõigi parajasti visuaalse graafiredaktori lõuendil olevate graafide loendit. Siin saab teha ka muudatusi näiteks graafi nimes, nähtavates omadustes, näiteks tippude nimedes või väärtustes, samuti määrata graafi elementide vaikimisi värve.</para
 
180
></listitem>
 
181
</varlistentry>
 
182
<varlistentry>
 
183
        <term
 
184
>Skriptiredaktor</term>
 
185
        <listitem
 
186
><para
 
187
>Selles tekstiredaktoris saab kirjutada algoritme QtScriptis (antud juhul on see põhimõtteliselt samane JavaScriptiga). Korraga võib tegutseda ka mitme algoritmi kallal, avades või luues menüü abil uusi skriptikaarte. Kui skripti tehtud muudatused on salvestamata, näeb kaardi sakil väikest ketast.</para
 
188
></listitem>
 
189
</varlistentry>
 
190
<varlistentry>
 
191
        <term
 
192
>Silumis- ja skriptiväljund</term>
 
193
        <listitem
 
194
><para
 
195
>Selles tekstialas näeb kas sinu skripti silumisteavet või väljundit sõltuvalt väljundi valikust. Kui skript tekitab vigu, valitakse automaatselt silumisväljund. Silumisväljund näitab samuti kõiki programmi väljundteateid.</para
 
196
></listitem>
 
197
</varlistentry>
 
198
<varlistentry>
 
199
        <term
 
200
>Skripti töölepanek</term>
 
201
        <listitem
 
202
><para
 
203
>See ala tegeleb skriptide töölepanekuga. Parajasti avatud skripti saab rakendada visuaalse graafiredaktori lõuendil olevale graafile, kui klõpsata nupule <guiicon
 
204
>Käivita</guiicon
 
205
>. Skripti käivitamise järel saab selle täitmist ka peatada, kui klõpsata nupule <guiicon
 
206
>Peata</guiicon
 
207
>.</para
 
208
></listitem>
 
209
</varlistentry>
 
210
</variablelist>
 
211
</sect1>
 
212
 
 
213
<sect1 id="user-interface-toolbars">
 
214
<title
 
215
>Tööriistaribad</title>
 
216
<para
 
217
>Siin on mitmesugused visuaalse graafiredaktori tööriistaribad, mis võimaldavad vajalikke võimalusi kasutada üheainsa klõpsuga. Vaikimisi näeb järgmisi tööriistaribasid:</para>
 
218
<itemizedlist>
 
219
        <listitem
 
220
><para
 
221
>Peamine tööriistariba</para
 
222
></listitem>
 
223
        <listitem
 
224
><para
 
225
>Joondusriba</para
 
226
></listitem>
 
227
</itemizedlist>
 
228
 
 
229
<sect2 id="user-interface-toolbars-main">
 
230
<title
 
231
>Peamine tööriistariba</title>
 
232
<para
 
233
><emphasis
 
234
>Peamine tööriistariba</emphasis
 
235
> koosneb järgmistest toimingutest. Toimingule klõpsamine tähendab seda, et saad hiirega rakendada antud toimingu visuaalse graafiredaktori lõuendis:</para>
 
236
<itemizedlist>
 
237
<listitem
 
238
><para
 
239
><guilabel
 
240
>Liiguta</guilabel
 
241
>: elementide valimiseks klõpsa lõuendi tühjal alal, hoia hiirenupp all ja joonista ristkülik, mis sisaldab mõningaid tippe ja/või seoseid, mis sel juhul valitakse, või klõpsa vahetult valimata elemendi peal selle valimiseks. Kui klõpsad valitud elemendil või elementidel, saab hiirenuppu all hoides ja hiirt liigutades elemente liigutada. Valitud elemente saab liigutada ka nooleklahvidega.</para
 
242
></listitem>
 
243
<listitem
 
244
><para
 
245
><guilabel
 
246
>Lisa tipp</guilabel
 
247
>: klõpsa visuaalse graafiredaktori lõuendil vajalikus kohas ja loo uus tipp, mis kuulub parajasti valitud graafile.</para
 
248
></listitem>
 
249
<listitem
 
250
><para
 
251
><guilabel
 
252
>Lisa seos</guilabel
 
253
>: klõpsa mõnel tipul, hoia hiir all ja tõmba joon teise tipuni, milleni seos peab ulatuma. Seda toimingut saadab edu ainult siis, kui aktiivne graaf võimaldab sellist seost lisada (nt. orienteerimata graafil ei ole lubatud lisada kahe tipu vahele mitut seost).</para
 
254
></listitem>
 
255
<listitem
 
256
><para
 
257
><guilabel
 
258
>Kustuta</guilabel
 
259
>: klõpsa elemendil selle kustutamiseks. Kui kustutad tipu, kustutatakse ka kõik sellega seotud seosed.</para
 
260
></listitem>
 
261
<listitem
 
262
><para
 
263
><guilabel
 
264
>Suurendus</guilabel
 
265
>: klõpsa lõuendil, hoia &HVN; all ja joonista sellega ristkülik. Lõuendit suurendatakse, nii et näed ainult valitud osa. Samuti võib suurendada või vähendada hiirerattaga. Topeltklõps &HVNga; taasta esialgse suurenduse.</para
 
266
></listitem>
 
267
</itemizedlist>
 
268
<screenshot>
 
269
<screeninfo
 
270
>Peamine tööriistariba</screeninfo>
 
271
<mediaobject>
 
272
<imageobject>
 
273
<imagedata fileref="rocs-toolbar-main.png" format="PNG"/>
 
274
</imageobject>
 
275
<textobject>
 
276
<phrase
 
277
>Peamine tööriistariba</phrase>
 
278
</textobject>
 
279
</mediaobject>
 
280
</screenshot>
 
281
</sect2>
 
282
 
 
283
<sect2 id="user-interface-toolbars-alignment">
 
284
<title
 
285
>Joondusriba</title>
 
286
<para
 
287
>Lisada võib ka <emphasis
 
288
>joondusriba</emphasis
 
289
>. Mõnele selle riba toimingule klõpsates saab vahetult mõjutada parajasti valitud tippe:</para>
 
290
<itemizedlist>
 
291
<listitem
 
292
><para>
 
293
<inlinemediaobject
 
294
><imageobject>
 
295
<imagedata fileref="hi22-action-rocsaligntop.png" format="PNG"/></imageobject>
 
296
</inlinemediaobject
 
297
> <guilabel
 
298
>Üles</guilabel
 
299
>: tipud joondatakse kõige ülemise tipu vertikaalse positsiooni järgi. See puudutab ainult vertikaalset positsiooni.</para
 
300
></listitem>
 
301
<listitem
 
302
><para>
 
303
<inlinemediaobject
 
304
><imageobject>
 
305
<imagedata fileref="hi22-action-rocsalignvmiddle.png" format="PNG"/></imageobject>
 
306
</inlinemediaobject
 
307
> <guilabel
 
308
>Keskele</guilabel
 
309
>: tippude joondamine kõigi valitud tippude vertikaalsete positsioonide keskme järgi. See puudutab ainult vertikaalset positsiooni.</para
 
310
></listitem>
 
311
<listitem
 
312
><para>
 
313
<inlinemediaobject
 
314
><imageobject>
 
315
<imagedata fileref="hi22-action-rocsalignbottom.png" format="PNG"/></imageobject>
 
316
</inlinemediaobject
 
317
> <guilabel
 
318
>Alla</guilabel
 
319
>: tipud joondatakse kõige alumise tipu vertikaalse positsiooni järgi. See puudutab ainult vertikaalset positsiooni.</para
 
320
></listitem>
 
321
<listitem
 
322
><para>
 
323
<inlinemediaobject
 
324
><imageobject>
 
325
<imagedata fileref="hi22-action-rocsalignleft.png" format="PNG"/></imageobject>
 
326
</inlinemediaobject
 
327
> <guilabel
 
328
>Vasakule</guilabel
 
329
>: tipud joondatakse kõige vasakpoolsema tipu horisontaalse positsiooni järgi. See puudutab ainult horisontaalset positsiooni.</para
 
330
></listitem>
 
331
<listitem
 
332
><para>
 
333
<inlinemediaobject
 
334
><imageobject>
 
335
<imagedata fileref="hi22-action-rocsalignhmiddle.png" format="PNG"/></imageobject>
 
336
</inlinemediaobject
 
337
> <guilabel
 
338
>Keskele</guilabel
 
339
>: tipud joondatakse kõige ülemise tipu horisontaalse positsiooni järgi. See puudutab ainult horisontaalset positsiooni.</para
 
340
></listitem>
 
341
<listitem
 
342
><para>
 
343
<inlinemediaobject
 
344
><imageobject>
 
345
<imagedata fileref="hi22-action-rocsalignright.png" format="PNG"/></imageobject>
 
346
</inlinemediaobject
 
347
> <guilabel
 
348
>Paremale</guilabel
 
349
>: tipud joondatakse kõige parempoolsema tipu horisontaalse positsiooni järgi. See puudutab ainult horisontaalset positsiooni.</para
 
350
></listitem>
 
351
<listitem
 
352
><para>
 
353
<inlinemediaobject
 
354
><imageobject>
 
355
<imagedata fileref="hi22-action-rocsaligncircle.png" format="PNG"/></imageobject>
 
356
</inlinemediaobject
 
357
> <guilabel
 
358
>Ring</guilabel
 
359
>: tipud joondatakse ringi, mille diameeter võrdub tippude maksimaalse vahemaaga. Tipud paigutatakse samas järjekorras nagu vaates alates tippude raskuskeskmest.</para
 
360
></listitem>
 
361
<listitem
 
362
><para>
 
363
<inlinemediaobject
 
364
><imageobject>
 
365
<imagedata fileref="hi22-action-rocsaligntree.png" format="PNG"/></imageobject>
 
366
</inlinemediaobject
 
367
> <guilabel
 
368
>Kattuvate seoste minimeerimine</guilabel
 
369
>: rakendatakse Rruchterman-Reingoldi algoritmile kattuvate seoste arvu (ligilähedaseks) minimeerimiseks.</para
 
370
></listitem>
 
371
</itemizedlist>
 
372
<screenshot>
 
373
<screeninfo
 
374
>Joondusriba</screeninfo>
 
375
<mediaobject>
 
376
<imageobject>
 
377
<imagedata fileref="rocs-toolbar-alignment.png" format="PNG"/>
 
378
</imageobject>
 
379
<textobject>
 
380
<phrase
 
381
>Joondusriba</phrase>
 
382
</textobject>
 
383
</mediaobject>
 
384
</screenshot>
 
385
</sect2>
 
386
</sect1>
 
387
 
 
388
<sect1 id="user-interface-graph-properties">
 
389
        <title
 
390
>Graafi omadused</title>
 
391
        <para
114
392
>Vasakul külgribal leiab valikud kõigi avatud graafide jaoks. Kõik need on globaalsed iga graafi jaoks ning neid võib muuda tipu või seose jaoks vastavalt tipu või seose omaduste dialoogis.</para>
115
 
<itemizedlist>
116
 
<listitem
117
 
><para>
118
 
<guilabel
119
 
>Graafi nimi</guilabel>
120
 
</para
 
393
 
 
394
        <itemizedlist>
 
395
        <listitem
 
396
><para
 
397
><guilabel
 
398
>nimi</guilabel
 
399
>: nimi, mida algoritm peab kasutama graafi mõjutamiseks. </para
121
400
></listitem>
122
 
<listitem
 
401
        <listitem
123
402
><para
124
403
><guilabel
125
 
>Tipu värv</guilabel
 
404
>Andmete värv</guilabel
126
405
> uute tippude jaoks: klõpsuga nupule <guilabel
127
406
>Kõik</guilabel
128
407
> saab muuta kõigi aktiivsete tippude värvi </para
129
408
></listitem>
130
 
<listitem
 
409
        <listitem
131
410
><para>
132
 
<guilabel
133
 
>Seose värv</guilabel>
134
 
</para
 
411
          <guilabel
 
412
>Osuti värv</guilabel
 
413
> <!--FIXME color of edges?-->
 
414
        </para
135
415
></listitem>
136
 
</itemizedlist>
137
 
<para
 
416
        </itemizedlist>
 
417
        <para
138
418
>Valikute viimane rida sisaldab klõpsatavaid nuppe:</para>
139
 
<itemizedlist>
140
 
<listitem
 
419
        <itemizedlist>
 
420
        <listitem
141
421
><para
142
422
><guilabel
143
423
>Nimede näitamise koht</guilabel
144
424
> <guilabel
145
 
>Tipud</guilabel
 
425
>Andmed</guilabel
146
426
> või <guilabel
147
 
>Seosed</guilabel
 
427
>Osutid</guilabel
148
428
> </para
149
429
></listitem>
150
 
<listitem
 
430
        <listitem
151
431
><para
152
432
><guilabel
153
433
>Väärtuste näitamise koht</guilabel
157
437
>Seosed</guilabel
158
438
> </para
159
439
></listitem>
160
 
<!--listitem
161
 
><para>
162
 
<guilabel
163
 
>Graph is oriented</guilabel>
164
 
</para
165
 
></listitem>
166
 
<listitem
167
 
><para>
168
 
<guilabel
169
 
>Graph is Automate</guilabel>
170
 
</para
171
 
></listitem-->
172
 
</itemizedlist>
173
 
</sect1>
174
 
 
175
 
<sect1 id="rocs-toolbars">
176
 
<title
177
 
>&rocs;i tööriistaribad</title>
178
 
<para
179
 
>Ülal asub kaks tööriistariba. Peamisel tööriistaribal on järgmised tööriistad:</para>
180
 
<itemizedlist>
181
 
<listitem
182
 
><para
183
 
><guilabel
184
 
>Liiguta tippu</guilabel
185
 
>: võimaldab liigutada tippu joonistusalal.</para
186
 
></listitem>
187
 
<listitem
188
 
><para
189
 
><guilabel
190
 
>Lisa tipp Node</guilabel
191
 
>: loob uue tipu kohta, kus joonistusalal klõpsad.</para
192
 
></listitem>
193
 
<listitem
194
 
><para
195
 
><guilabel
196
 
>Lisa seos</guilabel
197
 
>: loob uue seose kahe tipu vahele.</para
198
 
></listitem>
199
 
<listitem
200
 
><para
201
 
><guilabel
202
 
>Vali</guilabel
203
 
>: võimaldab valida elemente neil klõpsates.</para
204
 
></listitem>
205
 
<listitem
206
 
><para
207
 
><guilabel
208
 
>Kustuta</guilabel
209
 
>: võimaldab kustutada elemente neil klõpsates.</para
210
 
></listitem>
211
 
<listitem
212
 
><para
213
 
>Joondamistööriistadega saab asetada valitud tippe.</para
214
 
></listitem>
215
 
</itemizedlist>
216
 
 
217
 
<para
218
 
>Hiire parema nupuga tipul või seosel klõpsates saab avada selle tipu või seose omaduste dialoogi.</para>
219
 
<para
220
 
>Paigutusriba koosneb mitmest joondamisikoonist.</para>
221
 
 
222
 
<para
223
 
>Tippude joondamiseks vali tööriist <guiicon
224
 
>Vali</guiicon
225
 
>, klõpsa ja joonista lohistades ristkülik ning seejärel vali vajalik joondus. </para>
 
440
        <!-- FIXME missing Graph Type Undirected Graph, Directed Graph, Multigraph -->
 
441
        </itemizedlist>
226
442
</sect1>
227
443
</chapter>
228
444
 
229
 
<chapter id="scripting-rocs">
230
 
<title
231
 
>&rocs;i skriptimine</title>
232
 
<para
233
 
>Kui graaf on juba ekraanil, saab hakata selle jaoks skripti looma. Vastav keel kasutab JavaScripti süntaksit. Järgnevalt on ära toodud graafi, tipu ja seose objektid.</para>
234
 
 
235
 
<sect1 id="script-graph">
236
 
<title
237
 
>Graaf</title>
 
445
<chapter id="using-rocs">
 
446
<title
 
447
>&rocs;i kasutamine</title>
 
448
<para
 
449
>Tavaliselt on esimene samm graafi loomine visuaalse graafiredaktoriga. Seda võib teha käsitsi, see tähendab tippe luues ja neid ühendades, või siis kasutades mõningaid abialgoritme, mida pakub menüükäsk <menuchoice
 
450
><guimenu
 
451
>Tööriistad</guimenu
 
452
> <guimenuitem
 
453
>Graafi genereerimine</guimenuitem
 
454
></menuchoice
 
455
>. Samuti võib lõpuks kasutada tööriista <menuchoice
 
456
><guimenu
 
457
>Tööriistad</guimenu
 
458
> <guimenuitem
 
459
>Väärtuste omistamine</guimenuitem
 
460
></menuchoice
 
461
>, millega saab anda graafi tippudele ja seostele esialgsed väärtused. Kõige lõpuks tuleb graafile anda nimi. Seda kasutatakse edaspidi identifikaatorina, mida läheb vaja skriptimootoril.</para>
 
462
 
 
463
<sect1 id="using-rocs-scripting">
 
464
<title
 
465
>Skriptimine</title>
 
466
<para
 
467
>&rocs; kasutab JavaScriptile sarnanevat skriptikeelt. See tähendab, et muutujate ja funktsioonide defineerimine ning nende kasutamine käib täpselt samamoodi nagu JavaScriptis. Lisaks pakub &rocs; mitmeid funktsioone, mis võimaldavad kasutada graafe visuaalse graafiredaktori lõuendil ja nende elemente. </para>
 
468
 
 
469
<sect2
 
470
><title
 
471
>Graafi kasutamine</title>
 
472
<para
 
473
>Skriptiliideses saab ligipääsu graafile tagada lihtsalt selle nime kirjutades ja kasutades seda objektina koos mõnega järgnevatest funktsioonidest. ligipääsu tipule või seosele annab graafiobjekti identifikaator.</para>
 
474
<variablelist>
 
475
<varlistentry>
 
476
<term
 
477
>Graafiobjektid</term>
 
478
<listitem>
238
479
<programlisting
239
 
>array list_nodes();
 
480
>// functions
 
481
     array list_nodes();
240
482
     array list_edges();
241
483
     node add_node(name);
242
484
     edge add_edge(from, to);
243
485
     node node_byname(QString&amp; name);
244
486
     node begin_node();
245
487
     array end_nodes();
246
 
</programlisting
247
 
> 
248
 
<para
249
 
>Graafi muutujad, mida saab muuta:</para>
250
 
<programlisting
251
 
>bool directed
 
488
 
 
489
// variables
 
490
     bool directed
252
491
     bool automate
253
492
     string name
254
493
     string nodeDefaultColor // in HEXA
255
 
     string edgeDefaultColor  // in HEXA 
 
494
     string edgeDefaultColor  // in HEXA
256
495
</programlisting>
257
 
</sect1>
 
496
</listitem>
 
497
</varlistentry>
258
498
 
259
 
<sect1 id="script-nodes">
260
 
<title
261
 
>Tipud</title>
 
499
<varlistentry>
 
500
<term
 
501
>Tipuobjektid</term>
 
502
<listitem>
262
503
<programlisting
263
 
>array adj_nodes();
 
504
>// functions
 
505
     array adj_nodes();
264
506
     array adj_edges();
265
 
     array  input_edges();
 
507
     array input_edges();
266
508
     array output_edges();
267
509
     array loop_edges();
268
510
     array connected_edges(Node *n);
269
511
     void self_remove();
270
 
</programlisting
271
 
> 
272
 
<para
273
 
>Tipu muutujad:</para>
274
 
<programlisting
275
 
>double x
 
512
 
 
513
// variables
 
514
    double x
276
515
    double y
277
516
    double width
278
517
    string value
281
520
    bool begin
282
521
    bool end
283
522
</programlisting>
284
 
</sect1>
 
523
</listitem>
 
524
</varlistentry>
285
525
 
286
 
<sect1 id="script-edges">
287
 
<title
288
 
>Seosed</title>
 
526
<varlistentry>
 
527
<term
 
528
>Seoseobjektid</term>
 
529
<listitem>
289
530
<programlisting
290
531
>string color ( em hexa )
291
532
    string value
297
538
    node  end();
298
539
 
299
540
    void self_remove();
300
 
</programlisting
301
 
> 
 
541
</programlisting>
 
542
</listitem>
 
543
</varlistentry>
 
544
</variablelist>
 
545
</sect2>
 
546
 
 
547
<sect2 id="script-graph-algorithms">
 
548
<title
 
549
>Graafi algoritmid</title>
 
550
<para
 
551
>Mõnikord tuleb kasuks, kui tarvitad standardsete ülesannete funktsioone, näiteks lühima vahemaa arvutamiseks kahe tipu vahel. Praegu toetame järgmisi algoritme, mida saab skriptimootoriga välja kutsuda sama graafi tippudel.</para>
 
552
<variablelist>
 
553
<varlistentry>
 
554
<term
 
555
>Lühima teekonna arvutamine</term>
 
556
<listitem>
 
557
        <para
 
558
>Arvutab lühima tee tippude <emphasis
 
559
>algus</emphasis
 
560
> ja <emphasis
 
561
>lõpp</emphasis
 
562
> vahel. Mõlemad tipud peavad asuma ühel graafil. Arvutamine arvestab ka seda, kas graaf on orienteeritud või orienteerimata.</para>
 
563
        <funcsynopsis>
 
564
        <funcprototype
 
565
><funcdef
 
566
>array <function
 
567
>dijkstra_shortest_path</function
 
568
></funcdef
 
569
> <paramdef
 
570
>Node* <parameter
 
571
><replaceable
 
572
>algus</replaceable
 
573
></parameter
 
574
></paramdef
 
575
> <paramdef
 
576
>Node* <parameter
 
577
><replaceable
 
578
>lõpp</replaceable
 
579
></parameter
 
580
></paramdef
 
581
> </funcprototype>
 
582
        </funcsynopsis>
 
583
</listitem>
 
584
</varlistentry>
 
585
</variablelist>
 
586
</sect2>
302
587
</sect1>
303
588
 
304
589
<sect1 id="script-example">
307
592
<para
308
593
>Selle on lihtne näidisskript, mis määrab kindlaks esimese graafi nelja esimese tipu värvi:</para>
309
594
<programlisting
310
 
>/* A simple example that sets the color of the 4 first nodes in the first 
 
595
>/* A simple example that sets the color of the 4 first nodes in the first
311
596
graph: */
312
 
 
313
 
var colours = new Array("red", "green", "blue", "yellow");
314
 
 
315
 
/* graphs is an array of graphs, you can access a graph by its index in the 
316
 
array or by its name, so if the first graph's name is Untitled0, the following 
 
597
 
 
598
var colors = new Array("red", "green", "blue", "yellow");
 
599
 
 
600
/* graphs is an array of graphs, you can access a graph by its index in the
 
601
array or by its name, so if the first graph's name is Untitled0, the following
317
602
sentence are right  */
318
603
var list1= graphs[0].list_nodes(); //  1st form.
319
604
var list2=Untitled0.list_nodes();              // 2nd form
320
 
 
321
 
 for ( var i = 0; i &lt; colours.length; i++){
 
605
 
 
606
 for ( var i = 0; i &lt; colors.length; i++){
322
607
        if (i 
323
608
> list2.length) break;
324
 
        list2[i].color = colours[i]
 
609
        list2[i].color = colors[i]
325
610
 }
326
611
</programlisting>
327
612
</sect1>
328
 
 
329
 
</chapter>
330
 
 
331
 
<chapter id="commands">
332
 
<title
333
 
>Käskude seletused</title>
334
 
 
335
 
<sect1 id="rocs-mainwindow">
336
 
<title
337
 
>Menüüd ja kiirklahvid</title>
338
 
 
339
 
<sect2>
340
 
<title
341
 
>Menüü <guimenu
342
 
>Fail</guimenu
343
 
></title>
344
 
<variablelist>
345
 
<varlistentry>
346
 
<term
347
 
><menuchoice
348
 
><shortcut
349
 
> <keycombo action="simul"
350
 
>&Ctrl;<keycap
351
 
>Q</keycap
352
 
></keycombo
353
 
> </shortcut
354
 
> <guimenu
355
 
>Fail</guimenu
356
 
> <guimenuitem
357
 
>Välju</guimenuitem
358
 
> </menuchoice
359
 
></term>
360
 
<listitem
361
 
><para
362
 
><action
363
 
>Lõpetab</action
364
 
> &rocs;i töö</para
365
 
></listitem>
366
 
</varlistentry>
367
 
</variablelist>
368
 
 
369
 
</sect2>
370
 
 
371
 
 
372
 
<sect2>
373
 
<title
374
 
>Menüü <guimenu
375
 
>Seadistused</guimenu
376
 
></title>
377
 
 
378
 
<variablelist>
379
 
<varlistentry>
380
 
<term
381
 
><menuchoice
382
 
><guimenu
383
 
>Seadistused</guimenu
384
 
> <guisubmenu
385
 
>Näidatavad tööriistaribad</guisubmenu
386
 
> </menuchoice
387
 
></term>
388
 
<listitem
389
 
><para
390
 
><action
391
 
>Lülitab</action
392
 
> <guimenuitem
393
 
>peamise</guimenuitem
394
 
> ja <guimenuitem
395
 
>paigutuse</guimenuitem
396
 
> tööriistariba näitamise sisse ja välja.</para
397
 
></listitem>
398
 
</varlistentry>
399
 
 
400
 
 
401
 
<varlistentry>
402
 
<term
403
 
><menuchoice
404
 
><guimenu
405
 
>Seadistused</guimenu
406
 
> <guimenuitem
407
 
>Olekuriba näitamine</guimenuitem
408
 
> </menuchoice
409
 
></term>
410
 
<listitem
411
 
><para
412
 
><action
413
 
>Lülitab</action
414
 
> olekuriba näitamise sisse ja välja.</para
415
 
></listitem>
416
 
</varlistentry>
417
 
 
418
 
<varlistentry>
419
 
<term
420
 
><menuchoice
421
 
><guimenu
422
 
>Seadistused</guimenu
423
 
> <guimenuitem
424
 
>Kiirklahvide seadistamine...</guimenuitem
425
 
> </menuchoice
426
 
></term>
427
 
<listitem
428
 
><para
429
 
><action
430
 
>Avab</action
431
 
> &kde; standardse kiirklahvide seadistamise dialoogi, kus saab määrata toimingutele kiirklahve. </para
432
 
></listitem>
433
 
</varlistentry>
434
 
 
435
 
<varlistentry>
436
 
<term
437
 
><menuchoice
438
 
><guimenu
439
 
>Seadistused</guimenu
440
 
> <guimenuitem
441
 
>Tööriistaribade seadistamine...</guimenuitem
442
 
> </menuchoice
443
 
></term>
444
 
<listitem
445
 
><para
446
 
><action
447
 
>Võimaldab seadistada</action
448
 
> tööriistaribade välimust. </para
449
 
></listitem>
450
 
</varlistentry>
451
 
 
452
 
</variablelist>
453
 
 
454
 
</sect2>
455
 
 
456
 
<sect2>
457
 
<title
458
 
>Menüü <guimenu
459
 
>Abi</guimenu
460
 
></title>
461
 
&help.menu.documentation; </sect2>
 
613
<sect1>
 
614
        <title
 
615
>Import ja eksport</title>
 
616
        <para
 
617
>&rocs; toetab praegu importimisel ja eksportimisel järgmisi failivorminguid:</para>
 
618
        <itemizedlist>
 
619
                <listitem
 
620
><para
 
621
>DOT-failid, tuntud ka kui Graphviz-failid</para
 
622
></listitem>
 
623
                <listitem
 
624
><para
 
625
>GML-failid</para
 
626
></listitem>
 
627
                <listitem
 
628
><para
 
629
>Klaartekstfailid</para
 
630
></listitem>
 
631
        </itemizedlist>
 
632
        <para
 
633
>Praegu imporditakse enamiku failitüüpide korral ainult üksikud väärtused. Imporditavate väärtuste hulka kuuluvad tipud ja nendega seotud seosed, kõigi elementide nimed, väärtused ja olemasolu korral ka koordinaadid.</para>
462
634
</sect1>
463
635
</chapter>
464
636
 
465
 
 
466
637
<chapter id="credits">
467
 
 
468
638
<title
469
639
>Autorid ja litsents</title>
470
640
 
471
641
<para
472
642
>&rocs; </para>
473
643
<para
474
 
>Rakenduse autoriõigus 2009: Tomaz Canabrava tcanabrava at kde dot org </para>
 
644
>Rakenduse autoriõigus:</para>
 
645
<itemizedlist>
 
646
        <listitem
 
647
><para
 
648
>Autoriõigus 2008: Ugo Sangiori (ugorox AT gmail.com)</para
 
649
></listitem>
 
650
        <listitem
 
651
><para
 
652
>Autoriõigus 2008-2011: Tomaz Canabrava (tcanabrava AT kde.org)</para
 
653
></listitem>
 
654
        <listitem
 
655
><para
 
656
>Autoriõigus 2008-2011: Wagner Reck (wagner.reck AT gmail.com)</para
 
657
></listitem>
 
658
        <listitem
 
659
><para
 
660
>Autoriõigus 2011: Andreas Cord-Landwehr (cordlandwehr AT googlemail.com)</para
 
661
></listitem>
 
662
</itemizedlist>
475
663
 
476
664
<para
477
 
>Dokumentatsiooni autoriõigus 2009: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; ja Tomaz Canabrava tcanabrava at kde dot org </para>
 
665
>Dokumentatsiooni autoriõigus:</para>
 
666
<itemizedlist>
 
667
        <listitem
 
668
><para
 
669
>Dokumentatsiooni autoriõigus 2009: &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;</para
 
670
></listitem>
 
671
        <listitem
 
672
><para
 
673
>Dokumentatsiooni autoriõigus 2009: Tomaz Canabrava (tcanabrava AT kde.org)</para
 
674
></listitem>
 
675
        <listitem
 
676
><para
 
677
>Dokumentatsiooni autoriõigus 2011: Andreas Cord-Landwehr (cordlandwehr AT googlemail.com)</para
 
678
></listitem>
 
679
</itemizedlist>
478
680
 
479
681
<para
480
682
>Tõlge eesti keelde: Marek Laane <email