Документация

Пошаговая процедура

1. Если вы еще не сделали этого, скопируйте файлы для этого примера следующим образом:

   1. Скопируйте следующую папку, которая поставляется с продуктом MATLAB, в вашу рабочую папку:

      matlabroot\toolbox\dotnetbuilder\Examples\VSVersion\NET\VarArgExample
      

   2. В командной строке MATLAB, cd на новый VarArgExample подпапка в рабочей папке.

2. Напишите функции MATLAB, так же как и любую функцию MATLAB.

   Код для функций в этом примере следующий:

    drawgraph.m

   function [xyCoords] = DrawGraph(colorSpec, varargin)
   ...
       numVarArgIn= length(varargin);
       xyCoords= zeros(numVarArgIn, 2);
   
       for idx = 1:numVarArgIn
           xCoord = varargin{idx}(1);
           yCoord = varargin{idx}(2);
           
           x(idx) = xCoord;
           y(idx) = yCoord;
           
           xyCoords(idx,1) = xCoord;
           xyCoords(idx,2) = yCoord;
       end
       
       xmin = min(0, min(x));
       ymin = min(0, min(y));
   
       axis([xmin fix(max(x))+3 ymin fix(max(y))+3])
       
       plot(x, y, 'color', colorSpec);
   
    
   

    extractcoords.m

   function [varargout] = ExtractCoords(coords)
   
       for idx = 1:nargout
           varargout{idx}= coords(idx,:);
       end
   

   Этот код уже находится в вашей рабочей папке в \VarArgExample\VarArgComp\.

3. Из галереи Apps MATLAB откройте приложение Library Compiler.

4. Создайте .NET компонент. Для получения дополнительной информации см. инструкции в разделе «Создание сборки .NET и создание приложения .NET». Используйте следующую информацию:

   Имя проекта	VarArgComp
   Имя класса	Plotter
   Файл для компиляции	extractcoords.m   drawgraph.m

5. Запись исходного кода для приложения, которое обращается к компоненту.

   Пример применения для этого примера приведен в VarArgExample\VarArgCSApp\VarArgApp.cs.

   Список программ показан здесь.

    VarArgApp.cs

   using System;
   
   using MathWorks.MATLAB.NET.Utility;
   using MathWorks.MATLAB.NET.Arrays;
   
   using VarArgComp;
   
   
   namespace MathWorks.Examples.VarArgApp
    {
     /// <summary>
     /// This application demonstrates how to call components 
     ///  having methods with varargin/vargout arguments.
     /// </summary>
     class VarArgApp
       {
         #region MAIN
   
         /// <summary>
         /// The main entry point for the application.
         /// </summary>
         [STAThread]
         static void Main(string[] args)
           {
             // Initialize the input data
             MWNumericArray colorSpec= new double[]
                                           {0.9, 0.0, 0.0};
             MWNumericArray data= 
                     new MWNumericArray(new int[,]{{1,2},{2,4},
                                          {3,6},{4,8},{5,10}});  
             MWArray[] coords= null;
   
             try
               {
                 // Create a new plotter object
                 Plotter plotter= new Plotter();
   
                 //Extract a variable number of two element x and y coordinate 
                 //  vectors from the data array
                 coords= plotter.extractcoords(5, data);
   
                 // Draw a graph using the specified color to connect the 
                 //   variable number of input coordinates.
                 // Return a two column data array containing the input coordinates.
                 data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                   coords[0], coords[1], coords[2],coords[3], coords[4]);
   
                 Console.WriteLine("result=\n{0}", data);
   
                 Console.ReadLine();  // Wait for user to exit application
   
                 // Note: You can also pass in the coordinate array directly.
                 data= (MWNumericArray)plotter.drawgraph(colorSpec, coords);
   
                 Console.WriteLine("result=\n{0}", data); 
    
                 Console.ReadLine();  // Wait for user to exit application
               }
   
             catch(Exception exception)
               {
                 Console.WriteLine("Error: {0}", exception);
               }
           }
   
         #endregion
       }
     }
   

   Программа делает следующее:

   • Инициализирует три массива (colorSpec, data, и coords) использование MWArray библиотека классов

   • Создает Plotter объект

   • Вызывает extracoords и drawgraph методы

   • Использует MWNumericArray для представления данных, необходимых для методов

   • Использует try-catch блок для поимки и обработки любых исключений

   Следующие операторы являются альтернативными способами вызова drawgraph метод:

   data= (MWNumericArray)plotter.drawgraph(colorSpec, 
                   coords[0], coords[1], coords[2],coords[3], coords[4]);
   ...
   data= (MWNumericArray)plotter.drawgraph((MWArray)colorSpec, coords);
   

6. Создайте VarArgApp приложение с использованием Visual Studio .NET.

   1. The VarArgCSApp папка содержит файл проекта Visual Studio .NET для этого примера. Откройте проект в Visual Studio .NET двойным кликом мыши VarArgCSApp.csproj в Windows^® Исследователь. Вы также можете открыть его с рабочего стола, щелкнув правой кнопкой мыши VarArgCSApp.csproj > Open Outside MATLAB.

   2. Добавьте ссылку на MWArray компонент, который matlabroot\ toolbox\dotnetbuilder\bin\ architecture\framework_version\mwarray.dll.

   3. Добавьте или, при необходимости, исправьте местоположение ссылки на VarArgComp компонент, созданный на предыдущем шаге. (Компонент, VarArgComp.dll, находится в \VarArgExample\VarArgComp\x86\v4.0\debug\distrib подпапка рабочей области.)

7. Создайте и запустите приложение в Visual Studio .NET.