Autodesk 15606-011408-9330 User Guide - Page 103

Raster Image Catalog Files

Page 103 highlights

Raster Image Catalog Files In addition to individual raster image files, Autodesk MapGuide supports Raster Image Catalog (RIC) files. A RIC is a list of raster image files and their lower-left and upper-right coordinates. When creating a raster map layer, you can reference an individual raster image in any of the supported formats shown on page 101, or in a RIC file. Each raster image file (whether an individual image or a RIC) must be accompanied by a georeferencing file, which provides additional information about how to position the raster image on the map. Note that GeoTIFF files do not require a separate georeferencing file. Raster images in ECW and MrSID format are already optimized, so there is no reason to include them in RIC files. When you access a layer that references a RIC file, Autodesk MapGuide Server scans through the RIC file to determine the images or portions of images that correspond to the area being viewed, and then sends only the data for that area. This greatly increases performance, as only the necessary data is stored in memory instead of the entire image. It is important to keep in mind that the RIC file only determines which images might be visible. Georeferencing information for each individual raster image must still be available, as this information-not the information in the RIC file-is used to place them in the correct position on the map. Note that the raster image must be based on the same coordinate system as the rest of the data on the map, and it cannot be converted automatically if you change the coordinate system for the map. If Autodesk MapGuide Server is running under the System account, please note the following:  All of the image files in the RIC must be on the same server as the RIC.  The RIC must reference the raster image files using relative paths. If you use a computer name in the path, Windows NT/2000 will not be able to recognize it. Raster Image Catalog File Format Raster image catalog files are ASCII, comma-delimited (CSV) files with the following format: "",,,, "",,,, "",,,, ... "",,,, Working with Raster Images | 103

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204

Working with Raster Images
|
103
Raster Image Catalog Files
In addition to individual raster image files, Autodesk MapGuide supports
Raster Image Catalog (RIC) files. A RIC is a list of raster image files and their
lower-left and upper-right coordinates. When creating a raster map layer, you
can reference an individual raster image in any of the supported formats
shown on page 101, or in a RIC file. Each raster image file (whether an indi-
vidual image or a RIC) must be accompanied by a georeferencing file, which
provides additional information about how to position the raster image on
the map. Note that GeoTIFF files do not require a separate georeferencing file.
Raster images in ECW and MrSID format are already optimized, so there is no
reason to include them in RIC files.
When you access a layer that references a RIC file, Autodesk MapGuide Server
scans through the RIC file to determine the images or portions of images that
correspond to the area being viewed, and then sends only the data for that
area. This greatly increases performance, as only the necessary data is stored
in memory instead of the entire image.
It is important to keep in mind that the RIC file only determines which
images might be visible. Georeferencing information for each individual
raster image must still be available, as this information
not the information
in the RIC file
is used to place them in the correct position on the map.
Note that the raster image must be based on the same coordinate system as
the rest of the data on the map, and it cannot be converted automatically if
you change the coordinate system for the map.
If Autodesk MapGuide Server is running under the System account, please
note the following:
All of the image files in the RIC must be on the same server as the RIC.
The RIC must reference the raster image files using relative paths. If you
use a computer name in the path, Windows NT/2000 will not be able to
recognize it.
Raster Image Catalog File Format
Raster image catalog files are ASCII, comma-delimited (CSV) files with the
following format:
"<Name of the raster image file1>",<xMin>,<yMin>,<xMax>,<yMax>
"<Name of the raster image file2>",<xMin>,<yMin>,<xMax>,<yMax>
"<Name of the raster image file3>",<xMin>,<yMin>,<xMax>,<yMax>
...
"<Name of the raster image file
n
>",<xMin>,<yMin>,<xMax>,<yMax>