Subversion Repositories Scribus

Rev

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

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