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