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