Subversion Repositories Scribus

Rev

Rev 13027 | Rev 13409 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

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