Include Graphics

The Include Graphics dialog makes insertion of graphics as easy as possible. You can reach it via the menubar with LaTeXImage Insertion. Please take a look at Graphic File Formats and EPS Graphics to get an overview of some basic facts concerning graphic formats.


Including a graphics element
  1. 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 (SettingsConfigure Kile...LaTeX+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.

  2. Decide whether your image shall be centered on the page.

  3. Choose whether you want the \graphicspath notation 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 \graphicspath command, Kile would include the path for the graphics file. But if you use \graphicspath in your preamble like this:

    \graphicspath{{/path/to/my/graphics}{other/path/to/more/graphics}}

    and check this option, Kile will only use the base name of the graphics file.

    Another example: if you set \graphicspath command like:

    \graphicspath{{./}{camera/}{images/}}

    LATEX will search in the current folder, then in camera and finally in images to find your graphics file.

  4. 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 the dialog to know the original size of the graphics.

  5. Insert an angle by which to rotate the graphics counterclockwise.

  6. 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 hand, 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.

  7. 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.

  8. In the Trim Image tab you can crop your image in all four directions.

  9. 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.

    Note

    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 fig: for images.

  10. If you pick the figure environment, you can choose where LATEX should preferably position the figure.

  11. In the wrapfigure environment you can:

    1. 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 or outside edge of the page.

    2. Define how many shortened lines of the text are set alongside the figure. If you leave this empty, LATEX will determine this itself as well as is possible.

    3. Define an overhang to the chosen side. This is especially useful when you have columns in your document and you want a figure to span over more than just one column or you want shortened text on both sides of the figure.

    4. Choose a width for the figure. This should be a bit bigger than the actual image width, so there will be some empty space between the figure and the text.