Image Display

Using Raster Manager you can open and display images of various formats, from monochrome to full color (For details, see the list of Supported Input File Formats). Single images, or groups of images, can be set to display in one or more DGN file views. MicroStation's drawing and annotation tools still can be used in views that display raster images. The Raster Manager dialog list box displays a list of all attached image files. You can set the size of the list box by dragging the horizontal/vertical edges, or the corners of the dialog box. When the number of images in a list is larger than the number of lines displayed, you can scroll up and down with the scroll bar.

You can modify the location, display order, and various other settings of previously attached raster image files. Changes can be made via the Attachment Settings dialog box, the Modify tool, or the attachment information section of the Raster Manager dialog box. Additionally, the Warp tool lets you fit (warp) a raster image to a particular shape.

When you display a raster image file in a DGN file, it is attached in a Raster Reference Attachment. When a raster attachment is modified with Raster Manager, no changes are made to the original file, just to its attachment information in the DGN file.

Attaching raster files

Using the Raster Manager dialog box, or tools in the Raster Display and Raster Control tool boxes, you can control the display of raster references in one or more MicroStation DGN file views.

You can attach a raster reference to a DGN file by selecting File > Attach in the Raster Manager dialog box , or by selecting the Attach tool in the Raster Control tool box. In either case, the Attach Raster Reference dialog box opens, letting you choose the view(s) in which to display the image.

To attach a raster reference based on the image's own positioning information

1. From the Raster Manager File menu, choose Attach.
   or
   In the Raster Control tool box, select the Attach tool.
   The Attach Raster Reference dialog box opens.


2. Use controls in the Attach Raster Reference dialog box to select the raster image file.


3. (Optional) Turn On Raster Preview, to preview the file being attached.


4. (Optional) Enter Logical Name and Description.


5. Turn Off Place Interactively.


6. (Optional) Turn On Open Raster Files Read Only.


7. Turn On the view number(s) in which the raster reference is to be displayed.


8. Click OK.

To attach a raster reference interactively

1. From the Raster Manager File menu, choose Attach. In the Raster Control tool box, select the Attach tool.
   The Attach Raster Reference dialog box opens.


2. Use controls in the Attach Raster Reference dialog box to select the raster image file.


3. (Optional) Turn On Raster Preview, to preview the file being attached.


4. (Optional) Enter Logical Name and Description.


5. Turn On Place Interactively.

   Rotation and Affinity values are not applied to image(s) when attached with the “Place Interactively” toggle set to ON.



6. (Optional) Turn On Open Raster Files Read-Only.


7. Turn On the view number(s) in which the raster reference is to be displayed.


8. Click OK.


9. Place a data point in the designated view, to define the origin of the image.


10. Place a second data point to define the opposite corner of the image.
    The Modify Image dialog box opens, letting you make additional adjustments to the image, either by keying in values in the settings window, or by dragging the handles on the image.


11. Make any required adjustments to the image.


12. Reset to finish.

Selecting raster files to modify/manipulate

You can choose one or more images via the Raster Manager dialog box , or with the Raster Selection tool. While only one raster file at a time can be modified with tools such as those that mirror, warp and clip, you can manipulate several images simultaneously with Modify/Manipulate. For example, you can choose several images that you want to bring to the front of the display, or send to the back of the display, in one step.

To select one image in a view

1. Select the Raster Selection tool.


2. Click the required image in the view.
   The selected raster filename is highlighted in the Raster Manager dialog box (if open). If Display Border Around Selected Raster (Workspace Preferences) is On, the image highlights in the view(s) as well. All other images are deselected.

To select additional images in a view

1. Select the Raster Selection tool.


2. Control-click the additional images. That is, while holding down the <Ctrl> key, click the additional images.
   The additional raster filenames highlight in the Raster Manager dialog box (if open). If Display Border Around Selected Raster (Workspace Preferences) is On, the images highlight in the view(s) as well. If you control-click a previously selected image, it is deselected.

To select one raster image from the list

1. In the Raster Manager dialog box, click the name of the required image.
   The selected raster filename is highlighted and any other previously selected files are deselected. If Display Border Around Selected Raster (Workspace Preferences) is On, the image highlights in the view(s) as well.

To select additional raster images from the list

1. In the Raster Manager dialog box, control-click the names of the additional images. That is, while holding down the <Ctrl> key, click the names of the additional images.
   The additional raster filenames highlight in the Raster Manager dialog box. If Display Border Around Selected Raster (Workspace Preferences) is On, the images highlight in the view(s) as well. If you control-click a highlighted name, it is deselected.

To select several consecutive raster images from the list

1. In the Raster Manager dialog box, click the name of the first image.


2. Shift-click the name of the last consecutive image. That is, hold down the <Shift> key and click the name of the last image.
   The first image, the last image, and all names in between are selected.

To deselect images

1. Control-click the names of the images you want to deselect in the Raster Manager dialog box.
   or
   Select the Raster Selection tool and control-click the images that you want to deselect.

To deselect all images in a view

1. Select the Raster Selection tool.


2. Click a blank part of a view.

To deselect all raster files from the list

1. In the Raster Manager dialog box, click any name.
   All names are deselected except for this one.


2. Control-click the highlighted name to deselect it.

Detaching raster files

You can detach one or more raster references. First select the required files in the Raster Manager dialog list box , or use the Raster Selection tool. Then select File > Detach or press the right mouse button and select Detach from the right-click menu. To detach all raster references, select File > Detach All.

If mirroring, warping resizing or clipping modifications were brought to the image, detaching the image will result in the loss of those settings. In order to keep them, you can save the image in a new file using the Save As menu with the Option > Resample toggle On.

When detaching a read-write mode raster file, if the native information of the file has been modified during the work session, Raster Manager will automatically save the changes made to the raster file. This applies to the following "native" information:

• Georeference which is native to the file (geotiff/HMR/Intergraph formats, and others)

• Georeference stored in a sister file

• Coordinate systems and projections in a geotiff.

If the file being detached does not have native georeference or georeference stored in an already existing file, the “Save Location Info in Sister File if Required” toggle in the Workspace > Preferences dialog box has to be set to ON for the file to be updated. Otherwise, if the file has native georeference or if it already has a sister file, it will be updated regardless of the toggle setting.

Automatic file saving controls the detach operations in Raster Manager. By default, automatic file saving of rasters is activated, meaning the user is not prompted when changes to the files are committed in a detach operation. You can change the default behavior for automatic file saving so that each detach operation in Raster Manager will prompt for saving or not saving the image, whichever case applies.

Use the following key-ins to change the default behavior of automatic file saving:

• RASTER SAVEAUTO SETON to activate automatic file saving

• RASTER SAVEAUTO SETOff to disable automatic file saving

• RASTER SAVEAUTO TOGGLE to invert automatic saving status

• RASTER SAVEAUTO GET to get the status of automatic saving (in the status field).

You can also use the following configuration variables:

• MS_RASTER_SAVEAUTO = 0 to disable automatic file saving.

• MS_RASTER_SAVEAUTO = 1 to activate automatic file saving.

In order to activate the MS_RASTER_SAVEAUTO configuration variable, MicroStation needs to be exited and reopened.

To detach selected raster files

1. In the Raster Manager dialog list box, click the name of the image to detach.
   or
   Select the Raster Selection tool, and identify a raster image.


2. (Optional) Hold down the <Ctrl> key and select additional filenames or interactively identify raster images.
   You also can hold down the <Shift> key to select consecutive names in the Raster Manager dialog box list.


3. From the Raster Manager File menu, choose Detach.
   or
   With the pointer in the Raster Manager file list box, right-click the mouse (press the right mouse button) and select Detach from the right-click menu.
   If the following variable are set: MS_RASTER_NO_DETACH_CONFIRM=0 and RASTER SILENT ON, an alert box asks if you are sure that you want to detach the selected raster reference(s). You can turn Off the alert box with the key-in MS_RASTER_NO_DETACH_CONFIRM=1 . In order to activate the MS_RASTER_NO_DETACH_CONFIRM configuration variable, MicroStation needs to be exited and reopened.


4. Click OK.
   If you made changes to the raster reference's native information and Autosave is set to Off, an Alert box asks if you want to save the changes.


5. Click your selection (Yes, Yes To All or No) or Cancel to exit without detaching.

To detach all raster references

1. From the Raster Manager File menu, choose Detach All.
   If the following variable are set: MS_RASTER_NO_DETACH_CONFIRM=0 and RASTER SILENT ON, an alert box asks if you are sure that you want to detach the selected raster reference(s). You can turn Off the alert box with the key-in MS_RASTER_NO_DETACH_CONFIRM=1 . In order to activate the MS_RASTER_NO_DETACH_CONFIRM configuration variable, MicroStation needs to be exited and reopened.


2. Click OK.
   If you made changes to the raster reference's native information and Autosave is set to Off, an Alert box asks if you want to save the changes.


3. Click your selection (Yes, Yes To All or No) or Cancel to exit without detaching.

Image Server

Used to create new or modify existing server configuration files.

To set an Image Server

1. Choose Settings > Image Server


2. Select the Add tool.
   The New Server Alias dialog box opens.


3. Type in the name of the server you want to add.
   The new server name displays in the Alias list and name box.


4. Type in the URL name or IP address.


5. Click OK.
   The new alias is saved. You can also select Save or Save as in the File menu of the Image Server Settings dialog box.

To attach a raster file from a server

1. From the Raster Manager File menu, choose Attach or select the Attach tool from the Raster Control tool box.
   The Attach Raster Reference dialog box opens.


2. From the Drives option menu, choose the new image server you created above.
   Notice the alias name is there, not the server name.


3. Select the name of the required file.


4. (Optional) Turn On Raster Preview, to preview the file being attached.


5. (Optional) Turn On Place Interactively.


6. Click OK.