Generating in the workbench

Generating in the workbench is accomplished with either the generation wizard or the generation menu item. When you select the generation menu item, EGL uses the default build descriptor. If you have not selected a default build descriptor, use the generation wizard. For details on selecting the default build descriptor, see Setting the default build descriptors.

To generate in the workbench by invoking the generation wizard, do as follows:

1. Right-click on a resource name (project, folder, or file) in the Project Explorer.

2. Select the Generate With Wizard... option.

The generation wizard includes four pages:

1. The first page displays a list of parts to generate based on the selection that the user made to start the generation process. You must select at least one part from the list before you can continue to the next page. The interface provides buttons to let you select or deselect all of the parts in the list.

2. The second page lets you choose a build descriptor or build descriptors to be used to generate the parts selected on the first page. You have two options:
   • Choose from a drop-down list of all the build descriptors that are in the workspace, and use that build descriptor to generate all of the parts.

   • Select a build descriptor for each of the parts selected on the first page. You use a table to select the build descriptors for each part. The first column of the table displays the part names; the second column displays a drop-down list of build descriptors for each part.

3. The third page lets you set user IDs and passwords for both the destination machine and the SQL database used in the generation process, if IDs and passwords are necessary. These user IDs and passwords, if any, override the ones listed in the specified build descriptor for each part being generated. You may want to set user IDs and passwords on this page rather than the build descriptor to avoid keeping sensitive information in persistent storage.

4. The fourth page lets you create a command file that you can use for generating an EGL program outside of the workbench. You can reference the command file in the workbench batch interface (by using the command EGLCMD) or in the EGL SDK (by using the command EGLSDK).

   To create a command file, do as follows:

   1. Select the Create a Command File checkbox

   2. Specify the name of the output file, either by typing the fully qualified path or by clicking Browse and using the standard Windows procedure for selecting a file

   3. Select or clear the Automatically Insert EGL Path (eglpath) check box to specify whether you want to include the EGL project path in the command file, as the initial value for eglpath; for details, see EGL command file

   4. Select a radio button to indicate whether to avoid generating output when creating the command file

5. Click Finish.

To generate in the workbench using the generation menu item, do one of the following sets of steps:

1. Select one or more resource names (project, folder, or file) in the Project Explorer. To select multiple resource names, hold down the Ctrl key as you click.

2. Right-click, then select the Generate menu option.

or

1. Double-click on a resource name (project, folder, or file) in the Project Explorer. The file opens in the EGL editor.

2. Right-click inside the editor pane, then select Generate.

Related concepts
Generation in the workbench

Related tasks
Setting the default build descriptors

Related reference
EGLCMD
EGLSDK
Generated output (reference)