"SfR Fresh" - the SfR Freeware/Shareware Archive 
Member "scribus-1.3.3.12/scribus/po/scribus.tr.ts" of archive scribus-1.3.3.12.tar.gz:
As a special service "SfR Fresh" has tried to format the requested source page into HTML format using source code syntax highlighting with prefixed line numbers.
Alternatively you can here view or download the uninterpreted source code file.
That can be also achieved for any archive member file by clicking within an archive contents listing on the first character of the file(path) respectively on the according byte size field.
1 <!DOCTYPE TS><TS>
2 <context>
3 <name></name>
4 <message>
5 <source>getColorNames() -> list
6
7 Returns a list containing the names of all defined colors in the document.
8 If no document is open, returns a list of the default document colors.
9 </source>
10 <translation>getColorNames() -> list
11
12 Returns a list containing the names of all defined colours in the document.
13 If no document is open, returns a list of the default document colours.
14 </translation>
15 </message>
16 <message>
17 <source>newDocDialog() -> bool
18
19 Displays the "New Document" dialog box. Creates a new document if the user
20 accepts the settings. Does not create a document if the user presses cancel.
21 Returns true if a new document was created.
22 </source>
23 <translation>newDocDialog() -> bool
24
25 Displays the "New Document" dialog box. Creates a new document if the user
26 accepts the settings. Does not create a document if the user presses cancel.
27 Returns true if a new document was created.
28 </translation>
29 </message>
30 <message>
31 <source>getFillColor(["name"]) -> string
32
33 Returns the name of the fill color of the object "name".
34 If "name" is not given the currently selected item is used.
35 </source>
36 <translation>getFillColor(["name"]) -> string
37
38 Returns the name of the fill colour of the object "name".
39 If "name" is not given the currently selected item is used.
40 </translation>
41 </message>
42 <message>
43 <source>moveObject(dx, dy [, "name"])
44
45 Moves the object "name" by dx and dy relative to its current position. The
46 distances are expressed in the current measurement unit of the document (see
47 UNIT constants). If "name" is not given the currently selected item is used.
48 If the object "name" belongs to a group, the whole group is moved.
49 </source>
50 <translation>moveObject(dx, dy [, "name"])
51
52 Moves the object "name" by dx and dy relative to its current position. The
53 distances are expressed in the current measurement unit of the document (see
54 UNIT constants). If "name" is not given the currently selected item is used.
55 If the object "name" belongs to a group, the whole group is moved.
56 </translation>
57 </message>
58 <message>
59 <source>setRedraw(bool)
60
61 Disables page redraw when bool = False, otherwise redrawing is enabled.
62 This change will persist even after the script exits, so make sure to call
63 setRedraw(True) in a finally: clause at the top level of your script.
64 </source>
65 <translation>setRedraw(bool)
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 </translation>
71 </message>
72 <message>
73 <source>createRect(x, y, width, height, ["name"]) -> string
74
75 Creates a new rectangle on the current page and returns its name. The
76 coordinates are given in the current measurement units of the document
77 (see UNIT constants). "name" should be a unique identifier for the object
78 because you need this name to reference that object in future. If "name"
79 is not given Scribus will create one for you.
80
81 May raise NameExistsError if you explicitly pass a name that's already used.
82 </source>
83 <translation>createRect(x, y, width, height, ["name"]) -> string
84
85 Creates a new rectangle on the current page and returns its name. The
86 coordinates are given in the current measurement units of the document
87 (see UNIT constants). "name" should be a unique identifier for the object
88 because you need this name to reference that object in future. If "name"
89 is not given Scribus will create one for you.
90
91 May raise NameExistsError if you explicitly pass a name that's already used.
92 </translation>
93 </message>
94 <message>
95 <source>newPage(where [,"masterpage"])
96
97 Creates a new page. If "where" is -1 the new Page is appended to the
98 document, otherwise the new page is inserted before "where". Page numbers are
99 counted from 1 upwards, no matter what the displayed first page number of your
100 document is. The optional parameter "masterpage" specifies the name of the
101 master page for the new page.
102
103 May raise IndexError if the page number is out of range
104 </source>
105 <translation>newPage(where [,"masterpage"])
106
107 Creates a new page. If "where" is -1 the new Page is appended to the
108 document, otherwise the new page is inserted before "where". Page numbers are
109 counted from 1 upwards, no matter what the displayed first page number of your
110 document is. The optional parameter "masterpage" specifies the name of the
111 master page for the new page.
112
113 May raise IndexError if the page number is out of range
114 </translation>
115 </message>
116 <message>
117 <source>setGradientFill(type, "color1", shade1, "color2", shade2, ["name"])
118
119 Sets the gradient fill of the object "name" to type. Color descriptions are
120 the same as for setFillColor() and setFillShade(). See the constants for
121 available types (FILL_<type>).
122 </source>
123 <translation>setGradientFill(type, "color1", shade1, "color2", shade2, ["name"])
124
125 Sets the gradient fill of the object "name" to type. Colour descriptions are
126 the same as for setFillColor() and setFillShade(). See the constants for
127 available types (FILL_<type>).
128 </translation>
129 </message>
130 <message>
131 <source>getFontSize(["name"]) -> float
132
133 Returns the font size in points for the text frame "name". If this text
134 frame has some text selected the value assigned to the first character of
135 the selection is returned.
136 If "name" is not given the currently selected item is used.
137 </source>
138 <translation>getFontSize(["name"]) -> float
139
140 Returns the font size in points for the text frame "name". If this text
141 frame has some text selected the value assigned to the first character of
142 the selection is returned.
143 If "name" is not given the currently selected item is used.
144 </translation>
145 </message>
146 <message>
147 <source>messagebarText("string")
148
149 Writes the "string" into the Scribus message bar (status line). The text
150 must be UTF8 encoded or 'unicode' string(recommended).
151 </source>
152 <translation>messagebarText("string")
153
154 Writes the "string" into the Scribus message bar (status line). The text
155 must be UTF8 encoded or 'unicode' string(recommended).
156 </translation>
157 </message>
158 <message>
159 <source>importSVG("string")
160
161 The "string" must be a valid filename for a SVG image. The text
162 must be UTF8 encoded or 'unicode' string(recommended).
163 </source>
164 <translation>importSVG("string")
165
166 The "string" must be a valid filename for a SVG image. The text
167 must be UTF8 encoded or 'unicode' string(recommended).
168 </translation>
169 </message>
170 <message>
171 <source>newDocument(size, margins, orientation, firstPageNumber,
172 unit, pagesType, firstPageOrder) -> bool
173
174 Creates a new document and returns true if successful. The parameters have the
175 following meaning:
176
177 size = A tuple (width, height) describing the size of the document. You can
178 use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
179
180 margins = A tuple (left, right, top, bottom) describing the document
181 margins
182
183 orientation = the page orientation - constants PORTRAIT, LANDSCAPE
184
185 firstPageNumer = is the number of the first page in the document used for
186 pagenumbering. While you'll usually want 1, it's useful to have higher
187 numbers if you're creating a document in several parts.
188
189 unit: this value sets the measurement units used by the document. Use a
190 predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
191 UNIT_PICAS, UNIT_POINTS.
192
193 pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
194 PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
195 PAGE_4 is 4-fold.
196
197 firstPageOrder = What is position of first page in the document.
198 Indexed from 0 (0 = first).
199
200 The values for width, height and the margins are expressed in the given unit
201 for the document. PAPER_* constants are expressed in points. If your document
202 is not in points, make sure to account for this.
203
204 example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
205 PAGE_4, 3)
206
207 May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
208 </source>
209 <translation type="obsolete">newDocument(size, margins, orientation, firstPageNumber,
210 unit, pagesType, firstPageOrder) -> bool
211
212 Creates a new document and returns true if successful. The parameters have the
213 following meaning:
214
215 size = A tuple (width, height) describing the size of the document. You can
216 use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
217
218 margins = A tuple (left, right, top, bottom) describing the document
219 margins
220
221 orientation = the page orientation - constants PORTRAIT, LANDSCAPE
222
223 firstPageNumer = is the number of the first page in the document used for
224 pagenumbering. While you'll usually want 1, it's useful to have higher
225 numbers if you're creating a document in several parts.
226
227 unit: this value sets the measurement units used by the document. Use a
228 predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
229 UNIT_PICAS, UNIT_POINTS.
230
231 pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
232 PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
233 PAGE_4 is 4-fold.
234
235 firstPageOrder = What is position of first page in the document.
236 Indexed from 0 (0 = first).
237
238 The values for width, height and the margins are expressed in the given unit
239 for the document. PAPER_* constants are expressed in points. If your document
240 is not in points, make sure to account for this.
241
242 example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
243 PAGE_4, 3)
244
245 May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
246 </translation>
247 </message>
248 <message>
249 <source>newDocument(size, margins, orientation, firstPageNumber,
250 unit, pagesType, firstPageOrder) -> bool
251
252 Creates a new document and returns true if successful. The parameters have the
253 following meaning:
254
255 size = A tuple (width, height) describing the size of the document. You can
256 use predefined constants named PAPER_<paper_type> e.g. PAPER_A4 etc.
257
258 margins = A tuple (left, right, top, bottom) describing the document
259 margins
260
261 orientation = the page orientation - constants PORTRAIT, LANDSCAPE
262
263 firstPageNumer = is the number of the first page in the document used for
264 pagenumbering. While you'll usually want 1, it's useful to have higher
265 numbers if you're creating a document in several parts.
266
267 unit: this value sets the measurement units used by the document. Use a
268 predefined constant for this, one of: UNIT_INCHES, UNIT_MILLIMETERS,
269 UNIT_PICAS, UNIT_POINTS.
270
271 pagesType = One of the predefined constants PAGE_n. PAGE_1 is single page,
272 PAGE_2 is for double sided documents, PAGE_3 is for 3 pages fold and
273 PAGE_4 is 4-fold.
274
275 firstPageOrder = What is position of first page in the document.
276 Indexed from 0 (0 = first).
277
278 numPage = Number of pages to be created.
279
280 The values for width, height and the margins are expressed in the given unit
281 for the document. PAPER_* constants are expressed in points. If your document
282 is not in points, make sure to account for this.
283
284 example: newDocument(PAPER_A4, (10, 10, 20, 20), LANDSCAPE, 7, UNIT_POINTS,
285 PAGE_4, 3, 1)
286
287 May raise ScribusError if is firstPageOrder bigger than allowed by pagesType.
288 </source>
289 <translation type="unfinished"></translation>
290 </message>
291 </context>
292 <context>
293 <name>@default</name>
294 <message>
295 <source>getColor("name") -> tuple
296
297 Returns a tuple (C, M, Y, K) containing the four color components of the
298 color "name" from the current document. If no document is open, returns
299 the value of the named color from the default document colors.
300
301 May raise NotFoundError if the named color wasn't found.
302 May raise ValueError if an invalid color name is specified.
303 </source>
304 <translation>getColor("name") -> tuple
305
306 Returns a tuple (C, M, Y, K) containing the four colour components of the
307 colour "name" from the current document. If no document is open, returns
308 the value of the named colour from the default document colours.
309
310 May raise NotFoundError if the named colour wasn't found.
311 May raise ValueError if an invalid colour name is specified.
312 </translation>
313 </message>
314 <message>
315 <source>getColorAsRGB("name") -> tuple
316
317 Returns a tuple (R,G,B) containing the three color components of the
318 color "name" from the current document, converted to the RGB color
319 space. If no document is open, returns the value of the named color
320 from the default document colors.
321
322 May raise NotFoundError if the named color wasn't found.
323 May raise ValueError if an invalid color name is specified.
324 </source>
325 <translation>getColorAsRGB("name") -> tuple
326
327 Returns a tuple (R,G,B) containing the three colour components of the
328 colour "name" from the current document, converted to the RGB colour
329 space. If no document is open, returns the value of the named colour
330 from the default document colours.
331
332 May raise NotFoundError if the named colour wasn't found.
333 May raise ValueError if an invalid colour name is specified.
334 </translation>
335 </message>
336 <message>
337 <source>changeColor("name", c, m, y, k)
338
339 Changes the color "name" to the specified CMYK value. The color value is
340 defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
341 Color components should be in the range from 0 to 255.
342
343 May raise NotFoundError if the named color wasn't found.
344 May raise ValueError if an invalid color name is specified.
345 </source>
346 <translation>changeColour("name", c, m, y, k)
347
348 Changes the colour "name" to the specified CMYK value. The colour value is
349 defined via four components c = Cyan, m = Magenta, y = Yellow and k = Black.
350 Colour components should be in the range from 0 to 255.
351
352 May raise NotFoundError if the named colour wasn't found.
353 May raise ValueError if an invalid colour name is specified.
354 </translation>
355 </message>
356 <message>
357 <source>defineColor("name", c, m, y, k)
358
359 Defines a new color "name". The color Value is defined via four components:
360 c = Cyan, m = Magenta, y = Yello and k = Black. Color components should be in
361 the range from 0 to 255.
362
363 May raise ValueError if an invalid color name is specified.
364 </source>
365 <translation>defineColor("name", c, m, y, k)
366
367 Defines a new colour "name". The colour Value is defined via four components:
368 c = Cyan, m = Magenta, y = Yello and k = Black. Colour components should be in
369 the range from 0 to 255.
370
371 May raise ValueError if an invalid colour name is specified.
372 </translation>
373 </message>
374 <message>
375 <source>deleteColor("name", "replace")
376
377 Deletes the color "name". Every occurence of that color is replaced by the
378 color "replace". If not specified, "replace" defaults to the color
379 "None" - transparent.
380
381 deleteColor works on the default document colors if there is no document open.
382 In that case, "replace", if specified, has no effect.
383
384 May raise NotFoundError if a named color wasn't found.
385 May raise ValueError if an invalid color name is specified.
386 </source>
387 <translation>deleteColor("name", "replace")
388
389 Deletes the colour "name". Every occurence of that colour is replaced by the
390 colour "replace". If not specified, "replace" defaults to the colour
391 "None" - transparent.
392
393 deleteColor works on the default document colours if there is no document open.
394 In that case, "replace", if specified, has no effect.
395
396 May raise NotFoundError if a named colour wasn't found.
397 May raise ValueError if an invalid colour name is specified.
398 </translation>
399 </message>
400 <message>
401 <source>replaceColor("name", "replace")
402
403 Every occurence of the color "name" is replaced by the color "replace".
404
405 May raise NotFoundError if a named color wasn't found.
406 May raise ValueError if an invalid color name is specified.
407 </source>
408 <translation>replaceColor("name", "replace")
409
410 Every occurence of the colour "name" is replaced by the colour "replace".
411
412 May raise NotFoundError if a named colour wasn't found.
413 May raise ValueError if an invalid colour name is specified.
414 </translation>
415 </message>
416 <message>
417 <source>fileDialog("caption", ["filter", "defaultname", haspreview, issave, isdir]) -> string with filename
418
419 Shows a File Open dialog box with the caption "caption". Files are filtered
420 with the filter string "filter". A default filename or file path can also
421 supplied, leave this string empty when you don't want to use it. A value of
422 True for haspreview enables a small preview widget in the FileSelect box. When
423 the issave parameter is set to True the dialog acts like a "Save As" dialog
424 otherwise it acts like a "File Open Dialog". When the isdir parameter is True
425 the dialog shows and returns only directories. The default for all of the
426 opional parameters is False.
427
428 The filter, if specified, takes the form 'comment (*.type *.type2 ...)'.
429 For example 'Images (*.png *.xpm *.jpg)'.
430
431 Refer to the Qt-Documentation for QFileDialog for details on filters.
432
433 Example: fileDialog('Open input', 'CSV files (*.csv)')
434 Example: fileDialog('Save report', defaultname='report.txt', issave=True)
435 </source>
436 <translation>fileDialog("caption", ["filter", "defaultname", haspreview, issave, isdir]) -> string with filename
437
438 Shows a File Open dialog box with the caption "caption". Files are filtered
439 with the filter string "filter". A default filename or file path can also
440 supplied, leave this string empty when you don't want to use it. A value of
441 True for haspreview enables a small preview widget in the FileSelect box. When
442 the issave parameter is set to True the dialog acts like a "Save As" dialog
443 otherwise it acts like a "File Open Dialog". When the isdir parameter is True
444 the dialog shows and returns only directories. The default for all of the
445 opional parameters is False.
446
447 The filter, if specified, takes the form 'comment (*.type *.type2 ...)'.
448 For example 'Images (*.png *.xpm *.jpg)'.
449
450 Refer to the Qt-Documentation for QFileDialog for details on filters.
451
452 Example: fileDialog('Open input', 'CSV files (*.csv)')
453 Example: fileDialog('Save report', defaultname='report.txt', issave=True)
454 </translation>
455 </message>
456 <message>
457 <source>messageBox("caption", "message",
458 icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
459 button2=BUTTON_NONE, button3=BUTTON_NONE) -> integer
460
461 Displays a message box with the title "caption", the message "message", and
462 an icon "icon" and up to 3 buttons. By default no icon is used and a single
463 button, OK, is displayed. Only the caption and message arguments are required,
464 though setting an icon and appropriate button(s) is strongly
465 recommended. The message text may contain simple HTML-like markup.
466
467 Returns the number of the button the user pressed. Button numbers start
468 at 1.
469
470 For the icon and the button parameters there are predefined constants available
471 with the same names as in the Qt Documentation. These are the BUTTON_* and
472 ICON_* constants defined in the module. There are also two extra constants that
473 can be binary-ORed with button constants:
474 BUTTONOPT_DEFAULT Pressing enter presses this button.
475 BUTTONOPT_ESCAPE Pressing escape presses this button.
476
477 Usage examples:
478 result = messageBox('Script failed',
479 'This script only works when you have a text frame selected.',
480 ICON_ERROR)
481 result = messageBox('Monkeys!', 'Something went ook! <i>Was it a monkey?</i>',
482 ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
483 BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
484
485 Defined button and icon constants:
486 BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
487 BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
488 ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
489 </source>
490 <translation>messageBox("caption", "message",
491 icon=ICON_NONE, button1=BUTTON_OK|BUTTONOPT_DEFAULT,
492 button2=BUTTON_NONE, button3=BUTTON_NONE) -> integer
493
494 Displays a message box with the title "caption", the message "message", and
495 an icon "icon" and up to 3 buttons. By default no icon is used and a single
496 button, OK, is displayed. Only the caption and message arguments are required,
497 though setting an icon and appropriate button(s) is strongly
498 recommended. The message text may contain simple HTML-like markup.
499
500 Returns the number of the button the user pressed. Button numbers start
501 at 1.
502
503 For the icon and the button parameters there are predefined constants available
504 with the same names as in the Qt Documentation. These are the BUTTON_* and
505 ICON_* constants defined in the module. There are also two extra constants that
506 can be binary-ORed with button constants:
507 BUTTONOPT_DEFAULT Pressing enter presses this button.
508 BUTTONOPT_ESCAPE Pressing escape presses this button.
509
510 Usage examples:
511 result = messageBox('Script failed',
512 'This script only works when you have a text frame selected.',
513 ICON_ERROR)
514 result = messageBox('Monkeys!', 'Something went ook! <i>Was it a monkey?</i>',
515 ICON_WARNING, BUTTON_YES|BUTTONOPT_DEFAULT,
516 BUTTON_NO, BUTTON_IGNORE|BUTTONOPT_ESCAPE)
517
518 Defined button and icon constants:
519 BUTTON_NONE, BUTTON_ABORT, BUTTON_CANCEL, BUTTON_IGNORE, BUTTON_NO,
520 BUTTON_NOALL, BUTTON_OK, BUTTON_RETRY, BUTTON_YES, BUTTON_YESALL,
521 ICON_NONE, ICON_INFORMATION, ICON_WARNING, ICON_CRITICAL.
522 </translation>
523 </message>
524 <message>
525 <source>valueDialog(caption, message [,defaultvalue]) -> string
526
527 Shows the common 'Ask for string' dialog and returns its value as a string
528 Parameters: window title, text in the window and optional 'default' value.
529
530 Example: valueDialog('title', 'text in the window', 'optional')
531 </source>
532 <translation>valueDialog(caption, message [,defaultvalue]) -> string
533
534 Shows the common 'Ask for string' dialog and returns its value as a string
535 Parameters: window title, text in the window and optional 'default' value.
536
537 Example: valueDialog('title', 'text in the window', 'optional')
538 </translation>
539 </message>
540 <message>
541 <source>closeDoc()
542
543 Closes the current document without prompting to save.
544
545 May throw NoDocOpenError if there is no document to close
546 </source>
547 <translation>closeDoc()
548
549 Closes the current document without prompting to save.
550
551 May throw NoDocOpenError if there is no document to close
552 </translation>
553 </message>
554 <message>
555 <source>haveDoc() -> bool
556
557 Returns true if there is a document open.
558 </source>
559 <translation>haveDoc() -> bool
560
561 Returns true if there is a document open.
562 </translation>
563 </message>
564 <message>
565 <source>openDoc("name")
566
567 Opens the document "name".
568
569 May raise ScribusError if the document could not be opened.
570 </source>
571 <translation>openDoc("name")
572
573 Opens the document "name".
574
575 May raise ScribusError if the document could not be opened.
576 </translation>
577 </message>
578 <message>
579 <source>saveDoc()
580
581 Saves the current document with its current name, returns true if successful.
582 If the document has not already been saved, this may bring up an interactive
583 save file dialog.
584
585 If the save fails, there is currently no way to tell.
586 </source>
587 <translation>saveDoc()
588
589 Saves the current document with its current name, returns true if successful.
590 If the document has not already been saved, this may bring up an interactive
591 save file dialog.
592
593 If the save fails, there is currently no way to tell.
594 </translation>
595 </message>
596 <message>
597 <source>saveDocAs("name")
598
599 Saves the current document under the new name "name" (which may be a full or
600 relative path).
601
602 May raise ScribusError if the save fails.
603 </source>
604 <translation>saveDocAs("name")
605
606 Saves the current document under the new name "name" (which may be a full or
607 relative path).
608
609 May raise ScribusError if the save fails.
610 </translation>
611 </message>
612 <message>
613 <source>saveDocAs("author", "info", "description") -> bool
614
615 Sets the document information. "Author", "Info", "Description" are
616 strings.
617 </source>
618 <translation type="obsolete">saveDocAs("author", "info", "description") -> bool
619
620 Sets the document information. "Author", "Info", "Description" are
621 strings.
622 </translation>
623 </message>
624 <message>
625 <source>setMargins(lr, rr, tr, br)
626
627 Sets the margins of the document, Left(lr), Right(rr), Top(tr) and Bottom(br)
628 margins are given in the measurement units of the document - see UNIT_<type>
629 constants.
630 </source>
631 <translation>setMargins(lr, rr, tr, br)
632
633 Sets the margins of the document, Left(lr), Right(rr), Top(tr) and Bottom(br)
634 margins are given in the measurement units of the document - see UNIT_<type>
635 constants.
636 </translation>
637 </message>
638 <message>
639 <source>setUnit(type)
640
641 Changes the measurement unit of the document. Possible values for "unit" are
642 defined as constants UNIT_<type>.
643
644 May raise ValueError if an invalid unit is passed.
645 </source>
646 <translation>setUnit(type)
647
648 Changes the measurement unit of the document. Possible values for "unit" are
649 defined as constants UNIT_<type>.
650
651 May raise ValueError if an invalid unit is passed.
652 </translation>
653 </message>
654 <message>
655 <source>getUnit() -> integer (Scribus unit constant)
656
657 Returns the measurement units of the document. The returned value will be one
658 of the UNIT_* constants:
659 UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
660 </source>
661 <translation>getUnit() -> integer (Scribus unit constant)
662
663 Returns the measurement units of the document. The returned value will be one
664 of the UNIT_* constants:
665 UNIT_INCHES, UNIT_MILLIMETERS, UNIT_PICAS, UNIT_POINTS.
666 </translation>
667 </message>
668 <message>
669 <source>loadStylesFromFile("filename")
670
671 Loads paragraph styles from the Scribus document at "filename" into the
672 current document.
673 </source>
674 <translation>loadStylesFromFile("filename")
675
676 Loads paragraph styles from the Scribus document at "filename" into the
677 current document.
678 </translation>
679 </message>
680 <message>
681 <source>setDocType(facingPages, firstPageLeft)
682
683 Sets the document type. To get facing pages set the first parameter to
684 FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead. If you want
685 to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
686 a right page use FIRSTPAGERIGHT.
687 </source>
688 <translation>setDocType(facingPages, firstPageLeft)
689
690 Sets the document type. To get facing pages set the first parameter to
691 FACINGPAGES, to switch facingPages off use NOFACINGPAGES instead. If you want
692 to be the first page a left side set the second parameter to FIRSTPAGELEFT, for
693 a right page use FIRSTPAGERIGHT.
694 </translation>
695 </message>
696 <message>
697 <source>getLineColor(["name"]) -> string
698
699 Returns the name of the line color of the object "name".
700 If "name" is not given the currently selected item is used.
701 </source>
702 <translation>getLineColor(["name"]) -> string
703
704 Returns the name of the line colour of the object "name".
705 If "name" is not given the currently selected item is used.
706 </translation>
707 </message>
708 <message>
709 <source>getLineWidth(["name"]) -> integer
710
711 Returns the line width of the object "name". If "name"
712 is not given the currently selected Item is used.
713 </source>
714 <translation>getLineWidth(["name"]) -> integer
715
716 Returns the line width of the object "name". If "name"
717 is not given the currently selected Item is used.
718 </translation>
719 </message>
720 <message>
721 <source>getLineShade(["name"]) -> integer
722
723 Returns the shading value of the line color of the object "name".
724 If "name" is not given the currently selected item is used.
725 </source>
726 <translation>getLineShade(["name"]) -> integer
727
728 Returns the shading value of the line colour of the object "name".
729 If "name" is not given the currently selected item is used.
730 </translation>
731 </message>
732 <message>
733 <source>getLineJoin(["name"]) -> integer (see contants)
734
735 Returns the line join style of the object "name". If "name" is not given
736 the currently selected item is used. The join types are:
737 JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
738 </source>
739 <translation>getLineJoin(["name"]) -> integer (see contants)
740
741 Returns the line join style of the object "name". If "name" is not given
742 the currently selected item is used. The join types are:
743 JOIN_BEVEL, JOIN_MITTER, JOIN_ROUND
744 </translation>
745 </message>
746 <message>
747 <source>getLineEnd(["name"]) -> integer (see constants)
748
749 Returns the line cap style of the object "name". If "name" is not given the
750 currently selected item is used. The cap types are:
751 CAP_FLAT, CAP_ROUND, CAP_SQUARE
752 </source>
753 <translation>getLineEnd(["name"]) -> integer (see constants)
754
755 Returns the line cap style of the object "name". If "name" is not given the
756 currently selected item is used. The cap types are:
757 CAP_FLAT, CAP_ROUND, CAP_SQUARE
758 </translation>
759 </message>
760 <message>
761 <source>getLineStyle(["name"]) -> integer (see constants)
762
763 Returns the line style of the object "name". If "name" is not given the
764 currently selected item is used. Line style constants are:
765 LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
766 </source>
767 <translation>getLineStyle(["name"]) -> integer (see constants)
768
769 Returns the line style of the object "name". If "name" is not given the
770 currently selected item is used. Line style constants are:
771 LINE_DASH, LINE_DASHDOT, LINE_DASHDOTDOT, LINE_DOT, LINE_SOLID
772 </translation>
773 </message>
774 <message>
775 <source>getFillShade(["name"]) -> integer
776
777 Returns the shading value of the fill color of the object "name".
778 If "name" is not given the currently selected item is used.
779 </source>
780 <translation>getFillShade(["name"]) -> integer
781
782 Returns the shading value of the fill colour of the object "name".
783 If "name" is not given the currently selected item is used.
784 </translation>
785 </message>
786 <message>
787 <source>getCornerRadius(["name"]) -> integer
788
789 Returns the corner radius of the object "name". The radius isexpressed in points. If "name" is not given the currentlyselected item is used.
790 </source>
791 <translation>getCornerRadius(["name"]) -> integer
792
793 Returns the corner radius of the object "name". The radius isexpressed in points. If "name" is not given the currentlyselected item is used.
794 </translation>
795 </message>
796 <message>
797 <source>getImageScale(["name"]) -> (x,y)
798
799 Returns a (x, y) tuple containing the scaling values of the image frame
800 "name". If "name" is not given the currently selected item is used.
801 </source>
802 <translation>getImageScale(["name"]) -> (x,y)
803
804 Returns a (x, y) tuple containing the scaling values of the image frame
805 "name". If "name" is not given the currently selected item is used.
806 </translation>
807 </message>
808 <message>
809 <source>getImageName(["name"]) -> string
810
811 Returns the filename for the image in the image frame. If "name" is not
812 given the currently selected item is used.
813 </source>
814 <translation>getImageName(["name"]) -> string
815
816 Returns the filename for the image in the image frame. If "name" is not
817 given the currently selected item is used.
818 </translation>
819 </message>
820 <message>
821 <source>getPosition(["name"]) -> (x,y)
822
823 Returns a (x, y) tuple with the position of the object "name".
824 If "name" is not given the currently selected item is used.The position is expressed in the actual measurement unit of the document
825 - see UNIT_<type> for reference.
826 </source>
827 <translation>getPosition(["name"]) -> (x,y)
828
829 Returns a (x, y) tuple with the position of the object "name".
830 If "name" is not given the currently selected item is used.The position is expressed in the actual measurement unit of the document
831 - see UNIT_<type> for reference.
832 </translation>
833 </message>
834 <message>
835 <source>getSize(["name"]) -> (width,height)
836
837 Returns a (width, height) tuple with the size of the object "name".
838 If "name" is not given the currently selected item is used. The size is
839 expressed in the current measurement unit of the document - see UNIT_<type>
840 for reference.
841 </source>
842 <translation>getSize(["name"]) -> (width,height)
843
844 Returns a (width, height) tuple with the size of the object "name".
845 If "name" is not given the currently selected item is used. The size is
846 expressed in the current measurement unit of the document - see UNIT_<type>
847 for reference.
848 </translation>
849 </message>
850 <message>
851 <source>getRotation(["name"]) -> integer
852
853 Returns the rotation of the object "name". The value is expressed in degrees,
854 and clockwise is positive. If "name" is not given the currently selected item
855 is used.
856 </source>
857 <translation>getRotation(["name"]) -> integer
858
859 Returns the rotation of the object "name". The value is expressed in degrees,
860 and clockwise is positive. If "name" is not given the currently selected item
861 is used.
862 </translation>
863 </message>
864 <message>
865 <source>getAllObjects() -> list
866
867 Returns a list containing the names of all objects on the current page.
868 </source>
869 <translation>getAllObjects() -> list
870
871 Returns a list containing the names of all objects on the current page.
872 </translation>
873 </message>
874 <message>
875 <source>getPropertyCType(object, property, includesuper=True)
876
877 Returns the name of the C type of `property' of `object'. See getProperty()
878 for details of arguments.
879
880 If `includesuper' is true, search inherited properties too.
881 </source>
882 <translation>getPropertyCType(object, property, includesuper=True)
883
884 Returns the name of the C type of `property' of `object'. See getProperty()
885 for details of arguments.
886
887 If `includesuper' is true, search inherited properties too.
888 </translation>
889 </message>
890 <message>
891 <source>getPropertyNames(object, includesuper=True)
892
893 Return a list of property names supported by `object'.
894 If `includesuper' is true, return properties supported
895 by parent classes as well.
896 </source>
897 <translation>getPropertyNames(object, includesuper=True)
898
899 Return a list of property names supported by `object'.
900 If `includesuper' is true, return properties supported
901 by parent classes as well.
902 </translation>
903 </message>
904 <message>
905 <source>getProperty(object, property)
906
907 Return the value of the property `property' of the passed `object'.
908
909 The `object' argument may be a string, in which case the named PageItem
910 is searched for. It may also be a PyCObject, which may point to any
911 C++ QObject instance.
912
913 The `property' argument must be a string, and is the name of the property
914 to look up on `object'.
915
916 The return value varies depending on the type of the property.
917 </source>
918 <translation>getProperty(object, property)
919
920 Return the value of the property `property' of the passed `object'.
921
922 The `object' argument may be a string, in which case the named PageItem
923 is searched for. It may also be a PyCObject, which may point to any
924 C++ QObject instance.
925
926 The `property' argument must be a string, and is the name of the property
927 to look up on `object'.
928
929 The return value varies depending on the type of the property.
930 </translation>
931 </message>
932 <message>
933 <source>setProperty(object, property, value)
934
935 Set `property' of `object' to `value'. If `value' cannot be converted to a type
936 compatible with the type of `property', an exception is raised. An exception may
937 also be raised if the underlying setter fails.
938
939 See getProperty() for more information.
940 </source>
941 <translation>setProperty(object, property, value)
942
943 Set `property' of `object' to `value'. If `value' cannot be converted to a type
944 compatible with the type of `property', an exception is raised. An exception may
945 also be raised if the underlying setter fails.
946
947 See getProperty() for more information.
948 </translation>
949 </message>
950 <message>
951 <source>getChildren(object, ofclass=None, ofname=None, regexpmatch=False, recursive=True)
952
953 Return a list of children of `object', possibly restricted to children
954 of class named `ofclass' or children named `ofname'. If `recursive' is true,
955 search recursively through children, grandchildren, etc.
956
957 See QObject::children() in the Qt docs for more information.
958 </source>
959 <translation>getChildren(object, ofclass=None, ofname=None, regexpmatch=False, recursive=True)
960
961 Return a list of children of `object', possibly restricted to children
962 of class named `ofclass' or children named `ofname'. If `recursive' is true,
963 search recursively through children, grandchildren, etc.
964
965 See QObject::children() in the Qt docs for more information.
966 </translation>
967 </message>
968 <message>
969 <source>getChild(object, childname, ofclass=None, recursive=True)
970
971 Return the first child of `object' named `childname', possibly restricting
972 the search to children of type name `ofclass'. If `recursive' is true,
973 search recursively through children, grandchildren, etc.
974 </source>
975 <translation>getChild(object, childname, ofclass=None, recursive=True)
976
977 Return the first child of `object' named `childname', possibly restricting
978 the search to children of type name `ofclass'. If `recursive' is true,
979 search recursively through children, grandchildren, etc.
980 </translation>
981 </message>
982 <message>
983 <source>moveObjectAbs(x, y [, "name"])
984
985 Moves the object "name" to a new location. The coordinates are expressed in
986 the current measurement unit of the document (see UNIT constants). If "name"
987 is not given the currently selected item is used. If the object "name"
988 belongs to a group, the whole group is moved.
989 </source>
990 <translation>moveObjectAbs(x, y [, "name"])
991
992 Moves the object "name" to a new location. The coordinates are expressed in
993 the current measurement unit of the document (see UNIT constants). If "name"
994 is not given the currently selected item is used. If the object "name"
995 belongs to a group, the whole group is moved.
996 </translation>
997 </message>
998 <message>
999 <source>rotateObject(rot [, "name"])
1000
1001 Rotates the object "name" by "rot" degrees relatively. The object is
1002 rotated by the vertex that is currently selected as the rotation point - by
1003 default, the top left vertext at zero rotation. Positive values mean counter
1004 clockwise rotation when the default rotation point is used. If "name" is not
1005 given the currently selected item is used.
1006 </source>
1007 <translation>rotateObject(rot [, "name"])
1008
1009 Rotates the object "name" by "rot" degrees relatively. The object is
1010 rotated by the vertex that is currently selected as the rotation point - by
1011 default, the top left vertext at zero rotation. Positive values mean counter
1012 clockwise rotation when the default rotation point is used. If "name" is not
1013 given the currently selected item is used.
1014 </translation>
1015 </message>
1016 <message>
1017 <source>rotateObjectAbs(rot [, "name"])
1018
1019 Sets the rotation of the object "name" to "rot". Positve values
1020 mean counter clockwise rotation. If "name" is not given the currently
1021 selected item is used.
1022 </source>
1023 <translation>rotateObjectAbs(rot [, "name"])
1024
1025 Sets the rotation of the object "name" to "rot". Positve values
1026 mean counter clockwise rotation. If "name" is not given the currently
1027 selected item is used.
1028 </translation>
1029 </message>
1030 <message>
1031 <source>sizeObject(width, height [, "name"])
1032
1033 Resizes the object "name" to the given width and height. If "name"
1034 is not given the currently selected item is used.
1035 </source>
1036 <translation>sizeObject(width, height [, "name"])
1037
1038 Resizes the object "name" to the given width and height. If "name"
1039 is not given the currently selected item is used.
1040 </translation>
1041 </message>
1042 <message>
1043 <source>getSelectedObject([nr]) -> string
1044
1045 Returns the name of the selected object. "nr" if given indicates the number
1046 of the selected object, e.g. 0 means the first selected object, 1 means the
1047 second selected Object and so on.
1048 </source>
1049 <translation>getSelectedObject([nr]) -> string
1050
1051 Returns the name of the selected object. "nr" if given indicates the number
1052 of the selected object, e.g. 0 means the first selected object, 1 means the
1053 second selected Object and so on.
1054 </translation>
1055 </message>
1056 <message>
1057 <source>selectionCount() -> integer
1058
1059 Returns the number of selected objects.
1060 </source>
1061 <translation>selectionCount() -> integer
1062
1063 Returns the number of selected objects.
1064 </translation>
1065 </message>
1066 <message>
1067 <source>selectObject("name")
1068
1069 Selects the object with the given "name".
1070 </source>
1071 <translation>selectObject("name")
1072
1073 Selects the object with the given "name".
1074 </translation>
1075 </message>
1076 <message>
1077 <source>deselectAll()
1078
1079 Deselects all objects in the whole document.
1080 </source>
1081 <translation>deselectAll()
1082
1083 Deselects all objects in the whole document.
1084 </translation>
1085 </message>
1086 <message>
1087 <source>groupObjects(list)
1088
1089 Groups the objects named in "list" together. "list" must contain the names
1090 of the objects to be grouped. If "list" is not given the currently selected
1091 items are used.
1092 </source>
1093 <translation>groupObjects(list)
1094
1095 Groups the objects named in "list" together. "list" must contain the names
1096 of the objects to be grouped. If "list" is not given the currently selected
1097 items are used.
1098 </translation>
1099 </message>
1100 <message>
1101 <source>unGroupObjects("name")
1102
1103 Destructs the group the object "name" belongs to.If "name" is not given the currently selected item is used.</source>
1104 <translation>unGroupObjects("name")
1105
1106 Destructs the group the object "name" belongs to.If "name" is not given the currently selected item is used.</translation>
1107 </message>
1108 <message>
1109 <source>scaleGroup(factor [,"name"])
1110
1111 Scales the group the object "name" belongs to. Values greater than 1 enlarge
1112 the group, values smaller than 1 make the group smaller e.g a value of 0.5
1113 scales the group to 50 % of its original size, a value of 1.5 scales the group
1114 to 150 % of its original size. The value for "factor" must be greater than
1115 0. If "name" is not given the currently selected item is used.
1116
1117 May raise ValueError if an invalid scale factor is passed.
1118 </source>
1119 <translation>scaleGroup(factor [,"name"])
1120
1121 Scales the group the object "name" belongs to. Values greater than 1 enlarge
1122 the group, values smaller than 1 make the group smaller e.g a value of 0.5
1123 scales the group to 50 % of its original size, a value of 1.5 scales the group
1124 to 150 % of its original size. The value for "factor" must be greater than
1125 0. If "name" is not given the currently selected item is used.
1126
1127 May raise ValueError if an invalid scale factor is passed.
1128 </translation>
1129 </message>
1130 <message>
1131 <source>loadImage("filename" [, "name"])
1132
1133 Loads the picture "picture" into the image frame "name". If "name" is
1134 not given the currently selected item is used.
1135
1136 May raise WrongFrameTypeError if the target frame is not an image frame
1137 </source>
1138 <translation>loadImage("filename" [, "name"])
1139
1140 Loads the picture "picture" into the image frame "name". If "name" is
1141 not given the currently selected item is used.
1142
1143 May raise WrongFrameTypeError if the target frame is not an image frame
1144 </translation>
1145 </message>
1146 <message>
1147 <source>scaleImage(x, y [, "name"])
1148
1149 Sets the scaling factors of the picture in the image frame "name".
1150 If "name" is not given the currently selected item is used. A number of 1
1151 means 100 %.
1152
1153 May raise WrongFrameTypeError if the target frame is not an image frame
1154 </source>
1155 <translation>scaleImage(x, y [, "name"])
1156
1157 Sets the scaling factors of the picture in the image frame "name".
1158 If "name" is not given the currently selected item is used. A number of 1
1159 means 100 %.
1160
1161 May raise WrongFrameTypeError if the target frame is not an image frame
1162 </translation>
1163 </message>
1164 <message>
1165 <source>lockObject(["name"]) -> bool
1166
1167 Locks the object "name" if it's unlocked or unlock it if it's locked.
1168 If "name" is not given the currently selected item is used. Returns true
1169 if locked.
1170 </source>
1171 <translation>lockObject(["name"]) -> bool
1172
1173 Locks the object "name" if it's unlocked or unlock it if it's locked.
1174 If "name" is not given the currently selected item is used. Returns true
1175 if locked.
1176 </translation>
1177 </message>
1178 <message>
1179 <source>isLocked(["name"]) -> bool
1180
1181 Returns true if is the object "name" locked. If "name" is not given the
1182 currently selected item is used.
1183 </source>
1184 <translation>isLocked(["name"]) -> bool
1185
1186 Returns true if is the object "name" locked. If "name" is not given the
1187 currently selected item is used.
1188 </translation>
1189 </message>
1190 <message>
1191 <source>setScaleImageToFrame(scaletoframe, proportional=None, name=<selection>)
1192
1193 Sets the scale to frame on the selected or specified image frame to `scaletoframe'.
1194 If `proportional' is specified, set fixed aspect ratio scaling to `proportional'.
1195 Both `scaletoframe' and `proportional' are boolean.
1196
1197 May raise WrongFrameTypeError.
1198 </source>
1199 <translation>setScaleImageToFrame(scaletoframe, proportional=None, name=<selection>)
1200
1201 Sets the scale to frame on the selected or specified image frame to `scaletoframe'.
1202 If `proportional' is specified, set fixed aspect ratio scaling to `proportional'.
1203 Both `scaletoframe' and `proportional' are boolean.
1204
1205 May raise WrongFrameTypeError.
1206 </translation>
1207 </message>
1208 <message>
1209 <source>getFontNames() -> list
1210
1211 Returns a list with the names of all available fonts.
1212 </source>
1213 <translation>getFontNames() -> list
1214
1215 Returns a list with the names of all available fonts.
1216 </translation>
1217 </message>
1218 <message>
1219 <source>getXFontNames() -> list of tuples
1220
1221 Returns a larger font info. It's a list of the tuples with:
1222 [ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1223 </source>
1224 <translation>getXFontNames() -> list of tuples
1225
1226 Returns a larger font info. It's a list of the tuples with:
1227 [ (Scribus name, Family, Real name, subset (1|0), embed PS (1|0), font file), (...), ... ]
1228 </translation>
1229 </message>
1230 <message>
1231 <source>renderFont("name", "filename", "sample", size, format="PPM") -> bool
1232
1233 Creates an image preview of font "name" with given text "sample" and size.
1234 If "filename" is not "", image is saved into "filename". Otherwise
1235 image data is returned as a string. The optional "format" argument
1236 specifies the image format to generate, and supports any format allowed
1237 by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1238
1239 May raise NotFoundError if the specified font can't be found.
1240 May raise ValueError if an empty sample or filename is passed.
1241 </source>
1242 <translation>renderFont("name", "filename", "sample", size, format="PPM") -> bool
1243
1244 Creates an image preview of font "name" with given text "sample" and size.
1245 If "filename" is not "", image is saved into "filename". Otherwise
1246 image data is returned as a string. The optional "format" argument
1247 specifies the image format to generate, and supports any format allowed
1248 by QPixmap.save(). Common formats are PPM, JPEG, PNG and XPM.
1249
1250 May raise NotFoundError if the specified font can't be found.
1251 May raise ValueError if an empty sample or filename is passed.
1252 </translation>
1253 </message>
1254 <message>
1255 <source>getLayers() -> list
1256
1257 Returns a list with the names of all defined layers.
1258 </source>
1259 <translation>getLayers() -> list
1260
1261 Returns a list with the names of all defined layers.
1262 </translation>
1263 </message>
1264 <message>
1265 <source>setActiveLayer("name")
1266
1267 Sets the active layer to the layer named "name".
1268
1269 May raise NotFoundError if the layer can't be found.
1270 May raise ValueError if the layer name isn't acceptable.
1271 </source>
1272 <translation>setActiveLayer("name")
1273
1274 Sets the active layer to the layer named "name".
1275
1276 May raise NotFoundError if the layer can't be found.
1277 May raise ValueError if the layer name isn't acceptable.
1278 </translation>
1279 </message>
1280 <message>
1281 <source>getActiveLayer() -> string
1282
1283 Returns the name of the current active layer.
1284 </source>
1285 <translation>getActiveLayer() -> string
1286
1287 Returns the name of the current active layer.
1288 </translation>
1289 </message>
1290 <message>
1291 <source>sentToLayer("layer" [, "name"])
1292
1293 Sends the object "name" to the layer "layer". The layer must exist.
1294 If "name" is not given the currently selected item is used.
1295
1296 May raise NotFoundError if the layer can't be found.
1297 May raise ValueError if the layer name isn't acceptable.
1298 </source>
1299 <translation>sentToLayer("layer" [, "name"])
1300
1301 Sends the object "name" to the layer "layer". The layer must exist.
1302 If "name" is not given the currently selected item is used.
1303
1304 May raise NotFoundError if the layer can't be found.
1305 May raise ValueError if the layer name isn't acceptable.
1306 </translation>
1307 </message>
1308 <message>
1309 <source>setLayerVisible("layer", visible)
1310
1311 Sets the layer "layer" to be visible or not. If is the visible set to false
1312 the layer is invisible.
1313
1314 May raise NotFoundError if the layer can't be found.
1315 May raise ValueError if the layer name isn't acceptable.
1316 </source>
1317 <translation>setLayerVisible("layer", visible)
1318
1319 Sets the layer "layer" to be visible or not. If is the visible set to false
1320 the layer is invisible.
1321
1322 May raise NotFoundError if the layer can't be found.
1323 May raise ValueError if the layer name isn't acceptable.
1324 </translation>
1325 </message>
1326 <message>
1327 <source>setLayerPrintable("layer", printable)
1328
1329 Sets the layer "layer" to be printable or not. If is the printable set to
1330 false the layer won't be printed.
1331
1332 May raise NotFoundError if the layer can't be found.
1333 May raise ValueError if the layer name isn't acceptable.
1334 </source>
1335 <translation>setLayerPrintable("layer", printable)
1336
1337 Sets the layer "layer" to be printable or not. If is the printable set to
1338 false the layer won't be printed.
1339
1340 May raise NotFoundError if the layer can't be found.
1341 May raise ValueError if the layer name isn't acceptable.
1342 </translation>
1343 </message>
1344 <message>
1345 <source>isLayerPrintable("layer") -> bool
1346
1347 Returns whether the layer "layer" is visible or not, a value of True means
1348 that the layer "layer" is visible, a value of False means that the layer
1349 "layer" is invisible.
1350
1351 May raise NotFoundError if the layer can't be found.
1352 May raise ValueError if the layer name isn't acceptable.
1353 </source>
1354 <translation>isLayerPrintable("layer") -> bool
1355
1356 Returns whether the layer "layer" is visible or not, a value of True means
1357 that the layer "layer" is visible, a value of False means that the layer
1358 "layer" is invisible.
1359
1360 May raise NotFoundError if the layer can't be found.
1361 May raise ValueError if the layer name isn't acceptable.
1362 </translation>
1363 </message>
1364 <message>
1365 <source>isLayerPrintable("layer") -> bool
1366
1367 Returns whether the layer "layer" is printable or not, a value of True means
1368 that the layer "layer" can be printed, a value of False means that printing
1369 the layer "layer" is disabled.
1370
1371 May raise NotFoundError if the layer can't be found.
1372 May raise ValueError if the layer name isn't acceptable.
1373 </source>
1374 <translation>isLayerPrintable("layer") -> bool
1375
1376 Returns whether the layer "layer" is printable or not, a value of True means
1377 that the layer "layer" can be printed, a value of False means that printing
1378 the layer "layer" is disabled.
1379
1380 May raise NotFoundError if the layer can't be found.
1381 May raise ValueError if the layer name isn't acceptable.
1382 </translation>
1383 </message>
1384 <message>
1385 <source>deleteLayer("layer")
1386
1387 Deletes the layer with the name "layer". Nothing happens if the layer doesn't
1388 exists or if it's the only layer in the document.
1389
1390 May raise NotFoundError if the layer can't be found.
1391 May raise ValueError if the layer name isn't acceptable.
1392 </source>
1393 <translation>deleteLayer("layer")
1394
1395 Deletes the layer with the name "layer". Nothing happens if the layer doesn't
1396 exists or if it's the only layer in the document.
1397
1398 May raise NotFoundError if the layer can't be found.
1399 May raise ValueError if the layer name isn't acceptable.
1400 </translation>
1401 </message>
1402 <message>
1403 <source>createLayer(layer)
1404
1405 Creates a new layer with the name "name".
1406
1407 May raise ValueError if the layer name isn't acceptable.
1408 </source>
1409 <translation>createLayer(layer)
1410
1411 Creates a new layer with the name "name".
1412
1413 May raise ValueError if the layer name isn't acceptable.
1414 </translation>
1415 </message>
1416 <message>
1417 <source>getGuiLanguage() -> string
1418
1419 Returns a string with the -lang value.
1420 </source>
1421 <translation>getGuiLanguage() -> string
1422
1423 Returns a string with the -lang value.
1424 </translation>
1425 </message>
1426 <message>
1427 <source>createEllipse(x, y, width, height, ["name"]) -> string
1428
1429 Creates a new ellipse on the current page and returns its name.
1430 The coordinates are given in the current measurement units of the document
1431 (see UNIT constants). "name" should be a unique identifier for the object
1432 because you need this name for further referencing of that object. If "name"
1433 is not given Scribus will create one for you.
1434
1435 May raise NameExistsError if you explicitly pass a name that's already used.
1436 </source>
1437 <translation>createEllipse(x, y, width, height, ["name"]) -> string
1438
1439 Creates a new ellipse on the current page and returns its name.
1440 The coordinates are given in the current measurement units of the document
1441 (see UNIT constants). "name" should be a unique identifier for the object
1442 because you need this name for further referencing of that object. If "name"
1443 is not given Scribus will create one for you.
1444
1445 May raise NameExistsError if you explicitly pass a name that's already used.
1446 </translation>
1447 </message>
1448 <message>
1449 <source>createImage(x, y, width, height, ["name"]) -> string
1450
1451 Creates a new picture frame on the current page and returns its name. The
1452 coordinates are given in the current measurement units of the document.
1453 "name" should be a unique identifier for the object because you need this
1454 name for further access to that object. If "name" is not given Scribus will
1455 create one for you.
1456
1457 May raise NameExistsError if you explicitly pass a name that's already used.
1458 </source>
1459 <translation>createImage(x, y, width, height, ["name"]) -> string
1460
1461 Creates a new picture frame on the current page and returns its name. The
1462 coordinates are given in the current measurement units of the document.
1463 "name" should be a unique identifier for the object because you need this
1464 name for further access to that object. If "name" is not given Scribus will
1465 create one for you.
1466
1467 May raise NameExistsError if you explicitly pass a name that's already used.
1468 </translation>
1469 </message>
1470 <message>
1471 <source>createText(x, y, width, height, ["name"]) -> string
1472
1473 Creates a new text frame on the actual page and returns its name.
1474 The coordinates are given in the actual measurement unit of the document (see
1475 UNIT constants). "name" should be a unique identifier for the object because
1476 you need this name for further referencing of that object. If "name" is not
1477 given Scribus will create one for you.
1478
1479 May raise NameExistsError if you explicitly pass a name that's already used.
1480 </source>
1481 <translation>createText(x, y, width, height, ["name"]) -> string
1482
1483 Creates a new text frame on the actual page and returns its name.
1484 The coordinates are given in the actual measurement unit of the document (see
1485 UNIT constants). "name" should be a unique identifier for the object because
1486 you need this name for further referencing of that object. If "name" is not
1487 given Scribus will create one for you.
1488
1489 May raise NameExistsError if you explicitly pass a name that's already used.
1490 </translation>
1491 </message>
1492 <message>
1493 <source>createLine(x1, y1, x2, y2, ["name"]) -> string
1494
1495 Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1496 its name. The coordinates are given in the current measurement unit of the
1497 document (see UNIT constants). "name" should be a unique identifier for the
1498 object because you need this name for further access to that object. If
1499 "name" is not given Scribus will create one for you.
1500
1501 May raise NameExistsError if you explicitly pass a name that's already used.
1502 </source>
1503 <translation>createLine(x1, y1, x2, y2, ["name"]) -> string
1504
1505 Creates a new line from the point(x1, y1) to the point(x2, y2) and returns
1506 its name. The coordinates are given in the current measurement unit of the
1507 document (see UNIT constants). "name" should be a unique identifier for the
1508 object because you need this name for further access to that object. If
1509 "name" is not given Scribus will create one for you.
1510
1511 May raise NameExistsError if you explicitly pass a name that's already used.
1512 </translation>
1513 </message>
1514 <message>
1515 <source>createPolyLine(list, ["name"]) -> string
1516
1517 Creates a new polyline and returns its name. The points for the polyline are
1518 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
1519 The coordinates are given in the current measurement units of the document (see
1520 UNIT constants). "name" should be a unique identifier for the object because
1521 you need this name for further access to that object. If "name" is not given
1522 Scribus will create one for you.
1523
1524 May raise NameExistsError if you explicitly pass a name that's already used.
1525 May raise ValueError if an insufficient number of points is passed or if
1526 the number of values passed don't group into points without leftovers.
1527 </source>
1528 <translation>createPolyLine(list, ["name"]) -> string
1529
1530 Creates a new polyline and returns its name. The points for the polyline are
1531 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
1532 The coordinates are given in the current measurement units of the document (see
1533 UNIT constants). "name" should be a unique identifier for the object because
1534 you need this name for further access to that object. If "name" is not given
1535 Scribus will create one for you.
1536
1537 May raise NameExistsError if you explicitly pass a name that's already used.
1538 May raise ValueError if an insufficient number of points is passed or if
1539 the number of values passed don't group into points without leftovers.
1540 </translation>
1541 </message>
1542 <message>
1543 <source>createPolygon(list, ["name"]) -> string
1544
1545 Creates a new polygon and returns its name. The points for the polygon are
1546 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
1547 At least three points are required. There is no need to repeat the first point
1548 to close the polygon. The polygon is automatically closed by connecting the
1549 first and the last point. The coordinates are given in the current measurement
1550 units of the document (see UNIT constants). "name" should be a unique
1551 identifier for the object because you need this name for further access to that
1552 object. If "name" is not given Scribus will create one for you.
1553
1554 May raise NameExistsError if you explicitly pass a name that's already used.
1555 May raise ValueError if an insufficient number of points is passed or if
1556 the number of values passed don't group into points without leftovers.
1557 </source>
1558 <translation>createPolygon(list, ["name"]) -> string
1559
1560 Creates a new polygon and returns its name. The points for the polygon are
1561 stored in the list "list" in the following order: [x1, y1, x2, y2...xn. yn].
1562 At least three points are required. There is no need to repeat the first point
1563 to close the polygon. The polygon is automatically closed by connecting the
1564 first and the last point. The coordinates are given in the current measurement
1565 units of the document (see UNIT constants). "name" should be a unique
1566 identifier for the object because you need this name for further access to that
1567 object. If "name" is not given Scribus will create one for you.
1568
1569 May raise NameExistsError if you explicitly pass a name that's already used.
1570 May raise ValueError if an insufficient number of points is passed or if
1571 the number of values passed don't group into points without leftovers.
1572 </translation>
1573 </message>
1574 <message>
1575 <source>createBezierLine(list, ["name"]) -> string
1576
1577 Creates a new bezier curve and returns its name. The points for the bezier
1578 curve are stored in the list "list" in the following order:
1579 [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn. kyn]
1580 In the points list, x and y mean the x and y coordinates of the point and kx
1581 and ky meaning the control point for the curve. The coordinates are given in
1582 the current measurement units of the document (see UNIT constants). "name"
1583 should be a unique identifier for the object because you need this name for
1584 further access to that object. If "name" is not given Scribus will create one
1585 for you.