1 <?xml version="1.0" encoding="UTF-8"?>
5 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
7 * Copyright (C) INRIA - Fabrice Leray
12 * Copyright (C) 2012 - 2016 - Scilab Enterprises
14 * This file is hereby licensed under the terms of the GNU GPL v2.0,
15 * pursuant to article 5.3.4 of the CeCILL v.2.1.
16 * This file was originally licensed under the terms of the CeCILL v2.1,
17 * and continues to be available under such terms.
18 * For more information, see the COPYING file which you should have received
19 * along with this program.
25 <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="ja" xml:id="object_editor">
29 <refname>object_editor </refname>
31 <refpurpose>グラフィックオブジェクトエディタの機能に関する説明</refpurpose>
35 <refnamediv xml:id="graphic">
37 <refname>graphic </refname>
39 <refpurpose>グラフィックオブジェクトエディタの機能に関する説明</refpurpose>
43 <refnamediv xml:id="menus">
45 <refname>menus</refname>
47 <refpurpose>グラフィックオブジェクトエディタの機能に関する説明</refpurpose>
55 <para>Scilab graphics allow the
57 user to have interaction with graphics before and after having them
59 drawn. Each graphics window and the
61 drawing it contains are represented by hierarchical entities. The hierachy
63 top level is the Figure. Each Figure defines at least one child of type
65 Axes. Each Axes entity contains a set of leaf entities which are the basic
67 graphics objects like Polylines, Rectangles, Arcs, Segs,... It can also
69 contain a Compound type which are recursive sets of entities.
73 <para>The main interest of the graphic mode is to make property changes
75 easier. This graphics'mode provides a set of high-level graphing
77 routines (see <link linkend="set">set</link>, <link linkend="get">get</link>) used to control objects'
79 properties such as data, coordinates and scaling, color and appearences
81 without requiring to replay the initial graphics commands.
85 <para>Graphics entities are associated to Scilab variables of type
87 <literal>handle</literal>. The handle is a unique identifier which is associated
89 to each instance of a created graphical entity. Using this handle, it will
91 be possible to reach entities' properties through "set" and "get"
93 routines. The handles are also used to manipulate graphics objects, to
95 move them, to make copies or delete them.
99 <para>To complete and use the graphics handle capacity at its maximum, a
101 graphic object editor has been created too. It is a set of Tcl/Tk
103 interfaces available for each kind of graphics objects (see
105 <link linkend="graphics_entities">graphics_entities</link> for more details) that can be enabled for
107 each graphic window. To make it work, select the <literal>Edit</literal> menu in
109 the graphic window. Seven graphics editing operations are available :
119 <term>Select figure as current: </term>
123 <para>Let this</para>
125 <para>figure be the current one.</para>
135 <term>Redraw figure: </term>
139 <para>Redraw the content of the graphics window.</para>
149 <term>Erase figure: </term>
153 <para>Erase the content of the graphics window. Its action corresponds
155 to <literal>clf</literal> routine.
167 <term>Copy object: </term>
171 <para>Using the mouse, it allows the user to select a 2D object (like a
173 curve, a rectangle...) and put it in the clipboard. Thus, by a next
175 call to <literal>Paste object</literal>, the object is copied in the
177 selected current axes.
189 <term>Paste object: </term>
193 <para>Allow the user to paste a previous object put into in the
195 clipboard inside the selected current axes.
207 <term>Move object: </term>
211 <para>Using the mouse, it allows the user to move a 2D object (like a
213 curve, a rectangle...) inside the selected current axes.
225 <term>Delete object: </term>
229 <para>Using the mouse, it allows the user to pick up a 2D object (like a
231 curve, a rectangle...) inside the selected current axes and to delete
245 <term>Figure Properties: </term>
249 <para>Launch the Tcl/Tk interface for the Figure object applied to the
251 figure handle of the graphics window.
263 <term>Current Axes Properties: </term>
267 <para>Launch the Tcl/Tk interface for the Axes object applied to the
269 current axes handle of the graphics window.
281 <term>Start Entity Picker: </term>
285 <para>Start an event handler on the graphics window to catch the mouse
287 clicks on graphics objects and launch the corresponding Tcl/Tk
289 interface. The left mouse-click allows object edition and the right
291 click performs a move of the selected object. Note that, for now, this
293 feature is applied to 2D objects only.
305 <term>Stop Entity Picker: </term>
309 <para>Stop the action of the Entity Picker by terminating the event
311 handler on the graphics window.
325 Once the graphic interface is enabled (using the <literal>Figure
331 or <literal>Current Axes Properties</literal> options), two
345 <term>A tree selector: </term>
349 <para>Placed on the left side of the graphical editor, a hierarchical
351 tree selector specifies which object is currently edited. It can be
353 used to switch from a graphic object to another provided that they are
355 in the same graphic window.
371 <imagedata fileref="../images/tree.gif"/>
385 <term>A notebook: </term>
389 <para>The second area represents a notebook composed with different
391 properties pages (like <literal>Style</literal>, <literal>Data</literal>,
393 <literal>Clipping</literal>...) depending on the selected graphic object.
395 Using this editor, man can edit more easily the whole properties set
397 of each graphic object (like through the <literal>"set"</literal> and
399 <literal>"get"</literal> commands). Here is an example of the axes' notebook
401 displaying axes properties:
417 <imagedata fileref="../images/notebook.gif"/>
427 <para>Furthermore, you can legend/annotate your figure using sample
429 primitives given inside the <literal>Insert</literal> menu in the graphic
431 window. Using the mouse and following the instruction in the message
433 subwindow, you can add a:
447 <para>Draw a line between 2 left mouse clicks. The line lives in the
449 axes where the first point was selected.
465 <term>Polyline: </term>
469 <para>Draw a polyline by clicking on the left button to define the line
471 path and right click at last to complete the drawing. The polyline
473 lives in the axes where the first point was selected.
493 <para>Draw an arrow between 2 left mouse clicks. The arrow lives in the
495 axes where the first point was selected.
511 <term>Double arrow: </term>
515 <para>Draw a double-sided arrow between 2 left mouse clicks. The double
517 arrow lives in the axes where the first point was selected.
537 <para>Open a dialog box to enter the text, then click on the figure
539 window to place it. The text lives in the axes where the point was
557 <term>Rectangle: </term>
561 <para>Draw a rectangle : 2 left mouse clicks define respectively the
563 upper left corner and the lower-right corner of the rectangle. The
565 rectangle lives in the axes where the first point was selected.
581 <term>Circle: </term>
585 <para>Draw a circle : 2 left mouse clicks define respectively the upper
587 left corner and the lower-right corner of the bounding-box where the
589 circle lives. The rectangle lives in the axes where the first point
607 <simplelist type="inline">
611 <link linkend="graphics_entities">graphics_entities</link>
617 <link linkend="set">set</link>
623 <link linkend="get">get</link>
629 <link linkend="clf">clf</link>
635 <link linkend="plot">plot</link>