Primary Attributes

Each GINA feature may have associated primary attributes used to store non-spatial and non-system information associated with the feature. All primary attributes are supported. The corresponding primary table field names are used as attribute names in the mapping file group attribute listing. For example:

GINA photograph0000310003                             \
      gina_feat_type          gina_point              \
      gina_feat_code          %gina_feat_code         \
      FILE_NAME               %file_name              \
      gina_feat_plan          %gina_feat_plan         \
      gina_feat_network       %gina_feat_network      \
      DESCRIPTION             %description            \
      BITS_PER_PIXEL          %bits_per_pixel         \
      IMAGE_TYPE              %image_type             \
      gina_feat_number        %gina_feat_number       \
      gina_feat_version       %gina_feat_version      \
      PIXELS_PER_LINE         %pixels_per_line        \
      gina_feat_gp1           %gina_feat_gp1          \
      gina_feat_class         %gina_feat_class        \
      gina_feat_gp2           %gina_feat_gp2          \
      gina_feat_layer         %gina_feat_layer        \
      NO_OF_LINES             %no_of_linesTable 4 System Attributes

In this example, FILE_NAME, DESCRIPTION, BITS_PER_PIXEL, IMAGE_TYPE, PIXELS_PER_LINE, and NO_OF_LINES are primary attribute names (i.e., their corresponding primary table’s field names). When creating a mapping file from the GINA format to another format, the VISION* GINA reader automatically extracts those names for each feature group and lists them in the group’s attribute listing (as shown in the above example). The VISION* GINA reader also puts those attributes into the corresponding definition line. For example:

DWG_DEF photograph0000310003                          \
      autocad_color           $(AUTOCAD_BrightRed)    \
      autocad_linetype        CONTINUOUS              \
      gina_feat_code          char(13)                \
      FILE_NAME               char(14)                \
      gina_feat_plan          number(11,0)            \
      gina_feat_network       number(11,0)            \
      DESCRIPTION             char(60)                \
      BITS_PER_PIXEL          number(11,0)            \
      IMAGE_TYPE              char(1)                 \
      gina_feat_number        number(11,0)            \
      gina_feat_version       number(11,0)            \
      PIXELS_PER_LINE         number(11,0)            \
      gina_feat_gp1           number(31,15)           \
      gina_feat_class         number(11,0)            \
      gina_feat_gp2           number(31,15)           \
      gina_feat_layer         number(11,0)            \
      NO_OF_LINES             number(11,0)

The VISION* GINA writer can also use primary attributes to accommodate desired information from the source dataset. However, the user must create a primary table using the primary table keywords (PRIMARY_TABLE, FIELD, and FEATURE_CODE) in the mapping file. For example:

GINA_PRIMARY_TABLE road
GINA_FIELD DXF_LAYER "" CHAR 33 0
GINA_FIELD LINE_TYPE "" CHAR 33 0
GINA_FIELD COLOR "" NUM 6 0
GINA_FIELD THICKNESS "" NUM 31 15
GINA_FEATURE_CODE new_road

The GINA field names defined in the table can then be used as attributes names for features with gina_feat_code as new_road. For example:

GINA lines                                            \
      gina_feat_type          gina_line               \
      gina_feat_code          new_road                \
      gina_feat_layer         303                     \
      gina_feat_network       30304                   \
      autocad_elevation       %autocad_elevation      \
      THICKNESS               %autocad_thickness      \
      COLOR                   %autocad_color          \
      DXF_LAYER               %autocad_layer          \
      LINE_TYPE               %autocad_linetype