Author: jghali
Date: Sat Apr 13 15:30:51 2019
New Revision: 22945
URL: http://scribus.net/websvn/listing.php?repname=Scribus&sc=1&rev=22945
Log:
Restore ability to define OpenType features in scripter createCharStyle()
This ability was removed in r22923. Restore it in a way that will not break
existing 1.4.x scripts
Modified:
trunk/Scribus/doc/de/scripterapi-object.html
trunk/Scribus/doc/en/scripterapi-object.html
trunk/Scribus/doc/fr/scripterapi-object.html
trunk/Scribus/doc/it/scripterapi-object.html
trunk/Scribus/scribus/plugins/scriptplugin/cmdstyle.cpp
Modified: trunk/Scribus/doc/de/scripterapi-object.html
URL:
http://scribus.net/websvn/diff.php?repname=Scribus&rev=22945&path=/trunk/Scribus/doc/de/scripterapi-object.html
==============================================================================
--- trunk/Scribus/doc/de/scripterapi-object.html (original)
+++ trunk/Scribus/doc/de/scripterapi-object.html Sat Apr 13 15:30:51 2019
@@ -10,6 +10,11 @@
<h2>Creating and Destroying Objects</h2>
<dl>
+
+<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
+<dd><code>createBezierLine(list, ["name"]) -> string</code>
+<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
+<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createCharStyle"><strong>createCharStyle</strong></a>(...)</dt>
<dd><code>createCharStyle(...)</code>
@@ -34,8 +39,8 @@
<li>smallcaps</li>
</ul>
</li>
-<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
and 6th parameters - 5th is string, 6th is float 1.0 = 100%)</li>
-<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th and 8th parameters - 7th is string, 8th is float 1.0 = 100%)</li>
+<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
parameter: string, 6th parameter: a float 1.0 = 100%)</li>
+<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th parameter: string, 8th parameter: a float 1.0 = 100%)</li>
<li>baselineoffset [optional] -> offset of the baseline (ninth parameter)</li>
<li>shadowxoffset [optional], shadowyoffset [optional] -> offset of the shadow
if used (10th and 11th parameters)</li>
<li>outlinewidth [optional] -> width of the outline if used (12th
parameter)</li>
@@ -44,6 +49,65 @@
<li>scaleh [optional], scalev [optional] -> scale of the chars (17th and 18th
parameters - float values, 1.0 = 100%)</li>
<li>tracking [optional] -> tracking of the text (19th parameter - number with
odd math, e.g. -50 = -5.0%)</li>
<li>"language" [optional] -> language code (20th parameter - a string en =
English)</li>
+<li>"fontfeatures" [optional] -> a string that contains a comma-separated list
of OpenType font features (21th parameter - a string):
+<ul>
+ <li>Ligatures:
+ <ul>
+ <li>-liga: disable common ligatures</li>
+ <li>-clig: disable contextual ligatures</li>
+ <li>+dlig: enable discretionary ligatures</li>
+ <li>+hlig: enable historical ligatures</li>
+ </ul>
+ </li>
+ <li>Script Position:
+ <ul>
+ <li>+subs: enable subscript</li>
+ <li>+sups: enable superscript</li>
+ <li>+ordn: enable ordinals</li>
+ </ul>
+ </li>
+ <li>Capitals:
+ <ul>
+ <li>+smcp: enable small capitals</li>
+ <li>+c2sc: enable small capitals from capitals</li>
+ <li>+pcap: enable petite capitals</li>
+ <li>+c2pc: enable petite capitals from capitals</li>
+ <li>+unic: enable unicase</li>
+ <li>+titl: enable titling</li>
+ </ul>
+ </li>
+ <li>Numerals:
+ <ul>
+ <li>+lnum: enable lining figures</li>
+ <li>+tnum: enable old style numerals</li>
+ </ul>
+ </li>
+ <li>Numeral Width:
+ <ul>
+ <li>+pnum: enable proportional figures</li>
+ <li>+tnum: enable tabular figures</li>
+ </ul>
+ </li>
+ <li>Numeral Fractions:
+ <ul>
+ <li>+frac: enable diagonal fractions</li>
+ <li>+afrc: enable stacked fractions</li>
+ </ul>
+ </li>
+ <li>Numeral zero:
+ <ul>
+ <li>+zero: enable slashed zero</li>
+ </ul>
+ </li>
+ <li>Style sets:
+ <ul>
+ <li>+ss01: enable 1st style set</li>
+ <li>...</li>
+ <li>+ss20: enable 20th style set</li>
+ </ul>
+ </li>
+</ul>
+</li>
</ul>
</p>
<p>On a practical level, this is a challenging command to fully understand if
you wish to assign a number of settings, since keeping track of where you are,
and which kind of entry is needed (string vs number) is not easy. For some
guidance on this showing in particular how to set tracking, see the wiki page
<a href="https://wiki.scribus.net/canvas/Text_and_Text_Manipulation";>Text and
Text Manipulation</a>.</p>
@@ -63,11 +127,6 @@
</ul>
</p>
</dd>
-
-<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
-<dd><code>createBezierLine(list, ["name"]) -> string</code>
-<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
-<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createEllipse"><strong>createEllipse</strong></a>(...)</dt>
<dd><code>createEllipse(x, y, width, height, ["name"]) -> string</code>
Modified: trunk/Scribus/doc/en/scripterapi-object.html
URL:
http://scribus.net/websvn/diff.php?repname=Scribus&rev=22945&path=/trunk/Scribus/doc/en/scripterapi-object.html
==============================================================================
--- trunk/Scribus/doc/en/scripterapi-object.html (original)
+++ trunk/Scribus/doc/en/scripterapi-object.html Sat Apr 13 15:30:51 2019
@@ -10,6 +10,11 @@
<h2>Creating and Destroying Objects</h2>
<dl>
+
+<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
+<dd><code>createBezierLine(list, ["name"]) -> string</code>
+<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
+<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createCharStyle"><strong>createCharStyle</strong></a>(...)</dt>
<dd><code>createCharStyle(...)</code>
@@ -34,8 +39,8 @@
<li>smallcaps</li>
</ul>
</li>
-<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
and 6th parameters - 5th is string, 6th is float 1.0 = 100%)</li>
-<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th and 8th parameters - 7th is string, 8th is float 1.0 = 100%)</li>
+<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
parameter: string, 6th parameter: a float 1.0 = 100%)</li>
+<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th parameter: string, 8th parameter: a float 1.0 = 100%)</li>
<li>baselineoffset [optional] -> offset of the baseline (ninth parameter)</li>
<li>shadowxoffset [optional], shadowyoffset [optional] -> offset of the shadow
if used (10th and 11th parameters)</li>
<li>outlinewidth [optional] -> width of the outline if used (12th
parameter)</li>
@@ -44,6 +49,65 @@
<li>scaleh [optional], scalev [optional] -> scale of the chars (17th and 18th
parameters - float values, 1.0 = 100%)</li>
<li>tracking [optional] -> tracking of the text (19th parameter - number with
odd math, e.g. -50 = -5.0%)</li>
<li>"language" [optional] -> language code (20th parameter - a string en =
English)</li>
+<li>"fontfeatures" [optional] -> a string that contains a comma-separated list
of OpenType font features (21th parameter - a string):
+<ul>
+ <li>Ligatures:
+ <ul>
+ <li>-liga: disable common ligatures</li>
+ <li>-clig: disable contextual ligatures</li>
+ <li>+dlig: enable discretionary ligatures</li>
+ <li>+hlig: enable historical ligatures</li>
+ </ul>
+ </li>
+ <li>Script Position:
+ <ul>
+ <li>+subs: enable subscript</li>
+ <li>+sups: enable superscript</li>
+ <li>+ordn: enable ordinals</li>
+ </ul>
+ </li>
+ <li>Capitals:
+ <ul>
+ <li>+smcp: enable small capitals</li>
+ <li>+c2sc: enable small capitals from capitals</li>
+ <li>+pcap: enable petite capitals</li>
+ <li>+c2pc: enable petite capitals from capitals</li>
+ <li>+unic: enable unicase</li>
+ <li>+titl: enable titling</li>
+ </ul>
+ </li>
+ <li>Numerals:
+ <ul>
+ <li>+lnum: enable lining figures</li>
+ <li>+tnum: enable old style numerals</li>
+ </ul>
+ </li>
+ <li>Numeral Width:
+ <ul>
+ <li>+pnum: enable proportional figures</li>
+ <li>+tnum: enable tabular figures</li>
+ </ul>
+ </li>
+ <li>Numeral Fractions:
+ <ul>
+ <li>+frac: enable diagonal fractions</li>
+ <li>+afrc: enable stacked fractions</li>
+ </ul>
+ </li>
+ <li>Numeral zero:
+ <ul>
+ <li>+zero: enable slashed zero</li>
+ </ul>
+ </li>
+ <li>Style sets:
+ <ul>
+ <li>+ss01: enable 1st style set</li>
+ <li>...</li>
+ <li>+ss20: enable 20th style set</li>
+ </ul>
+ </li>
+</ul>
+</li>
</ul>
</p>
<p>On a practical level, this is a challenging command to fully understand if
you wish to assign a number of settings, since keeping track of where you are,
and which kind of entry is needed (string vs number) is not easy. For some
guidance on this showing in particular how to set tracking, see the wiki page
<a href="https://wiki.scribus.net/canvas/Text_and_Text_Manipulation";>Text and
Text Manipulation</a>.</p>
@@ -63,11 +127,6 @@
</ul>
</p>
</dd>
-
-<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
-<dd><code>createBezierLine(list, ["name"]) -> string</code>
-<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
-<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createEllipse"><strong>createEllipse</strong></a>(...)</dt>
<dd><code>createEllipse(x, y, width, height, ["name"]) -> string</code>
Modified: trunk/Scribus/doc/fr/scripterapi-object.html
URL:
http://scribus.net/websvn/diff.php?repname=Scribus&rev=22945&path=/trunk/Scribus/doc/fr/scripterapi-object.html
==============================================================================
--- trunk/Scribus/doc/fr/scripterapi-object.html (original)
+++ trunk/Scribus/doc/fr/scripterapi-object.html Sat Apr 13 15:30:51 2019
@@ -1,99 +1,211 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
- <title>Créer et détruire les objets</title>
+ <title>Créer et détruire les objets</title>
</head>
<body>
-<h2>Créer et détruire les objets</h2>
+<h2>Créer et détruire les objets</h2>
<dl>
<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
-<dd><tt>createBezierLine(liste, ["nom"]) -> chaîne</tt>
-<p>Crée une nouvelle courbe de Bézier et retourne son nom. Les
-points de la courbe de bezier sont conservés dans la "liste", dans
+<dd><tt>createBezierLine(liste, ["nom"]) -> chaîne</tt>
+<p>Crée une nouvelle courbe de Bézier et retourne son nom. Les
+points de la courbe de bezier sont conservés dans la "liste", dans
l'ordre suivant: [x1, y1, kx1, ky1, x2, y2, kx2, ky2...xn. yn, kxn.
-kyn] Dans la liste de points, x et y sont les coordonnées x et y du
-point et kx et ky représentent le point de contrôle de la courbe.
Les coordonnées sont fournies dans les unités de mesure du
document (voir les constantes UNIT). La
-valeur de "nom" doit être un identifiant unique parce que vous en
-aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est
pas
-fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé. Peut
-générer ValueError si le nombre de points précisé
est insuffisant
-ou si le nombre de valeurs passées ne forme pas un groupe de points
+kyn] Dans la liste de points, x et y sont les coordonnées x et y du
+point et kx et ky représentent le point de contrôle de la courbe. Les
coordonnées sont fournies dans les unités de mesure du document (voir les
constantes UNIT). La
+valeur de "nom" doit être un identifiant unique parce que vous en
+aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est pas
+fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé. Peut
+générer ValueError si le nombre de points précisé est insuffisant
+ou si le nombre de valeurs passées ne forme pas un groupe de points
entier, sans reste.</p></dd>
+<dt><a name="-createCharStyle"><strong>createCharStyle</strong></a>(...)</dt>
+<dd><code>createCharStyle(...)</code>
+<p>Crée un style de caractère. Cette function accepte les paramètres
nommés suivants:
+<ul>
+<li>"name" [requis] -> nom du style de caractère à créer (premier
paramètre)</li>
+<li>"font" [optionnel] -> nom de la police de caractère à utiliser (second
paramètre)</li>
+<li>fontsize [optionnel] -> taille de la police de caractère (3ème
paramètre - nombre réel)</li>
+<li>"features" [optionnel] -> détails typographiques définis sous la forme
d'une liste d'éléments séparés par des virgules (sans espaces!), pris
parmis les éléments suivants (4ème paramètre - chaîne de caractère):
+<ul>
+ <li>inherit</li>
+ <li>bold</li>
+ <li>italic</li>
+ <li>underline</li>
+ <li>underlinewords</li>
+ <li>strike</li>
+ <li>superscript</li>
+ <li>subscript</li>
+ <li>outline</li>
+ <li>shadowed</li>
+ <li>allcaps</li>
+ <li>smallcaps</li>
+</ul>
+</li>
+<li>"fillcolor" [optionnel], fillshade [optionnel] -> définie la couleur et
la teinte de fond (5ème paramètre: chaîne, 6ème paramètre: nombre réel
1.0 = 100%)</li>
+<li>"strokecolor" [optionnel], strokeshade [optionnel] -> définie la couleur
et la teinte de filet (7ème paramètre: chaîne, 8ème paramètre: nombre
réel 1.0 = 100%)</li>
+<li>baselineoffset [optionnel] -> décalage par rapport à la ligne de
base(9ème paramètre)</li>
+<li>shadowxoffset [optionnel], shadowyoffset [optionnel] -> décalages de
l'ombre portée si celle-ci est utilisée(10ème et 11ème paramètres)</li>
+<li>outlinewidth [optionnel] -> largeur du filet si celui-ci est utilisé
(12ème paramètre)</li>
+<li>underlineoffset [optionnel], underlinewidth [optionnel] -> options de
soulignement si utilisé (13ème et 14ème paramètres)</li>
+<li>strikethruoffset [optionnel], strikethruwidth [optionnel] -> options de
barré si utilisé (15ème et 16ème paramètres)</li>
+<li>scaleh [optionnel], scalev [optionnel] -> échelle horizontale et
verticale des caractères (17ème et 18ème paramètres - nombres réels, 1.0 =
100%)</li>
+<li>tracking [optionnel] -> valeur d'approche du texte(19ème paramètre -
nombre réel, e.g. -50 = -5.0%)</li>
+<li>"language" [optionnel] -> code de language (20ème paramètre - chaîne de
caractère: en = English)</li>
+<li>"fontfeatures" [optionnel] -> chaîne de caractère contenant une liste de
fonctionnalités OpenType séparées par des virgules (21ème paramètre):
+<ul>
+ <li>Ligatures:
+ <ul>
+ <li>-liga: désactive les ligatures commmunes</li>
+ <li>-clig: désactive les ligatures contextuelles</li>
+ <li>+dlig: active les ligatures discrétionnaires</li>
+ <li>+hlig: active les ligatures historiques</li>
+ </ul>
+ </li>
+ <li>Script Position:
+ <ul>
+ <li>+subs: active les indices</li>
+ <li>+sups: active les exposants</li>
+ <li>+ordn: active les ordinaux</li>
+ </ul>
+ </li>
+ <li>Capitals:
+ <ul>
+ <li>+smcp: active les petites capitales</li>
+ <li>+c2sc: active les capitales en petites capitales</li>
+ <li>+pcap: active les petite caps</li>
+ <li>+c2pc: active les capitales en les petite caps</li>
+ <li>+unic: active l'écriture unicamérale</li>
+ <li>+titl: active le titrage</li>
+ </ul>
+ </li>
+ <li>Numerals:
+ <ul>
+ <li>+lnum: active les chiffres alignés</li>
+ <li>+tnum: active les chiffres en style ancien</li>
+ </ul>
+ </li>
+ <li>Numeral Width:
+ <ul>
+ <li>+pnum: active la largeur de chiffre proportionnelle</li>
+ <li>+tnum: active la largeur de chiffre tabulaire</li>
+ </ul>
+ </li>
+ <li>Numeral Fractions:
+ <ul>
+ <li>+frac: active les fractions diagonales</li>
+ <li>+afrc: active les fractions empilées</li>
+ </ul>
+ </li>
+ <li>Numeral zero:
+ <ul>
+ <li>+zero: active le zéro barré</li>
+ </ul>
+ </li>
+ <li>Style sets:
+ <ul>
+ <li>+ss01: active le 1er jeu de style</li>
+ <li>...</li>
+ <li>+ss20: active le 20ème jeu de style</li>
+ </ul>
+ </li>
+</ul>
+</li>
+</ul>
+</p>
+<p>On a practical level, this is a challenging command to fully understand if
you wish to assign a number of settings, since keeping track of where you are,
and which kind of entry is needed (string vs number) is not easy. For some
guidance on this showing in particular how to set tracking, see the wiki page
<a href="https://wiki.scribus.net/canvas/Text_and_Text_Manipulation";>Text and
Text Manipulation</a>.</p>
+</dd>
+
+<dt><a
name="-createCustomLineStyle"><strong>createCustomLineStyle</strong></a>(...)</dt>
+<dd><code>createCustomLineStyle(nomStyle, style)</code>
+<p>Crée le style de filet personnalisé 'nomStyle'.</p>
+<p>Cette fonction accepte une liste de dictonnaires en tant que paramètre du
style. Chaque dictionnaire représente un sous-filet du style et accepte les
clés suivantes:
+<ul>
+<li>Color [optionnel] -> nom de la couleur à utiliser (chaîne)</li>
+<li>Dash [optionnel] -> type de ligne à utiliser (entier)</li>
+<li>LineEnd [optionnel] -> type de fin de filet à utiliser (entier)</li>
+<li>LineJoin [optionnel] -> type de jointure de filet à utiliser
(entier)</li>
+<li>Shade [optionnel] -> teinte de couleur (entier)</li>
+<li>Width [optionnel] -> largeur de filet (nombre réel entier)</li>
+</ul>
+</p>
+</dd>
+
<dt><a name="-createEllipse"><strong>createEllipse</strong></a>(...)</dt>
-<dd><tt>createEllipse(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
-<p>Crée une nouvelle ellipse dans la page courante et retourne son nom.
Les coordonnées sont données dans les unités de mesure du
document (voir les constantes UNIT). La
-valeur de "nom" doit être un identifiant unique parce que vous en
-aurez besoin pour accéder plus tard à l'objet
désigné. Si "nom" n'est pas fourni, Scribus en créera un
pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd></dt>
+<dd><tt>createEllipse(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
+<p>Crée une nouvelle ellipse dans la page courante et retourne son nom. Les
coordonnées sont données dans les unités de mesure du document (voir les
constantes UNIT). La
+valeur de "nom" doit être un identifiant unique parce que vous en
+aurez besoin pour accéder plus tard à l'objet désigné. Si "nom" n'est pas
fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd></dt>
<dt><a name="-createImage"><strong>createImage</strong></a>(...)</dt>
-<dd><tt>createImage(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
-<p>Crée un nouveau cadre d'image dans la page courante et retourne son
nom. Les coordonnées sont affichées dans les unités de
mesure du document.
-La valeur de "nom" doit être un identifiant unique parce que vous en
aurez besoin pour accéder plus tard à cet objet. Si "nom" n'est
pas fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
+<dd><tt>createImage(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
+<p>Crée un nouveau cadre d'image dans la page courante et retourne son nom.
Les coordonnées sont affichées dans les unités de mesure du document.
+La valeur de "nom" doit être un identifiant unique parce que vous en aurez
besoin pour accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus
en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
<dt><a name="-createLine"><strong>createLine</strong></a>(...)</dt>
-<dd><tt>createLine(x1, y1, x2, y2, ["nom"]) -> chaîne</tt>
-<p>Crée une nouvelle ligne à partir du point(x1, y1) et du
point(x2, y2) et retourne son nom. Les coordonnées sont affichées
dans les unités de mesure du document (voir les constantes UNIT). La
valeur de "nom" doit être un identifiant unique parce que vous en aurez
besoin pour accéder plus tard à cet objet.
-Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
+<dd><tt>createLine(x1, y1, x2, y2, ["nom"]) -> chaîne</tt>
+<p>Crée une nouvelle ligne à partir du point(x1, y1) et du point(x2, y2) et
retourne son nom. Les coordonnées sont affichées dans les unités de mesure
du document (voir les constantes UNIT). La valeur de "nom" doit être un
identifiant unique parce que vous en aurez besoin pour accéder plus tard Ã
cet objet.
+Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
<dt><a name="-createPathText"><strong>createPathText</strong></a>(...)</dt>
-<dd><tt>createPathText(x, y, "boiteTexte", "courbeBezier", ["nom"]) ->
chaîne</tt>
-<p>Crée un nouveau pathText en combinant les deux objets "boîte
de texte" et "courbe de Bézier", puis retourne son nom. Les
coordonnées sont affichées dans les unités de mesure du
document (voir les constantes UNIT). La valeur de "nom" doit être un
identifiant unique parce que vous en aurez besoin pour accéder plus tard
à cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour
vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
-Peut générer <a
href="scripterapi.html#NotFoundError">NotFoundError</a> si l'un des objets de
base (ou les deux) n'existent pas.</p></dd>
+<dd><tt>createPathText(x, y, "boiteTexte", "courbeBezier", ["nom"]) ->
chaîne</tt>
+<p>Crée un nouveau pathText en combinant les deux objets "boîte de texte" et
"courbe de Bézier", puis retourne son nom. Les coordonnées sont affichées
dans les unités de mesure du document (voir les constantes UNIT). La valeur de
"nom" doit être un identifiant unique parce que vous en aurez besoin pour
accéder plus tard à cet objet. Si "nom" n'est pas fourni, Scribus en créera
un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
+Peut générer <a href="scripterapi.html#NotFoundError">NotFoundError</a> si
l'un des objets de base (ou les deux) n'existent pas.</p></dd>
<dt><a name="-createPolyLine"><strong>createPolyLine</strong></a>(...)</dt>
-<dd><tt>createPolyLine(liste, ["nom"]) -> chaîne</tt>
-<p>Crée un nouveau polyline et retourne son nom. Les points de
l'élément polyline sont conservés dans la "liste", dans
l'ordre suivant : [x1, y1, x2, y2...xn. yn]. Les coordonnées sont
données dans les unités de mesure du document (voir les
constantes UNIT). La valeur de "nom" doit être un identifiant unique
parce que vous en aurez besoin pour accéder plus tard à cet
objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
-Peut générer ValueError si le nombre de points
précisé est insuffisant ou si le nombre de valeurs passées
ne forme pas un groupe de points entier, sans reste.</p></dd>
+<dd><tt>createPolyLine(liste, ["nom"]) -> chaîne</tt>
+<p>Crée un nouveau polyline et retourne son nom. Les points de l'élément
polyline sont conservés dans la "liste", dans l'ordre suivant : [x1, y1, x2,
y2...xn. yn]. Les coordonnées sont données dans les unités de mesure du
document (voir les constantes UNIT). La valeur de "nom" doit être un
identifiant unique parce que vous en aurez besoin pour accéder plus tard Ã
cet objet. Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
+Peut générer ValueError si le nombre de points précisé est insuffisant ou
si le nombre de valeurs passées ne forme pas un groupe de points entier, sans
reste.</p></dd>
<dt><a name="-createPolygon"><strong>createPolygon</strong></a>(...)</dt>
-<dd><tt>createPolygon(liste, ["nom"]) -> chaîne</tt>
-<p>Crée un nouveau polygone et retourne son nom. Les points du polygone
sont conservés dans la "liste", dans l'ordre suivant: [x1, y1, x2,
y2...xn. yn].
-Au moins trois points sont requis. Il n'est pas nécessaire de
répéter le premier point pour fermer le polygone. Le polygone se
ferme automatiquement avec la connexion du premier et du dernier point. Les
coordonnées sont données dans les unités de mesure du
document (voir les constantes UNIT). La valeur de "nom" doit être un
identifiant unique parce que vous en aurez besoin pour accéder plus tard
à cet objet.
-Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
-Peut générer ValueError si le nombre de points
précisé est insuffisant ou si le nombre de valeurs passées
ne forme pas un groupe de points entier, sans reste.</p></dd>
+<dd><tt>createPolygon(liste, ["nom"]) -> chaîne</tt>
+<p>Crée un nouveau polygone et retourne son nom. Les points du polygone sont
conservés dans la "liste", dans l'ordre suivant: [x1, y1, x2, y2...xn. yn].
+Au moins trois points sont requis. Il n'est pas nécessaire de répéter le
premier point pour fermer le polygone. Le polygone se ferme automatiquement
avec la connexion du premier et du dernier point. Les coordonnées sont
données dans les unités de mesure du document (voir les constantes UNIT). La
valeur de "nom" doit être un identifiant unique parce que vous en aurez besoin
pour accéder plus tard à cet objet.
+Si "nom" n'est pas fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.
+Peut générer ValueError si le nombre de points précisé est insuffisant ou
si le nombre de valeurs passées ne forme pas un groupe de points entier, sans
reste.</p></dd>
<dt><a name="-createRect"><strong>createRect</strong></a>(...)</dt>
-<dd><tt>createRect(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
-<p>Crée un nouveau rectangle dans la page courante et retourne son nom.
Les coordonnées sont données dans les unités de mesure du
document (voir les constantes UNIT). Le "nom" doit être un identifiant
unique parce que vous en aurez besoin pour des références futures
à l'objet désigné. Si "nom" n'est pas fourni, Scribus en
créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
+<dd><tt>createRect(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
+<p>Crée un nouveau rectangle dans la page courante et retourne son nom. Les
coordonnées sont données dans les unités de mesure du document (voir les
constantes UNIT). Le "nom" doit être un identifiant unique parce que vous en
aurez besoin pour des références futures à l'objet désigné. Si "nom" n'est
pas fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
<dt><a name="-createText"><strong>createText</strong></a>(...)</dt>
-<dd><tt>createText(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
-<p>Crée un nouveau cadre de texte dans la page courante et retourne son
nom. Les coordonnées sont données dans les unités de
mesure du document (voir les constantes UNIT). La valeur de "nom" doit
être un identifiant unique parce que vous en aurez besoin pour
accéder plus tard à l'objet désigné. Si "nom" n'est
pas fourni, Scribus en créera un pour vous.</p>
-<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
+<dd><tt>createText(x, y, largeur, hauteur, ["nom"]) -> chaîne</tt>
+<p>Crée un nouveau cadre de texte dans la page courante et retourne son nom.
Les coordonnées sont données dans les unités de mesure du document (voir les
constantes UNIT). La valeur de "nom" doit être un identifiant unique parce que
vous en aurez besoin pour accéder plus tard à l'objet désigné. Si "nom"
n'est pas fourni, Scribus en créera un pour vous.</p>
+<p>Peut générer <a
href="scripterapi.html#NameExistsError">NameExistsError</a> si vous passez
explicitement un nom déjà utilisé.</p></dd>
<dt><a name="-deleteObject"><strong>deleteObject</strong></a>(...)</dt>
<dd><tt>deleteObject(["nom"])</tt>
-<p>Supprime l'élément portant le nom "nom". Si "nom" n'est pas
-fourni, l'élément sélectionné est
supprimé.</p></dd>
+<p>Supprime l'élément portant le nom "nom". Si "nom" n'est pas
+fourni, l'élément sélectionné est supprimé.</p></dd>
<dt><a name="-getAllStyles"><strong>getAllStyles</strong></a>(...)</dt>
<dd><tt>getAllStyles() -> liste</tt>
-<p>Obsolète. Veuillez utiliser getParagraphStyles() en lieu et
place.</p></dd>
+<p>Obsolète. Veuillez utiliser getParagraphStyles() en lieu et place.</p></dd>
<dt><a name="-getCharStyles"><strong>getCharStyles</strong></a>(...)</dt>
<dd><tt>getCharStyles() -> liste</tt>
-<p>Retourne une liste des noms de l'ensemble des styles de caractère du
document courant.</p></dd>
+<p>Retourne une liste des noms de l'ensemble des styles de caractère du
document courant.</p></dd>
<dt><a
name="-getParagraphStyles"><strong>getParagraphStyles</strong></a>(...)</dt>
<dd><tt>getParagraphStyles() -> liste</tt>
<p>Retourne une liste des noms de l'ensemble des styles de paragraphe du
document courant.</p></dd>
<dt><a name="-objectExists"><strong>objectExists</strong></a>(...)</dt>
-<dd><tt>objectExists(["nom"]) -> booléen</tt>
-<p>Teste si un objet avec le nom spécifié existe
réellement dans le document. Le paramètre optionnel est le nom de
l'objet. Lorsqu'aucun
-nom d'objet n'est donné, retourne la valeur True si un
élément est
-sélectionné.</p></dd>
+<dd><tt>objectExists(["nom"]) -> booléen</tt>
+<p>Teste si un objet avec le nom spécifié existe réellement dans le
document. Le paramètre optionnel est le nom de l'objet. Lorsqu'aucun
+nom d'objet n'est donné, retourne la valeur True si un élément est
+sélectionné.</p></dd>
</dl>
</body>
Modified: trunk/Scribus/doc/it/scripterapi-object.html
URL:
http://scribus.net/websvn/diff.php?repname=Scribus&rev=22945&path=/trunk/Scribus/doc/it/scripterapi-object.html
==============================================================================
--- trunk/Scribus/doc/it/scripterapi-object.html (original)
+++ trunk/Scribus/doc/it/scripterapi-object.html Sat Apr 13 15:30:51 2019
@@ -10,6 +10,11 @@
<h2>Creating and Destroying Objects</h2>
<dl>
+
+<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
+<dd><code>createBezierLine(list, ["name"]) -> string</code>
+<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
+<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createCharStyle"><strong>createCharStyle</strong></a>(...)</dt>
<dd><code>createCharStyle(...)</code>
@@ -34,8 +39,8 @@
<li>smallcaps</li>
</ul>
</li>
-<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
and 6th parameters - 5th is string, 6th is float 1.0 = 100%)</li>
-<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th and 8th parameters - 7th is string, 8th is float 1.0 = 100%)</li>
+<li>"fillcolor" [optional], fillshade [optional] -> specify fill options (5th
parameter: string, 6th parameter: a float 1.0 = 100%)</li>
+<li>"strokecolor" [optional], strokeshade [optional] -> specify stroke options
(7th parameter: string, 8th parameter: a float 1.0 = 100%)</li>
<li>baselineoffset [optional] -> offset of the baseline (ninth parameter)</li>
<li>shadowxoffset [optional], shadowyoffset [optional] -> offset of the shadow
if used (10th and 11th parameters)</li>
<li>outlinewidth [optional] -> width of the outline if used (12th
parameter)</li>
@@ -44,6 +49,65 @@
<li>scaleh [optional], scalev [optional] -> scale of the chars (17th and 18th
parameters - float values, 1.0 = 100%)</li>
<li>tracking [optional] -> tracking of the text (19th parameter - number with
odd math, e.g. -50 = -5.0%)</li>
<li>"language" [optional] -> language code (20th parameter - a string en =
English)</li>
+<li>"fontfeatures" [optional] -> a string that contains a comma-separated list
of OpenType font features (21th parameter - a string):
+<ul>
+ <li>Ligatures:
+ <ul>
+ <li>-liga: disable common ligatures</li>
+ <li>-clig: disable contextual ligatures</li>
+ <li>+dlig: enable discretionary ligatures</li>
+ <li>+hlig: enable historical ligatures</li>
+ </ul>
+ </li>
+ <li>Script Position:
+ <ul>
+ <li>+subs: enable subscript</li>
+ <li>+sups: enable superscript</li>
+ <li>+ordn: enable ordinals</li>
+ </ul>
+ </li>
+ <li>Capitals:
+ <ul>
+ <li>+smcp: enable small capitals</li>
+ <li>+c2sc: enable small capitals from capitals</li>
+ <li>+pcap: enable petite capitals</li>
+ <li>+c2pc: enable petite capitals from capitals</li>
+ <li>+unic: enable unicase</li>
+ <li>+titl: enable titling</li>
+ </ul>
+ </li>
+ <li>Numerals:
+ <ul>
+ <li>+lnum: enable lining figures</li>
+ <li>+tnum: enable old style numerals</li>
+ </ul>
+ </li>
+ <li>Numeral Width:
+ <ul>
+ <li>+pnum: enable proportional figures</li>
+ <li>+tnum: enable tabular figures</li>
+ </ul>
+ </li>
+ <li>Numeral Fractions:
+ <ul>
+ <li>+frac: enable diagonal fractions</li>
+ <li>+afrc: enable stacked fractions</li>
+ </ul>
+ </li>
+ <li>Numeral zero:
+ <ul>
+ <li>+zero: enable slashed zero</li>
+ </ul>
+ </li>
+ <li>Style sets:
+ <ul>
+ <li>+ss01: enable 1st style set</li>
+ <li>...</li>
+ <li>+ss20: enable 20th style set</li>
+ </ul>
+ </li>
+</ul>
+</li>
</ul>
</p>
<p>On a practical level, this is a challenging command to fully understand if
you wish to assign a number of settings, since keeping track of where you are,
and which kind of entry is needed (string vs number) is not easy. For some
guidance on this showing in particular how to set tracking, see the wiki page
<a href="https://wiki.scribus.net/canvas/Text_and_Text_Manipulation";>Text and
Text Manipulation</a>.</p>
@@ -63,11 +127,6 @@
</ul>
</p>
</dd>
-
-<dt><a name="-createBezierLine"><strong>createBezierLine</strong></a>(...)</dt>
-<dd><code>createBezierLine(list, ["name"]) -> string</code>
-<p>Creates a new bezier curve and returns its name. The points for the bezier
curve are stored in the list "list" in the following order: [x1, y1, kx1, ky1,
x2, y2, kx2, ky2...xn. yn, kxn. kyn] In the points list, x and y mean the x and
y coordinates of the point and kx and ky meaning the control point for the
curve. The coordinates are given in the current measurement units of the
document (see UNIT constants). "name" should be a unique identifier for the
object because you need this name for further access to that object. If "name"
is not given Scribus will create one for you.</p>
-<p>May raise <a href="scripterapi.html#NameExistsError">NameExistsError</a> if
you explicitly pass a name that's already used. May raise ValueError if an
insufficient number of points is passed or if the number of values passed don't
group into points without leftovers.</p></dd>
<dt><a name="-createEllipse"><strong>createEllipse</strong></a>(...)</dt>
<dd><code>createEllipse(x, y, width, height, ["name"]) -> string</code>
Modified: trunk/Scribus/scribus/plugins/scriptplugin/cmdstyle.cpp
URL:
http://scribus.net/websvn/diff.php?repname=Scribus&rev=22945&path=/trunk/Scribus/scribus/plugins/scriptplugin/cmdstyle.cpp
==============================================================================
--- trunk/Scribus/scribus/plugins/scriptplugin/cmdstyle.cpp (original)
+++ trunk/Scribus/scribus/plugins/scriptplugin/cmdstyle.cpp Sat Apr 13
15:30:51 2019
@@ -115,6 +115,7 @@
const_cast<char*>("scalev"),
const_cast<char*>("tracking"),
const_cast<char*>("language"),
+ const_cast<char*>("fontfeatures"),
nullptr};
if (!checkHaveDocument())
_______________________________________________
scribus-commit mailing list
[email protected]
http://lists.scribus.net/mailman/listinfo/scribus-commit
