Function Syntax: CopyC3DEntitiesToClipboard AI Description This AutoLISP routine extracts visible text from selected Civil 3D labels or AutoCAD entities by duplicating the selection, exploding the duplicated objects, collecting generated TEXT and MTEXT content, copying the cleaned text to the Windows clipboard, and deleting the temporary exploded entities afterward. The original selected Civil 3D labels or AutoCAD objects are intended to remain unchanged because the routine works on copied objects instead of directly exploding the originals. The main command is CopyC3DEntitiesToClipboard. The routine is useful when Civil 3D labels need to be converted temporarily into plain text so their displayed values can be copied into Excel, Notepad, Word, emails, QA notes, reports, or project documentation. The code works as a command-line utility and does not use a DCL dialog. Main Command • 📌 CopyC3DEntitiesToClipboard — starts the duplicate, explode, text extraction, clipboard copy, and cleanup workflow. Loading Method • 🧰 Load LISP File — load the file CopyC3DEntitiesToClipboard.lsp in AutoCAD or Civil 3D using APPLOAD. • 📌 Run Command — run CopyC3DEntitiesToClipboard from the AutoCAD or Civil 3D command line. User Workflow • 🚀 Start Command — the user runs CopyC3DEntitiesToClipboard. • 📌 Select Objects — the command prompts the user to select Civil 3D labels or other entities that may produce text after exploding. • 🧠 Use Pickfirst When Available — the routine first checks the implied selection using ssget "_I" and then falls back to a normal ssget selection if needed. • 📋 Copy Objects In Place — each selected object is duplicated in the same position before any explode operation is performed. • 💥 Explode Temporary Copy — the duplicated object is exploded with EXPLODE so generated AutoCAD entities can be inspected. • 🧩 Explode Nested Blocks — if the exploded result includes block references, the routine attempts to explode those nested INSERT entities too. • 📝 Collect Text — the routine searches the exploded entities for TEXT and MTEXT objects. • 🧹 Clean MText Codes — text is cleaned with StripMTextCodes_2 if that helper exists, otherwise a basic fallback cleanup is used. • 📋 Copy To Clipboard — the extracted text is copied to the Windows clipboard using htmlfile, MSForms.DataObject, or clip.exe as fallback methods. • 🧹 Delete Temporary Geometry — the routine builds a selection set of the exploded temporary entities, uses PSELECT with Previous, then uses ERASE to remove the temporary exploded objects. • ✅ Report Result — the command line reports how many text items were copied to the clipboard. Functionalities • 📌 Pickfirst Selection Support — the routine can use objects already selected before the command starts through ssget "_I". • 📌 Manual Selection Support — if no pickfirst selection exists, the routine asks the user to select objects normally with ssget. • 📋 Duplicate Before Explode — the routine copies each selected entity in place so the original object is not intentionally exploded or modified. • 🔄 COM Copy Fallback — the routine first tries vla-copy, then falls back to the AutoCAD COPY command from 0,0,0 to 0,0,0 if COM copy fails. • 💥 Temporary Explode Workflow — the duplicated entity is exploded with EXPLODE so Civil 3D label graphics can become readable AutoCAD text objects. • 🧩 Nested Block Explosion — exploded INSERT entities are processed again so text inside nested blocks can also be collected. • 📝 TEXT Extraction — the routine reads the DXF group 1 value from TEXT objects. • 📝 MTEXT Extraction — the routine combines MTEXT DXF groups 1 and 3 to capture long MTEXT content. • 🧹 MText Formatting Cleanup — the routine removes or replaces common MTEXT control codes such as paragraph codes, underline codes, overline codes, and braces. • 📋 Clipboard Export — all extracted text is combined into a plain-text list and copied to the Windows clipboard. • 🔐 Multiple Clipboard Methods — the code tries htmlfile first, then MSForms.DataObject, then a temporary file piped through clip.exe. • 🧹 Temporary Object Cleanup — exploded temporary entities are erased after the text has been copied. • ↩️ Undo Grouping — the workflow is wrapped inside UNDO BEGIN and UNDO END so the operation can be treated as one undo group in AutoCAD. • 🔇 Command Echo Control — the routine sets CMDECHO to 0 during processing and restores the previous value afterward. • ⚡ No Dialog Workflow — the command runs directly from the command line without a DCL interface, making it fast for repeated label-to-clipboard extraction tasks. Important Helper Logic • 🔒 Error Handler — *error* restores CMDECHO and suppresses normal cancel, break, and exit messages. • 🧠 Pickset Validator — _is-pickset checks whether a returned value is a valid AutoCAD selection set. • 📌 Selection Helper — _get-pickset retrieves the implied selection first and then asks the user to select objects if needed. • 📋 Copy Helper — _copy-in-place duplicates an entity using vla-copy or the AutoCAD COPY command as fallback. • 💥 Explode Collector — _explode-collect runs EXPLODE, collects all newly created entities, and attempts to explode nested block references. • 🧹 Text Cleaner — _clean-text uses StripMTextCodes_2 when available and otherwise performs a basic MTEXT formatting cleanup. • 📝 Text Reader — _text-from-entity reads plain text from TEXT and MTEXT entities. • 📋 Clipboard Helper — _clipboard-put tries three Windows clipboard routes: htmlfile, MSForms.DataObject, and clip.exe. • 🧹 Deletion Selection Builder — the routine collects temporary exploded entities into ssDel and then erases them using PSELECT and ERASE. Important Code Notes • 📌 Command Name — the command name is CopyC3DEntitiesToClipboard. • 🔴 Platform Requirement — the clipboard workflow is Windows-specific because it uses COM objects and clip.exe. • 🔴 Selection Filter Note — the routine prompts for Civil 3D labels, but the code uses ssget without a Civil 3D label filter, so any selectable object can be chosen. • 🔴 Explode Dependency — text is collected only if the duplicated object explodes into TEXT or MTEXT entities. • 🔴 Text Cleanup Dependency — advanced MTEXT cleanup depends on StripMTextCodes_2 if that helper function is loaded. Otherwise the routine uses only a basic fallback cleanup. • 🔴 Non Explodable Object Note — if a copied object cannot be exploded, the copied temporary object may not produce text and should be checked in the drawing after testing. • 🔴 Undo Handler Note — the routine starts an AutoCAD undo group, but the error handler does not explicitly close the undo group if an unexpected error occurs after UNDO BEGIN. • 🔴 Clipboard Limitation — the routine copies plain text only. It does not create a CSV file, Excel file, table, report, label, band, ProfileView, SectionView, Alignment, or export database. • 🔴 Civil 3D Object Limitation — the routine does not modify Civil 3D objects. It only duplicates, explodes temporary copies, extracts text, copies text to the clipboard, and removes the temporary exploded entities. Final Result The final result is a fast Civil 3D label and AutoCAD text extraction workflow. The user can select labels or objects, let the routine duplicate and explode temporary copies, collect generated TEXT and MTEXT values, copy the cleaned result to the Windows clipboard, and automatically remove the temporary exploded geometry. This improves productivity, reduces manual label copying, speeds up QA documentation, supports fast transfer to Excel or reports, and helps Civil 3D users extract visible label information without permanently exploding the original design objects.