Include Window Compositor in an OS Design (Compact 7)
3/12/2014
To include Window Compositor in your OS, you must configure the required SYSGEN variable SYSGEN_COMPOSITION and the required board support package (BSP) environment variable BSP_GLES2COMPOSITOR before you create the BSP. For information about SYSGEN variables, see GWES Catalog Items and Sysgen Variables. For information about BSP environment variables, see BSP Environment Variables.
The following table defines the required settings.
| Variable/Setting | Definition |
|---|---|
SYSGEN_COMPOSITION = 1 |
Adds Window Compositor functionality to the BSP and adds the default GDI compositor to the OS. |
BSP_GLES2COMPOSITOR = 1 |
Adds the OpenGL compositor instead of the GDI compositor to the OS. SYSGEN_COMPOSITION must also be set to 1, or Platform Builder ignores this setting. |
Add Window Compositor from Platform Builder
Platform Builder offers a standard user interface (UI) to set required SYSGEN and BSP variables and to include Window Compositor in the OS build. After you create a project in Platform Builder, use the following steps to set the SYSGEN_COMPOSITION and BSP_GLES2COMPOSITOR variables and to add Window Compositor to the OS.
To add the GDI compositor to the OS from Platform Builder
In the Solution Explorer window, click the Catalog Items View tab.
You can also click View, click Other Windows, and then click Catalog Items View.
In the Catalog Items View window, in the search box at the top of the catalog item tree, type SYSGEN_COMPOSITION. The Catalog Item tree appears and Window Compositor is selected (under Core OS/Shell and User Interface/Graphics, Windowing and Events). This selection indicates that SYSGEN_COMPOSITION is correctly set to 1 for the build.
To add the OpenGL compositor to the OS from Platform Builder
Repeat steps 1 and 2 from the preceding procedure.
In the Project window, click project-name Properties, where project-name is the name of the project.
In the Property Pages pane, click Configuration Properties, and then click Environment.
If BSP_GLES2COMPOSITOR is not in the Environment Variables list, then do the following:
- Below the Environment Variables list, click New.
- In the Environment Variable dialog box, in the Variable Name list, type BSP_GLES2COMPOSITOR, and in the Variable Value list, type 1.
The variable name and value appear in separate columns in the Environment Variable list. - Click OK or Apply.
Add Window Compositor from the Command Line
You can set the required values for SYSGEN and BSP variables and build the image from the command line without running Platform Builder, or you can open a command line to do this within Platform Builder. After you set the required values, use the following procedure to build the OS and add Window Compositor to it.
To add Window Compositor to an OS from the build command line
Open a Command Prompt window that points to the Wince.bat file that builds the OS. The following sample code opens a Command Prompt window that points to Wince.bat in the default location, C:\WINCE700\public\COMMON\oak\, and sets options for the batch file.
%SystemRoot%\system32\cmd.exe /k "set _WINCEROOT=C:\WINCE700\public\COMMON\oak\WinCE.bat x86 uldr CEPC"At the command prompt, do one of the following:
To include the default GDI compositor in the OS, type the following command.
SYSGEN_COMPOSITION=1To include the OpenGL compositor in the OS, type both of the following commands at the command line.
SYSGEN_COMPOSITION=1 BSP_GLES2COMPOSITOR=1
To build the image, at the command prompt, type blddemo with any arguments you want.