In professional CAD workflows, integrating raster images—such as site maps, reference sketches, or interior renders—is essential for visualization and project coordination. However, choosing the wrong insertion method can lead to broken file paths or bloated file sizes. This guide outlines the four primary methods for inserting images in GstarCAD and the technical scenarios where each excels.
1. Clipboard Operations (Copy & Paste)
This is the fastest method for ad-hoc tasks, utilizing the system clipboard.
- Workflow: Select the image in your file manager-rightarrow-Ctrl + C-rightarrow-Ctrl + V in the GstarCAD viewport.
- Technical Note: Pasting directly behaves differently based on the source. If you copy/paste a file, it acts as an External Reference (Xref). If you paste an image already opened in an image editor (e.g., Snipping Tool), it may embed the image directly.
- Best For: Rapid, one-off visual references where long-term path management is not a concern.
2. Raster Image Reference (Command: IMAGEATTACH)
This is the industry-standard approach for professional drafting. It provides granular control over the image’s geometric properties.
- Workflow: Navigate to the Insert tab-rightarrow-Raster Image Reference (or type IAT). Select your file and configure the Attach Image dialog.
- Professional Recommendation: Always use Relative Path instead of Absolute Path. This ensures that the image links remain intact when the project folder is moved or shared with colleagues.
- Best For: Project underlays, floor plans, and large-scale images that require precise scale, rotation, and layer management.
3. OLE Objects (Command: INSERTOBJ)
Object Linking and Embedding (OLE) allows for high-level integration between GstarCAD and other applications (like Microsoft Office or Paint).
- Workflow: Go to Insert-rightarrow-OLE Object. You can choose to “Create New” or “Create from File.”
- Key Advantage: Images inserted via OLE are embedded directly within the .dwg file structure. This eliminates the “missing image” issue when sharing files externally.
- Best For: Embedding technical specifications, tables, or documentation where you want to ensure the visual data travels with the CAD file without external dependencies.
4. Drag-and-Drop
The most intuitive method for quick visual alignment.
- Workflow: Drag the image file from your Windows Explorer directly into the GstarCAD drawing area.
- Logic: Similar to IMAGEATTACH, this method usually creates an external reference. It is best used for non-critical, temporary visual aids.
- Best For: Rapid prototyping or inserting references when you need to quickly assess spatial relationships.
Expert Tips for Optimizing Performance
- Manage Image Visibility: Use the IMAGEFRAME variable to control the visibility of image boundaries:
- 0: Hides all frames.
- 1: Displays and plots frames.
- 2: Displays frames but suppresses them during plotting.
- Scaling: Always verify the scale after insertion. Use the SC (Scale) command to calibrate the image against known dimensions (e.g., a known wall length) for accuracy.
- Performance Optimization: When dealing with high-resolution imagery, modern GstarCAD versions use an optimized loading protocol. If you experience lag, ensure you are working with optimized file sizes (e.g., converting massive TIFF files to compressed JPG/PNG).
- Troubleshooting: If images appear as paths or blank boxes, check the External References (XREF) manager to relink the file path.
Quick Selection Matrix
| Method | Linking Type | Best For |
| Copy/Paste | Variable (Ref/Embed) | Quick, ad-hoc reference |
| Raster Ref | External Reference | Professional workflow (Recommended) |
| OLE Object | Embedded | Self-contained, portable files |
| Drag & Drop | External Reference | Casual, fast insertion |
Join our discord community!
Connect with CAD experts, share technical insights, and get real-time support from the global community.
Join Discord ServerDiscover more from Gstarsoft's Blog
Subscribe to get the latest posts sent to your email.






