File: usage-loadsave.xml

package info (click to toggle)
dia 0.97.3%2Bgit20160930-9
  • links: PTS
  • area: main
  • in suites: bullseye
  • size: 54,372 kB
  • sloc: ansic: 155,065; xml: 16,326; python: 6,641; cpp: 4,935; makefile: 3,833; sh: 540; perl: 137; sed: 19
file content (200 lines) | stat: -rw-r--r-- 6,740 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
<chapter label="8" id="loadsave-chapter">
<title>Loading and Saving Diagrams</title>
<sect1 id="loadsave-intro">
 <title>Loading and Saving Introduction</title>
  <para>
   <application>Dia</application> follows the saving model common to most
   desktop applications: you must explicitly save any canvases that you
   wish to retain for future use. To save a file, choose
    <menuchoice>
     <guimenu>File</guimenu>
      <guimenuitem>Save</guimenuitem>
    </menuchoice>
   from the <interface>Main Popup Menu</interface>. The result is a
   standard save dialog. Your canvas is saved in
   <application>Dia</application> XML format. No file extension is
   automatically added, so it is a good idea to explicitly add
  '.dia' to the name you enter.
  </para>
  <para>
   To load a canvas from a file previously saved by
   <application>Dia</application> or created by another application,
   select
    <menuchoice>
     <guimenu>File</guimenu>
     <guimenuitem>Open...</guimenuitem>
    </menuchoice>
   from the <interface>Main Menu Bar</interface>. The result is an
   <interface>open dialog</interface>; select the file you want
   and choose <guibutton>Open</guibutton>. The <interface>open
   dialog</interface> is standard apart from the popup menu labeled
   <guimenu>Determine file type</guimenu>. Choose the format of the file
   to open (<application>Dia</application> XML or Drawing Interchange)
   if <application>Dia</application> does not correctly determine the
   file format unassisted.
  </para>
  <para>An alternate file-loading method is to start
  <application>Dia</application> from the command line with the name
   of the file to open given as an argument.
  </para>
 </sect1>
   <sect1 id="loadsave-filetypes">
   <title>File Types</title>
    <para>
     A few words on file types are in order. You should be aware that not all
     format of files can be re-loaded into <application>Dia</application>
     after saving and that most supported file formats lose information to
     some degree.
    </para>
    <sect2 id="loadsave-filetypes-dia">
    <title>Dia Native Diagram Files</title>
     <para>
      The only format guaranteed to be lossless is
      <application>Dia</application> XML. Happily, you are unlikely to
      accidentally save in a lossy format because
       <menuchoice>
        <guimenu>File</guimenu>
         <guimenuitem>Save</guimenuitem>
       </menuchoice>
      always produces a file in <application>Dia</application> XML format.
     </para>
     <para>
      Files in <application>Dia</application> XML format are automatically
      compressed using gzip to save disk space. This is almost necessary
      since, without compression, even simple diagrams are very large because
      they store much redundant information. 
      <application>Dia</application> XML files are already compressed, 
      so further compressing them using other archive formats will not help
      make them significantly smaller.  
     </para>
    </sect2>
    <sect2 id="loadsave-filetypes-import">
    <title>Import/Export Formats</title>
     <para>
      <application>Dia</application> is able to import and export the following file types:
      <itemizedlist>
       <listitem>
        <para>
	 Scalable Vector Graphics (.svg)
	</para>
       </listitem>
       <listitem>
        <para>
	 AutoCad Drawing eXchange Format (.dxf)
	</para>
       </listitem>
       <listitem>
        <para>
	 Visio XML File Format (.vdx)
	</para>
       </listitem>
       <listitem>
        <para>
	 XFig File Format (.fig)
	</para>
       </listitem>
       <listitem>
        <para>
          GdkPixbuf bitmap graphics (.bmp, .gif, .jpg, .png, .pnm, .ras, .tif)
        </para>
       </listitem>
      </itemizedlist> 
     </para>
    </sect2>
<!-- Add loadsave-filestypes-dif section in future -->
    <sect2 id="loadsave-filetypes-export">
    <title>Exporting Only Formats</title>
     <para>
     <application>Dia</application> supports exporting to many other types of
     file, such as:
     <itemizedlist>
      <listitem>
       <para>
         Computer Graphics Metafile (.cgm)
       </para>
      </listitem>
      <listitem>
       <para>
        Dia Shape File (.shape)
       </para>
      </listitem>
      <listitem>
       <para>
        HP Graphics Language (.plt, .hpgl) 
       </para>
      </listitem>
      <listitem>
       <para>
        Encapsulated Postscript (.eps, .epsi)
       </para>
      </listitem>
      <listitem>
       <para>
        Postscript (.ps)
       </para>
      </listitem>
      <listitem>
       <para>
        Portable Document Format (.pdf)
       </para>
      </listitem>
      <listitem>
       <para>
        Portable Network Graphics (.png)
       </para>
      </listitem>
      <listitem>
       <para>
        TeX Metapost macros (.mp)
       </para>
      </listitem>
      <listitem>
       <para>
        TeX PSTricks macros (.tex)
       </para>
      </listitem>	
      <listitem>
       <para>
        WordPerfect Graphics (.wpg)
       </para>
      </listitem>
      <listitem>
       <para>
        XFig format (.fig)
       </para>
      </listitem> 
      <listitem>
       <para>
        XSLT (eXtensible Stylesheet Language Transformation) (.code)
       </para>
      </listitem>
     </itemizedlist>
     <application>Dia</application> cannot load files in most of these formats.  These
     formats are useful for diagrams that you need to use in another
     application or to distribute to users of another operating system that
     <application>Dia</application> does not support.
     <!--Lets go through later and make this a variablelist, as well as describe
     the strengths of each of these formats  -->
<!--      Computer Graphics Metafile, HPGL, EPS, PNG, SVG,
      TeX, and WPG formats are supported for crating files
      only&mdash;<application>Dia</application> cannot load files in these
      formats. These formats are useful for diagrams that you need to use
      in another application (e.g., the World-wide Web) or distribute to
      users of an operating system that <application>Dia</application>
      does not support.
-->
     </para>
     <para>
      To create a file in one of these formats, select
       <menuchoice>                                                                             
	 <guimenu>File</guimenu>
         <guimenuitem>Export...</guimenuitem>
       </menuchoice>
      from the <interface>Main Popup Menu</interface>. Choose a name
      and the desired format in the resulting dialog, which works like a
      <interface>save</interface> dialog. An appropriate file extension
      is automatically added.
     </para>
   </sect2>
  </sect1>
</chapter>