Этот пример создает интерфейс MATLAB® к библиотеке matrixOperations C++ для Linux®. Процесс включает:
Сгенерируйте файл определения (definemyPkg.mlx).
Измените файл определения, чтобы завершить любые определения, которые MATLAB не может автоматически преобразовать.
Создайте интерфейс библиотеки.
Для получения дополнительной информации смотрите Сборку Интерфейс MATLAB к Библиотеке C++.
MATLAB обеспечивает библиотеку C++ и заголовочные файлы для вас, чтобы использовать в этом примере. Файлы библиотеки находятся в этой папке и ее подпапках:
fullfile(matlabroot,'extern','examples','cpp_interface')
Первый шаг для генерации интерфейса готовит необходимые папки и файлы и вызывает clibgen.generateLibraryDefinition сгенерировать файл определения.
Создайте папку издателя
Создайте папку для файла интерфейса MATLAB.
% Replace user with your user name
pubPath = '/mathworks/home/user/MATLAB/publisher/matrixexample/';
if ~isfolder(pubPath)
mkdir(pubPath)
end
cd(pubPath)Идентифицируйте файлы библиотеки C++
Идентифицируйте имена и пути к артефактам библиотеки C++.
productPath = fullfile(matlabroot,'extern','examples','cpp_interface'); libPath = fullfile(productPath,'glnxa64'); % Header file name hppFile = 'matrixOperations.hpp'; % Full path to folder containing all header files hppPath = productPath; % Full path to folder containing include files iPath = hppPath; % Library file name libFile = 'libmwmatrixOperations.so';
Назовите интерфейс
По умолчанию MATLAB создает интерфейс под названием matrixOperations. В данном примере поменяйте имя на myPkg.
myPkg = 'myPkg';
Вызовите clibgen.generateLibraryDefinition
Чтобы создать интерфейс, необходимо задать:
Имя заголовочного файла matrixOperations.hpp и его местоположение.
Путь к папке, содержащей включать файлы, с помощью 'IncludePath' аргумент.
Название и местоположение совместно использованного файла библиотеки matrixOperations.lib, использование 'Libraries' аргумент.
Опционально, можно задать:
Имя библиотеки, с помощью 'PackageName' аргумент.
Отобразите сообщения генерации, с помощью 'Verbose' аргумент.
myPkg = 'myPkg'; v = true; clibgen.generateLibraryDefinition(fullfile(hppPath,hppFile),... 'IncludePath', iPath,... 'Libraries', fullfile(libPath,libFile),... 'PackageName', myPkg,... 'ReturnCArrays',false,... 'Verbose',v)
Просмотрите функциональность
Несмотря на то, что некоторые построения требуют дополнительного определения, можно просмотреть доступную функциональность. Если эта функциональность достаточна для ваших потребностей, то можно продолжить шаг Интерфейса Библиотеки Сборки. В противном случае продолжите шаг, Задают Недостающие Построения.
summary(definemyPkg)
MATLAB Interface to myPkg1 Library
Class clib.myPkg1.Mat
Constructors:
clib.myPkg1.Mat()
clib.myPkg1.Mat(clib.myPkg1.Mat)
Methods:
uint64 getLength()
No Properties defined
Functions
clib.myPkg1.updateMatByX(clib.myPkg1.Mat,int32)Чтобы задать недостающие построения, щелкните по ссылке в generateLibraryDefinition выходной сигнал, чтобы отредактировать определения в definemyPkg.mlx. Для получения информации о редактировании этого файла и примеров для определения аргументов, смотрите, Задают Недостающую информацию для Подписей MATLAB.
Ищите файл определения setMat метод и некомментарий операторы, задающие его. Задавать src аргумент, в этом defineArgument оператор, замена <SHAPE> с "len".
defineArgument(setMatDefinition, "src", "clib.array.myPkg.Int", "input", "len");
В методе getMat, задайте RetVal выведите, заменив <SHAPE> с "len".
defineOutput(getMatDefinition, "RetVal", "int32", "len");
В методе copyMat, задайте dest аргумент, заменяя <SHAPE> с "len".
defineArgument(copyMatDefinition, "dest", "clib.array.myPkg.Int", "output", "len");
В функциональном addMat, задайте mat аргумент в функциональном addMat заменяя <SHAPE> с 1.
defineArgument(addMatDefinition, "mat", "clib.myPkg.Mat", "input", 1);
В функциональном updateMatBySize, задайте arr аргумент, заменяя <SHAPE> с "len".
defineArgument(updateMatBySizeDefinition, "arr", "clib.array.myPkg.Int", "input", "len");
Сохраните и закройте файл определения.
Создайте файл интерфейса MATLAB myPkgInterface.dll.
build(definemyPkg)
Building interface file 'myPkgInterface.dll'. Interface file 'myPkgInterface.dll' built in folder 'H:\Documents\MATLAB\publisher\matrixexample\myPkg'. To use the library, add the interface file folder to the MATLAB path.
Обязательно щелкните по ссылке в сообщении, чтобы добавить интерфейсный файл в путь.
Чтобы протестировать интерфейс, смотрите Вызов функций в Интерфейсе Linux на C++ Разделяемая Библиотека.
clibgen.generateLibraryDefinition