Command
QisLib_SaveOASIS Function: int QisLib_SaveOASIS(const char* OutFileName); Inputs: OutFileName: Name and path of the OASIS file to be saved. Return: success: 0 failure: one of the following values : Errors: -1: QisLib has not been initialized. -2: The OASIS file has not been loaded into the memory. -3: Cannot save data to the same OASIS file. -5: The specified input is either invalid or null. -6: No OASIS file has been opened. -7: File open in progress, operation not permitted. 3: Usage Error: No open files. 30: Memory Error: Cannot allocate memory. Description: - This function can be used to save an OASIS file opened in edit mode (QisLib_SetLoadMemory on) to another OASIS file. - This function will work only if the input OASIS file is opened in edit mode (QisLib_SetLoadMemory is on or file was created from scratch using QisLib_NewOASIS). This function will fail if the input file is GDSII. - Any changes made to the polygons, layers or cells will be reflected. - The cell hierarchy is preserved during this operation. - This function does not save settings such as layer on/off, nesting level, array mode, etc. - Data is output on the same layer as the input. However QisLib_SetOutputLayerMap can be used to control the mapping of the input layers to different output layers. - The output may not be same as the input even if no changes have been made. For example, CBLOCK compression would be different, repetitions and vertices point lists could be output as different types. Also, various properties would be skipped. - If a progress message callback function has been set using QisLib_SetProgressMessageCallback, QisLib updates the file save percentage to the user program while this function is executing. - If this operation needs to be cancelled, use QisLib_Stop. This can only be done if QisLib_SetProcessEvents is turned on. Also, for Unix/Linux, the program's application context must be passed to QisLib_InitLib. - The Grid of the output OASIS file can be controlled by using QisLib_SetDBU and QisLib_SetResolution. By default, these values will be same as the input OASIS file.References: QisLib_SetOutputLayerMap QisLib_SetLoadMemory QisLib_NewOASIS QisLib_SetProgressMessageCallback QisLib_SetDBU QisLib_Stop QisLib_SetResolution QisLib_SetProcessEvents |