Subversion Repositories Scribus

Rev

Rev 14485 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
12918 cbradney 1
<?xml version="1.0" encoding="utf-8"?>
14474 cbradney 2
<!DOCTYPE TS>
3
<TS version="2.0">
12918 cbradney 4
<context>
5
    <name></name>
6
    <message>
14474 cbradney 7
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="17"/>
12918 cbradney 8
        <source>getColorNames() -&gt; list
9
 
10
Returns a list containing the names of all defined colors in the document.
11
If no document is open, returns a list of the default document colors.
12
</source>
13
        <translation type="unfinished">getColorNames() -&gt; list
14
 
15
Returns a list containing the names of all defined colors in the document.
16
If no document is open, returns a list of the default document colors.</translation>
17
    </message>
18
    <message>
14474 cbradney 19
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="27"/>
12918 cbradney 20
        <source>getColor(&quot;name&quot;) -&gt; tuple
21
 
22
Returns a tuple (C, M, Y, K) containing the four color components of the
23
color &quot;name&quot; from the current document. If no document is open, returns
24
the value of the named color from the default document colors.
25
 
26
May raise NotFoundError if the named color wasn&apos;t found.
27
May raise ValueError if an invalid color name is specified.
28
</source>
29
        <translation type="unfinished">getColor(&quot;name&quot;) -&gt; tuple
30
 
31
Palauttaa tuplen (C, M, Y, K) värille &quot;name&quot; nykyisestä asiakirjasta. Jos asiakirjaa
32
ei ole avoinna, palauttaa värin oletusväreistä.
33
 
34
Saattaa nostaa NotFoundError:n, jos väriä ei löydy.
35
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
36
    </message>
37
    <message>
14474 cbradney 38
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="41"/>
12918 cbradney 39
        <source>getColorAsRGB(&quot;name&quot;) -&gt; tuple
40
 
41
Returns a tuple (R,G,B) containing the three color components of the
42
color &quot;name&quot; from the current document, converted to the RGB color
43
space. If no document is open, returns the value of the named color
44
from the default document colors.
45
 
46
May raise NotFoundError if the named color wasn&apos;t found.
47
May raise ValueError if an invalid color name is specified.
48
</source>
49
        <translation type="unfinished">getColorAsRGB(&quot;name&quot;) -&gt; tuple
50
 
51
Returns a tuple (R,G,B) containing the three color components of the
52
color &quot;name&quot; from the current document, converted to the RGB color
53
space. If no document is open, returns the value of the named color
54
from the default document colors.
55
 
56
May raise NotFoundError if the named color wasn&apos;t found.
57
May raise ValueError if an invalid color name is specified.
58
</translation>
59
    </message>
60
    <message>
14474 cbradney 61
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="56"/>
12918 cbradney 62
        <source>changeColor(&quot;name&quot;, c, m, y, k)
63
 
64
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
65
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
66
Color components should be in the range from 0 to 255.
67
 
68
May raise NotFoundError if the named color wasn&apos;t found.
69
May raise ValueError if an invalid color name is specified.
70
</source>
71
        <translation type="unfinished">changeColor(&quot;name&quot;, c, m, y, k)
72
 
73
Vaihtaa värin &quot;name&quot; vastaamaan väriä c, m, y, k (kaikki määritelty välillä 0, 255).</translation>
74
    </message>
75
    <message>
14474 cbradney 76
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="70"/>
12918 cbradney 77
        <source>defineColor(&quot;name&quot;, c, m, y, k)
78
 
79
Defines a new color &quot;name&quot;. The color Value is defined via four components:
80
c = Cyan, m = Magenta, y = Yellow and k = Black. Color components should be in
81
the range from 0 to 255.
82
 
83
May raise ValueError if an invalid color name is specified.
84
</source>
85
        <translation type="unfinished"></translation>
86
    </message>
87
    <message>
14474 cbradney 88
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="83"/>
12918 cbradney 89
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
90
 
91
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
92
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
93
&quot;None&quot; - transparent.
94
 
95
deleteColor works on the default document colors if there is no document open.
96
In that case, &quot;replace&quot;, if specified, has no effect.
97
 
98
May raise NotFoundError if a named color wasn&apos;t found.
99
May raise ValueError if an invalid color name is specified.
100
</source>
101
        <translation type="unfinished">deleteColor(&quot;name&quot;, &quot;replace&quot;)
102
 
103
Poistaa värin &quot;nimi&quot;, joka korvataan värillä &quot;replace&quot;. Oletuksena &quot;replace&quot; on None (läpinäkyvä).
104
 
105
deleteColors toimii asiakirjassa määritellyillä väreillä, asiakirja on avoinna.
106
 
107
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
108
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
109
    </message>
110
    <message>
14474 cbradney 111
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="100"/>
12918 cbradney 112
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
113
 
114
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
115
 
116
May raise NotFoundError if a named color wasn&apos;t found.
117
May raise ValueError if an invalid color name is specified.
118
</source>
119
        <translation type="unfinished">replaceColor(&quot;name&quot;, &quot;replace&quot;)
120
 
121
Jokainen ilmentymä väristä &quot;name&quot; korvataan värillä &quot;replace&quot;.
122
 
123
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
124
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
125
    </message>
126
    <message>
14474 cbradney 127
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="113"/>
128
        <source>isSpotColor(&quot;name&quot;) -&gt; bool
129
 
130
Returns True if the color &quot;name&quot; is a spot color.
131
See also setSpotColor()
132
 
133
May raise NotFoundError if a named color wasn&apos;t found.
134
May raise ValueError if an invalid color name is specified.
135
</source>
136
        <translation type="unfinished"></translation>
137
    </message>
138
    <message>
139
        <location filename="../../../scribus/plugins/scriptplugin/cmdcolor.h" line="128"/>
140
        <source>setSpotColor(&quot;name&quot;, spot)
141
 
142
Set the color &quot;name&quot; as a spot color if spot parameter is True.
143
See also isSpotColor()
144
 
145
May raise NotFoundError if a named color wasn&apos;t found.
146
May raise ValueError if an invalid color name is specified.
147
</source>
148
        <translation type="unfinished"></translation>
149
    </message>
150
    <message>
151
        <location filename="../../../scribus/plugins/scriptplugin/cmddialog.h" line="17"/>
12918 cbradney 152
        <source>newDocDialog() -&gt; bool
153
 
154
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
155
accepts the settings. Does not create a document if the user presses cancel.
156
Returns true if a new document was created.
157
</source>
158
        <translation type="unfinished">getColorNames() -&gt; list
159
 
160
Näyttää dialogin &quot;Uusi asiakirja&quot;. Luo uuden asiakirjan, jos käyttäjä hyväksyy
161
asetukset. Asiakirjaa ei luoda, jos käyttäjä painaa Peruuta-painiketta.
162
Palauttaa true, jos uusi asiakirja luotiin.</translation>
163
    </message>
164
    <message>
14474 cbradney 165
        <location filename="../../../scribus/plugins/scriptplugin/cmddialog.h" line="28"/>
12918 cbradney 166
        <source>fileDialog(&quot;caption&quot;, [&quot;filter&quot;, &quot;defaultname&quot;, haspreview, issave, isdir]) -&gt; string with filename
167
 
168
Shows a File Open dialog box with the caption &quot;caption&quot;. Files are filtered
169
with the filter string &quot;filter&quot;. A default filename or file path can also
170
supplied, leave this string empty when you don&apos;t want to use it.  A value of
171
True for haspreview enables a small preview widget in the FileSelect box.  When
172
the issave parameter is set to True the dialog acts like a &quot;Save As&quot; dialog
173
otherwise it acts like a &quot;File Open Dialog&quot;. When the isdir parameter is True
174
the dialog shows and returns only directories. The default for all of the
175
optional parameters is False.
176
 
177
The filter, if specified, takes the form &apos;comment (*.type *.type2 ...)&apos;.
178
For example &apos;Images (*.png *.xpm *.jpg)&apos;.
179
 
180
Refer to the Qt-Documentation for QFileDialog for details on filters.
181
 
182
Example: fileDialog(&apos;Open input&apos;, &apos;CSV files (*.csv)&apos;)
183
Example: fileDialog(&apos;Save report&apos;, defaultname=&apos;report.txt&apos;, issave=True)
184
</source>
185
        <translation type="unfinished"></translation>
186
    </message>
187
    <message>
14474 cbradney 188
        <location filename="../../../scribus/plugins/scriptplugin/cmddialog.h" line="56"/>
12918 cbradney 189
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
190
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
191
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
192
 
193
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
194
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
195
button, OK, is displayed. Only the caption and message arguments are required,
196
though setting an icon and appropriate button(s) is strongly
197
recommended. The message text may contain simple HTML-like markup.
198
 
199
Returns the number of the button the user pressed. Button numbers start
200
at 1.
201
 
202
For the icon and the button parameters there are predefined constants available
203
with the same names as in the Qt Documentation. These are the BUTTON_* and
204
ICON_* constants defined in the module. There are also two extra constants that
205
can be binary-ORed with button constants:
206
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
207
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
208
 
209
Usage examples:
210
result = messageBox(&apos;Script failed&apos;,
211
                    &apos;This script only works when you have a text frame selected.&apos;,
212
                    ICON_ERROR)
213
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
214
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
215
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
216
 
217
Defined button and icon constants:
218
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
219
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
220
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
221
</source>
222
        <translation type="unfinished">messageBox(&quot;caption&quot;, &quot;message&quot;,
223
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
224
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
225
 
226
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
227
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
228
button, OK, is displayed. Only the caption and message arguments are required,
229
though setting an icon and appropriate button(s) is strongly
230
recommended. The message text may contain simple HTML-like markup.
231
 
232
Returns the number of the button the user pressed. Button numbers start
233
at 1.
234
 
235
For the icon and the button parameters there are predefined constants available
236
with the same names as in the Qt Documentation. These are the BUTTON_* and
237
ICON_* constants defined in the module. There are also two extra constants that
238
can be binary-ORed with button constants:
239
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
240
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
241
 
242
Usage examples:
243
result = messageBox(&apos;Script failed&apos;,
244
                    &apos;This script only works when you have a text frame selected.&apos;,
245
                    ICON_ERROR)
246
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
247
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
248
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
249
 
250
Defined button and icon constants:
251
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
252
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
253
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.</translation>
254
    </message>
255
    <message>
14474 cbradney 256
        <location filename="../../../scribus/plugins/scriptplugin/cmddialog.h" line="95"/>
12918 cbradney 257
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
258
 
259
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
260
Parameters: window title, text in the window and optional &apos;default&apos; value.
261
 
262
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
263
</source>
264
        <translation type="unfinished">valueDialog(caption, message [,defaultvalue]) -&gt; string
265
 
266
Näyttää yleisen &quot;Kysy string&quot;-dialogin ja palauttaa sen arvon. Parametrit: ikkunan
267
otsikko, ikkunan teksti ja oletusarvo</translation>
268
    </message>
269
    <message>
14474 cbradney 270
        <location filename="../../../scribus/plugins/scriptplugin/cmddialog.h" line="107"/>
12918 cbradney 271
        <source>newStyleDialog() -&gt; string
272
 
273
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
274
style name or None when user cancels the dialog.
275
</source>
276
        <translation type="unfinished">newStyleDialog() -&gt; string
277
 
278
Shows &apos;Create new paragraph style&apos; dialog. Function returns real
279
style name or None when user cancels the dialog.
280
</translation>
281
    </message>
282
    <message>
14474 cbradney 283
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="16"/>
12918 cbradney 284
        <source>newDocument(size, margins, orientation, firstPageNumber,
285
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
286
 
287
Creates a new document and returns true if successful. The parameters have the
288
following meaning:
289
 
290
size = A tuple (width, height) describing the size of the document. You can
291
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
292
 
293
margins = A tuple (left, right, top, bottom) describing the document
294
margins
295
 
296
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
297
 
298
firstPageNumer = is the number of the first page in the document used for
299
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
300
numbers if you&apos;re creating a document in several parts.
301
 
302
unit: this value sets the measurement units used by the document. Use a
303
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
304
UNIT_PICAS, UNIT_POINTS.
305
 
306
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
307
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
308
PAGE_4 is 4-fold.
309
 
310
firstPageOrder = What is position of first page in the document.
311
Indexed from 0 (0 = first).
312
 
313
numPage = Number of pages to be created.
314
 
315
The values for width, height and the margins are expressed in the given unit
316
for the document. PAPER_* constants are expressed in points. If your document
317
is not in points, make sure to account for this.
318
 
319
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
320
PAGE_4, 3, 1)
321
 
322
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
323
</source>
324
        <translation type="unfinished">newDocument(size, margins, orientation, firstPageNumber,
325
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
326
 
327
Creates a new document and returns true if successful. The parameters have the
328
following meaning:
329
 
330
size = A tuple (width, height) describing the size of the document. You can
331
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
332
 
333
margins = A tuple (left, right, top, bottom) describing the document
334
margins
335
 
336
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
337
 
338
firstPageNumer = is the number of the first page in the document used for
339
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
340
numbers if you&apos;re creating a document in several parts.
341
 
342
unit: this value sets the measurement units used by the document. Use a
343
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
344
UNIT_PICAS, UNIT_POINTS.
345
 
346
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
347
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
348
PAGE_4 is 4-fold.
349
 
350
firstPageOrder = What is position of first page in the document.
351
Indexed from 0 (0 = first).
352
 
353
numPage = Number of pages to be created.
354
 
355
The values for width, height and the margins are expressed in the given unit
356
for the document. PAPER_* constants are expressed in points. If your document
357
is not in points, make sure to account for this.
358
 
359
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
360
PAGE_4, 3, 1)
361
 
362
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
363
</translation>
364
    </message>
365
    <message>
14474 cbradney 366
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="62"/>
12918 cbradney 367
        <source>newDoc(size, margins, orientation, firstPageNumber,
368
                   unit, facingPages, firstSideLeft) -&gt; bool
369
 
370
WARNING: Obsolete procedure! Use newDocument instead.
371
 
372
Creates a new document and returns true if successful. The parameters have the
373
following meaning:
374
 
375
    size = A tuple (width, height) describing the size of the document. You can
376
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
377
 
378
    margins = A tuple (left, right, top, bottom) describing the document
379
    margins
380
 
381
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
382
 
383
    firstPageNumer = is the number of the first page in the document used for
384
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
385
    numbers if you&apos;re creating a document in several parts.
386
 
387
    unit: this value sets the measurement units used by the document. Use a
388
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
389
    UNIT_PICAS, UNIT_POINTS.
390
 
391
    facingPages = FACINGPAGES, NOFACINGPAGES
392
 
393
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
394
 
395
The values for width, height and the margins are expressed in the given unit
396
for the document. PAPER_* constants are expressed in points. If your document
397
is not in points, make sure to account for this.
398
 
399
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
400
                FACINGPAGES, FIRSTPAGERIGHT)
401
</source>
402
        <translation type="unfinished">newDoc(size, margins, orientation, firstPageNumber,
403
                   unit, facingPages, firstSideLeft) -&gt; bool
404
 
405
WARNING: Obsolete procedure! Use newDocument instead.
406
 
407
Creates a new document and returns true if successful. The parameters have the
408
following meaning:
409
 
410
    size = A tuple (width, height) describing the size of the document. You can
411
    use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
412
 
413
    margins = A tuple (left, right, top, bottom) describing the document
414
    margins
415
 
416
    orientation = the page orientation - constants PORTRAIT, LANDSCAPE
417
 
418
    firstPageNumer = is the number of the first page in the document used for
419
    pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
420
    numbers if you&apos;re creating a document in several parts.
421
 
422
    unit: this value sets the measurement units used by the document. Use a
423
    predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
424
    UNIT_PICAS, UNIT_POINTS.
425
 
426
    facingPages = FACINGPAGES, NOFACINGPAGES
427
 
428
    firstSideLeft = FIRSTPAGELEFT, FIRSTPAGERIGHT
429
 
430
The values for width, height and the margins are expressed in the given unit
431
for the document. PAPER_* constants are expressed in points. If your document
432
is not in points, make sure to account for this.
433
 
434
example: newDoc(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 1, UNIT_POINTS,
435
                FACINGPAGES, FIRSTPAGERIGHT)
436
</translation>
437
    </message>
438
    <message>
14474 cbradney 439
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="103"/>
12918 cbradney 440
        <source>closeDoc()
441
 
442
Closes the current document without prompting to save.
443
 
444
May throw NoDocOpenError if there is no document to close
445
</source>
446
        <translation type="unfinished">closeDoc()
447
 
448
Sulkee aktiivisen asiakirjan, ilman tallennusdialogia.
449
 
450
Saattaa heittää NoDocOpenError, jos suljettavia asiakirjoja ei ole</translation>
451
    </message>
452
    <message>
14474 cbradney 453
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="114"/>
12918 cbradney 454
        <source>haveDoc() -&gt; bool
455
 
456
Returns true if there is a document open.
457
</source>
458
        <translation type="unfinished">haveDoc() -&gt; bool
459
 
460
Palauttaa true, jos yksikin asiakirja on avoinna.</translation>
461
    </message>
462
    <message>
14474 cbradney 463
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="123"/>
12918 cbradney 464
        <source>openDoc(&quot;name&quot;)
465
 
466
Opens the document &quot;name&quot;.
467
 
468
May raise ScribusError if the document could not be opened.
469
</source>
470
        <translation type="unfinished">openDoc(&quot;name&quot;)
471
 
472
Avaa asiakirjan &quot;name&quot;.
473
 
474
Saattaa aiheuttaa ScribusErrorin, jos asiakirjaa ei voida avata.</translation>
475
    </message>
476
    <message>
14474 cbradney 477
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="134"/>
12918 cbradney 478
        <source>saveDoc()
479
 
480
Saves the current document with its current name, returns true if successful.
481
If the document has not already been saved, this may bring up an interactive
482
save file dialog.
483
 
484
If the save fails, there is currently no way to tell.
485
</source>
486
        <translation type="unfinished">saveDoc()
487
 
488
Tallennusdialogi. Tallennuksen epäonnistumista ei voi tällä hetkellä päätellä mistään.</translation>
489
    </message>
490
    <message>
14474 cbradney 491
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="146"/>
492
        <source>getDocName() -&gt; string
493
 
494
Returns the name the document was saved under.
495
If the document was not saved before the name is empty.
496
</source>
497
        <translation type="unfinished"></translation>
498
    </message>
499
    <message>
500
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="156"/>
12918 cbradney 501
        <source>saveDocAs(&quot;name&quot;)
502
 
503
Saves the current document under the new name &quot;name&quot; (which may be a full or
504
relative path).
505
 
506
May raise ScribusError if the save fails.
507
</source>
508
        <translation type="unfinished">saveDocAs(&quot;name&quot;)
509
 
510
Tallentaa aktiivisen asiakirjan nimellä &quot;nimi&quot;, joka voi olla täydellinen tai suhteellinen polku.
511
 
512
Saattaa aiheuttaa ScribusError:n, jos tallennus epäonnistuu.</translation>
513
    </message>
514
    <message>
14474 cbradney 515
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="168"/>
12918 cbradney 516
        <source>setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
517
 
518
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
519
strings.
520
</source>
521
        <translation type="unfinished">setInfo(&quot;author&quot;, &quot;info&quot;, &quot;description&quot;) -&gt; bool
522
 
523
Sets the document information. &quot;Author&quot;, &quot;Info&quot;, &quot;Description&quot; are
524
strings.
525
</translation>
526
    </message>
527
    <message>
14474 cbradney 528
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="178"/>
12918 cbradney 529
        <source>setMargins(lr, rr, tr, br)
530
 
14474 cbradney 531
Sets the margins of the document, Left(lr), Right(rr), Top(tr) and Bottom(br)
12918 cbradney 532
margins are given in the measurement units of the document - see UNIT_&lt;type&gt;
533
constants.
534
</source>
535
        <translation type="unfinished"></translation>
536
    </message>
537
    <message>
14474 cbradney 538
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="189"/>
539
        <source>setBaseLine(grid, offset)
540
 
541
Sets the base line settings of the document, grid spacing(grid), grid offset(offset).
542
Values are given in the measurement units of the document - see UNIT_&lt;type&gt;
543
constants.
544
</source>
545
        <translation type="unfinished"></translation>
546
    </message>
547
    <message>
548
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="200"/>
12918 cbradney 549
        <source>setUnit(type)
550
 
551
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
552
defined as constants UNIT_&lt;type&gt;.
553
 
554
May raise ValueError if an invalid unit is passed.
555
</source>
556
        <translation type="unfinished">setUnit(type)
557
 
558
Vaihtaa asiakirjan mittayksikköä. Mahdolliset yksiköt on määritelty vakiona UNIT_&lt;type&gt;.
559
 
560
Saattaa aiheuttaa ValueError:n, jos käytetään virheellistä yksikköä.</translation>
561
    </message>
562
    <message>
14474 cbradney 563
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="212"/>
12918 cbradney 564
        <source>getUnit() -&gt; integer (Scribus unit constant)
565
 
566
Returns the measurement units of the document. The returned value will be one
567
of the UNIT_* constants:
568
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
569
</source>
570
        <translation type="unfinished">getUnit() -&gt; integer (Scribus unit constant)
571
 
572
Palauttaa asiakirjan mittayksikön. Arvo on yksi UNIT_* vakioista.
573
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
574
</translation>
575
    </message>
576
    <message>
14474 cbradney 577
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="223"/>
12918 cbradney 578
        <source>loadStylesFromFile(&quot;filename&quot;)
579
 
580
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
581
current document.
582
</source>
583
        <translation type="unfinished">loadStylesFromFile(&quot;filename&quot;)
584
 
585
Lataa kappaletyylit Scribus-asiakirjasta &quot;filename&quot; aktiiviseen asiakirjaan.</translation>
586
    </message>
587
    <message>
14474 cbradney 588
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="233"/>
12918 cbradney 589
        <source>setDocType(facingPages, firstPageLeft)
590
 
591
Sets the document type. To get facing pages set the first parameter to
592
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
593
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
594
a right page use FIRSTPAGERIGHT.
595
</source>
596
        <translation type="unfinished">setDocType(facingPages, firstPageLeft)
597
 
598
Sets the document type. To get facing pages set the first parameter to
599
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
600
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
601
a right page use FIRSTPAGERIGHT.
602
 
603
</translation>
604
    </message>
605
    <message>
14474 cbradney 606
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="243"/>
12918 cbradney 607
        <source>closeMasterPage()
608
 
609
Closes the currently active master page, if any, and returns editing
610
to normal. Begin editing with editMasterPage().
611
</source>
612
        <translation type="unfinished">closeMasterPage()
613
 
614
Closes the currently active master page, if any, and returns editing
615
to normal. Begin editing with editMasterPage().
616
</translation>
617
    </message>
618
    <message>
14474 cbradney 619
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="251"/>
12918 cbradney 620
        <source>masterPageNames()
621
 
622
Returns a list of the names of all master pages in the document.
623
</source>
624
        <translation type="unfinished">masterPageNames()
625
 
626
Returns a list of the names of all master pages in the document.
627
</translation>
628
    </message>
629
    <message>
14474 cbradney 630
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="258"/>
12918 cbradney 631
        <source>editMasterPage(pageName)
632
 
633
Enables master page editing and opens the named master page
634
for editing. Finish editing with closeMasterPage().
635
</source>
636
        <translation type="unfinished">editMasterPage(pageName)
637
 
638
Enables master page editing and opens the named master page
639
for editing. Finish editing with closeMasterPage().
640
</translation>
641
    </message>
642
    <message>
14474 cbradney 643
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="266"/>
12918 cbradney 644
        <source>createMasterPage(pageName)
645
 
646
Creates a new master page named pageName and opens it for
647
editing.
648
</source>
649
        <translation type="unfinished">createMasterPage(pageName)
650
 
651
Creates a new master page named pageName and opens it for
652
editing.
653
</translation>
654
    </message>
655
    <message>
14474 cbradney 656
        <location filename="../../../scribus/plugins/scriptplugin/cmddoc.h" line="274"/>
12918 cbradney 657
        <source>deleteMasterPage(pageName)
658
 
659
Delete the named master page.
660
</source>
661
        <translation type="unfinished">deleteMasterPage(pageName)
662
 
663
Delete the named master page.
664
</translation>
665
    </message>
666
    <message>
14474 cbradney 667
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="17"/>
12918 cbradney 668
        <source>getFillColor([&quot;name&quot;]) -&gt; string
669
 
670
Returns the name of the fill color of the object &quot;name&quot;.
671
If &quot;name&quot; is not given the currently selected item is used.
672
</source>
673
        <translation type="unfinished">getFillColor([&quot;name&quot;]) -&gt; string
674
 
675
Palauttaa täyttövärin nimen kohteelle &quot;name&quot;.
676
Jos &quot;name&quot; ei ole annettu käytetään valittuna olevaa kohdetta.</translation>
677
    </message>
678
    <message>
14474 cbradney 679
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="27"/>
12918 cbradney 680
        <source>getFillTransparency([&quot;name&quot;]) -&gt; float
681
 
682
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
683
is not given the currently selected Item is used.
684
</source>
685
        <translation type="unfinished">getFillTransparency([&quot;name&quot;]) -&gt; float
686
 
687
Returns the fill transparency of the object &quot;name&quot;. If &quot;name&quot;
688
is not given the currently selected Item is used.
689
</translation>
690
    </message>
691
    <message>
14474 cbradney 692
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="37"/>
12918 cbradney 693
        <source>getFillBlendmode([&quot;name&quot;]) -&gt; integer
694
 
695
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
696
is not given the currently selected Item is used.
697
</source>
698
        <translation type="unfinished">getFillBlendmode([&quot;name&quot;]) -&gt; integer
699
 
700
Returns the fill blendmode of the object &quot;name&quot;. If &quot;name&quot;
701
is not given the currently selected Item is used.
702
</translation>
703
    </message>
704
    <message>
14474 cbradney 705
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="47"/>
12918 cbradney 706
        <source>getLineColor([&quot;name&quot;]) -&gt; string
707
 
708
Returns the name of the line color of the object &quot;name&quot;.
709
If &quot;name&quot; is not given the currently selected item is used.
710
</source>
711
        <translation type="unfinished">getLineColor([&quot;name&quot;]) -&gt; string
712
 
713
Palauttaa kohteen &quot;name&quot; viivan värin. Ilman &quot;name&quot;:a palauttaa
714
valittuna olevan kohteen kehyksen värin.</translation>
715
    </message>
716
    <message>
14474 cbradney 717
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="57"/>
12918 cbradney 718
        <source>getLineTransparency([&quot;name&quot;]) -&gt; float
719
 
720
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
721
is not given the currently selected Item is used.
722
</source>
723
        <translation type="unfinished">getLineTransparency([&quot;name&quot;]) -&gt; float
724
 
725
Returns the line transparency of the object &quot;name&quot;. If &quot;name&quot;
726
is not given the currently selected Item is used.
727
</translation>
728
    </message>
729
    <message>
14474 cbradney 730
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="67"/>
12918 cbradney 731
        <source>getLineBlendmode([&quot;name&quot;]) -&gt; integer
732
 
733
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
734
is not given the currently selected Item is used.
735
</source>
736
        <translation type="unfinished">getLineBlendmode([&quot;name&quot;]) -&gt; integer
737
 
738
Returns the line blendmode of the object &quot;name&quot;. If &quot;name&quot;
739
is not given the currently selected Item is used.
740
</translation>
741
    </message>
742
    <message>
14474 cbradney 743
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="77"/>
12918 cbradney 744
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
745
 
746
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
747
is not given the currently selected Item is used.
748
</source>
749
        <translation type="unfinished">getLineWidth([&quot;name&quot;]) -&gt; integer
750
 
751
Palauttaa kohteen &quot;name&quot; viivan leveyden. Jos &quot;name&quot;:a
752
ei anneta käytetään valittuna olevaa kohdetta.</translation>
753
    </message>
754
    <message>
14474 cbradney 755
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="87"/>
12918 cbradney 756
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
757
 
758
Returns the shading value of the line color of the object &quot;name&quot;.
759
If &quot;name&quot; is not given the currently selected item is used.
760
</source>
761
        <translation type="unfinished">getLineShade([&quot;name&quot;]) -&gt; integer
762
 
763
Palauttaa kohteen &quot;name&quot; viivan värin sävyn. Jos &quot;name&quot;:a ei
764
anneta käytetään valittuna olevaa kohdetta.</translation>
765
    </message>
766
    <message>
14474 cbradney 767
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="97"/>
12918 cbradney 768
        <source>getLineJoin([&quot;name&quot;]) -&gt; integer (see constants)
769
 
770
Returns the line join style of the object &quot;name&quot;. If &quot;name&quot; is not given
771
the currently selected item is used.  The join types are:
772
JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
773
</source>
774
        <translation type="unfinished"></translation>
775
    </message>
776
    <message>
14474 cbradney 777
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="108"/>
12918 cbradney 778
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
779
 
780
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
781
currently selected item is used. The cap types are:
782
CAP_FLAT, CAP_ROUND, CAP_SQUARE
783
</source>
784
        <translation type="unfinished">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
785
 
786
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
787
currently selected item is used. The cap types are:
788
CAP_FLAT, CAP_ROUND, CAP_SQUARE </translation>
789
    </message>
790
    <message>
14474 cbradney 791
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="119"/>
12918 cbradney 792
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
793
 
794
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
795
currently selected item is used. Line style constants are:
796
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
797
</source>
798
        <translation type="unfinished">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
799
 
800
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
801
currently selected item is used. Line style constants are:
802
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
803
</translation>
804
    </message>
805
    <message>
14474 cbradney 806
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="130"/>
12918 cbradney 807
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
808
 
809
Returns the shading value of the fill color of the object &quot;name&quot;.
810
If &quot;name&quot; is not given the currently selected item is used.
811
</source>
812
        <translation type="unfinished">getFillShade([&quot;name&quot;]) -&gt; integer
813
 
814
Returns the shading value of the fill color of the object &quot;name&quot;.
815
If &quot;name&quot; is not given the currently selected item is used.
816
</translation>
817
    </message>
818
    <message>
14474 cbradney 819
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="140"/>
12918 cbradney 820
        <source>getCornerRadius([&quot;name&quot;]) -&gt; integer
821
 
822
Returns the corner radius of the object &quot;name&quot;. The radius is
823
expressed in points. If &quot;name&quot; is not given the currently
824
selected item is used.
825
</source>
826
        <translation type="unfinished"></translation>
827
    </message>
828
    <message>
14474 cbradney 829
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="151"/>
12918 cbradney 830
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
831
 
832
Returns a (x, y) tuple containing the scaling values of the image frame
833
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
834
</source>
835
        <translation type="unfinished">getImageScale([&quot;name&quot;]) -&gt; (x,y)
836
 
837
Returns a (x, y) tuple containing the scaling values of the image frame
838
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
839
</translation>
840
    </message>
841
    <message>
14474 cbradney 842
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="161"/>
12918 cbradney 843
        <source>getImageName([&quot;name&quot;]) -&gt; string
844
 
845
Returns the filename for the image in the image frame. If &quot;name&quot; is not
846
given the currently selected item is used.
847
</source>
848
        <translation type="unfinished">getImageName([&quot;name&quot;]) -&gt; string
849
 
850
Returns the filename for the image in the image frame. If &quot;name&quot; is not
851
given the currently selected item is used.
852
</translation>
853
    </message>
854
    <message>
14474 cbradney 855
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="171"/>
12918 cbradney 856
        <source>getPosition([&quot;name&quot;]) -&gt; (x,y)
857
 
858
Returns a (x, y) tuple with the position of the object &quot;name&quot;.
859
If &quot;name&quot; is not given the currently selected item is used.
860
The position is expressed in the actual measurement unit of the document
861
- see UNIT_&lt;type&gt; for reference.
862
</source>
863
        <translation type="unfinished"></translation>
864
    </message>
865
    <message>
14474 cbradney 866
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="183"/>
12918 cbradney 867
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
868
 
869
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
870
If &quot;name&quot; is not given the currently selected item is used. The size is
871
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
872
for reference.
873
</source>
874
        <translation type="unfinished">getSize([&quot;name&quot;]) -&gt; (width,height)
875
 
876
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
877
If &quot;name&quot; is not given the currently selected item is used. The size is
878
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
879
for reference.
880
</translation>
881
    </message>
882
    <message>
14474 cbradney 883
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="195"/>
12918 cbradney 884
        <source>getRotation([&quot;name&quot;]) -&gt; integer
885
 
886
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
887
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
888
is used.
889
</source>
890
        <translation type="unfinished">getRotation([&quot;name&quot;]) -&gt; integer
891
 
892
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
893
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
894
is used.</translation>
895
    </message>
896
    <message>
14474 cbradney 897
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetprop.h" line="206"/>
12918 cbradney 898
        <source>getAllObjects() -&gt; list
899
 
900
Returns a list containing the names of all objects on the current page.
901
</source>
902
        <translation type="unfinished">getAllObjects() -&gt; list
903
 
904
Returns a list containing the names of all objects on the current page.</translation>
905
    </message>
906
    <message>
14474 cbradney 907
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="77"/>
12918 cbradney 908
        <source>getPropertyCType(object, property, includesuper=True)
909
 
910
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
911
for details of arguments.
912
 
913
If `includesuper&apos; is true, search inherited properties too.
914
</source>
915
        <translation type="unfinished">getPropertyCType(object, property, includesuper=True)
916
 
917
Returns the name of the C type of `property&apos; of `object&apos;. See getProperty()
918
for details of arguments.
919
 
920
If `includesuper&apos; is true, search inherited properties too.</translation>
921
    </message>
922
    <message>
14474 cbradney 923
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="96"/>
12918 cbradney 924
        <source>getPropertyNames(object, includesuper=True)
925
 
926
Return a list of property names supported by `object&apos;.
927
If `includesuper&apos; is true, return properties supported
928
by parent classes as well.
929
</source>
930
        <translation type="unfinished">getPropertyNames(object, includesuper=True)
931
 
932
Return a list of property names supported by `object&apos;.
933
If `includesuper&apos; is true, return properties supported
934
by parent classes as well.</translation>
935
    </message>
936
    <message>
14474 cbradney 937
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="123"/>
12918 cbradney 938
        <source>getProperty(object, property)
939
 
940
Return the value of the property `property&apos; of the passed `object&apos;.
941
 
942
The `object&apos; argument may be a string, in which case the named PageItem
943
is searched for. It may also be a PyCObject, which may point to any
944
C++ QObject instance.
945
 
946
The `property&apos; argument must be a string, and is the name of the property
947
to look up on `object&apos;.
948
 
949
The return value varies depending on the type of the property.
950
</source>
951
        <translation type="unfinished">getProperty(object, property)
952
 
953
Return the value of the property `property&apos; of the passed `object&apos;.
954
 
955
The `object&apos; argument may be a string, in which case the named PageItem
956
is searched for. It may also be a PyCObject, which may point to any
957
C++ QObject instance.
958
 
959
The `property&apos; argument must be a string, and is the name of the property
960
to look up on `object&apos;.
961
 
962
The return value varies depending on the type of the property.
963
</translation>
964
    </message>
965
    <message>
14474 cbradney 966
        <location filename="../../../scribus/plugins/scriptplugin/cmdgetsetprop.h" line="158"/>
12918 cbradney 967
        <source>setProperty(object, property, value)
968
 
969
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
970
compatible with the type of `property&apos;, an exception is raised. An exception may
971
also be raised if the underlying setter fails.
972
 
973
See getProperty() for more information.
974
</source>
975
        <translation type="unfinished">setProperty(object, property, value)
976
 
977
Set `property&apos; of `object&apos; to `value&apos;. If `value&apos; cannot be converted to a type
978
compatible with the type of `property&apos;, an exception is raised. An exception may
979
also be raised if the underlying setter fails.
980
 
981
See getProperty() for more information.
982
</translation>
983
    </message>
984
    <message>
14474 cbradney 985
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="17"/>
12918 cbradney 986
        <source>moveObject(dx, dy [, &quot;name&quot;])
987
 
988
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
989
distances are expressed in the current measurement unit of the document (see
990
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
991
If the object &quot;name&quot; belongs to a group, the whole group is moved.
992
</source>
993
        <translation type="unfinished">moveObject(dx, dy [, &quot;name&quot;])
994
 
995
Siirtää kohdetta &quot;name&quot; arvoilla dx ja dy  suhteessa nykyiseen sijaintiin. Etäisyydet
996
ilmaistaan asiakirjassa käytössä olevalla yksiköllä (katso UNIT-vakio). Jos &quot;name&quot; ei
997
ole määritelty, käytetään valittuna olevaa kohdetta. Jos kohde &quot;name&quot; kuuluu
998
ryhmään, koko ryhmää siirretään.</translation>
999
    </message>
1000
    <message>
14474 cbradney 1001
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="29"/>
12918 cbradney 1002
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
1003
 
1004
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
1005
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
1006
is not given the currently selected item is used.  If the object &quot;name&quot;
1007
belongs to a group, the whole group is moved.
1008
</source>
1009
        <translation type="unfinished">moveObjectAbs(x, y [, &quot;name&quot;])
1010
 
1011
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
1012
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
1013
is not given the currently selected item is used.  If the object &quot;name&quot;
1014
belongs to a group, the whole group is moved.
1015
</translation>
1016
    </message>
1017
    <message>
14474 cbradney 1018
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="41"/>
12918 cbradney 1019
        <source>rotateObject(rot [, &quot;name&quot;])
1020
 
1021
Rotates the object &quot;name&quot; by &quot;rot&quot; degrees relatively. The object is
1022
rotated by the vertex that is currently selected as the rotation point - by
1023
default, the top left vertex at zero rotation. Positive values mean counter
1024
clockwise rotation when the default rotation point is used. If &quot;name&quot; is not
1025
given the currently selected item is used.
1026
</source>
1027
        <translation type="unfinished"></translation>
1028
    </message>
1029
    <message>
14474 cbradney 1030
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="54"/>
12918 cbradney 1031
        <source>rotateObjectAbs(rot [, &quot;name&quot;])
1032
 
1033
Sets the rotation of the object &quot;name&quot; to &quot;rot&quot;. Positive values
1034
mean counter clockwise rotation. If &quot;name&quot; is not given the currently
1035
selected item is used.
1036
</source>
1037
        <translation type="unfinished"></translation>
1038
    </message>
1039
    <message>
14474 cbradney 1040
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="65"/>
12918 cbradney 1041
        <source>sizeObject(width, height [, &quot;name&quot;])
1042
 
1043
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1044
is not given the currently selected item is used.
1045
</source>
1046
        <translation type="unfinished">sizeObject(width, height [, &quot;name&quot;])
1047
 
1048
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
1049
is not given the currently selected item is used.
1050
</translation>
1051
    </message>
1052
    <message>
14474 cbradney 1053
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="75"/>
12918 cbradney 1054
        <source>getSelectedObject([nr]) -&gt; string
1055
 
1056
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1057
of the selected object, e.g. 0 means the first selected object, 1 means the
1058
second selected Object and so on.
1059
</source>
1060
        <translation type="unfinished">getSelectedObject([nr]) -&gt; string
1061
 
1062
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
1063
of the selected object, e.g. 0 means the first selected object, 1 means the
1064
second selected Object and so on.
1065
</translation>
1066
    </message>
1067
    <message>
14474 cbradney 1068
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="86"/>
12918 cbradney 1069
        <source>selectionCount() -&gt; integer
1070
 
1071
Returns the number of selected objects.
1072
</source>
1073
        <translation type="unfinished">selectionCount() -&gt; integer
1074
 
1075
Returns the number of selected objects.
1076
</translation>
1077
    </message>
1078
    <message>
14474 cbradney 1079
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="95"/>
12918 cbradney 1080
        <source>selectObject(&quot;name&quot;)
1081
 
1082
Selects the object with the given &quot;name&quot;.
1083
</source>
1084
        <translation type="unfinished">selectObject(&quot;name&quot;)
1085
 
1086
Selects the object with the given &quot;name&quot;.
1087
</translation>
1088
    </message>
1089
    <message>
14474 cbradney 1090
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="104"/>
12918 cbradney 1091
        <source>deselectAll()
1092
 
1093
Deselects all objects in the whole document.
1094
</source>
1095
        <translation type="unfinished">deselectAll()
1096
 
1097
Deselects all objects in the whole document.
1098
</translation>
1099
    </message>
1100
    <message>
14474 cbradney 1101
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="113"/>
14747 cbradney 1102
        <source>groupObjects(list) -&gt; string
1103
 
1104
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1105
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1106
items are used. Returns the group name for further referencing.
1107
</source>
1108
        <translation type="unfinished"></translation>
1109
    </message>
1110
    <message>
12918 cbradney 1111
        <source>groupObjects(list)
1112
 
1113
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1114
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1115
items are used.
1116
</source>
14747 cbradney 1117
        <translation type="obsolete">groupObjects(list)
12918 cbradney 1118
 
1119
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
1120
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
1121
items are used.
1122
</translation>
1123
    </message>
1124
    <message>
14474 cbradney 1125
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="124"/>
12918 cbradney 1126
        <source>unGroupObjects(&quot;name&quot;)
1127
 
1128
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
1129
        <translation type="unfinished">unGroupObjects(&quot;name&quot;)
1130
 
1131
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.
1132
</translation>
1133
    </message>
1134
    <message>
14474 cbradney 1135
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="132"/>
12918 cbradney 1136
        <source>scaleGroup(factor [,&quot;name&quot;])
1137
 
1138
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1139
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1140
scales the group to 50 % of its original size, a value of 1.5 scales the group
1141
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1142
0. If &quot;name&quot; is not given the currently selected item is used.
1143
 
1144
May raise ValueError if an invalid scale factor is passed.
1145
</source>
1146
        <translation type="unfinished">scaleGroup(factor [,&quot;name&quot;])
1147
 
1148
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
1149
the group, values smaller than 1 make the group smaller e.g a value of 0.5
1150
scales the group to 50 % of its original size, a value of 1.5 scales the group
1151
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
1152
0. If &quot;name&quot; is not given the currently selected item is used.
1153
 
1154
May raise ValueError if an invalid scale factor is passed.
1155
</translation>
1156
    </message>
1157
    <message>
14474 cbradney 1158
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="147"/>
12918 cbradney 1159
        <source>loadImage(&quot;filename&quot; [, &quot;name&quot;])
1160
 
1161
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1162
not given the currently selected item is used.
1163
 
1164
May raise WrongFrameTypeError if the target frame is not an image frame
1165
</source>
1166
        <translation type="unfinished">loadImage(&quot;filename&quot; [, &quot;name&quot;])
1167
 
1168
Loads the picture &quot;picture&quot; into the image frame &quot;name&quot;. If &quot;name&quot; is
1169
not given the currently selected item is used.
1170
 
1171
May raise WrongFrameTypeError if the target frame is not an image frame
1172
</translation>
1173
    </message>
1174
    <message>
14474 cbradney 1175
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="159"/>
12918 cbradney 1176
        <source>scaleImage(x, y [, &quot;name&quot;])
1177
 
14474 cbradney 1178
Sets the internal scaling factors of the picture in the image frame &quot;name&quot;.
1179
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1180
means 100 %. Internal scaling factors are different from the values shown on
1181
properties palette. Note : deprecated, use setImageScale() instead.
1182
 
1183
May raise WrongFrameTypeError if the target frame is not an image frame
1184
</source>
1185
        <translation type="unfinished"></translation>
1186
    </message>
1187
    <message>
1188
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="173"/>
1189
        <source>setImageScale(x, y [, &quot;name&quot;])
1190
 
12918 cbradney 1191
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1192
If &quot;name&quot; is not given the currently selected item is used. A number of 1
14474 cbradney 1193
means 100 %. Scaling factors are equal to the values shown on properties palette.
1194
 
1195
May raise WrongFrameTypeError if the target frame is not an image frame
1196
</source>
1197
        <translation type="unfinished"></translation>
1198
    </message>
1199
    <message>
1200
        <source>scaleImage(x, y [, &quot;name&quot;])
1201
 
1202
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1203
If &quot;name&quot; is not given the currently selected item is used. A number of 1
12918 cbradney 1204
means 100 %.
1205
 
1206
May raise WrongFrameTypeError if the target frame is not an image frame
1207
</source>
13279 cbradney 1208
        <translation type="obsolete">scaleImage(x, y [, &quot;name&quot;])
12918 cbradney 1209
 
1210
Sets the scaling factors of the picture in the image frame &quot;name&quot;.
1211
If &quot;name&quot; is not given the currently selected item is used. A number of 1
1212
means 100 %.
1213
 
1214
May raise WrongFrameTypeError if the target frame is not an image frame
1215
</translation>
1216
    </message>
1217
    <message>
14474 cbradney 1218
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="186"/>
12918 cbradney 1219
        <source>lockObject([&quot;name&quot;]) -&gt; bool
1220
 
1221
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1222
If &quot;name&quot; is not given the currently selected item is used. Returns true
1223
if locked.
1224
</source>
1225
        <translation type="unfinished">lockObject([&quot;name&quot;]) -&gt; bool
1226
 
1227
Locks the object &quot;name&quot; if it&apos;s unlocked or unlock it if it&apos;s locked.
1228
If &quot;name&quot; is not given the currently selected item is used. Returns true
1229
if locked.
1230
</translation>
1231
    </message>
1232
    <message>
14474 cbradney 1233
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="197"/>
12918 cbradney 1234
        <source>isLocked([&quot;name&quot;]) -&gt; bool
1235
 
1236
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1237
currently selected item is used.
1238
</source>
1239
        <translation type="unfinished">isLocked([&quot;name&quot;]) -&gt; bool
1240
 
1241
Returns true if is the object &quot;name&quot; locked.  If &quot;name&quot; is not given the
1242
currently selected item is used.
1243
</translation>
1244
    </message>
1245
    <message>
14474 cbradney 1246
        <location filename="../../../scribus/plugins/scriptplugin/cmdmani.h" line="206"/>
12918 cbradney 1247
        <source>setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1248
 
1249
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1250
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1251
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1252
 
1253
May raise WrongFrameTypeError.
1254
</source>
1255
        <translation type="unfinished">setScaleImageToFrame(scaletoframe, proportional=None, name=&lt;selection&gt;)
1256
 
1257
Sets the scale to frame on the selected or specified image frame to `scaletoframe&apos;.
1258
If `proportional&apos; is specified, set fixed aspect ratio scaling to `proportional&apos;.
1259
Both `scaletoframe&apos; and `proportional&apos; are boolean.
1260
 
1261
May raise WrongFrameTypeError. </translation>
1262
    </message>
1263
    <message>
14474 cbradney 1264
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="19"/>
12918 cbradney 1265
        <source>setRedraw(bool)
1266
 
1267
Disables page redraw when bool = False, otherwise redrawing is enabled.
1268
This change will persist even after the script exits, so make sure to call
1269
setRedraw(True) in a finally: clause at the top level of your script.
1270
</source>
1271
        <translation type="unfinished">setRedraw(bool)
1272
 
1273
Estää sivun uudelleenpiirron, kun bool=False. Muuten uudelleen piirto on
1274
käytössä. Tämä asetus jää voimaan vaikka skriptistä poistutaan. Varmista,
1275
että kutsut setRedraw(True) finally: -lauseessa ylimmällä tasolla skriptissäsi.</translation>
1276
    </message>
1277
    <message>
14474 cbradney 1278
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="30"/>
12918 cbradney 1279
        <source>getFontNames() -&gt; list
1280
 
1281
Returns a list with the names of all available fonts.
1282
</source>
1283
        <translation type="unfinished">getFontNames() -&gt; list
1284
 
1285
Returns a list with the names of all available fonts.
1286
</translation>
1287
    </message>
1288
    <message>
14474 cbradney 1289
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="39"/>
12918 cbradney 1290
        <source>getXFontNames() -&gt; list of tuples
1291
 
1292
Returns a larger font info. It&apos;s a list of the tuples with:
1293
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1294
</source>
1295
        <translation type="unfinished">getXFontNames() -&gt; list of tuples
1296
 
1297
Returns a larger font info. It&apos;s a list of the tuples with:
1298
[ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1299
</translation>
1300
    </message>
1301
    <message>
14474 cbradney 1302
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="52"/>
12918 cbradney 1303
        <source>renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1304
 
1305
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1306
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1307
image data is returned as a string. The optional &quot;format&quot; argument
1308
specifies the image format to generate, and supports any format allowed
1309
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1310
 
1311
May raise NotFoundError if the specified font can&apos;t be found.
1312
May raise ValueError if an empty sample or filename is passed.
1313
</source>
1314
        <translation type="unfinished">renderFont(&quot;name&quot;, &quot;filename&quot;, &quot;sample&quot;, size, format=&quot;PPM&quot;) -&gt; bool
1315
 
1316
Creates an image preview of font &quot;name&quot; with given text &quot;sample&quot; and size.
1317
If &quot;filename&quot; is not &quot;&quot;, image is saved into &quot;filename&quot;. Otherwise
1318
image data is returned as a string. The optional &quot;format&quot; argument
1319
specifies the image format to generate, and supports any format allowed
1320
by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1321
 
1322
May raise NotFoundError if the specified font can&apos;t be found.
1323
May raise ValueError if an empty sample or filename is passed. </translation>
1324
    </message>
1325
    <message>
14474 cbradney 1326
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="68"/>
12918 cbradney 1327
        <source>getLayers() -&gt; list
1328
 
1329
Returns a list with the names of all defined layers.
1330
</source>
1331
        <translation type="unfinished">getLayers() -&gt; list
1332
 
1333
 
1334
Returns a list with the names of all defined layers. </translation>
1335
    </message>
1336
    <message>
14474 cbradney 1337
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="77"/>
12918 cbradney 1338
        <source>setActiveLayer(&quot;name&quot;)
1339
 
1340
Sets the active layer to the layer named &quot;name&quot;.
1341
 
1342
May raise NotFoundError if the layer can&apos;t be found.
1343
May raise ValueError if the layer name isn&apos;t acceptable.
1344
</source>
1345
        <translation type="unfinished">setActiveLayer(&quot;name&quot;)
1346
 
1347
Sets the active layer to the layer named &quot;name&quot;.
1348
 
1349
May raise NotFoundError if the layer can&apos;t be found.
1350
May raise ValueError if the layer name isn&apos;t acceptable.
1351
</translation>
1352
    </message>
1353
    <message>
14474 cbradney 1354
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="89"/>
12918 cbradney 1355
        <source>getActiveLayer() -&gt; string
1356
 
1357
Returns the name of the current active layer.
1358
</source>
1359
        <translation type="unfinished">getActiveLayer() -&gt; string
1360
 
1361
Returns the name of the current active layer.
1362
</translation>
1363
    </message>
1364
    <message>
14474 cbradney 1365
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="98"/>
12918 cbradney 1366
        <source>sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1367
 
1368
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1369
If &quot;name&quot; is not given the currently selected item is used.
1370
 
1371
May raise NotFoundError if the layer can&apos;t be found.
1372
May raise ValueError if the layer name isn&apos;t acceptable.
1373
</source>
1374
        <translation type="unfinished">sentToLayer(&quot;layer&quot; [, &quot;name&quot;])
1375
 
1376
Sends the object &quot;name&quot; to the layer &quot;layer&quot;. The layer must exist.
1377
If &quot;name&quot; is not given the currently selected item is used.
1378
 
1379
May raise NotFoundError if the layer can&apos;t be found.
1380
May raise ValueError if the layer name isn&apos;t acceptable.
1381
</translation>
1382
    </message>
1383
    <message>
14474 cbradney 1384
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="111"/>
12918 cbradney 1385
        <source>setLayerVisible(&quot;layer&quot;, visible)
1386
 
1387
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1388
the layer is invisible.
1389
 
1390
May raise NotFoundError if the layer can&apos;t be found.
1391
May raise ValueError if the layer name isn&apos;t acceptable.
1392
</source>
1393
        <translation type="unfinished">setLayerVisible(&quot;layer&quot;, visible)
1394
 
1395
Sets the layer &quot;layer&quot; to be visible or not. If is the visible set to false
1396
the layer is invisible.
1397
 
1398
May raise NotFoundError if the layer can&apos;t be found.
1399
May raise ValueError if the layer name isn&apos;t acceptable.
1400
</translation>
1401
    </message>
1402
    <message>
14474 cbradney 1403
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="124"/>
12918 cbradney 1404
        <source>setLayerPrintable(&quot;layer&quot;, printable)
1405
 
1406
Sets the layer &quot;layer&quot; to be printable or not. If is the
1407
printable set to false the layer won&apos;t be printed.
1408
 
1409
May raise NotFoundError if the layer can&apos;t be found.
1410
May raise ValueError if the layer name isn&apos;t acceptable.
1411
</source>
1412
        <translation type="unfinished"></translation>
1413
    </message>
1414
    <message>
14474 cbradney 1415
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="137"/>
12918 cbradney 1416
        <source>setLayerLocked(&quot;layer&quot;, locked)
1417
 
1418
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1419
true the layer will be locked.
1420
 
1421
May raise NotFoundError if the layer can&apos;t be found.
1422
May raise ValueError if the layer name isn&apos;t acceptable.
1423
</source>
1424
        <translation type="unfinished">setLayerLocked(&quot;layer&quot;, locked)
1425
 
1426
Sets the layer &quot;layer&quot; to be locked or not. If locked is set to
1427
true the layer will be locked.
1428
 
1429
May raise NotFoundError if the layer can&apos;t be found.
1430
May raise ValueError if the layer name isn&apos;t acceptable.
1431
</translation>
1432
    </message>
1433
    <message>
14474 cbradney 1434
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="150"/>
12918 cbradney 1435
        <source>setLayerOutlined(&quot;layer&quot;, outline)
1436
 
1437
Sets the layer &quot;layer&quot; to be locked or not. If outline is set to
1438
true the layer will be displayed outlined.
1439
 
1440
May raise NotFoundError if the layer can&apos;t be found.
1441
May raise ValueError if the layer name isn&apos;t acceptable.
1442
</source>
1443
        <translation type="unfinished"></translation>
1444
    </message>
1445
    <message>
14474 cbradney 1446
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="163"/>
12918 cbradney 1447
        <source>setLayerFlow(&quot;layer&quot;, flow)
1448
 
1449
Sets the layers &quot;layer&quot;  flowcontrol to flow. If flow is set to
1450
true text in layers above this one will flow around objects on this layer.
1451
 
1452
May raise NotFoundError if the layer can&apos;t be found.
1453
May raise ValueError if the layer name isn&apos;t acceptable.
1454
</source>
1455
        <translation type="unfinished"></translation>
1456
    </message>
1457
    <message>
14474 cbradney 1458
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="176"/>
12918 cbradney 1459
        <source>setLayerBlendmode(&quot;layer&quot;, blend)
1460
 
1461
Sets the layers &quot;layer&quot;  blendmode to blend.
1462
 
1463
May raise NotFoundError if the layer can&apos;t be found.
1464
May raise ValueError if the layer name isn&apos;t acceptable.
1465
</source>
1466
        <translation type="unfinished"></translation>
1467
    </message>
1468
    <message>
14474 cbradney 1469
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="188"/>
12918 cbradney 1470
        <source>setLayerTransparency(&quot;layer&quot;, trans)
1471
 
1472
Sets the layers &quot;layer&quot;  transparency to trans.
1473
 
1474
May raise NotFoundError if the layer can&apos;t be found.
1475
May raise ValueError if the layer name isn&apos;t acceptable.
1476
</source>
1477
        <translation type="unfinished"></translation>
1478
    </message>
1479
    <message>
14474 cbradney 1480
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="200"/>
12918 cbradney 1481
        <source>isLayerVisible(&quot;layer&quot;) -&gt; bool
1482
 
1483
Returns whether the layer &quot;layer&quot; is visible or not, a value of True means
1484
that the layer &quot;layer&quot; is visible, a value of False means that the layer
1485
&quot;layer&quot; is invisible.
1486
 
1487
May raise NotFoundError if the layer can&apos;t be found.
1488
May raise ValueError if the layer name isn&apos;t acceptable.
1489
</source>
1490
        <translation type="unfinished"></translation>
1491
    </message>
1492
    <message>
14474 cbradney 1493
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="214"/>
12918 cbradney 1494
        <source>isLayerPrintable(&quot;layer&quot;) -&gt; bool
1495
 
1496
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1497
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1498
the layer &quot;layer&quot; is disabled.
1499
 
1500
May raise NotFoundError if the layer can&apos;t be found.
1501
May raise ValueError if the layer name isn&apos;t acceptable.
1502
</source>
1503
        <translation type="unfinished">isLayerPrintable(&quot;layer&quot;) -&gt; bool
1504
 
1505
Returns whether the layer &quot;layer&quot; is printable or not, a value of True means
1506
that the layer &quot;layer&quot; can be printed, a value of False means that printing
1507
the layer &quot;layer&quot; is disabled.
1508
 
1509
May raise NotFoundError if the layer can&apos;t be found.
1510
May raise ValueError if the layer name isn&apos;t acceptable. </translation>
1511
    </message>
1512
    <message>
14474 cbradney 1513
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="228"/>
12918 cbradney 1514
        <source>isLayerLocked(&quot;layer&quot;) -&gt; bool
1515
 
1516
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1517
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1518
&quot;layer&quot; is locked.
1519
 
1520
May raise NotFoundError if the layer can&apos;t be found.
1521
May raise ValueError if the layer name isn&apos;t acceptable.
1522
</source>
1523
        <translation type="unfinished">isLayerLocked(&quot;layer&quot;) -&gt; bool
1524
 
1525
Returns whether the layer &quot;layer&quot; is locked or not, a value of True means
1526
that the layer &quot;layer&quot; is editable, a value of False means that the layer
1527
&quot;layer&quot; is locked.
1528
 
1529
May raise NotFoundError if the layer can&apos;t be found.
1530
May raise ValueError if the layer name isn&apos;t acceptable.
1531
</translation>
1532
    </message>
1533
    <message>
14474 cbradney 1534
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="242"/>
12918 cbradney 1535
        <source>isLayerOutlined(&quot;layer&quot;) -&gt; bool
1536
 
1537
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1538
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1539
&quot;layer&quot; is normal.
1540
 
1541
May raise NotFoundError if the layer can&apos;t be found.
1542
May raise ValueError if the layer name isn&apos;t acceptable.
1543
</source>
1544
        <translation type="unfinished">isLayerOutlined(&quot;layer&quot;) -&gt; bool
1545
 
1546
Returns whether the layer &quot;layer&quot; is outlined or not, a value of True means
1547
that the layer &quot;layer&quot; is outlined, a value of False means that the layer
1548
&quot;layer&quot; is normal.
1549
 
1550
May raise NotFoundError if the layer can&apos;t be found.
1551
May raise ValueError if the layer name isn&apos;t acceptable.
1552
</translation>
1553
    </message>
1554
    <message>
14474 cbradney 1555
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="256"/>
12918 cbradney 1556
        <source>isLayerFlow(&quot;layer&quot;) -&gt; bool
1557
 
1558
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1559
that text flows around, a value of False means that the text does not flow around.
1560
 
1561
May raise NotFoundError if the layer can&apos;t be found.
1562
May raise ValueError if the layer name isn&apos;t acceptable.
1563
</source>
1564
        <translation type="unfinished">isLayerFlow(&quot;layer&quot;) -&gt; bool
1565
 
1566
Returns whether text flows around objects on layer &quot;layer&quot;, a value of True means
1567
that text flows around, a value of False means that the text does not flow around.
1568
 
1569
May raise NotFoundError if the layer can&apos;t be found.
1570
May raise ValueError if the layer name isn&apos;t acceptable.
1571
</translation>
1572
    </message>
1573
    <message>
14474 cbradney 1574
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="269"/>
12918 cbradney 1575
        <source>getLayerBlendmode(&quot;layer&quot;) -&gt; int
1576
 
1577
Returns the &quot;layer&quot; layer blendmode,
1578
 
1579
May raise NotFoundError if the layer can&apos;t be found.
1580
May raise ValueError if the layer name isn&apos;t acceptable.
1581
</source>
1582
        <translation type="unfinished">getLayerBlendmode(&quot;layer&quot;) -&gt; int
1583
 
1584
Returns the &quot;layer&quot; layer blendmode,
1585
 
1586
May raise NotFoundError if the layer can&apos;t be found.
1587
May raise ValueError if the layer name isn&apos;t acceptable.
1588
</translation>
1589
    </message>
1590
    <message>
14474 cbradney 1591
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="281"/>
12918 cbradney 1592
        <source>getLayerTransparency(&quot;layer&quot;) -&gt; float
1593
 
1594
Returns the &quot;layer&quot; layer transparency,
1595
 
1596
May raise NotFoundError if the layer can&apos;t be found.
1597
May raise ValueError if the layer name isn&apos;t acceptable.
1598
</source>
1599
        <translation type="unfinished">getLayerTransparency(&quot;layer&quot;) -&gt; float
1600
 
1601
Returns the &quot;layer&quot; layer transparency,
1602
 
1603
May raise NotFoundError if the layer can&apos;t be found.
1604
May raise ValueError if the layer name isn&apos;t acceptable.
1605
</translation>
1606
    </message>
1607
    <message>
14474 cbradney 1608
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="293"/>
12918 cbradney 1609
        <source>deleteLayer(&quot;layer&quot;)
1610
 
1611
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1612
exists or if it&apos;s the only layer in the document.
1613
 
1614
May raise NotFoundError if the layer can&apos;t be found.
1615
May raise ValueError if the layer name isn&apos;t acceptable.
1616
</source>
1617
        <translation type="unfinished">deleteLayer(&quot;layer&quot;)
1618
 
1619
 
1620
Deletes the layer with the name &quot;layer&quot;. Nothing happens if the layer doesn&apos;t
1621
exists or if it&apos;s the only layer in the document.
1622
 
1623
May raise NotFoundError if the layer can&apos;t be found.
1624
May raise ValueError if the layer name isn&apos;t acceptable. </translation>
1625
    </message>
1626
    <message>
14474 cbradney 1627
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="306"/>
12918 cbradney 1628
        <source>createLayer(layer)
1629
 
1630
Creates a new layer with the name &quot;name&quot;.
1631
 
1632
May raise ValueError if the layer name isn&apos;t acceptable.
1633
</source>
1634
        <translation type="unfinished">createLayer(layer)
1635
 
1636
Creates a new layer with the name &quot;name&quot;.
1637
 
1638
May raise ValueError if the layer name isn&apos;t acceptable.
1639
</translation>
1640
    </message>
1641
    <message>
14474 cbradney 1642
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="317"/>
12918 cbradney 1643
        <source>getGuiLanguage() -&gt; string
1644
 
1645
Returns a string with the -lang value.
1646
</source>
1647
        <translation type="unfinished">getGuiLanguage() -&gt; string
1648
 
1649
Returns a string with the -lang value.
1650
</translation>
1651
    </message>
1652
    <message>
14474 cbradney 1653
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="326"/>
12918 cbradney 1654
        <source>moveSelectionToFront()
1655
 
1656
Moves current selection to front.
1657
</source>
1658
        <translation type="unfinished"></translation>
1659
    </message>
1660
    <message>
14474 cbradney 1661
        <location filename="../../../scribus/plugins/scriptplugin/cmdmisc.h" line="335"/>
12918 cbradney 1662
        <source>moveSelectionToFront()
1663
 
1664
Moves current selection to back.
1665
</source>
1666
        <translation type="unfinished"></translation>
1667
    </message>
1668
    <message>
14474 cbradney 1669
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="17"/>
12918 cbradney 1670
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1671
 
1672
Creates a new rectangle on the current page and returns its name. The
1673
coordinates are given in the current measurement units of the document
1674
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1675
because you need this name to reference that object in future. If &quot;name&quot;
1676
is not given Scribus will create one for you.
1677
 
1678
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1679
</source>
1680
        <translation type="unfinished">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1681
 
1682
Luo uuden nelikulmion nykyiselle sivulle ja palauttaa luodun kohteen nimen.
1683
Koordinaatit on annettava asiakirjassa käytössä olevalla yksiköllä. Katso (UNIT vakiot).
1684
&quot;name&quot;:n tulee olla yksilöllinen tunniste kohteelle, koska tarvitset nimeä myöhemmin
1685
viitatessasi nelikulmioon. Jos &quot;name&quot;:a ei anneta Scribus luo sen.
1686
 
1687
Saattaa nostaa NameExistsError:n, jos annettu nimi on jo olemassa.</translation>
1688
    </message>
1689
    <message>
14474 cbradney 1690
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="34"/>
12918 cbradney 1691
        <source>createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1692
 
1693
Creates a new ellipse on the current page and returns its name.
1694
The coordinates are given in the current measurement units of the document
1695
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1696
because you need this name for further referencing of that object. If &quot;name&quot;
1697
is not given Scribus will create one for you.
1698
 
1699
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1700
</source>
1701
        <translation type="unfinished">createEllipse(x, y, width, height, [&quot;name&quot;]) -&gt; string
1702
 
1703
Creates a new ellipse on the current page and returns its name.
1704
The coordinates are given in the current measurement units of the document
1705
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
1706
because you need this name for further referencing of that object. If &quot;name&quot;
1707
is not given Scribus will create one for you.
1708
 
1709
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1710
</translation>
1711
    </message>
1712
    <message>
14474 cbradney 1713
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="51"/>
12918 cbradney 1714
        <source>createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1715
 
1716
Creates a new picture frame on the current page and returns its name. The
1717
coordinates are given in the current measurement units of the document.
1718
&quot;name&quot; should be a unique identifier for the object because you need this
1719
name for further access to that object. If &quot;name&quot; is not given Scribus will
1720
create one for you.
1721
 
1722
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1723
</source>
1724
        <translation type="unfinished">createImage(x, y, width, height, [&quot;name&quot;]) -&gt; string
1725
 
1726
Creates a new picture frame on the current page and returns its name. The
1727
coordinates are given in the current measurement units of the document.
1728
&quot;name&quot; should be a unique identifier for the object because you need this
1729
name for further access to that object. If &quot;name&quot; is not given Scribus will
1730
create one for you.
1731
 
1732
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1733
</translation>
1734
    </message>
1735
    <message>
14474 cbradney 1736
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="66"/>
12918 cbradney 1737
        <source>createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1738
 
1739
Creates a new text frame on the actual page and returns its name.
1740
The coordinates are given in the actual measurement unit of the document (see
1741
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1742
you need this name for further referencing of that object. If &quot;name&quot; is not
1743
given Scribus will create one for you.
1744
 
1745
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1746
</source>
1747
        <translation type="unfinished">createText(x, y, width, height, [&quot;name&quot;]) -&gt; string
1748
 
1749
Creates a new text frame on the actual page and returns its name.
1750
The coordinates are given in the actual measurement unit of the document (see
1751
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1752
you need this name for further referencing of that object. If &quot;name&quot; is not
1753
given Scribus will create one for you.
1754
 
1755
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1756
</translation>
1757
    </message>
1758
    <message>
14474 cbradney 1759
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="81"/>
12918 cbradney 1760
        <source>createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1761
 
1762
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1763
its name. The coordinates are given in the current measurement unit of the
1764
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1765
object because you need this name for further access to that object. If
1766
&quot;name&quot; is not given Scribus will create one for you.
1767
 
1768
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1769
</source>
1770
        <translation type="unfinished">createLine(x1, y1, x2, y2, [&quot;name&quot;]) -&gt; string
1771
 
1772
Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1773
its name. The coordinates are given in the current measurement unit of the
1774
document (see UNIT constants). &quot;name&quot; should be a unique identifier for the
1775
object because you need this name for further access to that object. If
1776
&quot;name&quot; is not given Scribus will create one for you.
1777
 
1778
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1779
</translation>
1780
    </message>
1781
    <message>
14474 cbradney 1782
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="96"/>
12918 cbradney 1783
        <source>createPolyLine(list, [&quot;name&quot;]) -&gt; string
1784
 
1785
Creates a new polyline and returns its name. The points for the polyline are
1786
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1787
The coordinates are given in the current measurement units of the document (see
1788
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1789
you need this name for further access to that object. If &quot;name&quot; is not given
1790
Scribus will create one for you.
1791
 
1792
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1793
May raise ValueError if an insufficient number of points is passed or if
1794
the number of values passed don&apos;t group into points without leftovers.
1795
</source>
1796
        <translation type="unfinished">createPolyLine(list, [&quot;name&quot;]) -&gt; string
1797
 
1798
Creates a new polyline and returns its name. The points for the polyline are
1799
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1800
The coordinates are given in the current measurement units of the document (see
1801
UNIT constants). &quot;name&quot; should be a unique identifier for the object because
1802
you need this name for further access to that object. If &quot;name&quot; is not given
1803
Scribus will create one for you.
1804
 
1805
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1806
May raise ValueError if an insufficient number of points is passed or if
1807
the number of values passed don&apos;t group into points without leftovers.
1808
</translation>
1809
    </message>
1810
    <message>
14474 cbradney 1811
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="114"/>
12918 cbradney 1812
        <source>createPolygon(list, [&quot;name&quot;]) -&gt; string
1813
 
1814
Creates a new polygon and returns its name. The points for the polygon are
1815
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1816
At least three points are required. There is no need to repeat the first point
1817
to close the polygon. The polygon is automatically closed by connecting the
1818
first and the last point.  The coordinates are given in the current measurement
1819
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1820
identifier for the object because you need this name for further access to that
1821
object. If &quot;name&quot; is not given Scribus will create one for you.
1822
 
1823
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1824
May raise ValueError if an insufficient number of points is passed or if
1825
the number of values passed don&apos;t group into points without leftovers.
1826
</source>
1827
        <translation type="unfinished">createPolygon(list, [&quot;name&quot;]) -&gt; string
1828
 
1829
Creates a new polygon and returns its name. The points for the polygon are
1830
stored in the list &quot;list&quot; in the following order: [x1, y1, x2, y2...xn. yn].
1831
At least three points are required. There is no need to repeat the first point
1832
to close the polygon. The polygon is automatically closed by connecting the
1833
first and the last point.  The coordinates are given in the current measurement
1834
units of the document (see UNIT constants).  &quot;name&quot; should be a unique
1835
identifier for the object because you need this name for further access to that
1836
object. If &quot;name&quot; is not given Scribus will create one for you.
1837
 
1838
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1839
May raise ValueError if an insufficient number of points is passed or if
1840
the number of values passed don&apos;t group into points without leftovers.
1841
</translation>
1842
    </message>
1843
    <message>
14474 cbradney 1844
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="134"/>
12918 cbradney 1845
        <source>createBezierLine(list, [&quot;name&quot;]) -&gt; string
1846
 
1847
Creates a new bezier curve and returns its name. The points for the bezier
1848
curve are stored in the list &quot;list&quot; in the following order:
1849
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1850
In the points list, x and y mean the x and y coordinates of the point and kx
1851
and ky meaning the control point for the curve.  The coordinates are given in
1852
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1853
should be a unique identifier for the object because you need this name for
1854
further access to that object. If &quot;name&quot; is not given Scribus will create one
1855
for you.
1856
 
1857
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1858
May raise ValueError if an insufficient number of points is passed or if
1859
the number of values passed don&apos;t group into points without leftovers.
1860
</source>
1861
        <translation type="unfinished">createBezierLine(list, [&quot;name&quot;]) -&gt; string
1862
 
1863
 
1864
Creates a new bezier curve and returns its name. The points for the bezier
1865
curve are stored in the list &quot;list&quot; in the following order:
1866
[x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1867
In the points list, x and y mean the x and y coordinates of the point and kx
1868
and ky meaning the control point for the curve.  The coordinates are given in
1869
the current measurement units of the document (see UNIT constants). &quot;name&quot;
1870
should be a unique identifier for the object because you need this name for
1871
further access to that object. If &quot;name&quot; is not given Scribus will create one
1872
for you.
1873
 
1874
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1875
May raise ValueError if an insufficient number of points is passed or if
1876
the number of values passed don&apos;t group into points without leftovers. </translation>
1877
    </message>
1878
    <message>
14474 cbradney 1879
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="155"/>
12918 cbradney 1880
        <source>createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1881
 
1882
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1883
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1884
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1885
unique identifier for the object because you need this name for further access
1886
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1887
 
1888
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1889
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1890
</source>
1891
        <translation type="unfinished">createPathText(x, y, &quot;textbox&quot;, &quot;beziercurve&quot;, [&quot;name&quot;]) -&gt; string
1892
 
1893
Creates a new pathText by merging the two objects &quot;textbox&quot; and
1894
&quot;beziercurve&quot; and returns its name. The coordinates are given in the current
1895
measurement unit of the document (see UNIT constants). &quot;name&quot; should be a
1896
unique identifier for the object because you need this name for further access
1897
to that object. If &quot;name&quot; is not given Scribus will create one for you.
1898
 
1899
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1900
May raise NotFoundError if one or both of the named base object don&apos;t exist.
1901
</translation>
1902
    </message>
1903
    <message>
14474 cbradney 1904
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="173"/>
12918 cbradney 1905
        <source>deleteObject([&quot;name&quot;])
1906
 
1907
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1908
selected item is deleted.
1909
</source>
1910
        <translation type="unfinished">deleteObject([&quot;name&quot;])
1911
 
1912
 
1913
Deletes the item with the name &quot;name&quot;. If &quot;name&quot; is not given the currently
1914
selected item is deleted. </translation>
1915
    </message>
1916
    <message>
14474 cbradney 1917
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="184"/>
12918 cbradney 1918
        <source>textFlowMode(&quot;name&quot; [, state])
1919
 
1920
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
1921
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
1922
Setting &quot;state&quot; to 0 will disable text flow.
1923
Setting &quot;state&quot; to 1 will make text flow around object frame.
1924
Setting &quot;state&quot; to 2 will make text flow around bounding box.
1925
Setting &quot;state&quot; to 3 will make text flow around contour line.
1926
If &quot;state&quot; is not passed, text flow is toggled.
1927
</source>
1928
        <translation type="unfinished">textFlowMode(&quot;name&quot; [, state])
1929
 
1930
Enables/disables &quot;Text Flows Around Frame&quot; feature for object &quot;name&quot;.
1931
Called with parameters string name and optional int &quot;state&quot; (0 &lt;= state &lt;= 3).
1932
Setting &quot;state&quot; to 0 will disable text flow.
1933
Setting &quot;state&quot; to 1 will make text flow around object frame.
1934
Setting &quot;state&quot; to 2 will make text flow around bounding box.
1935
Setting &quot;state&quot; to 3 will make text flow around contour line.
1936
If &quot;state&quot; is not passed, text flow is toggled.
1937
</translation>
1938
    </message>
1939
    <message>
14474 cbradney 1940
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="206"/>
12918 cbradney 1941
        <source>objectExists([&quot;name&quot;]) -&gt; bool
1942
 
1943
Test if an object with specified name really exists in the document.
1944
The optional parameter is the object name. When no object name is given,
1945
returns True if there is something selected.
1946
</source>
1947
        <translation type="unfinished">objectExists([&quot;name&quot;]) -&gt; bool
1948
 
1949
Test if an object with specified name really exists in the document.
1950
The optional parameter is the object name. When no object name is given,
1951
returns True if there is something selected.
1952
</translation>
1953
    </message>
1954
    <message>
14474 cbradney 1955
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="223"/>
12918 cbradney 1956
        <source>setStyle(&quot;style&quot; [, &quot;name&quot;])
1957
 
14474 cbradney 1958
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If object name is
1959
given, style is applied to the current text selection in object &quot;name&quot;.
1960
If no object name is given, style is applied on selected object.
1961
</source>
1962
        <translation type="unfinished"></translation>
1963
    </message>
1964
    <message>
1965
        <source>setStyle(&quot;style&quot; [, &quot;name&quot;])
1966
 
12918 cbradney 1967
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
1968
given, it&apos;s applied on the selected object.
1969
</source>
14474 cbradney 1970
        <translation type="obsolete">setStyle(&quot;style&quot; [, &quot;name&quot;])
12918 cbradney 1971
 
1972
Apply the named &quot;style&quot; to the object named &quot;name&quot;. If is no object name
1973
given, it&apos;s applied on the selected object.
1974
</translation>
1975
    </message>
1976
    <message>
14474 cbradney 1977
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="238"/>
12918 cbradney 1978
        <source>getAllStyles() -&gt; list
1979
 
1980
Return a list of the names of all paragraph styles in the current document.
1981
</source>
1982
        <translation type="unfinished">getAllStyles() -&gt; list
1983
 
1984
Return a list of the names of all paragraph styles in the current document.
1985
</translation>
1986
    </message>
1987
    <message>
14474 cbradney 1988
        <location filename="../../../scribus/plugins/scriptplugin/cmdobj.h" line="250"/>
12918 cbradney 1989
        <source>duplicateObject([&quot;name&quot;]) -&gt; string
1990
 
1991
creates a Duplicate of the selected Object (or Selection Group).
1992
</source>
1993
        <translation type="unfinished">duplicateObject([&quot;name&quot;]) -&gt; string
1994
 
1995
creates a Duplicate of the selected Object (or Selection Group).
1996
</translation>
1997
    </message>
1998
    <message>
14474 cbradney 1999
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="17"/>
12918 cbradney 2000
        <source>newPage(where [,&quot;masterpage&quot;])
2001
 
2002
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
2003
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
2004
counted from 1 upwards, no matter what the displayed first page number of your
2005
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
2006
master page for the new page.
2007
 
2008
May raise IndexError if the page number is out of range
2009
</source>
2010
        <translation type="unfinished">newPage(where [,&quot;masterpage&quot;])
2011
 
2012
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
2013
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
2014
counted from 1 upwards, no matter what the displayed first page number of your
2015
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
2016
master page for the new page.
2017
 
2018
May raise IndexError if the page number is out of range
2019
</translation>
2020
    </message>
2021
    <message>
14474 cbradney 2022
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="32"/>
12918 cbradney 2023
        <source>currentPage() -&gt; integer
2024
 
2025
Returns the number of the current working page. Page numbers are counted from 1
2026
upwards, no matter what the displayed first page number of your document is.
2027
</source>
2028
        <translation type="unfinished">currentPage() -&gt; integer
2029
 
2030
Returns the number of the current working page. Page numbers are counted from 1
2031
upwards, no matter what the displayed first page number of your document is.
2032
</translation>
2033
    </message>
2034
    <message>
14474 cbradney 2035
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="42"/>
12918 cbradney 2036
        <source>redrawAll()
2037
 
2038
Redraws all pages.
2039
</source>
2040
        <translation type="unfinished">redrawAll()
2041
 
2042
Redraws all pages.
2043
</translation>
2044
    </message>
2045
    <message>
14474 cbradney 2046
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="51"/>
12918 cbradney 2047
        <source>getPageType() -&gt; integer
2048
 
2049
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
2050
</source>
2051
        <translation type="unfinished">getPageType() -&gt; integer
2052
 
2053
Returns the type of the Page, 0 means left Page, 1 is a middle Page and 2 is a right Page
2054
</translation>
2055
    </message>
2056
    <message>
14474 cbradney 2057
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="60"/>
12918 cbradney 2058
        <source>savePageAsEPS(&quot;name&quot;)
2059
 
2060
Saves the current page as an EPS to the file &quot;name&quot;.
2061
 
2062
May raise ScribusError if the save failed.
2063
</source>
2064
        <translation type="unfinished">savePageAsEPS(&quot;name&quot;)
2065
 
2066
Saves the current page as an EPS to the file &quot;name&quot;.
2067
 
2068
May raise ScribusError if the save failed.
2069
</translation>
2070
    </message>
2071
    <message>
14474 cbradney 2072
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="71"/>
12918 cbradney 2073
        <source>deletePage(nr)
2074
 
2075
Deletes the given page. Does nothing if the document contains only one page.
2076
Page numbers are counted from 1 upwards, no matter what the displayed first
2077
page number is.
2078
 
2079
May raise IndexError if the page number is out of range
2080
</source>
2081
        <translation type="unfinished">deletePage(nr)
2082
 
2083
Deletes the given page. Does nothing if the document contains only one page.
2084
Page numbers are counted from 1 upwards, no matter what the displayed first
2085
page number is.
2086
 
2087
May raise IndexError if the page number is out of range
2088
</translation>
2089
    </message>
2090
    <message>
14474 cbradney 2091
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="84"/>
12918 cbradney 2092
        <source>gotoPage(nr)
2093
 
2094
Moves to the page &quot;nr&quot; (that is, makes the current page &quot;nr&quot;). Note that
2095
gotoPage doesn&apos;t (currently) change the page the user&apos;s view is displaying, it
2096
just sets the page that script commands will operates on.
2097
 
2098
May raise IndexError if the page number is out of range.
2099
</source>
2100
        <translation type="unfinished"></translation>
2101
    </message>
2102
    <message>
14474 cbradney 2103
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="97"/>
12918 cbradney 2104
        <source>pageCount() -&gt; integer
2105
 
2106
Returns the number of pages in the document.
2107
</source>
2108
        <translation type="unfinished">pageCount() -&gt; integer
2109
 
2110
Returns the number of pages in the document.
2111
</translation>
2112
    </message>
2113
    <message>
14474 cbradney 2114
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="106"/>
12918 cbradney 2115
        <source>getHGuides() -&gt; list
2116
 
2117
Returns a list containing positions of the horizontal guides. Values are in the
2118
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2119
</source>
2120
        <translation type="unfinished">getHGuides() -&gt; list
2121
 
2122
Returns a list containing positions of the horizontal guides. Values are in the
2123
document&apos;s current units - see UNIT_&lt;type&gt; constants.
2124
</translation>
2125
    </message>
2126
    <message>
14474 cbradney 2127
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="116"/>
12918 cbradney 2128
        <source>setHGuides(list)
2129
 
2130
Sets horizontal guides. Input parameter must be a list of guide positions
2131
measured in the current document units - see UNIT_&lt;type&gt; constants.
2132
 
2133
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2134
         setHGuides([90,250]) # replace current guides entirely
2135
</source>
2136
        <translation type="unfinished">setHGuides(list)
2137
 
2138
Sets horizontal guides. Input parameter must be a list of guide positions
2139
measured in the current document units - see UNIT_&lt;type&gt; constants.
2140
 
2141
Example: setHGuides(getHGuides() + [200.0, 210.0] # add new guides without any lost
2142
         setHGuides([90,250]) # replace current guides entirely
2143
</translation>
2144
    </message>
2145
    <message>
14474 cbradney 2146
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="129"/>
12918 cbradney 2147
        <source>getVGuides()
2148
 
2149
See getHGuides.
2150
</source>
2151
        <translation type="unfinished">getVGuides()
2152
 
2153
See getHGuides.
2154
</translation>
2155
    </message>
2156
    <message>
14474 cbradney 2157
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="138"/>
12918 cbradney 2158
        <source>setVGuides()
2159
 
2160
See setHGuides.
2161
</source>
2162
        <translation type="unfinished">setVGuides()
2163
 
2164
 
2165
See setHGuides. </translation>
2166
    </message>
2167
    <message>
14474 cbradney 2168
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="147"/>
12918 cbradney 2169
        <source>getPageSize() -&gt; tuple
2170
 
2171
Returns a tuple with page dimensions measured in the document&apos;s current units.
2172
See UNIT_&lt;type&gt; constants and getPageMargins()
2173
</source>
2174
        <translation type="unfinished">getPageSize() -&gt; tuple
2175
 
2176
Returns a tuple with page dimensions measured in the document&apos;s current units.
2177
See UNIT_&lt;type&gt; constants and getPageMargins()
2178
</translation>
2179
    </message>
2180
    <message>
14474 cbradney 2181
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="161"/>
2182
        <source>getPageNSize() -&gt; tuple
2183
 
2184
Returns a tuple with a particular page&apos;s size measured in the document&apos;s current units.
2185
See UNIT_&lt;type&gt; constants and getPageMargins()
2186
</source>
2187
        <translation type="unfinished"></translation>
2188
    </message>
2189
    <message>
2190
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="174"/>
2191
        <source>getPageNMargins() -&gt; tuple
2192
 
2193
Returns a tuple with a particular page&apos;s margins measured in the document&apos;s current units.
2194
See UNIT_&lt;type&gt; constants and getPageMargins()
2195
</source>
2196
        <translation type="unfinished"></translation>
2197
    </message>
2198
    <message>
2199
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="187"/>
12918 cbradney 2200
        <source>getPageItems() -&gt; list
2201
 
2202
Returns a list of tuples with items on the current page. The tuple is:
2203
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2204
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2205
the page...
2206
</source>
2207
        <translation type="unfinished">getPageItems() -&gt; list
2208
 
2209
Returns a list of tuples with items on the current page. The tuple is:
2210
(name, objectType, order) E.g. [(&apos;Text1&apos;, 4, 0), (&apos;Image1&apos;, 2, 1)]
2211
means that object named &apos;Text1&apos; is a text frame (type 4) and is the first at
2212
the page...
2213
</translation>
2214
    </message>
2215
    <message>
14474 cbradney 2216
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="203"/>
12918 cbradney 2217
        <source>getPageMargins()
2218
 
2219
Returns the page margins as a (top, left, right, bottom) tuple in the current
2220
units. See UNIT_&lt;type&gt; constants and getPageSize().
2221
</source>
2222
        <translation type="unfinished">getPageMargins()
2223
 
2224
Returns the page margins as a (top, left, right, bottom) tuple in the current
2225
units. See UNIT_&lt;type&gt; constants and getPageSize(). </translation>
2226
    </message>
2227
    <message>
14474 cbradney 2228
        <location filename="../../../scribus/plugins/scriptplugin/cmdpage.h" line="216"/>
12918 cbradney 2229
        <source>importPage(&quot;fromDoc&quot;, (pageList), [create, imortwhere, importwherePage])
2230
 
2231
Imports a set of pages (given as a tuple) from an existing document (the file name must be given). This functions maps the &quot;Page-&gt;Import&quot; dropdown menu function.
2232
fromDoc: string; the filename of the document to import pages from
2233
pageList: tuple with page numbers of pages to import
2234
create: number; 0 to replace existing pages, 1 (default) to insert new pages
2235
importWhere: number; the page number (of the current document) at which import the pages
2236
importWherePage: number; used if create==1; 0 to create pages before selected page; 1 to create pages after selected page; 2 (default) to create pages at the end of the document
2237
</source>
2238
        <translation type="unfinished"></translation>
2239
    </message>
2240
    <message>
14474 cbradney 2241
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="17"/>
12918 cbradney 2242
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
2243
 
2244
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
2245
the same as for setFillColor() and setFillShade(). See the constants for
2246
available types (FILL_&lt;type&gt;).
2247
</source>
2248
        <translation type="unfinished">setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
2249
 
2250
Asettaa liukuväritäytön kohteelle &quot;name&quot;. Värin kuvaukset ovat samat kuin
2251
setFillColor():lla ja setFillShade():lla. Katso vakiot FILL_&lt;type&gt;.</translation>
2252
    </message>
2253
    <message>
14474 cbradney 2254
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="28"/>
2255
        <source>setGradientStop(&quot;color&quot;, shade, opacity, ramppoint, [&quot;name&quot;])
2256
 
2257
Set or add a gradient stop to the gradient fill of the object &quot;name&quot; at position ramppoint.
2258
Color descriptions are the same as for setFillColor() and setFillShade(). setGradientFill()
2259
must have been called previously for the gradient fill to be visible.
2260
</source>
2261
        <translation type="unfinished"></translation>
2262
    </message>
2263
    <message>
2264
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="39"/>
12918 cbradney 2265
        <source>setFillColor(&quot;color&quot;, [&quot;name&quot;])
2266
 
2267
Sets the fill color of the object &quot;name&quot; to the color &quot;color&quot;. &quot;color&quot;
2268
is the name of one of the defined colors. If &quot;name&quot; is not given the
2269
currently selected item is used.
2270
</source>
2271
        <translation type="unfinished">setFillColor(&quot;color&quot;, [&quot;name&quot;])
2272
 
2273
Sets the fill color of the object &quot;name&quot; to the color &quot;color&quot;. &quot;color&quot;
2274
is the name of one of the defined colors. If &quot;name&quot; is not given the
2275
currently selected item is used.
2276
</translation>
2277
    </message>
2278
    <message>
14474 cbradney 2279
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="50"/>
12918 cbradney 2280
        <source>setFillTransparency(transparency, [&quot;name&quot;])
2281
 
2282
Sets the fill transparency of the object &quot;name&quot; to transparency
2283
If &quot;name&quot; is not given the currently selected item is used.
2284
</source>
2285
        <translation type="unfinished"></translation>
2286
    </message>
2287
    <message>
14474 cbradney 2288
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="60"/>
12918 cbradney 2289
        <source>setFillBlendmode(blendmode, [&quot;name&quot;])
2290
 
2291
Sets the fill blendmode of the object &quot;name&quot; to blendmode
2292
If &quot;name&quot; is not given the currently selected item is used.
2293
</source>
2294
        <translation type="unfinished"></translation>
2295
    </message>
2296
    <message>
14474 cbradney 2297
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="70"/>
12918 cbradney 2298
        <source>setLineColor(&quot;color&quot;, [&quot;name&quot;])
2299
 
2300
Sets the line color of the object &quot;name&quot; to the color &quot;color&quot;. If &quot;name&quot;
2301
is not given the currently selected item is used.
2302
</source>
2303
        <translation type="unfinished">setLineColor(&quot;color&quot;, [&quot;name&quot;])
2304
 
2305
Sets the line color of the object &quot;name&quot; to the color &quot;color&quot;. If &quot;name&quot;
2306
is not given the currently selected item is used.
2307
</translation>
2308
    </message>
2309
    <message>
14474 cbradney 2310
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="80"/>
12918 cbradney 2311
        <source>setLineTransparency(transparency, [&quot;name&quot;])
2312
 
2313
Sets the line transparency of the object &quot;name&quot; to transparency
2314
If &quot;name&quot; is not given the currently selected item is used.
2315
</source>
2316
        <translation type="unfinished"></translation>
2317
    </message>
2318
    <message>
14474 cbradney 2319
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="90"/>
12918 cbradney 2320
        <source>setLineBlendmode(blendmode, [&quot;name&quot;])
2321
 
2322
Sets the line blendmode of the object &quot;name&quot; to blendmode
2323
If &quot;name&quot; is not given the currently selected item is used.
2324
</source>
2325
        <translation type="unfinished"></translation>
2326
    </message>
2327
    <message>
14474 cbradney 2328
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="100"/>
12918 cbradney 2329
        <source>setLineWidth(width, [&quot;name&quot;])
2330
 
2331
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2332
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2333
given the currently selected item is used.
2334
 
2335
May raise ValueError if the line width is out of bounds.
2336
</source>
2337
        <translation type="unfinished">setLineWidth(width, [&quot;name&quot;])
2338
 
2339
Sets line width of the object &quot;name&quot; to &quot;width&quot;. &quot;width&quot; must be in the
2340
range from 0.0 to 12.0 inclusive, and is measured in points. If &quot;name&quot; is not
2341
given the currently selected item is used.
2342
 
2343
May raise ValueError if the line width is out of bounds.
2344
</translation>
2345
    </message>
2346
    <message>
14474 cbradney 2347
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="113"/>
12918 cbradney 2348
        <source>setLineShade(shade, [&quot;name&quot;])
2349
 
2350
Sets the shading of the line color of the object &quot;name&quot; to &quot;shade&quot;.
2351
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2352
(full color intensity). If &quot;name&quot; is not given the currently selected item
2353
is used.
2354
 
2355
May raise ValueError if the line shade is out of bounds.
2356
</source>
2357
        <translation type="unfinished">setLineShade(shade, [&quot;name&quot;])
2358
 
2359
Sets the shading of the line color of the object &quot;name&quot; to &quot;shade&quot;.
2360
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2361
(full color intensity). If &quot;name&quot; is not given the currently selected item
2362
is used.
2363
 
2364
May raise ValueError if the line shade is out of bounds.
2365
</translation>
2366
    </message>
2367
    <message>
14474 cbradney 2368
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="127"/>
12918 cbradney 2369
        <source>setLineJoin(join, [&quot;name&quot;])
2370
 
2371
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2372
If &quot;name&quot; is not given the currently selected item is used. There are
2373
predefined constants for join - JOIN_&lt;type&gt;.
2374
</source>
2375
        <translation type="unfinished">setLineJoin(join, [&quot;name&quot;])
2376
 
2377
Sets the line join style of the object &quot;name&quot; to the style &quot;join&quot;.
2378
If &quot;name&quot; is not given the currently selected item is used. There are
2379
predefined constants for join - JOIN_&lt;type&gt;.
2380
</translation>
2381
    </message>
2382
    <message>
14474 cbradney 2383
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="138"/>
12918 cbradney 2384
        <source>setLineEnd(endtype, [&quot;name&quot;])
2385
 
2386
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2387
If &quot;name&quot; is not given the currently selected item is used. There are
2388
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2389
</source>
2390
        <translation type="unfinished">setLineEnd(endtype, [&quot;name&quot;])
2391
 
2392
Sets the line cap style of the object &quot;name&quot; to the style &quot;cap&quot;.
2393
If &quot;name&quot; is not given the currently selected item is used. There are
2394
predefined constants for &quot;cap&quot; - CAP_&lt;type&gt;.
2395
</translation>
2396
    </message>
2397
    <message>
14474 cbradney 2398
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="149"/>
12918 cbradney 2399
        <source>setLineStyle(style, [&quot;name&quot;])
2400
 
2401
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2402
is not given the currently selected item is used. There are predefined
2403
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2404
</source>
2405
        <translation type="unfinished">setLineStyle(style, [&quot;name&quot;])
2406
 
2407
Sets the line style of the object &quot;name&quot; to the style &quot;style&quot;. If &quot;name&quot;
2408
is not given the currently selected item is used. There are predefined
2409
constants for &quot;style&quot; - LINE_&lt;style&gt;.
2410
</translation>
2411
    </message>
2412
    <message>
14474 cbradney 2413
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="160"/>
12918 cbradney 2414
        <source>setFillShade(shade, [&quot;name&quot;])
2415
 
2416
Sets the shading of the fill color of the object &quot;name&quot; to &quot;shade&quot;.
2417
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2418
(full Color intensity). If &quot;name&quot; is not given the currently selected
2419
Item is used.
2420
 
2421
May raise ValueError if the fill shade is out of bounds.
2422
</source>
2423
        <translation type="unfinished">setFillShade(shade, [&quot;name&quot;])
2424
 
2425
Sets the shading of the fill color of the object &quot;name&quot; to &quot;shade&quot;.
2426
&quot;shade&quot; must be an integer value in the range from 0 (lightest) to 100
2427
(full Color intensity). If &quot;name&quot; is not given the currently selected
2428
Item is used.
2429
 
2430
May raise ValueError if the fill shade is out of bounds.
2431
</translation>
2432
    </message>
2433
    <message>
14474 cbradney 2434
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="174"/>
12918 cbradney 2435
        <source>setCornerRadius(radius, [&quot;name&quot;])
2436
 
2437
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2438
in points. If &quot;name&quot; is not given the currently selected item is used.
2439
 
2440
May raise ValueError if the corner radius is negative.
2441
</source>
2442
        <translation type="unfinished">setCornerRadius(radius, [&quot;name&quot;])
2443
 
2444
 
2445
Sets the corner radius of the object &quot;name&quot;. The radius is expressed
2446
in points. If &quot;name&quot; is not given the currently selected item is used.
2447
 
2448
May raise ValueError if the corner radius is negative. </translation>
2449
    </message>
2450
    <message>
14474 cbradney 2451
        <location filename="../../../scribus/plugins/scriptplugin/cmdsetprop.h" line="186"/>
12918 cbradney 2452
        <source>setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2453
 
2454
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2455
If &quot;name&quot; is not given the currently selected item is used.
2456
 
2457
May raise NotFoundError if the line style doesn&apos;t exist.
2458
</source>
2459
        <translation type="unfinished">setMultiLine(&quot;namedStyle&quot;, [&quot;name&quot;])
2460
 
2461
Sets the line style of the object &quot;name&quot; to the named style &quot;namedStyle&quot;.
2462
If &quot;name&quot; is not given the currently selected item is used.
2463
 
2464
May raise NotFoundError if the line style doesn&apos;t exist.
2465
</translation>
2466
    </message>
2467
    <message>
14474 cbradney 2468
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="17"/>
12918 cbradney 2469
        <source>getFontSize([&quot;name&quot;]) -&gt; float
2470
 
2471
Returns the font size in points for the text frame &quot;name&quot;. If this text
2472
frame has some text selected the value assigned to the first character of
2473
the selection is returned.
2474
If &quot;name&quot; is not given the currently selected item is used.
2475
</source>
2476
        <translation type="unfinished">getFontSize([&quot;name&quot;]) -&gt; float
2477
 
2478
Palauttaa fontin koon pisteinä tekstikehykselle &quot;name&quot;. Jos tekstikehyksessä
2479
on tekstiä valittuna palautetaan valinnan ensimmäisen fontin koko.
2480
Jos &quot;name&quot; ei ole määritelty, käytetään valittuna olevaa kohdetta.</translation>
2481
    </message>
2482
    <message>
14474 cbradney 2483
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="29"/>
12918 cbradney 2484
        <source>getFont([&quot;name&quot;]) -&gt; string
2485
 
2486
Returns the font name for the text frame &quot;name&quot;. If this text frame
2487
has some text selected the value assigned to the first character
2488
of the selection is returned. If &quot;name&quot; is not given the currently
2489
selected item is used.
2490
</source>
2491
        <translation type="unfinished">getFont([&quot;name&quot;]) -&gt; string
2492
 
2493
Returns the font name for the text frame &quot;name&quot;. If this text frame
2494
has some text selected the value assigned to the first character
2495
of the selection is returned. If &quot;name&quot; is not given the currently
2496
selected item is used.
2497
</translation>
2498
    </message>
2499
    <message>
14474 cbradney 2500
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="41"/>
12918 cbradney 2501
        <source>getTextLength([&quot;name&quot;]) -&gt; integer
2502
 
2503
Returns the length of the text in the text frame &quot;name&quot;.
2504
If &quot;name&quot; is not given the currently selected item is used.
2505
</source>
2506
        <translation type="unfinished">getTextLength([&quot;name&quot;]) -&gt; integer
2507
 
2508
Returns the length of the text in the text frame &quot;name&quot;.
2509
If &quot;name&quot; is not given the currently selected item is used.
2510
</translation>
2511
    </message>
2512
    <message>
14474 cbradney 2513
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="51"/>
12918 cbradney 2514
        <source>getTextLines([&quot;name&quot;]) -&gt; integer
2515
 
2516
Returns the number of lines of the text in the text frame &quot;name&quot;.
2517
If &quot;name&quot; is not given the currently selected item is used.
2518
</source>
2519
        <translation type="unfinished">getTextLines([&quot;name&quot;]) -&gt; integer
2520
 
2521
Returns the number of lines of the text in the text frame &quot;name&quot;.
2522
If &quot;name&quot; is not given the currently selected item is used.
2523
</translation>
2524
    </message>
2525
    <message>
14474 cbradney 2526
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="61"/>
12918 cbradney 2527
        <source>getText([&quot;name&quot;]) -&gt; string
2528
 
2529
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2530
selected, the selected text is returned. All text in the frame, not just
2531
currently visible text, is returned. If &quot;name&quot; is not given the currently
2532
selected item is used.
2533
</source>
2534
        <translation type="unfinished">getText([&quot;name&quot;]) -&gt; string
2535
 
2536
Returns the text of the text frame &quot;name&quot;. If this text frame has some text
2537
selected, the selected text is returned. All text in the frame, not just
2538
currently visible text, is returned. If &quot;name&quot; is not given the currently
2539
selected item is used.
2540
</translation>
2541
    </message>
2542
    <message>
14474 cbradney 2543
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="73"/>
12918 cbradney 2544
        <source>getAllText([&quot;name&quot;]) -&gt; string
2545
 
2546
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2547
linked with this frame. If this textframe has some text selected, the selected
2548
text is returned. If &quot;name&quot; is not given the currently selected item is
2549
used.
2550
</source>
2551
        <translation type="unfinished">getAllText([&quot;name&quot;]) -&gt; string
2552
 
2553
 
2554
Returns the text of the text frame &quot;name&quot; and of all text frames which are
2555
linked with this frame. If this textframe has some text selected, the selected
2556
text is returned. If &quot;name&quot; is not given the currently selected item is
2557
used. </translation>
2558
    </message>
2559
    <message>
14474 cbradney 2560
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="85"/>
12918 cbradney 2561
        <source>getLineSpacing([&quot;name&quot;]) -&gt; float
2562
 
2563
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2564
points. If &quot;name&quot; is not given the currently selected item is used.
2565
</source>
2566
        <translation type="unfinished">getLineSpacing([&quot;name&quot;]) -&gt; float
2567
 
2568
Returns the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; expressed in
2569
points. If &quot;name&quot; is not given the currently selected item is used.
2570
</translation>
2571
    </message>
2572
    <message>
14474 cbradney 2573
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="95"/>
12918 cbradney 2574
        <source>getTextDistances([&quot;name&quot;]) -&gt; tuple
2575
 
2576
Returns the text distances of the text frame &quot;name&quot; expressed in points. The
2577
distances are returned as a tuple like (left, right, top, bottom). If &quot;name&quot;
2578
is not given the currently selected item is used.
2579
</source>
2580
        <translation type="unfinished"></translation>
2581
    </message>
2582
    <message>
14474 cbradney 2583
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="106"/>
12918 cbradney 2584
        <source>getColumnGap([&quot;name&quot;]) -&gt; float
2585
 
2586
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2587
&quot;name&quot; is not given the currently selected item is used.
2588
</source>
2589
        <translation type="unfinished">getColumnGap([&quot;name&quot;]) -&gt; float
2590
 
2591
Returns the column gap size of the text frame &quot;name&quot; expressed in points. If
2592
&quot;name&quot; is not given the currently selected item is used. </translation>
2593
    </message>
2594
    <message>
14474 cbradney 2595
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="116"/>
12918 cbradney 2596
        <source>getColumns([&quot;name&quot;]) -&gt; integer
2597
 
2598
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2599
given the currently selected item is used.
2600
</source>
2601
        <translation type="unfinished">getColumns([&quot;name&quot;]) -&gt; integer
2602
 
2603
Gets the number of columns of the text frame &quot;name&quot;. If &quot;name&quot; is not
2604
given the currently selected item is used. </translation>
2605
    </message>
2606
    <message>
14474 cbradney 2607
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="126"/>
12918 cbradney 2608
        <source>setText(&quot;text&quot;, [&quot;name&quot;])
2609
 
2610
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2611
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2612
for more details. If &quot;name&quot; is not given the currently selected item is
2613
used.
2614
</source>
2615
        <translation type="unfinished">setText(&quot;text&quot;, [&quot;name&quot;])
2616
 
2617
Sets the text of the text frame &quot;name&quot; to the text of the string &quot;text&quot;.
2618
Text must be UTF8 encoded - use e.g. unicode(text, &apos;iso-8859-2&apos;). See the FAQ
2619
for more details. If &quot;name&quot; is not given the currently selected item is
2620
used.
2621
</translation>
2622
    </message>
2623
    <message>
14474 cbradney 2624
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="138"/>
12918 cbradney 2625
        <source>insertText(&quot;text&quot;, pos, [&quot;name&quot;])
2626
 
2627
Inserts the text &quot;text&quot; at the position &quot;pos&quot; into the text frame &quot;name&quot;.
2628
Text must be UTF encoded (see setText() as reference) The first character has an
2629
index of 0. Inserting text at position -1 appends it to the frame. If &quot;name&quot; is
2630
not given the currently selected Item is used.
2631
 
2632
May throw IndexError for an insertion out of bounds.
2633
</source>
2634
        <translation type="unfinished"></translation>
2635
    </message>
2636
    <message>
14474 cbradney 2637
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="152"/>
12918 cbradney 2638
        <source>setFont(&quot;font&quot;, [&quot;name&quot;])
2639
 
2640
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2641
selected only the selected text is changed.  If &quot;name&quot; is not given the
2642
currently selected item is used.
2643
 
2644
May throw ValueError if the font cannot be found.
2645
</source>
2646
        <translation type="unfinished">setFont(&quot;font&quot;, [&quot;name&quot;])
2647
 
2648
Sets the font of the text frame &quot;name&quot; to &quot;font&quot;. If there is some text
2649
selected only the selected text is changed.  If &quot;name&quot; is not given the
2650
currently selected item is used.
2651
 
2652
May throw ValueError if the font cannot be found. </translation>
2653
    </message>
2654
    <message>
14474 cbradney 2655
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="165"/>
12918 cbradney 2656
        <source>setFontSize(size, [&quot;name&quot;])
2657
 
2658
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2659
as a value in points. If there is some text selected only the selected text is
2660
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2661
currently selected item is used.
2662
 
2663
May throw ValueError for a font size that&apos;s out of bounds.
2664
</source>
2665
        <translation type="unfinished">setFontSize(size, [&quot;name&quot;])
2666
 
2667
Sets the font size of the text frame &quot;name&quot; to &quot;size&quot;. &quot;size&quot; is treated
2668
as a value in points. If there is some text selected only the selected text is
2669
changed. &quot;size&quot; must be in the range 1 to 512. If &quot;name&quot; is not given the
2670
currently selected item is used.
2671
 
2672
May throw ValueError for a font size that&apos;s out of bounds. e(size, [&quot;name&quot;]).</translation>
2673
    </message>
2674
    <message>
14474 cbradney 2675
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="179"/>
12918 cbradney 2676
        <source>setLineSpacing(size, [&quot;name&quot;])
2677
 
2678
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2679
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2680
item is used.
2681
 
2682
May throw ValueError if the line spacing is out of bounds.
2683
</source>
2684
        <translation type="unfinished">setLineSpacing(size, [&quot;name&quot;])
2685
 
2686
Sets the line spacing (&quot;leading&quot;) of the text frame &quot;name&quot; to &quot;size&quot;.
2687
&quot;size&quot; is a value in points. If &quot;name&quot; is not given the currently selected
2688
item is used.
2689
 
2690
May throw ValueError if the line spacing is out of bounds. </translation>
2691
    </message>
2692
    <message>
14474 cbradney 2693
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="192"/>
2694
        <source>setLineSpacingMode(mode, [&quot;name&quot;])
2695
 
2696
Sets the line spacing mode of the text frame &quot;name&quot; to &quot;mode&quot;.
2697
If &quot;name&quot; is not given the currently selected
2698
item is used.
2699
Mode values are the same as in createParagraphStyle.
2700
 
2701
May throw ValueError if the mode is out of bounds.
2702
</source>
2703
        <translation type="unfinished"></translation>
2704
    </message>
2705
    <message>
2706
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="206"/>
12918 cbradney 2707
        <source>setTextDistances(left, right, top, bottom, [&quot;name&quot;])
2708
 
2709
Sets the text distances of the text frame &quot;name&quot; to the values &quot;left&quot;
2710
&quot;right&quot;, &quot;top&quot; and &quot;bottom&quot;. If &quot;name&quot; is not given the currently
2711
selected item is used.
2712
 
2713
May throw ValueError if any of the distances are out of bounds (must be positive).
2714
</source>
2715
        <translation type="unfinished"></translation>
2716
    </message>
2717
    <message>
14474 cbradney 2718
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="219"/>
12918 cbradney 2719
        <source>setColumnGap(size, [&quot;name&quot;])
2720
 
2721
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2722
&quot;name&quot; is not given the currently selected item is used.
2723
 
2724
May throw ValueError if the column gap is out of bounds (must be positive).
2725
</source>
2726
        <translation type="unfinished">setColumnGap(size, [&quot;name&quot;])
2727
 
2728
Sets the column gap of the text frame &quot;name&quot; to the value &quot;size&quot;. If
2729
&quot;name&quot; is not given the currently selected item is used.
2730
 
2731
May throw ValueError if the column gap is out of bounds (must be positive). </translation>
2732
    </message>
2733
    <message>
14474 cbradney 2734
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="231"/>
12918 cbradney 2735
        <source>setColumns(nr, [&quot;name&quot;])
2736
 
2737
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2738
If &quot;name&quot; is not given the currently selected item is used.
2739
 
2740
May throw ValueError if number of columns is not at least one.
2741
</source>
2742
        <translation type="unfinished">setColumns(nr, [&quot;name&quot;])
2743
 
2744
Sets the number of columns of the text frame &quot;name&quot; to the integer &quot;nr&quot;.
2745
If &quot;name&quot; is not given the currently selected item is used.
2746
 
2747
May throw ValueError if number of columns is not at least one. </translation>
2748
    </message>
2749
    <message>
14474 cbradney 2750
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="243"/>
12918 cbradney 2751
        <source>setTextAlignment(align, [&quot;name&quot;])
2752
 
2753
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2754
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2755
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2756
 
2757
May throw ValueError for an invalid alignment constant.
2758
</source>
2759
        <translation type="unfinished">setTextAlignment(align, [&quot;name&quot;])
2760
 
2761
Sets the text alignment of the text frame &quot;name&quot; to the specified alignment.
2762
If &quot;name&quot; is not given the currently selected item is used. &quot;align&quot; should
2763
be one of the ALIGN_ constants defined in this module - see dir(scribus).
2764
 
2765
May throw ValueError for an invalid alignment constant. </translation>
2766
    </message>
2767
    <message>
14474 cbradney 2768
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="256"/>
12918 cbradney 2769
        <source>selectText(start, count, [&quot;name&quot;])
2770
 
2771
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2772
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2773
text selection will be cleared.  If &quot;name&quot; is not given the currently
2774
selected item is used.
2775
 
2776
May throw IndexError if the selection is outside the bounds of the text.
2777
</source>
2778
        <translation type="unfinished">selectText(start, count, [&quot;name&quot;])
2779
 
2780
Selects &quot;count&quot; characters of text in the text frame &quot;name&quot; starting from the
2781
character &quot;start&quot;. Character counting starts at 0. If &quot;count&quot; is zero, any
2782
text selection will be cleared.  If &quot;name&quot; is not given the currently
2783
selected item is used.
2784
 
2785
May throw IndexError if the selection is outside the bounds of the text.
2786
</translation>
2787
    </message>
2788
    <message>
14474 cbradney 2789
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="270"/>
12918 cbradney 2790
        <source>deleteText([&quot;name&quot;])
2791
 
2792
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2793
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2794
selected item is used.
2795
</source>
2796
        <translation type="unfinished">deleteText([&quot;name&quot;])
2797
 
2798
 
2799
Deletes any text in the text frame &quot;name&quot;. If there is some text selected,
2800
only the selected text will be deleted. If &quot;name&quot; is not given the currently
2801
selected item is used. </translation>
2802
    </message>
2803
    <message>
14474 cbradney 2804
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="281"/>
12918 cbradney 2805
        <source>setTextColor(&quot;color&quot;, [&quot;name&quot;])
2806
 
2807
Sets the text color of the text frame &quot;name&quot; to the color &quot;color&quot;. If there
2808
is some text selected only the selected text is changed. If &quot;name&quot; is not
2809
given the currently selected item is used.
2810
</source>
2811
        <translation type="unfinished">setTextColor(&quot;color&quot;, [&quot;name&quot;])
2812
 
2813
Sets the text color of the text frame &quot;name&quot; to the color &quot;color&quot;. If there
2814
is some text selected only the selected text is changed. If &quot;name&quot; is not
2815
given the currently selected item is used.
2816
</translation>
2817
    </message>
2818
    <message>
14474 cbradney 2819
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="292"/>
12918 cbradney 2820
        <source>setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2821
 
2822
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
2823
selected item is used.
2824
</source>
2825
        <translation type="unfinished">setTextStroke(&quot;color&quot;, [&quot;name&quot;])
2826
 
2827
Set &quot;color&quot; of the text stroke. If &quot;name&quot; is not given the currently
2828
selected item is used.
2829
</translation>
2830
    </message>
2831
    <message>
14474 cbradney 2832
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="302"/>
2833
        <source>setTextScalingV(scale, [&quot;name&quot;])
2834
 
2835
Sets the vertical character scaling of the object &quot;name&quot; to &quot;scale&quot; in percent.
2836
If &quot;name&quot; is not given the currently selected item is used.
2837
</source>
2838
        <translation type="unfinished"></translation>
2839
    </message>
2840
    <message>
2841
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="312"/>
2842
        <source>setTextScalingH(scale, [&quot;name&quot;])
2843
 
2844
Sets the horizontal character scaling of the object &quot;name&quot; to &quot;scale&quot; in percent.
2845
If &quot;name&quot; is not given the currently selected item is used.
2846
</source>
2847
        <translation type="unfinished"></translation>
2848
    </message>
2849
    <message>
2850
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="322"/>
12918 cbradney 2851
        <source>setTextShade(shade, [&quot;name&quot;])
2852
 
2853
Sets the shading of the text color of the object &quot;name&quot; to &quot;shade&quot;. If
2854
there is some text selected only the selected text is changed. &quot;shade&quot; must
2855
be an integer value in the range from 0 (lightest) to 100 (full color
2856
intensity). If &quot;name&quot; is not given the currently selected item is
2857
used.
2858
</source>
2859
        <translation type="unfinished">setTextShade(shade, [&quot;name&quot;])
2860
 
2861
Sets the shading of the text color of the object &quot;name&quot; to &quot;shade&quot;. If
2862
there is some text selected only the selected text is changed. &quot;shade&quot; must
2863
be an integer value in the range from 0 (lightest) to 100 (full color
2864
intensity). If &quot;name&quot; is not given the currently selected item is
2865
used.
2866
</translation>
2867
    </message>
2868
    <message>
14474 cbradney 2869
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="335"/>
12918 cbradney 2870
        <source>linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
2871
 
2872
Link two text frames. The frame named &quot;fromname&quot; is linked to the
2873
frame named &quot;toname&quot;. The target frame must be an empty text frame
2874
and must not link to or be linked from any other frames already.
2875
 
2876
May throw ScribusException if linking rules are violated.
2877
</source>
2878
        <translation type="unfinished">linkTextFrames(&quot;fromname&quot;, &quot;toname&quot;)
2879
 
2880
Link two text frames. The frame named &quot;fromname&quot; is linked to the
2881
frame named &quot;toname&quot;. The target frame must be an empty text frame
2882
and must not link to or be linked from any other frames already.
2883
 
2884
May throw ScribusException if linking rules are violated.
2885
</translation>
2886
    </message>
2887
    <message>
14474 cbradney 2888
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="352"/>
12918 cbradney 2889
        <source>unlinkTextFrames(&quot;name&quot;)
2890
 
2891
Remove the specified (named) object from the text frame flow/linkage. If the
2892
frame was in the middle of a chain, the previous and next frames will be
2893
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
2894
 
2895
May throw ScribusException if linking rules are violated.
2896
</source>
2897
        <translation type="unfinished">unlinkTextFrames(&quot;name&quot;)
2898
 
2899
Remove the specified (named) object from the text frame flow/linkage. If the
2900
frame was in the middle of a chain, the previous and next frames will be
2901
connected, eg &apos;a-&gt;b-&gt;c&apos; becomes &apos;a-&gt;c&apos; when you unlinkTextFrames(b)&apos;
2902
 
2903
May throw ScribusException if linking rules are violated.
2904
</translation>
2905
    </message>
2906
    <message>
14474 cbradney 2907
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="369"/>
12918 cbradney 2908
        <source>traceText([&quot;name&quot;])
2909
 
2910
Convert the text frame &quot;name&quot; to outlines. If &quot;name&quot; is not given the
2911
currently selected item is used.</source>
2912
        <translation type="unfinished">traceText([&quot;name&quot;])
2913
 
2914
Muuta tekstikehys &quot;name&quot; ääriviivoiksi. Jos nimeä ei anneta, käytetään
2915
valittuna olevaa kohdetta.</translation>
2916
    </message>
2917
    <message>
14474 cbradney 2918
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="380"/>
12918 cbradney 2919
        <source>textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
2920
 
2921
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
2922
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
2923
use text frame linking. Without this parameter it search all linking chain.
2924
 
2925
May raise WrongFrameTypeError if the target frame is not an text frame
2926
</source>
2927
        <translation type="unfinished">textOverflows([&quot;name&quot;, nolinks]) -&gt; integer
2928
 
2929
Returns the actual number of overflowing characters in text frame &quot;name&quot;.
2930
If is nolinks set to non zero value it takes only one frame - it doesn&apos;t
2931
use text frame linking. Without this parameter it search all linking chain.
2932
 
2933
May raise WrongFrameTypeError if the target frame is not an text frame
2934
</translation>
2935
    </message>
2936
    <message>
14474 cbradney 2937
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="393"/>
12918 cbradney 2938
        <source>hyphenateText([&quot;name&quot;]) -&gt; bool
2939
 
2940
Does hyphenation on text frame &quot;name&quot;.
2941
If &quot;name&quot; is not given the currently selected item is used.
2942
 
2943
May raise WrongFrameTypeError if the target frame is not a text frame
2944
</source>
2945
        <translation type="unfinished"></translation>
2946
    </message>
2947
    <message>
14474 cbradney 2948
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="407"/>
12918 cbradney 2949
        <source>dehyphenateText([&quot;name&quot;]) -&gt; bool
2950
 
2951
Does dehyphenation on text frame &quot;name&quot;.
2952
If &quot;name&quot; is not given the currently selected item is used.
2953
 
2954
May raise WrongFrameTypeError if the target frame is not a text frame
2955
</source>
2956
        <translation type="unfinished"></translation>
2957
    </message>
2958
    <message>
14474 cbradney 2959
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="422"/>
12918 cbradney 2960
        <source>setPDFBookmark(&quot;toggle&quot;, [&quot;name&quot;])
2961
 
2962
Sets whether (toggle = 1) the text frame &quot;name&quot; is a bookmark nor not.
2963
If &quot;name&quot; is not given the currently selected item is used.
2964
 
2965
May raise WrongFrameTypeError if the target frame is not a text frame
2966
</source>
2967
        <translation type="unfinished"></translation>
2968
    </message>
2969
    <message>
14474 cbradney 2970
        <location filename="../../../scribus/plugins/scriptplugin/cmdtext.h" line="434"/>
12918 cbradney 2971
        <source>isPDFBookmark([&quot;name&quot;]) -&gt; bool
2972
 
2973
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
2974
If &quot;name&quot; is not given the currently selected item is used.
2975
 
2976
May raise WrongFrameTypeError if the target frame is not a text frame
2977
</source>
2978
        <translation type="unfinished">isPDFBookmark([&quot;name&quot;]) -&gt; bool
2979
 
2980
Returns true if the text frame &quot;name&quot; is a PDF bookmark.
2981
If &quot;name&quot; is not given the currently selected item is used.
2982
 
2983
May raise WrongFrameTypeError if the target frame is not a text frame </translation>
2984
    </message>
2985
    <message>
14474 cbradney 2986
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="17"/>
12918 cbradney 2987
        <source>messagebarText(&quot;string&quot;)
2988
 
2989
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
2990
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
2991
</source>
2992
        <translation type="unfinished">messagebarText(&quot;string&quot;)
2993
 
2994
Asettaa tekstin &quot;string&quot; Scribuksen tilariville. Teksti täytyy olla UTF8 koodattu tai
2995
&apos;unicode&apos; teksti (suositeltavaa).</translation>
2996
    </message>
2997
    <message>
14474 cbradney 2998
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="30"/>
12918 cbradney 2999
        <source>progressReset()
3000
 
3001
Cleans up the Scribus progress bar previous settings. It is called before the
3002
new progress bar use. See progressSet.
3003
</source>
3004
        <translation type="unfinished">progressReset()
3005
 
3006
Tyhjentää etenemispalkin (progress bar). Katso progressSet.</translation>
3007
    </message>
3008
    <message>
14474 cbradney 3009
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="43"/>
12918 cbradney 3010
        <source>progressTotal(max)
3011
 
3012
Sets the progress bar&apos;s maximum steps value to the specified number.
3013
See progressSet.
3014
</source>
3015
        <translation type="unfinished">progressTotal(max)
3016
 
3017
Asettaa etenemispalkin suurimman mahdollisen arvon. Katso progressSet.</translation>
3018
    </message>
3019
    <message>
14474 cbradney 3020
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="52"/>
12918 cbradney 3021
        <source>progressSet(nr)
3022
 
3023
Set the progress bar position to &quot;nr&quot;, a value relative to the previously set
3024
progressTotal. The progress bar uses the concept of steps; you give it the
3025
total number of steps and the number of steps completed so far and it will
3026
display the percentage of steps that have been completed. You can specify the
3027
total number of steps with progressTotal(). The current number of steps is set
3028
with progressSet(). The progress bar can be rewound to the beginning with
3029
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]
3030
</source>
3031
        <translation type="unfinished">progressSet(nr)
3032
 
3033
Aseta etenemispalkki nr:n osoittamaan tilaan.
3034
The progress bar uses the concept of steps; you give it the
3035
total number of steps and the number of steps completed so far and it will
3036
display the percentage of steps that have been completed. You can specify the
3037
total number of steps with progressTotal(). The current number of steps is set
3038
with progressSet(). The progress bar can be rewound to the beginning with
3039
progressReset(). [based on info taken from Trolltech&apos;s Qt docs]</translation>
3040
    </message>
3041
    <message>
14474 cbradney 3042
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="66"/>
12918 cbradney 3043
        <source>setCursor()
3044
 
3045
[UNSUPPORTED!] This might break things, so steer clear for now.
3046
</source>
3047
        <translation type="unfinished">setCursor()
3048
 
3049
[Ei tuettu!] Tämä saattaa rikkoa asoita. Eli älä käytä ainakaan vielä.</translation>
3050
    </message>
3051
    <message>
14474 cbradney 3052
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="78"/>
12918 cbradney 3053
        <source>docChanged(bool)
3054
 
3055
Enable/disable save icon in the Scribus icon bar and the Save menu item. It&apos;s
3056
useful to call this procedure when you&apos;re changing the document, because Scribus
3057
won&apos;t automatically notice when you change the document using a script.
3058
</source>
3059
        <translation type="unfinished">docChanged(bool)
3060
 
3061
Ota käyttöön/Poista käytöstä tallennuskuvake työkalurivillä ja Tiedosto-valikossa.
3062
On hyvä kutsua tätä funktiota, kun olet muokannut asiakirjaa. Scribus ei huomaa
3063
automaattisesti skriptin tekemiä muutoksia.</translation>
3064
    </message>
3065
    <message>
14474 cbradney 3066
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="91"/>
12918 cbradney 3067
        <source>zoomDocument(double)
3068
 
3069
Zoom the document in main GUI window. Actions have whole number
3070
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3071
</source>
3072
        <translation type="unfinished">zoomDocument(double)
3073
 
3074
Zoom the document in main GUI window. Actions have whole number
3075
values like 20.0, 100.0, etc. Zoom to Fit uses -100 as a marker.
3076
</translation>
3077
    </message>
3078
    <message>
14474 cbradney 3079
        <location filename="../../../scribus/plugins/scriptplugin/guiapp.h" line="103"/>
12918 cbradney 3080
        <source>scrollDocument(x,y)
3081
 
3082
Scroll the document in main GUI window by x and y.
3083
</source>
3084
        <translation type="unfinished"></translation>
3085
    </message>
3086
    <message>
14474 cbradney 3087
        <location filename="../../../scribus/plugins/scriptplugin/cmdstyle.h" line="22"/>
3088
        <source>createParagraphStyle(...)
12918 cbradney 3089
 
14474 cbradney 3090
Creates a paragraph style. This function takes the following keyword parameters:
12918 cbradney 3091
 
14474 cbradney 3092
&quot;name&quot; [required] -&gt; specifies the name of the paragraphstyle to create
12918 cbradney 3093
 
14474 cbradney 3094
linespacingmode [optional] -&gt; specifies the linespacing mode; possible modes are:
12918 cbradney 3095
 
14474 cbradney 3096
fixed linespacing:          0
12918 cbradney 3097
 
14474 cbradney 3098
automatic linespacing:      1
12918 cbradney 3099
 
14474 cbradney 3100
baseline grid linespacing:  2
12918 cbradney 3101
 
14474 cbradney 3102
linespacing [optional] -&gt; specifies the linespacing if using fixed linespacing
12918 cbradney 3103
 
14474 cbradney 3104
alignment [optional] -&gt; specifies the alignment of the paragraph
13279 cbradney 3105
 
14474 cbradney 3106
-&gt; left:     0
13279 cbradney 3107
 
14474 cbradney 3108
-&gt; center:   1
13279 cbradney 3109
 
14474 cbradney 3110
-&gt; right:    2
13279 cbradney 3111
 
14474 cbradney 3112
-&gt; justify:  3
3113
 
3114
-&gt; extend:   4
3115
 
3116
leftmargin [optional], rightmargin [optional] -&gt; specify the margin
3117
 
3118
gapbefore [optional], gapafter [optional] -&gt; specify the gaps to the heading and following paragraphs
3119
 
3120
firstindent [optional] -&gt; the indent of the first line
3121
 
3122
hasdropcap [optional] -&gt; specifies if there are caps (1 = yes, 0 = no)
3123
 
3124
dropcaplines [optional] -&gt; height (in lines) of the caps if used
3125
 
3126
dropcapoffset [optional] -&gt; offset of the caps if used
3127
 
3128
&quot;charstyle&quot; [optional] -&gt; char style to use
3129
 
13279 cbradney 3130
</source>
3131
        <translation type="unfinished"></translation>
3132
    </message>
3133
    <message>
14474 cbradney 3134
        <location filename="../../../scribus/plugins/scriptplugin/cmdstyle.h" line="52"/>
3135
        <source>createCharStyle(...)
13279 cbradney 3136
 
14474 cbradney 3137
Creates a character style. This function takes the following keyword parameters:
13279 cbradney 3138
 
14474 cbradney 3139
&quot;name&quot; [required] -&gt; name of the char style to create
3140
 
3141
&quot;font&quot; [optional] -&gt; name of the font to use
3142
 
3143
fontsize [optional] -&gt; font size to set (double)
3144
 
3145
&quot;features&quot; [optional] -&gt; nearer typographic details can be defined by a string that might contain the following phrases comma-seperated (without spaces!):
3146
 
3147
-&gt; inherit
3148
 
3149
-&gt; bold
3150
 
3151
-&gt; italic
3152
 
3153
-&gt; underline
3154
 
3155
-&gt; underlinewords
3156
 
3157
-&gt; strike
3158
 
3159
-&gt; superscript
3160
 
3161
-&gt; subscript
3162
 
3163
-&gt; outline
3164
 
3165
-&gt; shadowed
3166
 
3167
-&gt; allcaps
3168
 
3169
-&gt; smallcaps
3170
 
3171
&quot;fillcolor&quot; [optional], &quot;fillshade&quot; [optional] -&gt; specify fill options
3172
 
3173
&quot;strokecolor&quot; [optional], &quot;strokeshade&quot; [optional] -&gt; specify stroke options
3174
 
3175
baselineoffset [optional] -&gt; offset of the baseline
3176
 
3177
shadowxoffset [optional], shadowyoffset [optional] -&gt; offset of the shadow if used
3178
 
3179
outlinewidth [optional] -&gt; width of the outline if used
3180
 
3181
underlineoffset [optional], underlinewidth [optional] -&gt; underline options if used
3182
 
3183
strikethruoffset [optional], strikethruwidth [optional] -&gt; strikethru options if used
3184
 
3185
scaleh [optional], scalev [optional] -&gt; scale of the chars
3186
 
3187
tracking [optional] -&gt; tracking of the text
3188
 
3189
&quot;language&quot; [optional] -&gt; language code
3190
 
13279 cbradney 3191
</source>
3192
        <translation type="unfinished"></translation>
3193
    </message>
3194
    <message>
14474 cbradney 3195
        <location filename="../../../scribus/plugins/scriptplugin/svgimport.h" line="15"/>
3196
        <source>placeSVG(&quot;filename&quot;, x, y)
13279 cbradney 3197
 
14474 cbradney 3198
Places the SVG &quot;filename&quot; onto the current page,
3199
x and y specify the coordinate of the topleft corner of the SVG placed on the page
13279 cbradney 3200
 
14474 cbradney 3201
If loading was successful, the selection contains the imported SVG
13279 cbradney 3202
</source>
3203
        <translation type="unfinished"></translation>
3204
    </message>
3205
    <message>
14474 cbradney 3206
        <location filename="../../../scribus/plugins/scriptplugin/svgimport.h" line="27"/>
3207
        <source>placeEPS(&quot;filename&quot;, x, y)
13279 cbradney 3208
 
14474 cbradney 3209
Places the EPS &quot;filename&quot; onto the current page,
3210
x and y specify the coordinate of the topleft corner of the EPS placed on the page
3211
 
3212
If loading was successful, the selection contains the imported EPS
13279 cbradney 3213
</source>
3214
        <translation type="unfinished"></translation>
3215
    </message>
3216
    <message>
14474 cbradney 3217
        <location filename="../../../scribus/plugins/scriptplugin/svgimport.h" line="39"/>
3218
        <source>placeSXD(&quot;filename&quot;, x, y)
13279 cbradney 3219
 
14474 cbradney 3220
Places the SXD &quot;filename&quot; onto the current page,
3221
x and y specify the coordinate of the topleft corner of the SXD placed on the page
3222
 
3223
If loading was successful, the selection contains the imported SXD
13279 cbradney 3224
</source>
3225
        <translation type="unfinished"></translation>
3226
    </message>
3227
    <message>
14474 cbradney 3228
        <location filename="../../../scribus/plugins/scriptplugin/svgimport.h" line="51"/>
3229
        <source>placeODG(&quot;filename&quot;, x, y)
13279 cbradney 3230
 
14474 cbradney 3231
Places the ODG &quot;filename&quot; onto the current page,
3232
x and y specify the coordinate of the topleft corner of the ODG placed on the page
3233
 
3234
If loading was successful, the selection contains the imported ODG
13279 cbradney 3235
</source>
3236
        <translation type="unfinished"></translation>
3237
    </message>
12918 cbradney 3238
</context>
3239
<context>
12281 cbradney 3240
    <name>@default</name>
1135 cbradney 3241
    <message>
12918 cbradney 3242
        <source>getColorNames() -&gt; list
1135 cbradney 3243
 
3244
Returns a list containing the names of all defined colors in the document.
3245
If no document is open, returns a list of the default document colors.
3246
</source>
12918 cbradney 3247
        <translation type="obsolete">getColorNames() -&gt; list
1135 cbradney 3248
 
3823 tsoots 3249
Returns a list containing the names of all defined colors in the document.
3250
If no document is open, returns a list of the default document colors.</translation>
1135 cbradney 3251
    </message>
3252
    <message>
12918 cbradney 3253
        <source>newDocDialog() -&gt; bool
1135 cbradney 3254
 
3255
Displays the &quot;New Document&quot; dialog box. Creates a new document if the user
3256
accepts the settings. Does not create a document if the user presses cancel.
3257
Returns true if a new document was created.
3258
</source>
12918 cbradney 3259
        <translation type="obsolete">getColorNames() -&gt; list
1135 cbradney 3260
 
3261
Näyttää dialogin &quot;Uusi asiakirja&quot;. Luo uuden asiakirjan, jos käyttäjä hyväksyy
3262
asetukset. Asiakirjaa ei luoda, jos käyttäjä painaa Peruuta-painiketta.
3263
Palauttaa true, jos uusi asiakirja luotiin.</translation>
3264
    </message>
3265
    <message>
12918 cbradney 3266
        <source>getFillColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3267
 
3268
Returns the name of the fill color of the object &quot;name&quot;.
3269
If &quot;name&quot; is not given the currently selected item is used.
3270
</source>
12918 cbradney 3271
        <translation type="obsolete">getFillColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3272
 
3273
Palauttaa täyttövärin nimen kohteelle &quot;name&quot;.
3274
Jos &quot;name&quot; ei ole annettu käytetään valittuna olevaa kohdetta.</translation>
3275
    </message>
3276
    <message>
12918 cbradney 3277
        <source>moveObject(dx, dy [, &quot;name&quot;])
1135 cbradney 3278
 
3279
Moves the object &quot;name&quot; by dx and dy relative to its current position. The
3280
distances are expressed in the current measurement unit of the document (see
3281
UNIT constants). If &quot;name&quot; is not given the currently selected item is used.
3282
If the object &quot;name&quot; belongs to a group, the whole group is moved.
3283
</source>
12918 cbradney 3284
        <translation type="obsolete">moveObject(dx, dy [, &quot;name&quot;])
1135 cbradney 3285
 
3286
Siirtää kohdetta &quot;name&quot; arvoilla dx ja dy  suhteessa nykyiseen sijaintiin. Etäisyydet
10743 tsoots 3287
ilmaistaan asiakirjassa käytössä olevalla yksiköllä (katso UNIT-vakio). Jos &quot;name&quot; ei
1135 cbradney 3288
ole määritelty, käytetään valittuna olevaa kohdetta. Jos kohde &quot;name&quot; kuuluu
3289
ryhmään, koko ryhmää siirretään.</translation>
3290
    </message>
3291
    <message>
12918 cbradney 3292
        <source>setRedraw(bool)
1135 cbradney 3293
 
3294
Disables page redraw when bool = False, otherwise redrawing is enabled.
3295
This change will persist even after the script exits, so make sure to call
3296
setRedraw(True) in a finally: clause at the top level of your script.
3297
</source>
12918 cbradney 3298
        <translation type="obsolete">setRedraw(bool)
1135 cbradney 3299
 
3300
Estää sivun uudelleenpiirron, kun bool=False. Muuten uudelleen piirto on
3301
käytössä. Tämä asetus jää voimaan vaikka skriptistä poistutaan. Varmista,
3302
että kutsut setRedraw(True) finally: -lauseessa ylimmällä tasolla skriptissäsi.</translation>
3303
    </message>
3304
    <message>
12918 cbradney 3305
        <source>createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 3306
 
3307
Creates a new rectangle on the current page and returns its name. The
3308
coordinates are given in the current measurement units of the document
3309
(see UNIT constants). &quot;name&quot; should be a unique identifier for the object
3310
because you need this name to reference that object in future. If &quot;name&quot;
3311
is not given Scribus will create one for you.
3312
 
12918 cbradney 3313
May raise NameExistsError if you explicitly pass a name that&apos;s already used.
1135 cbradney 3314
</source>
12918 cbradney 3315
        <translation type="obsolete">createRect(x, y, width, height, [&quot;name&quot;]) -&gt; string
1135 cbradney 3316
 
3317
Luo uuden nelikulmion nykyiselle sivulle ja palauttaa luodun kohteen nimen.
10743 tsoots 3318
Koordinaatit on annettava asiakirjassa käytössä olevalla yksiköllä. Katso (UNIT vakiot).
1135 cbradney 3319
&quot;name&quot;:n tulee olla yksilöllinen tunniste kohteelle, koska tarvitset nimeä myöhemmin
3320
viitatessasi nelikulmioon. Jos &quot;name&quot;:a ei anneta Scribus luo sen.
3321
 
3322
Saattaa nostaa NameExistsError:n, jos annettu nimi on jo olemassa.</translation>
3323
    </message>
3324
    <message>
12918 cbradney 3325
        <source>setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
1135 cbradney 3326
 
3327
Sets the gradient fill of the object &quot;name&quot; to type. Color descriptions are
3328
the same as for setFillColor() and setFillShade(). See the constants for
12918 cbradney 3329
available types (FILL_&lt;type&gt;).
1135 cbradney 3330
</source>
12918 cbradney 3331
        <translation type="obsolete">setGradientFill(type, &quot;color1&quot;, shade1, &quot;color2&quot;, shade2, [&quot;name&quot;])
1135 cbradney 3332
 
10743 tsoots 3333
Asettaa liukuväritäytön kohteelle &quot;name&quot;. Värin kuvaukset ovat samat kuin
12918 cbradney 3334
setFillColor():lla ja setFillShade():lla. Katso vakiot FILL_&lt;type&gt;.</translation>
1135 cbradney 3335
    </message>
3336
    <message>
12918 cbradney 3337
        <source>getFontSize([&quot;name&quot;]) -&gt; float
1135 cbradney 3338
 
3339
Returns the font size in points for the text frame &quot;name&quot;. If this text
3340
frame has some text selected the value assigned to the first character of
3341
the selection is returned.
3342
If &quot;name&quot; is not given the currently selected item is used.
3343
</source>
12918 cbradney 3344
        <translation type="obsolete">getFontSize([&quot;name&quot;]) -&gt; float
1135 cbradney 3345
 
6993 tsoots 3346
Palauttaa fontin koon pisteinä tekstikehykselle &quot;name&quot;. Jos tekstikehyksessä
3347
on tekstiä valittuna palautetaan valinnan ensimmäisen fontin koko.
1135 cbradney 3348
Jos &quot;name&quot; ei ole määritelty, käytetään valittuna olevaa kohdetta.</translation>
3349
    </message>
3350
    <message>
12918 cbradney 3351
        <source>messagebarText(&quot;string&quot;)
1135 cbradney 3352
 
3353
Writes the &quot;string&quot; into the Scribus message bar (status line). The text
12918 cbradney 3354
must be UTF8 encoded or &apos;unicode&apos; string(recommended).
1135 cbradney 3355
</source>
12918 cbradney 3356
        <translation type="obsolete">messagebarText(&quot;string&quot;)
1135 cbradney 3357
 
3358
Asettaa tekstin &quot;string&quot; Scribuksen tilariville. Teksti täytyy olla UTF8 koodattu tai
12918 cbradney 3359
&apos;unicode&apos; teksti (suositeltavaa).</translation>
1135 cbradney 3360
    </message>
1525 cbradney 3361
    <message>
12918 cbradney 3362
        <source>newPage(where [,&quot;masterpage&quot;])
1525 cbradney 3363
 
3823 tsoots 3364
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3365
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3366
counted from 1 upwards, no matter what the displayed first page number of your
3367
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3368
master page for the new page.
3369
 
3370
May raise IndexError if the page number is out of range
2147 cbradney 3371
</source>
12918 cbradney 3372
        <translation type="obsolete">newPage(where [,&quot;masterpage&quot;])
1525 cbradney 3373
 
3823 tsoots 3374
Creates a new page. If &quot;where&quot; is -1 the new Page is appended to the
3375
document, otherwise the new page is inserted before &quot;where&quot;. Page numbers are
3376
counted from 1 upwards, no matter what the displayed first page number of your
3377
document is. The optional parameter &quot;masterpage&quot; specifies the name of the
3378
master page for the new page.
3379
 
3380
May raise IndexError if the page number is out of range
3381
</translation>
1525 cbradney 3382
    </message>
3064 cbradney 3383
    <message>
12918 cbradney 3384
        <source>newDocument(size, margins, orientation, firstPageNumber,
3385
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
3064 cbradney 3386
 
3387
Creates a new document and returns true if successful. The parameters have the
3388
following meaning:
3389
 
3823 tsoots 3390
size = A tuple (width, height) describing the size of the document. You can
12918 cbradney 3391
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
3064 cbradney 3392
 
3823 tsoots 3393
margins = A tuple (left, right, top, bottom) describing the document
3394
margins
3064 cbradney 3395
 
3823 tsoots 3396
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3064 cbradney 3397
 
3823 tsoots 3398
firstPageNumer = is the number of the first page in the document used for
12918 cbradney 3399
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3400
numbers if you&apos;re creating a document in several parts.
3064 cbradney 3401
 
3823 tsoots 3402
unit: this value sets the measurement units used by the document. Use a
3403
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3404
UNIT_PICAS, UNIT_POINTS.
3064 cbradney 3405
 
3823 tsoots 3406
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3407
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3408
PAGE_4 is 4-fold.
3064 cbradney 3409
 
3823 tsoots 3410
firstPageOrder = What is position of first page in the document.
3411
Indexed from 0 (0 = first).
3064 cbradney 3412
 
6993 tsoots 3413
numPage = Number of pages to be created.
3414
 
3064 cbradney 3415
The values for width, height and the margins are expressed in the given unit
3416
for the document. PAPER_* constants are expressed in points. If your document
3417
is not in points, make sure to account for this.
3418
 
3823 tsoots 3419
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
6993 tsoots 3420
PAGE_4, 3, 1)
3823 tsoots 3421
 
3422
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
3064 cbradney 3423
</source>
12918 cbradney 3424
        <translation type="obsolete">newDocument(size, margins, orientation, firstPageNumber,
3425
                        unit, pagesType, firstPageOrder, numPages) -&gt; bool
3064 cbradney 3426
 
3823 tsoots 3427
Creates a new document and returns true if successful. The parameters have the
3428
following meaning:
3064 cbradney 3429
 
3823 tsoots 3430
size = A tuple (width, height) describing the size of the document. You can
12918 cbradney 3431
use predefined constants named PAPER_&lt;paper_type&gt; e.g. PAPER_A4 etc.
3064 cbradney 3432
 
3823 tsoots 3433
margins = A tuple (left, right, top, bottom) describing the document
3434
margins
3435
 
3436
orientation = the page orientation - constants PORTRAIT, LANDSCAPE
3437
 
3438
firstPageNumer = is the number of the first page in the document used for
12918 cbradney 3439
pagenumbering. While you&apos;ll usually want 1, it&apos;s useful to have higher
3440
numbers if you&apos;re creating a document in several parts.
3823 tsoots 3441
 
3442
unit: this value sets the measurement units used by the document. Use a
3443
predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
3444
UNIT_PICAS, UNIT_POINTS.
3445
 
3446
pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
3447
PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
3448
PAGE_4 is 4-fold.
3449
 
3450
firstPageOrder = What is position of first page in the document.
3451
Indexed from 0 (0 = first).
3452
 
6434 cbradney 3453
numPage = Number of pages to be created.
3454
 
3455
The values for width, height and the margins are expressed in the given unit
3456
for the document. PAPER_* constants are expressed in points. If your document
3457
is not in points, make sure to account for this.
3458
 
3459
example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
3460
PAGE_4, 3, 1)
3461
 
3462
May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
6993 tsoots 3463
</translation>
6434 cbradney 3464
    </message>
1135 cbradney 3465
    <message>
12918 cbradney 3466
        <source>getColor(&quot;name&quot;) -&gt; tuple
1135 cbradney 3467
 
3468
Returns a tuple (C, M, Y, K) containing the four color components of the
3469
color &quot;name&quot; from the current document. If no document is open, returns
3470
the value of the named color from the default document colors.
3471
 
12918 cbradney 3472
May raise NotFoundError if the named color wasn&apos;t found.
1135 cbradney 3473
May raise ValueError if an invalid color name is specified.
3474
</source>
12918 cbradney 3475
        <translation type="obsolete">getColor(&quot;name&quot;) -&gt; tuple
1135 cbradney 3476
 
3477
Palauttaa tuplen (C, M, Y, K) värille &quot;name&quot; nykyisestä asiakirjasta. Jos asiakirjaa
3478
ei ole avoinna, palauttaa värin oletusväreistä.
3479
 
3480
Saattaa nostaa NotFoundError:n, jos väriä ei löydy.
3481
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3482
    </message>
3483
    <message>
12918 cbradney 3484
        <source>changeColor(&quot;name&quot;, c, m, y, k)
1135 cbradney 3485
 
3486
Changes the color &quot;name&quot; to the specified CMYK value. The color value is
3487
defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
3488
Color components should be in the range from 0 to 255.
3489
 
12918 cbradney 3490
May raise NotFoundError if the named color wasn&apos;t found.
1135 cbradney 3491
May raise ValueError if an invalid color name is specified.
3492
</source>
12918 cbradney 3493
        <translation type="obsolete">changeColor(&quot;name&quot;, c, m, y, k)
1135 cbradney 3494
 
3495
Vaihtaa värin &quot;name&quot; vastaamaan väriä c, m, y, k (kaikki määritelty välillä 0, 255).</translation>
3496
    </message>
3497
    <message>
12918 cbradney 3498
        <source>deleteColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3499
 
3500
Deletes the color &quot;name&quot;. Every occurence of that color is replaced by the
3501
color &quot;replace&quot;. If not specified, &quot;replace&quot; defaults to the color
3502
&quot;None&quot; - transparent.
3503
 
3504
deleteColor works on the default document colors if there is no document open.
3505
In that case, &quot;replace&quot;, if specified, has no effect.
3506
 
12918 cbradney 3507
May raise NotFoundError if a named color wasn&apos;t found.
1135 cbradney 3508
May raise ValueError if an invalid color name is specified.
3509
</source>
12918 cbradney 3510
        <translation type="obsolete">deleteColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3511
 
3512
Poistaa värin &quot;nimi&quot;, joka korvataan värillä &quot;replace&quot;. Oletuksena &quot;replace&quot; on None (läpinäkyvä).
3513
 
3514
deleteColors toimii asiakirjassa määritellyillä väreillä, asiakirja on avoinna.
3515
 
3516
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
3517
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3518
    </message>
3519
    <message>
12918 cbradney 3520
        <source>replaceColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3521
 
3522
Every occurence of the color &quot;name&quot; is replaced by the color &quot;replace&quot;.
3523
 
12918 cbradney 3524
May raise NotFoundError if a named color wasn&apos;t found.
1135 cbradney 3525
May raise ValueError if an invalid color name is specified.
3526
</source>
12918 cbradney 3527
        <translation type="obsolete">replaceColor(&quot;name&quot;, &quot;replace&quot;)
1135 cbradney 3528
 
3529
Jokainen ilmentymä väristä &quot;name&quot; korvataan värillä &quot;replace&quot;.
3530
 
3531
Saattaa nostaa NotFoundError:n, jos nimettyä väriä ei löydy.
3532
Saattaa nostaa ValueError:n, jos värin nimi on viallinen.</translation>
3533
    </message>
3534
    <message>
12918 cbradney 3535
        <source>messageBox(&quot;caption&quot;, &quot;message&quot;,
1135 cbradney 3536
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
12918 cbradney 3537
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
1135 cbradney 3538
 
3539
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3540
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3541
button, OK, is displayed. Only the caption and message arguments are required,
3542
though setting an icon and appropriate button(s) is strongly
3543
recommended. The message text may contain simple HTML-like markup.
3544
 
3545
Returns the number of the button the user pressed. Button numbers start
3546
at 1.
3547
 
3548
For the icon and the button parameters there are predefined constants available
3549
with the same names as in the Qt Documentation. These are the BUTTON_* and
3550
ICON_* constants defined in the module. There are also two extra constants that
3551
can be binary-ORed with button constants:
3552
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3553
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3554
 
3555
Usage examples:
12918 cbradney 3556
result = messageBox(&apos;Script failed&apos;,
3557
                    &apos;This script only works when you have a text frame selected.&apos;,
1135 cbradney 3558
                    ICON_ERROR)
12918 cbradney 3559
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
1135 cbradney 3560
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3561
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3562
 
3563
Defined button and icon constants:
3564
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3565
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3566
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
3567
</source>
12918 cbradney 3568
        <translation type="obsolete">messageBox(&quot;caption&quot;, &quot;message&quot;,
2147 cbradney 3569
    icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
12918 cbradney 3570
    button2=BUTTON_NONE, button3=BUTTON_NONE) -&gt; integer
2147 cbradney 3571
 
3572
Displays a message box with the title &quot;caption&quot;, the message &quot;message&quot;, and
3573
an icon &quot;icon&quot; and up to 3 buttons. By default no icon is used and a single
3574
button, OK, is displayed. Only the caption and message arguments are required,
3575
though setting an icon and appropriate button(s) is strongly
3576
recommended. The message text may contain simple HTML-like markup.
3577
 
3578
Returns the number of the button the user pressed. Button numbers start
3579
at 1.
3580
 
3581
For the icon and the button parameters there are predefined constants available
3582
with the same names as in the Qt Documentation. These are the BUTTON_* and
3583
ICON_* constants defined in the module. There are also two extra constants that
3584
can be binary-ORed with button constants:
3585
    BUTTONOPT_DEFAULT   Pressing enter presses this button.
3586
    BUTTONOPT_ESCAPE    Pressing escape presses this button.
3587
 
3588
Usage examples:
12918 cbradney 3589
result = messageBox(&apos;Script failed&apos;,
3590
                    &apos;This script only works when you have a text frame selected.&apos;,
2147 cbradney 3591
                    ICON_ERROR)
12918 cbradney 3592
result = messageBox(&apos;Monkeys!&apos;, &apos;Something went ook! &lt;i&gt;Was it a monkey?&lt;/i&gt;&apos;,
2147 cbradney 3593
                    ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
3594
                    BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
3595
 
3596
Defined button and icon constants:
3597
BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
3598
BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
3599
ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.</translation>
1135 cbradney 3600
    </message>
3601
    <message>
12918 cbradney 3602
        <source>valueDialog(caption, message [,defaultvalue]) -&gt; string
1135 cbradney 3603
 
12918 cbradney 3604
Shows the common &apos;Ask for string&apos; dialog and returns its value as a string
3605
Parameters: window title, text in the window and optional &apos;default&apos; value.
1135 cbradney 3606
 
12918 cbradney 3607
Example: valueDialog(&apos;title&apos;, &apos;text in the window&apos;, &apos;optional&apos;)
1135 cbradney 3608
</source>
12918 cbradney 3609
        <translation type="obsolete">valueDialog(caption, message [,defaultvalue]) -&gt; string
1135 cbradney 3610
 
3611
Näyttää yleisen &quot;Kysy string&quot;-dialogin ja palauttaa sen arvon. Parametrit: ikkunan
3612
otsikko, ikkunan teksti ja oletusarvo</translation>
3613
    </message>
3614
    <message>
12918 cbradney 3615
        <source>closeDoc()
1135 cbradney 3616
 
3617
Closes the current document without prompting to save.
3618
 
3619
May throw NoDocOpenError if there is no document to close
3620
</source>
12918 cbradney 3621
        <translation type="obsolete">closeDoc()
1135 cbradney 3622
 
3623
Sulkee aktiivisen asiakirjan, ilman tallennusdialogia.
3624
 
3625
Saattaa heittää NoDocOpenError, jos suljettavia asiakirjoja ei ole</translation>
3626
    </message>
3627
    <message>
12918 cbradney 3628
        <source>haveDoc() -&gt; bool
1135 cbradney 3629
 
3630
Returns true if there is a document open.
3631
</source>
12918 cbradney 3632
        <translation type="obsolete">haveDoc() -&gt; bool
1135 cbradney 3633
 
3634
Palauttaa true, jos yksikin asiakirja on avoinna.</translation>
3635
    </message>
3636
    <message>
12918 cbradney 3637
        <source>openDoc(&quot;name&quot;)
1135 cbradney 3638
 
3639
Opens the document &quot;name&quot;.
3640
 
3641
May raise ScribusError if the document could not be opened.
3642
</source>
12918 cbradney 3643
        <translation type="obsolete">openDoc(&quot;name&quot;)
1135 cbradney 3644
 
3645
Avaa asiakirjan &quot;name&quot;.
3646
 
3647
Saattaa aiheuttaa ScribusErrorin, jos asiakirjaa ei voida avata.</translation>
3648
    </message>
3649
    <message>
12918 cbradney 3650
        <source>saveDoc()
1135 cbradney 3651
 
3652
Saves the current document with its current name, returns true if successful.
3653
If the document has not already been saved, this may bring up an interactive
3654
save file dialog.
3655
 
3656
If the save fails, there is currently no way to tell.
3657
</source>
12918 cbradney 3658
        <translation type="obsolete">saveDoc()
1135 cbradney 3659
 
3660
Tallennusdialogi. Tallennuksen epäonnistumista ei voi tällä hetkellä päätellä mistään.</translation>
3661
    </message>
3662
    <message>
12918 cbradney 3663
        <source>saveDocAs(&quot;name&quot;)
1135 cbradney 3664
 
3665
Saves the current document under the new name &quot;name&quot; (which may be a full or
3666
relative path).
3667
 
3668
May raise ScribusError if the save fails.
3669
</source>
12918 cbradney 3670
        <translation type="obsolete">saveDocAs(&quot;name&quot;)
1135 cbradney 3671
 
3672
Tallentaa aktiivisen asiakirjan nimellä &quot;nimi&quot;, joka voi olla täydellinen tai suhteellinen polku.
3673
 
3674
Saattaa aiheuttaa ScribusError:n, jos tallennus epäonnistuu.</translation>
3675
    </message>
3676
    <message>
12918 cbradney 3677
        <source>setUnit(type)
1135 cbradney 3678
 
3679
Changes the measurement unit of the document. Possible values for &quot;unit&quot; are
12918 cbradney 3680
defined as constants UNIT_&lt;type&gt;.
1135 cbradney 3681
 
3682
May raise ValueError if an invalid unit is passed.
3683
</source>
12918 cbradney 3684
        <translation type="obsolete">setUnit(type)
1135 cbradney 3685
 
12918 cbradney 3686
Vaihtaa asiakirjan mittayksikköä. Mahdolliset yksiköt on määritelty vakiona UNIT_&lt;type&gt;.
1135 cbradney 3687
 
3688
Saattaa aiheuttaa ValueError:n, jos käytetään virheellistä yksikköä.</translation>
3689
    </message>
3690
    <message>
12918 cbradney 3691
        <source>getUnit() -&gt; integer (Scribus unit constant)
1135 cbradney 3692
 
3693
Returns the measurement units of the document. The returned value will be one
3694
of the UNIT_* constants:
3695
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3696
</source>
12918 cbradney 3697
        <translation type="obsolete">getUnit() -&gt; integer (Scribus unit constant)
1135 cbradney 3698
 
3699
Palauttaa asiakirjan mittayksikön. Arvo on yksi UNIT_* vakioista.
3700
UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
3701
</translation>
3702
    </message>
3703
    <message>
12918 cbradney 3704
        <source>loadStylesFromFile(&quot;filename&quot;)
1135 cbradney 3705
 
3706
Loads paragraph styles from the Scribus document at &quot;filename&quot; into the
3707
current document.
3708
</source>
12918 cbradney 3709
        <translation type="obsolete">loadStylesFromFile(&quot;filename&quot;)
1135 cbradney 3710
 
3711
Lataa kappaletyylit Scribus-asiakirjasta &quot;filename&quot; aktiiviseen asiakirjaan.</translation>
3712
    </message>
3713
    <message>
12918 cbradney 3714
        <source>setDocType(facingPages, firstPageLeft)
1135 cbradney 3715
 
3716
Sets the document type. To get facing pages set the first parameter to
3717
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3718
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3719
a right page use FIRSTPAGERIGHT.
3720
</source>
12918 cbradney 3721
        <translation type="obsolete">setDocType(facingPages, firstPageLeft)
2147 cbradney 3722
 
3723
Sets the document type. To get facing pages set the first parameter to
3724
FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead.  If you want
3725
to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
3726
a right page use FIRSTPAGERIGHT.
1135 cbradney 3727
 
3728
</translation>
3729
    </message>
3730
    <message>
12918 cbradney 3731
        <source>getLineColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3732
 
3733
Returns the name of the line color of the object &quot;name&quot;.
3734
If &quot;name&quot; is not given the currently selected item is used.
3735
</source>
12918 cbradney 3736
        <translation type="obsolete">getLineColor([&quot;name&quot;]) -&gt; string
1135 cbradney 3737
 
3738
Palauttaa kohteen &quot;name&quot; viivan värin. Ilman &quot;name&quot;:a palauttaa
3739
valittuna olevan kohteen kehyksen värin.</translation>
3740
    </message>
3741
    <message>
12918 cbradney 3742
        <source>getLineWidth([&quot;name&quot;]) -&gt; integer
1135 cbradney 3743
 
3744
Returns the line width of the object &quot;name&quot;. If &quot;name&quot;
3745
is not given the currently selected Item is used.
3746
</source>
12918 cbradney 3747
        <translation type="obsolete">getLineWidth([&quot;name&quot;]) -&gt; integer
1135 cbradney 3748
 
3749
Palauttaa kohteen &quot;name&quot; viivan leveyden. Jos &quot;name&quot;:a
3750
ei anneta käytetään valittuna olevaa kohdetta.</translation>
3751
    </message>
3752
    <message>
12918 cbradney 3753
        <source>getLineShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3754
 
3755
Returns the shading value of the line color of the object &quot;name&quot;.
3756
If &quot;name&quot; is not given the currently selected item is used.
3757
</source>
12918 cbradney 3758
        <translation type="obsolete">getLineShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3759
 
3760
Palauttaa kohteen &quot;name&quot; viivan värin sävyn. Jos &quot;name&quot;:a ei
3761
anneta käytetään valittuna olevaa kohdetta.</translation>
3762
    </message>
3763
    <message>
12918 cbradney 3764
        <source>getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
1135 cbradney 3765
 
3766
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3767
currently selected item is used. The cap types are:
3768
CAP_FLAT, CAP_ROUND, CAP_SQUARE
3769
</source>
12918 cbradney 3770
        <translation type="obsolete">getLineEnd([&quot;name&quot;]) -&gt; integer (see constants)
2147 cbradney 3771
 
3772
Returns the line cap style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3773
currently selected item is used. The cap types are:
3774
CAP_FLAT, CAP_ROUND, CAP_SQUARE </translation>
1135 cbradney 3775
    </message>
3776
    <message>
12918 cbradney 3777
        <source>getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
1135 cbradney 3778
 
3779
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3780
currently selected item is used. Line style constants are:
3781
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
3782
</source>
12918 cbradney 3783
        <translation type="obsolete">getLineStyle([&quot;name&quot;]) -&gt; integer (see constants)
2147 cbradney 3784
 
3785
Returns the line style of the object &quot;name&quot;. If &quot;name&quot; is not given the
3786
currently selected item is used. Line style constants are:
3787
LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
1135 cbradney 3788
</translation>
3789
    </message>
3790
    <message>
12918 cbradney 3791
        <source>getFillShade([&quot;name&quot;]) -&gt; integer
1135 cbradney 3792
 
3793
Returns the shading value of the fill color of the object &quot;name&quot;.
3794
If &quot;name&quot; is not given the currently selected item is used.
3795
</source>
12918 cbradney 3796
        <translation type="obsolete">getFillShade([&quot;name&quot;]) -&gt; integer
2147 cbradney 3797
 
3798
Returns the shading value of the fill color of the object &quot;name&quot;.
3799
If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3800
</translation>
3801
    </message>
3802
    <message>
12918 cbradney 3803
        <source>getImageScale([&quot;name&quot;]) -&gt; (x,y)
1135 cbradney 3804
 
3805
Returns a (x, y) tuple containing the scaling values of the image frame
3806
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
3807
</source>
12918 cbradney 3808
        <translation type="obsolete">getImageScale([&quot;name&quot;]) -&gt; (x,y)
2147 cbradney 3809
 
3810
Returns a (x, y) tuple containing the scaling values of the image frame
3811
&quot;name&quot;.  If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3812
</translation>
3813
    </message>
3814
    <message>
12918 cbradney 3815
        <source>getImageName([&quot;name&quot;]) -&gt; string
1135 cbradney 3816
 
3817
Returns the filename for the image in the image frame. If &quot;name&quot; is not
3818
given the currently selected item is used.
3819
</source>
12918 cbradney 3820
        <translation type="obsolete">getImageName([&quot;name&quot;]) -&gt; string
2147 cbradney 3821
 
3822
Returns the filename for the image in the image frame. If &quot;name&quot; is not
3823
given the currently selected item is used.
1135 cbradney 3824
</translation>
3825
    </message>
3826
    <message>
12918 cbradney 3827
        <source>getSize([&quot;name&quot;]) -&gt; (width,height)
1135 cbradney 3828
 
3829
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
3830
If &quot;name&quot; is not given the currently selected item is used. The size is
12918 cbradney 3831
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
1135 cbradney 3832
for reference.
3833
</source>
12918 cbradney 3834
        <translation type="obsolete">getSize([&quot;name&quot;]) -&gt; (width,height)
2147 cbradney 3835
 
3836
Returns a (width, height) tuple with the size of the object &quot;name&quot;.
3837
If &quot;name&quot; is not given the currently selected item is used. The size is
12918 cbradney 3838
expressed in the current measurement unit of the document - see UNIT_&lt;type&gt;
2147 cbradney 3839
for reference.
1135 cbradney 3840
</translation>
3841
    </message>
3842
    <message>
12918 cbradney 3843
        <source>getRotation([&quot;name&quot;]) -&gt; integer
1135 cbradney 3844
 
3845
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
3846
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
3847
is used.
3848
</source>
12918 cbradney 3849
        <translation type="obsolete">getRotation([&quot;name&quot;]) -&gt; integer
1135 cbradney 3850
 
2147 cbradney 3851
Returns the rotation of the object &quot;name&quot;. The value is expressed in degrees,
3852
and clockwise is positive. If &quot;name&quot; is not given the currently selected item
3853
is used.</translation>
1135 cbradney 3854
    </message>
3855
    <message>
12918 cbradney 3856
        <source>getAllObjects() -&gt; list
1135 cbradney 3857
 
3858
Returns a list containing the names of all objects on the current page.
3859
</source>
12918 cbradney 3860
        <translation type="obsolete">getAllObjects() -&gt; list
1135 cbradney 3861
 
2147 cbradney 3862
Returns a list containing the names of all objects on the current page.</translation>
1135 cbradney 3863
    </message>
3864
    <message>
12918 cbradney 3865
        <source>moveObjectAbs(x, y [, &quot;name&quot;])
1135 cbradney 3866
 
3867
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
3868
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
3869
is not given the currently selected item is used.  If the object &quot;name&quot;
3870
belongs to a group, the whole group is moved.
3871
</source>
12918 cbradney 3872
        <translation type="obsolete">moveObjectAbs(x, y [, &quot;name&quot;])
2147 cbradney 3873
 
3874
Moves the object &quot;name&quot; to a new location. The coordinates are expressed in
3875
the current measurement unit of the document (see UNIT constants).  If &quot;name&quot;
3876
is not given the currently selected item is used.  If the object &quot;name&quot;
3877
belongs to a group, the whole group is moved.
1135 cbradney 3878
</translation>
3879
    </message>
3880
    <message>
12918 cbradney 3881
        <source>sizeObject(width, height [, &quot;name&quot;])
1135 cbradney 3882
 
3883
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
3884
is not given the currently selected item is used.
3885
</source>
12918 cbradney 3886
        <translation type="obsolete">sizeObject(width, height [, &quot;name&quot;])
2147 cbradney 3887
 
3888
Resizes the object &quot;name&quot; to the given width and height. If &quot;name&quot;
3889
is not given the currently selected item is used.
1135 cbradney 3890
</translation>
3891
    </message>
3892
    <message>
12918 cbradney 3893
        <source>getSelectedObject([nr]) -&gt; string
1135 cbradney 3894
 
3895
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
3896
of the selected object, e.g. 0 means the first selected object, 1 means the
3897
second selected Object and so on.
3898
</source>
12918 cbradney 3899
        <translation type="obsolete">getSelectedObject([nr]) -&gt; string
2147 cbradney 3900
 
3901
Returns the name of the selected object. &quot;nr&quot; if given indicates the number
3902
of the selected object, e.g. 0 means the first selected object, 1 means the
3903
second selected Object and so on.
1135 cbradney 3904
</translation>
3905
    </message>
3906
    <message>
12918 cbradney 3907
        <source>selectionCount() -&gt; integer
1135 cbradney 3908
 
3909
Returns the number of selected objects.
3910
</source>
12918 cbradney 3911
        <translation type="obsolete">selectionCount() -&gt; integer
2147 cbradney 3912
 
3913
Returns the number of selected objects.
1135 cbradney 3914
</translation>
3915
    </message>
3916
    <message>
12918 cbradney 3917
        <source>selectObject(&quot;name&quot;)
1135 cbradney 3918
 
3919
Selects the object with the given &quot;name&quot;.
3920
</source>
12918 cbradney 3921
        <translation type="obsolete">selectObject(&quot;name&quot;)
2147 cbradney 3922
 
3923
Selects the object with the given &quot;name&quot;.
1135 cbradney 3924
</translation>
3925
    </message>
3926
    <message>
12918 cbradney 3927
        <source>deselectAll()
1135 cbradney 3928
 
3929
Deselects all objects in the whole document.
3930
</source>
12918 cbradney 3931
        <translation type="obsolete">deselectAll()
2147 cbradney 3932
 
3933
Deselects all objects in the whole document.
1135 cbradney 3934
</translation>
3935
    </message>
3936
    <message>
12918 cbradney 3937
        <source>groupObjects(list)
1135 cbradney 3938
 
3939
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
3940
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
3941
items are used.
3942
</source>
12918 cbradney 3943
        <translation type="obsolete">groupObjects(list)
2147 cbradney 3944
 
3945
Groups the objects named in &quot;list&quot; together. &quot;list&quot; must contain the names
3946
of the objects to be grouped. If &quot;list&quot; is not given the currently selected
3947
items are used.
1135 cbradney 3948
</translation>
3949
    </message>
3950
    <message>
12918 cbradney 3951
        <source>unGroupObjects(&quot;name&quot;)
1135 cbradney 3952
 
3953
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.</source>
12918 cbradney 3954
        <translation type="obsolete">unGroupObjects(&quot;name&quot;)
2147 cbradney 3955
 
3956
Destructs the group the object &quot;name&quot; belongs to.If &quot;name&quot; is not given the currently selected item is used.
1135 cbradney 3957
</translation>
3958
    </message>
3959
    <message>
12918 cbradney 3960
        <source>scaleGroup(factor [,&quot;name&quot;])
1135 cbradney 3961
 
3962
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
3963
the group, values smaller than 1 make the group smaller e.g a value of 0.5
3964
scales the group to 50 % of its original size, a value of 1.5 scales the group
3965
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
3966
0. If &quot;name&quot; is not given the currently selected item is used.
3967
 
3968
May raise ValueError if an invalid scale factor is passed.
3969
</source>
12918 cbradney 3970
        <translation type="obsolete">scaleGroup(factor [,&quot;name&quot;])
2147 cbradney 3971
 
3972
Scales the group the object &quot;name&quot; belongs to. Values greater than 1 enlarge
3973
the group, values smaller than 1 make the group smaller e.g a value of 0.5
3974
scales the group to 50 % of its original size, a value of 1.5 scales the group
3975
to 150 % of its original size.  The value for &quot;factor&quot; must be greater than
3976
0. If &quot;name&quot; is not given the currently selected item is used.
3977
 
3978
May raise ValueError if an invalid scale factor is passed.
1135 cbradney 3979
</translation>
3980
    </message>
3981
    <message>
12918 cbradney 3982
        <source>loadImage(&quot;filename&quot; [, &quot;name&quot;])
1135 cbradney 3983