Translation into Russian: GlobalProperty, Graphics, compound_properties and addchapter.
[scilab.git] / scilab / modules / graphics / help / ru_RU / GlobalProperty.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - Fabrice Leray
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="ru" xml:id="GlobalProperty">
14     <refnamediv>
15         <refname>ГлобальноеСвойство</refname>
16         <refpurpose>
17             для настройки вида объектов (кривых, поверхностей, ...) в командах
18             plot или surf
19         </refpurpose>
20     </refnamediv>
21     <refsection>
22         <title>Описание</title>
23         <para>
24             <literal>ГлобальноеСвойство</literal> - это необязательный аргумент,
25             который может использоваться внутри команд <link
26             linkend="plot">plot</link> или <link linkend="surf">surf</link>. Он
27             позволяет глобальную настройку построения всех новых линий
28             (соответственно, поверхностей). Он должен указываться в виде пары
29             {<literal>ИмяСвойства</literal>,<literal>ЗначениеСвойства</literal>}.
30             В <function>plot</function> или <function>surf</function> может быть установлено несколько пар одновременно.
31         </para>
32         <para>
33             <literal>ИмяСвойства</literal> должно быть строкой, определяющей то
34             свойство, которое необходимо установить.
35             <literal>ЗначениеСвойства</literal> может быть вещественным,
36             целочисленным или строкой (скаляром или матрицей) в зависимости от
37             типа используемого свойства. Например, чтобы определить красную
38             (цвет) штрихпунктирную линию с длинными штрихами (стиль линии) с
39             маркерами в виде ромба (маркер), последовательность должна быть:
40             <literal>'Colo'</literal>, <literal>'red'</literal>,
41             <literal>'LineSt'</literal>, <literal>'-.'</literal>,
42             <literal>'Marker'</literal>, <literal>'diam'</literal>.
43         </para>
44         <para>
45             Как видите, не требует полного написания имени каждого свойства и
46             значения однако те аргументы, которые определяются в любом порядке,
47             должны оставаться однозначными. Более того, строковое определение не
48             чувствительно к регистру. <literal>ГлобальноеСвойство</literal> -
49             имеет преимущество над всеми ранее установленными  <literal>ВидамиЛиний</literal>.
50                 </para> 
51         <para>
52             Вот полный список <literal>ИмёнСвойств</literal>, которые вы можете
53             определять (при использовании <link linkend="plot">plot</link> или
54             <link linkend="surf">surf</link>) и их возможные
55             <literal>ЗначенияСвойства</literal>. Если не указано, то те свойства
56             применимы как для объектов <literal>Polyline</literal>, так и
57             объектов <literal>Fac3d</literal> (созданных соответственно с
58             помощью <function>plot</function> или <function>surf</function>) и,
59             как упоминалось ранее, они применяются к новым создаваемым объектам
60             (линиям или поверхностям).
61         </para>
62         <para>
63             Иногда, вы можете иметь два <literal>ИмениСвойства</literal>,
64             соответствующих одному свойству: первое из них эквивалентно по
65             умолчанию имени в Matlab'е, втрое имя по умолчанию используется в Scilab'е.
66             (т.е.: <literal>Color</literal> или <literal>Foreground</literal>
67             для линии, смотрите ниже).
68         </para>
69         <variablelist>
70             <varlistentry>
71                 <term>CData или ColorData: </term>
72                 <listitem>
73                     <para>
74                         матрица вещественных значений, определяющая цвет каждой
75                         точки, определяемой матрицей <literal>Z</literal>. Это
76                         свойство связано со свойством
77                         <literal>data.color</literal> объекта (см.
78                         <link linkend="surface_properties">свойства поверхностей</link>).
79                         Заметьте, что это свойство доступно только для поверхностей.
80                     </para>
81                 </listitem>
82             </varlistentry>
83             <varlistentry>
84                 <term>CDataMapping или ColorDataMapping: </term>
85                 <listitem>
86                     <para>
87                         строка со значением <literal>'scaled'</literal> или
88                         <literal>'direct'</literal>. Если установлен
89                         <literal>data.color</literal>, то каждое значение
90                         индекса цвета определяет отдельное значение для каждой
91                         вершины. <literal>cdata_mapping</literal>
92                         определяет масштабированы ли те индексы для линейного
93                         отображения в текущей цветовой карте ("colormap")
94                         (режим <literal>'scaled'</literal>) или указывает
95                         напрямую на эту цветовую карту (режим
96                         <literal>'direct'</literal>).
97                         Это свойство полезно, когда
98                         <literal>color_flag</literal> равно
99                         <literal>2</literal>, <literal>3</literal> или
100                         <literal>4</literal>.
101                         <note>
102                              Заметьте, что это свойство существует только
103                              у объектов <literal>Fac3d</literal>. Заметьте
104                              также, у <function>plot3d</function> по умолчанию
105                              режим <literal>'direct'</literal>, а у
106                              <function>surf</function> по умолчанию режим
107                              <literal>'scaled'</literal>.
108                         </note>
109                     </para>
110                 </listitem>
111             </varlistentry>
112             <varlistentry>
113                 <term>Clipping: </term>
114                 <listitem>
115                     <para>
116                         строка <literal>"on"</literal> или
117                         <literal>"off"</literal>, определяющая режим обрезки
118                         (по умолчанию - <literal>"on"</literal>). Это
119                         эквивалентно свойству <literal>clip_state</literal>
120                         ("состояние обрезки"). Это поле содержит поле
121                         <literal>visible</literal> ("видимость", см. <link
122                         linkend="polyline_properties">свойства ломаной линии</link>).
123                         <note>
124                             Заметьте, что это свойство пока что не доступно для объектов поверхности.
125                         </note>
126                     </para>
127                 </listitem>
128             </varlistentry>
129             <varlistentry>
130                 <term>Color ("цвет") или Foreground ("передний план"): </term>
131                 <listitem>
132                     <para>
133                         строка, определяющая известный цвет (см. <link
134                         linkend="color_list">color_list</link>, "список цветов")
135                         или RGB-вектор размером <literal>1</literal> на
136                         <literal>3</literal> (или <literal>3</literal> на
137                         <literal>1</literal>), определяющий номер цвета. Номер
138                         цвета задаётся в виде тройки <literal>R</literal>,
139                         <literal>G</literal>, <literal>B</literal>,
140                         соответствующих, соответственно, интенсивности красного,
141                         зелёного и синего между 0 и 1. Это свойство связано со
142                         объектным свойством <literal>foreground</literal>
143                         (передний план, см. <link
144                         linkend="polyline_properties">свойства ломаной
145                         линии</link>).
146                         <warning>
147                             Цвет не доступен для объектов поверхности. Свойство
148                             <literal>Foreground</literal> существует только для
149                             объектов поверхности, но  связано со свойством
150                             <literal>EdgeColor</literal> ("цвет кромки") в Matlab'е (см.
151                             <link linkend="surface_properties">свойства поверхности</link>).
152                         </warning>
153                     </para>
154                 </listitem>
155             </varlistentry>
156             <varlistentry>
157                 <term>EdgeColor ("цвет кромки") или Foreground: </term>
158                 <listitem>
159                     <para>
160                         строка, определяющая известный цвет (см. <link linkend="color_list">color_list</link>) или RGB-вектор размером
161                         <literal>1</literal> на <literal>3</literal> (или
162                         <literal>3</literal> на <literal>1</literal>),
163                         определяющий номер цвета. Номер цвета задаётся в виде
164                         тройки <literal>R</literal>, <literal>G</literal>,
165                         <literal>B</literal>, соответствующих, соответственно,
166                         интенсивности красного, зелёного и синего между 0 и 1.
167                         Это свойство связано со объектным свойством
168                         <literal>foreground</literal> (см. <link
169                         linkend="surface_properties">свойства поверхности</link>).
170                         <warning>
171                             Для объектов <literal>polyline</literal> ("ломаная
172                             линия"), свойство <literal>Foreground</literal>
173                             существует с различными значениями (см. выше), а
174                             <literal>EdgeColor</literal>  вообще отсутствует.
175                         </warning>
176                     </para>
177                 </listitem>
178             </varlistentry>
179             <varlistentry>
180                 <term>FaceColor: </term>
181                 <listitem>
182                     <para>
183                         строка со значением <literal>'none'</literal>,
184                         <literal>'flat'</literal> или <literal>'interp'</literal>,
185                         определяющая способ, которым строятся цвета фацетов.
186                         Когда выбрано <literal>'none'</literal>, то строится
187                         сетка поверхности; если установлено <literal>'flat'</literal>
188                         (режим по умолчанию), то значения <literal>Fac3d</literal>
189                         <literal>color.data</literal> определяют один цвет на
190                         фацет, используя цвет первой вершины фацета. Если
191                         значение <literal>'interp'</literal>, то выполняется
192                         интерполированное затенение на поверхности, используя
193                         <literal>color.data</literal> для определения цвета в
194                         каждой вершине каждого фацета.
195                     </para>
196                 </listitem>
197             </varlistentry>
198             <varlistentry>
199                 <term>LineStyle: </term>
200                 <listitem>
201                     <para>
202                         это значение свойства должно быть строковым,
203                         определяющим стиль линии. Это свойство связано с
204                         объектным свойством <literal>line_style</literal>
205                         ("стиль линии", см. <link
206                         linkend="polyline_properties">свойства ломаной
207                         линии</link> или <link linkend="surface_properties">свойства поверхности</link>).
208                     </para>
209                     <para/>
210                     <informaltable border="1">
211                         <tr>
212                             <td>
213                                 <literal>Определитель</literal>
214                             </td>
215                             <td>
216                                 <literal>Стиль линии</literal>
217                             </td>
218                         </tr>
219                         <tr>
220                             <td>
221                                 <literal>-</literal>
222                             </td>
223                             <td>сплошная линия (по умолчанию)</td>
224                         </tr>
225                         <tr>
226                             <td>
227                                 <literal>--</literal>
228                             </td>
229                             <td>штриховая линия</td>
230                         </tr>
231                         <tr>
232                             <td>
233                                 <literal>:</literal>
234                             </td>
235                             <td>штрихпунктирная линия (две точки)</td>
236                         </tr>
237                         <tr>
238                             <td>
239                                 <literal>-.</literal>
240                             </td>
241                             <td>штрихпунктирная линия (одна точка)</td>
242                         </tr>
243                         <tr>
244                             <td>
245                                 <literal>none</literal>
246                             </td>
247                             <td>нет линии</td>
248                         </tr>
249                     </informaltable>
250                 </listitem>
251             </varlistentry>
252             <varlistentry>
253                 <term>Marker ("маркер") или MarkStyle ("стиль маркера"): </term>
254                 <listitem>
255                     <para>
256                         строка, определяющая тип маркера. Заметьте, что если вы
257                         определяете маркер без стиля линии, то будут нарисованы
258                         и линия (по умолчанию сплошная) и маркер. Это свойство
259                         связано с объектными свойствами <literal>mark_style</literal>
260                         ("стиль маркера") и <literal>mark_mode</literal> ("режим
261                         маркера") (см. <link
262                         linkend="polyline_properties">свойства ломаной линии</link> или
263                         <link linkend="surface_properties">свойства поверхностей</link>).
264                     </para>
265                     <informaltable border="1">
266                         <tr>
267                             <td>
268                                 <literal>Определитель</literal>
269                             </td>
270                             <td>
271                                 <literal>Тип маркера</literal>
272                             </td>
273                         </tr>
274                         <tr>
275                             <td>
276                                 <literal>+</literal>
277                             </td>
278                             <td>знак "плюс"</td>
279                         </tr>
280                         <tr>
281                             <td>
282                                 <literal>o</literal>
283                             </td>
284                             <td>кружок</td>
285                         </tr>
286                         <tr>
287                             <td>
288                                 <literal>*</literal>
289                             </td>
290                             <td>звёздочка</td>
291                         </tr>
292                         <tr>
293                             <td>
294                                 <literal>.</literal>
295                             </td>
296                             <td>точка</td>
297                         </tr>
298                         <tr>
299                             <td>
300                                 <literal>x</literal>
301                             </td>
302                             <td>крестик</td>
303                         </tr>
304                         <tr>
305                             <td>
306                                 <literal>'square'</literal> или
307                                 <literal>'s'</literal>
308                             </td>
309                             <td>квадрат</td>
310                         </tr>
311                         <tr>
312                             <td>
313                                 <literal>'diamond'</literal> или
314                                 <literal>'d'</literal>
315                             </td>
316                             <td>ромб</td>
317                         </tr>
318                         <tr>
319                             <td>
320                                 <literal>^</literal>
321                             </td>
322                             <td>треугольник, указывающий вверх</td>
323                         </tr>
324                         <tr>
325                             <td>
326                                 <literal>v</literal>
327                             </td>
328                             <td>треугольник, указывающий вниз</td>
329                         </tr>
330                         <tr>
331                             <td>
332                                 <literal>&gt;</literal>
333                             </td>
334                             <td>треугольник, указывающий вправо</td>
335                         </tr>
336                         <tr>
337                             <td>
338                                 <literal>&lt;</literal>
339                             </td>
340                             <td>треугольник, указывающий влево</td>
341                         </tr>
342                         <tr>
343                             <td>
344                                 <literal>'pentagram'</literal> или
345                                 <literal>'p'</literal>
346                             </td>
347                             <td>пятиконечная звезда (пентаграмма)</td>
348                         </tr>
349                         <tr>
350                             <td>
351                                 <literal>'none'</literal>
352                             </td>
353                             <td>нет маркера (по умолчанию)</td>
354                         </tr>
355                     </informaltable>
356                 </listitem>
357             </varlistentry>
358             <varlistentry>
359                 <term>MarkerEdgeColor ("цвет кромки маркера") или MarkForeground ("передний план маркера"): </term>
360                 <listitem>
361                     <para>
362                         строка, определяющая известный цвет (см. <link linkend="color_list">color_list</link>) или RGB-вектор размером
363                         <literal>1</literal> на <literal>3</literal> (или
364                         <literal>3</literal> на <literal>1</literal>),
365                         определяющий номер цвета. Номер цвета задаётся в виде
366                         тройки <literal>R</literal>, <literal>G</literal>,
367                         <literal>B</literal>, соответствующих, соответственно,
368                         интенсивности красного, зелёного и синего между 0 и 1.
369                         Это свойство связано со объектным свойством
370                         <literal>mark_foreground</literal> (см. <link
371                         linkend="polyline_properties">свойства ломаной
372                         линии</link> или <link linkend="surface_properties">свойства поверхности</link>).
373                     </para>
374                 </listitem>
375             </varlistentry>
376             <varlistentry>
377                 <term>MarkerFaceColor ("цвет внешней стороны маркера") или MarkBackground ("задний план маркера"): </term>
378                 <listitem>
379                     <para>
380                         строка, определяющая известный цвет (см. <link
381                         linkend="color_list">color_list</link>) или RGB-вектор
382                         размером <literal>1</literal> на <literal>3</literal>
383                         (или <literal>3</literal> на <literal>1</literal>),
384                         определяющий номер цвета. Номер цвета задаётся в виде
385                         тройки <literal>R</literal>, <literal>G</literal>,
386                         <literal>B</literal>, соответствующих, соответственно,
387                         интенсивности красного, зелёного и синего между 0 и 1.
388                         Это свойство связано с объектным свойством
389                         <literal>mark_background</literal> ("фон маркера", см.
390                         <link linkend="polyline_properties">свойства ломаной
391                         линии</link> или <link linkend="surface_properties">свойства поверхности</link>).
392                     </para>
393                 </listitem>
394             </varlistentry>
395             <varlistentry>
396                 <term>MarkerSize ("размер маркера") или MarkSize: </term>
397                 <listitem>
398                     <para>
399                         скаляр, определяющий размер маркера в пунктах (
400                         <literal>point</literal>). Это свойство связано с
401                         объектным свойством <literal>mark_size</literal> с
402                         <literal>mark_size_unit</literal> ("единицы измерения
403                         размера маркера"), установленным в
404                         <literal>"point"</literal> (см
405                         <link linkend="polyline_properties">свойства ломаной линии</link> или
406                         <link linkend="surface_properties">свойства поверхностей</link>).
407                     </para>
408                 </listitem>
409             </varlistentry>
410             <varlistentry>
411                 <term>Visible ("видимость"): </term>
412                 <listitem>
413                     <para>
414                         строковое значение <literal>"on"</literal> ("вкл.") или
415                         <literal>"off"</literal> ("откл."), определяющее  режим
416                         видимости (по умолчанию включён, <literal>"on"</literal>).
417                         Это свойство связано с объектным свойством
418                         <literal>visible</literal> (см.
419                         <link linkend="polyline_properties">свойства ломаной линии</link> или
420                         <link linkend="surface_properties">свойства поверхностей</link>).
421                     </para>
422                 </listitem>
423             </varlistentry>
424             <varlistentry>
425                 <term>X data: </term>
426                 <listitem>
427                     <para>
428                         вектор или матрица вещественных значений,
429                         (пере)определяющих указанные данные для всех построенных
430                         линий или поверхностей. Касательно размеров, обратите
431                         внимание, что эти новые данные должны совпадать со в
432                         определёнными ранее данными <literal>X</literal>: иными словами, все эти матрицы данных должны быть одного размера. Это свойство связано с объектным свойством
433                         <literal>data.x</literal> (см.
434                         <link linkend="polyline_properties">свойства ломаной линии</link> или
435                         <link linkend="surface_properties">свойства поверхностей</link>).
436                     </para>
437                 </listitem>
438             </varlistentry>
439             <varlistentry>
440                 <term>Y data: </term>
441                 <listitem>
442                     <para>
443                         вектор или матрица вещественных значений,
444                         (пере)определяющих указанные данные для всех построенных
445                         линий или поверхностей. Касательно размеров, обратите
446                         внимание, что эти новые данные должны совпадать со в
447                         определёнными ранее данными <literal>Y</literal>: иными словами, все эти матрицы данных должны быть одного размера. Это свойство связано с объектным свойством
448                         <literal>data.y</literal> property (см.
449                         <link linkend="polyline_properties">свойства ломаной линии</link> или
450                         <link linkend="surface_properties">свойства поверхностей</link>).
451                     </para>
452                 </listitem>
453             </varlistentry>
454             <varlistentry>
455                 <term>Z data: </term>
456                 <listitem>
457                     <para>
458                         когда используется в <function>plot</function>, то это
459                         вещественный вектор или матрица, добавляющая данные
460                         <literal>Z</literal> ко всем построенным линиям;
461                         в <function>surf</function> это вещественная матрица,
462                         (пере)определяющая заданные данные для всех
463                         поверхностей. Касательно размеров, заметьте, что новые
464                         данные должны совпадать со всеми ранее определёнными
465                         данными <literal>X</literal> и <literal>Y</literal>. Это
466                         свойство связано с объектным свойством
467                         <literal>data.z</literal> (см. <link
468                         linkend="polyline_properties">свойства ломаной линии</link>
469                         или <link linkend="surface_properties">свойства поверхностей</link>).
470                     </para>
471                 </listitem>
472             </varlistentry>
473         </variablelist>
474     </refsection>
475     <refsection>
476         <title>Примеры</title>
477         <programlisting role="example"><![CDATA[ 
478 // --------------------
479 // С командой plot:
480 // --------------------
481 x=1:10; // Init.
482 plot(x,sin(x),'colo','red','linest','-.','marker','>','markeredg','cyan','markerFace','yellow','markersize',5)
483 clf();
484 // порядок комбинаций {ИмяСвойства,ЗначениеСвойства} не имеет значения
485 plot(x,sin(x),'marker','p','markerfac','cyan','markersiz',10)
486 clf();
487 // комбинация ВидаЛиний и ГлобальногоСвойства показывает преимущество Глобального свойства
488 plot(x,x.*x,'*cya--','color','gr','linestyle','-','marker','sq','markersize',6,'markforegroun','red','markbackgro',[0.2 0.5 0.6])
489 clf();
490 //множество графиков с различными ВидамиЛиний и, наконец, некоторые ГлобальныеСвойства
491 clf();
492 t=0:%pi/20:2*%pi;
493 plot(t,sin(t),'ro-.',t,cos(t),'cya+',t,abs(sin(t)),'--mo','markstyl','diam')
494 // --------------------
495 // С командой plot2d:
496 // --------------------
497 function draw_marks(title)
498   a=gca();
499   a.title.text=title;
500   a.mark_size=8;
501   a.data_bounds=[-1.5 1.5 -1.5 1.5];
502   theta=(1/15)*(2*%pi)*[0:15];
503   plot2d(cos(theta),sin(theta));
504   for i=0:14 do
505     theta=(i/15)*(2*%pi);
506     plot2d(cos(theta),sin(theta),style=-i);
507   end
508 endfunction
509 clf();
510 subplot(2,2,1)
511 draw_marks("чёрный передний план/ белый задний план")
512 subplot(2,2,2)
513 a=gca();
514 a.mark_foreground=-1;
515 a.mark_background=4;
516 draw_marks("чёрный передний план/ синезелёный задний план")
517 subplot(2,2,3)
518 a=gca();
519 a.mark_background=0;
520 draw_marks("чёрный передний план/ невидимый задний план")
521 subplot(2,2,4)
522 a=gca();
523 a.mark_foreground=0;
524 a.mark_background=4;
525 draw_marks("невидимый передний план/ синезелёный задний план")
526 // --------------------
527 // С командой surf:
528 // --------------------
529 Z= [   0.0001    0.0013    0.0053   -0.0299   -0.1809   -0.2465   -0.1100   -0.0168   -0.0008   -0.0000
530     0.0005    0.0089    0.0259   -0.3673   -1.8670   -2.4736   -1.0866   -0.1602   -0.0067    0.0000
531     0.0004    0.0214    0.1739   -0.3147   -4.0919   -6.4101   -2.7589   -0.2779    0.0131    0.0020
532    -0.0088   -0.0871    0.0364    1.8559    1.4995   -2.2171   -0.2729    0.8368    0.2016    0.0130
533    -0.0308   -0.4313   -1.7334   -0.1148    3.0731    0.4444    2.6145    2.4410    0.4877    0.0301
534    -0.0336   -0.4990   -2.3552   -2.1722    0.8856   -0.0531    2.6416    2.4064    0.4771    0.0294
535    -0.0137   -0.1967   -0.8083    0.2289    3.3983    3.1955    2.4338    1.2129    0.2108    0.0125
536    -0.0014   -0.0017    0.3189    2.7414    7.1622    7.1361    3.1242    0.6633    0.0674    0.0030
537     0.0002    0.0104    0.1733    1.0852    2.6741    2.6725    1.1119    0.1973    0.0152    0.0005
538     0.0000    0.0012    0.0183    0.1099    0.2684    0.2683    0.1107    0.0190    0.0014    0.0000];
539 clf();
540 f=gcf();
541 f.figure_size = [610,724];
542 subplot(211)
543 surf(Z,'facecol','interp','ydat',101:110,'edgecol','mage')
544 subplot(212)
545 surf(Z,'edgeco','b','marker','d','markersiz',9,'markerfac','k','xdata',-50:-41)
546  ]]></programlisting>
547     </refsection>
548     <refsection role="see also">
549         <title>Смотрите также</title>
550         <simplelist type="inline">
551             <member>
552                 <link linkend="LineSpec">ВидЛиний</link>
553             </member>
554             <member>
555                 <link linkend="plot">plot</link>
556             </member>
557             <member>
558                 <link linkend="surf">surf</link>
559             </member>
560             <member>
561                 <link linkend="clf">clf</link>
562             </member>
563             <member>
564                 <link linkend="polyline_properties">свойства ломаной линии</link>
565             </member>
566             <member>
567                 <link linkend="surface_properties">свойства поверхностей</link>
568             </member>
569         </simplelist>
570     </refsection>
571 </refentry>