

This guide assumes that the user is familiar with wysiwyg’s importing basics as described in the Reference Guide; it by no means describes everything that needs to be done in order for a CAD file to import into wysiwyg, only the most common actions that may need to be taken. Since every CAD file is different, it is literally impossible to write a step-by-step import procedure, or devise a set of rules/actions, which cover every import scenario or guarantee a successful import. Many CAD files require no modifications at all, while others only need to be modified slightly, following only one or two of the suggestions below; others still, may require a large number of changes in order to import correctly—some which are not even listed below because the need for them has never come up and are therefore unknown. All this considered, the following is merely a set of guidelines and suggestions for using AutoCAD to modify files in order to make them “importable” into wysiwyg.
Text Conventions for this Guide
- Red Capitalized words denote AutoCAD object types or features
- red italic words, regardless of capitalization, denote an AutoCAD command (i.e. one that is typed into AutoCAD’s command line, such as units or purge) or a tool/feature (such as Quick Select)
- italics are used for emphasis/important points
File Information
The following information must be known about the file that’s about to be imported; if it is not known and cannot be obtained from the file’s author, AutoCAD must be used to collect it.
- The file’s Units. Choosing the incorrect units when importing will result in the model being either too large or too small. To determine the file’s units, use AutoCAD’s units command and choose the same option in the Scale step of wysiwyg’s Import Wizard. On occasion (rare) “Unitless” files are encountered; if the author cannot provide proper information about the file, the import will need to be attempted by trial-and-error, selecting a different unit every time, until the correct one is found. (Unfortunately, wysiwyg cannot be made to “guess” the units and/or select them automatically.)
- The model’s scale. Some CAD applications can be used to draw to scale and/or to save in scale; since wysiwyg only uses real-world measurements, ideally only files drawn/saved in one-to-one scale (i.e. with “real-world measurements”) should be imported. To ensure that the model has imported correctly, it is recommended that one or two known distances are checked (using wysiwyg’s Distance or Dimension tools) once the import is complete. If the model was drawn at scale, or the file was saved in scale, the (self-explanatory) Custom option in the Scale step of wysiwyg’s Import Wizard may be used to define how the model should be resized.
Common Actions (Recommended Before Every Import)
While it is by no means imperative for the following actions to be performed before import is attempted, doing all this will definitely make for a smoother import process. If AutoCAD is not available/accessible to the wysiwyg user, the file’s author (who has access to AutoCAD, since he or she created the file in the first place) should be asked to perform them and then re-save the file for import.
- Delete all user-created Paperspace Layouts. Paperspace Layouts cannot be imported into WYSIWYG, so there is no reason to have/leave them in the CAD file. In addition, while the chances of this are fairly low, it is possible for objects which have been inserted onto a Paperspace Layout to “confuse” wysiwyg’s import algorithms due to potential multiple references to them. As such, while not absolutely necessary, deleting Paperspace Layouts before attempting to import the file is preferred and recommended; doing this does not affect the model in any way, so this is a “safe” procedure (as long as a copy of the file is being modified, not the original). To delete a Paperspace Layout, right-click on its tab and select Delete from the pop-up menu that appears. Note that not all CAD files contain Paperspace Layouts, aside from the default “Layout 1”, which cannot be deleted; if Layout 1 is not empty, deleting it will remove its contents, but the tab will remain; this is recommended. (An empty Paperspace Layout will not affect the import in any way.)
- Move the model to the origin. Depending on how the CAD file was created, the model may have been drawn far from the origin. While this does not matter to AutoCAD (since its drawing space is virtually infinite), it does matter to wysiwyg (where the drawing space has limits), so an imported model may end up so far from the origin that it becomes difficult or even impossible to find. To check the model’s position (in AutoCAD) simply hover the cursor around it and look at AutoCAD’s coordinates display; if it is away from the origin, enable all layers (i.e. turn on and unfreeze and unlock them), select everything (CTRL+A), and move it all to surround the origin.
Note that wysiwyg can detect that the model is far away from the origin; in such cases wysiwyg will offer to move the model closer to the origin as part of the import. However, moving it manually, using AutoCAD, is preferred: this offers complete control over the move, since the points to move it from and to are specified, instead of randomly-selected by wysiwyg. (For example, the model may be picked up from its intended origin (e.g. “the centre of the bottom of the stage”) and moved to the exact document origin (i.e. the (0,0,0) coordinate); this is not something that WYSIWYG could possibly do as part of the import.)
- Set the drawing limits to contain the entire model but no more. Even if the model is moved to the origin, it is a good idea to define its limits; a model’s limits are the extents of the area that it occupies, and are defined via AutoCAD’s limits command.
- Purge the file. Preceding the last save before import is attempted, always purge the file in order to remove any unnecessary contents from it; do this by using AutoCAD’s purge command.
There are many advantages to purging the file before importing (instead of relying on wysiwyg’s Purge function to do this afterwards). Top among these is the fact that AutoCAD “knows its files” better than any other software could, so it can “make better decisions” about what to purge. Another very good reason to purge before importing is to avoid importing (or attempting to import) unnecessary objects, which may lead to import errors. Finally, purging reduces the file’s size, and makes easier/faster for wysiwyg to process the import. Naturally, the file should be purged again every time any changes (such as the ones described in the next section) are made to it.
Objects That Do Not Import
The list of objects that wysiwyg can import (and any additional/necessary details about each) may be found in the wysiwyg Reference Guide. This list has grown over the years, but there are still some objects which cannot import; some such objects simply do not make sense to import (and so they never will) while others will be added to the import routines in future versions. wysiwyg is good at ignoring objects that it cannot import, but it is always preferable for such objects to be removed from the file prior to the import, because it makes little sense to process them only to have them be discarded almost instantly; in addition, removing such objects before importing the file also allows the file to be purged, which may result in additional associated objects being removed from the file (objects which are most likely irrelevant for the import anyway).
Note: some of the suggestions below ask for all objects of the same type to be selected in order to be manipulated at once. The easiest way to perform this selection is via AutoCAD’s Quick Select tool, which is available at the top of the Properties side panel or by typing the qselect command.
- External References (or Xrefs) cannot be imported because they are simple pointers to other files whose contents can be displayed in the currently-open file (in AutoCAD). This feature provides a means for a .DWG or .DXF file to not contain any actual objects, only Xrefs to other files which contain the necessary models; if those files cannot be accessed, opening the file containing the Xrefs (in AutoCAD) would make it appear blank. An example of this is a multi-story building, whose every floor is drawn in a separate “floor file”, and each of these files is externally-referenced within a “master file”; when this master file is opened, the entire building appears, but if the “floor files” are not available, nothing appears. All this considered, it should be clear that it is beyond WYSIWYG’s scope to import Xrefs’ contents, so in order to import files which contain Xrefs, the Xrefs’ content must be added to the file being imported. This is accomplished via AutoCAD’s bind command; please consult AutoCAD’s documentation for more information on External References and how to bind
- Proxy Graphics and Raster Image objects cannot be imported and should be removed from the file prior to import.
- Hatch objects cannot be imported at this time. If they are crucial to the model, and WYSIWYG’s own hatching does not provide a suitable replacement to the hatches from the file being imported, they may be exploded via AutoCAD’s explode command; this turns them into individual Line or Point objects (depending on the type of hatch used) and they will However, this option must be used in moderation and with great care, as explodeing complex/dense Hatches has the potential to create hundreds/thousands of extra objects in the file, resulting in complex/slow imports and, potentially, unusually-large and poorly-performing .wyg files. Hatches which do not need to be imported should be selected and deleted from the file; if no Hatches at all need to be imported, select them all via Quick Select and delete them.
- Dimensions, aside from Aligned or Rotated ones, cannot be imported and may be deleted before importing. This is not necessary however, because Dimensions are very simple objects which do not require heavy processing during import and WYSIWYG can handle them easily. If no dimensions need to be imported from a CAD file, use Quick Select to select them all and then delete
- Nested Blocks used to have to be exploded before importing the file, but this is no longer necessary as of R39. In fact, in most cases, it is actually better not to do this unless WYSIWYG suggests it once the import is complete (as it will do if an imported Block contains more than 65,535 vertices). The only exception here is if the file contains only one very large Block, or several, each consisting of more than 65,535 vertices; in such cases (which are rare), the file must be opened in AutoCAD, the Block(s) must be selected and exploded, the file must be purged and saved (with a new name, so as not to overwrite the original), and the import must be attempted with this new file.
Additional Tips
In addition to the above, here are a few other things to try, or things that may have to be done, in order for CAD file to import and/or to streamline the import:
- Ensure that the file being imported has not been corrupted. (A corrupt file will generate unusual errors while WYSWYG attempts to import it, and will not open in AutoCAD or in DWG TrueView or Autodesk Viewer, which are available free-of-charge from https://www.autodesk.com/products/dwg/viewers.) A file may become corrupt as a result of bad media (eg. a bad/corrupt USB stick) or network errors during transfer. If for some reason these applications cannot be used to check if they can open the file, the only thing to do is determine the file’s hash value using a hash calculator, and compare it with the same value obtained from the computer where the file originated; if the two values do not match, the file has been corrupted and will have to be transferred again. One way to prevent corruption is to compress the file into a .ZIP or .RAR archive before transferring it; once the transfer is complete, if the .ZIP or .RAR file opens successfully, the CAD file within is virtually guaranteed to be fine (and its hash value will match that of the original).
- Use AutoCAD’s Write Block feature to create an AutoCAD-native file. This procedure applies to CAD files that weren’t created in AutoCAD, but in some other application, and then exported to .DWG or .DXF format; if it is known that this is how the CAD file came to be, or if WYSIWYG displays Load Errors “39”, “50”, or “65” during an import, there is a good chance that “converting” the file to an AutoCAD-native file will get it to import. To do this, open the file in AutoCAD, select everything (CTRL+A), use the wblock command to create the new file and then import that file.
- Use Write Block to create a new file which only contains the part of the model required for import. Optimizing the geometry in a CAD file (as discussed in this thread on the CAST Software Forum) is essential for performance, so files should always be analyzed for optimization opportunities. A prime candidate for optimization is content that is irrelevant to the lighting design. Such content must be removed from the file before import. (For example, only the venue itself should ever be imported, not its entire site plan.) To do this, open the file in AutoCAD, turn Off and Freeze and Lock the layers containing irrelevant objects, select everything (CTRL+A), and use the wblock command to create a new file to import.
- Import the file layer-by-layer. In most cases, import errors are not caused by the file or by the entire model, but rather by a single object within (or, perhaps, a handful of objects). One way to isolate the problem object is to import the file one layer (or a few layers) at a time. (This is accomplished by deselecting layers within WYSIWYG’s Import Wizard.) Most layers will import, but one (or perhaps a few) will not; this typically indicates that the problem object(s) are contained within this layer (or these layers); knowing this, the process of analyzing the file (using AutoCAD) to determine what those objects are and what may be done with them, becomes easier. (If those objects happen not to actually need to be imported, deleting them, purging the file, and saving it in that state will most likely allow it to import successfully.)
Importing layer-by-layer or a few layers at a time can also benefit complex files which contain large numbers of layers, by streamlining layer management and by providing a (potentially) less cluttered file to work with. This is especially true if a 2D model needs to be imported in order to be used as the basis for creating a 3D model; in such cases, the layers containing the venue would be imported first and then extruded as necessary in order to create the 3D model of the venue; this would be followed by merging the ‘hang structure’ layers (using wysiwyg’s File > Merge command in CAD mode), raising the lines to the appropriate heights, and converting them into pipes (or using the lines as a guide to create truss structures with Truss from wysiwyg’s library); and so on.
The only caveat to importing layer-by-layer is that the process can take a long time, because wysiwyg must process the entire file for import before it can display the list of layers to import. As such, importing a few (related) layers at once is preferred over a importing a single layer at a time.
Contacting Technical Support for Import Assistance
If, after performing the appropriate/necessary tasks described above, the file still does not import, please login to the Members Only Area of the CAST Software website and open a Tech Support ticket for assistance with the import. Please note the following important points regarding import assistance.
- In order to qualify for import assistance, the Membership on the dongle being used to run wysiwyg must be current.
- Ensure that both the original file AND the file modified as per the information above are attached to the case; please compress the two files into a .ZIP or .RAR file and attach this compressed file.
- If the file can be imported successfully, the Technical Support Department will provide (extensive) information about the steps that were required (beyond the above) in order for the import to succeed. It is strongly recommended that this information is retained for future reference, to be used the next time a problematic import is encountered. The “importable” version of the file, as well as the resulting .WYG file will also be provided.
- CAST Software cannot guarantee a successful import; this is rare, but there have been cases where the CAD file simply could not be imported, even after being analyzed by our Software Development Department. In such cases, the Technical Support Department will provide additional information regarding the failure, and potential next steps.
- Import assistance is not part of standard technical support, but is provided as a courtesy for the first two or three unsuccessful import attempts encountered by customers. Beyond that, customers are expected to modify CAD files for import themselves, using AutoCAD and the information that was provided as part of the cases for which assistance was rendered.