d.out.file(1)

1d.out.file(1)                 Grass User's Manual                d.out.file(1)
2
3
4

NAME

6       d.out.file   -  Saves  the  contents of the active display monitor to a
7       graphics file.
8

KEYWORDS

10       display, export
11

SYNOPSIS

13       d.out.file
14       d.out.file help
15       d.out.file [-btcr]  output=string  format=string   [resolution=integer]
16       [size=width,height]       [compression=integer]       [quality=integer]
17       [paper=string]   [ps_level=integer]   [--verbose]  [--quiet]
18
19   Flags:
20       -b
21           Set background color to black (white default)
22
23       -t
24           Set transparent background
25
26       -c
27           Use the Cario driver to render images
28
29       -r
30           Set paper orientation to landscape (for PostScript output)
31
32       --verbose
33           Verbose module output
34
35       --quiet
36           Quiet module output
37
38   Parameters:
39       output=string
40           Name for output file (do NOT add extension)
41
42       format=string
43           Graphics file format
44           Options: png,ppm,tif,jpg,bmp,ps,eps,svg,pdf
45           Default: png
46
47       resolution=integer
48           Dimensions of output file versus current window size
49           (same=1, double size=2, quadruple size=4)
50           Default: 1
51
52       size=width,height
53           Width and height of output image (overrides resolution setting)
54
55       compression=integer
56           Compression for PNG files
57           (0=none, 1=fastest, 9=most; lossless, only time vs. filesize)
58           Options: 0-9
59           Default: 9
60
61       quality=integer
62           File size/quality for JPEG files
63           (10=smallest/worst, 100=largest/best)
64           Options: 10-100
65           Default: 75
66
67       paper=string
68           Paper size for PostScript output
69           Options: a4,a3,a2,a1,a0,us-letter,us-legal,us-tabloid
70           Default: a4
71
72       ps_level=integer
73           PostScript level (only limits functionality!)
74           Options: 1-3
75           Default: 2
76

DESCRIPTION

78       (GRASS Shell Script)
79
80       d.out.file uses  d.save,  the  GRASS  PNG  or  PostScript  driver,  and
81       gdal_translate  to export the currently selected X display monitor to a
82       graphics file of several formats. Output image size can be set prior to
83       export.
84
85       PNG  and PPM formats are supported directly by the GRASS PNG driver and
86       PostScript output is supported directly by the GRASS PS driver.
87
88       TIFF, JPEG, and BMP formats are supported by  using  gdal_translate  on
89       PPM  format files produced by the GRASS PNG driver. Different levels of
90       compression/quality are supported for JPEG files.
91
92       Graphic files are exported to the user's current working  directory  by
93       default, but different paths may be specified in the output field.
94
95       EPS  files  are  not  compatible with d.frame, as it is not possible to
96       nest encapsulation. Only the first frame will be drawn. In these  cases
97       it is recommended to output to regular PostScript format and then use a
98       utility like ps2epsi to convert to an EPS file.  Output from this  mod‐
99       ule using the regular PostScript format may contain subframes.
100

EXAMPLES

102   Speafish dataset
103
104         g.region rast=slope -p
105         d.mon x0
106         d.rast slope
107         d.vect streams type=area,line
108         d.barscale at=0,94.5
109         d.out.file spearfish_pic format=png size=800,600
110         d.out.file spearfish_pic format=ps -r paper=a4
111
112
113   Multi-pane PostScript output using a shaded relief map and
114       d.frame.quarter from the Wiki-Addons site
115         g.region rast=elevation.dem
116         r.shaded.relief map=elevation.dem shad=elev.shad_relf
117         d.mon x1
118         d.frame.quarter
119         d.frame uno
120         d.his h=elevation.dem i=elev.shad_relf brighten=50
121         echo "A" | d.text -b color=black size=10 at=93,5
122         d.frame dos
123         d.his h=slope i=elev.shad_relf brighten=40
124         echo "B" | d.text -b color=black size=10 at=93,5
125         d.frame tres
126         d.his h=landcover.30m i=elev.shad_relf brighten=55
127         echo "C" | d.text -b color=black size=10 at=93,5
128         d.frame cuatro
129         d.his h=trn.sites i=elev.shad_relf brighten=15
130         echo "D" | d.text -b color=black size=10 at=93,5
131         d.frame full_screen
132         d.out.file spearfish_4 format=ps -r paper=a4
133
134

AUTHORS

141       Michael Barton, Arizona State University
142       Hamish Bowman, Otago University, New Zealand
143
144       Last changed: $Date: 2007-11-29 14:24:57 +0100 (Thu, 29 Nov 2007) $
145
146       Full index
147
148       © 2003-2008 GRASS Development Team
149
150
151
152GRASS 6.3.0                                                      d.out.file(1)

NAME

KEYWORDS

SYNOPSIS

DESCRIPTION

EXAMPLES

SEE ALSO

AUTHORS