How to Fix WIPEOUT Frames Showing on Screen or Plotting Solid Black Boxes in PDF
Eliminate visible WIPEOUT boundary borders via WIPEOUTFRAME = 0 or 2, and permanently fix WIPEOUT masks printing as solid black rectangles in PDF viewers and plotters.
To hide WIPEOUT borders when plotting while keeping them selectable on screen, set WIPEOUTFRAME to 2. If WIPEOUT objects print as solid black rectangles in PDFs, replace the WIPEOUT with a Solid Hatch set to TrueColor RGB 255,255,255 (which never prints black on any PDF driver).
1. Root Cause & DWG Database Symptom Analysis
WIPEOUT entities are widely used to mask background gridlines or hatching behind text tags and electrical symbols. However, two notorious issues plague submittals: visible border outlines plotting around every tag, or the entire mask printing as a solid black rectangle on client PDF plotters.
2. Step-by-Step Resolution in GstarCAD & AutoCAD
Step 1: Set WIPEOUTFRAME = 2 (Display Frame on Screen, Hide on Plot)
In GstarCAD and modern AutoCAD, WIPEOUTFRAME accepts three integer values: 0 (Frames completely hidden—cannot select them!), 1 (Frames visible AND plotted), and 2 (Frames visible on screen for editing, but suppressed during Plot/Publish). Always set WIPEOUTFRAME = 2.
Step 2: Why WIPEOUT Prints Black in Some PDF Drivers (Raster Mask Bug)
Internally, a `WIPEOUT` is a 1x1 pixel clipped raster image painted with the background color. Certain third-party PDF printers (and macOS Preview / mobile PDF viewers) invert 1-bit raster masks to solid black (`RGB 0,0,0`).
Step 3: The Bulletproof Fix — TrueColor 255,255,255 Solid Hatch or MTEXT Mask
For text notes, never draw a manual `WIPEOUT`: simply select the `MTEXT`, open Properties (`Ctrl+1`), set Background Mask = Yes (`Use drawing background color = Yes`, Offset = `1.15`). For dynamic blocks, replace the `WIPEOUT` with a `SOLID` hatch assigned explicitly to TrueColor 255,255,255 (because TrueColor bypasses `.ctb` monochrome conversion and plots pure white vector paper space!).
3. System Variables & Command Diagnostic Table
| Variable / Command | Default / Target Value | Diagnostic Function & Fix Behavior |
|---|---|---|
WIPEOUTFRAME = 2 |
Display On / Plot Off (Best) | Lets drafters select/stretch wipeouts without plotting borders |
WIPEOUTFRAME = 0 |
Display Off / Plot Off | Hides borders completely (must toggle to 1 or 2 to delete) |
TrueColor 255,255,255 Hatch |
Vector Mask Alternative | Bypasses monochrome .ctb tables; 0% chance of black PDF boxes |
MTEXT Background Mask |
DXF Group 90 = 3 | Built-in self-sizing mask that moves automatically with text |
4. One-Click AutoLISP Fix Script (AutoLISP Wipeout Frame Controller & MTEXT Background Mask Enabler)
(defun c:FIX-WIPEOUTS ( / ss i ent elist)
(setvar "WIPEOUTFRAME" 2) ; Show on screen, never plot frame
(setvar "TFRAMES" 0)
(princ "\n[Mask Guard] WIPEOUTFRAME set to 2 (Display On, Plot Off).")
(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 WIPEOUT Frames Showing on Screen or Plotting Solid Black Boxes in PDF 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)
- 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/.dwsstandards file viaCHECKSTANDARDS. - Coordinate & Unit Integrity: Run
-DWGUNITSor checkINSUNITS,LUNITS, andMEASUREMENTto guarantee 1:1 metric (`mm`/`m`) or imperial (`in`/`ft`) block and Xref insertion scaling, withOSNAPZ = 1preventing unintended 3D elevation drift. - 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:
- [Engineering Guide] Course 35: Reflected Ceiling Plans (RCP), Lighting Photometric Layouts & Diffuser Coordination
- [Engineering Guide] Course 39: Large DWG Performance Engineering — Spatial Indexes, Xref Demand Loading & Layer Filters
- [Engineering Guide] ISO 128 & ASME Y14.2 Lineweights, Linetypes & Hatch Standards Handbook
- [Troubleshooting FAQ] How to Fix Xref Fade (XDWGFADECTL) and Locked Layer Dimming (LAYLOCKFADECTL)
- [Troubleshooting FAQ] How to Import X,Y,Z Survey Points from Excel / CSV into GstarCAD with Point ID Labels
- [Troubleshooting FAQ] How to Create Custom Linetypes (.LIN) with Embedded Text or Shapes (MKLTYPE & MKSHAPE)
- [Skill Certification] Test Your Mastery on the 850-Question GstarCAD Engineering Certification Engine →
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.