LT On-line: Lesson 111 Feb, 2001 By: Mark Middlebrook
layers, loading, and logs
by Mark Middlebrook
1: Xref layer visibility
My previous two LT Online lessons covered xrefs and how to attach and manage them with the Xref Manager dialog box. This lesson rounds out xref coverage with a trio of topics: how to control xref layer settings with the VISRETAIN system variable, when to use demand loading, and how to troubleshoot xref problems with text window messages and the log file.
The procedures described
here work with AutoCAD LT 98 and 2000 and AutoCAD Release 14 and 2000.
As described in the "Layer-palooza"
If you change the settings of an xref layer in the parent drawing, do the changes persist after you close and reopen the parent drawing?
change the settings of a layer in the child drawing, do the changes appear
the next time you open the parent drawing?
The answer to both of these questions depends on the setting of the VISRETAIN system variable in the parent drawing. VISRETAIN is short for visibility retain, and this system variable determines whether layer settings in the parent drawing or the child drawing control the appearance of xref layers in the parent.
The default VISRETAIN setting is 1 (= on), which means that the parent drawing's settings for xref layers control over the settings for the corresponding layers in the xref drawing itself. For example, assume that you have attached
(the child drawing into
(the parent drawing). If you turn off the xref layer Myscrew|Text in the
that layer will still be off the next time that you open
Furthermore, if you later open
and change its Text layer from red to green, the Myscrew|Text layer ignores
this change. The Myscrew|Text will still be red when you open
If you change VISRETAIN to 0 (= off) in a parent drawing, you tell AutoCAD
that the child drawing's layer settings control over the parent drawing's
settings for the corresponding layers. Each time you open the parent drawing,
AutoCAD applies the current layer settings from the child drawing. For
example, if you turn off the xref layer Myscrew|Text in the parent drawing
it goes off for the current session. The next time that you open
though, the Myscrew|Text layer is back on, because that's its current
Furthermore, if you later open
MYSCREW.DWG and change its
Text layer from red to green, the Myscrew|Text layer reflects this change
when you open
(i.e., the layer Myscrew|Text layer is green).
Note that all of this
VISRETAIN discussion applies only to how the layers appear in the parent
drawing. No matter what you set VISRETAIN to in any drawing, the child
drawing's layers don't change when you change xref layer settings in a
parent drawing. In other words, changes to the Myscrew|Text layer in
don't affect the Text layer in
regardless of what VISRETAIN is set to.
There are ferocious arguments about whether to turn VISRETAIN on or off. I prefer when possible to turn off VISRETAIN and thereby control the visibility and properties of xrefed layers from the child drawings. But you may want to or need to set VISRETAIN to 1 and control xref layer visibility and properties from the parent drawings (in order to be able to assign different properties to the same layer in different parent drawings, for example).
The most important thing is that you choose one method and stick with it. If you aren't consistent, you can't predict whether changing a layer in a parent or child drawing will persist.
In order to change the VISRETAIN setting in AutoCAD or LT 2000, open the Options dialog box (Tools|Options), and choose the Open and Save tab, as shown in the figure below. Click the Retain Changes to Xref Layers check box to turn VISRETAIN off or on. In LT 98 or AutoCAD Release 14, you must type the system variable name at the Command line. Type VISRETAIN,
If all of these abstract file and layer names have your head spinning, the best thing to do is to test both settings:
1. Create a sample parent and child drawings (e.g.,
Draw some objects on different layers in
and xref attach
3. Set VISRETAIN to 0.
4. Use the Layer Properties Manager dialog box to change settings for some of the xref layers in
5. Save and reopen
Note that the layer changes have disappeared.
6. Open Child drawing, make some changes to the layer settings, and save the drawing.
Note that the layer changes from
8. Repeat steps 3 through 7, but set VISRETAIN to 1 instead. Note that in step 5 the layer changes now persist and in step 7 the layer changes from
do not appear in
A tutorial on my Web site demonstrates these concepts.
Autodesk Technical Evangelist Lynn Allen guides you through a different AutoCAD feature in every edition of her popular "Circles and Lines" tutorial series. For even more AutoCAD how-to, check out Lynn's quick tips in the Cadalyst Video Gallery. Subscribe to Cadalyst's Tips & Tricks Tuesdays free e-newsletter and we'll notify you every time a new video tip is available. All exclusively from Cadalyst!
Autodesk University 2013 - Exhibit Hall 4 Dec, 2013
New Video Demo: From Many CAD Systems, One 4 Dec, 2013
Revit 2014 Update Release 1 Now Available For Download - Crash Reductions or Enhancements? 19 Jul, 2013
How to Replace the Viewport Compass with your Company Logo 5 Jul, 2013