GS GstarCAD Academy
DISPLAY & XREF FIXES

How to Fix Xref Fade (XDWGFADECTL) and Locked Layer Dimming (LAYLOCKFADECTL)

Adjust or disable on-screen dimming of external references (Xrefs) and locked layers in GstarCAD using XDWGFADECTL and LAYLOCKFADECTL without affecting PDF plot output.

⚡ Quick Engineering Answer (TL;DR)

Type XDWGFADECTL at the command prompt and enter a value between -90 and 90 (0 = no dimming, 50 = default 50% fade) to control Xref brightness on screen. Type LAYLOCKFADECTL (0 to 90) to control how much locked layers dim.

1. Root Cause & DWG Database Symptom Analysis

When attaching an architectural or civil survey Xref in GstarCAD, the background drawing may appear so faint and washed out on your monitor that you can barely read grid bubbles—or conversely, so bright that you cannot tell which lines belong to the Xref vs. the active drawing.

2. Step-by-Step Resolution in GstarCAD & AutoCAD

Step 1: Adjust Xref On-Screen Fade via XDWGFADECTL (0 to 90)

Type XDWGFADECTL and enter 30 (subtle dimming) or 0 (100% full brightness). Adding a minus sign (e.g., -50) temporarily turns off Xref fading while storing your preferred `50%` value for quick toggling on the Ribbon! Note: XDWGFADECTL only affects your monitor display—it never affects PDF or paper plots.

Step 2: Adjust Locked Layer Dimming via LAYLOCKFADECTL

When you lock a layer in the Layer Manager, GstarCAD dims it by `50%` (`LAYLOCKFADECTL = 50`) so you know at a glance it cannot be erased. Set LAYLOCKFADECTL = 0 if you want locked layers to stay at full brightness.

Step 3: Control In-Place Reference Edit (REFEDIT) Fade via XFADECTL

When editing a block or Xref in-place via `REFEDIT`, surrounding inactive objects fade according to XFADECTL (default `70`, range `0–90`).

3. System Variables & Command Diagnostic Table

Variable / Command Default / Target Value Diagnostic Function & Fix Behavior
XDWGFADECTL 50 (Range -90..90) Controls on-screen dimming of attached DWG Xrefs (0 = full brightness)
LAYLOCKFADECTL 50 (Range -90..90) Controls on-screen dimming of locked layers in current drawing
XFADECTL 70 (Range 0..90) Controls dimming of background objects during in-place REFEDIT
Layer Transparency 0..90 (Plots when enabled) Unlike XDWGFADECTL, Layer Transparency plots to PDF if Plot Transparency is checked

4. One-Click AutoLISP Fix Script (AutoLISP Quick Toggle for Xref & Locked Layer Screen Fade)

(defun c:TOGGLE-FADE ( / cur)
  (setq cur (getvar "XDWGFADECTL"))
  (if (> cur 0)
    (progn (setvar "XDWGFADECTL" 0)  (setvar "LAYLOCKFADECTL" 0)
           (princ "\n[Display] Xref & Locked Layer Fade OFF (100% Brightness)."))
    (progn (setvar "XDWGFADECTL" 50) (setvar "LAYLOCKFADECTL" 50)
           (princ "\n[Display] Xref & Locked Layer Fade ON (50% Dimmed).")))
  (princ)
)

Enterprise AC1032 Database Internals & Cross-Version Diagnostics

In multi-office engineering environments operating across GstarCAD 2027, GstarCAD Mechanical, GstarCAD Architecture, and legacy AutoCAD (2018–2027) seats, mastering How to Fix Xref Fade (XDWGFADECTL) and Locked Layer Dimming (LAYLOCKFADECTL) requires understanding how the underlying AC1032 DWG binary database serializes entity handles, symbol table records, and Named Object Dictionary (NOD) pointers.

1. DWG Header & Registry Persistence Scope

Variables and object properties fall into three persistence scopes: Drawing-Saved (DXF Header) variables that travel with the .dwg file to subcontractors, Registry-Saved (Profile .arg) settings that persist per Windows workstation user, and Session-Volatile states that reset on every launch unless locked inside acaddoc.lsp. Always verify persistence scope via SYSVDLG before issuing sheets to an ISO 19650 Common Data Environment (CDE).

2. Multi-Core Regeneration & Memory Hygiene

When processing large civil corridors, dense plant P&IDs, or 50-sheet architectural Xref trees, unpurged Registered Application IDs (REGAPP), orphaned DGN stroke dictionaries, and redundant annotation scales degrade spatial index (INDEXCTL = 3) lookup speed. Executing a pre-submittal AUDIT, command-line -PURGE → Regapps, and OVERKILL pass keeps file open times under 2 seconds on GstarCAD's multi-threaded graphics kernel.

3. Hybrid AutoCAD + GstarCAD Team Coexistence

Because GstarCAD reads and writes native AC1032 binary records without intermediate import/export translation, dynamic block grips, associative hatches, XData payloads (DXF groups 1000–1071), Paper Space viewport layer overrides (VPLAYER), and X.509 digital signatures round-trip losslessly between AutoCAD and GstarCAD seats on shared SMB/BIM cloud folders.

Production Field Verification Protocol (ISO 9001 / ISO 19650 Gate)

  1. Baseline Template Audit: Confirm that the active drawing inherits layer naming, linetype scales (PSLTSCALE = 1, MSLTSCALE = 1, LTSCALE = 1.0), and dimension styles from the enterprise .dwt / .dws standards file via CHECKSTANDARDS.
  2. Coordinate & Unit Integrity: Run -DWGUNITS or check INSUNITS, LUNITS, and MEASUREMENT to guarantee 1:1 metric (`mm`/`m`) or imperial (`in`/`ft`) block and Xref insertion scaling, with OSNAPZ = 1 preventing unintended 3D elevation drift.
  3. Submittal Packaging & Mobile Review: Lock all Paper Space viewports (`DisplayLocked = Yes`), bind or relative-path all external references via ETRANSMIT, and verify final plotted PDF/A lineweights (`ISO full bleed`) alongside DWG FastView mobile cloud markup links.

Related Engineering Guides, Courses & Troubleshooting FAQs

Continue building your CAD engineering mastery with these related GstarCAD Academy technical references:

Need 100% Native DWG Compatibility Without Subscription Lock-In?

Engineered by Suzhou Gstarsoft Co., Ltd. (SSE: 688657), GstarCAD 2027 opens, repairs, and plots AC1032 DWG files with full command and AutoLISP parity.

Download Free 30-Day Trial → All Troubleshooting FAQs AutoCAD Migration Hub