Image Manager and Raster Reference have been combined to create the Raster Manager utility.
Raster Manager is the main raster engine that allows the display of raster reference files in MicroStation. Raster Manager provides users with a variety of image manipulation tools, such as warping, image navigation, interactive placement modification, and non-destructive raster clipping tools.
Raster Manager is now the standard default raster engine used in Descartes.
Two types of PRJ files can be imported in Raster Manager. The files are categorized by the applications that generated them. They are:
Image Manager and Raster Manager for MicroStation/J: These applications generated PRJ files versions 2.4 and 7.1, containing standard Raster Manager image settings.
Descartes and ReproGraphics for MicroStation/J: These special projects hold multiple color transparency attributes specific to Descartes and ReproGraphics.
In MicroStation V8, Raster Manager will not save raster information in project files or create new PRJ files. Instead, all information is stored within the MicroStation Raster Reference (Type 90 element), which is the new standard for raster attachments in MicroStation V8 design files.
Here are the existing scenarios when importing PRJ files:
With project files already attached to the V7 DGN, Raster Manager will automatically load version 2.4 and 7.1 project files. Descartes and ReproGraphics project files will not be loaded and because the DGN is being imported in MicroStation V8, they will be detached from the V7 DGN.
Project files can also be loaded manually with the File > Raster Manager > Project > Import menu. This operation will load all types of PRJ files, no matter which application they originate from. The project attachments (Type 66 elements) will automatically be converted into raster reference attachments (Type 90 elements), therefore the PRJ file will be detached from the DGN.
For PRJ files created with Image Manager and Raster Manager for MicroStation/J, you can create the RASTERMGR_PROJECT_READ_ALL configuration variable in the Workspace > Configuration menu. If it is set to 0, only Image Manager and Raster Manager projects (versions 2.4 and 7.1 ) are loaded automatically.
For projects generated with Descartes and ReproGraphics, create the RASTMNGR_PROJECT_READ_ALL configuration variable and set its value to "1". When set to "1", this variable causes all existing (attached) project files to be read and converted automatically.
Both variables can be used for the exact same task, but the variable's name is slightly different depending on the application that generated the PRJ files.
Note: All of these operations will cause the PRJ file to be detached from the design file, meaning that a MicroStation V8 DGN exported to MicroStation/J format will not recreate the attachment. The PRJ file must be sent with the MicroStation/J DGN file if it is to be reopened under a MicroStation/J environment. To preserve raster project attachments within your design file, open the DGN in read-only mode in MicroStation V8. Once back in MicroStation/J, you will be able to reattach the project or import raster reference attachments in Image Manager or Raster Manager 7.11.
Raster Manager for MicroStation V8 now supports more raster formats than in previous versions. When exporting MicroStation V8 DGNs to other file formats, keep in mind that some raster formats might not be supported.
Here is a list of unsupported raster formats by application:
Image Manager: iTIFF, BIL, GIF, ECW, MrSID, 11-bit TIFs, Intergraph c30, Intergraph c31.
Raster Reference: Same list as Image Manager plus HMR.
MicroStation/J's Descartes and ReproGraphics: Same list as Image Manager.
Raster Manager versions 7.11 and 7.14: BIL, GIF, ECW, MrSID, 11-bit TIFs, Intergraph c30 and Intergraph c31.
AutoCAD 2000i: Intergraph formats, BIL, HMR, iTIFF, GeoTIFF, IMG 24-bit (.A), IMG (.P), Sun Raster, 11-bit TIFs, ECW, MrSID.
Yes. Multiple color transparencies will be retained when the project is opened in Raster Manager. However, when you re-open this image with more than one color set to either translucent or transparent, you will no longer have the ability to remove or add color transparencies.
No limit is inferred by the Raster Manager software itself. Realistically, however, as with any software program, hardware memory and computing power will, at some point, limit the feasibility of opening additional images.
Raster Manager documentation is now delivered in the MicroStation CHM file that is located in the ..\Bentley\Documentation directory. You can also access this information in the MicroStation Help under the "Raster Manager Guide" topic.
Raster Manager supports BIL, GIF, MrSid, RLC, Intergraph C30 and Intergraph C31 files for viewing and conversion to other supported file formats. These files cannot be used as Save As or Batch Convert output formats by Raster Manager.
In older design files created with different MicroStation/J applications (for example I/RASB, and some Geotiff and Intergraph TIFF attachments created with Raster Manager version 07.11.36.38 or earlier), the Raster Attachment found in the design file may give a different georeference than the one found in the Raster file's header. If the file header georeference has to take precedence over the design file's Raster Attachment georeference, it is suggested to use the Workspace > Preferences dialog box and enable the "File Georeference Has Priority When Raster Is Loaded" checkbox in the Raster Manager Category. When the design file is closed, then reopened, this will allow the images to place themselves according to the raster file header's georeference and to overwrite the georeference found in the design file's Raster Attachments. Previously, it was necessary to detach and reattach the images to overcome this problem.
Yes. Two key-ins allow you to save location info files (HGR or World files) or plain georeference information directly from your raster attachments to World files or georeferenced file headers, without having to modify the raster locations.
Note: The rasters have to comply with these two conditions in order for the operation to work:
Files must be in read-write mode (make sure they are not opened in read only mode in Raster Manager).
The file format must be one of the output formats that are supported by Raster Manager.
The key-ins are:
RASTER SAVEALL: Saves all images listed in the Raster Manager dialog box and generates a World file for each of them.
RASTER SAVESELECTED: Saves the selected images in the Raster Manager dialog box and generates a World file for that particular raster.
To ensure that your World file has the TFW extension, use the following key-in:
RASTER DEFAULTSISTERTYPE WORLD
The main reason for this problem is that most of the time, these files are in fact GeoTIFF files. World files provide georeference information for applications that do not support the GeoTIFF format. In order for Raster Manager to read the values contained in the World file, simply turn OFF "File Georeference Has Priority when Raster Is Loaded" in the Raster Manager Category of the Workspace > Preferences dialog box and enable the "Use Sister File, if Present, for Georeferenced Files" check box to make the World file location values override the geotiff header's location information.
Yes. MicroStation handles raster reference paths in a way similar to DGN reference paths. A directory path is assigned to a configuration variable, and this variable may contain as many directories as necessary. Here are the most common ways to use this feature:
If on, the attached raster image paths are automatically appended to the MS_RFDIR configuration variable. The raster attachments will be searched for in the directories named by the configuration variable.
If off, the paths will not be appended to the configuration variable and the images will be searched for only in the paths that are already listed in the MS_RFDIR configuration variable.
To learn how to format configuration variable entries in workspace files, please refer to the MicroStation Help topics titled "Modifying the Project Configuration File" and "Configuration Variable File Syntax".
If your computer is linked to a network, you can either map network drives to the remote system directory or you can use the Universal Naming Convention (UNC) in your search paths.
To use configuration variables, in the Attach Raster Reference dialog box (Raster Manager dialog box: File > Attach), select the Directory menu and click the "Select Configuration Variable" item, then choose the configuration variable created to contain your raster search paths. The first search path listed in the configuration variable will become the default path to attach your images, and raster attachments will be searched for in all directories listed under the configuration variable.
This occurs when the working units are not properly defined. Raster Manager for MicroStation/J reads the Sub Unit label and matches that label with the one from the units.ini file. As an example, you cannot have kilometers as the Master Unit and inches as the Sub Unit. This problem also occurs if "SU" is used as the Sub Unit label, and the Master Unit label is anything other than "MU". For the HMR and TIF formats, "SU" is equal to 1 meter. If the Master Unit label defines a unit that is smaller than the one defined by the Sub Unit label (MU is smaller than SU), then MicroStation/J opens the image at a different location. There are two workarounds to fix this:
For example, in MicroStation, if one SU is to be equal to 1/10th of a foot, you need to convert this value into meters. Hence, you would use the following formula:
0.3048/10=0.0348, where 0.3048 is 1 foot expressed in meters.
Thus, the SU label in the units.ini file will be defined as: SU,0.03048.
Raster Manager's clipping is done entirely in memory (RAM).
The following parameter can be used to specify the background color of monochrome raster at printout:
To set the background color, edit the following variable in the .PLT driver used to generate the plot: BACKGROUND = 0 where 0=white, 1=black, 2=color.
NOTE: For the ripwin32_rgb.plt and the ripwin32_gray8.plt drivers, the variable has to be edited in the rip_std_options.inc driver. Refer to the MicroStation Help "Printing Guide > Printing Using Raster Manager" topic for more information.
Updated georeference data is stored in the DGN type 90 reference. When the image is detached or the design file closed, the georeference information is automatically written in the image header, or in a sister file. To avoid modification of either file, open your images as read-only. To do so, when attaching the raster simply turn on the "Open Raster Files Read-Only" toggle in the Attach Raster Reference File dialog box. By doing so, only the type 90 reference will be updated.
The file is automatically saved when the design file is closed and/or when the raster file is detached. The file can also be manually saved using all the available options with the Raster Manager File > Save As menu.
The foreground color is identified by the color index "1" and the background is color index "0". Transparency is set to the background color by default. The weight of each color is irrelevant.
No. Contrast and brightness settings are stored in the Raster Reference attachment (type 90).
Possible values are one single color or all colors.
Use the "Escape" key to halt Raster Preview and still be able to open image files.
If this problem occurs, simply modify the background or foreground color and the image will appear. To modify the color settings, click the "Show Image Settings" arrow at the bottom of the main Raster Manager dialog box, or choose File > Settings > Attachment > Color from the Raster Manager menu.
Clipping of vector and raster are independent from each other. To clip raster, choose File > Clip from the Raster Manager menu.
This can result from a memory problem: it occurs when there is not enough free space on disk to create the cached files on the drive where the default TEMP file is located. To resolve the issue, delete useless files in order to make room on the drive where the cached files are located. The cached files are found under your computer's temporary directory.
Add the HMRTempDirectory variable to your System Environment variables and set it to a drive/directory combination of your choice.
Starting with MicroStation version 08.05.01.25 and higher, Raster Manager supports LZW compression in TIFF and GIF raster formats.
It is possible to view or set the GeoTIFF and World file unit under the MicroStation menu Workspace > Preferences > Raster Manager.
Yes, when a GeoTiff has an unknown unit, you can set the default values in Raster Manager Category of the Workspace > Preferences dialog box under the "GeoTiff Default Unit Label" field.
Yes, you can set your own units in the Raster Manager Category of the Workspace > Preferences dialog box under the "WorldFile Default Unit Label" field. The default unit is set to Meters.
When converting file formats which refer to a DGN file for georeference information, because "rastconv.ma" operates offline, the utility cannot access the referenced DGN file and the proper creation of Intergraph format output files is impossible. Use Raster Manager's Batch Conversion tool for these formats.
See the chart below:
11-bit TIFF files can be opened in Read-Write mode but cannot be created. Once a 11-bit TIFF file is opened in Raster Manager, if any modifications are made to it, the changes have to be saved in another file format such as TIFF 24 Bits or CAL monochrome files.
Q: I have added transparency to my rasters, but when I send them to print, either the transparency does not apply or the images do not display. Why is this?
A: Only the ripwin32_rgb.plt and the ripwin32_gray8.plt support raster transparency when printing. Refer to the MicroStation Help "Printing Using Raster Manager" topic for more information on the use of different print drivers with Raster Manager.
Yes. In MDL programming one can send a keyin by specifying the application's TASKID. If the TASKID used to launch the keyin was "REF", it must now be replaced by "RASTMGR" in MicroStation V8.5. The most convenient way to set this parameter is to use the RASTMGR_TASKID define entry found in the ...Bentley\Program\MicroStation\mdl\include\rmdlgids.h file.
In MicroStation 2004 Edition, there is a special setting specifically designed to enhance opening speed when attaching an image via a network drive. To enable this feature, you must create the following configuration variable: MS_RASTER_LOADMODE
Set this variable to "3" in order to speed up the attach/display operation for any image accessed through a network drive. A cache file will be created on the local drive in the folder pointed to by the Windows Environment variable TMP or TEMP. You may control the location of these cached files by specifying a System Environment variable HMRTempDirectory and setting it to the desired folder on your local drive.
If images are opened from a local drive, the default value will optimize speed for local raster files (loadmode is not set in the configuration).
Product TechNotes and FAQs
Raster Product TechNotes And FAQs
Bentley Technical Support KnowledgeBase
Bentley LEARN Server
Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!