##

###

###

###

###

###

##

###

###

###

###

###

###

###

###

###

###

###

###

##

###

###

##

##

    Documention Application GIS1
    Version 2.0 - 2011-01-17

     program call:
        Start the user application "APP_GIS1"
          - Select from the list of add-on applications or
          - if application was active before: start with Ctrl-P

     termination of the application:
      Exit button.
      It will pass all data to the CAD model.

    toolbox
    modify points, surfaces
    project objects to surface
    define boundaries, breaklines
    ToDo

    ____________________________________________________________________________

    Import points from ascii-file:
      One point per Line.
      The first word that contains a dot (Decimalpoint, ".") is used
      for the X-Coordinate; the following two words are used for the
      Y- and Z-Coordinates.
      Additional textinfos (Words before or after the Coordinates)
      are not used at the moment.

      Example:
        import file "sample_gispoints1.txt",
          ("ImportPoints"; Filtertext "gis")
        rescale model with button "Scal.All"
        "create Mesh" to create/display the TIN
        "Exit" to transfer date to model
        File/save Model as/VRML2 to create a WRL file.

    Export points into ASCII file:
      Menu item "File / Export points"
      The Coordinates of the Points of the active Point-surface are
      written out into a file.
      At the moment no additional textinfos are written.

    Display the coordinates of all points of the active GIS Area:
      Menu item "Tools / dump all points"
      HTML file {tempDir}/tmp.htm is generated and displayed.

    Display a list of all edges of the active GIS Area:
      Menu item "Tools / dump all edge lines"
      HTML file {tempDir}/tmp.htm is generated and displayed.

    print the current view:
      Menu item "Tools / print"

    ____________________________________________________________________________

    "Edit" - modify points, surfaces

     Create new GIS-points:
      - indicate position with the left mouse button or
      - Select an existing CAD-point or
      - Enter the coordinates into the fields X, Y, Z; button "AddPt.".

     Move GIS-point:
      The active (last selected) point is moved;
      using the coordinates of the fields X, Y, Z;
      Button "Mod.Pt.".

     Move all GIS-points:
      Menu item "Tools / move all points"
      Enter the offset.

     Delete GIS-points:
      select them individually or as a group, "Delete" button.

     Delete a range of consequent points:
      Menu item "Tools / delete range of points"
      Type the Point numbers of the first and last point.

     Delete GIS-edge:
      Select edge, button "Delete".

     Delete network:
      Select network (A), button "Delete".

     Recalculate network:
      Button "create mesh".

     Clean up network boundary:
      Menu item "Tools / remove outer zone"
      Automatic removal of triangles with too long sides.

     Changing the active surface:
      Select from the list of loaded areas (far left).
      Only the active area can be modified.

     Create new surface:
      If no GIS area is included in the model, the start of the function
      automatically generates a new (empty) GIS area.
      With this feature, another new GIS area is generated:
      Menu item "Tools / create new surface"

     Delete active area and all of their points:
      Menu item "Tools / delete active mesh and all points"
      The currently active GIS area and all of its points will be deleted.

    ____________________________________________________________________________

    "prj -> Mesh" - project objects to surface

     Project point onto the net and generate GIS-point:
      - indicate position (left mousebutton) or
      - select CAD-point

     Project curves on the Net:
      select CAD-curve, another CAD-curve is created.
      Attention: the curve must be located within the Network!   (TODO)

    ____________________________________________________________________________

    "create Edge" - define boundaries, breaklines
    create outer Network boundaries outside,
    create inner Network boundaries (holes, void areas),
    create breaklines (edges).

    First define the edgeline, then select the edgetype.

      define consecutive edges by -
      - select GIS points or
      - select curve. The required GIS-points are generated.

      CAUTION:
      - Edge lines may not cross;
      - breaklines may not cross outer and inner boundaries. (TODO)

    ____________________________________________________________________________

    If necessary adjust Model Size:
      (Standards / Tolerances / model size = 15000, Modify, Exit).

     Program Files:
      APP_GIS1 is a supplementary program to gCAD3D.
      The source code file is ../GIS1/APP_GIS1.c
      The APP_GIS1 license program is GPL.

      Please report problems / corrections to franz.reiter@gcad3d.org.

    ____________________________________________________________________________

     TODO:
     LandXML import:
      - Import breaklines
      - Import Void-area (hole inside Borders)

     LandXM create export

     undo / restore for deleted objects