IMAGE Command Line — GstarCAD 2027
IMAGE Command Line
GstarCAD 2027 · Command Reference
Commands > I Command > IMAGE > IMAGE Command Line
The "-IMAGE" command is used to attach raster images to a drawing.
Command Access:
Command: -IMAGE
Command Prompts:
Enter image option [? /Detach/Path/Reload/Unload/Attach] \<Attach>:
Relative Glossary:
?
List all images in alphabetical?order. List the attached time and saved path for drawings. They all list in alphabetical order no matter how to set the MAXSORT system variable.
Detach
Detach the named image from the drawing, mark it for deleting, and remove all images.
Path
Update the path associated with specified image (including file name). This option will be helpful when changing the position of image file, renaming it or overriding it. Inputting "*" , it prompts:
Image name:
Old path:
Enter new path:
Reload
Reload the selected image. This information could be used to display and plot.
Unload
Remove image date from work memory and do not display the image any longer. All information associated with the image is still saved with image. The attached frame is still visible.
Attach
Attach a new image or its copy to current drawing. Display the "Select Image File" dialog box.
Specify the image name without extension. The image name could contain at most 255 characters, including letters, numbers, spaces and other special characters that used by operation system or this program. If the image name is invalid for non-graphical object, it will display the "Override image name" dialog box. It will generate a valid image name from file name with underline and numbers.
When inserting the same image, with the same image name and path, it prompts to insert it as a copy:
Image --- has already been loaded.
Use IMAGE Reload to update its definition.
Specify insertion point \<0, 0>:
Base image size: Width:
Height: Millimeters Specify scale factor or [Unit] \<1>:
Specify rotation angle \<0>:
If the FILEDIA system variable is set to 0, it displays the following prompts rather than dialog box:
Enter image file name to attach \<>:
The recently attached image name is default file name. When inputting the image name, users could specify image name and its file name at the same time to avoid mistakes.
After inputting a valid image name without extension, the program will search the file in the following rules: first search existing image definition in the drawing; second, search image file in the path order. The program will search all image files with specified name (with regards to their extensions) and use the first name. If the program could not find the specified file name or image file, it will repeat prompts "The image is not found".
To specify a long file name which is not meeting the required naming rule, users could input the name like this:
"imagename\=filename"
Users could search image files by dialog box, but they should input "imagename\=filename" under command prompts. Inputting "\~" under command prompt "Enter image file name to attach".