2 /* This file is part of
3 * ======================================================
5 * LyX, The Document Processor
7 * Copyright 1995 Matthias Ettrich
8 * Copyright 1995-2000 the LyX Team.
10 * ====================================================== */
12 #ifndef INSET_GRAPHICS_H
13 #define INSET_GRAPHICS_H
19 #include "insets/lyxinset.h"
20 #include "LaTeXFeatures.h"
22 #include "insets/BoundingBox.h"
29 class InsetGraphics : public Inset {
34 int ascent(Painter &, LyXFont const &) const;
36 int descent(Painter &, LyXFont const &) const;
38 int width(Painter &, LyXFont const &) const;
40 void draw(Painter &, LyXFont const &,
41 int baseline, float & x) const;
43 void Edit(BufferView *, int, int, unsigned int);
45 EDITABLE Editable() const;
47 void Write(ostream &) const;
49 void Read(LyXLex & lex);
50 /** returns the number of rows (\n's) of generated tex code.
51 fragile != 0 means, that the inset should take care about
52 fragile commands by adding a \protect before.
54 int Latex(ostream &, signed char fragile, bool free_spc) const;
56 int Linuxdoc(ostream &) const;
58 int DocBook(ostream &) const;
60 /// Updates needed features for this inset.
61 void Validate(LaTeXFeatures & features) const;
63 /// returns LyX code associated with the inset. Used for TOC, ...)
64 Inset::Code LyxCode() const { return Inset::GRAPHICS_CODE; }
67 Inset * Clone() const;
68 /// Set the graphics file
69 void graphicsFile(string const & f) {
72 /// Get the graphics file
73 string const & graphicsFile() const {
84 // We need variables to store the size of the boundingbox and
85 // to store a pointer to the pixmap in.. The question is if
86 // these should be in a "pixmap" class.
87 // We also need to have variables about rotation and scaling,
88 // width and height. in effect all the paramters that
89 // \includegrapichs can handle. (the graphix.sty package)
91 /** The "bounding box" of the graphics image. Its value field
92 must contain four dimensions, separated by spaces. */
94 /** The bounding box above is used for display and file both.
95 But we need this variable below to know if we shall use the
96 bounding box in the LaTex command or not. (i.e. if the user
97 has manually set the bb.) */
100 /** When a graphics file is parsed we first check for BoundingBox
101 and then for HiResBoundingBox, and set hiresbb depending on this.
102 This key makes LaTeX search for %%HiResBoundingBox comments
103 instead of the normal %%BoundingBox. Some applications use
104 this to specify more precise bounding boxes, becase the cumbers
105 can normally only have integer values. It is a Boolean, either
106 "true" or "false". */
108 /** This key takes four arguments (like bb), but in this case the
109 origin is taken with respect to the bounding box specified in
110 the file. So to view a 20 bp square at the lower left-hand corner
111 of the picture, specify viewport=0 0 20 20. */
112 BoundingBox viewport;
113 /** Similar to the viewport key, but the four dimensions correspond
114 to the amount of space to be trimmed (cut off) at the left-hand
115 side, bottom, right-hand side and top of the included graphics. */
117 /// Natural height of figure
119 /// Natural width of figure.
121 /// Rotation angle (in degrees, counterclockwise).
123 /// This is the different origins that the graphicx package support.
138 REFERENCE_POINT = LEFTBASELINE
140 /** Origin for rotation, similar to the origin parameter of
141 the \rotatebox command described on p.46 and Fig. 2.2 on p.46. */
143 /// Required width (the width of the image is scaled to that value).
145 /// Required height (the height of the image is scaled to that value).
147 /** Required total height (the total height of the image is scaled
148 to that value). This key should be used instead of height if
149 images are rotated over 90 degrees, since the height can
150 disappear (and become the depth) and LaTeX will have difficulties
151 satisfying the user's request. */
152 LyXLength totalheight;
153 /** Boolean variable that can have the values "true" and "false"
154 (se above for defaults). When true, specifying both width and
155 height parameters does not distort the picture, but the image
156 is scaled so that neither of the width of height exceeds the
158 bool keepaspectratio;
161 /** Clip the graphic to the bounding box. It is a Boolean, either
162 "true" or "false". */
164 /// Locally switch to draft mode. A Boolean valued key, like clip.
166 /// The graphics type.
168 ///x The file extension of the file containing the image data.
170 /// The file extension of the file "read" by LaTeX.
172 /// Any command to be applied to the file.