You are on page 1of 194

InterPlot for MicroStation

July 2001

Copyright © 2001 Bentley Systems, Inc. All Rights Reserved Including software, file formats, and audiovisual displays; may be used pursuant to applicable software license agreement; contains confidential and proprietary information of Bentley Systems and/or third parties which is protected by copyright and trade secret law and may not be provided or otherwise made available without proper authorization. Although this copyright protects the content of this Help file as the Intellectual Property of Bentley Systems, Bentley Systems grants you, the user, permission to print any topic in this Help file for your personal use while operating the software.
Restricted Rights Legend

Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c) (1) and (2) of Commercial Computer Software---Restricted Rights at 48 CFR 52.227-19, as applicable. Unpublished---rights reserved under the copyright laws of the United States. Bentley Systems, Inc.
Warranties and Liabilities

All warranties given by Bentley Systems about software are set forth in your purchase contract, and nothing stated in, or implied by, this document or its contents shall be considered or deemed a modification or amendment of such warranties. Bentley Systems believes the information in this publication is accurate as of its publication date. The information and the software discussed in this document are subject to change without notice and is subject to applicable technical product descriptions. Bentley Systems is not responsible for any error that may appear in this document. The software discussed in this document is furnished under a license and may be used or copied only in accordance with the terms of this license.
Trademarks

Bentley Systems, the "B" Bentley logo, MicroStation, and InterPlot are registered trademarks of Bentley Systems, Incorporated. Digital Print Room is a trademark of Bentley Systems, Incorporated. Microsoft, Windows, Windows NT, and Windows 2000 are registered trademarks of Microsoft Corporation. AutoCAD is a registered trademark of Autodesk. Paint Shop Pro is a trademark of Jasc Software, Inc. Other brands and product names are trademarks of their respective owners.

II

T

A

B

L

E

O

F

C

O

N

T

E

N

T

S

Contents
Introduction to InterPlot .................................................................................... 1-1 The Plotting Interfaces ...................................................................................... 2-1 Using Settings Files........................................................................................... 3-1 Plot Resymbolization......................................................................................... 4-1 Managing Resource Files.................................................................................. 5-1 InterPlot Client Configuration........................................................................... 6-1 InterPlot Server and the Server Utilities .......................................................... 7-1 InterPlot Drivers ................................................................................................. 8-1 Using InterPlot with other Windows Applications.......................................... 9-1

iv .

C H A P T E R 1 Introduction to InterPlot .

InterPlot for MicroStation .

a Windows application that can plot entire drawing sets in a single step. These plots and plot sets can consist of MicroStation® design files. and command line interfaces for unattended batch plotting. use InterPlot Server on the plot server. Workflow A typical InterPlot configuration consists of one or more plot servers and a (typically) larger number of workstations running InterPlot client products. you can submit plot jobs to the plot server for printing and/or digital archiving. and many types of raster data. 1-1 . It is designed to submit plots and plot sets to a plot server for printing and/or archiving. InterPlot Client also provides dialog boxes that run inside MicroStation or AutoCAD. InterPlot Client includes Organizer. Note For plot production.What is InterPlot Client? InterPlot Client is the client component of a network production plotting system (InterPlot). use a Digital Print Room product on the plot server. For plot production and/or digital archiving. Digital Archive data. AutoCAD® drawing files. Using InterPlot Client.

otherwise. InterPlot Professional automatically selects the most logical means to produce hard copy plots. AutoCAD drawing files. If either product is available.What is InterPlot Professional? InterPlot Professional is a stand-alone production plotting system designed to plot MicroStation design files. InterPlot Professional is not a server product and cannot accept plot jobs submitted by other computers. Workflow The following InterPlot configuration illustrates how InterPlot Professional can be used as a client in a networked environment. InterPlot Professional processes the plot itself. the software determines whether or not InterPlot Server or a Digital Print Room product is available to drive the chosen plotter. raster files. InterPlot Professional submits the plot to the plot server for processing. offloading plot processing to InterPlot Server or to a Digital Print Room product for printing and/or archiving. use a Digital Print Room product on the plot server. Note For plot production. However. When you submit a plot or plot set. use InterPlot Server on the plot server. 1-2 . For plot production and/or digital archiving. InterPlot Professional can act as a client in a networked environment to submit plots and plot sets to a plot server for printing and/or archiving. The configuration also illustrates how InterPlot Professional can be used as a stand-alone product. In addition. and Digital Archive data.

The Plotting Interfaces
This product is designed to plot AutoCAD drawing files, MicroStation design files, many types of raster files, and DPR files. The following plotting interfaces are available: InterPlot Organizer The APLOT Dialog Box (for plotting inside AutoCAD) The APLOT Command Line The IPLOT Dialog Box (for plotting inside MicroStation) The IPLOT Command Line Using these interfaces, you can plot both inside and outside of AutoCAD and MicroStation. The dialog interface allows you to plot from within the CAD environment, while the command line and Organizer interfaces operate outside the CAD environment. All five interfaces allow plot resymbolization; the ability to change the appearance of a plot. To make your workflow more efficient, InterPlot Organizer provides you with the ability to create plot sets. Plot sets allow you to replot a set of drawings exactly like they were plotted the first time.

1-3

Upgrading to InterPlot Client/Professional
There are two ways to upgrade to InterPlot Client/Professional 10.0. You can remove the previous version first and then install the new software, or you can leave the previous installation and overwrite it with the new software. Each method affects your current configuration differently. If you removed a previous version first — The software was installed as if it were being installed for the first time, setting all customizable variables to standard defaults. You must now copy your previously saved configuration files, settings files, and resource files, to the proper directories. If you overwrote a previous version — The new software was installed in the same location as the previous software with the following differences for the IPLOT component: Configuration files — The IPLOTSRV.CFG configuration file is now delivered to C:\Program Files\Common Files\InterPlot\iplot\config. IPLOT no longer reads files stored in the \config\project or \config\system directories. Resource files — Default IPLOT resource files (patterns and line styles) are delivered to \resrc\system. IPLOT no longer reads files stored in the \resrc\project directory. Move your customized IPLOT resource files to the new \resrc\custom directory. InterPlot now uses MicroStation font and line style resources. For more information see Using MicroStation Resource Files. Note If you are using Windows NT, you must have administrator privileges to upgrade this product.

1-4

Registering the Product
You can use the InterPlot Client Configure utility to properly register your software. InterPlot products that are not registered properly will produce plots containing watermarks. To register the software 1 Select Start->Programs->InterPlot Utilities->InterPlot Client Configure. 2 In the InterPlot Client Configure dialog box, click Register. 3 In the InterPlot Client Configure - Register dialog box, click Register Online. Note The computer name and computer code is displayed on this dialog. You will need this information to properly register your software. 4 From the Bentley Product Registration Page, click Commercial Product Registration. 5 To register a Bentley product, please fill out this form and click the REGISTRATION button when you have answered all the questions. 6 You will receive an email from Bentley Systems containing the license file. Save this file into the c:\Program Files\Common Files\InterPlot\Licensing folder to complete the registration process. Note The Register dialog box contains a link that displays the filename for the license file.

1-5

General Features The following is a general summary of new features: New Product Licensing — Setup no longer requires you to enter a registration number during product installation. and perform a window area. These files can be plotted or archived using Organizer. The Feature Table editor provides a Windows GUI for writing Feature Tables. zoom in. For more information. you can pan. ProjectWise Integration — InterPlot Organizer can now access files managed in a ProjectWise Datasource. Indexing/Accounting — The InterPlot pen table language has been enhanced to enable automatic extraction of data from MicroStation and AutoCAD files. Support for Windows Applications — InterPlot now provides a way for you to plot or archive data from various Windows applications. Improved printer validation — All InterPlot client interfaces should come up faster on a slow network. This means that InterPlot products will place a watermark on all plots until a license file is obtained from Bentley Systems. see the "How To" section of the InterPlot Reference Help. 1-6 . This data is written to the accounting file and can also be used as Digital Print Room attribute data (indexing). The InterPlot Client/Professional products include a new InterPlot Organizer Printer Driver for generating files from within Windows applications. Feature Table Editors — New IPLOT and APLOT Feature Table Editors for plot resymbolization. Plot Preview — Right-click inside the preview window to display the context menu. Small-format documents saved in Adobe Acrobat’s Portable Document Format (PDF) can be associated with plot sets. Organizer Reverse Command — New Reverse command in Organizer enables you to reverse the print order. zoom out. From the context menu.

IPLOT Features New IPLOT features include the following: Support for Descartes. zoom out." More flexible Scale field in the IPLOT Dialog — If you want to enter a scale of 200:1. Enhanced integration with ProjectWise document management system via the InterPlot Organizer interface. zoom in. you can select one or more MicroStation products to integrate with the IPLOT dialog interface. Raster Manager. 1-7 . Improved Align X and Align Y behavior. From the context menu. The InterPlot Client Configure utility enables you to select which MicroStation product to use as the IPLOT print/preview engine. Plot Preview — right-click inside the preview window to display the context menu. New Pen Table keywords: text_node_number — returns the text node number of a text node element. Also. If some plots in a plot set come out rotated 180 degrees from the others. The Feature Table editor provides a Windows GUI for writing Feature Tables. New IPLOT Feature Table Editor for plot resymbolization. double-click the Plotting MicroStation Data book. set the value of the IPLOT configuration variable IPLOT_ALIGN_METHOD to "coincident. ip_scale_num — returns the plot scale in numeric form. ip_ysize_num — returns the plot ysize in numeric form. ip_xsize_num — returns the plot xsize in numeric form. Improved workspace validation on the plot server. you can now type in 200. The new IPLOT configuration variable IPLOTSRV_WORKSPACE_VALIDATION enables InterPlot Server a more flexible approach for locating MicroStation user workspace configuration files. For more information about Feature Tables. and Image Manager. Better Integration with your CAD products. and perform a window area. you can pan.

ap_ysize_num — returns the plot ysize in numeric form. New APLOT Dialog Retain Mode to retain the settings between sessions. From the context menu. Extensive support for AutoCAD 2000. JPEG. and 270 degrees). For more information about the Dialog Retain mode. you can pan. zoom in. see Using the APLOT Dialog section. For more information about AutoCAD 2000 features. and other client resource files.APLOT Features APLOT features include the following: Support for AutoCAD R14 and later raster attachments. 90. Raster support is limited to the following file formats: BMP. linetype libraries. Plotting of raster attachments is supported for orthogonal plot rotations (0. and perform a window area. 1-8 . ap_scale_num — returns the plot scale in numeric form. double-click the Plotting AutoCAD Data book. zoom out. APLOT patterns can also be 1-bit raster images. CALS. 180. PCX. TIFF. Support for Project Search Paths to locate xrefs. New APARM version/Maximum Filename Length Long Object Names Non-Plotting Layers Non-Rectangular Viewports Multiple Paper Space Layouts Layout Plot Settings Plot Style Resymbolization Lineweights ACIS Solids New Entity Types Hyperlinks Plot Preview — Right-click inside the preview window to display the context menu. Now you can use the same raster patterns for both APLOT and IPLOT. ap_xsize_num — returns the plot xsize in numeric form. and TGA. see the Project-Based Resource Management section. For more information about Project Search Paths. New APLOT Pen Table Keywords to return the plot size/scale in numeric form.

com for TechNotes. fax.bentley. Searching the Online Help delivered with the product (note that some custom installation options will not include the online help). The main SELECT Support number is 800-778-4277. technical newsletters. and FAQs. and much more.com Bentley SELECT (SM) A flyer on Bentley SELECT is included with MicroStation./Canada/Latin America Europe/Middle East/Africa Asia/Pacific support@bentley.S. 1-9 . Checking regularly with the Bentley Web site at selectservices. More information on Bentley SELECT can be found at http://selectservices.com. upgrades and updates. and promotions. With Bentley SELECT.com support@bentley. utilities. you get e-mail. point your web browser to: http://www.bentley. Internet. bulletins.nl bsap. enhancements. The electronic mail addresses for Bentley’s Technical Support are as follows: U.support@bentley. Referencing the Frequently Asked Questions (or FAQ) document on the Bentley Web site at www.com Bentley’s World Wide Web Site Bentley’s World Wide Web Site is a central repository of information relating to Bentley products.Bentley. services. and telephone access to premiere support.Bentley.com/.Product Support There are a variety of ways to get the latest technical information on Bentley products. To access Bentley’s World Wide Web Site. These include: Contacting your technical support provider. training.

For InterPlot product information.interplot. convenient. up-to-the-minute information about Bentley Systems products and services. 1-10 . connect to www.Bentley.com.com. connect to www.InterPlot On-line For fast.

IPLOT allows you to increase your overall plotting throughput and provides the capabilities essential to producing high quality plots from a wide range of devices .0/9. 1-11 . Client/Server Configurations This release of InterPlot 10.0 clients can submit plot jobs to a plot server with InterPlot Server 10. The InterPlot 9.1/10.0 Clients and InterPlot 8. You can use the IPLOT dialog box in the MicroStation environment. InterPlot 8. or rendering attributes file. and rotation. Workspace name.0. You can specify these settings using the IPLOT dialog box. you should understand the basic IPLOT plotting process which involves three steps: 1 Creating the plot job 2 Generating the metafile 3 Submitting the plot. IPLOT is a production plotting solution for MicroStation users. MicroStation SE or MicroStation/J must be installed on either the client or plot server machine to support this configuration. or the IPLOT command line interface at the system prompt to complete these steps. Design file information.1/10. or the command line interface.1/10.0 Server IPlot Client 8.0 clients both support the plot preview feature. You then specify settings for the plot such as the area of the design file you want to plot and the size. IPARM Files The settings you specify for a MicroStation plot job are saved in an IPARM file. rotation.0 installed. InterPlot 9.0 or InterPlot Server 9. The following sections describe the possible configurations for upgrading to InterPlot Client 10. InterPlot 9.0/9. Each step in the plotting process depends on the IPARM file.1/10. you specify the design file you want to plot.0 clients can submit plot jobs to a plot server with InterPlot Server 10. The IPLOT Plotting Process Before you begin plotting MicroStation files with InterPlot.0 plot server is required to have MicroStation SE or MicroStation/J installed to process the incoming plot jobs. Organizer.0 installed. and orientation of the plotted image.) Name of the printer to which you are submitting the plot.0 Server InterPlot Client 9.i extension. When you create the plot job.0 and InterPlot Server 10.0 and InterPlot 9.0/9. InterPlot 8.0 Server InterPlot Client 9.0 software requires certain configurations for plot processing and plot preview of MicroStation data. size.1/10.0 installed. Creating the Plot Job The first step in the plotting process is creating the plot job.0 clients can submit plot jobs to a plot server with IPlot Server 8.0 clients are required to have MicroStation SE or MicroStation/J installed in order to support the plot preview feature. color table. By default. IPARM files contain the following information: Parameters used to create the plot job such as view.0 Clients and InterPlot 10. The InterPlot 10. InterPlot 9.1/10. Names of associated plot files such as a pen table.0 Clients and InterPlot 10. (The IPARM file extension is defined by the configuration variable IPLOT_IPARM_EXT in the IPLOT. (Each IPARM file is associated with a single design file and its associated reference files. IPARM files have a . .Introduction to Plotting MicroStation Data Note Throughout this section the term IPLOT refers to the IPLOT component of InterPlot.0 clients are required to have MicroStation SE or MicroStation/J installed to support the plot preview feature.CFG file). the Organizer interface outside of the MicroStation environment.

1-12 . The metafile also contains elements from the master design file. elements from any attached reference files and a copy of the IPARM file. IPLOT submits the plot job based on information stored in the IPARM file to the specified printer. the resulting metafile contains a compiled version of that pen table or feature table. Submitting the Plot The final step in producing a plot is to submit the metafile to the plot server. If a pen table or feature table is attached to the IPARM file.Generating the Metafile The second step in the plotting process is generating the metafile. The plot server receives the plot job and processes the metafile in association with the printer to produce the final plot.

C H A P T E R 2 The Plotting Interfaces .

InterPlot for MicroStation .

Additionally. Starting the IPLOT Dialog Box 1 Access MicroStation and load a design file. and perform a window area. and some element attributes. you can pan. Many commands display additional dialog boxes that allow you to specify settings to adjust the plot. When you type a filename. zoom out. zoom in. The IPLOT dialog box allows you to scale. For settings that require a filename. and rotate a plot. you can either type the filename or use a file selection dialog box. redefine and manipulate the plot area.Introduction to the IPLOT Dialog Box Note Throughout this section the term IPLOT refers to the IPLOT component of InterPlot. use settings files and configuration variables.) 2 Start IPLOT by selecting IPLOT from the MicroStation File menu. the IPLOT dialog box displays error and status information. The IPLOT dialog box allows you to perform the three steps necessary to plot a drawing. You can also control the display of levels. and specify qualifiers. The IPLOT dialog box is a graphical user interface that allows you to set up and submit plots of design files from the MicroStation environment. IPLOT searches specific directories determined by configuration variables. You control and operate IPLOT dialog boxes in the same manner as MicroStation dialog boxes. To customize the dialog box. classes of elements. and specify queuing options and plot submission options. Right-click inside the preview window to display the context menu. and to preview and plot a drawing. You can customize many aspects of this dialog box. a status area. 3 The IPLOT dialog box appears. You can also obtain a plot with different display characteristics. With the dialog box commands you can specify parameters and settings. size. From the context menu. and a menu bar that provides access to less frequently used commands. (See Introduction to Plotting MicroStation/IPLOT Data). to select a printer. The IPLOT Dialog Box The IPLOT dialog box contains several key-in fields. (Refer to your MicroStation documentation for information on loading a design file. you are not required to provide the full directory path. 2-1 . including default values (such as the printer name) and the product’s general behavior. a graphical representation of the plot area. You can customize IPLOT on a system-wide basis as well as for an individual user.

Note You can obtain detailed help on the IPLOT dialog interface by clicking Help > Help Topics on the IPLOT dialog box.If you do not remember the name of the file you want.. file selection dialog boxes are a useful tool. Browse buttons are labeled with an ellipsis (. IPLOT displays a browse button. These dialog boxes provide scroll boxes that list directories and filenames. You can use these scroll boxes to navigate through your directory structures to locate the file you want. 2-2 . Next to settings fields that require a filename. Click the browse button to display a file selection dialog box that allows you to search directories for a specific file..).

Introduction to InterPlot Organizer InterPlot Organizer is a Windows application for plotting MicroStation design files. you can create a plot set for a particular set of files to be replotted periodically (for example. Using InterPlot Organizer is often faster than plotting with the dialog box because you do not have to wait for MicroStation to load the design file or AutoCAD to load the drawing file before you plot. Or. Using Organizer. you can plot sets of MicroStation design files. AutoCAD drawing files. and preview and print all or some of the plots. Organizer gives you full control over plot sets and the plots they contain. and rearrange plots. delete. As the design progresses. At the beginning of a project. Organizer allows you to create and edit settings files and to edit configuration files. raster files. view and modify the properties of individual or multiple plots. You can also control how information about the plots in a set is displayed in the Organizer main window. AutoCAD drawing files. raster files. 2-3 . at various milestone dates for a project). InterPlot Organizer offers you several advantages: The Organizer interface allows you to work easily with large sets of plots. and Digital Print Room files. InterPlot Organizer allows you to work on a group of plots as a single plot set. you can easily produce new sets of drawings by using the Organizer dialog box and the original plot set file. You can add. you can create a plot set file that corresponds to project drawings. or Digital Print Room files without saving or reusing the plot sets.

click the Don’t display this screen again option before clicking OK. From the command prompt. follow the procedure below. For example. a Welcome dialog box appears. To Start Organizer from the Command Prompt: 1 Add the bin subdirectory of the product directory to the system path. The syntax is: iplotorg. do one of the following: From Windows NT Explorer. 2-4 . \Program Files\InterPlot Professional\bin or \Program Files\InterPlot Client\bin. Obtaining More Information on the Organizer Interface For additional information about Organizer. Click Cancel to exit the Welcome dialog box without performing any operation. The Welcome dialog box contains shortcuts for the two operations that load information into Organizer: creating new plot sets from files you select.exe <plot_set_filename> If you started Organizer without specifying a plot set. double-click the name of an existing plot set. 3 Click the appropriate option from the Welcome to InterPlot Organizer dialog box. 2 Type the executable filename and one command line argument (optional).Starting InterPlot Organizer To start Organizer. 4 Click OK to dismiss the Welcome dialog box and perform the selected operation. click the InterPlot Organizer command. and opening an existing plot set. From the Start -> Programs -> InterPlot Utilities folder. click Help Topics from within Organizer. Note If you prefer that this dialog box not be displayed the next time you run InterPlot Organizer.

preview. Represents the name of a plot set (. IntelliCAD. You must specify an extension (. Create Command Use the Create command to create a plot set file. You can place the qualifiers in any order on the command line. Modify. Print. These qualifiers are preceded by a dash. -attributes Organizer applies each attribute in the order it is listed. The following list describes each component of the command line: iplotorg command -qualifiers Activates Organizer. modify. Archives a plot set file without printing. Represents one or more qualifiers used to control the command. You can use the command line interface to create. Export.ips) file.ips) for the plot set filename. The exceptions to this rule are the -add_plot and -attributes qualifiers used with the Create command as follows: -add_plot Organizer reads and adds each plot to the plot set file. and archive plot sets. and to export plots from plot sets. Note Organizer reads the data sections of all settings files specified on the command line. To work around this limitation. Exports plots from a plot set file as PARM files. if you use a particular qualifier more than once on the same command line. Add the location of Organizer to the system path. plotset_file Qualifier Interaction In general. Represents one of the command line commands (Create. Syntax: iplotorg create <-qualifiers> plotset_file 2-5 . Prints a plot set. Plot sets can be composed of MicroStation. Displays plots on the screen before printing. If you specify a settings file with the –add_plot qualifier. but they must follow a command. An Organizer command line has the following syntax: iplotorg <command> <-qualifiers> plotset_file Note On Windows 98 you are limited in the number of characters per command line. you should: Use Organizer’s command file mechanism for specifying command line options.Using the Organizer Command Line InterPlot Client/Professional includes an Organizer command line interface which runs from the command prompt. Qualifier values can be filenames. Organizer will create the plot set in the current working directory unless you specify a directory in the plot set filename. the data specific qualifiers in this settings file will override those specified using the –settings qualifier. The Organizer command line provides the following commands: Create Modify Export Preview Print Archive Creates plot set files. raster. Modifies plot set files. arbitrary character strings. AutoCAD. Organizer processes the last occurrence and ignores the others. and digital print room data. Preview. Archive). or comma-separated lists of such items enclosed in square brackets. print.

-printer -rendering_attributes -settings Note If you do not specify the -add_plot qualifier on the Create command line.ips -archive_name Use the -archive_name qualifier to set the name of the archive in the plot set file.dgn –add_plot=*.ips -attributes Use the -attributes qualifier to set plot set attributes in the plot set file.You can use the following qualifiers with the Create command: -add_plot -archive_name -attributes -output -add_plot Use the -add_plot qualifier to add a plot to a plot set. and user-defined attributes.ips To use a wildcard (*) to create plots from all the DGN and JPG files in a directory: iplotorg create -add_plot=c:\temp\*.ips is arcone. the CAD filename (without extension) is used for the plot name. . Represents the name of the CAD file or PARM file to be added to the plot set. The name of the archive associated with house.interplot. ProjectID=ab1] house. the plot set file created will be empty.ips This command creates a plot set called house. settings_file] plot_name input_file settings_file Represents the name to be assigned to the plot. Syntax: -attributes=[name1=value1. PDF File. name2=value2. and the plot set attributes are www.dgn misc.com. Plot Set ID.] (Where name1 and name2 are user-defined attribute names.dgn -archive_name=arctwo misc. Revision.com (Related Web Page) and ab1 (Project ID).dgn -archive_name=arcone -attributes=[URL=http://www. Syntax: -add_plot=input_file -add_plot[plot_name]=[input_file. Examples: To create a plot set and add plots: iplotorg create -add_plot=house. .ips. Syntax: -archive_name=name Example: To specify the name of an archive: iplotorg create -add_plot=house.) Example: To assign plot set attributes: iplotorg create –add_plot=house. You can specify attributes such as Author. 2-6 . Represents the name of the settings file to be used when creating the plot. containing the plot house. Project ID. Related Web Page.dgn -add_plot=car. If no plot name is specified. The common section of the settings file will be ignored.interplot. Click here for a list of standard attribute names and keywords.jpg misc. . Account.

set to both plots.ips containing the plot house. the data specific sections in this settings file will override those specified using the -settings qualifier.set. Syntax: -settings=settings_file Examples: To specify a settings file: iplotorg create -add_plot=car.ips -settings Use the -settings qualifier to specify a settings file when creating plots. the printer is set to the most recently used InterPlot printer (or to the system ’s default printer if no recently used InterPlot printer is detected).set misc.set] -settings=two. To specify more than one settings file: iplotorg create -add_plot=[house.set) and applies only the data specific section from house.dgn -output=err.set. The common section and data specific sections are applied from two. This settings file applies the data specific sections and the common section to all plots. Syntax: -output=log_file (Where log_file is the name of the log file.-output Use the -output qualifier to redirect error/informational messages to a log file. house.dgn -add_plot=house. Organizer reads both settings files (house.) Example: To redirect error/informational messages to a log file: iplotorg create –add_plot=house.log house.ra mech. If you do not specify a destination printer. The data specific section in house.jpg -rendering_attributes=screen. This prevents you from having to dismiss a window each time you run the command line.dgn -printer=hp5si house.dgn.set.dgn -settings=common. If you specify an additional settings file with the -add_plot qualifier.ips containing the plots car and house and applies the settings in common.ips -rendering_attributes Use the -rendering_attributes qualifier to attach a rendering attributes file to the plot set file. Syntax: -rendering_attributes=rendering_attributes_file Example: To attach a rendering attributes file: iplotorg create –add_plot=lever.set will override those specified in two.ips This command creates a plot set called misc. Syntax: -printer=printer_name Example: To specify a printer: iplotorg create -add_plot=house.set and two.set misc.ips -printer Use the -printer qualifier to set the destination printer in the plot set file. 2-7 .ips This command creates a plot set called misc.

Modify Command Use the Modify command to modify a plot set file.ips -printer Use the -printer qualifier to change the destination printer in the plot set file. Revision. Syntax: -attributes=[name1=value1. . name2=value2. Project ID. .ips -attributes Use the -attributes qualifier to set plot set attributes in the plot set file. PDF File. Plot Set ID.) Example: To redirect error/informational messages to a log file: iplotorg modify -archive_name=arctwo –output=err. This prevents you from having to dismiss a window each time you run the command line. Syntax: -archive_name=name Example: To specify the name of an archive: iplotorg modify -archive_name=arctwo misc.ips) for the plot set filename. You must specify an extension (. Organizer appends any attributes you specify here to the plot set file.) Example: To assign plot set attributes: iplotorg modify -attributes=[URL=http://www. and user-defined attributes.log misc. Syntax: -printer -rendering_attributes -settings 2-8 . Related Web Page. Click here for a list of standard attribute names and keywords. . ProjectID=ab1] house.interplot.ips -output Use the -output qualifier to redirect error/informational messages to a log file. Syntax: iplotorg modify <-qualifiers> plotset_file You can use the following qualifiers with the Modify command: -archive_name -attributes -output -archive_name Use the -archive_name qualifier to set the name of the archive in the plot set file. Organizer will modify the plot set in the current working directory unless you specify a directory in the plot set filename. Syntax: -output=log_file (Where log_file is the name of the log file.com. You can specify attributes such as Author.] (Where name1 and name2 are user-defined attributes. Account.

set misc. Syntax: -settings=settings_file Example: To specify a settings file: iplotorg modify -settings=common.-printer=printer_name Example: To specify a new printer: iplotorg modify -printer=hp5si house.ips -rendering_attributes Use the -rendering_attributes qualifier to attach a rendering attributes file to the plot set file. the button to display the previous plot. In the Preview window. use the and the button to display the next plot.ips Export Command Use the Export command to export plots to the current working directory.ips Preview Command Use the Preview command to preview a plot set on the screen before you submit it to a printer. using the plot names for the PARM filenames. a Preview window appears containing the first plot in the plot set.ra mech. When plots are exported. You can use the following qualifiers with the Export command: -output Syntax: iplotorg export <-qualifiers> plotset_file -output Use the -output qualifier to redirect error/informational messages to a log file. button to close the Preview window after previewing the last plot.ips -settings Use the -settings qualifier to specify a settings file to be applied to all plots. This prevents you from having to dismiss a window each time you run the command line. Syntax: -output=log_file Example: To export the plots in a plot set: iplotorg export –output=err. Syntax: -rendering_attributes=rendering_attributes_file Example: To attach a rendering attributes file: iplotorg modify -rendering_attributes=screen.log house. they are written to the disk as PARM files. You can use the following qualifiers with the Preview command: -output 2-9 . When you run this command.

log house. This prevents you from having to dismiss a window each time you run the command line. Syntax: -copies=n Example: To specify a number of copies: iplotorg print -copies=2 house. Syntax: 2-10 . Syntax: -output=log_file Example: To preview the plots in a plot set: iplotorg preview –output=err.ips -delete_plotset Use the -delete_plotset qualifier to specify that the plot set file be deleted if printing is successful.ips -collate Use the -collate qualifier to request that the plot set be collated. Syntax: iplotorg print <-qualifiers> plotset_file You can use the following qualifiers with the Print command: -copies -collate -delete_plotset -output -copies Use the -copies qualifier to request multiple copies of a plot set. If you are only printing one copy of the plot set. This flag is not stored in the plot set file. Syntax: -collate Example: To specify that a plot set be collated: iplotorg print -copies=2 -collate house. this qualifier is ignored.Syntax: iplotorg preview plotset_file -output Use the -output qualifier to redirect error/informational messages to a log file. The number of copies is not stored in the plot set file.ips Print Command Use the Print command to submit a plot set to a printer.

exe @command_file (Where command_file is the name of an ASCII file.ips Command Files Organizer also supports the use of command files for specifying command line arguments.ips -output Use the -output qualifier to redirect error/informational messages to a log file. This prevents you from having to dismiss a window each time you run the command line. Syntax: -output=log_file Example: To archive the plots in a plot set and dismiss the window: iplotorg archive –output=err.) 2-11 .ips -output Use the -output qualifier to redirect error/informational messages to a log file.-delete_plotset Example: To delete a plot set after printing: iplotorg print -delete_plotset misc.log house. To specify a command file. Syntax: -output=log_file Example: To print the plots in a plot set and dismiss the window: iplotorg print –output=err. use the following syntax: iplotorg. Syntax: -delete_plotset Example: To delete a plot set after archiving: iplotorg archive -delete_plotset misc. Syntax: iplotorg archive <-qualifier> plotset_file You can use the following qualifiers with the Archive command: -delete_plotset -output -delete_plotset Use the -delete_plotset qualifier with the Archive command to specify that the plot set file be deleted if archiving is successful. This prevents you from having to dismiss a window each time you run the command line.ips Archive Command Use the Archive command to archive a plot set.log house.

you must specify the full filename. tabs. arguments must begin and end on the same line and each must be separated by spaces. including any extension. or newline characters. In the command file. Wildcards can not be used. All of the command line arguments must be specified in the command file. 2-12 .No space or tab is allowed between the at sign (@) and the filename. There is no default extension. Command files can not be nested.

2-13 . Plotting with the command line is often faster than plotting with the dialog box because you do not have to wait for MicroStation to load the design file before you plot. As with Organizer. The command line interface has several advantages: The command line allows you to work easily with large sets of IPARM files.Introduction to the IPLOT Command Line Note Throughout this section the term IPLOT refers to the IPLOT component of InterPlot. you can easily produce new sets of drawings by using the command line and the original IPARM files. InterPlot Client/Professional includes the IPLOT command line interface that you run from the command prompt. you can create a set of IPARM files that correspond to project drawings. You can create customized plotting utilities by writing shell scripts or batch files that run the command line. As the design progresses. you can resubmit plots submitted from the dialog box and plot design files without displaying them in MicroStation. using the command line. In addition to the dialog box that operates inside MicroStation. At the beginning of a project. and the Organizer interface that operates outside of the MicroStation environment.

a qualifier is in one of several formats: Format -qualifier -qualifier=value -qualifier[logical_names] -qualifier[logical_names]=value Function Specifies an action Sets a parameter Specifies an action for one or more reference files Sets a parameter for one or more reference files 2-14 . The command line components can be specified in either upper or lower case and can be abbreviated to the minimum number of characters needed to uniquely identify them. All commands except Preview and Generate have qualifiers that control the command. The Preview command allows you to view plots on the screen. 2 Generate a metafile containing graphics data representing the design file and its reference files. prior to using the Submit command to submit the plot to the device (Step 3). The Create command requires a single IPARM filename. The IPLOT command line provides the following commands to complete these three steps: Create Modify Show Generate Preview Submit The Create. the . Modify. All six commands use IPARM files. All commands except Preview and Generate support qualifiers. IPARM_file(s) . Show.accesses the IPLOT command line.0 drawing Using Qualifiers Depending on the information it specifies. Preview. command . typically by setting specific parameters or designating subactions. IPLOT Command Line Syntax An IPLOT command line has the following format: iplot command qualifiers IPARM_file(s) The following list describes each component: iplot . 3 Submit the metafile to a plot server. Note If InterPlot Professional is installed. The Generate command generates the metafile (Step 2). you complete these three steps: 1 Create an IPARM file that describes a design file and how it should be plotted.represents the name of one or more IPARM files used to plot the design file.i iplot MODIFY -UNITS=IN -X=10.0 drawing.i extension for IPARM filenames is optional. or Submit) qualifiers . All commands except Create support multiple IPARM filenames and IPARM filenames containing wildcards. For example. Generate. the job plots directly without being submitted to a server.0 drawing iplot mod -units=in -x=10.Using the IPLOT Command Line To plot with IPLOT.represents one or more qualifiers that are used to control the command. These qualifiers are preceded by dashes. where it is actually plotted. Also.represents one of the six commands (Create. Modify. the following command lines are equivalent: iplot modify -units=inches -xsize=10. and Show commands allow you to create and display the IPARM file (Step 1).

0 drawing iplot modify -xsize=10. The following two commands produce the same result: iplot modify -view=2 -xsize=10.0 -view=2 drawing Qualifier Interaction If you specify certain combinations of qualifiers on the same command line. IPLOT recomputes the plot size. arbitrary character strings. IPLOT ignores one or more qualifiers. The -nolevels and -levels qualifiers provide one useful example. consider the following Submit command: iplot submit drawing1 drawing2 drawing3 If IPLOT cannot submit the metafile associated with drawing3. the command line returns a non-zero value. if several closely related qualifiers. Command Line Examples The following command line example creates an IPARM file. or comma-separated lists of such items enclosed in square brackets. The -design qualifier specifies the name of the design file to be plotted along with the name of the IPARM file to be created: 2-15 . However. all occurrences are processed in the order that you specified them. -ysize. IPLOT processes -view first. you can turn these levels on and turn off all others with a single command line: iplot mod -nolev=[1-63] -lev=[1. such as -xsize. filenames. For example. the IPLOT exit status is determined by the command operation on the last file. 3. Qualifier Priority You can place command qualifiers in any order on the command line.Qualifier values can be numbers. keywords. if -view is specified on the same command line as -xsize or -ysize. it returns a non-zero (failure) exit status to the operating system. IPLOT returns a 0 to the operating system if it successfully submitted drawing3. IPLOT does not process qualifiers in the order they are specified. if you use a particular qualifier more than once. If several IPARM files are specified for a command. when you use the -view qualifier. For example. Unless otherwise specified. IPLOT uses default values for plotting parameters such as the view to be plotted and the plot size. and 5. only the last one is used. the -scale qualifier in the following command is ignored: iplot modify -scale=1:1 -xsize=24. are on the same command line. Therefore. If the command fails.0 drawing Several qualifiers are exceptions to this rule: -attach_ref -detach_ref -[no]display -[no]environment -[no]fast -[no]levels -ref_filename -settings If you use one of these qualifiers several times on the same command line. and -scale. Shell scripts and batch files can test the command line exit status to decide whether to continue processing. 5] drawing IPLOT Command Line Exit Status The IPLOT command line returns an exit status of zero(0) to the operating system if it successfully processes the command. For example. Instead. Similarly. 3. If you want to plot only Levels 1. even if it could not submit drawing1 or drawing 2. it processes qualifiers with many side effects before qualifiers with fewer or no side effects. In general. IPLOT processes the last occurrence and ignores the others.

as well as the effects they had on the plot size. use the Generate command to generate a metafile. iplot modify -printer=itp436 -scale=10:1 plan To see the results of your changes. After the IPARM settings are satisfactory. The following list contains additional command line examples: To view the plot scale: iplot show -scale drawing To set the plot’s X size: iplot modify -xsize=16. iplot generate plan IPLOT creates a metafile that has the same base name as the IPARM file and a .CFG file.m extension. IPLOT adds a . (The metafile extension is defined in the IPLOT. (The IPARM file extension is defined in the IPLOT. 5-10.) To view the settings for these and other parameters.) iplot submit plan IPLOT sends the metafile to the plot server. You can change any of the displayed parameters with the Modify command. specifying the IPARM filename.CFG file. iplot show plan IPLOT displays the current settings of all plotting parameters under your control. use the Show command. you can select a different printer and specify a different plot scale.Note If you do not add an extension to the IPARM filename. To submit this metafile to the plot server that is associated with the printer you selected. where it is plotted.0 drawing To generate metafiles for all IPARM files in the current directory: iplot generate *. iplot show -queue -scale -xsize -ysize plan Note -queue is equivalent to the -printer qualifier.i To view the names of all attached reference files: iplot show -ref_filename[iplot_all] drawing To turn on a set of levels in the master design file: iplot modify -levels=[1. pattern] drawing 2-16 . For example. as in this example.i extension to the filename by default. you can use the Show command again and specify only the parameters you want to see.ref2]=[points. 20-34] drawing To turn on all levels in a specific reference file: iplot modify -levels[ref1]=[1-63] drawing To disable the plotting of points and patterns in a set of reference files: iplot modify -nodisplay[ref1. use the Submit command.

only their associated names and values are displayed.i) is appended to the IPARM filename. The -design qualifier is required.dgn -scale=25:1 floorplan iplot modify -rotation=90 floorplan Show The Show command displays the contents of one or more IPARM files. the names and values of all changeable parameters are displayed. If you do not specify a directory in the IPARM filename. If qualifiers are specified. IPLOT applies the changes specified by the qualifiers to each file. the extension defined in the configuration file (by default. the current working directory). IPLOT creates the IPARM file in the directory specified by the configuration file (by default. Any specified qualifiers will override these default parameters. Syntax: iplot create -design=dgn_filename -qualifiers IPARM_file If you do not specify an extension for the IPARM filename. If several IPARM files are specified.IPLOT Commands This section discusses the IPLOT commands: Create Modify Show Generate Preview Submit Create and Modify The Create and Modify commands have similar functions and use the same qualifiers. and fast/slow settings are derived from this view. The Create command creates a new IPARM file from a design file. If you do not specify any qualifiers.i 2-17 . If you do not use any other qualifiers. display settings. The Modify command modifies one or more existing IPARM files. The paper size is set to NONE. The destination printer is the most recently used printer (or the system default if no previous plots have been made). The levels. Syntax: iplot show -qualifiers IPARM_file(s) Example: iplot show floorplan. The plot is maximized to the largest size the printer allows. Note You can also specify values by configuring a default settings file or printer specific settings file. the IPARM file contains the following default features: The plot area is the first "on" view. 0) inches. . The active units is inches. Syntax: iplot modify -qualifiers IPARM_file(s) Examples: iplot create -design=house. The plot data is not rotated and has an origin of (0.

Submit The Submit command submits a metafile to a plot server based on the information in the specified IPARM file. . a preview window containing the plot appears.i Note You must generate the metafile prior to using the Preview command. The Generate command does not have any associated qualifiers. An IPARM file contains control information about a plot. the Submit command actually plots the job directly to the printer. Examples: To generate a metafile for a single IPARM file: iplot generate floorplan To generate metafiles for all IPARMs in the current directory: iplot generate *. In contrast.Generate The Generate command creates a metafile from an existing IPARM file and its associated design and reference files.i: iplot preview floorplan. Syntax: iplot preview IPARM_file(s) Example: To preview the file named floorplan. Syntax: iplot submit -qualifiers IPARM_file(s) Example: iplot submit floorplan 2-18 . IPLOT generates a metafile from each file. Syntax: iplot generate IPARM_file(s) The generated metafile has the same base name as its corresponding IPARM file. If several IPARM files are specified. but with the extension defined in the configuration file (by default.i Preview The Preview command allows you to view plots on the screen. IPLOT sends the corresponding metafile of each file to the plot server. Note For InterPlot Professional. If several IPARM files are specified. a metafile contains the actual graphic elements extracted from the design file and its reference files.m). prior to submitting them to a printer. When you run the command.

dgn drawing When used with the Create command. The following is a list of qualifiers you can use with the Create and Modify commands: -align_x -align_y -area -area_cellnames -area_colors -area_files -area_levels -area_styles -area_types -area_weights -attach_ref -center -color_table -data_rescale -design -detach_ref -[no]display -[no]environment -[no]fast -[no]feature_table -[no]fence -[no]levels -maximize -mirror -origin -paper_size -[no]pen_table -plot_rescale -printer -workspace -[no]qpr_options -ref_filename -[no]region -[no]rendering_attributes -rotation -scale -settings -units -update -view -[no]volume -xsize -xysize -ysize Defining the Plot Area The following qualifiers define the design file or the area of the design file to plot.IPLOT Create and Modify Qualifiers The qualifiers for the Create and Modify commands are the same. You should not use the command Modify -design to specify a different design file. -view Syntax: -view=view_number -view=saved_view_name The view_number value must be a number between 1 and 8. Examples: To create an IPARM file that will plot the contents of View 2: iplot create -design=drawing. -design Syntax: -design=dgn_filename Examples: iplot create -design=new. the -design qualifier identifies the design file that IPLOT uses to create the IPARM file. If the IPARM file 2-19 .dgn -view=2 drawing To modify the IPARM file to plot View 1: iplot modify -view=1 drawing The -view qualifier changes the active view in the IPARM file. The saved_view_name value is the name of a saved view that existed in the design file at the time the IPARM file was created. depending on the contents of the IPARM file. the -design qualifier changes the design filename in the IPARM file. When used with the Modify command. You use the -design qualifier with the Modify command to update the IPARM files after you move design files to different directories or move IPARMs to different nodes with different directory structures. The new view affects the plot area differently.dgn drawing iplot modify -design=new.

[100. y. .0. . If only two points are specified. and fast/slow settings are also updated to match those of the new view.0]] plan3 The -fence qualifier defines a set of points (up to 101 vertices) that is used with the active view to define the plot area. and z are working unit values in the design file’s coordinate space. Examples: To plot a rectangular area of a 2D design file: iplot modify -fence=[[0. If the IPARM contains a volume specification. the new view completely defines the plot area. Note Because of the way MicroStation stores view information in the design file.. the volume still defines the plot area. The plot size is recomputed to reflect the new plot area.80. y2. IPLOT modifies the scale and size to make the plot fit.80]] plan2 To plot a rectangle in a view in a 3D design file: iplot modify -fence=[[0.0]. you specify 3D points.does not contain a fence. and the volume formed by extending its projection from the front face of the view to the back face is the plot area. If you specify two points... If the IPARM contains a fence or region specification.] -noregion The values x and y are working unit values in the design file coordinate space. To rectify the difference. The -fence qualifier clears any region or volume previously stored in the IPARM file. Examples: To plot a rectangular portion of a 2D design file: iplot modify -region=[0. x2.[100. region. If the design file is 3D. [x2.] -fence=[[x1.0]. 100..0].80]] plan1 To plot a triangular area of a 2D design file: iplot modify -fence=[[0. The plot size is recomputed to reflect the new plot area. indicating that the active view should define the plot area. the fence or region is projected onto the front face of the view. . but the contents of the volume are plotted based on the rotation of the new view. display on/off settings.80] drawing To plot a triangular portion of a 2D design file: 2-20 . z2]. you should specify a fenced region or volume to define the plot area instead of just a view. The -nofence qualifier deletes a previously stored fence or region. or volume specification. The volume formed by extending this polygon to the back of the view defines the plot area. If the computed plot size exceeds the plotter limits. For 3D files. [x2. [100. y1. and the projected points are connected to form a polygon on the view face. If the computed plot size exceeds the plotter limits. For 2D files. z1]. If the design file is 2D. you specify 2D points.] -nofence The values x. y2]. y1. IPLOT interprets their projections as the corners of a rectangular polygon on the view face. IPLOT interprets them as the two corners of a rectangle with sides that are parallel to those of the active view. IPLOT connects the points to form a polygon that defines the portion of the design to be plotted. -region/-noregion Syntax: -region=[x1.0].[50.. y2. IPLOT typically plots a slightly larger area for a given view than MicroStation displays.0. the points are projected to the front face of the active view. -fence/-nofence Syntax: -fence=[[x1. y1]. the scale and size are modified to make the plot fit. The active levels..

50. The IPARMs are created in the form iparm#.i.z2] -novolume The values x. this qualifier is accompanied by other qualifiers to select shapes with certain color. indicating that the active view should define the plot area. y.i. Example: To plot the contents of a cube in the design file: iplot modify -volume=[0. and z are working unit values in the design file coordinate space. The -region qualifier clears any fence previously stored in the IPARM file.z1. then IPARMs named test. Note For 2D design files.0.10] drawing The -volume qualifier specifies the two corners of a cubic volume that defines the plot area.0. The fences in the IPARMs correspond to the vertices of the shapes.0. 10. The -novolume qualifier clears any volume previously stored in the IPARM file. For example. Generally. IPLOT connects the points to form a polygon defining the portion of the design file to be plotted. The IPLOT_SHAPE_LIMIT configuration variable limits the number of IPARMs that an all_shapes operation can create. weight. The -noregion qualifier deletes a previously stored region or fence. The area keyword determines which of the automatic methods you should use to determine the plot area. the scale and size are modified to make the plot fit.y2.10.i. the contents of the resulting polygon or rectangle are plotted according to the rotation defined by the active view. IPLOT modifies the scale and size to make the plot fit. If you specify two points. If the computed size exceeds the plotter limits. the -region and -fence qualifiers are functionally equivalent unless you specify only two points and the active view is a rotated view. level. and test2. The valid -area values are: all_shapes locates all matching shapes and creates an IPARM for each one. and fit_all. all_shapes. style. -volume/-novolume Syntax: -volume=[x1.80] drawing The -region qualifier defines a set of points (up to 101 vertices) that define the plot area for a 2D design file.0. -area Syntax: -area = area_method Valid area_method keywords are shape. 2-21 . The plot size is recomputed to reflect the new plot area. the -volume qualifier clears any fence previously stored in the IPARM file.i would be created. This qualifier applies only to 3D design files. The contents of this volume are plotted according to the rotation defined by the active view. fit. indicating that the active view should define the plot area. test1. or file attributes. The default value of IPLOT_SHAPE_LIMIT is 50.y1. Example: iplot modify -area=fit_all drawing The area qualifiers allow you to specify the plot area indirectly by describing elements whose actual coordinates or ranges define the plot area. In any case.iplot modify -region=[0. IPLOT interprets them as the two corners of a rectangle in the design files coordinate space. Also. 100. if three matching shapes were found in the plot area during an all_shapes operation. If the computed plot size exceeds the plotter limits. IPLOT recomputes the plot size to reflect the new plot area. You can find descriptions of these qualifiers at the end of this section. x2. If you specify more than two points. This qualifier does not apply to 3D design files.

IPLOT_R7] -area_cellnames=DOOR -area_cellnames=[DOOR. then only cells with the specified names are considered. then scanning will end as soon as a matching shape is found. then only the last occurrence of the qualifier will be used.shape fit fit_all Note If you use the all_shapes qualifier in a Modify command. then IPLOT scans the master file and all reference files. locates the first matching shape and uses its vertices as the plot fence for the IPARM. -area_files. If area_cellnames is not present. style. To include other types. SHOWER] Examples: To create an IPARM with either a volume or region (depending on the dimension of the master file) that encompasses all of the graphical elements in all of the files: 2-22 . CHAIR. The following qualifiers define the elements considered in the automatic plot area determination and should occur only once in a given command line. IPLOT ignores them. If you give invalid strings. If area_files is not present and -area is fit_all. logical names (IPLOT_ALL. Generally. area=all_shapes). -area_styles. then only the master file is considered. The area_weights values can be any integers between 0 and 31 inclusive. If they are specified more than once. level. then IPLOT considers all cells. Qualifiers with numerical values will accept either a single integer or a list of integers. If area is shape. BORDER.). weight. Note -area_types is ignored if -area is set to shape or all_shapes. Note When area_types and area_cellnames are used in the same command line. area=shape. The area_types values can be any integers between 1 and 128 inclusive. -area_types. If you give invalid strings. -area_colors. The area_colors values can be any integers between 0 and 255 inclusive. -area_levels -area_colors -area_weights -area_styles -area_types The area_levels values can be any integers between 1 and 64 inclusive. IPLOT_R1. makes the plot area a region or volume that encloses the ranges of all selected elements. This qualifier examines only master file elements unless the area_files qualifier is present. IPLOT silently ignores them. 17. or shape. makes the plot area a region or volume that encloses the ranges of all selected elements. The following represents proper syntax for the area_files and area_cellnames qualifiers: -area_files="BORDER*. This qualifier examines the master file and all of the attached reference files unless the area_files qualifier is present. The area_styles values can be any integers between 0 and 7 inclusive. or file attributes. or reference file logical names. Wild cards are permitted. then IPLOT scans the listed files. this qualifier is accompanied by other qualifiers to select a shape with certain color. If area_cellnames is present. If area_files is present. use -area_types. since the shape modes imply scanning for Type 6 shape elements only. The strings given for area_cellnames should be valid cellnames. all_shapes. Also. then area_types automatically includes Type 2 and Type 35 cells. 19-31] -area_files The strings given for area_files should be either actual design filenames (without directory names). Wild cards are permitted for design filenames. the qualifiers must be used with one of the automatic plot area methods (area=fit. Note The following qualifiers define the elements considered in the automatic plot area determination: -area_levels. The following represents proper syntax for qualifiers with numerical values: -area_levels=42 -area_types=[2.DGN. 17] -area_weights=[0-15. then no additional IPARMs are created.DGN" -area_files=[FILE1. and -area_cellnames. -area_weights. If area_files is not present and area is fit. area=fit_all. etc. -area_cellnames The area_files and area_cellnames qualifiers define which files and cells are considered in the automatic plot area determination.

the paper size controls which paper tray or paper roll is used for the plot. If the printer has an associated settings file.dgn -area=shape -area_level=6 -area_files=[iplot_master] -maximize car To create up to 50 (default) IPARMs. the origin and plot size (if necessary) are reduced to make the plot fit. IPLOT maintains the current paper size on the new printer. each containing a fence that corresponds to a shape element with color 250. IPLOT processes the contents of the settings file. Adjusting the Plot Size Use the following qualifiers to specify and adjust the size of the plot. For some devices. Syntax: -printer=printer_name Example: To select a new printer: iplot modify -printer=v8936 drawing The -printer qualifier changes the printer name in the IPARM file. the special paper size None indicates to use the default paper size of the printer. Also.dgn -area=all_shapes -area_colors=250 -maximize car Selecting the Printer and Paper Size Use the following qualifier to select the printer you want to use for the plot. Example: 2-23 . If the paper size is unavailable. and millimeters (mm). For Microsoft or vendor-supplied drivers. The paper size changes the maximum length and width of the plot.iplot cre -des=a. feet (ft). -paper_size Use the following qualifier to select the paper size (form) you want to use for the plot.dgn -area=fit -area_types=3 -area_files=[ref1] -maximize car To create an IPARM with a fence whose vertices are the same as the first shape on a specified level in the master file: iplot cre -des=a. -units Syntax: -units=unit_keyword Valid unit keywords are inches (in). iplot cre -des=a. When changing the printer. the default is often the device limits. -printer Note -queue is equivalent to the -printer qualifier. the document defaults size is used. For InterPlot device drivers. paper size is set to NONE. centimeters (cm). meters (m). Syntax: -paper_size=paper_size Example: To select a paper size: iplot modify -paper_size="c size sheet" drawing The -paper_size qualifier changes the paper size in the IPARM file.dgn -area=fit_all -maximize car To create an IPARM with either a volume or region which encompasses all of the line elements found in the reference file with the logical name ref1. If the new printer's limits are smaller than the previous printer's. iplot cre -des=a.

This command maintains the current aspect ratio so that the plot size does not increase along one axis by a greater amount than the other axis. The size is interpreted in the active units. The plot origin resets to 0. IPLOT computes the plot size based on the plot area and the new scale.5 drawing The -xsize qualifier sets the size of the plot along the plotter’s X axis.25 specifies that 1/4 inch on the plot represents 1 foot in the design. if the design units are feet and the active units specified by the -units qualifier are inches. -maximize Syntax: -maximize Example: To specify that the drawing be maximized: iplot modify -maximize drawing The -maximize qualifier increases the plot size to the largest size allowed by the device. IPLOT recomputes the plot scale based on the plot area and the new plot size. scale. For example.To set the active units to millimeters: iplot modify -units=mm drawing The -units qualifier sets the active units of measure for any subsequent -scale. -ysize. -xysize. -scale Syntax: -scale=design_units:plotter_units Both design_units and plotter_units are numbers greater than zero. If the computed plot size exceeds the plotter’s limits. Example: To set the Y plot size to 36 inches: iplot modify -ysize=36 drawing 2-24 . -ysize Syntax: -ysize=y_size The value y_size is a number greater than zero. The active units also control how the size. IPLOT rejects the scale. and -origin qualifiers. a scale of 1:0. If the computed plot size exceeds plotter limits. -xsize. and origin are displayed by the Show command.5 inches: iplot modify -xsize=44. Example: To specify that a scale of 1 inch on the plot equals 100 miles in the design when mile is the design unit: iplot modify -scale=100:1 map The -scale qualifier defines the plot scale--the relationship between the design units in the design file and physical units of measure on the plot. IPLOT reduces the plot size to make the plot fit within the limits. IPLOT uses the new X size to compute the Y size while maintaining the current aspect ratio of the plot.0. Also. Example: To set the X plot size to 44. -xsize Syntax: -xsize=x_size The value x_size is a number greater than zero.

-plot_rescale behaves identically to -data_rescale.1 drawing To reset the plot to a proportionately scaled (undistorted) state: iplot modify -plot_rescale=1. Circles in the design file plot as ovals. IPLOT recomputes the X and Y plot sizes.y_rescale The values x_rescale and y_rescale are numbers greater than zero.y_rescale The values x_rescale and y_rescale are numbers greater than zero. and squares in the design file plot as rectangles. if the y_size value exceeds the plotter’s Y limit.1 drawing Note The -plot_rescale qualifier has no effect on raster data in the design file. do not use the technique of specifying extremely large values to maximize the plot size. IPLOT uses the new Y size to compute the X size while maintaining the current aspect ratio of the plot. In particular.1. IPLOT also recomputes the plot scale based on the plot area and the new plot size (same as X size). -data_rescale Syntax: -data_rescale=x_rescale.y_size The values x_size and y_size are numbers greater than zero. Note The plot rescale factors are applied after any plot rotation is performed. When you use this qualifier. resulting in large amounts of wasted paper.1 -data_rescale=1. raster data in the design file will not be disproportionately scaled. Examples: To stretch a plot by a factor of two along the active view’s X axis. IPLOT rejects the plot rescale. IPLOT reduces the plot size to make the plot fit within the limits. Examples: To stretch a plot slightly along the plotter’s X axis: iplot modify -plot_rescale=1. Note Be careful when using the -xysize qualifier to plot to roll feed plotters. -xysize Syntax: -xysize=x_size.1 drawing To reset the plot to a proportionately scaled (undistorted) state: 2-25 . Plot rescaling is typically used to compensate for old or non-standard plotters or to distort the plot slightly to use all of the available plot media. The size is interpreted in the active units. Example: To create an 11. even if the plot is rotated: iplot modify -data_rescale=2. If the computed plot size exceeds the plotter’s limits. If the x_size value exceeds the plotter’s X limit.The -ysize qualifier sets the size of the plot along the plotter’s Y axis. Doing so will extend the X plot size to the full length of the roll.5 plot regardless of the plot area’s shape: iplot modify -xysize=11.0 x 8. -plot_rescale Syntax: -plot_rescale=x_rescale. Using the -xysize qualifier usually results in a disproportionately scaled (distorted) plot and changes the plot rescale values.5 drawing The -xysize qualifier sets the size of the plot along both the plotter’s X and Y axes. The size is interpreted in the active units. If you do not rotate the plot. IPLOT reduces the x_size value to the X limit. IPLOT reduces the y_size value to the Y limit. The plot rescale updates to reflect the new X and Y sizes. Note If the -xysize qualifier results in a disproportionate scale. If the computed plot size exceeds the plotter’s limits.8.

Adjusting the Plot Placement Use the following qualifiers to adjust the placement of the plotted data on the page. Example: To shift the lower-left corner of the plot up two inches and to the right three inches from its default location: 2-26 . -align_y Syntax: -align_y Example: To align a plot with the Y axis: iplot modify -align_y drawing The -align_y qualifier calculates the rotation angle that aligns the longest side of the plot area with the printer’s Y axis. When you use this qualifier. IPLOT rejects the data rescale. -align_x Syntax: -align_x Example: To align a plot with the X axis: iplot modify -align_x drawing The -align_x qualifier calculates the rotation angle that aligns the longest side of the plot area with the printer’s X axis. -origin Syntax: -origin=x_origin. Data rescaling is typically used to expand data that is compressed along one axis (in the design file) to its normal size for plotting. IPLOT supports rotation values of 0. IPLOT recomputes the plot size. If the computed plot size exceeds the plotter’s limits.1 drawing Note The -data_rescale qualifier has no effect on raster data in the design file.y_origin The values x_origin and y_origin are numbers greater than zero. -data_rescale behaves identically to -plot_rescale. Note The -data_rescale factors are applied before any plot rotation is performed. IPLOT modifies the size and scale values.1 -plot_rescale=1. If you do not rotate the plot. IPLOT recomputes the X and Y plot sizes. If the computed plot size exceeds the plotter’s limits. and 270 degrees for raster reference files (type 90) and supports rotations of 0 and 90 for embedded raster files (type 87/88). 180.iplot modify -data_rescale=1. 90. Example: To rotate a plot 90 degrees counter-clockwise: iplot modify -rotation=90 drawing The -rotation qualifier rotates the plot by the specified number of degrees. -rotation Syntax: -rotation=degrees The value degrees is a number between 0 and 360.

Examples: To mirror the plot horizontally about the plotter’s Y axis: iplot modify -mirror=y drawing To mirror the plot vertically about the plotter’s X axis: iplot modify -mirror=x drawing To disable mirroring: iplot modify -mirror=off drawing The -mirror keyword produces a mirror image of the plot along the plotter’s X or Y axes or both.0.0. 1. The origin is interpreted in the active units.0 inches and the current plot size is 10. 3. -mirror Syntax: -mirror=keyword Valid mirror keywords are x. y. and off.0 inches and you specify an origin of 5. there are small margins along each side of the media that are unusable. The plot origin is the position of the lower left corner of the plot relative to the lower left corner of the plotter’s imaging area. The portion of the media that is usable is known as the imaging area. Typically.0 x 8. Mirroring the plot does not change the size or position of the plot on the media. Note To maintain compatibility with previous versions of IPLOT. The plot origin is an offset from the lower left corner of the imaging area. the following forms of -mirror are also supported. Note Most plotters cannot plot on the entire media. -center Syntax: -center Example: iplot modify -center drawing The -center qualifier sets the plot origin to the values that center the plot within the plotter’s imaging area. The effect of the -center qualifier is not permanent. 2-27 .0. both. and the plot is no longer centered. the plot is centered along the plotter’s short axis only.0. -mirror=on (identical to mirror=x) -nomirror (identical to mirror=off) Changing the Plot Display Use the following qualifiers to specify the design file elements that should appear on the plot and how those elements are plotted. if the plotter limits are 11.iplot modify -origin=3. Any changes to the IPARM that affect the plot size leave the origin unchanged. -display/-nodisplay Syntax: -display=[keyword(s)] -display[logical_name(s)]=[keyword(s)] -nodisplay=[keyword(s)] -nodisplay[logical_name(s)]=[keyword(s)] The value logical_name(s) is a single reference file logical name or a comma-separated list of logical names. IPLOT adjusts the origin to 1.0 x 7.2 drawing The -origin qualifier sets the plot origin. If the plotter is a roll-feed device (with paper size set to NONE). If the specified origin shifts the plot off the media. For example. not from the corner of the actual media. IPLOT adjusts the origin to keep the plot on the media.

Plots lines and arcs with width in their defined width. Plots weighted elements with their defined weight. If you use iplot_all as the logical name. -fast/-nofast Syntax: -fast=[keyword(s)] -fast[logical_name(s)]=[keyword(s)] -nofast=[keyword(s)] -nofast[logical_name(s)]=[keyword(s)] The value logical_name(s) is a single reference file logical name or a comma-separated list of logical names. Plots specified design file or reference file.Examples: To plot all filled elements in the master file as outlines: iplot modify -nodisplay=area_fill drawing To prevent a pair of reference files from plotting: iplot modify -nodisplay[ref1. Plots elements with the symbology in the level symbology table. Plots user-defined line styles. text. the changes apply only to the master file. Does not plot construction elements. Used with -nodisplay Plots filled elements. text. Does not plot perspective information associated with the active view (3D files only). Does not plot point elements. The elements or element attributes changed by the qualifier are controlled by a keyword. construction dimension enter_data file level_symbology line_styles pattern points ref_boundaries tags text_nodes weight width If you do not specify a logical name. Plots any perspective information associated with the active view (3D files only). Does not plot specified file or reference file. Plots dimension elements. Plots reference file clip boundaries. Plots elements with their defined symbology. Does not plot reference file clip boundaries. Does not plot data field markers. the changes apply to the specified reference files. Plots element tags. Plots construction elements. the changes apply to the master file and all reference files. and lines and arcs with width as outlines. The -nodisplay variable disables the plotting of those classes of elements or attributes. Refer to the following table for a list of keywords and descriptions of how they work with -display and -nodisplay. Plots weighted elements at weight 0. Plots lines and arcs as vectors. Does not plot element tags. Plots pattern elements. Examples: To specify fast curves and fonts for the master file: iplot modify -fast=[curve. Keyword area_fill camera Used with -display Plots filled elements. ref2]=file drawing To enable the plotting of text nodes in the master file and all reference files: iplot modify -display[iplot_all]=text_nodes drawing The -display qualifier allows you to plot classes of elements or element attributes in specified files. Plots point elements. Does not plot pattern elements. Plots text node crosses and numbers. and arcs with width as filled polygons. Plots data field markers. Does not plot dimension elements. If you specify logical names. Does not plot text node crosses and numbers. Does not plot user-defined line styles. font] drawing 2-28 .

If you do not specify a logical name. If you specify logical names.30-63] mstr To turn on a set of levels in a reference file: iplot modify -levels[ref1]=[1. Text plots with the defined font. Reference files are clipped to the minimum bounding rectangles of their boundaries. Text plots with the fast font.30-63] ref1 To turn on all levels in all files: iplot modify -levels[iplot_all]=[1-63] house The -levels qualifier turns on a set of levels in specified files. the changes apply to the master file and all reference files. Using Reference Files Use the following qualifiers to plot reference files with the design file. The following table shows how each keyword works with -fast and -nofast: Keyword cell font text curve ref_clipping Used with -fast Cells are represented by rectangles. the levels are modified in the specified reference files. IPLOT turns the levels on or off in the master file. If you specify only a single level number.5-10. the levels are modified in the master file and all reference files. the changes apply to the specified reference files. -ref_filename Syntax: 2-29 . Used with -nofast Cells plot normally. Text does not plot. curve] drawing The -fast keyword selects the "fast" representation of the designated elements in specified files.To specify normal representations of cells and curves in all files: iplot modify -nofast[iplot_all]=[cell. For example. Actual curves plot.5-10. The -nofast keyword selects the "slow" (normal) representation. -levels/-nolevels Syntax: -levels=[levels] -levels[logical_name(s)]=[levels] -nolevels=[levels] -nolevels[logical_name(s)]=[levels] The value logical_name(s) is a single reference file logical name or a comma-separated list of logical names. Text plots. Reference files are clipped to their defined boundaries. the brackets enclosing the number can be omitted. the changes apply only to the master file. If you specify iplot_all as the logical name. If you specify logical names. If you do not specify a logical name. If iplot_all is specified as the logical name. The -nolevels keyword turns off a set of levels. or a comma separated list of single level numbers and/or pairs. Curves represented by line strings. a fast cell is plotted as a rectangle. Examples: To turn on a single level in the master file: iplot modify -level=10 mstr To turn on a set of levels in the master file: iplot modify -levels=[1. a pair of level numbers separated by a hyphen. The value levels is a single level number between 1 and 63. The fast representation of an element is a crude representation that plots faster than the normal representation.

This form of -attach_ref also requires a scale ratio defining how the reference file should be scaled relative to the master file. The attachment point in the master file.1:1. The simple form of -attach_ref performs a "coincident" attachment. ref2] drawing To detach all reference files: 2-30 . Use the Show command to view the logical names and filenames of all reference files that are attached to the IPARM.2:1.dgn. specify an XY coordinate in working units. The name of the reference file to be attached.top. Example: To change the filename of the reference file with the logical name border: iplot modify -ref_filename[border]=newname. scale_ratio. and levels. if the master file is 3D.dgn. The saved view defines the reference file’s rotation.dgn drawing The -ref_filename qualifier changes the filename of a reference file having a specified logical name. Note Use the -ref_filename qualifier to update IPARM files after you move reference files to different directories or IPARMs to different nodes with different directory structures. saved_view_name. attach_point Examples: To attach a coincident reference file: iplot mod -attach_ref[hvac]=b100hvac. iplot show -ref_filename[iplot_all] drawing -attach_ref Syntax: -attach_ref[logical_name]= dgn_filename -attach_ref[logical_name]=[ dgn_filename. The complex form of -attach_ref performs a saved view attachment.top. The first number represents the master file. origin (the center of the saved view is mapped to the specified master file attachment point). the second represents the reference file.0. -detach_ref Syntax: -detach_ref[logical_name(s)] The value logical_name(s) is a single reference file logical name or a comma-separated list of logical names. attach_point] Value logical_name dgn_filename saved_view_name scale_ratio Definition The logical name to be assigned to the new reference file.0] car To attach a reference file to a 3D master file using a saved view.-ref_filename[logical_name]=dgn_filename The value logical_name is the logical name of the reference file whose filename is to be changed. The name of a saved view in the reference file that defines the reference file’s orientation and attachment point. scaling the reference file up by a factor of 2: iplot mod -attach_ref[bor]=[bor. A pair of floating point numbers separated by a colon that define the scale relationship between the master design file and the reference file.0. clipping boundary (the extents of the view). The reference file is not rotated or scaled with respect to the master file. If the master file is 2D. Example: To detach the reference file with logical names ref1 and ref2: iplot modify -detach[ref1. and their origins are coincident. specify an XYZ coordinate.dgn bldg To attach a reference file to a 2D master file using a saved view: iplot mod -attach_ref[bor]=[bor.0] car The -attach_ref qualifier attaches a reference file to the IPARM file (not to the design file).0.

Use it when you do not want any colors or gray shades on your plot.dgn -color_table=gshade. The color table GSHADE. -color_table Syntax: -color_table=color_table_file Example: To create an IPARM file to plot the sample gray shades: iplot cre -des=256color.pen *.DGN (also delivered in the IPLOT MISC subdirectory). plot the design file 256 COLOR. Note InterPlot delivers several IPLOT color tables in the MISC subdirectory of the shared component. to an IPARM file. A compiled version of the pen table is placed in the metafile created by the Generate command and is used during plot processing to change the appearance of selected elements.i To detach a pen table from an IPARM file: iplot mod -nopen_table house iplot modify -pen_table=none house The -pen_table qualifier attaches a pen table to the IPARM file.iplot modify -detach[iplot_all] drawing The -detach_ref qualifier permanently detaches one or more reference files from the IPARM.CTB color table. The color table is placed in the metafile created by the Generate command and is used by the InterPlot Server software on the plot server. -feature_table/-nofeature_table Syntax: -feature_table=feature_table_file -nofeature_table Examples: To attach a feature table to all IPARM files in the current directory: 2-31 . To plot the gray shades. it is detached when you use this qualifier.254 as solid black.CTB defines Color 0 as white and Colors 1 .CTB defines a white background color and colors 0 . but not both. The color table BW. The -nopen_table qualifier detaches a pen table from an IPARM file. Its main use is to provide sample gray shades that can be used for screening elements.ctb grays The -color_table qualifier reads a color table and stores it in the IPARM file. You can attach a pen table or a feature table. iplot show -ref_filename[iplot_all] drawing Attaching Associated Files Use the following qualifiers to attach associated files that change the plot’s appearance. The default location of the IPLOT shared component is c:\ Program Files\ Common Files\ InterPlot\ IPLOT. -pen_table/-nopen_table Syntax: -pen_table=pen_table_file -nopen_table Examples: To attach a pen table to all IPARM files in the current directory: iplot modify -pen_table=screen.254 as decreasing darker gray shades. Note Use the Show command to view the logical names and filenames of all reference files that are attached to the IPARM. Using -pen_table with none as the filename also detaches the pen table. If a feature table is attached to the IPARM file. with the GSHADE.

Be sure the rendering attributes file is compatible with the plotter that is serviced by the printer referenced in the IPARM file. -environment/-noenvironment Syntax: -environment=[variable_definition(s)] -noenvironment=[name(s)] The value variable_definition(s) is an environment variable definition or a comma-separated list of definitions. but not both. -settings Syntax: -settings=settings_file Example: To execute a project-specific settings file: iplot modify -settings=hvac. You can view and edit rendering attributes files with the InterPlot Utilities > Graphical Attribute Editor in the InterPlot Utilities group.set building The settings file qualifier processes the qualifiers in a settings file prior to the remaining command line qualifiers. it is detached when you use this qualifier. The rendering attributes file is sent to the server node along with the metafile by the Submit command. 2-32 . The value is an arbitrary string. It is used during plot processing to change the appearance of selected elements. You can access additional online help inside the utility. Using -feature_table with none as the filename also detaches the feature table.iplot modify -feature_table=fill.) A compiled version of the feature table is placed in the metafile created by the Generate command. If a pen table is attached to the IPARM file. see the "Using Feature Tables" section of the InterPlot Reference Help. You can attach a pen table or a feature table. Other Qualifiers The following qualifiers are also available for the Create and Modify commands. The -norendering_attributes qualifier detaches a rendering attributes file from the IPARM file. Using -rendering_attributes with none as the filename also detaches the file. -rendering_attributes/-norendering_attributes Syntax: -rendering_attributes=rendering_attributes_file -norendering_attributes Example: To attach a rendering attributes file: iplot mod -rendering_attributes=hp. to an IPARM file.i To detach a feature table from an IPARM file: iplot modify -nofeature_table drawing iplot modify -feature_table=none drawing The -feature_table qualifier attaches a feature table to the IPARM file. (For more information on feature tables.ftb *. Note Rendering attributes allow you to control certain plotter-specific settings that affect the appearance of the plot. A definition can take one of two forms: 1 name=value 2 name The value name(s) is an environment variable name or a comma-separated list of names. The -nofeature_table qualifier detaches a feature table from the IPARM file.ra house The -rendering_attributes qualifier attaches a rendering attributes file to the IPARM file.

account=123] drawing To store a value containing blanks or special characters: iplot modify -environment=[name="John Doe"] drawing To change a previously stored variable definition: iplot modify -environment=[account=12500] drawing To remove a pair of variable definitions: iplot modify -noenvironment=[name. -qpr_options/-noqpr_options Syntax: -qpr_options=[qpr_options] -noqpr_options Example: To clear any previously stored options: iplot modify -noqpr_options drawing The -qpr_options qualifier stores a set of qpr options in the IPARM file. accounting must be enabled for the destination printer. If you are using InterPlot Server accounting. numbers. may contain only letters.Examples: To store a pair of variable definitions: iplot modify -environment=[dept=civil. IPLOT does not validate or interpret the qpr options. these names and values are also stored there. If the value being assigned to a variable contains blanks or characters that have special meaning to the operating system’s command interpreter. The tag and the file are placed in the server’s environment to be used for producing the plot. Note Environment variable names must start with a letter. The workspace name is stored in the IPARM file. the Submit command obtains the variable’s value from the operating system’s environment when it submits the plot. This workspace name determines which font and line style resource files to use when plotting the metafile. This option logs messages in the destination printer accounting file. and may not contain blanks. The following list contains the qpr options you can use with this qualifier. This option allows you to associate a tag with a filename. The -noenvironment qualifier removes one or more environment variable definitions from the IPARM file. replacing (not augmenting) any previously stored options. Variables defined with the Submit command are not stored in the IPARM file. and underscores. you should enclose the value in quotation marks. If an environment variable name is stored without a value in the IPARM file. -workspace Syntax: -workspace=workspace_name Example: To associate an IPARM file with a specific workspace: iplot modify -workspace=civil drawing Specifies a workspace name that IPLOT references to access MicroStation font resource files. -d name=value -e tag=file -l message This option defines an environment variable name and value to be used by the server. 2-33 . The Submit command transfers these names and values to the plot processing stage. account] drawing The -environment qualifier stores environment variable names or names and values in the IPARM file. The Submit command simply passes the options directly to the queuing system. To temporarily define environment variables for a single plot request. use the environment qualifier with the Submit command.

-n num-copies* -R {remove files} -p priority This option prints the specified number of copies. This option deletes the original files after the submission process is complete. To temporarily specify qpr options for a single plot request. where a value of 99 defines the highest priority and a value of 1 defines the lowest priority. * It is recommended that you use the Copies field in the Submit Options dialog box instead of using the -n qpr option. Note PCs running Windows 98 cannot use the -p priority option. The -noqpr_options qualifier removes any qpr options stored in the IPARM file. IPLOT automatically uses the following qpr options when it submits plot requests. priority must be an integer from 1-99. because doing so will cause the plot request to fail. q queue_name t data_type r request_name o options Note Do not specify these qpr options. -update Syntax: -update Example: To update an IPARM with current data from the master file and attached reference files: iplot modify -update drawing The -update qualifier can affect the following values: Master Design File global origin view extents view rotation view scale working units display on/off settings levels on/off level symbology list of attached reference files list of raster reference files display update sequence Attached Reference Files file name logical name file number display and fast flags levels on/off reference file scaling/rotation reference file origin reference file description 2-34 . This option assigns a priority. use the -qpr_options qualifier with the Submit command. The qpr options specified with the Submit command are not stored in the IPARM file.

mirroring. workspace. Size and scale are changed if the underlying state information requires that they be changed. and rotation are not changed.reference file level symbology clip fence if the file is displayed or not displayed IPLOT generated full path name Non-state information like pen table. 2-35 . Settings files are not re-applied as a part of update. printer. paper size.

The logical name IPLOT_ALL can be used to display the settings for the master file and all of the reference files. If no logical name is specified. one or more reference file logical names must be specified.i 2-36 . You can specify reference file logical names with the -[no]display.IPLOT Show Qualifiers The following list contains the qualifiers you can use with the Show command: -color_table -data_rescale -design -[no]display -environment -[no]fast -feature_table -fence -[no]levels -mirror -origin -paper_size -pen_table -plot_rescale -printer -workspace -qpr_options -queue -ras_filename -ref_filename -region -rendering_attributes -rotation -scale -units -view -volume -xsize -xysize -ysize Note The -nodisplay.i To show the levels for all files: iplot show -levels[iplot_all] drawing. The logical name IPLOT_ALL can be used to display the names of all reference files. -[no]fast.i To show an attached pen table: iplot show -pen_table houseplan. You can use wildcards (*. ?) in the logical names. and -[no]levels qualifiers to display the settings for specific reference files. Examples: To show all IPARM information: iplot show mytest. then the master file settings are displayed. -nofast. and -nolevels qualifiers show which settings are turned off. For -ref_filename.

-delete_iparm Syntax: -delete_iparm Example: To delete the IPARM file and the metafile after the plot is submitted: iplot submit -delete_iparm -delete_metafile drawing The -delete_iparm qualifier specifies that the IPARM file should be deleted if the submission succeeds. A metafile is of little use without its corresponding IPARM file. A definition can take one of two forms: 1 name=value 2 name The value name(s) is an environment variable name or a comma-separated list of names. account=12] drawing To specify a value containing blanks or special characters: 2-37 . Note Specifying -delete_iparm without also specifying -delete_metafile is not recommended. The value is an arbitrary string. Examples: To specify a pair of variable definitions: iplot submit -environment=[dept=civil.IPLOT Submit Qualifiers You can use the following qualifiers with the Submit command: -copies -delete_iparm -delete_metafile -[no]environment -[no]qpr_options -copies Syntax: -copies=number Example: To produce 5 copies of a plot: iplot submit -copies=5 drawing The -copies qualifier requests multiple copies of the plot. -environment/-noenvironment Syntax: -environment=[variable_definition(s)] -noenvironment=[name(s)] The value variable_definition(s) is an environment variable definition or comma-separated list of definitions. -delete_metafile Syntax: -delete_metafile Example: To delete the metafile after the plot is submitted: iplot submit -delete_metafile drawing The -delete_metafile qualifier specifies that the metafile is to be deleted if the submission succeeds. The number of copies is not stored in the IPARM file.

If an environment variable name is specified without a value. Defines the author. which stores them in the accounting record for the plot (if accounting is enabled on the plot server). Defines additional project information. For multiple attributes. Author=ab] This sets the Related Web Page attribute to www. numbers. where archive is the name of the digital archive.interplot. type in: iplot submit -environment=[archivename=archiveA] map To archive without printing a drawing. archiveonly=true] map To set plot attributes.com.iplot submit -environment=[name="John Doe"] drawing The -environment qualifier defines one or more environment variables to be transferred to the plot server. Specifies a place holder for a user specific WWW link.com and sets the Author attribute to ab. The target printer must be serviced by a Digital Print Room machine that contains a digital archive. may contain only letters. Keyword PlotSetID ProjectID Account Revision Author URL Name Plot Set ID Project ID Account Revision Author Related Web Page Description Defines additional design information. you must specify the environment variable definition ArchiveOnly=TRUE on the same command line with ArchiveName. you can use the -environment qualifier to archivea drawing (with or without printing) and to set plot attributes. names. Examples: To archive and print a drawing. you must define the environment variable ArchiveName=archive. See the table following the examples for a list of attributes. To archive a drawing without printing. enclose the value in quotation marks. To set plot attributes. If the value assigned to a variable contains blanks or characters that have special meaning to the operating system’s command interpreter. To archive and print a drawing. and descriptions. The -noenvironment qualifier causes the Submit command to ignore one or more of the variable definitions stored in the IPARM file. you must specify the attribute keyword and value. Note Environment variable names must start with a letter. and may not contain blanks. Defines the revision number. To permanently store environment variables in the IPARM. type in: iplot submit -environment=[archivename=archiveA. The following table lists the attribute variable keywords. IPLOT does not validate or interpret the qpr options. The Submit command simply passes the options directly 2-38 . Additionally.interplot. Defines the account. -qpr_options/-noqpr_options Syntax: -qpr_options=[qpr_options] -noqpr_options Example: To clear any previously stored options: iplot modify -noqpr_options drawing The -qpr_options qualifier specifies a set of qpr options to be used with the plot request. use the -environment qualifier with the Modify command. type in: aplot submit -environment=[URL=http://www. These queuing system options override (not augment) any queuing system options stored in the IPARM file. These definitions are sent to the plot server along with any definitions stored in the IPARM file. use a comma-separated list. and underscores. the Submit command obtains the variable’s value from the operating system’s environment.

This option logs messages in the destination printer accounting file. because doing so will cause the plot request to fail. Note PCs running Windows 98 cannot use the -p priority option. The tag and the file are placed in the server’s environment to be used for producing the plot. This option prints the specified number of copies. This option deletes the original files after the submission process is complete. Submit Examples To submit the metafile associated with an IPARM file: iplot submit design To request two copies of the plot: iplot submit -copies=2 design To submit metafiles for all IPARM files in the current directory: iplot submit *. The following list contains the qpr options you can use with this qualifier. The -noqpr_options qualifier removes any qpr options stored in the IPARM file. To temporarily specify qpr options for a single plot request. The qpr options specified with the Submit command are not stored in the IPARM file. -d name=value -e tag=file -l message -n num-copies* -R {remove files} -p priority This option defines an environment variable name and value to be used by the server. accounting must be enabled for the destination printer. This option allows you to associate a tag with a filename. use the -qpr_options qualifier with the Submit command. q queue_name t data_type r request_name o options Note Do not specify these qpr options. where a value of 99 defines the highest priority and a value of 1 defines the lowest priority. This option assigns a priority. priority must be an integer from 1-99. * It is recommended that you use the Copies field in the Submit Options dialog box instead of using the -n qpr option.to the queuing system. IPLOT automatically uses the following qpr options when it submits plot requests.i 2-39 .

InterPlot for MicroStation 2-40 .

C H A P T E R 3 Using Setting Files .

InterPlot for MicroStation .

You can create sections for specific data types (APLOT. By using settings files you can force on/off particular levels or display parameters. rendering attributes filename. you might specify an x-size of 34 inches for all APLOT data. and manually-applied settings files. Group together plotting parameters so that you can apply them to a specific plot or plot set. but you cannot specify a printer name in a printer settings file. and plot set attributes (Plot Set ID. For example. and a rotation of 90 degrees for all IPLOT data. Project ID. Account. Common settings include printer name. Related Web Page. The settings in these sections apply to plots of the specific data type. These settings are stored as a separate section (Common section) in the settings file. You can specify common settings in default settings files. use particular scales. digital archive) in a settings file. Plot Level Settings Unlike common settings that apply to all plots in the plot set. archive name. PDF file. Common Settings Common settings apply to all plots in the plot set. Revision. Less typing and file selection is required in specifying the plotting parameters when you use settings files. such as printer name. Enforce drawing standards. IPLOT. For example. printer settings files. You can use settings files to: Store plotting parameters so that they can be easily reused. For most cases settings files get you closer to "one button plotting. Author. then those qualifiers (along with their values) can be placed into a default settings file that InterPlot automatically reads. Settings files can reduce the need to navigate through dialog boxes entirely. or pen tables. Establish settings that pertain to the entire plot set. 3-1 . plot level settings apply to individual plots within the plot set. Eliminate typographical errors. Assist novice users. and user-defined attributes)." Settings files consist of settings that apply to an entire plot set (Common Settings) and settings that apply to individual plots within the plot set (Plot Level Settings). if you always plot at a particular size with a specific color table and pen table.What are Settings Files? Settings files provide an easy and flexible way of defining default plotting values for your plots and plot sets. raster.

you must name the settings file IPLOT. You can change this behavior and search multiple levels of default and printer settings files. you can set the configuration variable IP_APPLY_ALL_SETTINGS to TRUE. InterPlot searches the directories specified by the configuration variable IP_SETTINGS_PATH for default and printer settings files. Once it finds the first occurrence of the settings file. You can create a printer settings file for each printer and use the color table qualifier to specify a different color table for each printer. The default value for this configuration variable is FALSE. you must separate each directory with a semicolon. or command line interfaces. The configuration variable IP_APPLY_ALL_SETTINGS allows you to set up multiple levels of default settings files. some users may want to have company-wide default settings files which can be overridden on a per-user or per-site basis. which defines the parameters related to a specific printer. Each of the InterPlot plotting interfaces provides a method for manually applying a settings file. For example. InterPlot searches for a printer settings file. Organizer. Default Settings Files Introduction With InterPlot. you can change it. By default. To do this. InterPlot searches for a printer settings file with the same name as the printer and with a . you can create a default settings file which stores plot parameters that will be applied automatically each time you create plots using the dialog. but you must take additional steps to use manually-applied settings files. When this configuration variable is set to TRUE.SET. InterPlot finds the first occurrence of a default or printer settings file and does not search any of the remaining directories in the settings file search path. as described below. 3-2 . InterPlot does not search any of the remaining directories for the file. all of the default settings files found in the search path are read and applied.SET when you use the color printer.Types of Settings Files InterPlot Client and InterPlot Professional provide support for three types of settings files: Default Settings Files Printer Settings Files Manually-applied Settings Files InterPlot automatically applies default and printer settings files. To specify a list of directories in the settings file search path. suppose that you have a printer named COLOR that connects to a color plotter and a printer named MONO that connects to a monochrome plotter. (Use Organizer’s Edit -> Configuration -> Common feature or the configure utility located on the InterPlot Utilities program folder to change the value of the configuration variable IP_DEFAULT_SETTINGS. Applying Multiple Settings By default. For example. The default settings file name is defined by the configuration variable IP_DEFAULT_SETTINGS.SET extension appended to it.) Changing the Settings File Search Path The directory locations for default and printer settings files can be changed. Printer Settings Files When you select a printer. Using the previous example. InterPlot looks for a printer settings file named COLOR. Changing the Name of the Default Settings File If you want to name the default settings file something other than IPLOT.SET and put it in one of three directories: Your home directory (which allows "per user" defaults on machines with shared user accounts) The directory containing the drawing file or design file (which allows the same settings to be used for all of the files in the given directory) The SETTINGS subdirectory of the product directory (which allows "per machine" defaults) Both the name of the default settings file and the directory locations can be changed. You can edit the configuration variable IP_SETTINGS_PATH using the same methods described above for editing default settings files.

SET. you can store groups of commonly used qualifiers (along with their values) in a file and then reference them on demand. it does not search any of the remaining directories for the file. the dialog box. all of the printer settings files found in the search path are read and applied. Note When you name a settings files that you want to load manually. Manually-applied Settings Files Although InterPlot uses settings files automatically. For this type of printer \\SERVER\HPDJET (Remote Windows NT) HP2500 (Local printer) Use this settings file name HPDJET. Note A printer settings file can contain any setting except for printer name. Once InterPlot finds the first occurrence of PRINTER_NAME. unless the configuration variable IP_APPLY_ALL_SETTINGS is set to TRUE. When this configuration variable is set to TRUE. you can manually load specific settings files by using Organizer. or the command line.SET HP2500. use a name other than the name specified with the IP_DEFAULT_SETTINGS configuration variable.SET InterPlot searches for printer settings files exactly as it does for default settings files. InterPlot automatically searches for and loads the filename specified with this variable. 3-3 . The configuration variable IP_APPLY_ALL_SETTINGS does not apply to manually-applied settings files. By manually applying settings files. This method of referencing settings files is helpful when a group of plotting parameters is used only for a specific project or on an occasional basis.The following table lists examples of various types of printers along with their associated settings file. The default value for this configuration variable is FALSE.

select a section from the Sections to create list. it will be written as a binary file. select a settings file. 9 To exit the Create Settings dialog box. 6 To add additional sections. Specify the name of the settings file. and then click Save. a message appears informing you that if you edit and save the ASCII file. click Save As. 3 Click the Edit Section button to access the properties sheet. select Edit -> Settings File -> Edit. and drop it on the item 5 To exit the Create Settings property sheet. click OK. (This step is optional. 2 On the Select a Settings File dialog box. 8 To save the settings file. Note Settings files created or edited with this editor are not saved as text files and are not compatible with InterPlot products prior to version 9. Note Only data type support that is installed will display in this dialog box. Note If you select an ASCII settings file.) This removes the section entry from the Sections created list and adds it to the Sections to create list. Common settings include printer name. at the top of the Create Settings property sheet. archive name.) 7 To remove a section from the settings file. and plot set attributes.0. repeat steps 2-5. and then click Open. (This step is optional. click you want help on. Only APLOT and IPLOT data types support ASCII settings files. select Edit -> Settings File -> Create. Using Organizer to Create Settings Files To create a settings file: 1 From the Organizer menu bar. Using Organizer to Edit Settings Files To edit a settings file: 1 From the Organizer menu bar. This removes the section entry from the Sections to create list and adds it to the Sections created list. select the section from the Sections created list and click the Delete Section button. rendering attributes filename. If you choose to edit the ASCII settings file. 4 From the Create Settings property sheet. and then click the Create Section button. contains a settings file editor that enables you to create and edit settings files. Organizer displays the existing sections in the Sections present in file list box. specify the settings you want. To get help on a specific item. you must select the data type that you want the qualifiers in the settings file to apply to. 2 On the Create Settings File dialog box. The Common section enables you to specify common settings.Creating and Editing Settings Files The InterPlot Organizer interface. click Close. which is a standard component of both InterPlot Client and InterPlot Professional. 3-4 .

click Save. (This step is optional.) This removes the section entry from the Sections present in file list and adds it to the Sections to add list. and drop it on the item 5 To exit the Modify Settings property sheet. and the APLOT qualifiers are rejected. and then click Close. Both default and/or printer settings files are applied to IPLOT data in Organizer. 4 On the Modify Settings property sheets. 7 To save the settings file. click the Add Section button. and then click the Edit Section button. but there are some limitations. click OK. select the section from the Sections present in file list. The maximum length of any line in a settings file is 1024 characters.0. at the top of the Create Settings property sheet. specify the settings you want to change. 3-5 . though the command line interface requires it. 6 To remove a section from the settings file.) If both APLOT and IPLOT components are installed. To add an additional section. One additional setting you can not use in a printer settings file is -printer. select the section from the Sections present in file list and click the Delete Section button. click you want help on. (No support for Common settings or settings files containing multiple data types as with binary settings files. The leading dash (-) character is optional when used in a settings file. Note You can use any setting in an settings file except for the -settings qualifier. the qualifiers are interpreted as IPLOT qualifiers. and then click the Edit Section button.3 To edit an existing section. Note Settings files created or edited with this editor are not saved as text files and are not compatible with InterPlot products prior to version 9. Creating Settings Files as Text Files You can still create settings files as text files and use them with the InterPlot Client/Professional software. The limitations are: All settings in the file apply to either IPLOT or APLOT data. To get help on a specific item. ASCII settings files are Text files that contain Create and Modify command line qualifiers. select the section from the Sections to add list. The format of the settings file is one qualifier per line (along with its associated value).

use the Edit -> Settings File -> Apply command to apply a settings file. Refer to Organizer’s Help Topics for details on using the Apply Settings command. 3-6 . and then click Select Settings to display the Select Settings File dialog box. The -settings qualifier specifies the name of the settings file. or you can apply a settings file to one or more plots using the Organizer and command line interfaces. select the File command. When you use the -settings qualifier. the contents of the referenced settings file are inserted into the beginning of the command line. To apply a settings file: With Organizer.Applying Settings Files You can apply a settings file to a single plot using the dialog box. You can select this command from Organizer’s Edit menu or by right-clicking the selection. With the IPLOT dialog box. use the File -> Select Settings command to apply a settings file. With the command line. This enables qualifiers specified on the command line to override those specified in the settings file. With the APLOT dialog box. you can manually apply a settings file while using the Create or Modify command with the -settings qualifier. then clicking Apply Settings on the shortcut menu.

and command line interfaces: Any plotting parameters specified in the dialog. The default value for this configuration variable is FALSE.Settings Files Priorities To ensure that you have an opportunity to override any settings file defaults. InterPlot would use the Scale value. duplicate or mutually exclusive parameters in the printer settings file override those in the default settings file. InterPlot always processes settings files and any specified qualifiers in a particular order. If the loaded settings file contained Xsize. because using one of them would alter the value of the other. For example. When this variable is set to FALSE. The following priority issues are applicable to the dialog. then the value of the qualifier from the settings file is ignored. If both a default and printer settings file exist. Mutually exclusive qualifiers are qualifiers that are not intended to be specified together. and Scale was then specified. 3-7 . all of the default and printer settings files found in the search path will be read and applied. only the first occurrence of a default and printer settings file will be read and applied. Mutually exclusive qualifiers that may appear in subsequent default or printer settings files override the same qualifiers that appear in previous default or printer settings files. This situation could occur if a default settings file (defined by the IP_DEFAULT_SETTINGS configuration file variable) is used and contains a reference to a printer that has a printer settings file associated with it. If you use the -settings qualifier with the Create or Modify commands and a default or printer settings file exists. or in the command line interface after a settings file has been loaded always override any duplicate or mutually exclusive qualifiers that may have appeared in the loaded settings file. Organizer. Xsize and Scale are mutually exclusive qualifiers. Organizer. When the configuration variable IP_APPLY_ALL_SETTINGS is set to TRUE. any qualifiers in the file referenced by the -settings qualifier will override any duplicate or mutually exclusive qualifiers that InterPlot read from the default or printer settings file. InterPlot does not search any of the remaining directories for the file. The following priority issues are applicable only to the command line: If you use a qualifier and a settings file that contain the same or mutually exclusive qualifiers in the same command line.

set IPLOT_SETTINGS_PATH=$HOME. The setup program will then delete obsolete settings file configuration variables and their descriptions from both IPLOT.n:\site. all files that are not configuration files will be overwritten with the new versions.CFG and APLOT.$IPLOT_MASTER_DIR. suppose IPLOT 8 was installed in C:\Program Files\IPLOT. $APLOT_MASTER_DIR.$IPLOT_MASTER_DIR.CFG.CFG.SET will be the default settings file.Upgrade Issues When you upgrade to InterPlot Client or InterPlot Professional from IPLOT 8 or APLOT Professional. The configuration files will remain. This means that IP_DEFAULT_SETTINGS will be IPLOT. The default values for these configuration variables are: IPLOT_DEFAULT_SETTINGS=iplot. In the case of IPLOT 8.n:\site. and put them into the IP. the IP. but will be modified.SET for this computer.\Program Files\iplot\settings. IPLOT. IP_DEFAULT_SETTINGS will be set to APLOT. 3-8 .CFG file and retrieve the values for the default settings file and the settings file search path. If a system has both APLOT and IPLOT installed.CFG as follows: IPLOT_SETTINGS_PATH=c:\joe.set After installing InterPlot Client or InterPlot Professional. the setup program will open the old IPLOT.CFG file.$HOME.set If APLOT Professional is the only installed component. then similar changes will be done for APLOT. For example.SET.$IP_PRODUCT_DIR\settings IP_DEFAULT_SETTINGS=iplot.$IPLOT_PRODUCT_DIR\settings IPLOT_DEFAULT_SETTINGS=iplot.CFG would contain the following settings: IP_SETTINGS_PATH=c:\joe.$IPLOT_PRODUCT_DIR\SETTINGS These values will be written to the configuration file IP. and the user had edited IPLOT. which is located in the CONFIG subdirectory of the InterPlot Client or InterPlot Professional product directory. In this case.

C H A P T E R 4 Plot Resymbolization .

InterPlot for MicroStation .

4-1 . width. Controlling the order in which elements are plotted. design files and reference files are plotted as they display on the screen. or line style that stands out. Omitting specific elements from the plot. Defining custom line styles.What are Pen Tables? Note Throughout this section the term IPLOT refers to the IPLOT component of InterPlot. or line style. For example. color. By default. Obtaining consistent colors on various plotters with the use of color tables and libraries. Substituting the current date for a specified text string. you might want to highlight the elements on a particular level by assigning them a width. Area-filling closed elements with a specified color or pattern. Changing the appearance of elements on a plot is called resymbolization. Pen tables enable you to alter the appearance of a design file when it is plotted. Some common uses for resymbolization include the following: Highlighting specific elements by changing their color.

If level symbology is enabled for the design or reference file you are plotting. The first method involves searching for a specific text string element in the file and replacing it with another string.Using IPLOT Pen Tables Pen tables enable you to alter the appearance of a design file when it is plotted. The following pen table highlights the drawing sheet. The pen table overrides any other display attributes enabled for the file. ! ! If the current element is a text element. ensuring that the text is always visible. For example. the design file’s actual name and the current date replace the text strings $DGNFILENAME$ and mmddyy. substitute an ! automatically-generated string for it. IPLOT applies the level symbology before executing the pen table. the design file used to generate the plot and the date the plot was created are used to label the plot. For example. respectively. respectively. an architect may want to change the color and line width of a particular area of a floor plan to highlight a specific area. you can write a pen table that checks the element to see if it is on a particular level and resymbolizes the element’s display attributes if it is on the specified level. text can be assigned a higher priority than filled polygons. For example. If it does. and furniture (Level 15) by plotting it in pure 4-2 . HISTORY 01/20/93 (INGR) Initial creation. see if ! it contains one of the special place-holder ! strings. In this specific case. The following pen tables demonstrate two techniques commonly used in resymbolizing a design file. Thus.pen ! ! DESCRIPTION ! Pen table to substitute the design filename and ! the current date for the strings ! $DGNFILENAME$ and mmddyy. even if the area_fill display attribute is disabled. elements filled by the pen table always plot filled. the sheet border (Level 1). Example 2: ! ! ! ! ! ! ! ! ! ! ! NAME screen.pen DESCRIPTION This pen table demonstrates screening. Highlight all text. ! ! HISTORY ! 01/20/93 (INGR) Initial creation. if (type == text) then if (characters == ’$DGNFILENAME$’) then characters = ip_design else if (characters == ’mmddyy’) then characters = date endif endif The second method involves de-emphasizing or screening certain elements by plotting them in a light gray color. and furniture on level 15 by screening all other elements. A pen table modifies an element’s attributes if it meets certain criteria. How a Pen Table Works The pen table resymbolizes elements from the design file as they are processed by the metafile interpreter. For example. Another user might want to area-fill polygons on the plot and assign priorities to the various elements to control the order in which they are plotted. text. Example 1: ! NAME ! txtsubst.

G=200. 0.in. R=200. 1. black else color = (200. 15) || (type == text)) then color = (0. B=0 is pure priority = 100 . B=200 is weight = 4 . light gray priority = 10 endif 4-3 . ! if ((level . 0) . 200) . 200. G=0. R=0.! black on top of all other elements. Screen ! (de-emphasize) all other elements by plotting ! them with a gray dither (halftone) pattern.

however. 0.5 .255) and black as (0. Statements and Keywords Pen tables contain two types of statements and keywords: assignment and comparison. You can specify white as (255. Data Types Each pen table keyword requires a value. constants. 0) red 4-4 . When used in an expression. The color of an element can be set using an integer. and line style definitions. Statements consist of combinations of keywords. operators.0 Strings — A string constant is a sequence of zero or more characters enclosed in quotes.0).0. You can use either single or double quotes. Integers — An integer is a series of one or more digits that can be preceded by a minus sign. For example. but the opening and closing quote must be the same type. RGB colors. It is specified as a triplet of integers in the range 0 to 255. Comparison statements test a single element attribute against a specified condition. You can use six types of data to specify a value: working units. integers. respectively. real numbers. Examples: ’$DGNFILENAME$’ "green. Refer to your MicroStation documentation for information on working units. Examples: 7 144 -32 Real Numbers — A real number is a series of one or more digits that can include a decimal point.75 -12. The type of statement depends on the type of keyword it contains. green. These keywords are grouped into assignment keywords and comparison keywords because they are either used to assign new attributes to an element or to compare an element’s existing attributes to values specified in the pen table. if you change an element’s style at the beginning of the pen table with an assignment keyword.14 0. The pen table language includes a set of predefined keywords. and blue intensities. None of the pen table components are case sensitive. The data type of a keyword depends on how it is used within a statement in the pen table.255. If a keyword is assigned a new value. a statement that contains a comparison keyword is a comparison statement. then assignment statements modify elements by changing the element’s attributes. then that attribute is evaluated later in the table by its new value instead of its original value.IPLOT Pen Table Language A pen table is composed of statements. The integers represent red. its data type might be a string or an integer. its data type might be limited to an integer. Examples: 3. Real numbers can be preceded by a minus sign. strings. then the element’s style is later evaluated with a comparison keyword with the new style. and expressions. Working Units — MicroStation working units. medium forest" RGB Colors — An RGB data type represents a color. or RGB value but can only be compared to the integer value. string. In other words. If you change an element’s attribute early in the pen table. If the attribute meets that condition. Examples: (255. 180.

255) (0.5) Constants Several constants are defined for the various data types to make writing and understanding pen tables easier. 255) (200. false or .5. 0. The constants can be used in their long or abbreviated form. off_transition.) You can specify any number of on/off transitions as long as. 0) (255.. weight_base.. flash. and line style.(0. a space of 1. 200) (100. centimeters (cm) millimeters (mm) meters inches feet (ft) Line Joint/Endcap Constants — The midline_joint and endcap keywords can be assigned a value using the following constants: butt circle Class Constants — The class constants enable you to modify or compare against the class keyword. 1.) can be used.false. 100) green blue yellow magenta cyan light gray dark gray Line style definitions — Line style definitions are defined by pairs of on/off transitions in the following format: (on_transition. there is a corresponding off transition. 1. Boolean Constants — Constants have been defined as true and false for use with keywords such as area_fill. primary 4-5 . 200. 0. The Boolean constants are: true or . 255) (255. weight_delta. Element Constants — The element constants can be used in comparison expressions with the type keyword.true.5 mm. for every on transition.5. 0) (0. 1. 0. For example. 255.true.5 mm space. and the properties keywords. a 5 mm dash followed by a 1.. true or . The classes of constants described in the following section have been defined for use with specific keywords. The element constants are: arc line assoc_dim line_string bspline_curve multiline bspline_surface shape cell shared_cell complex_shape solid connected_string surface curve text ellipse text_node Units Constants — The units constants can be used for setting the units keyword to specify the dimension for distance keywords such as thickness. Example: (1.5. 255. 255. if you specify in the pen table that the units are millimeters (mm). ignore.5 indicates a dash 3 mm long. 5. The transitions can be integer or real values and specify a distance in user-defined units. the line style definition 3. 100. 1. Note Either form of the constant (for example.

A relational expression takes the following form: operand1 relational_operator operand2 With one exception. or <> . These operators and expressions enable you to compare values of keywords with other keywords and constant expressions. . GT . If one operand is an integer and the other operand is a real number. or < Examples: Result true if operand1 and operand2 are equal true if operand1 and operand2 are not equal true if operand1 is greater than or equal to operand2 true if operand1 is less than or equal to operand2 true only if operand1 is greater than operand2 true only if operand1 is less than operand2 4-6 . The following list describes the relational operators. Relational Operators Relational operators provide a way to test two values to determine if they are equal or not. or <= . Similarly. "*PLUMB*" matches any string that contains the substring PLUMB. For example. These operators are categorized as relational operators.LT. the integer value is converted to a real number before the comparison is made. the string "ELEC*" matches any string that begins with the characters ELEC.LE. EQ . All of the relational operators require two operands.GT.EQ. attributes hole locked modified new_element nonplanar nonsnappable screen_relative Operators and Expressions The pen table language provides five types of operators and expressions. LE . The result of a relational expression is a value of true if the condition is satisfied and false if the condition is not satisfied. . logical operators. or > . .GE. it disables the special meaning of the asterisk (*) and question mark (?) characters. list operators. . GE . In other words. or if one is less than or greater than the other. or >= . only operands of the same data type can be compared with one another. . LT . arithmetic operators. or == . The following characters have a special meaning in comparisons with string keywords: Character * ? \ Function matches zero or more occurrences of any character matches exactly one occurrence of any character indicates that the next character is to be treated as an actual character and not as a special character. . and to build arithmetic expressions. and the string concatenation operator. Wildcards can be used in string comparisons of equality or inequality.pattern_component construction dimension primary_rule linear_pattern construction_rule Properties Constants — The properties constants are used with the properties keyword to determine if bits in the properties word of the element are set. to test for membership in a list. as well as some example relational expressions: Operator .NE. NE .

7) (cellname == "PLAN*") (thickness > 0.AND. Evaluates to false if and only if both operands are false. Otherwise it evaluates to false. The result of an arithmetic expression is either an integer. .(color == 5) (level . 23.) requires only a single operand. Evaluates to true if either operand is true. 23. Evaluates to false if the operand is true. and 45 to red. (type . A consecutive range of numbers can be indicated with the following notation. if you wanted to change the color of every element on levels 15. . can also be included in a list of strings. AND .AND. For example. The logical_not operator (.5) Logical Expressions Logical expressions are compound relational expressions formed by combining simple relational expressions with logical operators. you cannot mix numbers and strings. 15) . or || . 4-7 . Evaluates to true if the single operand is false. Also.NOT. 15. The logical_and operator (AND. you could use the . Examples: ((type == line) || (type == line_string)) ((level . 45) then color = "red" endif There is also the . If an integer operand and a real number operand are used in the same expression. Negative operator + Addition operator Subtraction operator * Multiplication operator / Division operator Examples: -10 thickness * 2 color + 1 (size + 1. both operands of a list operator must be the same type. or a real number if any one of the operands is a real.NI. or && .OR. (in the list of) operator and the list expression shown below. Although integers and real numbers can exist together within a list.(color == 5)) Arithmetic Expressions The pen table language also has the standard arithmetic operators that enable you to create arithmetic expressions. A keyword whose value is a string. The following are the arithmetic operators and some examples of arithmetic expressions.NE.AND. All these operators are binary (except minus which is both binary and unary) and take integers and real numbers as operands. (not in the list of) operator for determining if a value is not in the list.IN.0)/2 List Expressions List expressions are used to determine if a string or number is in a specified list. the integer is first converted to a real number and then the operation is performed.NOT. or &&) and the logical_or operator (OR. . if (level .ne. such as cellname.OR. text)) (.eq. or ||) are both binary operators. Operator .NOT. or NOT Result Evaluates to true if and only if both operands are true. The following list contains descriptions of each of the logical operators and some example logical expressions.in. if all the operands are integers. . Both operands must be simple relational expressions or logical expressions that evaluate to true or false. OR .

If either number is a real. 48-53 color . GT> . 8. Examples: Expression ’A’ + ’B’ + ’C’ + ’D’ "A" + "Z" + "1" ’Con’ + "cat" Operator Precedence You can combine all of the operators described above to form complex expressions. For example. In some cases. This comment begins with the ’#’. NOT /* +. cell. 16. text_node.NI. LE< = .GE. Parentheses also make the pen table program easier to understand. IN . Below are examples of valid 4-8 . NE <> . the expression color + 3 * 5 is ambiguous. Examples: type . The following list contains operators in order of precedence from highest to lowest.OR. ’!’. any number greater than or equal to number1 and less than or equal to number2 is included in the list.GT. 1. The operator is the same as the arithmetic addition operator. and operators which enable you to resymbolize your design file.NE. 30-39 String Concatenation Operator The string concatenation operator (+) enables strings to be added together to form a single string. GE > = .number1 .NOT. NI . connected_string. It could be interpreted as (color + 3) * 5 OR color + (3 * 5) To resolve this ambiguity. AND && It is generally a good practice to use parentheses with expressions that can be ambiguous instead of depending on precedence rules. There is also a Stop statement that enables you to terminate the processing of an element in the pen table. all integers in the range of number1 to number2 are part of the list.number2 This construct specifies that if number1 and number2 are both integers. Operators of the same precedence are evaluated from left to right. The different types of statements provided by the pen table language use the supported keywords. . LT< .IN. each operator has a relative precedence. The expressions below are examples of valid list expressions. complex_shape level .IN. When there are no parentheses to directly indicate the order of evaluation. or ’. different results can be obtained depending on the order of evaluation of the expression. They do not impact the operation of the pen table. Result ’ABCD’ ’AZ1’ ’Concat’ Statements A pen table program is made up of a series of statements. Comments The most basic statement of the pen table language is the comment.EQ. OR || . EQ == . but strings and numbers cannot be used together within a single expression using the ’+’ operator.LE. 5-10. operators with a higher precedence are evaluated before an operator of lower precedence. 12.NI. Comments are used to improve a pen table’s readability and to document its operation.LT. expressions.’ character and continues to the end of the current line.AND.IN. Operators of the same precedence are listed on the same line.

0..comments within a pen table. or zero. The assignment statement has the form keyword = expression where keyword is any of the keywords listed in Assignment Keywords.5) color = "green" else if (level == 45) then style = (1. sky" else style = 0 color = (0.true.25) area_fill = true color = "blue. The following are example syntaxes: if (expression) then 1 or more statements endif OR if (expression) then 1 or more statements else 1 or more statements endif OR if(expression) then 1 or more statements else if (expression) then 1 or more statements else if . is executed. 0. The following examples are legal assignment statements: Examples: ignore = . if present.05 If-Then-Else-Endif Statements If-then-else-endif statements are used in pen tables to determine if an element has certain attributes and to control program flow based on the results. # This is a sample comment color = "red" . 0) endif 4-9 .25. Any nonzero value is considered true. The data type of the expression must be compatible with the data type of the keyword.0. else 1 or more statements endif The expression portion of an if statement must evaluate to an integer and is typically true or false..5. 0. the else portion of the statement. 0. If the expression evaluates to false. assigning a string constant to an integer keyword is illegal. Example: if (level == 23) then style = (1. 0. For example. area_fill = false midline_joint = miter style = "dotted" thickness = weight * 0. This is also a comment Assignment Statements Assignment statements in the pen table are used to modify an element’s attributes. The following pen table segment makes use of the if-then-else-endif construct.

. When the stop statement is executed. and so forth) must be constants.. The values (for example. value1. Any modifications to the element before the stop statement are performed. Example: if (type == ellipse) then color = 4 stop endif 4-10 . The following are two examples of the switch statement: Example 1: switch (level) case 20 ? color = "blue" thickness = 0. constant expressions. value2. The syntax for the switch statement is as follows: switch (expression) case value1 ? 1 or more statements case value2 ? 1 or more statements . If the expression and a value are equivalent or if the expression is in the range of the value.Switch Statements The switch statement is similar to the if-then-else-endif statement in that it enables you to control the flow of the pen table program based on an element’s attributes. The optional default case is executed if the expression does not match any of the case values.5 default ? thickness = 0.3 endswitch Example 2: switch (weight) case 0-5 ? thickness = 0.25 case 30-40 ? color = "red" thickness = 0. the pen table stops processing the current element as if IPLOT reached the end of the pen table. the statements following the case statement up to the next case are executed.75 endswitch Stop The stop statement is used to improve the speed of pen table execution by enabling the system to avoid unnecessary comparisons. default ? 1 or more statements endswitch The switch expression is evaluated and successively compared against the values associated with the case keyword.25 case 6-10 ? thickness = 0. or a numeric range.

penck will output an error message identifying each error and the line number where the error occurred. 4-11 . The syntax for ths utility is: penck pen_table If there are any syntax errors.IPLOT PENCK Utility The penck utility allows you to check a pen table for syntax errors before generating a metafile.

! Do not alter elements that are not filled. ellipse. arc. In this case.0 to 360. and an example of how to use the keyword.IPLOT Comparison Keywords The following keyword descriptions include a brief description of the keyword function. the types of elements the keyword affects (if applicable). Note To find the name of the innermost cell name. text node. the valid data type(s) (if applicable). Wildcards can be used in string comparisons of equality or inequality.0)) then color = 2 endif area_fill The area_fill keyword checks to see if the current element is filled. Data Type: constant (true or false) Example: ! ! Change the fill color of all filled elements. the angle value is 0. ! if ((type == text) and (angle == 90. the cellname keyword is the name of the nested cell. For other element types.0 Example: ! ! Change the color of text elements rotated 90 ! degrees. use the nested_cellname keyword. and text. the value for cellname is "NO_CELL". ! if (area_fill == true) then fill_color = 10 endif cellname The cellname keyword specifies the name of the cell if the current element is a cell header or a component of a cell. For components nested within one or more cells. If the current element is not a cell header or is not a component of a cell. angle envr_value size area_fill file style cellname font tag_character characters font_name tag_display class header_type tag_integer cls_end_width ip_scale_num tag_real cls_name ip_xsize_num text_node_number cls_origin_width ip_ysize_num type cls_scale level weight cls_shift_distance lname width cls_shift_fraction nested_cellname color properties angle The angle keyword specifies the angle for element types cell. the cellname keyword specifies the name of the outermost cell unless the component is a nested cell header.0. Data Type: real number in the range of 0. Data Type: string containing up to 6 characters Example: ! 4-12 .

Wildcards can be used in string comparisons of equality or inequality. ! if ((type == text) and (characters ==’*School*’)) then color = (0." ! if (cellname == "border") then color = (200. or one of the following constants: 0 primary 1 pattern_component 2 construction 3 dimension 4 primary_rule 5 linear_pattern 6 construction_rule Example: ! !Do not plot pattern and dimension class elements. Data Type: integer in the range from 0 to 6. in master design file units. ! if ((lname=="border") and (characters=="preliminary")) then ignore_element=true endif class The class keyword specifies the class type of the current element.! Change the color of all components of the cell ! named "border.0.255) else if ((type == text) and (characters ==’*Hospital*’)) then color = (255.200. Data Type: string Example 1: ! !Highlight any text strings that contain the string !’School’ or ’Hospital’.0. the class of the current element might be used in a pen table to determine if the current element is part of a dimension or pattern. of the MicroStation custom line style associated with the current element.0. the cls_end_width is 0. ! if ((class == pattern_component) or (class == dimension)) then ignore_element = true endif cls_end_width The cls_end_width keyword tests the ending width. For example. If the current element does not have an associated custom line style.200) endif characters The characters keyword specifies the string contained in the element if the current element is a text element.0) endif Example 2: ! !Removes the text "preliminary" if it appears in !"border" file. Data Type: real number 4-13 .

If the current element does not have an associated custom line style." Data Type: string Example: ! ! Change the color of all elements using the style. of the MicroStation custom line style associated with the current element. ! Assign the "origin" custom line style to all ! other elements. (cls_origin_width > 2.0. ! if (cls_name == ’{ Diamond }’) then color = 2 else cls_name = "origin" endif cls_origin_width The cls_origin_width keyword tests the starting width.0) then color = 5 endif cls_name The cls_name keyword tests the name of the MicroStation custom line style associated with the current element. in master design file units. (cls_scale == 2. the cls_origin_width is 0.0) then color = 5 endif cls_shift_distance 4-14 . Data Type: real number Example: ! ! ! ! ! if Change the color of all elements using a MicroStation custom line style whose scale is 2.0) then color = 5 endif cls_scale The cls_scale keyword tests the scale factor applied to the MicroStation custom line style associated with the current element. the cls_scale is 1. (cls_end_width > 2. Data Type: real number Example: ! ! ! ! ! ! if Change the color of all elements using a MicroStation custom line style whose starting width is greater than 2 master design units.0. the cls_name is "NONE.Example: ! ! ! ! ! if Change the color of all elements using a MicroStation custom line style whose ending width is greater than 2 master design units. If the current element does not have an associated custom line style. For elements without an associated custom line style.

Data Type: real number Example: ! ! ! ! ! if Change the color of all elements using a MicroStation custom line style whose shift distance is 0.0.5 master design units.The cls_shift_distance keyword tests the shift distance. If the current element does not have an associated custom line style. change the text !value to a blank string. ! if ((color == 1) and (type == shape)) then area_fill = true endif envr_value The envr_value keyword is used to compare the value of an IPARM environment variable which is chosen by setting the envr_variable assignment keyword. the cls_shift_fraction is 0. ! envr_variable = "ARCHITECT" 4-15 .25) then color = 5 endif color The color keyword indicates the color index of the current element. (cls_shift_fraction == 0. If the variable has not been set or is not a valid variable.25 as shown by MicroStation’s Line Style dialog. Data Type: integer in the range from 0 to 255 Example: ! ! Area fill shapes with a color index of 1. If the current element does not have an associated custom line style. envr_value is set to a zero-length string.0." Otherwise. (cls_shift_distance == 0. in master design file units. the cls_shift_distance is 0. applied to the MicroStation custom line style associated with the current element. Data Type: string Example: ! !Get the value of the IPARM environment variable !ARCHITECT. Data Type: real number Example: ! ! ! ! ! ! if Change the color of all elements using a MicroStation custom line style whose shift fraction is 0. Find text element with characters !equal to "$Architect$" and change the text value !to "Designed by <name>" if ARCHITECT is equal to !"Owner1" or "Owner2.5) then color = 5 endif cls_shift_fraction The cls_shift_fraction keyword tests the shift fraction applied to the MicroStation custom line style associated with the current element.

the value of the header_type keyword is the same as the element’s type. the font keyword contains the font number for the current element. If the current element is not part of a complex element. the master file is attachment number 0. the font_name contains the font name for the current element. It also determines the type of elements such as multilines and associative dimensions that are logically composed of simpler elements. Generating a metafile from the command line prints the filename and its attachment number for each reference file.if((type ==text)and(characters == "$ARCHITECT$")) then if (envr_value .IN. the font name is "NO_FONT_NAME. Data Type: integers that correspond to valid element types or one of the following constants: assoc_dim (type 33) cell (type 2) complex_shape (type 14) connected_string (type 12) 4-16 . ! if ((type == text) and (font == 10)) then ignore_element = true endif font_name For text and text nodes. Data Type: integer in the range from 0 to 255 Example: ! ! If the current element is in the master file ! (index of 0). change its color to 2. "Owner1". ! if (file == 0) then color = 2 endif font For text and text nodes." Data Type: String Example: ! ! Change the color of all text elements ! using the "architectural" font. "Owner2") then characters = "Designed by " + envr_value else characters = "" endif endif file The file keyword specifies the file attachment number for the file being processed. Data Type: integer in the range from 0 to 255 Example: ! ! Do not plot text elements that use font 10. if ((type == text) and (font_name == ’architectural’)) then color = ’gray’ endif header_type The header_type keyword determines the outermost complex header type for elements that are components of a complex element. Typically. For elements other than text and text nodes. For elements other than text and text nodes. the font number is zero.

! change its weight to 2. if (header_type == assoc_dim) then if (type == line) then weight = 3 endif endif ip_scale_num The ip_scale_num keyword gets the IPARM scale as a number. Data Type: real number Example: ! ! Plot line thickness based on the IPARM scale.multiline shared_cell solid surface text_node Example 1: (type 36) (type 35) (type 19) (type 18) (type 7) ! ! If the current element is a component of a cell. Data Type: real number Example: ! ! Plot line thickness based on the IPARM xsize. ! leaving the text unchanged.02 else !small drawing use thinner lines thickness = (weight +1) * .01 endif ip_xsize_num The ip_xsize_num keyword gets the IPARM xsize as a number. Data Type: real number 4-17 . ! if (ip_xsize_num > 17) then !large drawing use thick lines thickness = (weight +1) * . ! if (ip_scale_num > 250) then !large drawing use thick lines thickness = (weight +1) * .02 else !small drawing use thinner lines thickness = (weight +1) * .01 endif ip_ysize_num The ip_ysize_num keyword gets the IPARM ysize as a number. ! if (header_type == cell) then weight = 2 endif Example 2: ! Change the weight of the ! lines in a dimension element.

For components nested within one or more cells. Elements in the master file and other reference files will not be changed. Note To find the name of the outermost cell name. If the current element is not a cell header or is not a component of a cell.Example: ! ! Plot line thickness based on the IPARM ysize." ! if (nested_cellname == ’FRAME’) then weight = 3 4-18 . the lname keyword evaluates to an empty string (""). Data Type: string Example: ! ! ! ! ! ! ! if Change the weight of all elements in the reference file with the logical name of "border" to be a weight of 2. the lname keyword contains the logical name of the reference file. the nested_cellname keyword specifies the name of the cell. use the cellname keyword. Data Type: integer in the range from 1 . Wildcards can be used in string comparisons of equality or inequality. ! if (level == 1) then color = 1 else if (level == 2) then color = 2 endif lname If the current element is in a reference file.02 else !small drawing use thinner lines thickness = (weight +1) * .63 Example: ! ! Set the color of the element based on its level. Wildcards can be used in string comparisons of equality or inequality.01 endif level The level keyword contains the level number of the current element. the nested_cellname keyword specifies the name of the innermost cell. ! if (ip_ysize_num > 17) then !large drawing use thick lines thickness = (weight +1) * . (lname == ’border’) then weight = 2 endif nested_cellname If the current element is a cell header or a component of a cell. the value for the nested_cellname keyword is "NO_CELL". Data Type: string that contains up to 6 characters Example: ! ! Change the weight of all components of the nested ! cell named "FRAME. If the current element is in the master file.

the style comparison keyword will not reflect this. Data Type: integer in the range from 0 to 7 Example: ! ! ! Change the color of any element not on level 1 4-19 . the size keyword is the height of the text string. if a named style or transitions have been used to set the style of an element. or Z range of the element. ! if ((type == text) and (size > 0:4:0)) then color = 3 endif style The style keyword contains the value of the current element’s line style. . ! if (properties == screen_relative) then ignore_element=true endif size For text elements. For example. Data Type: working units Example: ! ! ! Change the color of text elements whose height is ! greater than 4 subunits. Also. . then style will evaluate to the new style instead of the original style of the element. the size is the largest of the X. endif Data Type: one of the following constants: attributes hole locked modified new_element nonplanar nonsnappable screen_relative Example: ! ! Do not plot any element with the screen_relative ! bit set in the properties word. endif if(properties == hole) then . It will evaluate to the current style index. the following two relational expressions are equivalent: if(hole == true) then .endif properties The properties keyword provides two methods for determining if bits in the properties word of the element are set. . If the style has been set earlier in the pen table by the style keyword. . Y. For all other elements.

Tag_real tests the actual tag’s value. The following are brief descriptions. Data Type: integer Example 1: ! ! ! Change the color of text associated with a specific ! text node number." each ! containing a character tag named "City. Note that the tag name is still "City". tag_integer. ! "Home address" and "Work address. the TAG_CHARACTER keyword evaluates to "NO_TAG_CHARACTER"." ! ! Start by looking for "City" tags belonging to ! the "Home address" tag set. tag_set = ’Work address’ if (tag_char == ’Madison’) then color = 4 endif text_node_number The text_node_number comparison keyword can be used to test against the text node number of a text node complex element. Note Note The tag_character. and tag_real comparison keywords must be used with the tag_set and tag_name assignment keywords. Data Types: tag_character tag_display tag_integer tag_real Example: string constant (true or false) integer real number ! ! Assuming the design file uses two tag sets." ! change the color of all elements whose tags ! specify a home address of "Huntsville" or a ! work address of "Madison. Tag_integer tests the actual tag’s value. data types. ! tag_set = ’Home address’ tag_name = ’City’ if (tag_char == ’Huntsville’) then color = 4 endif ! Now look for tags in the "Work address" ! tag set.! that has a line style of 7. 4-20 . Tag_display checks to see if a particular type of tag is displayed. Tag_character tests the actual tag’s value. and examples of the tag keywords. If tag data is not attached to the current element. while TAG_INTEGER and TAG_REAL evaluate to NO_TAG_NUM. ! if ((level<>1) and (style == 7)) then color = 2 endif tag keywords The tag keywords check the tag data attached to the current element.

4.11) and (level == 1)) then color = 1 endif Note To test for multiline and associative dimensioning elements. and curves ! on level 1 ! ! if ((type in 3. use header_type instead of type. weight The weight keyword contains the value of the current element’s line weight. Data Type: integer in the range from 0 to 31 Example: ! ! ! Set color of element based upon its weight ! ! units = inches if (weight == 0) then color = 1 4-21 . linestrings. This sheet attribute can be used !as Digital Print Room attribute date. if (text_node_number eq 10) then envr_variable = "Author" envr_value = envr_value + " " + characters else if (text_node_number eq 11) then envr_variable = "Title" envr_value = envr_value + " " + characters endif type The type keyword determines the element type of the current element. Data Type: integers that correspond to valid element types. or one of the following constants: arc (type 16) line (type 3) assoc_dim(type 33) line_string (type 4) bspline_curve (type 27) multiline(type 36) bspline_surface(type 24) shape (type 6) cell (type 2) shared_cell (type 35) complex_shape (type 14) solid (type 19) connected_string (type 12) surface (type 18) curve (type 11) text (type 17) ellipse (type 15) text_node (type 7) Example: ! ! ! Change the color of lines.! ! if (text_node_number eq 46) then color = 3 endif Example 2: ! !This pen table sets a plot sheet attribute !based on the characters stored in a text node element !in the design file.

4. 3. ! units = inches if (type .16) then if (width == 0:0:050) then color = 1 else if (width == 0:0:100) then color = 2 else if (width == 0:0:150) then color = (30.15.50. arcs. arcs.100) else if (width == 0:0:200) then color = (100. ellipses. connected ! strings.0. and ellipses based on their width.0. All other elements and 3D elements have a width value of 0.0) endif endif 4-22 . Data Type: working units Example: ! ! Change the color of lines. linestrings. linestrings. The width value is extracted from the element’s Z low range field and specifies the element’s line width in working units as opposed to a weight value.12. and connected strings.else if (weight == color = 2 else if (weight == color = 3 else if (weight == color = 4 else if (weight == color = 5 else if (weight == color = 6 endif 1) then 2) then 3) then 4) then 5) then width The width keyword is valid only for 2D lines.0) else if (width > 0:0:300) then color = (0.in.

ellipses. and an example of how to use the keyword.B) (where RGB is in the range of 0 to 255) Example: ! ! Set boundary_color and boundary_display for ! shapes on level 7. and shapes. Syntax: boundary_color = integer (where integer is a color index in the range from 0 to 255) boundary_color = "string" (where string is a name from a color library) boundary_color = (R. ! if (type == shape) then area_fill = true endif boundary_color The boundary_color keyword is used to specify the boundary color of an area or pattern-filled polygon. the area_fill keyword plots closed elements as filled when set to true. The area_fill keyword can be used to plot elements that would otherwise plot filled as outlines. the types of elements the keyword affects (if applicable). area_fill envr_value screen_relative boundary_color envr_variable size boundary_display fill_color style case_sensitive font tag_name characters font_name tag_set class ignore_element thickness cls_end_width ip_logical_index translucent cls_name level translucent_fill cls_origin_width midline_joint units cls_scale pattern weight cls_shift_distance pattern_color weight_base cls_shift_fraction pen weight_delta color priority endcap scale area_fill For plotters that support polygon fill. Boundary_color only affects filled elements with boundary_display set to true. Syntax: area_fill = true area_fill = false Example: ! ! Area fill all shapes.IPLOT Assignment Keywords The following keyword descriptions include a brief description of the keyword function.G. the valid data type(s) (if applicable). complex shapes. Any closed element (except text) can be controlled with this keyword including closed b-spline curves. Setting the assignment keywords fill_color or pattern implies setting area_fill to true. ! 4-23 .

In addition to any arbitrary string. If the new string is longer. you can later substitute these strings with useful information such as the date the file was plotted or the design file name. Syntax: boundary_display = true boundary_display = false Example: ! ! Set boundary_color and boundary_display for ! shapes on level 7. The boundary_display keyword has no effect on elements that are not filled. Most of these keywords represent values from the IPARM file and you can use them to label a plot. By putting text elements in your design file to act as place holders. The default value is false. Syntax: case_sensitive = true case_sensitive = false Example: ! !Replace text. the original string expands to accommodate the extra characters. Some keywords require the ip_logical_index keyword to be set before being used. attrib. the envr_value keyword or any of the following keywords can be used to substitute a string in the current text element. If the new string is shorter than the original string. ! if ((type == shape) and (level == 7)) then area_fill = true color = ’blue’ boundary_display = true boundary_color = ’red’ endif case_sensitive The case_sensitive keyword determines whether the case of letters is important in string comparisons made using the characters comparison keyword. ! case_sensitive = true if (characters == "TITLE") then characters = "FIRST FLOOR DESIGN" else if (characters == "Title") then characters = "First Floor Design" endif characters The characters keyword enables you to replace the string in a text element with a new string. or mtext entity having !characters "TITLE" with all-caps title. Note Setting boundary_display to true for filled text may produce undesirable results.if ((type == shape) and (level == 7)) then area_fill = true color = ’blue’ boundary_display = true boundary_color = ’red’ endif boundary_display For elements that are filled in MicroStation or with the area_fill keyword in the pen table. it is padded with blanks. the boundary_display keyword specifies whether the boundary of a filled polygon is plotted. and !replace "Title" with first letter caps title. 4-24 .

the keyword value is NONE.00000) Design filename.FONT.10. (Example: 11) Hour number based on a 12 hour cycle.6]. (Example: 05) File specification of the master design file.3.54-64]) Mirror settings stored in the IPARM file. (Example: [[10.Keyword am_pm date day_abbreviation day_name day_number dgnspec hour hour_12 hour_24 ip_color_table ip_data_rescale ip_data_rescale_x ip_data_rescale_y ip_design ip_display ip_environment ip_fast ip_feature_table ip_fence ip_levels ip_mirror ip_nodisplay Value Time of day: am or pm. (Example: C:\IPLOT\MISC\COLOR.FTB) List of fence points in the IPARM file. (Example: BOTH) List of the view display attributes that 4-25 .[20.REF_CLIPPING. (Example: Fri) Full name of day. (Example: Friday) Day in numeric format.USER_ID]) The fast display attributes for the file specified by the ip_logical_index keyword. (Example: [PROJECT=civil. (Example: AM) Date the metafile was generated.[15. (Example: C:\MYPROJ\PLAN. the value of this keyword is NONE. (Example: [CELL.10. (Example: C:\PROJ\SECTION. (Example: [1-5.20. (Example: 1.DGN) Hour number the metafile was generated.5]. If no feature table is associated with the job.9.TEXT]) The name of the attached feature table.REV_NUM=3. (Example: 3. or OFF. Valid values are X.45.7. (Example: C:\MYPROJ\E1. (Example: 1. Y. (Example: 05-APR-1996) Three-character abbreviation of day. (Example: [CONSTRUCTION. DIMENSION.00000) Y value of data rescale.CTB) Data rescale value. ENTER_DATA]) Environment variables stored in the IPARM file.00000.5]]) List of levels that are set "on" in the file specified by the ip_logical_index keyword. BOTH. (Example: 17) Color table. (Example: 05) Hour number based on a 24 hour cycle.DGN) Display flags for the file attachment indicated by the keyword ip_logical_index. If you have not defined a fence.00000) X value of the data rescale.

(Example: FLOOR27.2. (Example: 1.200]) The name of the rendering attributes file associated with the plot job. (Example: hp4mv) Full file specification for the file specified by the ip_logical_index. (Example: C:\PROJ\FLOOR. (Example: COLORS. (Example: DECATUR. If no rendering attributes are specified. the value for this keyword is NONE. (Example: 2. qpr options specified as submit qualifiers but not stored in the IPARM file are not listed.2. (Example: [-me]) Queue name stored in the IPARM file.000000) List of qpr options stored in the IPARM file.500000.000000) Master file name without the directory name. (Example: 4.ip_nofast ip_origin ip_origin_x ip_origin_y ip_pen_table ip_plot_rescale ip_plot_rescale_x ip_plot_rescale_y ip_qpr_options ip_queue ip_ref_filename ip_region ip_rendering_attributes ip_rotation ip_scale ip_short_design ip_short_color_table ip_short_pen_table ip_short_feature_table are disabled for the file specified by the ip_logical_index keyword.PEN) Feature table name without directory. (Example: C:\PROJ\E5.000000) Name of the pen table associated with the plot job. (Example: [100.150.TEXT]) X and Y origin in the units specified by the ip_units keyword. If no pen table is attached.PEN) X and Y plot rescale values from the IPARM file.WIDTH]) List of fast view display attributes that are disabled for the file specified by the ip_logical_index keyword. (Example: [CAMERA. (Example: 3.FONT. (Example: STANDARD.000000) Y plot rescale value from the IPARM file.000000.POINTS.100. (Example: 1. the value for this keyword is NONE.FTB) 4-26 . (Example: 3.000000) X origin in the units specified by ip_units.DGN) Color table name without directory.000000) X plot rescale value from the IPARM file.DGN) The region specified in the IPARM file.000000:1.TBL) Pen table name without directory. (Example: 5. (Example: [CELL.RA) The rotation of the plot specified as an angle in degrees in the range from 0 to 360.500000) Y origin in the units specified by ip_units. (Example: C:\REND\HPSI.000000) The plot scale specified as a ratio of design units to plotter units. (Example: 45.

(Example: 59) Three-character abbreviation of month.0. (Example: 04) Sequence number of the plot in the document set while in Organizer. (Example: 5) Username of user who generated the 4-27 . (Example: 04/05/96) Time in short time format. (Example: 2) X. (Example: Friday.2000. (Example: 11:59) Year in two digit format.1000. (Example: 17) Date in numeric format. (Example: 09:47) Total number of plots in the document set while in Organizer. Y. (Example: 5-APR-1996 09:47) Time of metafile generation.2000.000000) Y size of the plot in the units specified by ip_units. and Z coordinates of the plot volume diagonal. (Example: Apr) Full name of month. (Example: 1) The name of the plot name inside Organizer. (Example: 96) System date and time metafile was generated. (Example: [1000.000000. (Example: 1:8) Units specified for values such as size and origin.RA) Filename without directory for the file specified by the ip_logical_index. (Example: 34.000000) Date in long character format. (Example: border) Second number. April 05. 1996) Time the metafile was generated in long time format. 44. (Example: inches) Either the view name or number.DGN) The plot scale specified without trailing zeroes.ip_short_rendering_attributes ip_short_ref_filename ip_short_scale ip_units ip_view ip_volume ip_workspace ip_xsize ip_xysize ip_ysize long_date long_time minute month_abbreviation month_name month_number page_number plot_name second short_date short_time short_year sytime time total_pages username Rendering attributes filename without directory.0]) The workspace name or "NONE" if there is no workspace.000000) X and Y size of the plot in the units specified by ip_units. (Example: DITHER. (Example: FLOOR. (Example: 34. (Example: 11:59:17 PM) Minute the metafile was generated. (Example: April) Number of month. (Example: 75. (Example: siteplan) X size of the plot in units specified by ip_units.

! if (characters == "preliminary" and type==text and level==10) then characters = "final" endif Example 2: if (characters == "PAGE") then characters = PAGE_NUMBER + "of" + TOTAL_PAGES endif Example 3: ! ! Replace the string "Project Number" with ! the actual project number stored in ! the PROJECT_NUM environment variable." ! if ((type == text) and (characters == ’$$queue$$’)) then characters = ip_queue endif ! if (characters == ’4th reference filename’) then ip_logical_index = ’ref4’ characters = ip_ref_filename endif class The class keyword changes the class of an element. The element will not plot if the new class has been disabled in the IPARM file or by the equivalent MicroStation display flag. (Example: jdoe) Year the metafile was generated in four digit format. ! if (characters == "Project Number") then envr_variable = "PROJECT_NUM" characters = envr_value endif Example 4: ! Substitute the queue name from the iparm file for ! the text string "$$queue$$. Syntax: class = integer (where integer is in the range from 0 to 6) class = constant (where constant is one of the following: 0 construction 1 construction_rule 2 dimension 4-28 . (Example: 1996) (where string is any valid string or a keyword described in the previous table) Example 1: ! ! Change "preliminary" to "final" for text on ! level 10.year Syntax: characters = "string" metafile.

the width of the line style’s "dash strokes" narrow or widen uniformly. The line style resource file used on the plot server must contain the line style. in master design file units. When different values are specified for these two keywords. When the same value is specified for both cls_origin_width and cls_end_width. ! if (style == 3) then cls_name = ’{ Diamond }’ endif cls_origin_width The cls_origin_width keyword sets the starting width. This keyword has no 4-29 . of the MicroStation custom line style associated with the current element.0 cls_end_width = 2. This keyword has no effect on line style dash strokes that do not have width as a property. the width of the line style’s "dash strokes" narrow or widen uniformly. When different values are specified for these two keywords. in master design file units. ! ! if ((class == construction) and (level == 5)) then class = primary endif cls_end_width The cls_end_width keyword sets the ending width.3 4 5 6 linear_pattern pattern_component primary primary_rule) Example: ! ! Change construction class elements on level 5 ! to primary class elements. the dash strokes taper from the start to the end of the element. Width is an optional property of each dash stroke in a MicroStation custom line style. Width is an optional property of each dash stroke in a MicroStation custom line style. Syntax: cls_name = string Example: ! ! Assign the "{ Diamond }" custom line ! style to all elements using line code 3. When the same value is specified for both cls_origin_width and cls_end_width. the dash strokes taper from the start to the end of the element. Syntax: cls_end_width = real number Example: ! ! Change the width of the wide strokes in ! the "{ Wide Dash }" line style to 2 master ! design units. ! ! if (cls_name == ’{ Wide Dash }’) then cls_origin_width = 2. of the MicroStation custom line style associated with the current element.0 endif cls_name The cls_name keyword assigns a MicroStation custom line style to the current element.

Syntax: cls_origin_width = real number Example: ! ! Change the width of the wide strokes ! in the "{ Wide Dash }" line style to 2 master ! design units. ! if (cls_name .0 endif cls_scale The cls_scale keyword scales the MicroStation custom line style associated with the current element.0 endif cls_shift_fraction The cls_shift_fraction keyword shifts the MicroStation custom line style associated with the current element. Syntax: cls_shift_distance = real number Example: ! ! Shift the linestyle origin by 1 master ! design unit.ne. Syntax: cls_scale = real number Example: ! ! Scale all linestyles by 1/2.0 cls_end_width = 2. ’none’) then cls_shift_fraction = 0.5 endif cls_shift_distance The cls_shift_distance keyword shifts the MicroStation custom line style associated with the current element. ! if (cls_name == ’{ Wide Dash }’) then cls_origin_width = 2.effect on line style dash strokes that do not have width as a property. ! if (cls_name == ’{Batten}’) then cls_shift_distance = 1. ’none’) then cls_scale = 0.5 endif 4-30 . ! if (cls_name .ne. Syntax: cls_shift_fraction = real number Example: ! ! Shift the custom linestyle by 1/2 of the ! pattern length. The shift distance is specified in master design file units.

the color that is used for the color comparison keyword will not be changed. For information on Rendering Attributes. and pattern foreground color for closed polygons if these values have not been specifically set with the boundary_color.255. fill_color. Specifying named colors in a pen table sets the Rendering mode for InterPlot drivers to Full color all. select Help > Attributes in the Graphical Attribute Editor. fill color. Note If a named color or RGB color is used.color The color keyword changes the current element’s color for nonfilled elements. and pattern_color keywords. and curves using ! the various methods for defining color. ! if (type == line) then endcap = butt else if (type == line_string) then endcap = extend else if (type == arc) then endcap = circle endif envr_value 4-31 . endif endcap The endcap keyword controls the display of end points of nonclosed elements. Endcap has the following display options: butt—a rectangle with no extension (the default). extend.G. strings. Syntax: color = integer (where integer is a color index in the range from 0 to 255) color = "string" (where string is a color name from a color library) color = (R.0. extend—also rectangular. Syntax: endcap = endcap_type (where endcap_type is butt.255) ! Set the color to be RGB ! value 0. else if (type == line_string) then color = ’blue’ ! Set the color to be ! library color ’blue. but extended one-half the line width past the end of the line or curve. circle—a semicircle with a radius one-half the line width. Assigning a value to color also changes the boundary color.0. ! if (type == line) then color = 1 ! Set the color to be index ! value 1.B) (where RGB is in the range of 0 to 255) Example: ! ! Change color of lines. circle) Example: ! ! Specify the endcap type based on the element ! type.’ else if (type == curve) then color = (0.

The criteria to determine which !text contains the appropriate characters is !based on level.IN. The Comparison keyword envr_value can be used to check the value of the variable. Syntax: envr_value=string Example 1: ! !This pen table sets a plot sheet attribute !based on the characters stored in text elements !in the design file. This envr_variable = value pair is then written to the accounting file and can also be used as Digital Print Room attribute data. tag_set=’dpr’ tag_name=’sheet’ if ((type eq text) and (tag_character eq ’drawingno’)) then envr_variable = "Drawingno" envr_value = characters else if ((type eq text) and (tag_character eq ’title’)) then envr_variable = "Title" envr_value = characters else if ((type eq text) and (tag_character eq ’sheetno’)) then envr_variable = "Sheetno" envr_value = characters endif Example 2: ! !This pen table sets a plot sheet attribute !based on the characters stored in text elements !in the design file.g. ! envr_variable = "SKIP_TEXT" if (envr_value <> "") then if (type . text_node) then 4-32 . !"iplot mod MY_IPARM -environment = [SKIP_TEXT=1]") !in the IPARM environment. if ((type eq text) and (level eq 2)) then envr_variable = "Account" envr_value = characters else if ((type eq text) and (level eq 4)) then envr_variable = "Project" envr_value = characters else if ((type eq text) and (level eq 6)) then envr_variable = "Revision" envr_value = characters endif envr_variable The envr_variable assignment keyword selects the IPARM environment variable you want to use in the pen table. text. ignore text and !text_node elements. e. The criteria to determine which !text contains the appropriate characters is !based on MicroSation tags.The envr_value assignment keyword sets the current envr_variable to the specified string. Syntax: envr_variable = string Example: ! !If SKIP_TEXT is defined (as anything.

G.) Example: ! ! Change font name for certain text strings.255) endif font The font keyword sets the font number for text elements. Syntax: fill_color = integer (where integer is a color index in the range from 0 to 255) fill_color = "string" (where string is a color name from a color library) fill_color = (R. ! and ellipses. ! if ((type == text) and (font == 1)) then font = 2 else if ((type == text) and (font == 3)) then font = 7 endif font_name The font_name keyword sets the font name for text elements. Syntax: font_name = string (where string is the font name in the symbology resource file. Syntax: font = integer (where integer is in the range from 0 to 255) Example: ! ! Change font for certain text strings.0. It also specifies the background color for patterned elements. ! if ((type == text) and (font == 1)) then 4-33 .ignore = true endif endif fill_color The fill_color keyword sets the fill color for area filled polygons.B) (where RGB is in the range of 0 to 255) Example: ! ! Define fill color for shapes. The default fill color for an element is its element color. ! if (type == shape) then fill_color = 5 else if (type == complex_shape) then fill_color = ’blue’ else if (type == ellipse) then fill_color = (0. Using this keyword automatically enables area_fill. complex shapes. The pattern background is transparent by default.

If the new level has been disabled with the NOLEVELS qualifier or is disabled in MicroStation. ! if (type == text) then level = 63 endif midline_joint The midline_joint keyword controls the display of joints for both unfilled and filled elements. setting the midline_joint keyword has no effect. These keywords indicate display attributes and file specification for the reference file specified by the ip_logical_index keyword. ! if ((type == text) and (level == 63)) then ignore_element = true endif ip_logical_index The ip_logical_index keyword must be set before using the keywords ip_display. ip_nodisplay. ip_fast.font_name = "Architectural" else if ((type == text) and (font == 3)) then font_name = "FONT060" endif ignore_element The ignore_element keyword determines if the element is plotted. The following 4-34 . the element is not plotted. Syntax: ip_logical_index = "string" (where string is a logical name for a reference file or the master file) Example: ! ! Set logical index and retrieve appropriate ! reference filename. the current element is not plotted. If the boundary_display is disabled for a filled element. If this keyword is set to true. ip_levels. ip_nofast. Syntax: level = integer (where integer is in the range from 1 to 63) Example: ! ! Move all text to level 63. ! if ((type == text) and (characters == ’$$$REFFILENAME1$$$’)) then ip_logical_index = "border" characters = ip_ref_filename endif level The level keyword changes the level for the current element. Syntax: ignore_element = true ignore_element = false Example: ! ! Do not plot text elements on level 63. or ip_ref_filename to access reference file information.

Syntax: pattern_color = integer (where integer is a color index in the range from 0 to 255) pattern_color = "string" (where string is a color name from a color library) 4-35 . navy’ endif pattern_color The pattern_color keyword specifies the foreground color of pattern filled elements. Syntax: midline_joint = midline_joint_type (where midline_joint_type is butt. circle. or miter) Example: ! ! Set the midline_joint based on the reference ! file attachment number. Syntax: pattern = "string" (where string is the name of a pattern from the pattern library) Example: ! ! Area fill ellipses with the pattern ’stars. You can use the pattern_color and fill_color keywords to modify these defaults. By default. endif pattern The pattern keyword specifies a name of a pattern from the pattern library for pattern-filling a closed polygon. bevel—similar to miter except the segments are finished with butt end caps. circle—displays a semicircle at the end of each segment. else if(file == 2)then ! Test for elements in the midline_joint = circle ! second reference file. By default.’ ! The star pattern plots white with the ! background plotting navy blue. else if(file == 3)then ! Test for elements in the midline_joint = miter ! third reference file. Note The pattern keyword is not valid for vector devices. bevel. a pattern must be defined. extend. To have any effect. the element’s color is the pattern color and the pattern background is transparent. the pattern will be plotted with the element color as its foreground color and a transparent background.list describes the options for this keyword: miter—the corresponding edges of two segments extend to their point of intersection (the default). if (type == ellipse) then pattern = ’stars’ pattern_color = ’white’ fill_color = ’blue. else if (file == 1) then ! Test for elements in the midline_joint = extend ! first reference file. butt—the end of each segment displays with a rectangular joint. The pattern background color is set with the fill_color keyword. Setting the pattern keyword also sets the area_fill keyword to true. extend—similar to butt except that each segment is extended by one-half its width. ! if (file == 0) then ! Test for elements in the midline_joint = butt ! master file.

000) Example: ! ! Set priority of elements based on their color. Setting this keyword is equivalent to setting the color of the current element. Syntax: priority = integer (where integer is in the range from -1. pen The pen keyword selects the pen on a pen plotter.000. ! The star pattern plots white with the ! background plotting navy blue. Using the priority keyword.000 to 1.B) (where RGB is in the range of 0 to 255) Example: ! ! Area fill ellipses with the pattern ’stars’. the text must have a higher priority than the polygon so that the text is not covered. For example. except that the pen number equals the color number plus 1. navy’ endif Note The pattern_color keyword is not valid for vector devices.pattern_color = (R. Syntax: pen = integer (where integer is in the range from 1 to 256) Example: ! ! Set pen number based on element’s level. low priority elements are plotted before higher priority elements so that higher priority elements are plotted on top of lower priority elements. This can be useful when plotting area-filled elements. if you want a text string to plot inside a filled polygon. Notes The priority keyword is not valid for filled elements plotting to a vector device. priority = 20 endif 4-36 .G. The priority keyword overrides the order implied by MicroStation display update sequences. elements are plotted in the order they appear in the design file. if (level == 1 ) then pen = 1 else if (level == 2 ) then pen = 2 else if (level == 3 ) then pen = 3 endif priority The priority keyword modifies the order in which elements are plotted. The default priority for an element is 0. ! if (type == shape) then area_fill = true if (color == 1) then priority = 10 else if (type == text) then !Plot text on top of the shapes.000. By default. if (type == ellipse) then pattern = ’stars’ pattern_color = ’white’ fill_color = ’blue.

such as cells (normal and shared). set the screen ! relative bit in the properties word. ! if ((type == text) and (level == 1)) then size = 0:0:250 endif style The style keyword modifies the line style of the current element. ellipses. A user-defined line style can be used by specifying the name of a line style from a line style library or by specifying a series of on and off transitions. Syntax: scale = real (where real is any positive real number) Example: ! ! Scale text by a factor of 1. MicroStation refers to screen relative as "view independent. By default.endif scale The scale keyword specifies a scale factor that is applied to elements that have a local origin." Syntax: screen_relative = true screen_relative = false Example: ! ! If element is a cell named ’LOGO’. Text and text nodes are scaled about their justification point. Syntax: 4-37 .0. Syntax: size = working units Example: ! ! Set text size for text elements on level 1. ! if (type == text) then scale = 1. and text nodes.5 endif screen_relative The screen_relative keyword is used to modify the screen_relative bit in the current element’s properties word. Specify a new style by assigning the element an index in the range from 0 to 7. text.5. which corresponds to one of the predefined MicroStation style types. ! if ((type == cell) and (cellname == ’LOGO’)) then screen_relative = true endif size The size keyword is used to modify the size of text and text node elements. Note If you use a named style or style definition. the boundary display is disabled. Setting the style has no effect on area-filled or pattern-filled elements if the boundary display is not enabled. the line style used with the style comparison keyword does not change. arcs. The default scale is 1.

but can be modified within the pen table with the units keyword. ! "Home address" and "Work address. 0.5." ! ! Start by looking for "City" tags belonging to ! the "Home address" tag set.style = integer (where integer is a line style index in the range of 0 to 7) style = "string" (where string is a line style name in a line style library) style = line style definition (on. tag_set = ’Work address’ if (tag_char == ’Madison’) then color = 4 endif string string thickness The thickness keyword specifies the line width for elements in physical units that are defined by the user instead of as a line weight. Data Types: tag_set tag_name Example: ! ! Assuming the design file uses two tag sets. on." ! change the color of all elements whose tags ! specify a home address of "Huntsville" or a ! work address of "Madison. Note that the tag name is still "City"." each ! containing a character tag named "City. Specifying a thickness does not change the weight used by the weight comparison keyword. ! units = mm switch (color) case 1 ? style = 3 case 2 ? style = ’dashed’ case 3 ? style = (0. 0.75. 0.. off. The units value stored in the IPARM file is the default for the thickness keyword.3) endswitch tags The TAG_SET and TAG_NAME assignment keywords are used to specify tag set and tag name for later use by one of the comparison keywords. 4-38 . ! tag_set = ’Home address’ tag_name = ’City’ if (tag_char == ’Huntsville’) then color = 4 endif ! Now look for tags in the "Work address" ! tag set..3. off.) Example: ! ! Set the element’s style based on its color using ! the various methods for defining a line style.

The default value for this keyword is false.0) units 4-39 .10 ? thickness = 0. The translucent_fill keyword is not valid with vector devices or devices driven with Microsoft printer drivers. Syntax: thickness = positive real number Example: ! ! Set line thickness based on the element’s color. Syntax: translucent = true translucent = false Example: ! ! Plot elements on level 10 with heavily weighted ! red lines and allow elements underneath to ! show through. Elements beneath a translucent_filled element are still visible.Note You must specify the value for the thickness keyword exactly. There is no implied scaling by 1/1000 for integer values as in previous versions of IPLOT. ! if (level == 10) then color = "red" weight = 10 translucent = true endif translucent_fill If set to true. The translucent keyword only affects non-filled elements and boundaries of filled elements if the boundaries are on.05 endswitch translucent If the translucent keyword is set to true.0. Note The translucent keyword is not valid for vector devices or devices driven with Microsoft printer drivers.5 ? thickness = 0.075 default ? thickness = 0. the current element is plotted such that any elements beneath it are not completely hidden. Both the foreground and background colors for pattern_filled elements are translucent. Syntax: translucent_fill = true translucent_fill = false Example: ! ! Set fill color to be translucent.125 case 6 . ! units = inches switch (color) case 1 . the translucent_fill keyword specifies that the fill color for area-filled and pattern-filled elements is translucent. ! area_fill = true translucent_fill = true fill_color = (255. The default value for this keyword is false.

the following values are used. you can get consistent line thicknesses across various plotters. boundary_display must be enabled for this keyword to affect the element boundary. ! switch (color) case 1-10 ? weight = 2 case 11-20 ? weight = 1 default ? weight = 0 endswitch weight_base/weight_delta The weight_base and weight_delta keywords map line weights to physical thicknesses on the plot.15 cm 0.10 cm 0.5 weight The weight keyword modifies the line weight of the current element. Syntax: weight = integer (where integer is in the range from 0 to 31) Example: ! ! Set line weight based on element’s color. Plot Thickness 0. .05 cm. if the weight_base is 0. The default value for the keyword is the units value from the IPARM file. 4-40 . . The weight_delta keyword specifies an additional line thickness increment to add for each line weight above 0.The units keyword is used to specify the dimension for keywords such as thickness and line styles. Using these keywords.20 cm . The weight_base keyword specifies the line thickness for an element of weight 0.5 millimeters. Weight 0 1 2 . ! units = mm thickness = 0. Use the following formula to calculate line thickness using the weight_base and weight_delta keywords: plot thickness = weight_base + (element weight * weight_delta) For example. . Always set the units keyword at the beginning of the pen table and only set it once within a pen table.1 cm and weight_delta is 0. For filled elements. Syntax: units = units_constant (where units_constant is one of the following: centimeters (cm) millimeters (mm) meters inches feet (ft)) Example: ! ! Set line thickness to 0. .

25 mm ! . Syntax: weight_base = positive_real weight_delta = positive_real Example: ! ! Map element’s line weight to a thickness on ! the plot. ! .65 mm units = mm weight_base = 0.31 1.20 mm ! weight 3 = 0.10 mm ! weight 1 = 0.1 weight_delta = 0. ! . ! weight 31 = 1.05 4-41 . ! weight 0 = 0.15 mm ! weight 2 = 0.65 cm Note You must define the weight_base and weight_delta keywords at the beginning of the pen table.

InterPlot for MicroStation 4-42 .

Within the InterPlot Organizer interface. The General Property page contains a New/Edit button that corresponds to the pen/feature table field. The feature table does not modify the original design file or its reference files. Feature Table Example Assume that a design file of a map contains elements representing the base map. Area-filling closed elements with a specified color or pattern. Symbology . You could use the following feature table to resymbolize the map: IP_FETBL 1. Substituting the current date for a specified text string. 2 sym: ignore_element = . bodies of water. fill_color = ’blue’ 4-43 . Some common uses for resymbolization include the following: Highlighting specific elements by changing their color. Water elements are on level 2. Invoking the IPLOT Feature Table Editor The IPLOT Feature Table Editor can be invoked the following ways: Select "IPLOT Feature Table Editor" from the InterPlot Utilities program group. priority = 2 area_fill = . fill_color = ’green’ name: body of water def: level .Introducing Feature Tables Like a pen table. Otherwise.false.Describes how those elements should appear on a plot.eq. and railroads with the following characteristics: Base map elements are on level 1. From a Command Prompt.false. Obtaining consistent colors on various plotters with the use of color tables and libraries.1 name: base map def: level .true. If an element possesses the characteristics listed in one of the feature definition sections. Instead. 1 sym: ignore_element = . the modifications listed in the corresponding symbology section are made.eq. Definition . priority = 1 area_fill = . Defining custom line styles. Controlling the order in which elements print. How a Feature Table Works The feature table is compiled on the client node and included in the metafile for execution on the server node. and no further processing is performed for that element. or line style. Type in "ipfte feature_table_name" and press Enter. Omitting specific elements from the plot. Road elements have a weight of 0.Identifies a group of elements sharing a set of characteristics. width. However. Railroad elements have a weight of 1. the element is not modified. a feature table contains a series of feature descriptions that contain the following three parts: Name . Changing the appearance of elements on a plot is called resymbolization.Identifies the element group. a feature table changes the appearance of specified elements of a plot.true. roads. The New/Edit button invokes the IPLOT Feature Table Editor. a feature table is not a sequence of instructions for testing and modifying elements. Road and railroad elements are on level 3.

These feature descriptions define transportation. Roads. Each feature defined in a feature table typically corresponds to some physical component of the object represented by the design file. Because roads and railroads share a common characteristic (both being on level 3) in the design file. the body of water feature corresponds to lakes and rivers in the map. All bodies of water are area-filled in blue with a light blue wave pattern. 0 sym: ignore_element = . nuts and bolts are specialized types of fasteners and chairs are comprised of cushions. and railroads would overlay both the base map and the bodies of water. For example. reconsider the previous map example. and legs. special types of transportation mechanisms.. All railroads would be red and 0. or a component may be comprised of several subcomponents..05 Note Although feature tables are ASCII files and displayed as such in the examples in this document. Several components may be specialized versions of a common component.false. The base map appears at the bottom of the plot.eq. Roads would be plotted on top of the other plotted data.. For example. you can define a transportation feature. priority = 3 color = ’red’ style = ’dashed’ thickness = 0. name: transportation. In the previous example.eq.railroad def: weight . 3 weight . you should create and modify feature tables with the feature table editor.pattern = ’waves’ pattern_color = ’blue.false.road def: weight . All roads would be black and 0. priority = 4 color = ’black’ thickness = 0.05 inches thick with a dashed line style. reside on level 3 and have a weight of 0. 1 sym: ignore_element = . 3 weight . but it must also have some additional characteristics that differentiate it from its parent. 0 sym: . 4-44 . name: transportation. A subfeature must possess all characteristics that define its parent. A subfeature is a variation or component of another feature known as the parent feature. light’ name: road def: level . 3 sym: . You can consider roads and railroads to be two specialized versions of transportation mechanisms.eq. 1 sym: .eq.1 inches thick.. road and railroad features as follows: Transportation mechanisms reside on level 3 in the design file. The map plotted with this feature table has the following appearance: The base map is area-filled in green (assuming that closed elements such as shapes or complex shapes represent the base map). Bodies of water overlay the base map..eq. Parent Features and Subfeatures The physical components of an object are often related. armrests. The design file contained roads and railroads on level 3 with roads having a weight of 0 and railroads having a weight of 1.eq. and road and railroad subfeatures in a feature table as follows: name: transportation def: level .eq. Feature tables enable you to describe such relationships by defining subfeatures.1 name: railroad def: level ..

reside on level 3 and have a weight of 1.Railroads. you can independently symbolize roads and railroads just as if you had defined them as totally independent features. Defining a feature’s subfeatures enables you to control the subfeatures either individually or collectively. both roads and railroads are also turned off. Using the previous feature table descriptions. However. When defining a subfeature. you need to list only characteristics that differentiate the subfeature from its parent feature. If you specify that roads and railroads inherit the symbology of their parent feature. 4-45 . If you turn off the transportation feature using the feature table editor. roads and railroads are modified the same way. another type of transportation mechanism. you can also symbolize roads and railroads together by modifying the transportation feature.

type in 15. Wildcards can be used in string comparisons of equality or inequality. First. select the comparison keyword. For example. 23. you must type in the values as a comma-separated list. Valid values are strings. Area fill The area fill keyword checks to see if the current element is filled. and then click Remove. you must define a new feature using the Definition tab inside the Feature Table Editor. If an element is not a cell header and is in a nested cell. and text nodes have an associated angle. click the New Condition button. click the feature and type in the new name. and type in the new name. 4 To remove an existing condition. From the list. You can select the value through the scrolling list. its cell name is the name of the outermost cell. 4-46 . Wildcards can be used in string comparisons of equality or inequality. You can select the value through the scrolling list. and 45. click New Condition. For descriptions of all the comparison keywords. refer to the Modifying a Feature’s Definition section. Real numbers in the range of 0 to 360 are valid. Valid values are integers between 0 and 255. not in) in a condition. use the list button on the Parent field to display a list of existing features. you can use the symbology tabs to determine how the elements will look when they are printed. CLS name Specifies the name of the MicroStation custom line style associated with the current element. ellipses. 2 Click the Definition tab.Creating a Feature Table Creating a feature table is essentially a two-step process. Angle Specifies an element’s angle. to change the color of every element on level 15. arcs. after a new feature is defined. Modifying a Feature’s Definition 1 Select a feature from the features list. Only cells. Use the Comparison keyword list to distinguish the new feature from other features in the design file. select the parent feature for the new feature. Cell name Identifies an element’s cell name. Use the following list of comparison keywords to distinguish a feature from other features in the feature table. 4 If the new feature is a subfeature. The keywords listed below the Comparison Keyword heading identify the elements in the design and reference files that represent the feature. Second. Color The color keyword indicates the color index of the current element. 3 To add a new condition. 45. 6 Select or type in the value for the comparison keyword in the Value edit box. 5 Select a valid Relational Operator for the selected comparison keyword. When using a list operator (in. Characters The characters keyword specifies the string contained in the element if the current element is a text element. text. Valid values are strings. 3 On the Definition tab page. Valid values are strings. 23. A feature called "New Feature" is added to the features list. 2 To rename the new feature. or select Edit – Rename. Defining a New Feature 1 Select Edit – New Feature from the menu. Class The class keyword specifies the class type of the current element.

Valid values are integers between 0 and 31. Tag keywords The tag keywords check the tag data attached to the current element. Assigning Line Symbology The items on the Line symbology page modify the active feature’s symbology. or Z range of the element. arcs. An "*" matches zero or more occurrences of any character. it disables the special meaning of the asterisk (*) and question mark (?) characters. Size For text elements. Typically. You can select the value through the scrolling list. Text node number Identifies the text node number of a text node complex element. Y. linestrings. Ref attach no. and a real number for Tag real. Weight Identifies an element’s line weight. Wildcards can be used in string comparisons of equality or inequality. 4-47 . the size keyword is the height of the text string. You can select the value through the scrolling list. Properties Identifies miscellaneous properties of an element. You can select the value through the scrolling list. Style The style keyword contains the value of the current element’s line style.Font For text and text nodes. Nested cell name Specifies the name of the innermost cell. Type The type keyword determines the element type of the current element. the font keyword contains the font number for the current element. Type in the size in working units format. Valid values are integers between 0 and 255. The "\" indicates that the next character is to be treated as an actual character and not as a special character. positional units). Specifies the file attachment number for the file being processed. For Tag display. Type in the size in working units format. Feature symbology defines how elements look when they are printed. Type in a string value for Tag character. mu:su:pu (master units. Header type The Header type keyword determines the outermost complex header type for elements that are components of a complex element. an integer value for Tag integer. you can select the value through the scrolling list. Valid values are strings. In other words. Ref log name Identifies the logical name of the reference file. mu:su:pu (master units. positional units). and a "?" matches exactly one occurrence of any character. subunits. You can select the value through the scrolling list. ellipses. Valid values are 0 and positive integers. subunits. and connected strings have an associated width. Only 2D lines. Valid values are integers between 0 and 255. Level The level keyword contains the level number of the current element. For all other elements. Valid values are integers between 1 and 63. Width Identifies an element’s width. the size is the largest of the X. Valid values are strings. the master file is attachment number 0.

Using this keyword automatically enables area fill. off.B) where R. the current element is plotted such that any elements beneath it are not completely hidden. but extended one-half the line width past the end of the line or curve. butt—the end of each segment displays with a rectangular joint. It also specifies the background color for patterned entities. The line style resource file used on the plot server must contain the line style. Custom line style scale Scales the MicroStation custom line style associated with the current element. Endcap Controls the display of end points of nonclosed elements.The parameters you can set on the Line symbology page include: Color Assigns a new color to the current entity. If the boundary display is disabled for a filled element. off. Specify a new style by assigning the element an index in the range from 0 to 7. Thickness The thickness keyword specifies the line width for elements in physical units that are defined by the user instead of as a line weight. The translucent keyword only affects non-filled elements and boundaries of filled elements if the boundaries are on. or RGB values in the format (R. Real numbers are valid values. and B are integers between 0 and 255. Feature symbology defines how elements look when they are printed. …). but can be modified within the feature table with the units keyword. The following list describes the options for this keyword: bevel—similar to miter except the segments are finished with butt end caps. Valid values are strings.G. G. Custom line style Assigns a MicroStation custom line style to the current element. When the line width is set to Weight. miter—the corresponding edges of two segments extend to their point of intersection (the default). If the translucent radio button is set. on. circle—a semicircle with a radius one-half the line width. setting the midline joint keyword has no effect. Weight Assigns a valid weight to the specified elements. extend—similar to butt except that each segment is extended by one-half its width. Valid values are positive real numbers. Endcap has the following display options: butt—a rectangle with no extension (the default). Midline joint Controls the display of joints for both unfilled and filled elements. Translucency Sets the opaque or translucent attribute for the linear element. circle—displays a semicircle at the end of each segment. Assigning Fill Symbology The items on the Fill symbology page modify the active feature's symbology. The pattern background is transparent by default. The parameters you can set on the Fill symbology page include: 4-48 . A user-defined line style can be used by specifying the name of a line style from a line style library or by specifying a series of on and off transitions (on. The default fill color for an entity is its entity color. which corresponds to one of the predefined MicroStation style types. You can type in a color name. type in an integer between 0 and 31. Style Specifies the line style for the feature. The units value stored in the IPARM file is the default for the thickness keyword. extend—also rectangular. a color index integer between 0 and 255.

The Area fill keyword can be used to plot elements that would otherwise plot filled as outlines. You can type in a color name. Boundary color Specifies the boundary color of an area or pattern-filled polygon. Elements beneath a translucent element are still visible. and B are integers between 0 and 255. It also specifies the background color for patterned elements. G. a color index integer between 0 and 255. a color index integer between 0 and 255.B) where R. The pattern background color is set with the Solid fill color keyword. or RGB values in the format (R. G. Any closed element can be controlled with this keyword including closed b-spline curves.B) where R. the pattern will be plotted with the element color as its foreground color and a transparent background.G. you should use the Edit – Character Substitutions command to replace multiple text strings. Valid values are strings. The default fill color for an element is its element color. The pattern background color is also set with the Solid fill color field. and B are integers between 0 and 255. and B are integers between 0 and 255. Setting the assignment keywords Solid fill color or Pattern implies setting Area fill to true. The values from these environment variables can be used to replace the string in a text element with a new string. and shapes.B) where R. or RGB values in the format (R. or RGB values in the format (R. These environment variable definitions are sent to the plot server along with any definitions stored in the IPARM file. a color index integer between 0 and 255. By default.B) where R. Translucency Specifies that the Solid fill color for area-filled and pattern-filled elements is translucent. You can type in a color name. This information is then written to the accounting file and can also be used as Digital Print Room attribute data.Area fill Plots closed elements as filled when set to true. G. a color index integer between 0 and 255. G. You can select the value through the scrolling list. Using this keyword automatically enables Area fill. You can also use environment variables in a feature table to extract data from a design file. Solid fill color The Solid fill color keyword sets the fill color for area filled polygons. the element’s color is the pattern color and the pattern background is transparent. and B are integers between 0 and 255.G. You can type in a color name. You can type in a color name. Both the foreground and background colors for pattern-filled elements are translucent. By default. Pattern Specifies a name of a pattern from the pattern library for pattern-filling a closed polygon. Boundary color only affects filled elements with Boundary display set to true. Boundary display Specifies whether the boundary of a filled polygon is plotted. The pattern background is transparent by default. Assigning Environment Variables The Environment page enables you to use environment variables in feature tables to perform text substitution and to extract data from the design file.G. ellipses. or RGB values in the format (R. The parameters you can set on the Environment symbology page for text substitution include: 4-49 . The Character Substitutions command does not require a separate feature to replace each text string. Setting Boundary display to true for filled text may produce undesirable results. Although you can use the "Set characters to" field to replace a text entity with a new string. the element’s color is the pattern color and the pattern background is transparent. The Boundary display keyword has no effect on elements that are not filled.G. Pattern foreground color Specifies the foreground color of pattern filled elements. Setting the Pattern keyword also sets the Area fill keyword to True. By default. Pattern background color Specifies the background color of pattern filled elements. complex shapes. InterPlot clients can define environment variables that can be transferred to the plot server during plot submission.

Valid values are strings. Valid values are integers between –1. Value Specifies the environment variable value. positional units). such as cells (normal and shared). Type in envr_value to set characters to the value of the environment variable specified in the "Environment variable" field. The default scale is 1. The default priority for an element is 0. The parameters you can set on the Other symbology page include: Font index Sets the font number for text elements. Inherit from parent The Inherit from parent checkbox enables the subfeature to inherit attributes from the parent feature. Select "envr_value + " " + characters" to allow for string concatenation.000. such as text nodes. Feature symbology defines how elements look when they are printed. Select "characters" to set the environment variable value to the specified text string.Environment variable Specifies the environment variable for the current feature. Valid values are integers between 0 and 255. ellipses. Variable Specifies the environment variable you want to create. and text nodes. Using the priority keyword. Weight delta.000 and 1. Use the string concatenation value when extracting data from multi-line text elements. By default. Type in the size in working units format. mu:su:pu (master units. If you want to replace a text string with the value of this environment variable. and Units for the feature table.000. low priority elements are plotted before higher priority elements so that higher priority elements are plotted on top of lower priority elements. Set characters to Replaces the string in a text element with a new string. you can later substitute these strings with useful information such as the date the file was plotted or the design file name. The default 4-50 . Global Symbology The Edit – Global Symbology command enables you to set the Weight base.000. Text and text nodes are scaled about their justification point. such as text. subunits. Priority Controls the order in which elements are plotted. Size Changes the size of text and text node elements. type envr_value in the "Set characters to" field.0. The text data that is extracted from the design file is associated with this variable. elements are plotted in the order they appear in the design file. This information is then written to the accounting file and can also be used as Digital Print Room attribute data. Valid values are positive real numbers. text. Assigning Other Symbology The items on the Other symbology page modify the active feature’s symbology. Units The Units keyword is used to specify the dimension for keywords such as thickness and line styles. arcs. By putting text elements in your design file to act as place holders. Scale Specifies a scale factor that is applied to elements that have a local origin. View independent The View independent checkbox controls the rotation of view-independent elements. Font name Sets the font name for text elements.

.000. so that higher priority features are plotted on top. a second click inverts the feature list. 31 Priorities The Edit – Priorities command enables you to set the priority for a feature.000. you can get consistent line thickness across various printers. Valid priority values range from –1. Low priority features are plotted before higher priority features.65 cm 4-51 .15 cm 0. the feature list will be sorted (alternating between ascending and descending order). 1. Weight base/Weight delta Weight base and Weight delta keywords map line weight to a physical thickness on the plot. the feature list will revert back to it’s original state. The Weight base keyword specifies the line thickness for a element of weight 0. Priority determines the order in which the selected feature is plotted. For example. If you click the Priority column heading. Plot Thickness 0.value for the keyword is the units value from the IPARM file. If you click the Feature Hierarchy column heading once. if the Weight base is 0.1 cm and Weight delta is 0. The Weight delta keyword specifies an additional line thickness increment to add for each line weight above 0. the following values are used.000. .05. Using these keywords.10 cm 0. By default. elements are plotted in the order they appear in the design file.000 to 1.20 cm . Weight 0 1 2 .

Use the Edit – Character Substitutions command to add a Character Substitutions feature.16 2 .Special Features The Default Feature The Default feature enables you to change the symbology of all elements not defined in the other features. you can later substitute these strings with useful information such as the date the file was plotted or the design file name.32 4 . The Default feature will always display in the tree. Character Substitutions The Character substitutions command enables you to replace the string in a text element with a new string. since weight zero lines print as single pixel lines and the thickness varies depending upon the printer resolution. you can use the Edit – Modify Value Mapping command to make changes. Once a Value Mapping feature is added. you can double-click it to make changes. For example.08 1 . 4-52 . but will not be written to the file if it is empty. Value Mapping features are added to the top of the feature list. or renamed. The Default feature cannot be deleted. you may want to map line weights to a specific line thickness.24 3 . A Character Substitutions feature will be added to the top of the feature list. Once a Character Substitutions feature is added. moved.48 Use the Edit – New Value Mapping command to create a Value Mapping feature.40 5 . Example: Weight Thickness 0 . Mapping weight to thickness ensures consistent line thickness across a wide range of printer resolutions. Value Mapping Value Mapping enables you to map a comparison keyword to a specific assignment keyword. By putting text elements in your design file to act as place holders.

You can only reorder normal features. Expand and Collapse Commands The View – Expand and View – Collapse commands enable you to turn on or off the display of subfeatures. To rename the new feature. controls the starting point for file selection 4-53 . to hide subfeatures. Use the New Condition button to add a new condition." To rename the new feature.Save As will be executed instead. To access the context menu. If this filename doesn’t exist or is invalid. IPLOT_FEATURE_TABLE_PATH. but will retain their original name. Move Commands The Move commands enable you to move a feature up/down in the feature list. Save and Save As Commands The File . The new feature will be created with a unique name. Rename Command The Rename command enables you to change the name of a feature. The Save As command enables you to save the data to a feature table or to a pen table. right-click on any feature. Use the InterPlot Client Configure utility to set search path variables. the new feature is listed last in the list (but above the Default Feature). select the Edit – Rename command. IPLOT_FEATURE_TABLE_PATH.Duplicate command enables you to create a copy of the selected feature.Save command saves the feature table being edited using the filename obtained in the last File Open execution.Other Feature Table Command Delete Command The Edit .Open command opens a valid feature table file. or click the selected feature and type in the new name. or from the context menu. controls the starting point for file selection dialog boxes. the subfeatures will also be copied. The new feature’s definition and symbology pages contain the same attributes as the original feature. click the MINUS SIGN (-). New Feature Command The Edit . Value Mapping. The new feature will be named "New Feature. The Move commands are the arrows located below the features list. You cannot select any other commands until you add the new condition. click the PLUS SIGN (+). Special features such as Character Substitutions. If the selected feature contains subfeatures. then make the necessary modifications to the new feature to distinguish it from the other features in the drawing file.New command empties the feature table editor of all features. Note A new feature requires at least one condition for the feature definition.Delete Feature command enables you to delete the selected feature. or from the context menu. The Expand and Collapse commands can be accessed from the View menu. The new feature will be placed immediately after the selected feature. they will be deleted along with the parent feature. The Save As command obtains the filename where the current file is to be saved. The new feature name is formed by appending a number to the feature’s original name. except the Default feature. the command File . Duplicate Command The Edit . This feature enables you to create a new feature table without having to exit the feature table editor. Note The search path variable. The search path variable. or click the selected feature and type in the new name. You should use the Duplicate command to create a similar feature. Alternately. The Delete feature command can be accessed from the Edit menu. to view subfeatures. The Duplicate command can be accessed from the Edit menu. select the Edit – Rename command. To access the context menu. If a parent feature contains subfeatures.New Feature command creates a new feature that displays in the feature list. If no feature is selected. The File . New and Open Commands The File . and the Default feature cannot be moved. right-click on any feature.

Toggle Plotting command enables you to plot or not plot a given feature. Toggle Plotting Command The Edit . Use the InterPlot Client Configure utility to set search path variables.dialog boxes. a check in this box specifies that the feature will plot. 4-54 . Each normal feature in the feature list has a checkbox.

DGN.0.0. and then type in "border" for the feature name.0) will plot the border pure black. 4-55 .0) in the Color field. and the date you submitted the plot. select Start -> Programs -> InterPlot Utilities -> IPLOT Feature Table Editor . Creating the border feature 1 Select Edit – New Feature to create a new feature. 3 Select the Other symbology tab. select text. 5 Type 1 in the Value field and press Enter. and then type (0. and then type 100 in the Priority field. Changing feature symbology for furniture 1 From the Features list. 4 From the Comparison Keyword list. and then type (0. 2 Select Edit – Rename. Changing feature symbology for text 1 From the Features list. you will create a feature table (LEARNDGN. 2 Select the Line symbology tab. and the furniture (level 15) by plotting it in black and the rest of the building in gray. A new feature named "New Feature" is created and added to the Features list. 3 Select the Other symbology tab.Feature Table Lessons Lesson 1: Creating a Feature Table In this lesson. Creating the text feature 1 Select Edit – New Feature to create a new feature. Changing feature symbology for border 1 From the Features list. This will give the furniture a high priority so it will plot on top of the other features. 2 Select the Line symbology tab. A new feature named "New Feature" is created and added to the Features list. 4 From the Comparison Keyword list. 3 On the Definition page. and then type 100 in the Priority field. 3 On the Definition page.0) will plot the furniture pure black. select Level. select Level. the sheet border (level 1). and then type (0. 2 Select Edit – Rename.0) in the Color field. 2 Select Edit – Rename. click New Condition. 3 On the Definition page. A color of (0.0. the actual file specification of LEARN.0.0. 5 Type 15 in the Value field and press Enter.0. A color of (0. This will give the border a high priority so it will plot on top of the other features. Replace the text in the title block with the printer name.0) will plot the text pure black. A color of (0. Starting the IPLOT Feature Table Editor From the desktop. 4 From the Comparison Keyword list. Creating the furniture feature 1 Select Edit – New Feature to create a new feature. click New Condition. click New Condition. and then type in "furniture" for the feature name. select Type.0) in the Color field. select furniture. 5 In the Value field select Text (type 17).FTB) to change the plot in the following ways: Highlight all text. and then type in "text" for the feature name. A new feature named "New Feature" is created and added to the Features list. select border. 2 Select the Line symbology tab.

configure at least one printer or connect to a printer on an InterPlot Server node. 3 In the Line width frame.FTB and click Open. and then click Set. For InterPlot Professional.3 Select the Other symbology tab. 2 In the Search String field. type in 4 for the Weight. 5 Select LEARNDGN. Maximizing the Plot Size 4-56 . Creating Plots 1 From the Create Plots dialog box. to exit the IPLOT Feature Table Editor." Be sure to enclose the string in quotes. and then type 100 in the Priority field. Selecting the Feature Table 1 From Organizer’s main window. type in "substitute the printer name here. A color of (200.200.FTB. 6 In the Search String field. select Start -> Programs -> InterPlot Utilities -> InterPlot Organizer. Lesson 2: Changing the Appearance of a Plot In this lesson. 4 To dismiss the Create Plots dialog box and add the selected file to the current plot set. click OK. select date. type in "substitute the date here. 2 Select the Line symbology tab. 5 In the Replace String field. Navigate to the folder you saved the feature table (LEARNDGN. and then type 10 in the Priority field. and then click Set. Creating the Character Substitutions feature 1 Select Edit – Character Substitutions to create a special feature. double-click learn. an error message displays. click the Browse button next to the File name edit box. 2 When the Welcome to InterPlot Organizer dialog box displays. click Add. Organizer loads the plot into the main window. and then click Set.200) will plot elements gray. 7 In the Replace String field. 4 To locate the feature table named LEARNDGN." Be sure to enclose the string in quotes. you will learn how to attach the feature table to the design file. 3 Select the file LEARN. 4 Select the Other symbology tab. 2 Select File Exit. If Organizer cannot find a printer that is capable of printing the job. 3 In the Replace String field. select Default Feature. select Save As. type in "substitute the filename here. 8 Click OK to dismiss the Character Substitutions dialog.FTB) into.FTB." Be sure to enclose the string in quotes. select dgnspec. Changing feature symbology for the Default Feature 1 From the Features list.DGN.200. This will give the text a high priority so it will plot on top of the other features.200) in the Color field. Starting InterPlot Organizer 1 From the desktop. click the Feature table radio button. For InterPlot Client. 2 Navigate to the C:\Program Files\InterPlot Client\learn or C:\Program Files\InterPlot Professional\learn folder. 2 From the Learn Properties dialog box. The Default Feature enables you to change the symbology of all elements not defined in the other features. and then click Open. you must create at least one printer to a machine that has InterPlot Server installed. and preview and print the plot using InterPlot Organizer. This will give the Default Feature a low priority so it will plot below the other features. click the General tab. 3 From the General property page. 4 In the Search String field. Save the feature table to your favorite folder and name it LEARNDGN. select ip_queue. and then type (200. click OK. Saving the Feature Table 1 From the File menu.

and the current date. 4 To maximize the plot. 2 In the Preview window. 3 From the Learn Properties dialog box. 2 From the Print dialog box. Previewing the Plot 1 To preview the plot. 4-57 . and then click OK. and then click OK to dismiss the Fit to Element Range dialog box. click Maximize. click the Layout tab. 2 Click Fit to Element Range. Use the Zoom In command to see the text in the title block. the current printer. 5 To dismiss the Learn Properties dialog box. select File -> Print Preview. use the Printing the Plot 1 Select File -> Print. and text is pure black. and the remaining elements are gray. button to close the Preview window. select the printer. Notice that the text strings display the current design file. click the Area tab. Right-click inside the preview window to access the context menu. Notice that the furniture. border.1 From the Learn Properties dialog box. click OK.

InterPlot for MicroStation 4-58 .

C H A P T E R 5 Managing Resource Files .

InterPlot for MicroStation .

RSC) IPLOT pattern libraries IPLOT line style libraries 5-1 . These graphical resources are not stored in files sent through the printing system.What are Resource Files? When plotting CAD drawings. pattern. There are two categories of resource files associated with IPLOT: General resource files color libraries MicroStation/IPLOT resource files MicroStation symbology resource files (FONT. LSTYLE. Resource files are accessed on the plot server when offloading plot processing to InterPlot Server or a Digital Print Room product. line.RSC. Rather. and color definitions. InterPlot reads them from local resource files during preview or local printing (InterPlot Professional only). InterPlot may access font.

where 0. but the colors are defined differently for each driver to compensate for how the different plotters produce the same color. blue_value A color name is a string of characters (31 or fewer) that may contain blanks.000000. the metafile should be regenerated to ensure that it contains that plotter’s color table. the following IPLOT pen table assigns colors to elements on levels 1 through 5: if (level . Each remaining line defines a single color description consisting of a name and an RGB definition. For example. and blue intensities that define the color. Color libraries are a collection of color descriptions associated with a printer on the plot server.733333. The first character in a color name must be alphabetic but can be followed by any displayable ASCII characters except single or double quotation marks. IP_CLRLB. Each intensity value is a real number between 0.000000. 2) then color = ’black’ else if (level .000000. green_value.eq. 0. 3) then color = ’blue’ else if (level . 1) then color = ’aquamarine’ else if (level . the colors produced by one plotter rarely match those produced by another. Instead of assigning a color index to an element. = 0. 0. All drivers’ color libraries contain the same color names.866667 0.666667. The second line indicates that the colors in the library are defined by red. Customizing a Color Library 5-2 . = 0. Each description includes a name and an RGB definition.0 is the lowest intensity.000000 The first line.eq. that color name’s RGB definition is extracted from the appropriate driver’s color library and used for the plot. you assign a color name to an element. For example: IP_CLRLB type=RGB aquamarine aquamarine.666670 0. the correct RGB intensities for that device are used automatically. Likewise.eq. medium black blue = 0. you must create a pen table that assigns the color names to the appropriate elements. 5) then color = ’blue. Each InterPlot device driver includes a color library tailored to its specific plotter.000000 1. and feature tables to simplify the task of obtaining consistent colors across different plotters. 0. When the element is plotted. cadet’ else if (level . green. IPLOT uses color libraries. A metafile produced using color names instead of color indices does not need to be regenerated before it is plotted on a different device. indicates it is a color library. green. cornflower’ endif Matching Colors The colors on a plot rarely match the colors on the workstation screen.0 is full or highest intensity. The usual solution to this problem involves using several MicroStation color tables. To use these named colors. = 0. The syntax for the color definition section is: color_name = red_value. 0. 0. and 1.000000.933333. Before a plot is submitted to a particular plotter. You must use a pen table or feature table to use the colors defined in color libraries.0 and 1.eq.Color Libraries You can use color libraries to change element color. 4) then color = ’blue. Each time the metafile is plotted to a different device. one for screen display and one for each type of color plotter. and blue intensities. The numbers following the equal sign (=) are red. pen tables.0. A color value denotes the intensity of the component in the color model specified in the header.866667.eq.

The color libraries delivered with each device driver contain 67 standard colors. the element is plotted in black. a metafile with colors that look fine on one plotter may not plot correctly on another. you should also add or delete those colors from all other plotters’ color libraries. Use the clib utility to edit color libraries. The clib utility invokes Notepad to enable you to edit the color library associated with the printer. The Clib Utility You can edit color libraries with the clib utility. Otherwise. modify. You may want to add. C:\win32app\ingr\ipshare\ipserver\bin\clib printer_name 5-3 . When you add or delete colors from one plotter’s color library. or delete colors from these libraries. if an element is assigned a color with a name not defined in the current plotter’s color library.

CFG).PLB.UCF). If different users in your organization require different resources. you can edit InterPlot’s configuration file to designate your pattern and line style resource files as defaults. you must create a MicroStation workspace for each project or discipline to reference the appropriate font resource files. 5-4 . If your entire organization uses the same pattern and/or line style resources. You do not need to take any action to use these resource files.UCF). Font resources are accessed through UCF files. PAT100. Default IPLOT Resource Files InterPlot delivers the following IPLOT resource files in the RESRC\SYSTEM directory of the IPLOT component of InterPlot.Using IPLOT Resource Files InterPlot reads two types of configuration files: MicroStation workspace user configuration files (*. you must create a MicroStation workspace for each project or discipline and add the pattern and line style IPLOTSRV. By default. MicroStation Font Resources InterPlot references MicroStation workspaces to access MicroStation font resource files. this directory is C:\Program Files\Common Files\InterPlot\IPLOT. Pattern and line style resources can be accessed through either IPLOTSRV. and a server configuration file (IPLOTSRV.PLB. InterPlot uses them automatically. PAT400.CFG variables to the user configuration file (*.PLB — IPLOT pattern libraries that contain patterns you can assign to filled elements with pen tables or feature tables. PAT600. IPLOT Pattern and Line Style Resources InterPlot includes a set of standard IPLOT pattern and line style resource files used when plotting MicroStation data and a configuration file (IPLOTSRV. If different users work on different projects or in different disciplines that require custom resources. An IPLOT line style library that contains line styles you can assign to elements with pen tables or feature tables.PLB.CFG or UCF files. PAT300.CFG) that designates them as defaults.

To create a pattern. If the foreground/background colors do not plot correctly. you must use the new pattern name with the -entry qualifier in subsequent commands. or individual pattern entries. Quits the interactive mode. Deletes a pattern. read the server configuration file (IPLOTSRV. At the plib prompt. and store the raster image in a pattern library using the plib utility. and delete patterns from a pattern library. For example. Shows pattern library global information. and graphical definition. Adds a pattern. invert the colors using your raster editor and save the file again. for a 300 dpi plotter. you draw the pattern with a raster editor like Paint Shop Pro™. The following list describes the qualifiers available with the plib utility: Qualifier -entry Description Specifies a pattern name. then use the plib utility to add it to the pattern library. You do not need to key in the entire command. The mandatory letters are underscored. create a 1-bit raster image.IPLOT Pattern Libraries IPLOT pattern libraries are collections of area fill patterns. The following table includes the commands used with the plib utility. so the patterns plot at varying sizes depending on the plot scale. For more information about pattern libraries. PLIB Utility The plib utility is delivered with IPLOT component of InterPlot. It has a command line interface that enables you to add. If you use the -name qualifier to change the name of a pattern. copy. Command create delete modify show add copy extract quit Description Creates a pattern library. In contrast. Copies a pattern. size. Modifies a pattern qualifier. Extracts a pattern from a pattern library. When you assign a pattern to an element. key in the command and qualifier(s). modify. IPLOT patterns always plot at the same size because their sizes are defined in actual units. rotation. and places it in a raster file.CFG) in the InterPlot Client Configure utility. you should make the raster file pattern size 300x300 pixels. you can also define its foreground and background colors. Each pattern has a name. Separate patterns need to be drawn for each unique plotter resolution. then add it to the pattern library. Note The IPLOT pattern library is not valid with vector devices. The graphical definition is a 1-bit raster image. such as number of patterns in the pattern library. Syntax: plib command -entry=pattern_name pattern_library 5-5 . the following pen table fills all shaped elements on Level 1 with a blue and yellow hatch pattern. You must use a pen table or feature table to plot elements with the patterns stored in pattern libraries. if ((level == 1) && (type == shape)) then area_fill = true pattern = ’hatch’ fill_color = ’blue’ # define pattern # background color pattern_color = ’yellow’ # define pattern # foreground color endif MicroStation area patterns are defined in working units. Syntax: plib command -qualifier=value pattern_library You can use plib in an interactive mode by typing plib pattern_library at the system prompt. For example.

Syntax: plib command -entry=pattern_name -origin=[n. or double quotation marks. Must be a string of less than 32 characters. The size is measured along the length of the pattern and must be less than four inches. However. the string can begin with and contain any character except new lines and double quotation marks. Syntax: plib command -entry=pattern_name -name=new_name pattern_library -size Specifies the size of the pattern. Syntax: plib command -entry=pattern_name -filename=tile. Command create delete modify Qualifier entry entry name size rotation origin description filename units origin entry units entry name Optional/Required required required optional optional optional optional optional optional optional optional optional optional required optional show add 5-6 .-name Specifies the new name when the name of a pattern is being modified. The following list shows the available qualifiers for each command. inches (or in).n] pattern_library -description Describes the pattern. Use a string of fewer than 256 characters. (The default units are centimeters. Syntax: plib command -entry=pattern_name -size =nnnn -units=in pattern_lib Note Strings must begin with an alphanumeric character and cannot contain spaces. meters (or m). Use any of the following values: millimeters (or mm). centimeters (or cm). Use this qualifier when adding a pattern to the library and when extracting a pattern from the library. The default is centimeters. Syntax: plib command -entry=pattern_name -description="description" pattern_lib -filename Specifies a raster filename.) Syntax: plib command -entry=pattern_name -size =nnnn pattern_lib -rotation Specifies the pattern rotation in degrees where nnn is between 0 and 360.tif pattern_lib -units Specifies the units of measure. if the string is surrounded by double quotation marks. tabs.Syntax: plib command -entry=pattern_name -rotation=nnn pattern_lib -origin Specifies the pattern origin in the current units of measure. new lines.

5-7 .copy extract size rotation origin description filename units origin entry name entry filename optional optional optional optional optional optional optional required required required required Note Qualifiers not listed with commands are ignored.

062) = (0.045. IPLOT includes the following default line style library: IP_STYLB UNITS = IN solid dotted medium dashed long dashed dash-dot short dashed dash-dot-dot long dashed-short dashed = (1.125. 5-8 .045.0125. 0.062) = (0. 0. Each definition includes a name and a series of dash/gap transitions. 0.03) = (0.045) = (0.062) = (0. 0.03.125.062.125 inch dash followed by a 0. You must use a pen table or feature table to plot design file elements with the styles defined in line style libraries.062) = (0. The second line indicates that the dash/gap transitions in the file are defined in inches.062. Each remaining line defines a line style.045) IP_STYLB identifies the file as an IPLOT line style library. 0. 0. However. centimeters (cm). The first line of every line style library must contain this identifier.062 inch gap.03. 0.IPLOT Line Style Libraries An IPLOT line style library is an ASCII text file that contains a collection of line style definitions.062. IPLOT line styles plot the same regardless of the plot scale because they are defined in actual units. The numbers in parentheses define the lengths of the dashes and gaps that represent the style. the following pen table example plots all elements on Level 1 with the dash-dot line style.062. Other valid units include millimeters (mm). if (level == 1) then style = ’dash-dot’ endif MicroStation’s custom line styles are much more flexible and powerful than IPLOT line styles.0) = (0. 0. 0.125. and the dash/gap pattern would repeat through the end of the line. the dashes and gaps in MicroStation’s line styles are defined in working units and will plot at varying lengths depending on the plot scale.062. 0. In contrast. 0. 0. a line drawn with the long dashed line style would start with a 0.030. and meters (m). 0. For example. For example. 0.03. 0.

C H A P T E R 6 InterPlot Client Configuration .

InterPlot for MicroStation .

Uninstall dialog box. Note To remove sub-components of MicroStation or AutoCAD support. 2 In the InterPlot Client Configure dialog box. click Uninstall. Note You must have administrator privileges to remove the product. and then click OK. 4 In the confirmation box. check the individual components you want to remove. click Change Option. 6-1 . To remove the software 1 Select Start->Programs->InterPlot Utilities->InterPlot Client Configure.Uninstalling the Product You can use the Uninstall option to remove some or all of the components of this product from your computer. click Yes to remove the product components or No to cancel the removal process. 3 In the InterPlot Client Configure . or click Select All to check all of the components.

click Commercial Product Registration. 6 You will receive an email from Bentley Systems containing the license file. 5 To register a Bentley product. Note The Register dialog box contains a link that displays the filename for the license file. 4 From the Bentley Product Registration Page. To register the software 1 Select Start->Programs->InterPlot Utilities->InterPlot Client Configure. please fill out this form and click the REGISTRATION button when you have answered all the questions.Registering the Product You can use the InterPlot Client Configure utility to properly register your software. Save this file into the c:\Program Files\Common Files\InterPlot\Licensing folder to complete the registration process. 6-2 . You will need this information to properly register your software.Register dialog box. Note The computer name and computer code is displayed on this dialog. 2 In the InterPlot Client Configure dialog box. 3 In the InterPlot Client Configure . InterPlot products that are not registered properly will produce plots containing watermarks. click Register Online. click Register.

you can determine which version to use as the print/preview engine. click Integrate.Integrating with MicroStation or AutoCAD The Integrate option allows you to integrate the APLOT dialog box with your current AutoCAD environment or the IPLOT dialog box with your current MicroStation environment. the latest version of MicroStation will be used for the MicroStation print/preview engine. click OK. or when you choose not to integrate with AutoCAD. or MicroStation after you install this InterPlot product. select the MicroStation or AutoCAD tab. 4 To complete product integration. If you have multiple versions of MicroStation installed. 6-3 . You can determine which version(s) of MicroStation or AutoCAD you want to integrate with the IPLOT/APLOT dialog interface. You can also use this dialog to determine which MicroStation product to use as the print/preview engine. Note By default. 3 In the InterPlot Client Configure .Integrate dialog box. 2 In the InterPlot Client Configure dialog box. You should use Integrate when you install a new version of AutoCAD. To integrate with MicroStation or AutoCAD 1 Select Start->Programs->InterPlot Utilities->InterPlot Client Configure. or MicroStation during the installation process.

This product includes five configuration files: IP. 6-4 . such as where it creates files. use the InterPlot Client Configure utility or the InterPlot Organizer Edit -> Configuration command. or how it stores filenames. To edit these configuration files.CFG --define APLOT-related variables for plotting AutoCAD data These configuration files control the system-level behavior of the product.CFG --define IPLOT-related variables for plotting MicroStation data APLOT. Each variable controls some aspect of the product’s behavior. where it looks for files.What are Configuration Files? Configuration files define configuration variables that control the behavior of the product.CFG --defines product level/common variables IPLOT. You can customize the product by adding or modifying variable values in any of these files.CFG and APLOTSRV.CFG and IPLOTSRV. A default version of each of these files is delivered with the product.

You can use configuration variables to define other configuration variables. Each variable in the default configuration files includes a comment that describes the behavior it controls. If a variable’s value contains the name of a previously-defined variable preceded by a dollar sign ($). For example. Variable names with IPLOT_DLOG apply only to the IPLOT dialog box.Configuration File Format Configuration files are ASCII files. the entire value must be quoted. Any time a value contains a space. 6-5 . a filename. Example: IP_WORK_DIR = $IP_PRODUCT_DIR\wrk You can also use percent (%) include = filename to reference another configuration file from within a configuration file. Each line in the configuration file contains a variable definition or a comment.cfg Comments Comments are explanatory text in the configuration file. Variable Definitions Variable definitions have the following form: name=value Name is the name of an InterPlot configuration variable. InterPlot replaces the variable name and the $ sign with the variable’s value.). InterPlot ignores comments when it reads the file. Depending on the variable. All text to the right of a pound sign (#) is treated as a comment.cfg" %include = \\serv2\plot\site. In most cases. Spaces around the equal sign (=) are optional.). Examples: %include = "c:\users\plotfiles\common. value is a keyword such as true or false. Example: # This is a comment line. The following list includes several examples: Variables with names ending in DIR must contain a single directory name. the name of the variable indicates the type of value it contains or identifies. or a list of directory names delimited by semicolons (. or the user interface to which it applies. you could use % include to centralize the configuration file on a file server. Defining groups of related variables this way makes it easier to modify the configuration file if your system changes. a directory name. for ease of administration. Variable names with APLOT_DLOG apply only to the APLOT dialog box. You can also insert blank lines to make the files easier to read. Variables with names ending in PATH contain a directory name or a list of directory names separated by semicolons (.

CFG) defines variables that control the general behavior of this product. You can access the Common configuration file through the InterPlot Client Configure utility or the InterPlot Organizer Edit -> Configuration command. All configuration variable definitions for settings files are defined in this file. 6-6 .Common Configuration File The Common configuration file (IP.

CFG is a configuration file that contains variables used by the IPLOT command line. dialog. InterPlot uses MicroStation font and line style resources. the configuration files on the client and server must access the same resources. You can access the IPLOT MicroStation configuration files with the InterPlot Client Configure utility or the InterPlot Organizer Edit -> Configuration command. This product supports two types of IPLOT MicroStation configuration files: Client and Server. and Organizer interfaces. 6-7 .MicroStation Configuration Files IPLOT MicroStation configuration files define variables that control how MicroStation data is plotted. Client Configuration File IPLOT.CFG is a configuration file that contains search paths used to locate resource files (IPLOT patterns and line styles) and variables that control how the plot is rendered. Server Configuration File IPLOTSRV. Note To ensure that your plot previews are displayed as they will plot. For more information see Using MicroStation Resource Files.

AutoCAD Configuration Files
AutoCAD configuration files define APLOT variables that control how AutoCAD data is plotted. This product supports two types of AutoCAD configuration files: client and server. You can access the AutoCAD configuration files with the InterPlot Client Configure utility or the InterPlot Organizer Edit -> Configuration command.

Client Configuration File
APLOT.CFG is a configuration file that contains variables used by the APLOT command line, dialog, and Organizer interfaces.

Server Configuration File
APLOTSRV.CFG is a configuration file that contains search paths used to locate resource files and variables that control how the plot is rendered. If InterPlot Server is not installed on this machine, the server configuration file controls the behavior of Print Preview.

6-8

Using MicroStation Resource Files
By default, InterPlot will use the font and line style resources (FONT.RSC and LSTYLE.RSC) referenced by the default MicroStation workspace. If your organization uses customized font or line style resources, InterPlot enables you to specify a custom workspace. Each InterPlot Client interface provides a method for specifying a workspace. In InterPlot Organizer, specify the workspace name in the “Workspace” field on the General Property Sheet. In the IPLOT dialog box, specify the workspace name using the File -> Set Workspace command. From the IPLOT command line, specify the workspace name on create or modify as follows: -workspace=<workspace name> Note See your MicroStation documentation for information about defining workspaces. If the plot server uses font resources on a remote file server, they must be specified in the MicroStation workspace UCF file using Universal Naming Convention (UNC) file names (that is, no mapped drives). You must also edit the registry on the remote file server which those UNC file names refer to.

6-9

InterPlot for MicroStation

6-10

C H A P T E R 7 InterPlot Server and the Server Utilities .

InterPlot for MicroStation

What is InterPlot Server?
InterPlot® Server is the server component of Bentley Systems network production plotting system (InterPlot). It serves as the print engine for the following InterPlot client products: InterPlot Client, InterPlot Professional, IPLOT Client 8.0, and APLOT Professional 1.0. These clients will offload plot processing to InterPlot Server for producing high-quality plots on any Windows-supported plotter or printer. Workflow InterPlot Server processes plot jobs from InterPlot client products. Computers with the InterPlot Server software installed are referred to as plot servers. Computers with InterPlot client products installed are referred to as clients. When a plot server receives a plot job from a client, the InterPlot Server software processes and sends the data to a printing device. The following InterPlot configuration illustrates network plot production.

7-1

What ’s New? Clients Served by InterPlot Server
InterPlot Server is the print engine for the following products: InterPlot Client InterPlot Professional IPLOT 8.0 APLOT Professional 1.0

New Product Licensing
Setup no longer requires you to enter a registration number during product installation. This means that InterPlot products will place a watermark on all plots until a license file is obtained from Bentley Systems.

Better Intergration with CAD Products
The InterPlot Server Configure utility enables you to select which MicroStation product to use as the IPLOT print engine.

Improved MicroStation Workspace Validation
Improved workspace validation on the plot server. The new IPLOT configuration variable IPLOTSRV_WORKSPACE_VALIDATION enables InterPlot Server a more flexible approach for locating MicroStation user workspace configuration files.

Accounting Enhancements
The InterPlot pen table language has been enhanced to enable the automatic extraction of data from MicroStation and AutoCAD files. This data is written to the accounting file. For more information, see the "How To" section of the InterPlot Reference Help version 10.0. The Accounting utility now displays the accounting data in a spreadsheet-like display. You can limit the display of the accounting file to particular fields of interest and export the data to a file suitable for importing into applications like Microsoft Excel. The Accounting file contains the following additional variables that can be used for billing purposes to more accurately determine the amount of media used: PAPER_LENGTH, PAPER_WIDTH, and PRINTED_AREA.

7-2

3 In the InterPlot Server Configure . click Yes to remove the product components or No to cancel the removal process. 2 In the InterPlot Server Configure dialog box.Uninstalling the Product You can use the Uninstall option to remove some or all of the components of this product from your computer. check the individual components you want to remove. and then click OK. or click Select All to check all of the components.Uninstall dialog box. 7-3 . Note You must have administrator privileges to remove the product. click Uninstall. To remove the software 1 Select Start->Programs->InterPlot Utilities->InterPlot Server Configure. 4 In the confirmation box.

7-4 . To integrate with MicroStation 1 Select Start->Programs->InterPlot Utilities-> InterPlot Server Configure.Integrate dialog box. 4 To complete product integration.Integrating the Product The Integrate option allows you to integrate InterPlot Server with your installed MicroStation products. the latest version of MicroStation will be used for the MicroStation print engine. You can also use this dialog to determine which MicroStation product (MicroStation 95 or later) to use as the print engine. click Integrate. 2 In the InterPlot Server Configure dialog box. 3 In the InterPlot Server Configure . Note By default. select the MicroStation product to use as the print engine. click OK.

6 You will receive an email from Bentley Systems containing the license file. please fill out this form and click the REGISTRATION button when you have answered all the questions. 7-5 . Save this file into the c:\Program Files\Common Files\InterPlot\Licensing folder to complete the registration process. 3 In the InterPlot Server Configure . click Register Online.Registering the Product You can use the InterPlot Server Configure utility to properly register your software. To register the software 1 Select Start->Programs->InterPlot Utilities-> InterPlot Server Configure. click Register. 2 In the InterPlot Server Configure dialog box. 4 From the Bentley Product Registration Page. Note The Register dialog box contains a link that displays the filename for the license file. You will need this information to properly register your software.Register dialog box. InterPlot products that are not registered properly will produce plots containing watermarks. click Commercial Product Registration. Note The computer name and computer code is displayed on this dialog. 5 To register a Bentley product.

such as where it creates files. where it looks for files. To edit these configuration files. 7-6 . use the InterPlot Server Configuration utility. A default version of each of these files is delivered with the product. or how it stores filenames.CFG --defines APLOT-related variables for plotting AutoCAD data These configuration files control the system-level behavior of the product. Each variable controls some aspect of the product’s behavior.CFG --defines IPLOT-related variables for plotting MicroStation data APLOTSRV.What Are Configuration Files? Configuration files define configuration variables that control the behavior of the product. You can customize the product by adding or modifying variable values in either of these files. This product includes two configuration files: IPLOTSRV.

for ease of administration. you must edit the registry on the machine(s) pointed to by the UNC file names in the InterPlot Server configuration files. 7-7 . In most cases. a directory name. If a variable’s value contains the name of a previously-defined variable preceded by a dollar sign ($). You can use configuration variables to define other configuration variables. All text to the right of a pound sign (#) is treated as a comment. the name of the variable indicates the type of value it contains or identifies.cfg Note InterPlot Server configuration files support UNC file names. Each line in the configuration file contains a variable definition or a comment. Depending on the variable. or a list of directory names delimited by semicolons (.).cfg" %include = \\serv2\plot\site. Each variable in the default configuration files includes a comment that describes the behavior it controls. you may encounter security problems when processing plot jobs from client machines. InterPlot ignores comments when it reads the file. value is a keyword such as true or false. Variable Definitions Variable definitions have the following form: name=value Name is the name of an InterPlot configuration variable. Example: IPLOTSRV_LINESTYLE_LIB = $IPLOTSRV_PRODUCT_DIR\resrc\system\style. For example. Variables with names ending in PATH contain a directory name or a list of directory names separated by semicolons (. Comments Comments are explanatory text in the configuration file. You can also insert blank lines to make the files easier to read.). Example: # This is a comment line.plb You can also use percent (%) include = filename to reference another configuration file from within a configuration file. Spaces around the equal sign (=) are optional. you could use % include to centralize the configuration file on a file server.Configuration File Format Configuration files are ASCII files. To correct the problem. The following list includes several examples: Variables with names ending in DIR must contain a single directory name. InterPlot replaces the variable name and the $ sign with the variable’s value. a filename. Defining groups of related variables this way makes it easier to modify the configuration file if your system changes. Any time a value contains a space. Examples: %include = "c:\users\plotfiles\common. the entire value must be quoted. If you use UNC file names.

MicroStation Configuration File The MicroStation configuration file defines IPLOT variables that control how MicroStation data is plotted. 7-8 . the configuration files on the server and client must access the same resources. Note To ensure that your plots match the plot previews on the client. IPLOTSRV.CFG is a configuration file that contains search paths used to locate resource files and variables that control how the plot is rendered.

C

H

A

P

T

E

R

8

InterPlot Drivers

InterPlot for MicroStation

What’s New?
The following is a summary of new features: Windows 2000 Compatibility. Support for the Xerox 8825 printer. Support for the Océ 9300 and Océ 9400 II printers. Support for the following DesignJet printers, the HP DesignJet 500, HP DesignJet 800, HP DesignJet 1050, HP DesignJet 1055CM, HP DesignJet 2000CP, HP DesignJet 2500CP, HP DesignJet 3000CP, and the HP DesignJet 3500CP printers. Updated PCL/5 monochrome and PCL/5 color drivers with a user configurable resolution field. The Accounting utility now displays the accounting data in a spreadsheet-like display. You can limit the display of the accounting file to particular fields of interest and export the data to a file suitable for importing into applications like Microsoft Excel. The Accounting file also contains the following additional variables that can be used for billing purposes to more accurately determine the amount of media used: PAPER_LENGTH, PAPER_WIDTH, and PRINTED_AREA.

8-1

when billing projects/departments and ordering printer supplies based on printer usage. and who sent the file. The driver is the component that configures and formats the data into the language (printer commands) that the printer recognizes. The various InterPlot Driver Pack drivers support the following printer languages: HPGL HPGL/2 HPRTL (Hewlett-Packard Raster Transfer Language) CPGL CCRF (CalComp Compressed Raster Format) Cals/G4 PCL/5 Printers created using InterPlot printer drivers support both Windows applications (such as Microsoft Word and Excel) and InterPlot applications (such as IPLOT and APLOT). In addition to the drivers. are common uses of plot labels. thereby assisting in troubleshooting printing problems. the date the file was printed. The same Printers folder commands provided for managing native Microsoft drivers are also provided for the InterPlot drivers. 8-2 . Some of the drivers in the InterPlot Driver Pack have been written specifically for particular printer models. The InterPlot printer drivers provide several methods for changing the appearance of a plot. thus enabling a user defined text string to appear at the bottom of each plot job.About the InterPlot Driver Pack The InterPlot Driver Pack provides a set of printer drivers that support a wide variety of printers. Information such as the name of the file. Changes can be made to affect all plot jobs or on a per-plot basis. Driver setup is performed from within your system’s print facility. The InterPlot Driver Pack also enables you to have plot labels associated with each job. the driver pack also includes error logging and accounting utilities. as well as manipulation of the plot jobs is also performed from within your system’s print facility. Error logging enables you to maintain error log information for each printer on the plot server. This information enables system administrators to keep track of printer workloads and can be used. while others are considered generic drivers that can work with most printers capable of accepting the driver’s printer commands. for example. See Changing a Plot’s Characteristics for more information. These methods vary depending on the type of application you are using. A printer driver is one of the software components involved in the printing process. Monitoring. Accounting enables you to generate accounting information for each job the printer processes on the plot server.

System Requirements The InterPlot Driver Pack requires certain hardware and software components to be able to run properly. Microsoft Windows 2000 Server. Microsoft Windows NT Workstation 4.0.0. Microsoft Windows NT Server 4. or Microsoft Windows 2000 Professional An Intel Pentium II processor or later 64 MB of RAM (minimum) 15 MB of available disk space for installation CD-ROM drive 8-3 .

Registering the Product You can use the InterPlot Driver Pack Configure utility to properly register your software. click Register Online. please fill out this form and click the REGISTRATION button when you have answered all the questions. 4 From the Bentley Product Registration Page. 6 You will receive an email from Bentley Systems containing the license file. click Register. You will need this information to properly register your software.Register dialog box. Note The computer name and computer code is displayed on this dialog. 2 In the InterPlot Driver Pack Configure dialog box. 3 In the InterPlot Driver Pack Configure . 5 To register a Bentley product. Note The Register dialog box contains a link that displays the filename for the license file. InterPlot products that are not registered properly will produce plots containing watermarks. Save this file into the c:\Program Files\Common Files\InterPlot\Licensing folder to complete the registration process. click Commercial Product Registration. 8-4 . To register the software 1 Select Start->Programs->InterPlot Utilities->InterPlot Driver Pack Configure.

8-5 . The Device. and then apply a standard or custom form with Fold set to On. Other printing options may appear in both the Device and Rendering Attributes dialog boxes. Rendering.Specifying Printer Options InterPlot printer drivers provide various methods to change or specify different printing options. There are some printing options that appear only in the Device Attributes dialog box. and Forms Attributes are applied last. For example. if you set Fold to Off in a Rendering Attributes file. and Forms Attributes dialog boxes do not contain the same printing options. Device Attributes are always applied before Rendering Attributes. the plot will be folded. These methods include: Device Attributes Rendering Attributes Forms Attributes You must be careful when the same printing option appears in more than one dialog box since the driver applies them in a particular order. Some or all of these methods can be applied during the printing process. or in both the Rendering and Forms Attributes dialog boxes.

If you specify a plot label in the Device Attributes dialog box. You can also establish a default plot label for each printer. and a different plot label in a Rendering Attributes file. the plot label in the Rendering Attributes file will take precedence. You can also identify what action the InterPlot software should take if a media handling error occurs. and you can set various other attributes depending upon the specific type of printer. Device Attributes are always applied before Rendering Attributes. a media handling error occurs if a print job requests film media.Device Attributes After you install the InterPlot Driver Pack and add a printer.) plot is requested but only 22 inch media is installed in the printer. and Form Attributes are applied last. you can access the InterPlot Device Attributes dialog box and identify what media types and sizes you have installed in the various media source locations. but film media is not installed in the printer. 8-6 . or if an E-size (34x44 in. For example.

InterPlot applications use a Rendering Attributes file to override the printer’s default Rendering Attributes. and the same attribute (Fold: On) in a form. or the Graphics Property dialog (Windows 98).0/Windows 2000). You can modify the default Rendering Attributes for a printer. you must create a Rendering Attribute file. Use the rendering_attributes qualifier within the submit interfaces to send the Rendering Attributes file along with the plot request. Media source.Rendering Attributes When you create a printer. and other driver specific options. Media deposit. while Windows applications use the Rendering Attributes button on the Advanced Document Properties dialog (Windows NT 4. 8-7 . Rendering Attributes for InterPlot Applications To override the "default" Rendering Attributes for a printer using the InterPlot command line and dialog submit interfaces. the InterPlot software associates a default set of Rendering Attributes with that printer. If you specify an attribute (Fold: Off) in a Rendering Attributes file. or the Graphics Property dialog (Windows 98). but before Forms Attributes. Folding options. the Forms Attribute will take precedence. The default Rendering Attributes affect each plot request submitted to that printer. You can use this option to specify a desired set of Rendering Attributes to be sent along with a plot set. The Device Control dialog box displays the various Rendering Attributes that you can modify. Use the Graphical Attribute Editor to create or modify Rendering Attributes files. causing the plot to be folded. Rendering Attributes include Rendering options.0/Windows 2000). Cutting options. InterPlot’s Organizer interface offers an additional option within the Print Setup and Print dialog boxes called InterPlot Attributes. Windows applications can override the default Rendering Attributes for the printer by selecting a form which has the desired options defined or by using the Rendering Attributes button on the Advanced Document Properties dialog (Windows NT 4. or you can choose to override the printer’s default Rendering Attributes during plot submission. Rendering Attributes are applied after Device Attributes. Rendering Attributes for Microsoft Applications Applications that submit print requests using the Windows printing workflow of File -> Print can define default Rendering Attributes using the Document Defaults command for the printer.

For InterPlot applications.Forms Attributes You can use the Forms option within the InterPlot Device Attributes dialog box to assign options to existing or custom forms. Forms Attributes are applied after Device and Rendering Attributes. or the default Rendering Attributes for the printer. causing the plot to be folded. Options specified with values other than "Default". will override the settings specified in the Rendering Attributes file (if submitted). you can use the paper_size qualifier when the IPARM/APARM file is created. and the same attribute (Fold: On) in a form. See your Windows NT documentation for creating custom forms. or the default Rendering Attributes for the printer. Those options defined as "Default". 8-8 . to specify an existing or custom form. on the Forms Attributes dialog. the forms attribute will take precedence. Windows applications that submit print requests using the Windows printing workflow of File -> Print can select a form with the desired options defined. will use the settings specified in the Rendering Attributes file (if submitted). If you specify an attribute (Fold: Off) in a Rendering Attributes file. InterPlot ’s Organizer interface supports the use of the paper_size option within the layout property page.

These clients can submit plots from InterPlot applications such as IPLOT and APLOT.0.Creating Printers on a Server Node Creating a printer on a Windows NT 4. To connect to a printer on another node. see Connecting to Printers on a Server Node . This printer can be shared to enable access to clients running Windows NT 4.0/Windows 2000 server node enables both Windows applications and InterPlot applications access to the device that the printer services. 8-9 . or Windows applications such as Microsoft® Word and Excel. Windows 2000. or Windows 98.

Creating Printers Using an InterPlot Printer Driver The process of setting up a printer that uses an InterPlot driver is the same as the process used to set up a printer using one of the native Microsoft drivers delivered with the Windows NT operating system. 8-10 . This modification is accomplished by using the InterPlot Device Attributes dialog box. Double-click the Add Printer icon to create a printer.com/directory. add a new printer to your system. To create a printer on Windows NT 4. refer to the Windows NT 4. choose "Keep existing driver. you can change the default characteristics of your printing device by modifying the Device Attributes. 2 Using the appropriate InterPlot Driver Pack driver for your device. For details on creating printers.0/Window 2000 on-line help." 3 Once the printer is created. See Setting Device Attributes for more information about specific Device Attributes. The options on this dialog box vary depending on the type of device you are using.0/Windows 2000 1 On the server node. access the Printers folder. When prompted to "Keep existing driver" or "Replace existing driver". or visit http://support/microsoft.

com/directory. 8-11 . and then click Next. select a group to display a list of printer names. Type the printer name. Select the Network printer server option.0/Windows 2000 on-line help. then click Next.0 client 1 2 3 4 5 From the Printers folder. double-click the Add Printer icon. Connecting to a printer on a server node enables all applications on the client node access to that printer. refer to the Windows NT 4. Note: If the printer name that you are looking for is not in this list. or click Next to browse for a printer. For more details about connecting to printers. Select the Network printer option. If more than one group is listed.microsoft.0/Windows 2000 Client To print to a shared printer on a server node. To connect to a printer from a Windows 2000 client 1 2 3 4 5 From the Printers folder. and then click Next. Double-click the name of the server node to which you want to connect. verify (on the server node) that the printer is shared. Click Finish. double-click the Add Printer icon. Double-click a printer name. Select Yes if you want this to be your default printer. or visit http://support. you must first connect to it from a client node. To connect to a printer from a Windows NT 4.Connecting to a Printer from a Windows NT 4.

InterPlot for MicroStation 8-12 .

C H A P T E R 9 Using InterPlot with other Windows Applications .

InterPlot for MicroStation .

InterPlot has added the following features: Attaching a Portable Document Format (PDF) file to plot set as reference information Creating Organizer compatible format files using the InterPlot Organizer Printer Driver Attaching a PDF File as Reference Information PDF is the most suitable Web-publishing format for small-format. such as word processing files and spreadsheets. 9-1 . DPR files can be added directly to a plot set using InterPlot Organizer. DPR is the most suitable Web-publishing format for large-format. To accommodate both small-format and large-format documents. Creating Organizer Compatible Format Files Organizer compatible format files (DPR) can be created using the InterPlot Organizer Printer Driver.Introduction to Plotting Windows Applications InterPlot now provides the capability to include small-format documents. and Visio Technical®. multi-sheet graphical documents created from applications such as Microsoft Project®. in your plot sets. text-based Office® documents created from applications such as Microsoft Word® and Microsoft Excel®. You can create PDF files from these applications using Adobe® Acrobat® PDF Writer or Acrobat Distiller. such as project schedules and drafting data. The new InterPlot Organizer Printer Driver is delivered with InterPlot Client and InterPlot Professional. The archive Web page displays the PDF file as a link. A PDF file can be attached to a plot set as reference information. as well as large-format documents.

This capability allows you to associate data from Office applications with your plot sets.) The Plot Set Table of Contents page displays a link to the PDF file. InterPlot Organizer provides a way to attach a PDF file to a plot set. (A plot set can have only one attached PDF file. small-format (A or B size) documents. such as the Acrobat PDF Writer or Acrobat Distiller. You can generate PDF files from Office applications using the tools provided in Adobe Acrobat. 9-2 . The following diagram illustrates the process of associating a PDF file with a plot set. Office applications such as Microsoft Word and Microsoft Excel typically generate multi-page. and printing these types of text-based documents over the Web.Attaching a PDF File as Reference Information InterPlot now provides a way to attach a PDF file to a plot set as reference information. Web viewers can double-click the PDF file link and view or print the file using the Adobe Acrobat Reader. viewing. and to make this data available over the Web when viewing a digital archive. PDF is the most suitable file format for distributing.

See InterPlot Organizer Help for more information about creating and editing settings files. To attach a PDF file to a plot set 1 From InterPlot Organizer. 4 Click OK. 3 Enter any attributes you want to associate with the plot set. you can attach it to a plot set using InterPlot Organizer. You can also use Organizer’s settings file editor to specify a PDF file in the Common section of a settings file. or click Browse to select the file. 9-3 . type the name of the PDF file in the PDF File text box. Note Organizer allows only one PDF file to be associated with a plot set. 2 In the Plot Set Attributes dialog box.Attaching a PDF File to a Plot Set After you create a PDF file from your Office application. select File -> Attributes.

After you create a DPR file from your application. You must first submit the DPR files to an archive using InterPlot Organizer. DPR files generated using the InterPlot Organizer printer driver can not be handled directly by the InterPlot Web Plot control. The following diagram illustrates the process of creating plots from DPR files and submitting them to a digital archive. you can add it to a plot set and submit it to an archive using InterPlot Organizer. however. Notes This feature is not supported with Windows 98. 9-4 . The DPR format. is well-suited for handling this large-format hybrid engineering data efficiently. and Visio Technical typically produce large vector and raster data. Applications such as Microsoft Project. Since PDF files created from these applications are very large. they are unsuitable for archiving and Web distribution.Creating Organizer Compatible Format Files (DPR) This release of InterPlot Client/Professional includes a new InterPlot Organizer Printer Driver for creating Organizer compatible format files (DPR) from large-format Windows applications which contain mostly graphical data.

and then click OK. listed in the Command Setup dialog box. 12 Select Bentley from the Manufacturers list box. 11 Click Next. To create the InterPlot Organizer printer: 1 Select Start -> Settings -> Printers. In addition to saving the DPR file to disk when printing from Windows applications. 7 From the Job Storage Definition dialog box. and then click New Port. 6 Enter a port name. 16 Click Finish. 3 Click My Computer. Creating the InterPlot Organizer printer is much like creating any Windows NT printer. and then click Next. The only exception is that the InterPlot Organizer printer requires a special port that determines the location and file-naming pattern for the DPR files. select the output directory for the DPR files. 14 Enter the printer name. 5 Select the InterPlot Organizer Port.exe. and then click Next. The Organizer utility command. and the InterPlot Organizer Printer Driver from the Printers list box.Creating the InterPlot Organizer Printer Both InterPlot Client and InterPlot Professional products install the new InterPlot Organizer Printer Driver. 8 Click Pattern Setup to change the file-naming pattern for the DPR files. 4 Click Add Port. and then click Next. 13 Select Keep Existing Driver and then click Next. 15 Click Shared. and then click Next. 10 Click OK to dismiss the Job Storage Definition dialog box.exe) after the DPR file is generated. 9-5 . orgutil. if this printer is to be shared over the network. 9 Click Command Setup to enter any command or utility that is to be run after the printer driver generates the DPR file. the InterPlot Organizer Port Monitor provides a Command Setup dialog box to invoke any command (*. enables the port to invoke Organizer and add the DPR file to an existing plot set or to a new plot set.bat) or utility (*. 2 Double-click Add Printer. then click Close to dismiss the Printer Ports dialog box.

You can specify a command to be executed in the Command Setup dialog box.Integration with InterPlot Organizer After you create the InterPlot Organizer printer. Note When using Windows 2000. The InterPlot Organizer Port Monitor The InterPlot Organizer Port Monitor provides a configuration option to execute a specified command after the printer driver has generated a DPR file from your Windows application. select Default and then click OK. InterPlot Organizer is invoked and the DPR file is added to the existing plot set. the DPR file is added to the existing plot set without invoking InterPlot Organizer.bat).exe. By default. In the "Default Authentication Level" list box. To execute this command. You can drag and drop the DPR files into Organizer. If you check the Invoke InterPlot Organizer check box and enter an existing plot set (*. click the Browse button to locate and open another executable (*. you can print large sheet-based engineering drawings to create DPR files. check the Execute Command check box. Then.ips) file. Run dcomcnfg and click the "Default Properties" tab. orgutil. or you can add them to a plot set from the Create Plots option. There are several ways to configure the plot set options. you can specify further options in the InterPlot Organizer Plot Set Options dialog. this dialog box displays the Organizer utility command.exe) or batch file (*. you must run dcomcnfg for the orgutil command to work properly. when you print from your Windows application using the InterPlot Organizer printer. If you enter a plot set file without checking the Invoke InterPlot Organizer box. 9-6 .

InterPlot Organizer is invoked and the DPR file is added to a new plot set.If you check the Invoke InterPlot Organizer check box without entering a plot set file. 9-7 .

InterPlot for MicroStation 9-8 .

or Image Manager with you InterPlot product. if you are using MicroStation Modeler you may want to set this variable to TRUE. Plotting MicroStation Raster Products with InterPlot Some setup is required for you to plot MicroStation raster products inside the InterPlot client submit interfaces. Select Start – Programs – InterPlot Utilities – InterPlot Client Configure. to allow plotting of part assemblies. Click Integrate. and Image Manager InterPlot provides support for Descartes. Raster Manager.38 or later. Direct plotting is much faster than the traditional workflow of starting up a separate background process to stroke the plot. creating an IPARM file. the traditional workflow is followed. Raster Manager. setting this variable to AUTO is appropriate. 2. Configuring IPLOT. 9-9 . If no raster is present. and plotting it in a separate background process. and Raster Manager for MicroStation SE and MicroStation/J. The following steps are recommended for the IPLOT Dialog Interface: Integrate InterPlot with your MicroStation raster product Configure IPLOT.CFG for the IPLOT Command Line and Organizer interfaces Set the resolution in the IPLOTDRV. this variable is set to AUTO. Click OK twice. To integrate InterPlot with your raster product 1. You will need to properly integrate InterPlot with the raster product that you are using in order for MicroStation plotting to work properly. Image Manager.PLT file (Optional) The following steps are recommended for InterPlot Organizer and the IPLOT Command Line interfaces: Integrate InterPlot with your MicroStation raster product Configure IPLOT. Auto mode senses if raster images are present and uses the direct mode for plots containing raster.Using InterPlot with Descartes. generating a metafile. Integrating InterPlot with your MicroStation Raster Product The InterPlot Client Configure utility enables you to integrate MicroStation raster products such as Descartes. In most cases. However. 3.CFG for the IPLOT Dialog Interface There is an IPLOT configuration variable (IPLOT_DLOG_USE_DIRECT_MODE) that has been added for the IPLOT Dialog interface when plotting raster images from Descartes. select the raster product you are using.CFG for the IPLOT Dialog Interface Set the resolution in the IPLOTDRV. * Requires Raster Manager 7.36. Raster Manager and Image Manager enable you to control the display of one or more image files within a MicroStation design file. 4. In the MicroStation Raster Support field. By default. and Image Manager. Descartes enables you to view and edit the raster images displayed within the design file. and then click Exit. The following chart displays the supported InterPlot workflows.dpr). Direct mode or "direct plotting" uses the active MicroStation process to stroke the plot to output a graphics metafile (.PLT file (Optional) The following sections describe in detail how to complete the above steps.11. Raster Manager.

the resolution should be increased to be equal to the printer resolution. The "pixel_resolution" field gives the raster resolution in dpi. This file resides in the c:\Program Files\Common Files\InterPlot\IPLOT\bin folder. 9-10 . When set to TRUE.11. When you attach a raster file with Raster Manager. To adjust the plotting resolution.ucf (user workspace configuration) file. For line art or monochrome data. IPLOT works in its traditional mode. Use FALSE if you want Type 90 Raster Reference files to plot as they did in previous versions. Specifying the correct workspace enables InterPlot to locate the raster files during the plotting process.PLT file. IPLOT uses a newer method which relies on the MicroStation graphics engine on the client to read and manipulate image files present in the design file . This modified MS_REFDIR is stored inside the user. Raster Manager updates the MS_RFDIR search path to include the directory where the raster file resides.36. but not for color line work and scanned monochrome (binary) image data. FALSE is the best setting for I/RAS B and I/RAS C compatibility. In order to plot raster data from the command line and Organizer interfaces.When this variable is set to FALSE. it is necessary to modify the IPLOTDRV.CFG for the IPLOT Command Line and Organizer Interfaces The IPLOT Command Line and InterPlot Organizer interfaces can plot raster data associated with MicroStation/J and Raster Manager (version 7. This is done so that the raster file can be found when you open the master design file.38 or later). The default value is TRUE. IPLOT_LOCAL_STROKE_RASTER determines how IPLOT processes raster image files. you can use the InterPlot Client Configure utility to edit the IPLOT. Many Raster Manager files will not plot accurately with this setting.CFG file and set the variable value for IPLOT_LOCAL_STROKE_RASTER to TRUE. Configuring IPLOT. Note Be sure to use the correct workspace name. Setting the Resolution with the IPLOTDRV. When set to FALSE. IPLOT uses its older traditional method.PLT File By default. all image data is subsampled during the plotting to 150 dots per inch (dpi). This is adequate for color and gray scale images. which transfers image files to the server for processing by InterPlot Server. meaning that IPLOT works as it does in previous releases.

Introducing ProjectWise ProjectWise is a Bentley product that provides Electronic Document Management Systems (EDMS) functionality. One of the benefits for using ProjectWise is to put all of your plotting files in a central location. 9-11 . InterPlot Organizer can access files in a ProjectWise Datasource. ProjectWise provides document storage. and the ability to associate applications with documents and run those applications from ProjectWise. workflow management. document attribution. Users can store all of their plotting files in a ProjectWise Datasource and then access them using InterPlot Organizer as if they were on the local drive. controlled access. so that everyone has access to the same data without having to duplicate files and shares on every client machine.

Make the following Program Associations: Associate <Product_Directory>\bin\iplotorg.Integrating Organizer with ProjectWise There are three steps to properly integrate InterPlot Organizer with ProjectWise. 3 Type in the User Name and Password in the ProjectWise Explorer Login window. Making Program Associations on the Client Perform the standard installation of ProjectWise on the client machine.exe with "APLOT Feature" (required if you want the APLOT Feature Table editor fully integrated with ProjectWise) To make a Program Association 1 Select Start – Programs – ProjectWise – ProjectWise Explorer. and then select the New – Applications command. Add the following Applications: Add "IP Organizer" with an extension of "ips" Add "IPLOT Feature" with an extension of "ftb" (required if you want the IPLOT Feature Table editor fully integrated with ProjectWise) Add "APLOT Feature" with an extension of "aft" (required if you want the APLOT Feature Table editor fully integrated with ProjectWise) To add a new Application 1 Select Start – Programs – ProjectWise – ProjectWise Administrator. 4 Select Tools – Program Associations. you will need to use the Program Associations command to associate the application with its corresponding executable. The three steps are to: Add new Applications on the ProjectWise Server Make Program Associations on the client Add an InterPlot Plot Set (IPS) file to the ProjectWise Datasource Adding New Applications on the ProjectWise Server Perform the standard installation of ProjectWise on the server machine. To expand the tree. In order to complete these steps. and then click Add. 9 Double-click on Arguments and type in a single space. you will need to add new Applications on the ProjectWise Server. To expand the tree. Afterwards. click OK. click the PLUS SIGN (+). 2 Expand the tree down to the Datasource. 5 Expand the tree under IP Organizer and then double-click OPEN. 8 Double-click on Partner Application to set it to YES. 7 Expand the tree under the new association.exe with “IP Organizer. 4 Right-click on the Applications icon. (This fixes a problem with an uninitialized string in ProjectWise. 6 To dismiss the New Applications dialog.exe with "IPLOT Feature" (required if you want the IPLOT Feature Table editor fully integrated with ProjectWise) Associate c:\win32app\ingr\ipshare\bin\apfte.) Note Be sure to repeat steps 5-9 for the IPLOT and APLOT Feature Table editors if you want them to be fully 9-12 .” Associate c:\win32app\ingr\ipshare\bin\ipfte. Once installed. 3 Click on the Datasource name.exe. click the PLUS SIGN (+). you will need to know the User Name and Password to the ProjectWise Datasource on the ProjectWise Server. type in the application name in the Name field and the extension in the File Extensions field. 5 From the New Applications dialog. 6 Associate InterPlot Organizer with <Product_Directory>\bin\iplotorg. and then type in the User Name and Password in the ProjectWise Login window. 2 Expand the tree for the Datasource.

Once InterPlot Organizer has invoked a plot set file within ProjectWise.integrated with ProjectWise. InterPlot Organizer exposes the ProjectWise File Open and File Save dialogs. Adding an InterPlot Plot Set (IPS) file to the ProjectWise Datasource The final step to properly integrate InterPlot Organizer with ProjectWise is to add an InterPlot Plot Set (IPS) file to the ProjectWise Datasource. When a plot set file is invoked from a ProjectWise Datasource. Two ways to add an Plot Set File to a ProjectWise Datasource Create an empty plot set file with InterPlot Organizer and then drag and drop it into a ProjectWise Datasource. the Program Associations dialog should look similar to the one shown below. press the Cancel button on the ProjectWise dialogs. you can use Organizer ’s File New command to create additional plot set files to a ProjectWise Datasource.exe create plot_set_name. You can also use the InterPlot Organizer command line to create an empty plot set file ( <Product_Directory >\bin\iplotorg. The ProjectWise dialogs allow you to access files being managed by ProjectWise and to save files to a ProjectWise Datasource.ips). If you wish to use InterPlot Organizer’s standard File Open and File Save dialogs. 9-13 . Once the Associations have been made.

InterPlot Organizer does not automatically copy out or check out ancillary files referenced in a Settings file. First. you would then have to modify every plot. project settings files. If a Settings file references ancillary files (such as pen tables or feature tables) that are located in a ProjectWise datasource. pen tables. rendering attribute files. Work in Organizer as you normally would. you would need to check in the plot set file and all of the files referenced by it. In addition to having the same files. feature tables. Exit and Save the Organizer session when you are finished. the files must reside in the same locations. just reference the plotting files from a ProjectWise Datasource instead of your local drive or a shared drive. but it is not an automatic process. then everyone that uses the plot set must have the same files on their local drive. Once it’s invoked from ProjectWise. raster files. one of the benefits for using ProjectWise is to put all of your plotting files in a central location. If you create new files such as pen tables or feature tables. It is possible to import this type of plot set file and have it work properly. so that everyone has access to the same data without having to duplicate files and shares on every client machine. Plot Set Files Created Outside of ProjectWise If an existing plot set file references files on a local drive and you check it into a ProjectWise Datasource. be sure to save them to a ProjectWise Datasource and not the local drive or a shared drive. and reference/xref files. 9-14 . Plotting files include color tables.Workflow for Organizer and ProjectWise The recommended workflow when using InterPlot Organizer with ProjectWise is as follows: Double-click an InterPlot Plot Set (IPS) file in a ProjectWise Datasource to run Organizer. As stated earlier. design/drawing files. making sure that each file it references is located in the ProjectWise Datasource. be sure to copy out or check out these files to the appropriate folder in the ProjectWise working directory before you apply the Settings file.

When a plot set file is invoked from a ProjectWise Datasource. Only one file at a time can be selected using the File Open dialogs (this is a limitation of ProjectWise). 9-15 . If you wish to use InterPlot Organizer’s standard File Open and File Save dialogs.) When referencing files from a ProjectWise Datasource. but the user can change this behavior inside ProjectWise Explorer using the Tools – User Settings – Document List – Double Click Action menu item. use InterPlot Organizer’s Browse buttons instead of the key-in fields. InterPlot Organizer displays the ProjectWise File Open and File Save dialogs. The following graphic displays the ProjectWise File Open dialog. InterPlot Plot Set files are checked out from the ProjectWise Datasource. By default.Accessing Plotting Files from ProjectWise If you have properly integrated InterPlot Organizer with ProjectWise. The ProjectWise dialogs allow you to access files being managed by ProjectWise and to save files to a ProjectWise Datasource. (If you wish to use InterPlot Organizer’s standard File Open and File Save dialogs. press the Cancel button on the ProjectWise dialogs while in InterPlot Organizer. press the Cancel button on the ProjectWise dialogs. The files that get checked out or copied out go to an application-defined directory (dmsnnnnn) under the user’s ProjectWise Datasource working directory on the client machine. All of the files that are referenced in an InterPlot Plot Set file are automatically copied out from the ProjectWise Datasource when the InterPlot Plot set file is invoked from ProjectWise . you can double-click the InterPlot Plot Set (IPS) file from ProjectWise to invoke InterPlot Organizer.

or exits InterPlot Organizer. If the user settings are set to "Leave local copy on free. These files are: Product Configuration files (CFG) InterPlot Organizer’s Default Settings File (IPLOT. ProjectWise uses the same naming convention for all of the directories it creates under the working directory for all Datasources. In general. files that were previously copied out to the working directory on the client machine will not be copied out again if they are up-to-date. File New.InterPlot Plot Set files that are checked out for editing in InterPlot Organizer will be updated when saved and freed for other users upon exiting.SET) Printer Settings Files (PRINTER_NAME. and the dms00069 folder maps to the "pentbls" vault. therefore the plot set file is deleted from the working directory along with all of the files that were copied out." a copy of the plot set file will remain in the working directory along with all of the files that were copied out." provided you are leaving a local copy of all copied out files in the working directory on the client machine. Using the same working directory for multiple Datasources could result in files being overwritten. the dms00068 folder maps to the "dgn" vault. all of the copied out files (design files.SET) 9-16 . For example. ProjectWise Explorer does not leave a local copy when the plot set file is freed. The same working directory should not be used for multiple ProjectWise Datasources. if you double-click a plot set file from ProjectWise to invoke InterPlot Organizer. There could be conflicts of files being removed while they are in use by another user. Notes Two users should not use the same physical working directory (shared drive) for the same ProjectWise Datasource. color tables) will track the InterPlot Plot Set file when the user performs a File Open. Files Not Accessed from the ProjectWise Datasource There are a few files related to InterPlot Organizer that cannot be put into the ProjectWise Datasource. By default. The dms00054 folder on the local drive maps to the "Dave" vault in the Datasource. pen/feature tables. Files from multiple ProjectWise Datasources cannot be referenced in a single plot set file. The following graphic shows the relationship to files in a ProjectWise Datasource to the files checked out or copied out to the client. Another useful user setting in ProjectWise Explorer is "Use up-to-date copy on copy out.