Introduction (MATLAB C/C++ Graphics Library)

MATLAB C/C++ Graphics Library

Components of the MATLAB C/C++ Graphics Library

The MATLAB C/C++ Graphics Library contains more than 100 routines, including:

MATLAB 6.0 built-in graphics functions, such as surf, plot, get, and set
Some commonly used MATLAB 6.0 M-file graphics functions, such as newplot, gcf, gca, gco, and gcbf

Note The MATLAB C/C+ Graphics Library includes only a subset of MATLAB M-file graphics functions. If you application includes graphics functions that are not included in the library, the MATLAB Compiler will compile them when it creates your application. For information about MATLAB features that are not supported by the Graphics Library, see Restrictions.

Files Installed on PCs

Table 1-1 lists the shared libraries (DLLs), include files, and other files installed on a PC as part of a MATLAB C/C++ Graphics Library installation. In the table, <MATLAB> stands for your top-level MATLAB installation directory.

For more information about the installation process, read the Installation Guide for PC, available in PDF format from the MathWorks Web site. Click on the Documentation link and go to the Online Manuals page to find the documentation in PDF format.

Note On PCs, the MATLAB C/C++ Graphics Library installation includes new versions of several standard MATLAB dynamic link libraries (DLLs).

Table 1-1: List of Files Installed on PCs
Files
Location
Description

sgl.dll hg_sgl.dll uiw_sgl.dll hardcopy_sgl.dll gui_sgl.dll mpath.dll
<MATLAB>\bin
Shared libraries containing stand-alone versions of MATLAB built-in and M-file graphics functions.
All DLLs are in WIN32 format.

sgl sglcpp
<MATLAB>\toolbox\compiler\bundles
MATLAB Compiler bundle files, containing all the compiler options required to build a stand-alone graphics application.

libsgl.h libmwsglm.h libmwsglm.mlib sgl.def
<MATLAB>\extern\include
Graphics library header files (.h) and module definition file (.def).

FigureMenuBar.fig FigureToolBar.fig
<MATLAB>\extern\include
Alternate menu bar and toolbar files used with the MATLAB figure window in stand-alone applications.

flames.m flames.mat
<MATLAB>\extern\examples\sgl
The M-file and MAT-file for the graphics library example program.

Table 1-1: **List of Files Installed on PCs**
Files	Location	Description
`sgl.dll hg_sgl.dll uiw_sgl.dll hardcopy_sgl.dll gui_sgl.dll mpath.dll`	`<MATLAB>\bin`	Shared libraries containing stand-alone versions of MATLAB built-in and M-file graphics functions. All DLLs are in WIN32 format.
`sgl sglcpp`	`<MATLAB>\toolbox\compiler\bundles`	MATLAB Compiler bundle files, containing all the compiler options required to build a stand-alone graphics application.
`libsgl.h libmwsglm.h libmwsglm.mlib sgl.def`	`<MATLAB>\extern\include`	Graphics library header files (`.h`) and module definition file (`.def`).
`FigureMenuBar.fig FigureToolBar.fig`	`<MATLAB>\extern\include`	Alternate menu bar and toolbar files used with the MATLAB figure window in stand-alone applications.
`flames.m flames.mat`	`<MATLAB>\extern\examples\sgl`	The M-file and MAT-file for the graphics library example program.

Files Installed on UNIX Systems

Table 1-2 lists the shared libraries, include files, and other files installed on a UNIX system as part of a MATLAB C/C++ Graphics Library installation. In the table, <matlab> stands for your top-level MATLAB installation directory.

For more information about the installation process, read the Installation Guide for UNIX, available in PDF format on the Support page from the MathWorks Web site. Click on the Documentation link and go to the Online Manuals page to find the documentation in PDF format.

Table 1-2: List of Files Installed on UNIX Systems
File
Location
Description

libmwsgl.ext,
where .ext is .so on Solaris systems and .sl on HP 700
systems
<MATLAB>/extern/lib/<ARCH>
<ARCH> identifies the system architecture (i.e., alpha, glnx86, sgi, sgi64, sol2)
The graphics library binary file.
The libraries are shared libraries for all platforms.

sgl sglcpp
<MATLAB>/bin/toolbox/compiler/bundles
MATLAB Compiler bundle files, containing all the compiler command line options required to build a stand-alone graphics application.

libsgl.h libmwsglm.h libmwsglm.mlib
<MATLAB>/extern/include
The graphics library header file that contains prototypes for both the built-in and M-file graphics functions.

FigureMenuBar.fig FigureToolBar.fig
<MATLAB>/extern/include
Alternate menu bar and toolbar files used with the MATLAB figure window in stand-alone applications.

flames.m flames.mat
<MATLAB>/extern/examples/sgl
The M-file and MAT-file for the graphics library example program.

**Table 1-2: List of Files Installed on UNIX Systems**
File	Location	Description
`libmwsgl.`ext, where `.`ext is `.so` on Solaris systems and `.sl` on HP 700 systems	`<MATLAB>/extern/lib/<ARCH>` `<ARCH>` identifies the system architecture (i.e., `alpha`, g`lnx86`, `sgi`, `sgi64`, `sol2`)	The graphics library binary file. The libraries are shared libraries for all platforms.
`sgl sglcpp`	`<MATLAB>/bin/toolbox/compiler/bundles`	MATLAB Compiler bundle files, containing all the compiler command line options required to build a stand-alone graphics application.
`libsgl.h libmwsglm.h libmwsglm.mlib`	`<MATLAB>/extern/include`	The graphics library header file that contains prototypes for both the built-in and M-file graphics functions.
`FigureMenuBar.fig FigureToolBar.fig`	`<MATLAB>/extern/include`	Alternate menu bar and toolbar files used with the MATLAB figure window in stand-alone applications.
`flames.m flames.mat`	`<MATLAB>/extern/examples/sgl`	The M-file and MAT-file for the graphics library example program.

Introduction Restrictions