NOTE: THIS FILE FORMAT IS OBSOLETE. THIS DOCUMENT IS ONLY PROVIDED
FOR BACKWARD COMPATIBILITY AND INFORMATION.
(1) The very first line is a comment line containing the name and version:
#FIG 2.1
The character # at the first column of a line indicates that the line
is a comment line which will be ignored.
(2) The first non-comment line consists of two numbers :
int fig_resolution (pixels/inch)
int coordinate_system (1 : origin is the lower left corner (NOT USED)
2 : Upper left)
Fig_resolution is the resolution fig is using for the current file.
It must always be 80 for compatibility with this version of Fig.
Pixels are assumed to be square.
Xfig only uses the upper-left coordinate system (2).
(3) The rest of the file contains various objects. An object can be one
of six classes (or types).
i) Arc.
ii) Ellipse which is a generalization of circle.
iii) Polyline which includes polygon and box.
iv) Spline which includes closed/open control/interpolated spline.
v) Text.
vi) Compound object which is composed of one or more objects.
In the following elaboration on object formats, every value of fig
output are separated by blank characters or new line ('\n'). The
value of the not-used parameters will be -1.
Some fields are described as "enumeration type" or "bit vector"; the
values which these fields can take are defined in the header file object.h.
The pen, arrow_type, and arrow_style fields are described as unused.
These values may be defined in some future version of Fig.
The color field is defined as follows:
-1 = Default
0 = Black
1 = Blue
2 = Green
3 = Cyan
4 = Red
5 = Magenta
6 = Yellow
7 = White
values from 8 to 2^30-1 = reserved for future use
The depth field is defined as follows:
0 ... 999 where larger value means object is deeper than (under)
objects with smaller depth
The area fill field is defined as follows:
0 = not filled
1 = white
... values from 2 to 20 are shades of grey, from lighter to darker
21 = black
The line_style field is defined as follows:
-1 = Default
0 = Solid
1 = Dashed
2 = Dotted
The style_val field is defined as the length, in pixels, of the on/off dashes
for dashed lines, and the distance between the dots, in pixels, for dotted lines
(3.1) ARC
First line :
type name (brief description)
---- ---- -------------------
int object_code (always 5)
int sub_type (always 1)
int line_style (enumeration type)
int line_thickness (pixels)
int color (enumeration type)
int depth (enumeration type)
int pen (not used)
int area_fill (enumeration type)
float style_val (pixels)
int direction (0 : clockwise, 1 : counterclockwise)
int forward_arrow (0: no forward arrow, 1: on)
int backward_arrow (0: no forward arrow, 1: on)
float center_x, center_y (center of the arc)
int x1, y1 (pixels, the 1st point the user entered)
int x2, y2 (pixels, the 2nd point)
int x3, y3 (pixels, the last point)
Forward arrow line (Optional; absent if forward_arrow is 0) :
type name (brief description)
---- ---- -------------------
int arrow_type (not used)
int arrow_style (not used)
float arrow_thickness (pixels)
float arrow_width (pixels)
float arrow_height (pixels)
Backward arrow line (Optional; absent if backward_arrow is 0) :
type name (brief description)
---- ---- -------------------
int arrow_type (not used)
int arrow_style (not used)
float arrow_thickness (pixels)
float arrow_width (pixels)
float arrow_height (pixels)
(3.2) COMPOUND
A line with object code 6 signifies the start of a compound.
There are four more numbers on this line which indicate the
upper right corner and the lower left corner of the bounding
box of this compound. A line with object code -6 signifies
the end of the compound. Compound may be nested.
First line :
type name (brief description)
---- ---- -------------------
int object_code (always 6)
int upperright_corner_x (pixels)
int upperright_corner_y (pixels)
int lowerleft_corner_x (pixels)
int lowerleft_corner_y (pixels)
Subsequent lines :
objects
.
.
Last line :
-6
(3.3) ELLIPSE
First line :
type name (brief description)
---- ---- -------------------
int object_code (always 1)
int sub_type (1 : ellipse defined by radiuses
2 : ellipse defined by diameters
3 : circle defined by radius
4 : circle defined by diameter)
int line_style (enumeration type)
int thickness (pixels)
int color (enumeration type)
int depth (enumeration type)
int pen (not used)
int area_fill (enumeration type)
float style_val (pixels)
int direction (always 1)
float angle (radians, the angle of the x-axis)
int center_x, center_y (pixels)
int radius_x, radius_y (pixels)
int start_x, start_y (pixels; the 1st point entered)
int end_x, end_y (pixels; the last point entered)
(3.4) POLYLINE
First line :
type name (brief description)
---- ---- -------------------
int object_code (always 2)
int sub_type (1 : polyline
2 : box
3 : polygon
4 : arc-box)
5 : imported-eps bounding-box)
int line_style (enumeration type)
int thickness (pixels)
int color (enumeration type)
int depth (enumeration type)
int pen (not used)
int area_fill (enumeration type)
float style_val (pixels)
int radius (pixels, radius of arc-boxes)
int forward_arrow (0: off, 1: on)
int backward_arrow (0: off, 1: on)
Forward arrow line : same as ARC object
Backward arrow line : same as ARC object
EPS line :
type name (brief description)
---- ---- -------------------
boolean flipped orientation = normal (0) or flipped (1)
char file[] name of eps file to import
Points line :
type name (brief description)
---- ---- -------------------
int x1, y1 (pixels)
int x2, y2 (pixels)
.
.
int xn, yn (this will be the same as the 1st
point for polygon and box)
int x, y (always 9999, 9999; marks the end of
point for polygon and box)
(3.5) SPLINE
First line :
type name (brief description)
---- ---- -------------------
int object_code (always 3)
int sub_type (0 : open spline
1 : closed spline
2 : open interpolated spline
3 : closed interpolated spline)
int line_style (See the end of this section)
int thickness (pixels)
int color (enumeration type)
int depth (enumeration type)
int pen (not used)
int area_fill (enumeration type)
float style_val (pixels)
int forward_arrow (0: off, 1: on)
int backward_arrow (0: off, 1: on)
Forward arrow line : same as ARC object
Backward arrow line : same as ARC object
Points line : same as POLYLINE object
Control points line (absent if sub_type is 0 or 1) :
Control points of interpolated spline. There are two control
points for each knots. A section i, of the spline is drawn
using Bezier cubic with the following four points:
(x ,y ), (rx ,ry ), (lx , ly ), (x , y ).
i i i i i+1 i+1 i+1 i+1
For closed interpolated spline the last pair of control points,
(lxn,lyn) and (rxn,ryn) (which can be ignored), are the same as
(lx1,ly1) and (rx1,ry1) respectively.
type name (brief description)
---- ---- -------------------
float lx1, ly1 (pixels)
float rx1, ry1 (pixels)
float lx2, ly2 (pixels)
float rx2, ry2 (pixels)
.
.
float lxn, lyn (pixels)
float rxn, ryn (pixels)
(3.6) TEXT
type name (brief description)
---- ---- -------------------
int object (always 4)
int sub_type (0 : Left justified
1 : Center justified
2 : Right justified)
int font (enumeration type)
int font_size (font size in points)
int pen (not used)
int color (enumeration type)
int depth (enumeration type)
float angle (radians, the angle of the text)
int font_flags (bit vector)
int height (pixels)
int length (pixels)
int x, y (pixels, coordinate of the origin
of the string. If sub_type = 0, it is
the lower left corner of the string.
If sub_type = 1, it is the lower
center. Otherwise it is the lower
right corner of the string.)
char string[] (ascii characters; starts after a blank
character following the last number and
ends before the character '\1' (control-A).
This character is not part of the string.
Note that the string may contain '\n'.)
The font_flags field is defined as follows:
Bit Description
0 Rigid text (text doesn't scale when scaling compound objects)
1 Special text (for LaTeX)
2 PostScript font (otherwise LaTeX font is used)
3 Hidden text
The font field is defined as follows:
For font_flags bit 2 = 0 (LaTeX fonts):
0 Default font
1 Roman
2 Bold
3 Italic
4 Modern
5 Typewriter
For font_flags bit 3 = 1 (PostScript fonts):
-1 Default font
0 Times Roman
1 Times Italic
2 Times Bold
3 Times Bold Italic
4 AvantGarde Book
5 AvantGarde Book Oblique
6 AvantGarde Demi
7 AvantGarde Demi Oblique
8 Bookman Light
9 Bookman Light Italic
10 Bookman Demi
11 Bookman Demi Italic
12 Courier
13 Courier Oblique
14 Courier Bold
15 Courier Bold Oblique
16 Helvetica
17 Helvetica Oblique
18 Helvetica Bold
19 Helvetica Bold Oblique
20 Helvetica Narrow
21 Helvetica Narrow Oblique
22 Helvetica Narrow Bold
23 Helvetica Narrow Bold Oblique
24 New Century Schoolbook Roman
25 New Century Schoolbook Italic
26 New Century Schoolbook Bold
27 New Century Schoolbook Bold Italic
28 Palatino Roman
29 Palatino Italic
30 Palatino Bold
31 Palatino Bold Italic
32 Symbol
33 Zapf Chancery Medium Italic
34 Zapf Dingbats
