Reference Guide
Reference Guide
Reference Guide

Raster Manager dialog box

Used to control the display of one or more raster images in a DGN file view. Opens when File > Raster Manager is chosen from the main menu and when the Raster Manager tool is selected in the Raster Control tool box. The Raster Manager dialog box, which is resizable, is divided into two sections plus a menu bar.

Contained in the upper section of the dialog box is the image list box.

Display of the lower section may be toggled by clicking the arrow between the sections. The lower section of the dialog box contains file attachment information for the selected file (in the list box). Where multiple files are selected, information is displayed for the first file in the list.

Raster Manager dialog box.

  

Raster Manager dialog box, displaying attachment details when a color image is selected..

  

Raster Manager dialog box, displaying attachment details when a binary image is selected..

  

Key-in: DIALOG RASTER

List box

Displays the File Name, Description and, Read-Only status and model of origin for all attached files. The Quick Info, Logical Name, On-the-Fly, Geo Priority, Display Gamma, Print Gamma, and Status fields can also be added to the menu bar by using the contextual (right-click) menu. When there is enough room, the name and path are shown.

You can change the display sequence by dragging a file to a different position in the list. The display sequence of the raster images follow these rules:

Resizing the dialog box changes the size of this list box, letting you display as many image filenames as you require. When the number of files in the list exceeds the number of lines displayed, a scroll bar lets you scroll through the list.

One or more files can be selected from the list. When more than one file is selected, the information provided by the text fields, in the lower part of the dialog box, applies to the first file of the list.

Double-clicking a filename opens the Attachment Settings dialog box.

Right-clicking a highlighted filename opens the Raster contextual menu, which lets you perform many of the tasks that are available in the Raster Manager dialog box's File, Edit, Display and Settings menus.

Key-in: IMGMANAGER IMAGE SELECT [viewnumber] [filename]

Key-in: IMGMANAGER IMAGE UNSELECT [viewnumber] [filename]

Quick Info

The Quick Info field displays an icon. When the cursor is placed over this field, a bubble appears with a short description of the raster. The following fields are displayed in the bubble: Full Path, Origin, Width, Height, Dimensions, Pixel Size, Scale Factor, Rotation and Affinity. This field is read-only.

Full Path

Displays the full file specification, including the directory where the reference was found.

Origin

Displays the X, Y and Z coordinates of the lower left corner of the image, in working units.

Width/Height

Displays the Width and Height of the image in working units.

Dimensions

Displays the dimensions of the raster image, in pixels, plus the color depth.

Pixel Size or Scale Factor

When set to Pixel Size, displays the size of each pixel of the image, in working units.

When set to Scale Factor, displays the scale as 1:n and the resolution in dpi.

Color Mode

Change the color depth of the image.

Rotation

Sets the rotation angle of the image.

Affinity

Sets the skew angle of the image.

Model

The Model field is used to display the origin (design name and model name) of the raster reference.

Status

The Status field displays the reference's status (Loaded, Referenced, Self-Referenced or Raster Not Found). When a file is not found, its name is displayed in red, with the message “Raster not found” appearing in the Status field.

Read-Only

If on, the file is opened in a read-only mode and a check mark will appear in the Read-Only column.

On-the-Fly Transformation

The new On-the-Fly Transformation field indicates that the raster file can be transformed or re-projected on-the-fly. When this toggle is ON, a check mark will appear in the On-the-Fly column. Once this toggle is set to ON, MicroStation GeoGraphics is required in order to transform or re-project a raster image.

A special editing operation only available in Bentley Descartes 2004 Edition or later is required to toggle this feature ON/OFF.

Geo Priority

The Geo Priority field displays the method used to geographically position the image. The available choices are Attachment, Raster Header, Sister File and From Preferences. The image may have native geographic metadata stored in the image itself (raster header) or in a companion file (sister file or world file). When no native methods are present, the image is geographically positioned by the user and the metadata is stored in the design file. This method is called “attachment”.

The geographic metadata is always preserved and updated in the Attachment. When specified otherwise, the alternate location is updated as well as the attachment. Hence, the attachment is constantly updated to reflect the current geographic information of the image.

In cases where the image has native geographic metadata, once attached to a design file, it is sometimes useful to specify which metadata storage to use such as Raster Header, Attachment or Sister File. The Raster Manager preferences allow some flexibility to that effect. The Geo Priority column displays the method used to position the image and, upon reopening the design file, will display in RED if the previous method cannot be used. For example, you may want to attach an image using a sister file, but once attached you want the geographic metadata to be read from the attachment. You would then set the preferences to prioritize native geographic metadata and would change the Geo Priority to attachment.

The Geo Priority is also very useful to warn about potential data loss. For example, if the preferences are set to always read the geographic metadata from a sister file but the sister file is not present, Raster Manager will use the Attachment information and will highlight the column in red showing an error has occurred. The status column will also display the alternate method used to geographically position the image, in this case “attachment”.

The Geo Priority feature allows each image to have it's own Geo Priority. In versions before 2004 Edition, the same Geo Priority was forced to all images. When an older file version is opened in MicroStation and where no Geo Priority was previously set, the Geo Priority will be set to From Preferences. This indicates that the Raster Manager preferences will dictate how Georeference for this image is handled. If the Raster Manager Preferences are set identically to the previous MicroStation version, the image will display and position identically. If the Preferences are set differently, it is possible that the image displays and positions differently. If this is the case, adjust the Geo Priority before saving and closing the design file and change the Raster Manager Preferences accordingly.

To change the Geo Priority, simply click in the Geo Priority column. This will open the Geo Priority dialog box. You can then change the selection.

Display Gamma

Sets the display gamma correction value. The base value is 1.0. A value lower than 1.0 creates a darker image, a value higher than 1.0 creates a lighter image.

Print Gamma

Sets the gamma correction value for the printer.

View

Numbered push buttons let you define in which view(s) to display the raster reference(s).

Tint Color or Foreground Color

For colored images, the Tint Color setting is used to add a tint to the colors in the raster image.

For monochrome images, the Foreground Color setting controls the color of foreground items.

Key-in: RASTER FOREGROUND COLOR

Key-in: RASTER TINT COLOR

Key-in: RASTER TINT RGB

Transparent Color or Background Color

For colored images, the Transparent Color setting is used to set a transparent color for the raster reference. The selected color in the raster image then becomes transparent, when the Transparent setting is enabled.

For monochrome images, the Background Color setting is used to set the background color of the raster file.

In both instances, the chosen color also is used as a fill color when clipping raster images.

Key-in: RASTER BACKGROUND COLOR

Key-in: RASTER TRANSPARENT COLOR

Key-in: RASTER TRANSPARENT RGB

Print

If ON, permits the raster image to be printed.

Transparent

If ON, the selected Transparent Color (for color images), or Background Color (for monochrome images), becomes transparent, allowing DGN elements or other images to show through the image.

Clipping

For raster references that have been clipped only. If ON, the raster reference is displayed with clipping enabled. If OFF, then the clipping polygon is ignored and the image is displayed in full.

Invert

If ON, the colors for the raster image are inverted. This is similar to making a negative of a photograph.

File > Attach

Performs the same function as the Attach tool in the Raster Control tool box. Opens the Attach Raster Reference dialog box, which lets you attach raster image files to the open DGN file.

Key-in: RASTER ATTACH FIXED

Key-in: RASTER ATTACH INTERACTIVE

Key-in: IMGMANAGER FILE OPEN

Key-in: RASTER ATTACHURL

File > Detach

Detaches the selected raster reference(s).

Key-in: RASTER DETACH

Key-in: IMGMANAGER FILE CLOSE

File > Detach All

Detaches all raster image files.

Key-in: RASTER DETACHALL

Key-in: IMGMANAGER FILE CLOSEALL

File > Reload

Refreshes the selected raster file(s), using the current data of the file(s).

Key-in: RASTER RELOAD

File > Save As...

Opens the Save Raster As dialog box, which lets you save the currently selected image in another format. This item is disabled if more than one raster image file is selected.

Key-in: IMGMANAGER FILE SAVEAS

Key-in: RASTER SAVEALL

Key-in: RASTER SAVESELECTED

File > Project > Import

Opens the Import Project dialog box, which lets you import a raster project to the DGN file.

File > Batch Convert

Opens the Raster Convert dialog box, which lets you convert one or more raster files to a new format. This same dialog box can be opened also by selecting Utilities > Image > Convert from MicroStation's main menu.

Key-in: IMGMANAGER FILE BATCHCONVER <[filename]>

Edit > Modify

Performs the same function as the Modify tool in the Raster Control tool box. Opens the Modify Image dialog box, which lets you modify the Origin, Pixel Size or Scale Factor, Rotation and Affinity settings for the selected raster reference.

Key-in: RASTER TOOLMODIFY

Edit > Move

Performs the same functions as the raster Move tool in the Raster Control tool box. Lets you move an image to a new location.

Key-in: RASTER MOVE [LOWERLEFT | LOWERRIGHT | UPPERLEFT | UPPERRIGHT | CENTER]

Edit > Scale

Performs the same functions as the raster Scale tool in the Raster Control tool box. Lets you change the proportionate dimensions of an image.

Key-in: RASTER sCALE [ACTIVE | 3POINTS | PROPORTIONAL | PROPORTIONAL ON | PROPORTIONAL OFF | PROPORTIONAL TOGGLE]

Edit > Rotate

Performs the same functions as the raster Rotate tool in the Raster Control tool box. Lets you rotate an image.

Key-in: RASTER ROTATE

Key-in: RASTER ROTATE [ACTIVE | 2POINTS | 3POINTS]

Edit > Mirror

Performs the same functions as the raster Mirror tool in the Raster Control tool box. Lets you mirror the selected raster image file horizontally, vertically, or diagonally. Additionally, you can specify the location of the axis about which the image is mirrored.

Key-in: RASTER MIRROR HORIZONTAL

Key-in: RASTER MIRROR VERTICAL

Edit > Warp

Performs the same functions as the raster Warp tool in the Raster Control tool box. Lets you adjust the size and shape of a raster image with a combination of move, scale, rotate, and skew options.

Key-in: RASTER WARP AFFINE

Key-in: RASTER WARP HELMERT

Edit > Clip

Performs the same functions as the raster Clip tool in the Raster Control tool box. Lets you crop a raster image, or define a masked area.

Key-in: RASTER CLIP BOUNDARY

Key-in: RASTER CLIP MASK

Edit > Unclip

Performs the same functions as the raster Unclip tool in the Raster Control tool box. Lets you remove one or more clipping polygons from a raster image.

Edit > Modify Clip

Performs the same functions as the Modify Clip tool in the Raster Control tool box. Lets you modify a clipping polygon graphically.

Display > References

Opens the References dialog box.

Display > Bring to Front

Performs the same function as the Bring to Front tool, in the Raster Display tool box, with Action set to To Front. Brings the selected image(s) to the front of the display stack.

Key-in: IMGMANAGER DISPLAY FRONT <ViewName>

Display > Send to Back

Performs the same function as the Send to Back tool, in the Raster Display tool box, with Action set to To Back. Sends the selected image(s) to the back of the display stack.

Key-in: IMGMANAGER DISPLAY BACK

Display > Bring Forward

Performs the same function as the Bring to Front tool, in the Raster Display tool box, with Action set to One Step. Brings the selected image one step forward (up) in the display stack.

Display > Send Backward

Performs the same function as the Send to Back tool, in the Raster Display tool box, with Action set to One Step. Sends the selected image one step backward (down) in the display stack.

Display > Fit Rasters to View

Performs the same function as the Fit to View tool, in the Raster Display tool box, with Mode set to Selected Rasters. Fits the selected images to a view, which is defined with a data point.

Key-in: IMGMANAGER DISPLAY FIT

Key-in: RASTER FIT

Display > Fit All Rasters to View

Performs the same function as the Fit to View tool, in the Raster Display tool box, with Mode set to All Rasters. Fits all images to a view, which is defined with a data point.

Key-in: IMGMANAGER DISPLAY FITALL

Key-in: RASTER FITALL

Display > Actual Resolution (1:1)

Displays the selected image at its resolution scale (1:1). A data point defines the center point of the view. (When only one image is opened, it is selected).

Performs a similar function as the Actual Resolution (1:1) tool, in the Raster Display tool box, which lets you select interactively the raster image to fit.

Key-in: IMGMANAGER DISPLAY 1FOR1

Settings > Attachment

Opens the Attachment Settings dialog box, which lets you view the attachment settings and, where necessary, make amendments to a number of the settings.

Key-in: IMGMANAGER DLGGENERAL OPEN

Key-in: DIALOG RASTER EDIT

Settings > Update Sequence

Opens the Update Sequence dialog box, which lets you change the display order whenever a view update is involved.

Settings > Image Servers

Opens the Image Server Settings dialog box, which lets you create new, or modify existing server configuration files.

Key-in: IMGMANAGER DLGSERVERSETTING OPEN