Subversion Repositories Scribus

Rev

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

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