Advanced Compiler Options Dialog Box
Use the Advanced Compiler Options dialog box to specify and view the information LabWindows/CVI passes to the external compiler when you compile a file. Click Advanced in the Compiler Setup dialog box to open the Advanced Compiler Options dialog box.
Each external compiler has its own set of options that specify command line compilation settings. There are several factors to consider when you edit the flags LabWindows/CVI passes to the external compiler. Refer to the external compiler documentation for information about specific options. Use the Advanced Compiler Options dialog box to specify the following settings:
- Compiler Path—Specifies the pathname of the external compiler executable. Click the … button to browse to the external compiler executable.
- Compatibility Flags—Specifies the flags that are required to run the specified compiler.
- C89 Flags—Specifies the flags that are required to compile the project when C99 extensions are not enabled.
- C99 Flags—Specifies the flags that are required to compile the project when C99 extensions are enabled.
- Environment Setup Batch File—Specifies the batch file LabWindows/CVI runs to set up the external compiler environment, if a setup batch file exists. LabWindows/CVI runs this environment setup batch file prior to calling the external compiler. Click the … button to browse to the environment setup batch file.
- Environment Setup Options—Specifies the command line arguments to pass to the environment setup batch file.
- Include Path—Specifies the command line template LabWindows/CVI uses to provide the external compiler with the include paths to search for header files. Use $PATH as a placeholder for the include path. For each project, LabWindows/CVI maintains a list of include paths to search. At compile time, LabWindows/CVI creates a copy of the include path template for each item in this list and replaces $PATH with an include path.
- Input Source File—Specifies the command line template LabWindows/CVI uses to provide the external compiler with the pathname of the source file to compile. Use $SOURCE as a placeholder for the name of the file to compile. At compile time, LabWindows/CVI creates a copy of the input source file template for each file to compile and replaces $SOURCE with the filename.
- Output Object File—Specifies the command line template LabWindows/CVI uses to provide the external compiler with the object file to output. Use $OBJECT as a placeholder for the name of the object file to output. At compile time, LabWindows/CVI replaces $OBJECT with the name of the object file the external compiler generates. This file has the same base name as the source file.
- Define—Specifies the command line template LabWindows/CVI uses to provide the external compiler with the LabWindows/CVI predefined macros and user-specified compiler defines. Use $MACRO as a placeholder for the macros and compiler defines. LabWindows/CVI maintains a list of predefined macros and the compiler defines you specify in the Build Options dialog box Compiler Defines control. At compile time, LabWindows/CVI creates a copy of the define template for each macro and compiler define and replaces $MACRO with the macro or compiler define name.
- Define with Value—Specifies the command line template LabWindows/CVI uses to provide the external compiler with the predefined macros and user-specified compiler defines that have assigned values. Use $VALUE as a placeholder for the macro or compiler define value. At compile time, LabWindows/CVI creates a copy of the define with value template for each macro and compiler define that has an assigned value. LabWindows/CVI replaces $MACRO with the macro or compiler define name and $VALUE with the value assigned to the macro or compiler define.
- Disable Parsing of Build Output—By default, LabWindows/CVI parses the output the external compiler returns and displays the parsed output in the Build Output window. LabWindows/CVI assigns line numbers to the errors or warnings the external compiler returns so that when you click an error or warning in the Build Output window, LabWindows/CVI highlights the line of code where the error occurred in the Source window. If you enable this option, LabWindows/CVI displays the output as the external compiler returns it. You cannot click an error or warning in output that has not been parsed to highlight the line of code where the error occurred. If you enable this option, LabWindows/CVI does not display the Build Output window if the build succeeds, even if you enable the Show build output window for warnings option in the Build Options dialog box.
- Preview—Displays a preview of the command LabWindows/CVI uses to compile a file using the external compiler configuration. This preview includes placeholders for the include paths, compiler defines, generated object file name, and input source file name because this information varies based upon what file is compiled.