This is an old revision of the document!

File Save As

Overview

The File_Save_As command is used to save the currently active workspace to a new file, rather than overwriting the original.

Works similar to a “Save As” button- the user can specify a new file name and destination folder.
This command is commonly used when you want to preserve the original CMZ file, and instead save a modified version with updates (e.g., added events, new model data, etc.)

Important Note:

There is an important distinction between this command and File_Save.

File_Save saves directly to the currently open CMZ file.
File_Save_As creates a new file- nothing is overwritten unless you specify the same name.

The command below is as seen on the Visual3D application, it has parameters as options to manipulate this command.

File_Save_As
!/FILE_NAME=
!/FOLDER=
!/SET_PROMPT=Save CMZ file as
!/SAVE_EMBEDDED_GRAPHICS=FALSE
!/CREATE_FOLDER_PATH=FALSE
;

The following table shows the command parameters and descriptions.

Parameter	Description
! /FILE_NAME=	Name of the new file to save the workspace into- this file will be created.
! /FOLDER=	Folder to save the file in, can be a full or relative path.
! /SET_PROMPT=	Text to display in the save dialog window if the user is prompted.
! /SAVE_EMBEDDED_GRAPHIC=FALSE	If 'TRUE', embedded 3D graphics/visuals ae saved inside the CMZ file.
! /CREATE_FOLDER_PATH=FALSE	If 'TRUE', Visual3D will create the folder path if it does not already exist.

Save the current Workspace to a new CMO file. A dialog will appear to allow the user to select the new file.

File_Save_As 
;