<sect1 id="sect-gui-editor">
    
  <para>
    The editor panel contains four tabs described below.
  </para>
  
 
 <title>The Editor panel</title>
  
     <figure id="fig-interface-editor">
        <title>The toolbar.</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/interface_editor.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase></phrase>
            </textobject>
           </mediaobject>
        </screenshot>
      </figure>

<para>
  <itemizedlist>
  
  <listitem>
      <para>
	<guilabel>The "Editor" Tab (F5)</guilabel>
      </para>
      <para>
        Object edition. User can set object properties there.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>The "Selection" (F6)</guilabel>
      </para>
      <para>
        Object list, organized with layers, and functions to manuipulate them.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>The "Create" Tab (F7)</guilabel>
      </para>
      <para>
        Tree where you can find every primitives suported by Truevision.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>The "Materials" Tab (F8)</guilabel>
      </para>
      <para>
        List of all loaded materials and material manipulation functions.
      </para>
    </listitem>
   </itemizedlist>
 </para>

<sect2 id="sect-gui-objeditor">
    
  <para>
    The object edition tab contains current object properties.
  </para>
  
 
 <title>The Object editor</title>
  
     <figure id="fig-interface-objeditor">
        <title>The object edition.</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/interface_objeditor.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase></phrase>
            </textobject>
           </mediaobject>
        </screenshot>
      </figure>

The object editor is used to set object properties. Some of these are object specific, they will be discussed in object sections. Others are common to all of them :
<para>
  <itemizedlist>
  
  <listitem>
      <para>
	<guilabel>Hide</guilabel>
      </para>
      <para>
        Hide object in Truevision only, not in povray.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Render</guilabel>
      </para>
      <para>
        Render object in povray.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Hollow</guilabel>
      </para>
      <para>
	Make the object 'empty'. This does not affect interior media and may produce strange results with csg operators.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>No shadow ( from Povray 3.6 Documentation )</guilabel>
      </para>
      <para>
	Make the object cast no shadow.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>No image</guilabel>
      </para>
      <para>
	Make the object invisible. But it still cast shadows, and is still participating to reflection, radiosity etc...
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Inverse</guilabel>
      </para>
      <para>
	Inverse the object, making the interior become the exterior. Mostly used with csg operators.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Double illuminate</guilabel>
      </para>
      <para>
	Make surface of the object being illuminated twice : on the exterior side and on the interior side.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Material</guilabel>
      </para>
      <para>
        Specify a material name, loaded in material list.
      </para>
    </listitem>

  <listitem>
      <para>
	<guilabel>Photons</guilabel>
      </para>
      <para> Photons are used by povray to create realistic caustics. An alternative is faked caustics
	defined in material finished. The object behaviour is defined by the following options !
   	<itemizedlist>
 		 <listitem>
 		     <para>
			<guilabel>Target</guilabel>
 		     </para>
  		    <para>
 		        Make the object cause photon caustics.
		      </para>
  		  </listitem>

		 <listitem>
 		     <para>
			<guilabel>Spacing</guilabel>
 		     </para>
  		    <para>
			Define density of photons for the object. In fact it is a multiplier of the general photons
			spacing defined in scene settings.
		      </para>
  		  </listitem>

		 <listitem>
 		     <para>
			<guilabel>Refraction / Reflection</guilabel>
 		     </para>
  		    <para>
			Make the object refract / reflect photons.
		      </para>
  		  </listitem>

		 <listitem>
 		     <para>
			<guilabel>Collect</guilabel>
 		     </para>
  		    <para>
			Make the object receive photon caustics.
		      </para>
  		  </listitem>

		 <listitem>
 		     <para>
			<guilabel>Pass through</guilabel>
 		     </para>
  		    <para>
			The object don't affect photons on the way to their target.
		      </para>
  		  </listitem>

   	</itemizedlist>   
 
      </para>
    </listitem>
  </itemizedlist>
</para>
</sect2>

 
<sect2 id="sect-gui-objselector">
    
  <para>
    The object selection tab contains object lists organized by layers.
  </para>
  
 
 <title>The Object selection</title>
  
     <figure id="fig-interface-objselector">
        <title>The object selection tab.</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/interface_objselect.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase></phrase>
            </textobject>
           </mediaobject>
        </screenshot>
      </figure>

The object selection tab is used to select the current object, which can be edited in the editor, manipulated with cursor... Objects are also organized in layers.


<para>
  <itemizedlist>
  
  <listitem>
      <para>
	<guilabel>The layers section</guilabel>
      </para>
      <para>
        The top of the tab contains the list of layers used in this scene. You have first the name of the layer, next a toggle icon which is used to make layer visible ( in OpenGl views ) or not (Eyes), and a second toggle icon that is used make layer rendered in povray (Gears). There are also six buttons, from left to right :
 	 <itemizedlist>
 		 <listitem>
		 <para>
		 <guilabel>New Layer</guilabel>
		 </para>
	         <para>
		Create a new ( and empty ) layer.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Delete Layer</guilabel>
		 </para>
	         <para>
		Delete the current layer, and all its objects. The layer owning the camera cannot be destroyed.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Duplicate Layer</guilabel>
		 </para>
	         <para>
		Duplicate the current layer, and the its objects.
      		 </para>
   		 </listitem>
	
		 <listitem>
		 <para>
		 <guilabel>Edit Layer</guilabel>
		 </para>
	         <para>
		Edit current layer properties. For now only the name can be changed. The two other properties are set with toggle icons.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Move Up, Move Down</guilabel>
		 </para>
	         <para>
		Move current layer up / down.
      		 </para>
   		 </listitem>

	 </itemizedlist>
 
      </para>
    </listitem>


  <listitem>
      <para>
	<guilabel>The objects section</guilabel>
      </para>
      <para>
        The bottom of the tab contains the list of objects contained in the current layer. You have first the two toggle icons used to hide/unhide objects or make them rendered in povray or not. Next you have the class of the object (and an icon representing it), and its name. There are also nine buttons on two raws, from left to right and top to bottom :
 	 <itemizedlist>
 		
		 <listitem>
		 <para>
		 <guilabel>Delete Object</guilabel>
		 </para>
	         <para>
		Delete the current object. The camera cannot be destroyed.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Duplicate object</guilabel>
		 </para>
	         <para>
		Duplicate the current object.
      		 </para>
   		 </listitem>
	
		 <listitem>
		 <para>
		 <guilabel>Save object</guilabel>
		 </para>
	         <para>
		Save the current object in separate file ( tvo format ). Associated materials are included in this file.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Load object</guilabel>
		 </para>
	         <para>
		Load object from file ( tvo format ). Associated materials are also loaded.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Move up / Down</guilabel>
		 </para>
	         <para>
		Move current object Up / Down in the list.
      		 </para>
   		 </listitem>
	
		 <listitem>
		 <para>
		 <guilabel>Cut / Copy / Paste</guilabel>
		 </para>
	         <para>
		Cut / copy /paste object.
      		 </para>
   		 </listitem>

	 </itemizedlist>
 
      </para>
    </listitem> 


  </itemizedlist>
</para>
</sect2>


<sect2 id="sect-gui-objcreator">
    
  <para>
    The object creation tab contains a tree of all available primitives.
  </para>
  
 
 <title>The Object creation</title>
  
     <figure id="fig-interface-objcreattor">
        <title>The object selection tab.</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/interface_objcreate.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase></phrase>
            </textobject>
           </mediaobject>
        </screenshot>
      </figure>
<para>
The object creation tab is used create objects choosen from all available primitives contained in a tree. To create an object double click on it or select it and click "create".


</para>
</sect2>

<sect2 id="sect-gui-objmaterial">
  
 
 <title>The Materials management tab</title>
  
     <figure id="fig-interface-objmaterial">
        <title>The material tab.</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/interface_objmaterial.png" format="PNG" />
            </imageobject>
            <textobject>
              <phrase></phrase>
            </textobject>
           </mediaobject>
        </screenshot>
      </figure>
  <para>
        The material tab contains a list of loaded materials. These materials can be used to texture one of more objetcs in scene. There are also six buttons to manipulate materials, from left to right :
 	 <itemizedlist>
 		
		 <listitem>
		 <para>
		 <guilabel>New material</guilabel>
		 </para>
	         <para>
		Create a new, empty, material.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Delete material</guilabel>
		 </para>
	         <para>
		Delete the current ( selected ) material.
      		 </para>
   		 </listitem>
	
		 <listitem>
		 <para>
		 <guilabel>Edit material</guilabel>
		 </para>
	         <para>
		Open the material editor to edit the curent material.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Save material</guilabel>
		 </para>
	         <para>
		Save the current material in a separate ( tvm format ) file. File can be saved with an included preview, that can be useful if user want to add it to the library.
      		 </para>
   		 </listitem>

		 <listitem>
		 <para>
		 <guilabel>Load material</guilabel>
		 </para>
	         <para>
		Load a material from file ( tvm format ).
      		 </para>
   		 </listitem>
	
		 <listitem>
		 <para>
		 <guilabel>Open material library</guilabel>
		 </para>
	         <para>
		Open the material library.
      		 </para>
   		 </listitem>

	 </itemizedlist>
 
      </para>
</sect2>
</sect1>




  <!-- end of panel docs -->
 
