summaryrefslogtreecommitdiffstats
path: root/koffice-i18n-it/docs/koffice/chalk/developers-plugins.docbook
blob: 1e509084f5aa7ff18cac6edde027c6ab31e337a0 (plain)
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
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
<sect1 id="developers-plugins">
<title
>Sviluppare plugin per &chalk;</title>

<sect2 id="developers-plugins-introduction">
<title
>Introduzione</title>

<para
>&chalk; è infinitamente estensibile. Gli strumenti, i filtri, ampie parti dell'interfaccia utente e anche gli spazi di colori sono plugin. &chalk; riconosce sei tipi di plugin: </para>

<itemizedlist>
<listitem
><para
>spazi di colori: questi definiscono i canali che costituiscono un pixel</para
></listitem>
<listitem
><para
>strumenti: qualsiasi cosa fatta con un mouse o una tavoletta grafica</para
></listitem>
<listitem
><para
>operazioni di disegno: effetti di disegno per gli strumenti</para
></listitem>
<listitem
><para
>filtri delle immagini: cambiano tutti i pixel, o solo i pixel selezionati di un livello</para
></listitem>
<listitem
><para
>plugin di visualizzazione: estendono l'interfaccia utente di &mdash; con nuove finestre, tavolozze e operazioni</para
></listitem>
<listitem
><para
>filtri di importazione o esportazione: leggono e scrivono tutti i tipi di formati di immagini</para
></listitem>
</itemizedlist>

<para
>&chalk; stesso è costituito da tre librerie stratificate e una cartella con alcune classi comuni di supporto: chalkcolor, chalkimage e chalkui. All'interno di &chalk;, gli oggetti possono essere identificati da un <classname
>KisID</classname
>, cioè una combinazione di una stringa univoca non tradotta (usata per esempio nei salvataggi) e una stringa tradotta per l'uso nell'interfaccia utente. </para
><para
>Due parole sulla compatibilità: &chalk; è ancora in fase di sviluppo. Da &chalk; 1.5 a 1.6 non ci si attendono molti cambiamenti nell'API, ma potrebbe essercene qualcuno. Da &chalk; 1.6 a 2.0 ci sposteremo da &Qt;3 a &Qt;4, da &kde;3 a &kde;4, da <command
>automake</command
> a <command
>cmake</command
>: ci si attendono molti cambiamenti. Se sviluppi un plugin per &chalk; e scegli di farlo nel deposito Subversion di &chalk;, molto probabilmente ti aiuteremo nel trasferimento. Questi cambiamenti potrebbero rendere obsolete parti di questo documento. Controlla sempre l'ultima documentazione dell'API o i file di intestazione installati sul tuo sistema. </para>

<sect3 id="developers-plugins-introduction-chalkcolor">
<title
>ChalkColor</title>

<para
>La prima libreria è chalkcolor. Questa libreria carica i plugin per gli spazi di colori. </para
><para
>Un plugin per spazi di colori dovrebbe implementare la classe astratta <classname
>KisColorSpace</classname
> o, se le capacità di base del nuovo spazio di colori saranno implementate con  <command
>lcms</command
> (<ulink url="http://www.littlecms.com/"
>sito Web</ulink
>), estendere <classname
>KisAbstractColorSpace</classname
>. La libreria chalkcolor potrebbe essere usata da altre applicazioni e non dipende da &koffice;. </para>
</sect3>

<sect3 id="developers-plugins-introduction-chalkimage">
<title
>ChalkImage</title>

<para
>La libreria chalkimage carica i plugin di filtraggio e delle operazioni di disegno, ed è responsabile del lavoro con i dati delle immagini: cambio dei pixel, composizione e disegno. Anche i pennelli, tavolozze, sfumature e motivi sono caricati da libchalkimage. È nostro obiettivo dichiarato rendere libchalkimage indipendente da &koffice;, ma attualmente condividiamo il codice di caricamento delle sfumature con &koffice;. </para
><para
>Non è facile al momento aggiungere nuovi tipi di risorse come pennelli, tavolozze, sfumature o motivi a &chalk; (aggiungere nuovi pennelli, tavolozze, sfumature o motivi è invece ovviamente facile). &chalk; segue le linee guida del progetto Create (<ulink url="http://create.freedesktop.org/"
>sito Web</ulink
>). Aggiungere il supporto per il formato dei pennelli di Photoshop richiede modifiche a libchalkimage; aggiungere nuovi file di dati per i pennelli di Gimp, no. </para
><para
><classname
>ChalkImage</classname
> carica i seguenti tipi di plugin: </para>

<itemizedlist>
<listitem
><para
>I filtri di &chalk; devono estendere e implementare le classi astratte <classname
>KisFilter</classname
>, <classname
>KisFilterConfiguration</classname
> ed eventualmente <classname
>KisFilterConfigurationWidget</classname
>. Un esempio di filtro è la maschera di contrasto.</para
></listitem>
<listitem
><para
>Le operazioni di disegno sono l'insieme di operazioni che gli strumenti di disegno come la mano libera e il cerchio hanno a disposizione. Esempi di operazioni sono la penna, l'aerografo o la gomma. Le operazioni dovrebbero estendere la classe di base <classname
>KisPaintop</classname
>. Esempi di nuove operazioni potrebbero essere un gessetto, un pennello a olio, o un complesso pennello programmabile.</para
></listitem>
</itemizedlist>

</sect3>

<sect3 id="developers-plugins-introduction-chalkui">
<title
>ChalkUI</title>

<para
>La libreria libchalkui carica i plugin degli strumenti e di vista. Questa libreria è un componente di &koffice;, ma contiene anche un certo numero di widget utili alle applicazioni grafiche. Forse dovremo dividere questa libreria in chalkpart e chalkui nel rilascio 2.0. Per ora, chi scrive script non ha accesso alla libreria e chi scrive plugin può usarla solo quando scrive plugin per strumenti o di vista. <classname
>ChalkUI</classname
> carica i seguenti tipi di plugin: </para>

<itemizedlist>
<listitem
><para
>Gli strumenti derivati da <classname
>KisTool</classname
> o una delle classi di base degli strumenti specializzati come <classname
>KisToolPaint</classname
>, <classname
>KisToolNonPaint</classname
> o <classname
>KisToolFreehand</classname
>. Un nuovo strumento potrebbe essere uno strumento di selezione degli oggetti in primo piano. Gli strumenti di disegno (inclusi gli strumenti che disegnano sulla selezione) possono usare qualsiasi operazione di disegno per determinare in che modo vengono cambiati i pixel.</para
></listitem>
<listitem
><para
>I plugin di vista sono normali componenti KPart che usano <command
>kxmlgui</command
> per infilarsi nell'interfaccia utente di &chalk;. Le opzioni dei menu, le finestre, le barre degli strumenti, insomma qualsiasi tipo di estensione all'interfaccia utente può essere un plugin di vista. In effetti, importanti funzionalità come il supporto per gli script di &chalk; sono scritte come plugin di vista.</para
></listitem>
</itemizedlist>

</sect3>

<sect3 id="developers-plugins-introduction-importexport">
<title
>Filtri di importazione ed esportazione</title>

<para
>I filtri di importazione ed esportazione sono filtri di &koffice;, sottoclassi di <classname
>KoFilter</classname
>. I filtri leggono e scrivono i dati delle immagini in uno qualsiasi della miriade di formati di immagine esistenti. Un esempio di un nuovo filtro di importazione ed esportazione di &chalk; potrebbe essere un filtro PDF. I filtri vengono caricati dalle librerie di &koffice;. </para>

</sect3>

</sect2>

<sect2 id="developers-plugins-creating">
<title
>Creare plugin</title>

<para
>I plugin si scrivono in C++ e possono usare tutta l'API di &kde;, &Qt; e &chalk;. Solo i plugin di vista dovrebbero usare l'API di &koffice;. Non preoccuparti: le API di &chalk; sono piuttosto chiare e ben documentate (per essere software libero) e scrivere il tuo primo filtro è veramente facile. </para
><para
>Se non vuoi usare il C++, puoi scrivere degli script in Python o Ruby; questa è però tutta un'altra cosa, però, e al momento non puoi scrivere strumenti, spazi di colori, operazioni o filtri di importazione ed esportazione come script. </para
><para
>I plugin di &chalk; usano i componenti di &kde; come meccanismi per il caricamento, perciò anche la <ulink url="http://developer.kde.org"
>documentazione dei componenti</ulink
> è importante qui. </para
><para
>La tua distribuzione dovrebbe avere installato i file di intestazione di rilievo con &chalk; stesso, o potrebbe averli divisi in un pacchetto per sviluppatori di &koffice; o &chalk;. Puoi trovare la documentazione dell'API pubblica di &chalk; a <ulink url="http://koffice.org/developer/apidocs/chalk/html/"
>questo indirizzo</ulink
>. </para>

<sect3 id="developers-plugins-creating-automake">
<title
>Automake (e CMake)</title>

<para
>&kde; 3.x e quindi &koffice; 1.5 e 1.6 usano <command
>automake</command
>; &kde; 4.0 e &koffice; 2.0 usano <command
>cmake</command
>. Questa esercitazione descrive come creare plugin con <command
>automake</command
>. </para
><para
>I plugin sono moduli di &kde; e dovrebbero essere segnalati come tali nei loro <filename
>Makefile.am</filename
>. I filtri, gli strumenti, le operazioni di disegno, gli spazi di colori e i filtri di importazione ed esportazione richiedono dei file <literal role="extension"
>.desktop</literal
>; i plugin di vista richiedono inoltre un file <application
>KXMLGui</application
> dal nome <filename
>pluginname.rc</filename
>. Il modo più semplice di cominciare è scaricare il progetto plugin di chalk dal deposito Subversion di &koffice; e usarlo come base per il proprio progetto. Abbiamo intenzione di preparare uno pacchetto di base per i plugin di &chalk; per KDevelop, ma non ne abbiamo ancora avuto il tempo. </para>

<sect4 id="d-p-c-a-makefile">
<title
><filename
>Makefile.am</filename
></title>

<para
>Diamo un'occhiata allo schema di un modulo plugin. Per prima cosa, <filename
>Makefile.am</filename
>. Questo è il file che  &kde; usa per generare il makefile che compila il plugin: <programlisting>
kde_services_DATA = chalkLIBRARYNAME.desktop

INCLUDES = $(all_includes)

chalkLIBRARYNAME_la_SOURCES = sourcefile1.cc sourcefile2.cc

kde_module_LTLIBRARIES = chalkLIBRARYNAME.la
noinst_HEADERS = header1.h header2.h

chalkLIBRARYNAME_la_LDFLAGS = $(all_libraries) -module $(KDE_PLUGIN)
chalkLIBRARY_la_LIBADD = -lchalkcommon

chalkextensioncolorsfilters_la_METASOURCES = AUTO
</programlisting
> Questo è il makefile per un plugin di filtro. Sostituisci <replaceable
>LIBRARYNAME</replaceable
> con il nome del tuo progetto, e sei a posto. </para
><para
>Se il tuo è un plugin di vista, dovrai probabilmente installare anche un file <literal role="extension"
>.rc</literal
> con le voci per le barre dei menu e degli strumenti. Allo stesso modo, potresti dover installare cursori ed icone. Tutto questo si può fare attraverso le solite magie per <filename
>Makefile.am</filename
> di &kde;: <programlisting
>chalkrcdir = $(kde_datadir)/chalk/chalkplugins
chalkrc_DATA = LIBRARYNAME.rc
EXTRA_DIST = $(chalkrc_DATA)

chalkpics_DATA = \
   bla.png \
   bla_cursor.png
chalkpicsdir = $(kde_datadir)/chalk/pics
</programlisting>

</para>
</sect4>

<sect4 id="d-p-c-a-desktop">
<title
>File del desktop</title>

<para
>Il file <literal role="extension"
>.desktop</literal
> dichiara il tipo di plugin: <programlisting
>[Desktop Entry]
Encoding=UTF-8
Icon=
Name=User-visible Name
ServiceTypes=Chalk/Filter
Type=Service
X-KDE-Library=chalkLIBRARYNAME
X-KDE-Version=2
</programlisting>
</para
><para
>I tipi di servizio (ServiceTypes) possibili sono: </para>

<itemizedlist>
<listitem
><para
>Chalk/Filter</para
></listitem>
<listitem
><para
>Chalk/Paintop</para
></listitem>
<listitem
><para
>Chalk/ViewPlugin</para
></listitem>
<listitem
><para
>Chalk/Tool</para
></listitem>
<listitem
><para
>Chalk/ColorSpace</para
></listitem>
</itemizedlist>

<para
>I filtri di importazione ed esportazione usano l'infrastruttura di filtraggio generica di &koffice; e vanno discussi a parte. </para>
</sect4>

<sect4 id="d-p-c-a-boilerplate">
<title
>Codice da riutilizzare</title>

<para
>Hai anche bisogno di un po' di codice comune chiamato dall'infrastruttura dei componenti di &kde; per avviare il plugin: un file di intestazione e uno di implementazione. </para
><para
>Un file di intestazione: <programlisting
>#ifndef TOOL_STAR_H_
#define TOOL_STAR_H_

#include &lt;tdeparts/plugin.h&gt;

/**
* Un modulo che fornisce uno strumento stella*/
class ToolStar : public KParts::Plugin
{
   Q_OBJECT
public:
   ToolStar(QObject *parent, const char *name, const QStringList &amp;);
   virtual ~ToolStar();

};

#endif // TOOL_STAR_H_
</programlisting>
</para>

<para
>E un file di implementazione: <programlisting
>#include &lt;kinstance.h&gt;
#include &lt;kgenericfactory.h&gt;

#include &lt;kis_tool_registry.h&gt;

#include "tool_star.h"
#include "kis_tool_star.h"


typedef KGenericFactory&lt;ToolStar&gt; ToolStarFactory;
K_EXPORT_COMPONENT_FACTORY( chaltdetoolstar, ToolStarFactory( "chalk" ) )


ToolStar::ToolStar(QObject *parent, const char *name, const QStringList &amp;)
   : KParts::Plugin(parent, name)
{
   setInstance(ToolStarFactory::instance());
   if ( parent->inherits("KisToolRegistry") )
   {
       KisToolRegistry * r = dynamic_cast&lt;KisToolRegistry*&gt;( parent );
       r -> add(new KisToolStarFactory());
   }

}

ToolStar::~ToolStar()
{
}

#include "tool_star.moc"
</programlisting>
</para>
</sect4>

<sect4 id="d-p-c-a-registries">
<title
>Registri</title>

<para
>Gli strumenti sono caricati dal registro degli strumenti e si registrano con esso. I plugin come strumenti, filtri e operazioni di disegno vengono caricati una sola volta: i plugin di vista vengono caricati per ogni vista creata. Nota che generalmente noi registriamo delle fabbriche. Per esempio, con gli strumenti, si crea una nuova istanza di uno strumento per ogni puntatore (mouse, penna, gomma), e viene creata una nuova operazione di disegno ogni volta che uno strumento riceve un evento di mouse premuto. </para>

<para
>I filtri chiamano il registro dei filtri: <programlisting
>if (parent->inherits("KisFilterRegistry")) {
       KisFilterRegistry * manager = dynamic_cast&lt;KisFilterRegistry *&gt;(parent);
       manager->add(new KisFilterInvert());
   }
</programlisting>
</para
><para
>Le operazioni di disegno il registro delle operazioni: <programlisting
>if ( parent->inherits("KisPaintOpRegistry") ) {
           KisPaintOpRegistry * r = dynamic_cast&lt;KisPaintOpRegistry*&gt;(parent);
           r -> add ( new KisSmearyOpFactory );
   }
</programlisting>
</para
><para
>Gli spazi di colori il registro degli spazi di colori (con qualche complicazione): <programlisting
>if ( parent->inherits("KisColorSpaceFactoryRegistry") ) {
        KisColorSpaceFactoryRegistry * f = dynamic_cast&lt;isColorSpaceFactoryRegistry*&gt;(parent);

       KisProfile *defProfile = new KisProfile(cmsCreate_sRGBProfile());
       f->addProfile(defProfile);

       KisColorSpaceFactory * csFactory = new KisRgbColorSpaceFactory();
       f->add(csFactory);
   
       KisColorSpace * colorSpaceRGBA = new KisRgbColorSpace(f, 0);
       KisHistogramProducerFactoryRegistry::instance() -> add(
               new KisBasicHistogramProducerFactory&lt;KisBasicU8HistogramProducer&gt;
               (KisID("RGB8HISTO", i18n("RGB8 Histogram")), colorSpaceRGBA) );
   }
</programlisting>
</para
><para
>I plugin di vista non devono registrarsi, e hanno accesso a un oggetto <classname
>KisView</classname
>: <programlisting
>if ( parent->inherits("KisView") )
   {
       setInstance(ShearImageFactory::instance());
       setXMLFile(locate("data","chalkplugins/shearimage.rc"), true);

       (void) new TDEAction(i18n("&amp;Shear Image..."), 0, 0, this, SLOT(slotShearImage()), actionCollection(), "shearimage");
       (void) new TDEAction(i18n("&amp;Shear Layer..."), 0, 0, this, SLOT(slotShearLayer()), actionCollection(), "shearlayer");

       m_view = (KisView*) parent;
   }
</programlisting>
</para
><para
>Ricordati che questo vuol dire che un plugin di vista sarà creato per ogni vista creata dall'utente: dividere una vista significa ricaricare tutti i plugin. </para>
</sect4>

<sect4 id="d-p-c-a-versioning">
<title
>Versioni dei plugin</title>

<para
>&chalk; 1.5 carica i plugin con l'impostazione <literal
>X-KDE-Version=2</literal
> nel file <literal role="extension"
>.desktop</literal
>. I file binari dei plugin di &chalk; 1.6 probabilmente saranno incompatibili con i plugin 1.5 e richiederanno il numero di versione 3. I plugin di &chalk; 2.0 richiederanno il numero di versione 3. Sì, effettivamente non è del tutto logico. </para>

</sect4>
</sect3>
</sect2>

<sect2 id="developers-plugins-colorspaces">
<title
>Spazi di colori</title>

<para
>Gli spazi di colori implementano la classe puramente virtuale <classname
>KisColorSpace</classname
>. Ci sono due tipi di spazi di colori: quelli che possono usare <command
>lcms</command
> per le trasformazioni tra spazi di colori, e quelli troppo particolari per essere gestiti da <command
>lcms</command
>. Esempi del primo tipo sono CMYK, RGB, e YUV. Un esempio del secondo tipo sono i colori ad acqua. Gli spazi di colori che usano <command
>lcms</command
> possono essere derivati da <classname
>KisAbstractColorSpace</classname
>, o una delle classi di base specializzate per un certo numero di bit per canale. </para
><para
>Implementare uno spazio di colori è piuttosto facile. Il principio generale è che gli spazi di colori lavorano con un semplice array di byte. L'interpretazione di questi byte è lasciata allo spazio di colori. Per esempio, un pixel in grigio a 16 bit consiste di quattro byte: due byte per il valore del grigio e due per il valore alfa. Sei libero di usare una struttura per lavorare con lo schema di memorizzazione di un pixel nell'implementazione del tuo spazio di colori, ma la rappresentazione non viene esportata. L'unico modo in cui il resto di &chalk; può capire di quali canali e di quale tipo consistano i pixel del tuo spazio di colori è attraverso la classe <classname
>KisChannelInfo</classname
>. </para
><para
>I filtri e le operazioni di disegno usano i molti metodi offerti da <classname
>KisColorSpace</classname
> per fare il loro lavoro. In molti casi, l'implementazione predefinita in <classname
>KisAbstractColorSpace</classname
> funzionerà, ma più lentamente di un'implementazione configurata per il tuo spazio di colori perché <classname
>KisAbstractColorSpace</classname
> convertirà tutti i pixel in L*a*b a 16 bit e viceversa. </para>

<sect3 id="developers-plugins-colorspaces-kischannelinfo">
<title
><classname
>KisChannelInfo</classname
></title>

<programlisting
>(http://websvn.kde.org/trunk/koffice/chalk/chalkcolor/kis_channelinfo.h)
</programlisting>
<para
>Questa classe definisce i canali che costituiscono un singolo pixel in un certo spazio di colori. Un canale ha le seguenti importanti caratteristiche: </para>
<itemizedlist>
<listitem
><para
>un nome da visualizzare nell'interfaccia utente</para
></listitem>
<listitem
><para
>una posizione: il byte dove cominciano i byte che rappresentano questo canale nel pixel.</para
></listitem>
<listitem
><para
>un tipo: colore, alfa, sostanza o substrato. Il colore è il semplice colore, alfa è la trasparenza, la sostanza è una rappresentazione della quantità di pigmento o cose simili, il substrato è la rappresentazione della tela (nota che questo potrebbe essere rifattorizzato in men che non si dica).</para
></listitem>
<listitem
><para
>un tipo di valore: byte, corto, intero, a virgola mobile o altro.</para
></listitem>
<listitem
><para
>dimensione: il numero di byte presi da questo canale</para
></listitem>
<listitem
><para
>colore: una rappresentazione <classname
>QColor</classname
> di questo canale per la visualizzazione nell'interfaccia utente, per esempio con istogrammi.</para
></listitem>
<listitem
><para
>un'abbreviazione da usare nell'interfaccia quando non c'è molto spazio</para
></listitem>
</itemizedlist>
</sect3>

<sect3 id="developers-plugins-colorspaces-kiscompositeop">
<title
><classname
>KisCompositeOp</classname
></title>

<para
>Come riportato dall'articolo originale di Porter e Duff, ci sono molti modi di combinare i pixel per ottenere un nuovo colore. La classe <classname
>KisCompositeOp</classname
> definisce la maggior parte di questi: questo insieme non è facilmente estensibile se non modificando la libreria chalkcolor. </para
><para
>Un plugin per spazi di colori può supportare qualsiasi sottoinsieme di queste possibili operazioni di composizione, ma l'insieme deve sempre includere "OVER" (lo stesso che "NORMAL") e "COPY". Il resto è più o meno opzionale, anche se ovviamente più ce n'è meglio è. </para>
</sect3>

<sect3 id="developers-plugins-colorspaces-kiscolorspace">
<title
><classname
>KisColorSpace</classname
></title>

<para
>I metodi nella classe puramente virtuale <classname
>KisColorSpace</classname
> possono essere divisi in un certo numero di gruppi: conversione, identificazione e manipolazione. </para
><para
>Tutte le classi devono poter convertire un pixel da e in RGB a 8 bit (per esempio, un <classname
>QColor</classname
>), e preferibilmente anche in e da L*a*b a 16 bit. Inoltre, c'è un metodo per convertire in qualsiasi spazio di colori da quello attuale. </para
><para
>Gli spazi di colori sono descritti dal vettore <classname
>KisChannelInfo</classname
>, il numero di canali, il numero di byte in un singolo pixel, se supporta le immagini ad alto raggio dinamico (<foreignphrase lang="en"
>High Dynamic Range</foreignphrase
>, HDR) e altro. </para
><para
>La manipolazione è, per esempio, la combinazione di due pixel in uno nuovo: bitBlt, oscuramento o convoluzione dei pixel. </para
><para
>Consulta la documentazione dell'API per una descrizione completa di tutti i metodi che devi implementare in uno spazio di colori. </para
><para
><classname
>KisAbstractColorSpace</classname
> implementa molti dei metodi virtuali di <classname
>KisColorSpace</classname
> usando funzioni della libreria <command
>lcms</command
>. Oltre a <classname
>KisAbstractColorSpace</classname
> ci sono classi di base per gli spazi di colori a 8 e 16 bit interi e 16 e 32 bit a virgola mobile che definiscono operazioni comuni per spostarsi tra profondità in bit. </para>

</sect3>
</sect2>

<sect2 id="developers-plugins-filters">
<title
>Filtri</title>

<para
>I filtri sono plugin che esaminano i pixel in un livello e ci effettuano modifiche. Sebbene &chalk; usi un'efficiente interfaccia a memoria affiancata per memorizzare i pixel, gli autori di filtri non devono preoccuparsi di ciò. Quando scrivi un plugin di filtraggio per l'API grafica di &Java;, Photoshop o Gimp, devi fare attenzione ai bordi dei riquadri e <quote
>ritagliarli</quote
> al posto giusto: &chalk; nasconde questo dettaglio di implementazione. </para>
<note
><para
>Nota che è teoricamente facile sostituire l'attuale interfaccia di memorizzazione affiancata dei dati delle immagini con un'altra, ma quelle interfacce non sono al momento veri plugin, per motivi di prestazioni.</para
></note>
<para
>&chalk; usa gli iteratori per leggere e scrivere i valori dei pixel. In alternativa, puoi leggere un blocco di pixel in memoria temporanea, lavorarci e riscriverlo in blocco. Però ciò non è necessariamente più efficiente, e potrebbe anche essere più lento che usare gli iteratori; potrebbe semplicemente essere più comodo. Vedi la documentazione dell'API. </para
><para
>Le immagini di &chalk; sono composte di livelli, dei quali ci sono al momento quattro tipi: livelli di disegno, di gruppo, di regolazione (che contengono un filtro applicato dinamicamente ai livelli inferiori) e di parte. I filtri operano sempre nei livelli di disegno. Questi contengono dispositivi di disegno, della classe <classname
>KisPaintDevice</classname
>. Un dispositivo di disegno, a sua volta, permette l'accesso ai pixel. </para
><para
>I <classname
>PaintDevice</classname
> sono generalmente passati come puntatori condivisi. Un puntatore condiviso tiene conto dei posti in cui il dispositivo è attualmente in uso e lo elimina quando non viene più usato da nessuna parte. Riconosci la versione a puntatore condiviso di un dispositivo di disegno dal su suffisso <literal
>SP</literal
>. Ricordati solo che non devi mai eliminare esplicitamente un <classname
>KisPaintDeviceSP</classname
>. </para
><para
>Diamo un'occhiata a un semplicissimo filtro, uno che inverta ogni pixel. Il codice del filtro è nella cartella <filename class="directory"
>koffice/chalk/plugins/filters/example</filename
>. Il metodo principale è <programlisting>
KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst,
                        KisFilterConfiguration* /*config*/, const QRect&amp; rect).
</programlisting
> La funzione riceve due dispositivi di disegno, un oggetto di configurazione (che non viene usato in questo semplice filtro) e un <varname
>rect</varname
>. Il <varname
>rect</varname
> descrive l'area del dispositivo di disegno su cui il filtro dovrebbe avere effetto. Quest'area è descritta da interi, vale a dire senza precisione sotto il livello dei pixel. </para
><para
>Il dispositivo di disegno <varname
>src</varname
> è per leggere, il dispositivo <varname
>dst</varname
> è per scrivere. Questi parametri potrebbero anche puntare allo stesso dispositivo di disegno, o a due diversi (nota: nel futuro potrebbe diventare in un solo dispositivo). </para
><para
>Adesso, diamo un'occhiata al codice una riga alla volta: </para>
<programlisting
>void KisFilterInvert::process(KisPaintDeviceSP src, KisPaintDeviceSP dst,
                             KisFilterConfiguration* /*config*/, const QRect&amp; rect)
{
   Q_ASSERT(src != 0);
   Q_ASSERT(dst != 0);

   KisRectIteratorPixel srcIt = src->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), false); <co id="invert1" />
   KisRectIteratorPixel dstIt = dst->createRectIterator(rect.x(), rect.y(), rect.width(), rect.height(), true ); <co id="invert2" />

   int pixelsProcessed = 0;
   setProgressTotalSteps(rect.width() * rect.height());

   KisColorSpace * cs = src->colorSpace();
   Q_INT32 psize = cs->pixelSize();

   while( ! srcIt.isDone() )
   {
       if(srcIt.isSelected()) <co id="invert3" />
       {
           memcpy(dstIt.rawData(), srcIt.oldRawData(), psize); <co id="invert4" />

           cs->invertColor( dstIt.rawData(), 1); <co id="invert5" />
       }
       setProgress(++pixelsProcessed);
       ++srcIt;
       ++dstIt;
   }
   setProgressDone(); // Must be called even if you don't really support progression
}
</programlisting>

<calloutlist>
<callout arearefs="invert1">
<para
>Questo crea un iteratore per leggere i pixel esistenti. &chalk; ha tre tipi di iteratori: orizzontali, verticali e rettangolari. L'iteratore rettangolare prende il percorso più efficiente nei dati dell'immagine, ma non garantisce nulla sulla posizione del prossimo pixel restituito. Ciò vuol dire che non puoi essere sicuro che il prossimo pixel che recupererai sarà di fianco al pixel che hai appena ricevuto. Gli iteratori di linea orizzontale e verticale garantiscono la posizione dei pixel che restituiscono. </para
></callout>
<callout arearefs="invert2"
><para
>(2) Creiamo l'iteratore di destinazione con <literal
>write</literal
> impostato a <literal
>true</literal
>. Ciò vuol dire che se il dispositivo di disegno di destinazione è più piccolo del rettangolo che scriviamo, sarà automaticamente ingrandito per adattarsi a ogni pixel su cui iteriamo. Nota che qui abbiamo un errore potenziale: se <varname
>dst</varname
> e <varname
>src</varname
> non sono lo stesso dispositivo, è possibile che i pixel restituiti dagli iteratori non corrispondano. Per ogni posizione dell'iteratore, <varname
>src</varname
> potrebbe, per esempio, essere a 165200, mentre <varname
>dst</varname
> potrebbe essere a 208, e quindi la copia potrebbe distorcere l'immagine. </para
></callout>
<callout arearefs="invert3"
><para
>Se vuoi sapere se un pixel è selezionato, usa il metodo <methodname
>isSelected</methodname
>. Però l'essere selezionato non è una proprietà binaria di un pixel, un pixel può essere selezionato a metà, appena o quasi del tutto. Puoi ottenere anche questo valore dall'iteratore. Le selezioni sono in realtà un dispositivo di disegno a maschera con un'intervallo tra 0 e 255, dove 0 è completamente non selezionato e 255 completamente selezionato. L'iteratore ha due metodi: <methodname
>isSelected()</methodname
> e <methodname
>selectedNess()</methodname
>. Il primo restituisce vero se un pixel è selezionato a qualsiasi livello (cioè se il valore della maschera è maggiore o uguale a 1), l'altro restituisce il valore della maschera. </para
></callout>
<callout arearefs="invert4"
><para
>Come notato sopra, questo <literal
>memcpy</literal
> può essere un brutto problema. <methodname
>rawData()</methodname
> restituisce l'array di byte che è lo stato attuale del pixel; <methodname
>oldRawData()</methodname
> lo restituisce come era prima che creassimo l'iteratore. Tuttavia, qui potremmo stare copiando il pixel sbagliato. In pratica, non capiterà spesso, a meno che <varname
>dst</varname
> esista già e non sia allineato a <varname
>src</varname
>. </para
></callout>
<callout arearefs="invert5"
><para
>Però è giusto: invece di cercare di capire quale canale rappresenta un byte, usiamo una funzione fornita da tutti gli spazi di colori per invertire il pixel attuale. Gli spazi di colori hanno molte operazioni sui pixel che puoi usare. </para
></callout>
</calloutlist>

<para
>Questo non è tutto quello che c'è per la creazione dei filtri. I filtri hanno altre due componenti importanti: un oggetto e un widget di configurazione; i due interagiscono molto da vicino. Il widget di configurazione crea un oggetto di configurazione, ma può anche essere riempito con un oggetto di configurazione preesistente. Gli oggetti di configurazione possono rappresentarsi come XML ed essere creati da XML. Questo è quello che rende possibili i livelli di regolazione. </para>

<sect3 id="developers-plugins-filters-iterators">
<title
>Iteratori</title>

<para
>Ci sono tre tipi di iteratori: </para>

<itemizedlist>
<listitem
><para
>Linee orizzontali</para
></listitem>
<listitem
><para
>Linee verticali</para
></listitem>
<listitem
><para
>Iteratori rettangolari</para
></listitem>
</itemizedlist>

<para
>Gli iteratori a linea orizzontale e verticale hanno un metodo per spostare l'iteratore alla prossima riga o colonna: <methodname
>nextRow()</methodname
> e <methodname
>nextCol()</methodname
>. Usare questi è molto più veloce che creare un nuovo iteratore per ogni riga o colonna. </para
><para
>Gli iteratori di &chalk; sono a prova di thread, quindi è possibile dividere il lavoro in thread diversi. Tuttavia, le versioni future di &chalk; useranno il metodo <methodname
>supportsThreading()</methodname
> per determinare se il tuo filtro può essere applicato a pezzi dell'immagine (cioè se tutti i pixel possono essere modificati indipendentemente, invece che essere cambiati da qualche valore determinato da tutti i pixel dell'immagine) e eseguire automaticamente in thread il filtro. </para>
</sect3>

<sect3 id="developers-plugins-filters-kisfilterconfiguration">
<title
><classname
>KisFilterConfiguration</classname
></title>

<para
><classname
>KisFilterConfiguration</classname
> è una struttura usata per salvare le impostazioni dei filtri sul disco, per esempio livelli di regolazione. Il plugin di scripting usa la mappa delle proprietà in fondo a <classname
>KisFilterConfigaration</classname
> per rendere possibile la scrittura di filtri con script. I filtri possono fornire un widget personalizzato che &chalk; visualizzerà nella galleria dei filtri, nella finestra di anteprima dei filtri o la scheda delle opzioni degli strumenti dello strumento di disegno con filtri. </para>
<para
>Un esempio, preso dal filtro dell'effetto di pittura a olio: </para>
<programlisting
>class KisOilPaintFilterConfiguration : public KisFilterConfiguration
{

public:

   KisOilPaintFilterConfiguration(Q_UINT32 brushSize, Q_UINT32 smooth)
       : KisFilterConfiguration( "oilpaint", 1 )
       {
           setProperty("brushSize", brushSize);
           setProperty("smooth", smooth);
       };
public:

   inline Q_UINT32 brushSize() { return getInt("brushSize"); };
   inline Q_UINT32 smooth() {return getInt("smooth"); };

};
</programlisting>
</sect3>

<sect3 id="developers-plugins-filters-kisfilterconfigurationwidget">
<title
><classname
>KisFilterConfigurationWidget</classname
></title>

<para
>La maggior parte dei filtri può essere modificata dall'utente. Puoi creare un widget di configurazione che &chalk; userà ovunque sia usato il filtro. Per esempio: </para>

<para>
<screenshot>
<screeninfo
>La finestra <guilabel
>Pittura a olio</guilabel
></screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="dialogs-oilpaint.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>La finestra <guilabel
>Pittura a olio</guilabel
></phrase>
</textobject>
<caption
><para
>La finestra <guilabel
>Pittura a olio</guilabel
></para
></caption>
</mediaobject>
</screenshot>
</para>

<para
>Nota che solo il lato sinistro di questa finestra è tua responsabilità: &chalk; fa il resto. Ci sono tre modi di creare un widget di opzioni: </para>

<itemizedlist>
<listitem
><para
>Usa &Qt; Designer per creare un widget di base, e fanne una sottoclasse per il tuo filtro</para
></listitem>
<listitem
><para
>Usa uno dei semplici widget che mostrano un certo numero di cursori per gli elenchi di numeri interi, a virgola mobile o valori booleani. Questi sono utili se, come nella schermata sopra, il filtro può essere configurato con un certo numero di cursori per gli elenchi di numeri interi, a virgola mobile o valori booleani. Vedi la documentazione dell'API di <classname
>KisMultiIntegerFilterWidget</classname
>, <classname
>KisMultiDoubleFilterWidget</classname
> e <classname
>KisMultiBoolFilterWidget</classname
>.</para
></listitem>
<listitem
><para
>Scrivi un widget a mano. Non è raccomandato, e se lo fai e vuoi che il tuo filtro diventi parte di un rilascio ufficiale di &chalk;, ti chiederò di ripetere il tuo widget scritto a mano con un widget di &Qt; Designer.</para
></listitem>
</itemizedlist>

<para
>Il filtro di pittura a olio usa il widget multiintero: </para>

<programlisting
>KisFilterConfigWidget * KisOilPaintFilter::createConfigurationWidget(QWidget* parent, KisPaintDeviceSP /*dev*/)
{
   vKisIntegerWidgetParam param;
   param.push_back( KisIntegerWidgetParam( 1, 5, 1, i18n("Brush size"), "brushSize" ) );
   param.push_back( KisIntegerWidgetParam( 10, 255, 30, i18n("Smooth"), "smooth" ) );
   return new KisMultiIntegerFilterWidget(parent, id().id().ascii(), id().id().ascii(), param );
}

KisFilterConfiguration* KisOilPaintFilter::configuration(QWidget* nwidget)
{
   KisMultiIntegerFilterWidget* widget = (KisMultiIntegerFilterWidget*) nwidget;
   if( widget == 0 )
   {
       return new KisOilPaintFilterConfiguration( 1, 30);
   } else {
       return new KisOilPaintFilterConfiguration( widget->valueAt( 0 ), widget->valueAt( 1 ) );
   }
}

std::list&lt;KisFilterConfiguration*&gt; KisOilPaintFilter::listOfExamplesConfiguration(KisPaintDeviceSP )
{
   std::list&lt;KisFilterConfiguration*&gt; list;
   list.insert(list.begin(), new KisOilPaintFilterConfiguration( 1, 30));
   return list;
}
</programlisting>

<para
>Puoi vedere come funziona: riempi un vettore con i tuoi parametri interi e crea il widget. Il metodo <methodname
>configuration()</methodname
> ispeziona il widget e crea il giusto oggetto di configurazione del filtro; in questo caso, ovviamente, <classname
>KisOilPaintFilterConfiguration</classname
>. Il metodo <methodname
>listOfExamplesConfiguration</methodname
> restituisce un elenco con oggetti di configurazione di esempio per la finestra della galleria dei filtri. </para>
</sect3>

<sect3 id="developers-plugins-filters-conclusion">
<title
>Conclusione sui filtri</title>

<para
>C'è ovviamente molto di più su come scrivere filtri interessanti, ma con queste spiegazioni, la documentazione dell'API e l'accesso al codice sorgente dovresti poter cominciare. Non esitare a contattare gli sviluppatori di &chalk; su IRC o sulla mailing list. </para>
</sect3>

</sect2>

<sect2 id="developers-plugins-tools">
<title
>Strumenti</title>

<para
>Gli strumenti compaiono nella raccolta di strumenti di &chalk;. Ciò vuol dire che c'è un limite a quanti nuovi strumenti ci possono essere: ragiona piuttosto se un'operazione di disegno non potrebbe essere abbastanza per il tuo obiettivo. Gli strumenti possono usare il mouse (o la tavoletta) e la tastiera in modi complessi, cosa che le operazioni di disegno non possono fare. Questo è il motivo per cui Duplica è uno strumento, ma l'aerografo è un'operazione di disegno. </para
><para
>Fai attenzione ai dati statici nello strumento: viene creata una nuova istanza dello strumento per ogni dispositivo di input: mouse, pennino, gomma, aerografo, qualsiasi cosa. Gli strumenti vengono divisi in gruppi logici: </para>
<itemizedlist>
<listitem
><para
>strumenti per disegnare forme (cerchio, rettangolo)</para
></listitem>
<listitem
><para
>strumenti per disegnare a mano libera (pennello)</para
></listitem>
<listitem
><para
>strumenti di trasformazione che cambiano la geometria di un livello</para
></listitem>
<listitem
><para
>strumenti di riempimento (come il riempimento a secchio o le sfumature)</para
></listitem>
<listitem
><para
>strumenti di visualizzazione (che non cambiano nessun pixel, ma modificano il modo in cui vedi la tela, come l'ingrandimento)</para
></listitem>
<listitem
><para
>strumenti di selezione (che cambiano la maschera di selezione)</para
></listitem>
</itemizedlist>

<para
>L'interfaccia degli strumenti è descritta nella documentazione dell'API di <classname
>KisTool</classname
>. Ci sono tre sottoclassi: <classname
>KisToolPaint</classname
>, <classname
>KisToolNonPaint</classname
> e <classname
>KisToolShape</classname
> (che in realtà è una sottoclasse di <classname
>KisToolPaint</classname
>) che specializzano <classname
>KisTool</classname
> per le operazioni di disegno (cioè cambiare i pixel), non di disegno e di disegno di forme. </para
><para
>Uno strumento ho un widget di opzioni, esattamente come i filtri. Attualmente, i widget di opzioni vengono visualizzati in una scheda in una finestra agganciata. Potremmo cambiarlo in una striscia sotto il menu principale (che sostituirebbe la barra degli strumenti) per &chalk; 2.0, ma per ora progetta il widget di opzioni per stare nella scheda. Come sempre, è meglio usare &Qt; Designer per il widget di opzioni. </para
><para
>Un buon esempio di strumento è lo strumento Stella: </para>

<screen
>kis_tool_star.cc       Makefile.am   tool_star_cursor.png  wdg_tool_star.ui
kis_tool_star.h        Makefile.in   tool_star.h           
chaltdetoolstar.desktop  tool_star.cc  tool_star.png         
</screen>

<para
>Come vedi, hai bisogno di due immagini: una per il cursore e una per la raccolta degli strumenti. <filename
>tool_star.cc</filename
> è solo il programma che carica il plugin, un po' come abbiamo visto sopra. La parte importante è l'implementazione: </para>

<programlisting
>KisToolStar::KisToolStar()
   : KisToolShape(i18n("Star")),
     m_dragging (false),
     m_currentImage (0)
{
   setName("tool_star");
   setCursor(KisCursor::load("tool_star_cursor.png", 6, 6));
   m_innerOuterRatio=40;
   m_vertices=5;
}
</programlisting>

<para
>Il costruttore imposta il nome interno (che non va tradotto) e la chiamata alla classe superiore imposta il nome visibile. Carichiamo anche l'immagine del cursore e impostiamo un certo numero di variabili. </para>

<programlisting
>void KisToolStar::update (KisCanvasSubject *subject)
{
   KisToolShape::update (subject);
   if (m_subject)
       m_currentImage = m_subject->currentImg();
}
</programlisting>

<para
>Il metodo <methodname
>update()</methodname
> viene chiamato quando lo strumento viene selezionato. Non è un metodo di <classname
>KisTool</classname
>, ma di <classname
>KisCanvasObserver</classname
>. Gli osservatori della tela ricevono un avviso ogni volta che qualcosa cambia nella visualizzazione, il che può essere utile per gli strumenti. </para
><para
>I seguenti metodi (<methodname
>buttonPress</methodname
>, <methodname
>move</methodname
> e <methodname
>buttonRelease</methodname
>) sono chiamati da &chalk; quando il dispositivo di input (mouse, pennino, gomma, eccetera) viene premuto, spostato o rilasciato. Nota che avrai eventi di spostamento anche se il pulsante del mouse non viene premuto. Gli eventi non sono i normali eventi &Qt;, ma eventi sintetici di &chalk; perché noi usiamo dei trucchetti di basso livello per avere abbastanza eventi da disegnare una linea liscia. Come impostazione predefinita, le librerie come &Qt; (e GTK) scartano gli eventi se hanno troppo da fare per gestirli, mentre noi invece li vogliamo tutti. </para>

<programlisting
>void KisToolStar::buttonPress(KisButtonPressEvent *event)
{
   if (m_currentImage &amp;&amp; event->button() == LeftButton) {
       m_dragging = true;
       m_dragStart = event->pos();
       m_dragEnd = event->pos();
       m_vertices = m_optWidget->verticesSpinBox->value();
       m_innerOuterRatio = m_optWidget->ratioSpinBox->value();
   }
}

void KisToolStar::move(KisMoveEvent *event)
{
   if (m_dragging) {
       // erase old lines on canvas
       draw(m_dragStart, m_dragEnd);
       // move (alt) or resize star
       if (event->state() &amp; Qt::AltButton) {
           KisPoint trans = event->pos() - m_dragEnd;
           m_dragStart += trans;
           m_dragEnd += trans;
       } else {
           m_dragEnd = event->pos();
       }
       // draw new lines on canvas
       draw(m_dragStart, m_dragEnd);
   }
}

void KisToolStar::buttonRelease(KisButtonReleaseEvent *event)
{
   if (!m_subject || !m_currentImage)
       return;

   if (m_dragging &amp;&amp; event->button() == LeftButton) {
       // erase old lines on canvas
       draw(m_dragStart, m_dragEnd);
       m_dragging = false;

       if (m_dragStart == m_dragEnd)
           return;

       if (!m_currentImage)
           return;

       if (!m_currentImage->activeDevice())
           return;
       
       KisPaintDeviceSP device = m_currentImage->activeDevice ();;
       KisPainter painter (device);
       if (m_currentImage->undo()) painter.beginTransaction (i18n("Star"));

       painter.setPaintColor(m_subject->fgColor());
       painter.setBackgroundColor(m_subject->bgColor());
       painter.setFillStyle(fillStyle());
       painter.setBrush(m_subject->currentBrush());
       painter.setPattern(m_subject->currentPattern());
       painter.setOpacity(m_opacity);
       painter.setCompositeOp(m_compositeOp);
       KisPaintOp * op =
           KisPaintOpRegistry::instance()->paintOp(m_subject->currentPaintop(), m_subject->currentPaintopSettings(), &amp;painter);
       painter.setPaintOp(op); // Painter takes ownership

       vKisPoint coord = starCoordinates(m_vertices, m_dragStart.x(), m_dragStart.y(), m_dragEnd.x(), m_dragEnd.y());

       painter.paintPolygon(coord);
       
       device->setDirty( painter.dirtyRect() );
       notifyModified();

       if (m_currentImage->undo()) {
           m_currentImage->undoAdapter()->addCommand(painter.endTransaction());
       }
   }
}
</programlisting>

<para
>Il metodo <methodname
>draw()</methodname
> è un metodo interno di <classname
>KisToolStar</classname
> e disegna il profilo di una stella. Lo chiamiamo dal metodo <methodname
>move()</methodname
> per dare all'utente un'idea delle dimensioni e forma della stella. Nota che usiamo l'operazione raster <varname
>Qt::NotROP</varname
>, che vuol dire che se chiamiamo una seconda volta <methodname
>draw()</methodname
> con gli stessi punti iniziale e finale, la stella precedente sarà eliminata. </para>

<programlisting
>void KisToolStar::draw(const KisPoint&amp; start, const KisPoint&amp; end )
{
   if (!m_subject || !m_currentImage)
       return;

   KisCanvasController *controller = m_subject->canvasController();
   KisCanvas *canvas = controller->kiscanvas();
   KisCanvasPainter p (canvas);
   QPen pen(Qt::SolidLine);

   KisPoint startPos;
   KisPoint endPos;
   startPos = controller->windowToView(start);
   endPos = controller->windowToView(end);

   p.setRasterOp(Qt::NotROP);

   vKisPoint points = starCoordinates(m_vertices, startPos.x(), startPos.y(), endPos.x(), endPos.y());

   for (uint i = 0; i &lt; points.count() - 1; i++) {
       p.drawLine(points[i].floorQPoint(), points[i + 1].floorQPoint());
   }
   p.drawLine(points[points.count() - 1].floorQPoint(), points[0].floorQPoint());

   p.end ();
}
</programlisting>

<para
>Il metodo <methodname
>setup()</methodname
> è essenziale: qui noi creiamo l'azione che sarà immessa nella raccolta degli strumenti in modo che gli utenti possano selezionare lo strumento. Assegniamo anche una chiave per la scorciatoia. Nota che abbiamo usato dei trucchi: ricorda che abbiamo creato un'istanza dello strumento per ogni dispositivo di input. Ciò vuol anche dire che chiamiamo <methodname
>setup()</methodname
> per ogni dispositivo di input e che un'azione con lo stesso nome viene aggiunta diverse volte alla raccolta di azioni. Però tutto sembra funzionare, e allora perché preoccuparsi? </para>

<programlisting
>void KisToolStar::setup(TDEActionCollection *collection)
{
   m_action = static_cast&lt;TDERadioAction *&gt;(collection->action(name()));

   if (m_action == 0) {
       TDEShortcut shortcut(Qt::Key_Plus);
       shortcut.append(TDEShortcut(Qt::Key_F9));
       m_action = new TDERadioAction(i18n("&amp;Star"),
                                   "tool_star",
                                   shortcut,
                                   this,
                                   SLOT(activate()),
                                   collection,
                                   name());
       Q_CHECK_PTR(m_action);

       m_action->setToolTip(i18n("Draw a star"));
       m_action->setExclusiveGroup("tools");
       m_ownAction = true;
   }
}
</programlisting>

<para
>Il metodo <methodname
>starCoordinates()</methodname
> contiene un po' di matematica strana, ma non è molto interessante per il discorso di come creare plugin strumenti. </para>

<programlisting
>KisPoint KisToolStar::starCoordinates(int N, double mx, double my, double x, double y)
{
   double R=0, r=0;
   Q_INT32 n=0;
   double angle;

   vKisPoint starCoordinatesArray(2*N);

   // the radius of the outer edges
   R=sqrt((x-mx)*(x-mx)+(y-my)*(y-my));

   // the radius of the inner edges
   r=R*m_innerOuterRatio/100.0;

   // the angle
   angle=-atan2((x-mx),(y-my));

   //set outer edges
   for(n=0;n&lt;N;n++){
       starCoordinatesArray[2*n] = KisPoint(mx+R*cos(n * 2.0 * M_PI / N + angle),my+R*sin(n *2.0 * M_PI / N+angle));
   }

   //set inner edges
   for(n=0;n&lt;N;n++){
       starCoordinatesArray[2*n+1] = KisPoint(mx+r*cos((n + 0.5) * 2.0 * M_PI / N + angle),my+r*sin((n +0.5) * 2.0 * M_PI / N + angle));
   }

   return starCoordinatesArray;
}
</programlisting>

<para
>Il metodo <methodname
>createOptionWidget()</methodname
> viene chiamato per creare il widget di opzioni che &chalk; mostrerà nella scheda. Siccome c'è uno strumento per dispositivo di input per vista, lo stato di uno strumento può essere mantenuto nello strumento stesso. Questo metodo viene chiamato una sola volta: il widget di opzioni viene memorizzato e recuperato la prossima volta che lo strumento viene attivato. </para>

<programlisting
>QWidget* KisToolStar::createOptionWidget(QWidget* parent)
{
   QWidget *widget = KisToolShape::createOptionWidget(parent);

   m_optWidget = new WdgToolStar(widget);
   Q_CHECK_PTR(m_optWidget);

   m_optWidget->ratioSpinBox->setValue(m_innerOuterRatio);

   QGridLayout *optionLayout = new QGridLayout(widget, 1, 1);
   super::addOptionWidgetLayout(optionLayout);

   optionLayout->addWidget(m_optWidget, 0, 0);

   return widget;
}
</programlisting>

<sect3 id="developers-plugins-tools-conclusions">
<title
>Conclusioni sugli strumenti</title>

<para
>Gli strumenti sono plugin relativamente facili da creare. Devi combinare le interfacce <classname
>KisTool</classname
> e <classname
>KisCanvasObserver</classname
> per creare uno strumento. </para>

</sect3>

</sect2>

<sect2 id="developers-plugins-paintoperations">
<title
>Operazioni di disegno</title>

<para
>Le operazioni di disegno sono uno dei tipi più innovativi di plugin di &chalk; (oltre agli spazi di colori). Un'operazione di disegno definisce come gli strumenti cambiano i pixel che toccano. L'aerografo, la matita e il pennello sono tutte operazioni. Però potresti (con molta fatica) creare un'operazione che legga le definizioni XML dei pennelli di Corel Painter e usi quelle per decidere come disegnare. </para
><para
>Le operazioni di disegno sono avviate quando uno strumento di disegno riceve un evento <literal
>mouseDown</literal
> e sono eliminate quando viene ricevuto un evento <literal
>mouseUp</literal
>. Nel frattempo, l'operazione può tenere a mente le posizioni precedenti e altri dati, come i livelli di pressione se l'utente usa una tavoletta. </para
><para
>Lo scopo fondamentale di un'operazione di disegno è cambiare i pixel alla posizione del cursore di uno strumento di disegno. Questo si può fare in una sola volta, oppure l'operazione può richiedere di essere eseguita a intervalli regolari, usando un timer. La prima possibilità sarebbe utile per un'operazione simile a una matita, la seconda per un aerografo. </para
><para
>Le operazioni di disegno possono avere un piccolo widget di configurazione che viene messo in una barra degli strumenti. Perciò i widget di configurazione delle operazioni devono avere una disposizione orizzontale di oggetti non più alti di un pulsante della barra. Altrimenti, l'aspetto di &chalk; non sarà granché. </para
><para
>Diamo un'occhiata a un semplice plugin per un'operazione di disegno, uno che dia qualche segno di intelligenza programmatrice. Innanzi tutto, nel file di intestazione, è definita una fabbrica. Questa fabbrica crea un'operazione quando lo strumento attivo ne ha bisogno: </para>

<programlisting
>public:
   KisSmearyOpFactory() {}
   virtual ~KisSmearyOpFactory() {}

   virtual KisPaintOp * createOp(const KisPaintOpSettings *settings, KisPainter * painter);
   virtual KisID id() { return KisID("paintSmeary", i18n("Smeary Brush")); }
   virtual bool userVisible(KisColorSpace * ) { return false; }
   virtual QString pixmap() { return ""; }

};
</programlisting>

<para
>La fabbrica contiene anche l'identificativo <classname
>KisID</classname
> con i nomi pubblico e privato dell'operazione (assicurati che il nome privato dell'operazione non collida con un'altra) e potrebbe a scelta restituire un oggetto pixmap. &chalk; potrà in questo caso mostrare il pixmap insieme al nome per l'identificazione visiva della tua operazione. Per esempio, un'operazione per il coltello da pittore avrebbe l'immagine di questo oggetto. </para
><para
>L'implementazione di un'operazione di disegno è molto semplice: </para>

<programlisting
>KisSmearyOp::KisSmearyOp(KisPainter * painter)
   : KisPaintOp(painter)
{
}

KisSmearyOp::~KisSmearyOp()
{
}
void KisSmearyOp::paintAt(const KisPoint &amp;pos, const KisPaintInformation&amp; info)
{
</programlisting>

<para
>Il metodo <methodname
>paintAt()</methodname
> è la cosa più importante per le operazioni. Questo metodo riceve due parametri: la posizione attuale (in numeri a virgola mobile, non pixel interi) e un oggetto <classname
>KisPaintInformation</classname
> che contiene la pressione, l'inclinazione X e Y, il vettore di movimento e che in futuro potrebbe venire esteso con altre informazioni. </para>

<programlisting
>if (!m_painter->device()) return;

   KisBrush *brush = m_painter->brush();
</programlisting>

<para
>Un <classname
>KisBrush</classname
> è la rappresentazione di un file di pennello di Gimp: cioè una maschera, sia una sola o una serie di maschere. In realtà noi non useremo il pennello qui, se non per determinare il <quote
>punto calto</quote
> sotto il cursore. </para>

<programlisting
>Q_ASSERT(brush);

   if (!brush) return;

   if (! brush->canPaintFor(info) )
       return;

   KisPaintDeviceSP device = m_painter->device();
   KisColorSpace * colorSpace = device->colorSpace();
   KisColor kc = m_painter->paintColor();
   kc.convertTo(colorSpace);

   KisPoint hotSpot = brush->hotSpot(info);
   KisPoint pt = pos - hotSpot;

   // Split the coordinates into integer plus fractional parts. The integer
   // is where the dab will be positioned and the fractional part determines
   // the sub-pixel positioning.
   Q_INT32 x, y;
   double xFraction, yFraction;

   splitCoordinate(pt.x(), &amp;x, &amp;xFraction);
   splitCoordinate(pt.y(), &amp;y, &amp;yFraction);

   KisPaintDeviceSP dab = new KisPaintDevice(colorSpace, "smeary dab");
   Q_CHECK_PTR(dab);
</programlisting>

<para
>Non cambiamo direttamente i pixel di un dispositivo di disegno: invece, creiamo un piccolo dispositivo di disegno, una copia, e ricomporla sul dispositivo di disegno attuale. </para>

<programlisting
>m_painter->setPressure(info.pressure);
</programlisting>

<para
>Come dai commenti, la prossima sezione di codice fa del lavoro che serve a creare la copia. In questo caso, disegnamo un certo numero di linee. Quando questa operazione sarà finita, la lunghezza, posizione e spessore delle linee dipenderanno dalla pressione e dal carico di disegno, e avremo creato un pennello oleoso e pesante. Purtroppo non c'è ancora stato tempo per completarla. </para>

<programlisting
>// Compute the position of the tufts. The tufts are arranged in a line
   // perpendicular to the motion of the brush, i.e, the straight line between
   // the current position and the previous position.
   // The tufts are spread out through the pressure

   KisPoint previousPoint = info.movement.toKisPoint();
   KisVector2D brushVector(-previousPoint.y(), previousPoint.x());
   KisVector2D currentPointVector = KisVector2D(pos);
   brushVector.normalize();

   KisVector2D vl, vr;

   for (int i = 0; i &lt; (NUMBER_OF_TUFTS / 2); ++i) {
       // Compute the positions on the new vector.
       vl = currentPointVector + i * brushVector;
       KisPoint pl = vl.toKisPoint();
       dab->setPixel(pl.roundX(), pl.roundY(), kc);

       vr = currentPointVector - i * brushVector;
       KisPoint pr = vr.toKisPoint();
       dab->setPixel(pr.roundX(), pr.roundY(), kc);
   }

   vr = vr - vl;
   vr.normalize();
</programlisting>

<para
>Infine eseguiamo blt sulla copia per metterla sul dispositivo di disegno originale e dire al disegnatore che abbiamo sporcato un rettangolino del dispositivo. </para>

<programlisting
>if (m_source->hasSelection()) {
       m_painter->bltSelection(x - 32, y - 32, m_painter->compositeOp(), dab.data(),
                               m_source->selection(), m_painter->opacity(), x - 32, y -32, 64, 64);
   }
   else {
       m_painter->bitBlt(x - 32, y - 32, m_painter->compositeOp(), dab.data(), m_painter->opacity(), x - 32, y -32, 64, 64);
   }

   m_painter->addDirtyRect(QRect(x -32, y -32, 64, 64));
}


KisPaintOp * KisSmearyOpFactory::createOp(const KisPaintOpSettings */*settings*/, KisPainter * painter)
{
   KisPaintOp * op = new KisSmearyOp(painter);
   Q_CHECK_PTR(op);
   return op;
}
</programlisting>

<para
>Tutto qui: le operazioni di disegno sono facili! </para>

</sect2>

<sect2 id="developers-plugins-viewplugins">
<title
>Plugin di vista</title>

<para
>I plugin di vista sono i più strani del gruppo: un plugin di vista è un normale componente KPart che può fornice un po' di interfaccia utente e qualche funzionalità. Per esempio, la scheda degli istogrammi è un plugin di vista, come la finestra di rotazione. </para>

</sect2>

<sect2 id="developers-plugins-importexport">
<title
>Filtri di importazione ed esportazione</title>

<para
>&chalk; funziona con l'architettura standard di filtraggio dei file di &koffice;. C'è un'esercitazione, un po' vecchia ma ancora utile, a <ulink url="http://koffice.org/developer/filters/oldfaq.php"
>questo indirizzo</ulink
>. Probabilmente è meglio lavorare con la squadra di &chalk; se sviluppi filtri per file e fare lo sviluppo nell'albero dei filtri di &koffice;. Nota che puoi provare i tuoi filtri senza avviare &chalk; usando il programma <command
>koconverter</command
>. </para
><para
>I filtri hanno due lati: importazione ed esportazione. Questi sono normalmente due plugin diversi che potrebbero condividere del codice. </para
><para
>Le voci importanti del file <filename
>Makefile.am</filename
> sono: </para>

<programlisting
>service_DATA = chalk_XXX_import.desktop chalk_XXX_export.desktop
servicedir = $(kde_servicesdir)
kdelnk_DATA = chalk_XXX.desktop
kdelnkdir = $(kde_appsdir)/Office
libchalkXXXimport_la_SOURCES = XXXimport.cpp
libchalkXXXexport_la_SOURCES = XXXexport.cpp
METASOURCES = AUTO
</programlisting>

<para
>Non importa se stai costruendo un filtro di importazione o di esportazione, il lavoro si riduce sempre a implementare questa funzione: </para>

<programlisting
>virtual KoFilter::ConversionStatus convert(const QCString&amp; from, const QCString&amp; to);
</programlisting>

<para
>Sono le impostazioni nei file <literal role="extension"
>.desktop</literal
> che determinano in che modo un filtro converte: </para
><para
>Importazione: </para>

<programlisting
>X-KDE-Export=application/x-chalk
X-KDE-Import=image/x-xcf-gimp
X-KDE-Weight=1
X-KDE-Library=libchalkXXXimport
ServiceTypes=KOfficeFilter
</programlisting>

<para
>Esportazione: </para>

<programlisting
>X-KDE-Export=image/x-xcf-gimp
X-KDE-Import=application/x-chalk
ServiceTypes=KOfficeFilter
Type=Service
X-KDE-Weight=1
X-KDE-Library=libchalkXXXexport
</programlisting>

<para
>Sì, il tipo MIME scelto per l'esempio è un suggerimento. Qualcuno potrebbe per cortesia implementare un filtro per XCF? </para>

<sect3 id="plugins-developers-importexport-import">
<title
>Importazione</title>

<para
>Il problema principale con i filtri di importazione è ovviamente far leggere al tuo codice i dati del disco. Il codice riutilizzabile per chiamarlo è abbastanza semplice: </para>

<note
><para
>Nota: dovremmo davvero trovare un modo di permettere a &chalk; di mantenere aperto un file e leggere i dati solo quando servono, invece che copiare tutti i contenuti nella rappresentazione grafica interna. Però questo vorrebbe dire avere delle interfacce di gestione dei dati che comprendono i file TIFF e tutto il resto, e questo al momento non è implementato. L'ideale sarebbe se alcuni filtri potessero implementare una classe temporaneamente battezzata <classname
>KisFileDataManager</classname
>, creare un oggetto di quell'istanza con il file attuale e passare a <classname
>KisDoc</classname
>. Però &chalk; gestisce la memorizzazione in base ai livelli, non ai documenti, quindi sarebbe difficile da riorganizzare.</para
></note>

<programlisting
>KoFilter::ConversionStatus XXXImport::convert(const QCString&amp;, const QCString&amp; to)
{
   if (to != "application/x-chalk") <co id="import1" />
       return KoFilter::BadMimeType;

   KisDoc * doc = dynamic_cast&lt;KisDoc*&gt;(m_chain -> outputDocument()); <co id="import2" />
   KisView * view = static_cast&lt;KisView*&gt;(doc -> views().getFirst()); <co id="import3" />
   
   QString filename = m_chain -> inputFile(); <co id="import4" />
   
   if (!doc)
       return KoFilter::CreationError;

   doc -> prepareForImport(); <co id="import5" />

   if (!filename.isEmpty()) {
   
       KURL url(filename);

       if (url.isEmpty())
           return KoFilter::FileNotFound;
           
       KisImageXXXConverter ib(doc, doc -> undoAdapter()); <co id="import6" />

       if (view != 0)
           view -> canvasSubject() ->  progressDisplay() -> setSubject(&amp;ib, false, true);

       switch (ib.buildImage(url)) <co id="import7" /> {
           case KisImageBuilder_RESULT_UNSUPPORTED:
               return KoFilter::NotImplemented;
               break;
           case KisImageBuilder_RESULT_INVALID_ARG:
               return KoFilter::BadMimeType;
               break;
           case KisImageBuilder_RESULT_NO_URI:
           case KisImageBuilder_RESULT_NOT_LOCAL:
               return KoFilter::FileNotFound;
               break;
           case KisImageBuilder_RESULT_BAD_FETCH:
           case KisImageBuilder_RESULT_EMPTY:
               return KoFilter::ParsingError;                
               break;
           case KisImageBuilder_RESULT_FAILURE:
               return KoFilter::InternalError;
               break;
           case KisImageBuilder_RESULT_OK:
               doc -> setCurrentImage( ib.image()); <co id="import8" />
               return KoFilter::OK;
           default:
               break;
       }

   }
   return KoFilter::StorageCreationError;
}
</programlisting>

<calloutlist>
<callout arearefs="import1"
><para
>Questo dovrebbe essere un filtro di importazione, perciò se non viene chiamato per convertire in un'immagine di &chalk;, c'è qualcosa che non va.</para
></callout>
<callout arearefs="import2"
><para
>La catena dei filtri ha già creato un documento di output. Dobbiamo passarlo a <classname
>KisDocM</classname
>, perché i documenti di &chalk; hanno bisogno di un trattamento speciale. In realtà non sarebbe una cattiva idea controllare che il risultato della chiamata non sia zero, perché in tal caso l'importazione non riuscirà.</para
></callout>
<callout arearefs="import3"
><para
>Se chiamiamo questo filtro dall'interfaccia, proviamo a ottenere la vista. Se la vista c'è, il codice di conversione può provare ad aggiornare la barra di avanzamento.</para
></callout>
<callout arearefs="import4"
><para
>Il filtro ha il nome del nostro file di input.</para
></callout>
<callout arearefs="import5"
><para
><classname
>KisDoc</classname
> deve essere preparato per un'importazione. Certe impostazioni sono inizializzate e l'annullamento delle azioni viene disattivato, altrimenti potresti annullare l'aggiunta di livelli effettuata dal filtro di importazione, e quello sarebbe un comportamento indesiderato.</para
></callout>
<callout arearefs="import6"
><para
>Si è scelto di implementare il codice di importazione in una classe a parte che viene istanziata qui. Puoi anche mettere tutto il codice nel metodo, ma sarebbe un po' disordinato.</para
></callout>
<callout arearefs="import7"
><para
>L'importatore restituisce un codice di stato che posso usare per impostare lo stato del filtro di importazione. &koffice; pensa a mostrare i messaggi di errore.</para
></callout>
<callout arearefs="import8"
><para
>Se la creazione di <classname
>KisImage</classname
> è riuscita, impostiamo l'immagine attuale del documento alla nostra immagine appena creata. A questo punto abbiamo finito: <literal
>return KoFilter::OK;</literal
>.</para
></callout>
</calloutlist>

</sect3>

</sect2>

</sect1>