./ plugins/ input/ raster/ raster_info.os ./ plugins/ input/ raster/ raster_datasource.os ./ src/ font_engine_freetype.os ./ plugins/ input/ raster/ raster.input ./ src/ point_symbolizer.os ./ src/ scale_denominator.os ./ src/ envelope.os ./ src/ image_util.os ./ plugins/ input/ raster ./ src/ graphics.os ./ src/ text_symbolizer.os ./ plugins ./ src/ png_reader.os ./ src/ polygon_pattern_symbolizer.os ./ src/ map.os ./ src/ wkb.os ./ src/ line_pattern_symbolizer.os ./ src/ symbolizer.os ./ src/ plugin.os ./ plugins/ input/ raster/ raster_featureset.os ./ src/ layer.os ./ src/ proj_transform.os ./ src/ tiff_reader.os ./ src/ load_map.os ./ src ./ src/ datasource_cache.os ./ src/ save_map.os ./ plugins/ input ./ src/ libmapnik.so ./ plugins/ input/ shape/ shape.os ./ src/ color.os ./ src/ memory_datasource.os ./ src/ params.os ./ src/ placement_finder.os ./ src/ font_set.os ./ src/ libxml2_loader.os ./ plugins/ input/ shape/ shape_io.os ./ src/ arrow.os ./ src/ distance.os ./ plugins/ input/ shape ./ src/ agg_renderer.os ./ plugins/ input/ shape/ shape_index_featureset.os SCons 4.2.0 ./ src/ stroke.os ./ src/ memory.os ./ src/ projection.os ./ src/ image_reader.os ./ src/ unicode.os ./ plugins/ input/ shape/ shape.input ./ src/ shield_symbolizer.os ./ plugins/ input/ shape/ dbffile.os ./ src/ filter_factory.os Design./ plugins/ input/ shape/ shapefile.os ./ plugins/ input/ shape/ shape_featureset.os ./ agg/ src/ agg_trans_double_path.o Steven Knight./ agg/ src/ agg_sqrt_tables.o ./ bindings/ python/ mapnik_raster_symbolizer.os ./ bindings/ python/ mapnik_text_symbolizer.os ./ agg/ src/ agg_vcgen_dash.o ./ agg/ src/ agg_bezier_arc.o ./ agg/ src/ agg_vpgen_clip_polygon.o ./ agg/ src/ agg_vcgen_contour.o ./ agg/ src/ agg_gsv_text.o ./ bindings/ python/ mapnik_color.os ./ agg/ src/ agg_arrowhead.o ./ bindings/ python/ mapnik_query.os ./ agg/ src/ agg_bspline.o ./ bindings/ python/ mapnik_stroke.os ./ agg/ libagg.a ./ agg/ src/ agg_vpgen_clip_polyline.o ./ agg/ src/ agg_trans_single_path.o ./ agg/ src/ agg_vcgen_stroke.o ./ agg/ src/ agg_trans_warp_magnifier.o ./ bindings/ python/ mapnik_featureset.os ./ bindings/ python/ mapnik_style.os ./ agg/ src/ agg_embedded_raster_fonts.o ./ bindings/ python/ mapnik_parameters.os ./ agg/ src ./ bindings/ python/ mapnik_shield_symbolizer.os ./ agg/ src/ agg_arc.o ./ agg/ src/ agg_curves.o ./ bindings/ python/ mapnik_line_pattern_symbolizer.os ./ agg/ src/ agg_vcgen_bspline.o ./ agg/ src/ agg_rounded_rect.o ./ bindings/ python/ mapnik_symbolizer.os ./ agg/ src/ agg_image_filters.o ./ bindings/ python/ mapnik_python.os ./ bindings/ python/ mapnik_filter.os ./ agg/ src/ agg_line_aa_basics.o ./ bindings/ python/ mapnik_map.os ./ bindings ./ bindings/ python/ mapnik_layer.os ./ agg/ src/ agg_line_profile_aa.o ./ agg/ src/ agg_vpgen_segmentator.o ./ agg ./ bindings/ python ./ agg/ src/ agg_vcgen_markers_term.o ./ bindings/ python/ mapnik_image_view.os ./ bindings/ python/ python_cairo.os ./ bindings/ python/ mapnik ./ agg/ src/ agg_vcgen_smooth_poly1.o ./ agg/ src/ agg_trans_affine.o ./ bindings/ python/ mapnik_polygon_symbolizer.os ./ bindings/ python/ mapnik/ ogcserver ./ bindings/ python/ mapnik_geometry.os ./ bindings/ python/ mapnik_point_symbolizer.os ./ bindings/ python/ _mapnik.so ./ bindings/ python/ mapnik_envelope.os ./ bindings/ python/ mapnik_rule.os ./ agg/ include ./ bindings/ python/ mapnik_feature.os ./ bindings/ python/ mapnik_image.os ./ bindings/ python/ mapnik_polygon_pattern_symbolizer.os ./ bindings/ python/ mapnik_coord.os ./ bindings/ python/ mapnik_view_transform.os ./ bindings/ python/ mapnik_datasource_cache.os ./ bindings/ python/ mapnik_datasource.os ./ bindings/ python/ mapnik_line_symbolizer.os ./ bindings/ python/ mapnik_projection.os ./ bindings/ python/ mapnik_proj_transform.os ./ bindings/ python/ mapnik_font_engine.os version 4.2.0 Copyright © 2001 Steven Knight Publication date 2001 Copyright (c) 2001 Steven Knight Portions of this document, by the same author, were previously published Copyright 2000 by CodeSourcery LLC, under the Software Carpentry Open Publication License, the terms of which are available at http:// www.software-carpentry.com/openpub-license.html [http://www.software-carpentry.com/openpub-license.html]. Table of Contents 1. Introduction ................................................................................................................................... 1 1.1. About This Document .......................................................................................................... 1 2. Goals ........................................................................................................................................... 2 2.1. Fixing Make's problems ........................................................................................................ 3 2.2. Fixing Cons's problems ......................................................................................................... 3 3. Overview ...................................................................................................................................... 4 3.1. Architecture ........................................................................................................................ 4 3.2. Build Engine ....................................................................................................................... 5 3.2.1. Python API .............................................................................................................. 5 3.2.2. Single-image execution ............................................................................................... 5 3.2.3. Dependency analysis .................................................................................................. 5 3.2.4. Customized output ..................................................................................................... 6 3.2.5. Build failures ............................................................................................................ 6 3.3. Interfaces ............................................................................................................................ 6 3.3.1. Native Python interface .............................................................................................. 6 3.3.2. Makefile interface ...................................................................................................... 6 3.3.3. Graphical interfaces ................................................................................................... 7 4. Build Engine API ........................................................................................................................... 8 4.1. General Principles ................................................................................................................ 8 4.1.1. Keyword arguments ................................................................................................... 8 4.1.2. Internal object representation ....................................................................................... 8 4.2. Construction Environments .................................................................................................... 8 4.2.1. Construction variables ................................................................................................ 9 4.2.2. Fetching construction variables .................................................................................... 9 4.2.3. Copying a construction environment ............................................................................. 9 4.2.4. Multiple construction environments ............................................................................. 10 4.2.5. Variable substitution ................................................................................................. 10 4.3. Builder Objects .............................................................................................................. 11 4.3.1. Specifying multiple inputs ......................................................................................... 12 4.3.2. Specifying multiple targets ........................................................................................ 12 4.3.3. File prefixes and suffixes .......................................................................................... 13 4.3.4. Builder object exceptions ...................................................................................... 13 4.3.5. User-defined Builder objects .................................................................................. 13 4.3.6. Copying Builder Objects ....................................................................................... 14 4.3.7. Special-purpose build rules ........................................................................................ 15 4.3.8. The Make Builder ............................................................................................... 15 4.3.9. Builder maps ...................................................................................................... 15 4.4. Dependencies .................................................................................................................... 16 4.4.1. Automatic dependencies ............................................................................................ 16 4.4.2. Implicit dependencies ............................................................................................... 16 4.4.3. Ignoring dependencies .............................................................................................