Mathworks MATLAB COMPILER RELEASE NOTES

MATLAB Notes
®
Compiler™ Release
How to Contact The MathWorks
www.mathworks. comp.soft-sys.matlab Newsgroup www.mathworks.com/contact_TS.html Technical Support
suggest@mathworks.com Product enhancement suggestions
bugs@mathwo doc@mathworks.com Documentation error reports service@mathworks.com Order status, license renewals, passcodes
info@mathwo
com
rks.com
rks.com
Web
Bug reports
Sales, prici
ng, and general information
508-647-7000 (Phone)
508-647-7001 (Fax)
The MathWorks, Inc. 3 Apple Hill Drive Natick, MA 01760-2098
For contact information about worldwide offices, see the MathWorks Web site.
®
MATLAB
© COPYRIGHT 2004–20 10 by The MathWorks, Inc.
The software described in this document is furnished under a license agreement. The software may be used or copied only under the terms of the license agreement. No part of this manual may be photocopied or reproduced in any form without prior written consent from The MathW orks, Inc.
FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentation by, for, or through the federal government of the United States. By accepting delivery of the Program or Documentation, the government hereby agrees that this software or documentation qualifies as commercial computer software or commercial computer software documentation as such terms are used or defined in FAR 12.212, DFARS Part 227.72, and DFARS 252.227-7014. Accordingly, the terms and conditions of this Agreement and only those rights specified in this Agreement, shall pertain to and govern theuse,modification,reproduction,release,performance,display,anddisclosureoftheProgramand Documentation by the federal government (or other entity acquiring for or through the federal government) and shall supersede any conflicting contractual terms or conditions. If this License fails to meet the government’s needs or is inconsistent in any respect with federal procurement law, the government agrees to return the Program and Docu mentation, unused, to The MathWorks, Inc.
Trademarks
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See
www.mathworks.com/trademarks for a list of additional trademarks. Other product or brand
names may be trademarks or registered trademarks of their respective holders.
Patents
The MathWorks products are protected by one or more U.S. patents. Please see
www.mathworks.com/patents for more information.
Compiler™ Release Notes
Summary by Version ............................... 1
Contents
Version 4.13 (R2010a) MATLAB
Version 4.11 (R2009b) MATLAB
Version 4.10 (R2009a) MATLAB
Version 4.9 (R2008b) MATLAB
Version 4.8 (R2008a) MATLAB
Version 4.7 (R2007b) MATLAB
Version 4.6 (R2007a) MATLAB
Version 4.5 (R2006b) MATLAB
Version 4.4 (R2006a) MATLAB
Version 4.3 (R14SP3) MATLAB
®
Compiler Software .. 4
®
Compiler Software .. 6
®
Compiler Software .. 8
®
Compiler Software ... 10
®
Compiler Software ... 13
®
Compiler Software ... 17
®
Compiler Software ... 20
®
Compiler Software ... 23
®
Compiler Software ... 24
®
Compiler Software ... 26
Version 4.2 (R14SP2) MATLAB
®
Version 4.1.1 (R14SP1+) MATLAB
Version 4.1 (R14SP1) MATLAB
Version 4.0.1 (R14+) MATLAB
Version 4.0 (R14) MATLAB
®
®
Compiler Software .... 35
®
Compiler Software ...... 38
Compiler Software ... 27
®
Compiler ......... 28
Compiler Software ... 31
iii
Compatibility Summary for MAT LAB®Compiler
Software
........................................ 44
iv Contents
SummarybyVersion
This table provides quick access to what’s new in each version. For clarification, see “Using Release Notes” on page 2 .
MATLAB®Compiler™ Release Notes
Version (Release)
Latest Versi V4.13 (R2010
V4.11 (R2009b)
V4.10 (R2009a)
V4.9 (R2
V4.8 (R2008a)
V4.7 (R2007b)
R2007a)
V4.6 (
V4.5 (R2006b)
on
008b)
New Features and Changes
Yes
a)
Details
Yes Details
Yes Details
Yes Details
Yes Details
Yes
ls
Detai
Yes Details
Yes Details
Version Compatibilit Consideratio
No Bug Reports
Yes Summary
No Bug Repor
Yes Summary
Yes Summary
Yes Summa
No Bug Reports
No Bug Reports
ry
Fixed Bugs
y
and Known
ns
Problems
Includes fix
Bug Reports Includes fixes
Includes
Bug Reports Includes fixes
Bug Reports Includes fixes
Bug Rep Inclu
Includes fixes
Includes fixes
ts
fixes
orts
des fixes
Related Documentation at Web Site
Printable Release
es
Notes: PDF
Current product documentation
No
No
No
No
No
No
No
V4.4 (R2006a)
.3 (R14SP3)
V4
V4.2 (R14SP2)
Yes
ails
Det
Yes Details
Yes Details
No Bug
No Bug Reports
No No No
Reports
ludes fixes
Inc
Includes fixes
No
No
1
MATLAB®Compiler™ Release Notes
Version (Release)
V4.1.1 (R14SP1+)
V4.1 (R14SP1)
V4.0.1 (R14+)
V4.0 (R14)
New Features and Changes
No No
Yes Details
No No
Yes Details
Version Compatibility Considerations
No
Yes Summary
Fixed Bugs and Known Problems
Fixed bugs
Fixed bugs
Fixed bugs
No No
Related Documentation at Web Site
No
No
No
Using Release Notes
Use release notes when upgrading to a newer version to learn about:
New features
Changes
Potential impact on your existing files and practices
Review the release notes for other MathWorks™ products required for this product (for example, MATLAB bugs, or compatibility considerations in other products impact you.
®
or Simulink®). Determine if enhancements,
If you are upgrading from a software version other than the m ost recent one, review the current release notes and all interim versions. For example, when you upg rade from V1.0 to V1.2, review the release notes for V1.1 and V1.2.
What Is in the Release Notes
New Features and Changes
New functionality
Changes to existing functionality
2
SummarybyVersion
Version Compatibility Con si derations
When a new feature or change introduces a reported incompatibility between versions, the Compatibility Considerations subsection explains the impact.
Compatibility issues reported after the product release appear under Bug Reports at The MathWorks™ Web site. Bug fixes can sometimes result in incompatibilities, so review the fixed bugs in Bug Reports for any compatibility impact.
Fixed Bugs and Known Problems
The MathWorks offers a user-searchable Bug Reports database so you can view Bug Reports. The development team updates this database at release time and as more information becomes available. Bug Reports include provisions for any known workarounds or file replacem ents. Information is available for bugs existing in or fixed in Release 14SP2 or later. Information is not avail able for all bugs in earlier releases.
Access Bug Reports using y our MathWorks Account.
3
MATLAB®Compiler™ Release Notes
Version 4.13 (R2010a) MATLAB Compiler Software
This table summarizes what’s new in Version 4.13 (R2010a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are:
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
Desktop Icon Available for Launching 64-Bit Mac Applications
Macintosh 64-bit applications can now be launched conveniently from the desktop. See “Using MATLAB Mac Application Launcher and other guidelines for UNIX, Linux, and Mac users.
®
Compiler™ on UNIX®”fordetailsaboutthe
New Video Demo Available
Watch a video about deploying applications using MATLAB Compiler.
Support for MATLAB Sparse Matrices
This release provides support for MATLAB sparse matrices via a C++ API. See “Static Factory Methods for Sparse Arrays” for a listing of capable classes and methods.
Deployment Tool Now Available from Command Line
You can now invoke the Deployment Tool GUI from the command line. See “Using the Command Line (mcc)” for more information.
4
Version 4.13 (R2010a) MATLAB®Compiler™ Software
linkdata on Not S
ng
In MAT LAB, setti plots in the same applications r
un in deploy ed mode.
linkdata on can be used to link data between multiple
figure. This feature is not available for standalone
upported in Deployed Mode
5
MATLAB®Compiler™ Release Notes
Version 4.11 (R2009b) MATLAB Compiler Software
This table summarizes what’s new in Version 4.11 (R2009b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes Summary
New features and changes introduced in this version are:
“Redesigned Deployment Tool GUI ” on page 6
“Customizable MCR Start-Up Message” on page 6
“MATLAB Memory Shielding Available” on page 7
“Mac 64-Bit Support Available” on page 7
“New Format for Deployment Tool Projects” on page 7
“Change in Windows Library Path” on page 7
“INLINE Option to MEX Function Deprecated” on page 7
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
Redesigned Deployment Tool GUI
The new Deployment Tool (deploytool) interface features in tu iti ve task-based navigation, a cancellable progress dialog, fast loading of previously-created projects, and ability to add supporting files as folders. The GUI also features new context sensitive help.
Customizable MCR Start-Up Message
Console applications can no w display a user-customizable message indicating that the MATLAB Compiler Runtime (MCR) is in the process of starting u p. See “Displaying MCR Initialization Start-Up and Completion Messages For Users” for more information.
6
Version 4.11 (R2009b) MATLAB®Compiler™ Software
MATLAB Memory Sh
The same memory s for deployed app resource-inte See “Reserving Shielding” fo
nsive applications are allocated proper run-time resources.
r more information.
Mac 64-Bit Su
Support for M
New Format f
If you have p R2009b, th changed in Tool (
depl
rojects that were created with the Deployment Tool prior to
ose projects will continue t o work. However, projects created or
R2009b cannot be opened in previous versions of Deployment
oytool
Change in
The path
matlabr
deploym and Test inform
matlab/bin/arch has been removed for Windows and replaced by
oot/runtime/win32|win64
ent target computers. See “Directories Required for Development
ing” and “Directories Required for Run-Time Deployment” for more
ation.
hielding process available in MATLAB is now available
lications. The process reserves memory to ensure
Memory for Deployed Applications with MATLAB Memory
pport Available
acintosh
®
64-bit processors is now available.
or Deployment Tool Projects
).
Windows L ibrary Path
ielding Available
. You may be required to reconfigure your
INLINE
For mo “INLI
Option to MEX Function Deprecated
re information on this change in support that will occur in R2010a, see
NE Option to MEX Function Deprecated” in the MATLAB Release Notes.
7
MATLAB®Compiler™ Release Notes
Version 4.10 (R2009a) MATLAB Compiler Software
This table summarizes what’s new in Version 4.10 (R2009a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes Summary
New features and changes introduced in this version are:
“Reduced MCR Size Saves on T ransfer Time” on page 8
“MATLAB Pcode Files Can Now Be Compiled” on page 8
“New Functions Return Information A bout MCR State” on page 8
®
“Microsoft
“Customized readme.txt Produced with Each Compilation” on page 9
Visual Studio Express 2008 Compilers Supported” on page 9
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
Printable Release Notes: PDF
Current product documentation
Reduced MCR Size Saves on Transfer Time
MCR copying and transfer time has been improved by 50% following a reduction in the file’s contents. The change will not reduce processor time or memory consumption since the deleted files were not loaded into RAM.
MATLAB Pcode Files Can Now Be Compiled
You can now compile MATLAB Preparsed Pseudocode files (Pcode files or "P-files"). For more information about Pcode and P-files, see the pcode function reference page in the MATLAB Function Reference.
New Functions Return Information About MCR State
New functions have been introduced that return data about MCR state, such as whether the MCR has been properly initialized or whether the MCR was
8
Version 4.10 (R2009a) MATLAB®Compiler™ Software
launched with a JVM instance enabled. For more information, see “Retrieving MCR Attributes” in the user guide.
Microsoft Visual Studio Express 2008 Compilers Supported
Microsoft®Visual Studio®Express 2008 compilers (32- and 64-bit version s) are now supported instead of Microsoft Visual Studio Express 2005 compilers (32­and 64-bit versions), which have been dropped from support. See “Installation and Configuration” in the MATLAB C om piler User’s G u id e for a complete list of supported compilers and information about installing and configuring them.
Customized readme.txt Produced with Each Compilation
An enhanced version of the readme.txt file, which is generated with each successful compilation, is now customi zed to include specific instructions about MATLAB Compiler deployment requirements.
9
MATLAB®Compiler™ Release Notes
Version 4.9 (R2008b) MATLAB Compiler Software
This table summarizes what’s new in Version 4.9 (R2008b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes Summary
New features and changes introduced in this version are:
“Applications Created with Parallel Computing Toolbox Can Be Compiled”
on page 10
“Data Sharing Between MATLAB Code, MCR Instance, and W rapper Code
Available” on page 11
“64-Bit Addressing of mwArrays Is New Default, 32-Bit Addressing No
Longer Supported” on page 11
“Microsoft
on page 11
“For More Information About Compilers Supported by MATLAB” on page
11
“Warning Results When Running Figure-Generating Applications or
Printing with -nojvm Flag” on page 12
®
Visual Studio 2008, 32-Bit and 64-Bit Editions, Now Supported”
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
No
10
“Same Name Class Objects Shared Between MCR Instances Will Not Work
Correctly ” on page 12
Applications Created with Parallel Computing Toolbox Can Be Compiled
You can now compile MATLAB applications that use the Parallel Computing Toolbox™. Resulting executables and components can scale to multicore and multiprocessing environments using the MATLAB Distributed Computing Server. For more information, see “ImprovingDataAccessUsingtheMCR
Version 4.9 (R2008b) MATLAB®Compiler™ Software
User Data Interface” in the MATLABCompilerUser’sGuideformore information.
Data Sharing Between MATLAB Code, MCR Instance, and Wrapper Code Available
It is now possible to share data between an MCR instance, the MATLAB code running on that MCR, and the wrapper code that created the M CR, by implementing two MATLAB functions and four external C functions in a new API that may be called from within deployed application wrapper code. Using these functions may potentially improve performance and promote efficient use of computing resources. See “Improving Data Access Using the MCR User Data Interface” in the MATLAB Compiler User’s Guide for more information.
64-Bit Addressing of mwArrays Is New Default, 32-Bit Addressing No Longer Supported
The MX_COMPAT_32_OFF variable, which allowed 32-bit addressing of
mwArrays, is no longer supported. As in R2008a, the default is 64-bit (large
array support). See ““Addressing mwArrays Above the 2 GB Limit”” in the MATLAB Compiler User’s Guide for more information.
Microsoft Visual Studio 2008, 32-Bit and 64-Bit Editions, Now Supported
Support is now available for Microsoft Visual Studio 2008, 32-bit and 64-bit editions.
For More Information About Compilers Supported by MATLAB
For more information about changes in compiler-related software and interfaces supported by MATLAB, see “Changes to Compiler S upport” in the MATLAB Compiler User’s Guide for more information.
11
MATLAB®Compiler™ Release Notes
Warning Results Applications or
As of R2008b, run
-nojvm option r
may succeed, a graphics func
-nojvm
-nojvm option
be removed.
,willn
Same Name Cl Instances W
Ifthesamec thesamepr component Java targe bug in the
based targets: C/C++ shared libraries, COM/.Net targets, and
ts. This bug does not affect standalone executables. This is due to a
MATLAB Object System and is being addressed.
ning a figure-generating application or printing with the
esults in a warning message. In some cases, figure rende ring
nd in other cases it may not. Similarly, various MATLAB
tions dependent on Java, such as graphics passed with
ot result in displayable graphics. In a future release, the
will no longer support figure-generating or printing and will
ass Objects Shared Between MCR
ill Not Work Correctly
lass name is used in two or more separate MCR instances within
ocess, the object will not work correctly. This bug impacts all
When Running Figure-Generating
Printing with -nojvm Flag
-R
12
Version 4.8 (R2008a) MATLAB®Compiler™ Software
Version 4.8 (R2008a) MATLAB Compiler Software
This table summarizes what’s new in Version 4.8 (R2008a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes Summary
New features and changes introduced in this version are:
“C++ API Now Supports 64-Bit Default” on page 13
“CTF Archives Now E mbedde d in a Single Binary Executable for
Convenient Deployment” on page 14
“Support Added for Microsoft
“Replacement of the mclmcr Header File” on page 14
“Run-Time Libraries Required for Applications Built with Microsoft
Studio 2008 Compiler” on page 14
“Large Array Support Now Default for C and C++ Code” on page 15
“Support Dropped for Borland Compilers” on page 15
“MATLAB Component Runtime Renamed” on page 15
“MATLAB Application Deployment Web Example Guide Available” on
page 15
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
®
Visual Studio 2008 Compiler” on page 14
Related Documentation at Web Site
No
®
Visual
“Enforcement of Proper Return Types For C/C++ Methods” on page 16
“For More Information About Compilers Supported by MATLAB” on page
16
C++ API Now Supports 64-Bit Default
In R2007b, the MX_COM PAT_ 32_OFF variable allowed for 64-bit support. In this release, 64-bit is the default setting. If you still require explicit
13
MATLAB®Compiler™ Release Notes
32-bit execution, see ““Addressing mwArrays Above the 2 GB Limit”” in the MATLAB Compiler User’s Guide for more information.
CTF Archives Now Embedded in a Single Binary Executable for Convenient Deployment
As of R2008a, CTF data is now automatically embedded directly in the C/C++, main a nd Winmain, sh a red libraries and standalones by default for convenient deployment of applications. In order to override this default functionality, you must compile with the CTF Archive Embedding Using the MCR Component Cache”” in the MATLAB Compiler User’s Guide fo r more information.
Support Added for Microsoft Visual Studio 2008 Compiler
Support has been added for the compiler included with Microsoft Visual Studio 2008. See “System Requirements ” in the MATLAB Compiler User’s Guide for more details.
-C option. See ““Overriding Default
14
Replacement of the mclmcr Header File
Starting with R2008a, replace all occurrences of #include mclmcr.h with
#include mclmcrrt.h.
If the library header created by MATLAB Compiler software is included in the external code, neither of these files need to be included, since the library header includes the correct file.
Run-Time Libraries Required for Application s Built with Microsoft Visual Studio 2008 Compiler
If yo u distribute a MEX-file, an engine application, or a MAT-file application built with the Visual Stud io run-time libraries. These files are required to run applications developed with Visual C++ on a computer that does not have Visual C++ 2008 installed. For information on locating the Microsoft Package (x86), containing your Microsoft
®
documentation.
®
2008 compiler, you must provide the Visual C++
®
Visual C++®2008 Redistributable
vcredist_x86.exe and vcredist_x64.exe,consult
®
Version 4.8 (R2008a) MATLAB®Compiler™ Software
Large Array Support Now Default for C and C++ Code
In R2008a, the default definition of MX_COMPAT_32 has been removed, and large array support is now the default for both C and C++ code. This new default may, in some cases, cause compiler warnings and errors. You can define behavior.
MX_COMPAT_32 in your mbuild step to return to the p revious default
Code compiled with
MX_COMPAT_32 controlsthebehaviorofsometypedefinitions. Forinstance,
when
MX_COMPAT_32 is defined, mwSize and mwIndex are defined to ints.
When
size_t. This can lead to compiler warnings and errors with respect to signed
and unsigned mismatches.
For information about expected behavior of this feature in R2007b, see ““Addressing mwArrays Above the 2 GB Limit”” in the MATLAB Compiler User’s Guide for more information..
This feature changes how the implemented. For more details, see ““Addressing mwArrays Above the 2 GB Limit”” in the MATLAB Compiler User’s G uide.
MX_COMPAT_32 is not defined, mwSize and mwIndex are defined to
MX_COMPAT_32 is not 64-bit aware. In addition,
MWArray C++ Library functions are
Support Dropped for Borland Compilers
Borland compilers are no longer supported as of this release.
MATLAB Component Runtime Renamed
The MATLAB Component Runtime has been renamed to the MATLAB Compiler Runtime.
MATLAB Application Deployment Web Example Guide Available
A new publication, the MATLAB Application Deployment Web Example Guide, is now available from the MATLAB Compiler, MATLAB
NE, and MA TLAB Builder JA roadmap pages.
®
Builder™
15
MATLAB®Compiler™ Release Notes
The guide provides full examples of common tasks performed by the MATLAB programmer, IT specialist, and others who play significant roles in deploying MATLAB applications to the Web.
Enforcement of Proper Return Types For C/C++ Methods
As of R2008a, the LCC compiler is more strict in enforcing bool return types from C and Return Types From C and C++ Methods” in the MATLAB Compiler User’s Guide.
For More Information About Compilers Supported by MATLAB
For more information about changes in compiler-related software and interfaces supported by MATLAB, see ““Changes to Compiler Support”” in the MATLAB Compiler User’s Guide for more information.
void returns from C++. For more information, see “C ode Proper
16
Version 4.7 (R2007b) MATLAB®Compiler™ Software
Version 4.7 (R2007b) MATLAB Compiler Software
This table summarizes what’s new in Version 4.7 (R2007b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes Summary
New features and changes introduced in this version are:
“Support Added for the Microsoft® Platform SD K ” on page 17
“Project Files Use Relative Paths and Can Be Shared” on page 17
“Replacement of MCRInstaller.zip and BUILDMCR Functionality” on
page 18
“Addressing MWArrays Above the 2 GB Limit” on page 18
“New Compiler Option –e” on page 18
“Support for Borland Compilers Being Phased Out” on page 19
“Functions Being Rem oved” on page 19
Fixed Bugs an d Known Problems
Bug Reports Includes fixes
Related Documentation at Web Site
No
Support Added for the Microsoft® Platform SDK
Support has been added for the Microsoft Platform SDK Compiler. See System Requirements in the MATLAB® Compiler User’s Guide documentation for more details.
Project Files Use Relative Paths and Can Be Shared
Project files can now be enabled for use with other computers since project files now use relative paths. See “Using Relative Paths with Project Files” in the MATLAB Compiler User’s Guide documentation for more details.
17
MATLAB®Compiler™ Release Notes
Replacement of MCRInstaller.zip and BUILDMCR Functionality
In past releases, you needed to include MCRInstaller.zip in your packaged application (created by running the the following files, which trigger self -extracting archives, that replace the functionality previously provided by MATLAB Compiler:
buildmcr command). Now you must run
MCRInstaller.zip. These files ship with
Platform
Windows
UNIX (Except for Mac)
Mac
Since there is no longer a need to create MCRInstaller.zip, buildmcr is no longer supported.
Type
mcr or mcrinstaller at the MATLAB command prompt for a list of
all available MCR installers, compatible platforms, version numbers, a nd other information. In addition, typing command prompt will provide further details and assistance.
See“WhatIsTheMATLABCompilerRuntime(MCR)?”formoreinformation.
File Replacing MCRInstaller.zip
MCRInstaller.exe
MCRInstaller.bin
MCRInstaller.dmg
help mcr or help mcrinstaller at the
Addressing MWArrays Above the 2 GB Limit
As of R2007b, you can address MWA rray s above the 2 GB limit. This is enabled by defining default as of R2008a.
This feature changes how the implemented. For more details, see ““Addressing mwArrays Above the 2 GB Limit”” in the MATLAB Compiler User’s Guide documentation.
MX_COMPAT_32_OFF in your mbuild step. This feature will be the
MWArray C++ Library functions are
18
New Compiler Option –e
This new mcc option suppresses the appearance of the MS-DOS command window when generating a standalone application. Use
-e in place of the
Version 4.7 (R2007b) MATLAB®Compiler™ Software
-m option. See “-e Suppress MS-DOS Command Window” in the MATLAB
Compiler User’s Guide documentation.
Support for Borland Compilers Being Phased Out
Borland compilers are supported in Version 7.5 (R2007b), but will not be supported in a future version of MATLAB. Please prepare and plan accordingly.
Functions Being Removed
The following functions were removed in R2007b:
Function Being Removed
buildmcr
comtool
dotnettool
mxltool
opennbl
openmxl
opencbl
What Happens When You Run the Function?
Errors
Undefined Function Error
Undefined Function Error
Undefined Function Error
Undefined Function Error
Undefined Function Error
Undefined Function Error
Use This Instead Compatibility
Considerations
MCRInstaller.exe
(Windows),
MCRInstaller.bin (UNIX), MCRInstaller.dmg (Mac)
See “What Is The MATLAB Compiler Runtime (MCR)?” in the MATLAB Compiler User’s Guide documentation.
deploytool
deploytool
deploytool
deploytool
deploytool
deploytool
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool.
Migrate to
deploytool.
19
MATLAB®Compiler™ Release Notes
Version 4.6 (R2007a) MATLAB Compiler Software
This table summarizes what’s new in Version 4.6 (R2007a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are:
“Support Added for Intel Mac an d Solaris 64” on page 20
“Support Dropped for Solaris 2” on page 20
“ReadmeFileAdded”onpage20
“Warning About Future Borland Compiler Support” on page 21
“New Compiler Option –F” on page 21
“Issues with the Microsoft Windows Vista Operating System ” on page 21
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
Support Added for Intel Mac and Solaris 64
Support has been added for the following operating systems:
Intel Mac
20
Solaris 64-bit
Support Dropped for Solaris 2
Support has been dropped for the Solaris 2 operating system. It has been replaced by suppo rt for Solaris 64.
Readme File Added
A readme file containing a customized checklist of deployment prerequisites is now generated in the output folder with each compiled application.
Version 4.6 (R2007a) MATLAB®Compiler™ Software
Warning About Fu
While still supp discontinuance
Borland C++Bui
Borland C++Bu
Borland C/C++
New Compiler
MATLAB Comp Use this opt Compiler. F documentat
Issues wit
orted in this release, customers should prepare for
of support for the following Borland compilers:
lder version 6.0
ilder version 5.0
(free command-line tools) version 5.5
Option –F
iler 4.6 includes the ion to feed back a specific project file’s settings to MATLAB or more information, see the MATLAB Compiler User’s Guide
ion.
htheMicrosoftWindowsVistaOperating
System
The follo resolve t
With Use
wing are known issues with Windows Vista™ as of this release. To
hese issues, ensure you are logged in as Administrator.
r Account Control (UAC) enabled, a standard user is not able to write to Notes f
afolderinthe
or more details regarding this issue.
ture Borland Compiler Support
-F option for both mcc and deploytool.
c:\Program Files folder. See the MATLAB Release
With Us
regist the fo
er Account Control (UAC) enabled, a standard user is not able to
er DLLs. When
mbuild -setup attempts to register mwcomutil.dll,
llowing errors are displayed:
Trying to update options file:
C:\Users\qe\AppData\Roaming\MathWorks\MATLAB\R2007a\compopts.bat
From template:
C:\PROGRA~1\MATLAB\R2007a\bin\win64\mbuildopts\msvc80compp.bat
Done . . .
--> "C:\PROGRA~1\MATLAB\R2007a\bin\win64\mwregsvr C:\PROGRA~1\MATLAB\R2007a\bin\
win64\mwcomutil.dll"
Error: DllRegisterServer in C:\PROGRA~1\MATLAB\R2007a\bin\win6 4\mwcomutil.dll
21
MATLAB®Compiler™ Release Notes
failed
Undefined subroutine &mexsetup::expire called at C:\PROGRA~1\MATLAB\R2007a\bin\/
mexsetup.pm line 839.
This is also the case when MATLAB Builder for Excel invokes mbuild in an attempt to register DLLs after a compilation completes.
The following message is displayed when MATLAB Builder for .NET,
attempts to install a DLL into the Global Assembly Cache from a network location:
Unhandled Exception: System.IO.FileLoadException: could not load file or assembly
'GACInstaller, Version=1.0.2568.30711, Culture=neutral, Public KeyToken=null' or
one of its dependencies. Failed t o grant permission to execute. (Exception from
HRESULT: 0x80131418)
File name: 'GACInstaller, Version=1.0.2568.30711, Culture=neutral,
PublicKeyToken=null' ---> System.Security.Policy.PolicyException: Execution
permission cannot be acquired.
PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,
PermissionSet& denied, Boolean checkExecutionPermission)
PermissionSet reqdPset, PermissionSet optPset, PermissionSet denyPset,
PermissionSet& denied, Int32& securitySpecialFlags, Boolean
checkExecutionPermission)
at System.Security.SecurityManager.ResolvePolicy(Evidence evidence,
at System.Security.SecurityManager.ResolvePolicy(Evidence evidence,
22
Printing from a compiled applicati on is not currently available with
Microsoft Windows Vista. The following message is displayed if you attempt to print on systems with the Microsoft Windows Vista 32-bit operating system installed:
PrintImage Error
StartPage failed with error 6: Th e handle is invalid.
Printing with Vista 64-bit installed results in an error message that lists a manifest as missing. Please check
http://www.mathworks.com/support/
for updates on these issues.
Version 4.5 (R2006b) MATLAB®Compiler™ Software
Version 4.5 (R2006b) MATLAB Compiler Software
This table summarizes what’s new in Version 4.5 (R2006b):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are:
“Support for Java Components” on page 23
“Deployment Tool Graphical User Interface” on page 23
Fixed Bugs an d Known Problems
Includes fixes
Related Documentation at Web Site
No
Support for Java Components
MATLAB Compiler, in conjunction with the optional MATLAB Builder for Java, lets you convert MATLAB files into Java components.
Deployment Tool Graphical User Interface
As an alternative to the mcc commandtoinvokeMATLABCompiler,youcan invoke the graphical user interface for MATLAB Compiler by issuing the following command at the M ATLAB prompt:
deploytool
Use the Deployment Tool to perform the tasks shown in the following conceptual illustration:
23
MATLAB®Compiler™ Release Notes
Version 4.4 (R2006a) MATLAB Compiler Software
This table summarizes what’s new in Version 4.4 (R2006a):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
New features and changes introduced in this version are:
“Support for .NET Components” on page 24
“Support for Microsoft
“HP-UX No Longer Supported” on page 25
This release p rovides support for a new target, .NET components. With the optional MATLAB Builder for .NET product, you can create both COM components that can be used in native code applications and .NET components that can be used in managed code applications.
Fixed Bugs an d Known Problems
Includes fixes
®
Visual C ++ Version 8.0” on page 24
Related Documentation at Web Site
No
Support for .NET Components
MATLAB Compiler, in conjunction with the optional MATLAB Builder for .NET, lets you convert MATLAB files into .NET components that are accessible from any Comm on Language Specification (CLS)-compliant client code. In addition, you can build Common Object Model (COM) components that are accessible from Visual Basic, C/C++, Microsoft Excel, or any other COM client.
24
Support for Microsoft Visual C++ Version 8.0
MATLAB Compiler supports Microsoft Visual C++ Version 8.0 as a third-party compiler. However, if you use Microsoft Visual C/C++ Version 8.0 to generate applications/components, you must have the Microsoft Visual Studio 2005 run-time libraries available on the computer used for deployment. If you distribute your applications/components, you must make sure that any
Version 4.4 (R2006a) MATLAB®Compiler™ Software
machine used for deployment has these run-time libraries installed. For more information, see solution 1–2223MW.
HP-UX No Longer Supported
MATLAB Compiler 4.4 (R2006a) does not support HP-UX. MATLAB Compiler
4.3 (R14SP3) was the last release to support HP-UX.
25
MATLAB®Compiler™ Release Notes
Version 4.3 (R14SP3) MATLAB Compiler Software
This table summarizes what’s new in Version 4.3 (R14SP3):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No Bug Reports
Fixed Bugs an d Known Problems
Related Documentation at Web Site
No
Includes fixes
Platform Support
You can use MATLAB Compiler 4.3 on the following supported systems to create redistributable, standalone applications or software components. These applications or com ponents can then be deployed to other systems with the same operating system.
Supported Platforms
MATLAB Compiler 4.3 is supported on these platforms:
Windows
Linux
Solaris™
HP-UX
Linux x86-64
Mac OS
®
®
®
®
X
26
The MATLAB Compiler documentation has been updated to include configuration information for a ll the supported platforms.
Version 4.2 (R14SP2) MATLAB®Compiler™ Software
Version 4.2 (R14SP2) MATLAB Compiler Software
This table summarizes what’s new in Version 4.2 (R14SP2):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Platform Support
You can use MATLAB Compiler 4.2 on the following supported systems to create redistributable, stand-alone applications or software components. These applications or com ponents can then be deployed to other systems with the same operating system.
Supported Platforms
MATLAB Compiler 4.2 is supported on these platforms:
Windows
Linux
Solaris
HP-UX
Linux x86-64
The MATLAB Compiler documentation has been updated to include configuration information for a ll the supported platforms.
27
MATLAB®Compiler™ Release Notes
Version 4.1.1 (R14SP1+) M ATLAB Compiler
This table summarizes what’s new in Version 4.1.1 (R14SP1+):
New Features and Changes
No No
Version Compatibility Consideratio
Fixed Bugs
MATLAB Com (Release 1
buildmcr Function Supports Use of ~ in the File Name on UNIX
With this name or fo
zipfile = buildmcr('~/mcr')
Before t or fold
Error opening '~/mcr/MCRInstaller.zip'
C++ Shared Libraries Fully Supported with Borland Compilers
With this release, you can use supported versions of the Borland Compiler (see the Supported Compilers list) to build C++ shared libraries. In previous releases, Borland compilers can build C shared libraries, but building C++ shared libraries resulted in link-time errors. These errors have been resolved.
Fixed Bugs an d Known Problems
ns
Fixed bugs
piler 4.1.1 includes bug fixes incorporated since Version 4.1
4SP1). These bug fixes include the following.
release, you can use the
lder on UNIX systems. For example:
his rele ase, usin g the
er on UNIX systems caused the error:
~ character as part of the destination file
~ character as part of the destination file name
Related Documentation at Web Site
No
28
ExcludedFunctionsListStoredinaLogFile
If you use the -v option to generate the verbose output of the compilation steps, MATLAB Compiler creates a log file called This file contains, if any, the list of functions that have been excluded from the compiled application. This list does not include the core MATLAB functions
mccExcludedFiles.log.
Version 4.1.1 (R14SP1+) MATLAB®Compiler™
that are unsupported. See“Unsupported Functions” in the MATLAB Compiler User’s Guide documentation.
loadlibrary Function Works in Compiled Mode
The load libr ary function did not work in certain cases in compiled mode. This problem has been resolved with this release o f MATLAB Compiler. Note that the libraries created using MA TLAB Compiler cannot be loaded into MATLAB workspace using the
loadlibrary function.
mclcppMlfFeval No Longer Multiply Defined
In R14, before Service Pack 1, C++ applications that linked against two or more MATLAB Compiler generated C++ shared libraries would get a link-time error indicating that Pack 1, this function, which is found in been declared
inline; this resolves the problem.
mclcppMlfFeval was multiply defined. In R14 Service
extern/include/mclcppclass.h,has
MCR Started by MATLAB Compiler Returns true for isdeployed
You can use the isdeployed function to determine if an MC R was s tarted by MATLAB Compiler. The function will return true for this MCR, thus replicating the deployed environment.
mcc command starts a new MCR. The isdeployed
Misleading -e Error Is Resolved
On Windows, when mbuild (which is called by mcc) fails, you will no longer get the m i sleading error about
-e not being an internal or an external command.
Reduced Compilation Time and Size of the CTF File
In certain scenarios, the compilation time is reduced and the size of the CTF file is smaller.
Translation Files for Various Toolboxes Included in the CTF File
When various toolboxes are compiled, the translation files are now included in the CTF archive. This will let Japanese users see the translated output for certain toolbox messages.
29
MATLAB®Compiler™ Release Notes
web Function Compiles Successfully
In MATLAB Compiler 4.0 (R14), MATLAB files that used the web function would compile (apparently without error), but fail to execute at run time. This occurred because a function that the not being shipped.
web command depends on, ibrowse,was
ibrowse is now shipped with the MCR.
30
Version 4.1 (R14SP1) MATLAB®Compiler™ Software
Version 4.1 (R14SP1) MATLAB Compiler Software
This table summarizes what’s new in Version 4.1 (R14SP1):
New Features and Changes
Yes Details below
Version Compatibility Considerations
No
New features and changes introduced in this version are:
“Solaris Support” on page 31
“Installing a New Version of the MCR on Windows” on page 33
“Fixed Bugs” on page 33
Fixed Bugs an d Known Problems
Fixed bugs
Related Documentation at Web Site
No
Solaris Support
You can use MATLAB Compiler 4.1 on supported Solaris systems to create redistributable, standalone applications or software components. These applications or components can then bedeployedtootherSolarissystems.
We encourage you to use this beta version for Solaris and we appreciate your feedback. We expect to release a fully qualified version of MATLAB Compiler for Solaris as soon as possible.
buildmcr on Solaris
The buildmcr command that ships with MATLAB Compiler 4.1 may fail on some Solaris systems. You must upgrade your see the error mes sage:
buildmcr command if you
"Could not redirect CTFARCHIVER output to the MATLAB Desktop"
All Solaris users are advised to upgrade their buildmcr command. For instructions on how to upgrade, see our Support site and search for “Solaris BUILDMCR.” This upgrade is not necessary for Windows or Linux users.
31
MATLAB®Compiler™ Release Notes
Modifying the Dynamic Library Path on Solaris
Development Machine. To run a MATLAB Compiler generated application
on your development machine, add the following folders to your dynamic library path.
Note For readability, the following command appears on separate lines, but you must enter it all on one line.
setenv LD_LIBRARY_PATH
/usr/lib/lwp:
matlabroot/bin/sol2: matlabroot/sys/os/sol2: matlabroot/sys/java/jre/sol2/jre1.4.2/lib/
matlabroot/sys/java/jre/sol2/jre1.4.2/lib/sparc/client: matlabroot/sys/java/jre/sol2/jre1.4.2/lib/sparc: matlabroot/sys/opengl/lib/sol2:${LD_LIBRARY_PATH}
setenv XAPPLRESDIR <matlabroot>/X11/app-defaults
sparc/native_threads:
32
Target Machine. To run a MATLAB Compiler generated application on a target m achine (a machine without MATLAB that has the MCR installed), add the following folders to your dynamic library path.
Note For readability, the following command appears on separate lines, but you must enter it all on one line.
setenv LD_LIBRARY_PATH
/usr/lib/lwp:
mcr_root/runtime/sol2: mcr_root/sys/os/sol2: mcr_root/sys/java/jre/sol2/jre1.4.2/lib/sparc/native_threads: mcr_root/sys/java/jre/sol2/jre1.4.2/lib/sparc/client: mcr_root/sys/java/jre/sol2/jre1.4.2/lib/sparc: mcr_root/sys/opengl/lib/sol2:${LD_LIBRARY_PATH}
setenv XAPPLRESDIR <mcr_root>/X11/app-defaults
Version 4.1 (R14SP1) MATLAB®Compiler™ Software
<mcr_root> is the folder w here the MCR is installed.
Redistribution o f the Sun sunperf Library
On Solaris, the only compiler that MATLAB Compiler supports is the Sun compiler. If you are a Solaris user who is licensed to use the Sun compiler, you can redistribute the Sun your end users. For more information, consult your Sun license agreement.
sunperf and dependent libraries, including BLAS, to
Installing a New Version of the MCR on Windows
The MCRInst alle r now supports th e installation of m ultiple versions of the MCR on a target machine. This allows applications compiled with different versionsoftheMCRtoexecutesidebysideonthesamemachine.
If multiple versions of the MCR are not desired on the target machine, you can run Add or Remove Programs from the Control Panel to remove any of the p rev ious versions. This can be done either before or after installation of a more recent version of the MCR, as versions can be installed or removed in any order.
MCR Version 7.0 Restriction
The only caveat to installing a new version of the MCR is that you cannot automatically install versio n 7.0 in the same folder as a previo usly installed version of the MCR. This restriction applies only to version 7.0 of the
MCRInstaller. If you must install version 7.0 in the same folder as a previous
version, you should first run the version 7.0 folder. After the installation completes, y ou should manually add the MCR run-time folder
<TargetDir>\v70\runtime\win32 to the system path.
MCRInstaller and select that
Fixed Bugs
MATLAB Compiler 4.1 includes bug fixes incorporated since Version 4.0.1, which was released via the Web in July 2004. These bug fixes include the following.
33
MATLAB®Compiler™ Release Notes
Calls to Java Code Work in Deployed Applications
In MATLAB Compiler 4.0 (Release 14), users were not able to deploy MATLAB applications that used certain Java files. For example, they could not deploy the Database Toolbox functions. This b ug has been fixed in this release.
Deploying Applica tions to Non-U.S. Locale Systems
The SET_PARAM error that was generated when an application was deployed to a non-U.S. locale system has been fixed.
Printing Figure Windows
On Windows, the problem of printing figure windows has been resolved and should work as expected.
Using pause in Applications Generated by MATLAB Compiler Software
In Release 14 on Windows, MATLAB Compiler generated applications that used the happen if you called This problem has been resolved.
pause command would occasionally hang. This was more likely to
pause frequently or y ou used very small timeout values.
34
Version 4.0.1 (R14+) MATLAB®Compiler™ Software
Version 4.0.1 (R14+) MATLAB Compiler Software
This table summarizes what’s new in Version 4.0.1 (R14+):
New Features and Changes
No No
Version Compatibility Considerations
Fixed Bugs
MATLAB Compiler 4.0.1 includes bug fixes incorporated since Version 4.0. Thesebugfixesincludethefollowing.
buildmcr Utility Works on Linux
You can use the buildmcr utility to create an MCRInstaller on Linux. For more information on documentation.
extractCTF Utility Works on Linux
The extractCT F utility has been moved to the
matlabroot/toolbox/compiler/deploy/glnx86 folder on Linux. You can
use this utility to extract the CTF archive into the current working folder.
Files Added Using addpath Are Found
MATLAB Compiler can locate the files that are in folders that have been added to the MATLAB path using the
Fixed Bugs an d Known Problems
Fixed bugs
buildmcr, see the MATLAB Compiler User’s Guide
addpath command.
Related Documentation at Web Site
No
genpath Function Works in Deployed Applications
You can now compile and deploy a MATLAB file that calls the genpath function.
35
MATLAB®Compiler™ Release Notes
input Function Works in Deployed Applications
The input function works properly i n deployed applications. It no longer waits for the input first and then displays the input prompt.
loadlibrary Function Works in Deployed Applications
MATLAB Compiler supports the compilation of the loadlibrary function.
Note MATLAB Compiler generated libraries cannot be loaded into the MATLAB workspace using the
MCRInstaller Works on Windows NT
The MCRInstaller works properly on Windows NT.
Private Folders Work Properly
Private folders deploy properly and work as expected in this release of MATLAB Compiler.
loadlibrary function.
36
-V2.0 Option Removed
The -V2.0 option that was available in previous releases of MATLAB Compiler has been obsoleted and is no longer available. Using this option will give an error message.
-w (Warning) Requires Option
You must specify an option (list, disable, enable,orerror) when using the
-w option to display warnings. This table shows thevalidforms.
Syntax Description
-w list
-w enable
Generates a table that maps string to warning message for use with
disable,anderror.
Enables complete warnings.
enable,
Version 4.0.1 (R14+) MATLAB®Compiler™ Software
Syntax Description
-w disable[:string]
-w enable[:string]
-w error[:string]
Disables specific warning associated with
string. Leave off the optional :string to
apply the
disable action to all warnings.
Enables specific warning associated with
string. Leave off the optional :string to
apply the
enable action to all warnings.
Treats specific warning associated with
string as error. Leave off the optional
:
string to apply the error action to all
warnings.
Warning About set_param Removed
You no longer get a warning/error message regarding SET_PARAM not being found when using MATLAB Compiler software.
37
MATLAB®Compiler™ Release Notes
Version 4.0 (R14) MATLAB Compiler Software
This table summarizes what’s new in Version 4.0 (R14):
New Features and Changes
Yes Details below
Version Compatibility Considerations
Yes—Details labeled as Compatibility Considerations, below. See also Summary.
New features and changes introduced in this version are:
“Targets” on page 38
“Language Support” on page 39
“Improved C++ Interface” on page 39
“MATLAB Compiler Runtime” on page 39
“Component Technology File” on page 39
“Compatibility Considerations” on page 39
Fixed Bugs an d Known Problems
No bug fixes
Related Documentation at Web Site
No
Targets
MATLAB Compiler can generate the following kinds of applications or components. None of these requires MATLAB on the end user’s system.
38
Standalone applications
C and C++ shared libraries (dynamically linked libraries, or DLLs, on
Microsoft Windows)
Excel add-ins; requires MATLAB Builder for Excel
COM objects; requires MATLAB Builder for COM
Version 4.0 (R14) MATLAB®Compiler™ Software
Language Suppor
MATLAB Compiler objects. In addi method functio
Improved C++ I
The C++ interf been improve
Note MATLAB some MathWo may be nonde of toolbox will not co more infor Compiler
d.
graphical u ser interfaces will be restricted). MATLAB Compiler mpile Simulink
mation re garding the compilability of toolboxes, see the MATL AB
product page on the Web.
MATLAB C
MATLAB C is a stan MATLAB The MCR
ompiler 4 uses the new MATLAB Compiler Runtime (M CR), which
dalone s et of shared libraries that enable the execution of compiled
files, instead of the MATLAB C/C++ Math and Graphics Libraries.
provides complete support for all features of the MATLAB language.
supports all the functionality of MATLAB, including
tion, n o special considerations are necessary for private and
ns; they are handled by MATLAB Compiler.
nterface
ace for MATLAB Compiler generated wrapper functions has
Compiler 4 will not compile every toolbox, consequently,
rks toolboxes will not be deployable. Portions of toolboxes
ployableduetolicensingrestrictions (in general, compilation
ompiler Runtime
t
®
, Stateflow®, or products that require them. For
Compo
MATLA house arch symm
Comp
MAT Com MAT
nent Technology File
B Compiler 4 also uses a Component Technology File (CTF) archive to
the deployable package. All MATLAB files are encrypted in the CTF
ive using the Advanced Encryption Standard (AES) cryptosystem, where
etric keys are protected by 1024-bit RSA keys.
atibility Considerations
LAB Compiler 4 is compatible with previous releases of MATLAB
piler. MATLAB files that you compiled with a previous version of
LAB Compiler should compile with this version if your MATLAB files
39
MATLAB®Compiler™ Release Notes
contain only compilable Release 14 functions. There are no restrictions on the contents of your MATLAB files other than compatibility with Release 14.
Compiling MATLAB and Toolboxes
MATLAB Compiler supports the full MATLAB language and almost all MATLAB based toolboxes. However, some limited MATLAB and toolbox functionality is not licensed for compilation:
Functionality that cannot be called directly from the command line will
not compile.
Most of the prebuilt graphical user interfaces included in MATLAB and
its companion toolboxes will not compile, for example, Processing Toolbox™.
Some toolboxes, such as Symbolic Math Toolbox ™ , will n ot compile.
The code generated by MATLAB Compiler is not suitable for embedded applications.
sptool from Signal
40
Toseeanup-to-datelistofnoncompilable toolboxes and functionality, visit the MATLAB Compiler product page on the Web.
Differences Between Release 14 and Previous Versions of MATLAB Compiler
This section highlights significant differences between Compiler 4 and previous versions of MATLAB Compiler.
MATLAB Compiler 4 is a deployment tool for creating so ftware components and complete a pp lica tions that can be distributed to other users. This version of MATLAB Compiler fully supports all features of the MATLAB language including objects:
Compiler 4 uses the new MATLAB Compiler Runtime (MCR), which is a
stand-alone set of shared libraries that enable the execution of compiled MATLAB files, instead of the MATLAB C/C++ Math and Graphics Libraries.
Compiler 4 does not support the creation of MEX-files and Simulink
S-functions from MATLAB functions because features in MATLAB 7 make
Version 4.0 (R14) MATLAB®Compiler™ Software
this functionality redundant. The MATLAB JIT makes compilation for speed obsolete, and the MATLAB you to hide your proprietary algorithms.
Compiler 4 is supported on Microsoft Windows and Linux only. Support is
planned for additional platforms in a future release.
Compiler 4 does not include the MATLAB Add-in for Visual Studio.
Compiler 4 does not speed up applications. There is no speed difference
between a compiled application and running it in MATLAB. The compiled application will run as fast as MATLAB with the JIT Accelerator.
MATLAB does not support the loading of MATLAB Compiler generated
libraries via the
loadlibrary function.
pcode (preparsed code) function enables
Compiler 4 does not support the set of imputed functions including
mbcharscalar, mbcharvector, mbint, mbintscalar, mbin tvec tor, mbreal, mbrealscalar, mbrealvector, mbscalar,andmbvector.Compiler4makes
the need for these functions obsolete.
Compiler 4 eliminates the need to use
Compiler from a shell (DOS or UNIX) prompt. Consequently, is no longer available with Compiler 4.
Wrapper Differences.
Compiler 4 only generates code for interface functions (wrappers), whereas
previous versions generated code for the entire MATLAB file. There are several differences to be aware of when calling Release 14 Compiler functions from C or C++:
mccsavepath to invoke MATLAB
mbchar,
mccsavepath
- Since Compiler 4 does not use the MATLAB C/C++ Math and Graphics
Libraries, the various libraries are no longer available. Some of the Release 13 have Release 14 equivalents in the MATLAB External Interface functions. For example, you can replace calls to to
mxCreateDoubleScalar.
mlf functions previously a vailable with the
mlf functions
mlfScalar with calls
- The interface to the mlf functions generated by MATLAB Compiler from
your MATLAB file routines has changed . Unlike previous versions of MATLAB Compiler, all the return values are passed as input to the function. The return value of these functions is Compiler documentation for additional details.
void. See the MATLAB
41
MATLAB®Compiler™ Release Notes
- The initialize routine now returns a status flag that can be used to
test if the library w as initialized properly.
Note These wrapper file differences only affect u se rs who build libraries; they do not affect users who build executables.
Deprecated Compiler Op tions .
Compiler 4 has deprecated options that involve code generation and
formatting. The following options are no longer supported and will produce errors if used.
Option Description
A
B pcode
F
h
i
l
L
O
p
S
t
u
x
y
Code annotation
Generate P-code
Format parameters
Helper functions
Include specified MATLAB files
Line/file numbers (This option has changed and now means “library”.)
Target language
Optimized code
Generate C++ code (This option has changed and now means “add folder to compilation path in an order-sensitive context.”)
Macro to generate Simulink S-function
TranslateMATLABcodetoC/C++code
Specifies number of inputs for Simulink S-function
Macro to generate MEX-function
Specifies number of outputs for Simulink S-function
42
Version 4.0 (R14) MATLAB®Compiler™ Software
Compiler 4 has deprecated some wrapper options and their associated
bundle files. The following wrapper options and their associated bundle files are deprecated and are replaced by the new ones.
Wrapper O ption/Bundle File Replaced By
B csglcom B csglexcel B csglsharedlib B cppsglcom B cppsglexcel
W comhg W excelhg W libhg W mainhg
B ccom B cexcel B csharedlib B cppcom B cppexcel
Wcom W excel Wlib W main
You no longer need to use -B sgl and -B sg lcpp to access Handle
Graphics
®
functions. A ll compiled applications have access to graphics by
default.
New Compiler Op tions. Compiler 4 includes several new options.
Option Description
a filename
Add filename to archive; specifies files to be directly added to the CTF archive.
l
Macro that generates a function library. (The meaning of this option has changed since Release 13.)
N
Clears the path of all but a minimal, required set of folders.
p directory
R -nojvm R -nojit
Add directory tocompilationpathinanorder-sensitive context; requires
-N option.
Run-time; provides MCR options; same as MATLAB startup options of the same name; only used with executable target.
43
MATLAB®Compiler™ Release Notes
Compatibility Summary for MATLAB Compiler Software
This table summarizes new features and changes that might cause incompatibilities when you upgrade from an earlier version, or wh en you use files on multiple versions. Details are provided in the description of the new feature or change.
Version (Rel ea se) New Features and Chang e s with Version Compatibility
Impact
Latest Version V4.13 (R2010a)
V4.11 (R2009b) See “New Format for Deployment Tool Projects” on page 7
V4.10 (R2009a)
V4.9 (R2008b) See “C++ API Now Supports 64-Bit Default” on page 13.
V4.8 (R2008a) See “C++ API Now Supports 64-Bit Default” on page 13.
V4.7 (R2007b) See “Functions Being Removed” on page 19.
V4.6 (R2007a)
V4.5 (R2006b)
V4.4 (R2006a)
V4.3 (R14SP3)
V4.2 (R14SP2)
V4.1.1 (R14SP1+)
V4.1 (R14SP1)
None
None
See “Warning Results When Running Figure-Generating Applications or Printing with -nojvm Flag” on page 12.
See “Replacement of the mclmcr Header File” on page 14.
None
None
None
None
None
None
None
44
Compatibility Summary for MATLAB®Compiler™ Software
Version (Rel ea se) New Features and Chang e s with Version Compatibility
Impact
V4.0.1 (R14+)
None
V4.0 (R14) See the Compatibility Considerations subheading for each of
these new features and changes:
“Compiling MATLAB a nd Toolboxes” on page 40
“Differences Between Release 14 and Previous Versions of
MATLAB
®
Compiler” on page 40
45
Loading...