Reference Settings Key-ins
Many of the reference file parameters that can be set in the References dialog, also can be set with REFERENCE SET key-ins. These can simplify the task of setting the parameters for groups of files, where you can also use a batch process.
Reference settings key-ins take a string of name/value pairs with the same syntax as required for the MS_REF_DEFAULTSETTINGS configuration variable. Multiple name/value pairs can be separated by commas. If spaces are needed in the name/value pair string, surround the entire name/value pair string with double quotes. One or more references can be specified on the command line, separated from the name/value pair string by a space.
For these key-ins, any case is acceptable, but the full unabbreviated keyword must be present.
For many of the settings, a "setting_spec" value can be specified, which can be any of the following:
When specifying the reference a "file_spec" can be used, which may be the file name or the logical name of the reference.
| References key-in | Description |
|---|---|
| REFERENCE SET ATTACHMETHOD=<setting_spec> <file_spec> | Sets the attachment method to geographic reprojected (setting spec = geoReprojected) or geographic AEC Transform (setting spec = geoAECTransform). |
| REFERENCE SET DISPLAY=<setting_spec> <file_spec> | Turns on/off the display of the defined references. Equivalent to the Display (icon) in the References dialog. |
| REFERENCE SET DRAWINGBOUNDARY <drawing identifier> | Sets the drawing boundary that has the assigned drawing identifier. |
| REFERENCE SET SNAP=<setting_spec> <file_spec> | Turns on/off the ability to snap to the defined references. Equivalent to the Snap (icon) in the References dialog. |
| REFERENCE SET LOCATE=<setting_spec> <file_spec> | Turns on/off the ability to select elements in the defined references. Equivalent to the Locate (icon) in the References dialog. |
| REFERENCE SET SCALELINESTYLES=<setting_spec> <file_spec> | Defines whether or not custom line styles are scaled by the reference scale for the defined references. Equivalent to the Scale Line Styles by Reference (icon) in the References dialog. |
| REFERENCE SET DISPLAYRASTERREFS=<setting_spec> <file_spec> | Defines whether or not raster references display for the defined references. Equivalent to the Display Raster References (icon) in the References dialog. |
| REFERENCE SET PRIORITY=<value between -5 and 5 inclusive> <file_spec> | (2D only) Sets the display priority to be applied to the reference. References with higher priority display in front of others. |
| REFERENCE SET TREATASELEMENT=<setting_spec> <file_spec> | Defines whether or not the defined references may be manipulated with the standard tools. Equivalent to the Treat Attachment as Element for Manipulation (icon) in the References dialog. |
| REFERENCE SET USELIGHTS=<setting_spec> <file_spec> | Defines whether or not light sources in the defined references are considered for rendering. Equivalent to the Use Lights (icon) in the References dialog. |
| REFERENCE SET IGNOREWHENNESTING=<setting_spec> <file_spec> | Controls the display of nested attachments when working in a DWG or DXF file, where live nesting is always on and there is no limit to nesting depth. Equivalent to the Ignore Attachment When Live Nesting (icon) in the References dialog. |
| REFERENCE SET PLOTAS3D=<setting_spec> <file_spec> | (PDF printer driver only) When on and the PDF printer driver is used, the reference is plotted as 3D data in Universal 3D (U3D) format. Equivalent to the Plot As 3D (PDF) (icon) in the References dialog. |
| REFERENCE SET REVISION=<revision> <file_spec> | <revision> can be either the revision number, such as 1.1, or a revision tag. |
| REFERENCE SET ROTATECLIPPING=<setting_spec> <file_spec> | Used to set reference clip rotation to V7 mode (OFF), where the clip boundary is view dependent, or to V8 mode (ON), where the clip boundary is maintained in model coordinates. |
| REFERENCE SET PRINTCOLORADJUSTMENT=<setting_spec> <file_spec> | Where reference colors have been adjusted, sets whether the adjusted (1) or the original (0) colors print. Equivalent to the Print Adjusted Colors setting in the Adjust Colors dialog. |
| REFERENCE SET TRANSPARENCY=<value between 0.0 and 1.0> <file_spec> | Sets the transparency value of the defined references. Equivalent to the Transparency (icon) in the References dialog. |
| REFERENCE SET NESTDEPTH=<integer between 0 and 99> <file_spec> | Sets the nesting depth for the defined references. Equivalent to the Depth setting in the References dialog. |
| REFERENCE SET NEWLEVELDISPLAY=FROMCONFIG|ALWAYS|NEVER <file_spec> | Sets when new levels will display in the defined references. Equivalent to the New Level Display setting in the References dialog. |
| REFERENCE SET NESTOVERRIDES=ALLOW|ALWAYS|NEVER <file_spec> | Sets how overrides are treated in nested references for the defined references. Equivalent to the overrides option menu in the References dialog. |
| REFERENCE SET GLOBALLSSCALE=MASTER|NONE|REFERENCE|BOTH <file_spec> | Defines how custom line styles are scaled for the defined references. Equivalent to the Global Line Style Scale setting in the Attachment Properties dialog. |
| REFERENCE SET SYNCHWITHSAVEDVIEW=ALLSETTINGS|VOLUMEONLY|PRESENTATIONONLY|NONE <file_spec> | If the reference source is a saved view, sets the Synchronize View drop-down to All Settings, Volume Only, Presentation Only, or None. |
| REFERENCE SET USEVIEWFLAGS=<setting_spec> <file_spec> | Sets and clears the Use View Flags check box in the Reference Presentation dialog. When this check box is set, the view attributes can be turned on and off. |