man/projection.n

   1
   2 .TH projection n 1.0 Fgis "user Tcl commands"
   3
   4 .SH NAME
   5 projection \- Create and manipulate projection objects
   6
   7 .SH SYNOPSIS
   8 \fB projection \fItype\fR ?\fIparameters\fR?
   9 .PP
  10
  11
  12 .SH DESCRIPTION
  13 .PP
  14
  15 This command creates projection object, used to recalculate geographic
  16 coordinates (latitude and longitude) into map projection coodrinates.
  17 .PP
  18 \fBprojection\fR command takes  list of options and
  19 returns name of newly created projection object.
  20 Name of object can be used as Tcl command which have several subcommands
  21 (see \fBPROJECTION SUBCOMMANDS\fR below) used for manipulation
  22 of projections.
  23
  24 .SH PROJECTION TYPES
  25
  26 Most important property of projection is projection type. fGIS supports
  27 following types of projections:
  28
  29 \" list should be here
  30
  31 .SH PROJECTION OPTIONS
  32
  33 \" list should be here
  34
  35 .SH PROJECTION SUBCOMMANDS
  36 .TP 8
  37 \fIprojName \fBforward\fI long lat\fR
  38 recieves two arguments - geographic longitude and latitude as degrees in
  39 decimal format and returs list of two double values representing map
  40 coordinates in meters.
  41
  42 .TP 8
  43 \fIprojName \fBbackward\fI X Y \fR
  44 performs backword transformation - given map coordinates in meters
  45 returns longitude and latitude in decimal degrees,
  46 .TP 8
  47 \fIprojName \fBformat\fI X Y\fR ?\fB-format\fI formatString\fR
  48 Returns formatted representation of latitude and longitude. String
  49 can contain following escapes sequences:
  50 .RS
  51 .TP
  52 \fB%lt\fR
  53 unsigned latitude in DDMMSS format
  54 .TP
  55 \fB%lg\fR
  56 unsigned longitude in DDMMSS format
  57 .TP
  58 \fB%-t\fR \fB%-g\fR
  59 optionally signed latitude and longitude in DDMMSS format
  60 .TP
  61 \fB%+t\fR \fB%+g\fR
  62 explicitely signed latitude and longitude in DDMMSS format
  63 .TP
  64 \fB%lG %lT %-G %-T %+G %+T\fR
  65 same as above, but in decimal fractions of degree
  66 .TP
  67 \fB%dl %dg\fR
  68 direction indicator - letters N and S for latitude and E and W for
  69 longitude (or some other national language values as defined in fgis.rc
  70 file).
  71 .RE
  72 If \fIformatString\fR omitted, default "%lt%dt %lg%dg" is used.
  73 .TP 8
  74 \fIprojName\fB dump\fR
  75 returns argumets for projection command used to create this projection
  76 object.
  77 .TP 8
  78 \fIprojName\fB delete\fR
  79 destroys projection object.
  80
  81 .SH "SEE ALSO"
  82
  83 .BR proj "(1), " pj_init "(3), " transform (1)
  84
  85