The Include Graphics dialog makes insertion of graphics as easy as possible. You can reach it via the menubar with → . Please take a look at Graphic File Formats and EPS Graphics to get an overview of some basic facts concerning graphic formats.
Choose a graphics file. This can be a JPEG, PNG, PDF, EPS or even a zipped or gzipped EPS file. If you have installed ImageMagick and also configured Kile to use it ( → → +Graphics), the width and the height of the graphic is automatically shown. If ImageMagick can determine a resolution, the size of the graphics is also shown in centimeters.
Decide whether your image shall be centered on the page.
Choose whether you want the
\graphicspathnotation for your graphics file.
By default graphics files have to be in the same folder as your master document. However, it is possible to put them in other folders to make things tidier. Without a
\graphicspathcommand, Kile would include the path for the graphics file. But if you use
\graphicspathin your preamble like this:
and check this option, Kile will only use the base name of the graphics file.
Another example: if you set
LATEX will search in the current folder, then in
cameraand finally in
imagesto find your graphics file.
If you choose either a width or a height, the whole graphics will be proportionally scaled. If you set two values for width and height at the same time, width and height may be scaled with different factors, and this could not be what you want. See also the information near the top of dialog to know the original size of the graphics.
Insert an angle by which to rotate the graphics counterclockwise.
The bounding-box information is set automatically when you choose a graphics file. This information is only needed when you work with traditional LATEX and bitmapped graphics. See the discussion of EPS graphics.
If LATEX needs a bounding box and you do not want to generate a bb file, Kile supports this option. On the other side, PDFLATEX will give a warning, when you want to include a png or jpg graphics with this option. This checkbox enables or disables the bounding box option.
Scale the image by the desired scale factor. e.g., 0.5 to reduce by half, or 2 to double. When you use this option, you do not have to set a width or height for the image.
In the Trim Image-tab you can crop your image in all four directions.
Finally, you have to specify whether you want to embed this image into a figure environment. When you want the text to wrap around the figure, use the wrapfigure environment instead.
When you choose the wrapfigure environment, you need to include the wrapfig package in your preamble.
In either case you can insert a caption and a label for your image. Generally, it is a good idea to add a different prefix to each kind of label. It is common to use the prefix
If you pick the figure environment, you can choose where LATEX should position the figure preferably.
In the wrapfigure environment you can
Pick a placement rule for the figure and decide whether the figure should float or not. In a two-sided document you can define whether the figure should be on the inside of the page or on the outside.
Define how many lines the wrapping text should be broken. If you leave this empty, LATEX will determine this itself as good as possible.
Define an overhang to the chosen side. This is especially useful when you have columns in your document and you want a figure span over more than just one column or you want it being wrapped by two columns.
Choose a width for the figure. This should be a bit bigger than your actual image width, so there will be some empty space between the figure and the text.