source: subversion/applications/rendering/osmps/README @ 34399

Last change on this file since 34399 was 6276, checked in by matthewnc, 12 years ago

osmps - PostScript? Renderer
update to 0.04

  • add ability to set output clipping area (tries not to draw objects outside this area for efficiency, and then PS clips to the area): aiming to more easily allow production of multi-page map booklets etc
File size: 2.4 KB
Line 
1OSMPS - a PostScript renderer for OpenStreetMap files
2=====================================================
3
4OSMPS generates Encapsulated PostScript files from OSM XML files.
5Rules for generating parts of the output are currently contained
6within the program and describe PostScript code to be utilised for
7particular tags.
8
9PostScript is sent to standard output. Typical usage would be
10
11  osmps.rb map.osm > map.ps
12
13as a subsequent step a PDF file may be generated with the common
14ps2pdf tool (which is a wrapper around GhostScript), or with Adobe
15Distiller.
16
17  ps2pdf map.ps
18
19Internal data structure
20-----------------------
21
22OSMPS possibly uses an odd method of processing the data. First
23nodes and segments are read from the file. Ways are then read but
24the tags are purely "pushed down" onto the segments that are in
25each way. Finally, paths are created from adjacent segments that
26are (a) pointing in the same direction and (b) have exactly the
27same tag set.
28
29Features
30--------
31
32Current features include basic areas, roads, simple bridges and
33road names. Planned next are oneway arrows and more node logos,
34and hopefully code to paginate maps easily (think easily print an
35"A-Z" book type town map from OSM).
36
37Logos
38-----
39
40The pslogos directory contains a font designed with FontForge that
41has glyphs to be used as some logos on the map. The .sfd file is
42the FontForge source - this is then generated into a .pfa
43PostScript Type1 font which is copied into logos.eps and osmps.rb
44itself. A small PostScript function is written for each character
45to set the colours and draw it correctly.
46
47Matthew Newton
4829 July 2007
49
50
51Changelog:
52
530.01    - 2007-03-20
54          initial release
55
560.02    - 2007-07-29
57          fixed scaling issues
58          rendering updates, including logos for some nodes
59          style updates and additions
60          move importosm to be a method of the Graph object
61          several other bugfixes and tweaks
62
630.02.1  - 2007-08-09
64          added highway=pedestrian style
65          tweaked highway style gen code and added a few comments :)
66
670.03    - 2007-10-15
68          converted for OSM data version 0.5
69
700.03.1  - 2008-01-03
71          add setpagedevice to set output size correctly
72          update some styles
73          add capability for dashed lines in styles
74
750.04    - 2008-01-07
76          add ability to define output area (for example to easily
77            produce multi-page map booklets)
78
Note: See TracBrowser for help on using the repository browser.