Mathworks MATLAB COMPILER RELEASE NOTES

Download

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

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

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)

008b)

New Features and Changes

Yes

Details

Yes Details

Yes

Detai

Yes Details

Version Compatibilit Consideratio

No Bug Reports

Yes Summary

No Bug Repor

Yes Summary

Yes Summa

No Bug Reports

Fixed Bugs

and Known

Problems

Includes fix

Bug Reports Includes fixes

Includes

Bug Reports Includes fixes

Bug Rep Inclu

Includes fixes

fixes

orts

des fixes

Related Documentation at Web Site

Printable Release

Notes: PDF

Current product documentation

V4.4 (R2006a)

.3 (R14SP3)

V4.2 (R14SP2)

Yes

ails

Det

Yes Details

No Bug

No Bug Reports

No No No

Reports

ludes fixes

Inc

Includes fixes

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

Yes Summary

Fixed Bugs and Known Problems

Fixed bugs

No No

Related Documentation at Web Site

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

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.

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.

Version 4.13 (R2010a) MATLAB®Compiler™ Software

linkdata on Not S

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

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.

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.

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

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 (32and 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.

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

• “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

• “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.

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

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

Visual

• “Enforcement of Proper Return Types For C/C++ Methods” on page 16

• “For More Information About Compilers Supported by MATLAB” on page

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

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

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™

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

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

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.

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

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

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

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

Migrate to

deploytool.

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

Support Added for Intel Mac and Solaris 64

Support has been added for the following operating systems:

• Intel Mac

• 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

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,

• 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

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:

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

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.

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.

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

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

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

Fixed Bugs an d Known Problems

No bug fixes

Related Documentation at Web Site

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.

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

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

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.

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.

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

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

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.

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:

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.

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.

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

genpath Function Works in Deployed Applications

You can now compile and deploy a MATLAB file that calls the genpath function.

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.

-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.

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

Targets

MATLAB Compiler can generate the following kinds of applications or components. None of these requires MATLAB on the end user’s system.

• 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

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

, 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

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

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

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

B pcode

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

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.

Macro that generates a function library. (The meaning of this option has changed since Release 13.)

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.

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

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

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

Mathworks MATLAB COMPILER RELEASE NOTES

Specifications and Main Features

Frequently Asked Questions

User Manual