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