Difference between revisions of "Using Graphics"

From Wiki
Jump to navigation Jump to search
m (new link)
m (titles)
Line 1: Line 1:
 
< [[Graphics]] | [[Combinations]] | [[Including pages from PDF document]] >
 
< [[Graphics]] | [[Combinations]] | [[Including pages from PDF document]] >
  
'''Direct use of <tt>mypic.pdf</tt>'''
+
== Direct use of an image ==
  
 +
This way you can use your image <tt>mypic.pdf</tt> :
 
<texcode>
 
<texcode>
 
\externalfigure[mypic]
 
\externalfigure[mypic]
Line 23: Line 24:
 
If only one dimension is given, scaling is proportional.
 
If only one dimension is given, scaling is proportional.
  
'''Where ConTeXt finds your picture files'''
+
== Where ConTeXt finds your picture files ==
  
 
ConTeXt looks in the actual and parent directory plus those given in <tt>texmf.cnf</tt>.
 
ConTeXt looks in the actual and parent directory plus those given in <tt>texmf.cnf</tt>.
Line 33: Line 34:
 
You can define the path relative or absolute, but use always forward slashes!
 
You can define the path relative or absolute, but use always forward slashes!
  
'''Referenced Pictures'''
+
== Referenced Pictures ==
  
 
Declaration of all used pictures in your environment, project or header file is better than direct use of file names in your code.
 
Declaration of all used pictures in your environment, project or header file is better than direct use of file names in your code.
Line 51: Line 52:
 
</texcode>
 
</texcode>
  
'''Pictures as [[Floating Objects]]'''
+
== Pictures as [[Floating Objects]] ==
  
 
Floats are numbered and placed by ConTeXt, and they can get a caption.
 
Floats are numbered and placed by ConTeXt, and they can get a caption.
Line 68: Line 69:
 
You find more about floats ([[Floating Objects]]) in the manual.
 
You find more about floats ([[Floating Objects]]) in the manual.
  
'''Movies'''
+
== Movies ==
  
 
Movies aren't recognized automatically yet, you need a more verbose declaration:
 
Movies aren't recognized automatically yet, you need a more verbose declaration:

Revision as of 13:27, 6 July 2005

< Graphics | Combinations | Including pages from PDF document >

Direct use of an image

This way you can use your image mypic.pdf :

\externalfigure[mypic]

Additional parameters:

\externalfigure[file or reference name][key=value, key=value, ...]
  • scale = scaling value
  • factor = max, fit, broad
  • wfactor, hfactor = max, fit, broad, value
  • width, height = dimension
  • frame = on, off
  • preset, preview, repeat, object = yes, no
  • display = file name
  • type, method = eps, mps, pdf, tif, png, jpg, mov, tex

If only one dimension is given, scaling is proportional.

Where ConTeXt finds your picture files

ConTeXt looks in the actual and parent directory plus those given in texmf.cnf.

You can define your own image directory with:

\setupexternalfigures[directory={../pictures}]

You can define the path relative or absolute, but use always forward slashes!

Referenced Pictures

Declaration of all used pictures in your environment, project or header file is better than direct use of file names in your code.

\useexternalfigure[reference name][file name][options]

Same options as above. You can even inherit them like this:

\useexternalfigure[dummy][nofile][width=\textwidth]
\useexternalfigure[myone][my_pic_one][dummy]
\useexternalfigure[mytwo][my_pic_two][dummy]

Somewhere in your text there's \externalfigure[myone].

Pictures as Floating Objects

Floats are numbered and placed by ConTeXt, and they can get a caption.

\placeexternalfigure[place]{My Caption}{\externalfigure[myone]}

place is one of: left, right, here, top, bottom, inleft, inright, inmargin, margin, page, opposite, always, force, tall

You get no caption with none. You get a table of figures with \showexternalfigures[alternative=a]. Alternatives (styles) a, b and c are predefined.

The second brackets of \placeexternalfigure can keep any command, e.g. \getbuffer.

You find more about floats (Floating Objects) in the manual.

Movies

Movies aren't recognized automatically yet, you need a more verbose declaration:

\externalfigure[demo.mov][label=demo,width=4cm,height=4cm,preview=yes]

preview=yes shows the first image as preview. You find more about interactive Elements in mwidget-s.pdf