Reference Guide
Reference Guide
Reference Guide

Raster Manager

Contains controls that are used to set preferences related to raster references.

Display Border Around Selected Raster

If on, a border is displayed around any selected raster images.

Key-in: IMGMANAGER VIEWBORDER SETON

Key-in: IMGMANAGER VIEWBORDER SETOFF

Key-in: IMGMANAGER VIEWBORDER GET

File Georeference Has Priority when Raster Is Loaded

If on, the file Georeference information has priority when the raster file is loaded for a preexisting attachment.

If off, the raster reference attachment has priority over the file Georeference information.

If many attachments of the same raster are found in many models, the position of the raster found in the Default (main) model will take precedence over the position found in all the other models.

Use Sister File, if Present, for Georeference Files

If on, Raster Manager will extract the geo-location from the associated sister/world file (if it exists) for all formats with header information (Example: COT, HMR, iTiff, GeoTiff). To be used, the sister/world file must be in the same folder as the image and have the same prefix. For files such as GeoTiff, ECW, SID, etc, the header will not be read and the sister/world file will be used instead. Thus, if the image header contains a Coordinate System, it will not be used. Once loaded in Raster Manager, the GeoPriority setting can be used to change the georeference from Sister File to Image Header or Attachment. This preference is useful for image files that were used with legacy systems not supporting header information and where sister/world files were used instead to store the geo-location.

Save Location Info in Sister File if Required

If on, automatically saves the file location information in a sister file when the raster image format does not support this feature.

This option affects only the files with sister files. You can specify the kind of sister file (HGR or World File) you want to create with the MS_RASTER_DEFAULTSISTER environment variable or with the following key-ins:

Key-in: RASTER DEFAULTSISTERTYPE HGR

Key-in: RASTER DEFAULTSISTERTYPE WORLD

Open Raster Files Read-Only

Specifies if the image will be opened in read-only mode or in edit mode. When a DGN is loaded, all the included raster attachments are opened with the opening mode specified in this preference. When the toggle is On, it allows multiple users to share the same DGN file.

Update MS_RFDIR Automatically for Raster Attachments

If on, automatically appends the path of attached raster images to the MS_RFDIR configuration variable. The raster attachments will be searched for in the directories named by the configuration variable. If the toggle is set to off, the paths will not be appended to the variable and the images will be searched for only in the paths already listed in the MS_RFDIR variable.

Key-in: RASTER AUTOUPDATEREFPATH SETON

Key-in: RASTER AUTOUPDATEREFPATH SETOFF

List Raster Attachments From Self References

If on, all raster attachments are listed in the main Raster Manager dialog box. Thus, if a DGN file references itself, the raster attachment will be listed twice. If the toggle is set to off, only the raster attachments in the master model will be listed.

Key-in: RASTER LISTSELFREFERENCE SETON

Key-in: RASTER LISTSELFREFERENCE SETOFF

Key-in: RASTER LISTSELFREFERENCE GET

GeoTiff Settings

Raster Manager needs to know the GeoTiff image file's coordinate units to be able to correctly place it in the design plane. This information is extracted based on the GeoCoding Projected Coordinate System (PCS) and the EPSG table that define the unit for this PCS. In some circumstances, a ProjLinearUnitsGeokey can also exist within the GeoTiff; this geokey also defines a unit for the GeoTiff. A problem arises when:

  1. PCS and ProjLinearUnitsGeokey are both undefined. In this case, the GeoTiff unit is unknown.

  2. PCS and ProjLinearUnitsGeokey are both defined but not resolved in the same unit.

The following preferences exist to resolve GeoTiff units and display GeoTiff image files correctly.

Use Unit Definition Geokey if Present (override PCS unit)

This toggle is used when GeoTiff units are defined. If on, places the GeoTiff image using the units found in its ProjLinearUnitsGeokey field. If off, places the GeoTiff image using the units under the Projected Coordinate System (PCS).

GeoTiff Default Unit Label

Defines the unit type and value to use when the unit is undefined in the GeoTiff image file.

WorldFile Default Unit Label

Defines the unit type and value to use with world files. The unit type can be expressed as a distance or as Working Units. Default is Meters.

Recent files List Contains _ Files

Sets how many files display in the recent files list of the Attach Raster Reference dialog's File menu. Default is 4.