The Cairo Package - ftp @ uni
Contents
1. at bass ee Es he oe d 6 AITORON S lt paseo 2 LR ee ee Re de ER D Bis eR ee eat ee oe He nie une ae 7 Index 9 2 Cairo Cairo Create a new Cairo based graphics device Description Cairo initializes a new graphics device that uses the cairo graphics library for rendering The current implementation produces high quality PNG JPEG TIFF bitmap files high resolution PDF files with embedded fonts SVG graphics and PostScript files It also provides X11 and Windows interactive graphics devices Unlike other devices it supports all graphics features including alpha blending anti aliasing etc CairoX11 CairoPNG CairoPDF CairoPS and CairoSVG are convenience wrappers of Cairo that take the same arguments as the corresponding device it replaces such as X11 png pdf etc Use of the Cairo function is encouraged as it is more flexible than the wrappers Usage Cairo width 640 height 480 file type png pointsize 12 bg transparent canvas white units px dpi auto CairoXll display Sys getenv DISPLAY width 7 height 7 pointsize 12 gamma getOption gamma bg transparent canvas white xpos NA ypos NA CairoPNG filename Rplot 03d png width 480 height 480 pointsize 12 bg white res NA CairoJPEG filename Rplot 03d jpeg width 480 height 480 pointsize 12 quality 75 b2. 8 Adobe Deflate All parameters listed below are defined by the other devices are are used by the wrappers to make it easier replace other devices by Cairo They are described in detail in the documentation corresponding to the device that is being replaced X11 display see X11 gamma correction see X11 see X11 same as file inCairo see png will be mapped to dpi for Cairo quality of the jpeg see jpeg logical if true the default allow multiple figures in one file see pdf false is currently not supported by vector devices font family see pdf see pdf ignored 4 Cairo fonts see pdf ignored Cairo automatically detects and embeds fonts version PDF version see pdf ignored paper see pdf ignored Cairo uses device dimensions encoding see pdf ignored Cairo uses native enconding except for symbols fg see pdf ignored pagecentre see pdf ignored Cairo uses device dimensions and thus it is irrelevant record Windows specific ignored on unix rescale Windows specific ignored on unix xpinch Windows specific ignored on unix ypinch Windows specific ignored on unix buffered Windows specific ignored on unix restoreConsole Windows specific ignored on unix horizontal see postscript ignored print it see postscript ignored command see postscript ignored colormodel see postscript ignored Cairo always uses RGB or ARGB Value The invisible return value is NULL if the device couldn t be created or
3. See Also CairoFonts Cairo CairoFonts Set the fonts used for all Cairo graphics devices Description CairoFonts initializes the fonts used for Cairo graphics devices Usage CairoFonts regular Helvetica style Regular bold Helvetica style Bold italic Helvetica style Italic bolditalic Helvetica style Bold Italic BoldItalic symbol Symbol 8 CairoFonts Arguments regular character fontconfig pattern for the plain text font bold character fontconfig pattern for the bold face font italic character fontconfig pattern for the italic font bolditalic character fontconfig pattern for the bold italic font symbol character fontconfig pattern for the symbol font Details This function sets the fonts for Cairo graphics devices globally previously opened Cairo graphics devices will also use these fonts The argument names correspond to the five values of the graphical parameter font i e regular is 1 bold is 2 italic is 3 etc For an explanation of fontconfig patterns see CairoFontMatch Known issues e This function is only available when the cairo graphics library is configured with FreeType and Fontcofig support e R math symbols are supported but require a Symbol font with the Adobe symbol encoding At the time of this release the authors are unaware of a free version of this font however they do exist on Windows and Mac OS X See Also CairoFont
4. Match Cairo par Examples Not run The following fontconfig patterns define the fr truetype fonts available in the debian package ttf freefont Freesans is very similar to Helvetica CairoFonts regular FreeSans style Medium bold FreeSans style Bold italic FreeSans style Oblique bolditalic FreeSans style BoldObligue End Not run Index Topic device Cairo 2 Cairo capabilities 5 CairoFonMatch 6 CairoFonts 7 Cairo 2 5 7 8 Cairo capabilities 3 5 CairoFonMat ch 6 CairoFontMatch 8 CairoFontMatch CairoFonMatch 6 CairoFonts 4 7 7 CairoJPEG Cairo 2 CairoPDF Cairo 2 CairoPNG Cairo 2 CairoPS Cairo 2 CairoSVG Cairo 2 CairoTIFF Cairo 2 CairoWin Cairo 2 CairoX11 Cairo 2 jpeg 3 par 8 pdf 3 4 png 3 postscript 4 X11 3
5. The Cairo Package September 1 2007 Version 1 3 5 Title R graphics device using cairo graphics library for creating high quality bitmap PNG JPEG TIFF vector PDF SVG PostScript and display X11 and Win32 output Author Simon Urbanek lt Simon Urbanek r project org gt Jeffrey Horner lt jeff horner O vanderbilt edu gt Maintainer Simon Urbanek lt Simon Urbanek r project org gt Depends R gt 1 9 0 Description This package provides a Cairo graphics device that can be use to create high quality vector PDF PostScript and SVG and bitmap output PNG JPEG TIFF and high quality rendering in displays X11 and Win32 Since it uses the same back end for all output copying across formats is WYSIWYG Files are created without the dependence on X11 or other external programs This device supports alpha channel semi transparent drawing and resulting images can contain transparent and semi transparent regions It is ideal for use in server environemnts file output and as a replacement for other devices that don t have Cairo s capabilities such as alpha support or anti aliasing Backends are modular such that any subset of backends is supported License GPL version 2 SystemRequirements cairo gt 1 2 http www cairographics org URL http www rforge net Cairo R topics documented Cairo 42 2224 0 24 eed be eh eh 13 bh EEE SEER EES 2 Cairo capabil ties wR A Ee Re ee eee 5 CairoFonMatch 13828 bon cd da
6. a Cairo object if success ful The vaule of the object is the device number Known issues e The X11 backend is quite slow The reason is the cairographics implementation of the back end so we can t do much about it It should be possible to drop cairographics Xlib backend entirely and use image backend copied into an X11 window instead We may try that in future releases e TrueType and OpenType fonts are supported when this package is compiled against a cairo graphics library configured with FreeType and Fontconfig support Therefore make sure have a cairo grpahics library with all bell and whistles to get a good result e R math symbols are supported but require a TrueType Symbol font accessible to Cairo under that name See Also CairoFonts Cairo capabilities 5 Examples very simple KDE Cairo 600 600 file plot png type png bg white plot rnorm 4000 rnorm 4000 col ff000018 pch 19 cex 2 semi transparent red dev off creates a file plot png with the above plot you can use any Cairo backend and get the same result vector bitmap or on screen CairoPDF plot pdf 6 6 bg transparent data iris attach iris plot Petal Length rep 0 03 length Species xlim c 1 7 ylim c 0 1 7 xlab Petal Length ylab Density pch 21 cex 1 5 col 00000001 main Iris yet again bg c 000020 00ff0020 0000ff20 unclass Species for 1 ah 143 polyg
7. atch Details This function displays a list of one or more fonts matching the supplied fontconfig pattern sort FALSE displays the font that Cairo will use for the supplied pattern while sort TRUE displays a sorted list of best matching fonts The simplest fontconfig pattern matching all installed fonts is Here s what CairoFontMatch displays on this system 1 family Bitstream Vera Sans style Roman file usr share fonts truetype verbose FALSE displays the font properties family style and file while verbose TRUE will display the canonical font pattern displaying all properties known for the font output of Cairo FontMatch verbose TRUE 1 family Bitstream Vera Sans style Roman file usr share fonts truetype Bitstream Vera Sans 12 familylang en style Roman stylelang en slant 0 weight 8 A simple approach to selecting a font starts with calling CairoFontMatch sort TRUE to list all available fonts Next the user will choose a font from the list and call CairoFontMatch FamilyName style PreferredStyle s substituting FamilyName and PreferredStyle with the desired values If only one font is found then the user has found the fontconfig pattern that will select the desired font Otherwise the user will call CairoFontMatch with verbose TRUE to determine other properties to add to the pattern to attain the desired font for instance the fontformat The foll
8. g white res NA CairoTIFF filename Rplot 03d tiff width 480 height 480 pointsize 12 bg white res NA CairoPDF file ifelse onefile Rplots pdf Rplot 03d pdf width 6 height 6 onefile TRUE family Helvetica title R Graphics Output fonts NULL version 1 1 paper special encoding bg fg pointsize pagecentre CairoSVG file ifelse onefile Rplots svg Rplot 03d svg width 6 height 6 onefile TRUE bg transparent pointsize 12 CairoWin width 7 height 7 pointsize 12 record getOption graphics record rescale c R fit fixed xpinch ypinch bg transparent canvas white gamma getOption gamma xpos NA ypos NA buffered getOption windowsBuffered restoreConsole FALSE CairoPS file ifelse onefile Rplots ps Rplot 03d ps onefile TRUE family title R Graphics Output fonts NULL encoding bg fg width height horizontal pointsize paper pagecentre print it command colormodel Cairo Arguments width height file type pointsize canvas bg units dpi display gamma xpos ypos filename res quality onefile family title width of the plot area also see units height of the plot area also see units name of the file to be created or connection to write to Only PDF PS and PNG types support connections For X11 type fi
9. le specifies the display name If NULL or a reasonable default will be chosen which is plot type for file oriented types and value of the DISPLAY environment variable for X11 For image types the file name can contain printf style formatting expecting one integer parameter which is the page number such as Rplot 03d png The page numbers start at one moms output type This version of Cario supports png jpeg and tiff bitmaps png tiff with transparent background pdf PDF file with embedded fonts svg SVG file ps PostScript file x11 X11 interactive window and win Windows graphics Depending on the support of various backends in cairo graphics some of the options may not be available for your system See Cairo capabilities function initial text size in points canvas color must be opaque The canvas is only used by devices that display graphics on a screen and the canvas is only visible only if bg is transparent plot background color can include alpha component or be transparent allto gether units for of the width and height specifications It can be any of px pix els in inches pt points cm centimeters or mm millimeters DPI used for the conversion of units to pixels If set to auto the DPI resolu tion will be determined by the back end additional backend specific parameters e g quality setting for JPEG 0 100 and compression for TIFF 0 1 none 5 LZW default 7 JPEG
10. on density Petal Length unclass Species i bw 0 2 col c 000040 00ff0040 0000fF40 i dev off Cairo capabilities Reports which output types are supported by this Cairo build Description Cairo capabilities returns a logical vector describing the capabilities of this particular Cairo build Usage Cairo capabilities Details The Cairo package provides multiple back ends such as images PNG JPEG TIFF vector graphics PDF PostScript SVG or displays X11 Windows However not all systems support all back ends The Cairo capabilities function returns a logical vector showing which capa bilities are supported in this particular Cairo build Note that the capabilities depend both on the libraries available in the system as well as the compiled in modules in cairo graphics See Also Cairo 6 CairoFonMatch CairoFonMatch Find installed fonts with a fontconfig pattern Description CairoFontMatch searches for fonts based on a fontconfig pattern Usage CairoFontMatch fontpattern Helvetica sort FALSE verbose FALSE Arguments fontpattern character a fontconfig pattern sort logical if FALSE display only the best matching font for the pattern If TRUE display a sorted list of best matching fonts verbose logical if FALSE display the family style and file property for the pattern if TRUE display the canonical font pattern for each m
11. owing excerpt is from the fontconfig user s manual http fontconfig org and better de scribes the fontconfig pattern definition Fontconfig provides a textual representation for patterns that the library can both accept and gen erate The representation is in three parts first a list of family names second a list of point sizes and finally a list of additional properties CairoFonts 7 lt families gt lt point sizes gt lt name 1 gt lt values 1 gt lt name2 gt lt values2 gt Values in a list are separated with commas The name needn t include either families or point sizes they can be elided In addition there are symbolic constants that simultaneously indicate both a name and a value Here are some examples Font Pattern Meaning Times 12 12 point Times Roman Times 12 bold 12 point Times Bold Courier italic Courier Italic in the default size Monospace matrix l 1 0 1 The users preferred monospace font with artificial obliguing The and characters in family names must be preceeded by a haracter to avoid having them misinterpreted Similarly values containing and must also have them pre ceeded by a haracter The haracters are stripped out of the family name and values as the font name is read Known issues e This function is only available when the Cairo graphics library is configured with FreeType and Fontcofig support
Download Pdf Manuals
Related Search