Working map

Display:

Description:
The aim of the working map module is to introduce in the diagram the map on which the user is to work.
You have two possibilities:

• Choosing a file on your hard disk, containing a map. For this, select the File box, and then click on the Choose the map file button .
• Choosing a "Blob" field of a 4D database, containing a map. For this, select the 4D Database box, and then fill in the Table name, Field name, Key field name and Key value boxes concerning the 4D database you want to use (the base must be opened with the Cartes & Données Plug-In).

If you check the Automatic module name box, the module name in the diagram will be chosen automatically, and you will not be able to modify it yourself. This will be the name of the file selected, or the key value for 4D databases.

File location:
In the Options/Preferences menu , you can choose a data directory. If the file is under that directory or any subdirectory, it is considered to be relative.

• We recommend that all the documents (maps, data, diagrams) be placed in this directory.
• We do not recommend ever changing this directory, because it is used as a reference for all the relative files.
• If two persons have Cartes & Données, they can exchange diagrams very easily if they have been careful to place their data in the directory using a similar directory hierarchy. This is the case even if one is using a Macintosh and the other a PC.

Parameters of the 4D database:
Example:
If the "MapsFrance" table is structured thus:

(where "Map" is a Blob field)
and the values in the "Identifier" field are French department numbers (text codes), the following values can be entered to obtain a map of Paris:

Table name: MapsFrance
Field name: Map
Key field name: Identifier
Key value: 75

ATTENTION: there must be only one Plug-In on the machine. If several 4D databases are open and each one has a Plug-In, the parameter transfer will not be carried out correctly.

The following error messages may appear during program execution:

Consulting data:
The module is linked to a window called ".... Window". All the modules using this working map will have a column in this window (with very few exceptions). Examples: statistical data, calculations, surfaces, etc.
The data window enables consultation and modification of values. Each column can be moved by using the mouse to drag its title, and its size can be changed by moving the right edge of its title.
It is also possible to modify a column in a block, by clicking on its title. A data entry box pops up. This is the only possible method of modifying the matrix values.

There is a button that can be pressed to save the data in a text file, which can then be used in the data module.

Format of the working map:
The working map specified can be in any of the following formats:

• Cartes & Données and C&D Numérisation (all versions, and all platforms)
• "NUM"
• WMF (windows metafile 16 bits)
• DXF
• Adobe Illustrator 3
• BNA
• Map Info
• Ungenerate Arc/Info
• Shapefile Arc/View

(see the description of formats in imports / exports)

For the Map Info and Shapefile formats, the column numbers for the identifiers and the names must be specified in the text areas provided. The lowest possible value for these numbers is 1.

Information on the working map:
The text area in the lower left-hand corner of the display contains information about the working map you have specified. Once you have chosen the map to be used, you must click on the Apply button to have the following information displayed:

• The format of the map
• The number of entities on the map, with their breakdown:
  • The number of surfaces
  • The number of lines
  • The number of points
• The size of the map:
  • Width
  • Height
  • The coordinate of the lower edge
  • The coordinate of the left edge

Script:

2      module untyped_list ""
3        mod_type integer "101"
3        mod_subtype integer "0"
3        mod_name string "FRANCDEP.VXF"
3        mod_dads integer_list ""
3        path path ""
4          file_type integer "-1"
4          type integer "4"
4          volume string ""
4          path_elem string_list ""
5            ? string "<<.>>"
5            ? string "FRANCE"
5            ? string "DPT"
5            ? string "FRANCDEP.VXF"
3        absolute boolean "F"
3        base_path path ""
4          file_type integer "-1"
4          type integer "2"
4          volume string "D"
4          path_elem string_list ""
5            ? string "DevelRes"
5            ? string "Lib_html"
5            ? string "Scripts"
3        auto_name boolean "T"
3        id_column integer "1"
3        name_column integer "2"
3        entity_nb integer "96"
3        pt_nb integer "0"
3        line_nb integer "0"
3        surf_nb integer "97"
3        bottom_left vector ""
4          x_val double "72.699997"
4          y_val double "1620.9"
4          z_val double "0"
3        top_right vector ""
4          x_val double "1197.6"
4          y_val double "2675.3999"
4          z_val double "0"
3        format string "Cartes (*.vxf)"
3        in_database boolean "F"
3        table_name string ""
3        data_name string ""
3        key_name string ""
3        key string ""