簡介
ATFX API 由兩個 DLL 文件組成，可以與自定義軟件集成以直接讀取和提取 ATFX 文件中的數據。這篇文章將展示打開和讀取 ATFX 文件的簡單 C# 代碼示例。
有關如何在類中實現以下代碼段和屬性的更多詳細信息，請參閱 ATFX API 手冊和提供的 C# 演示代碼。該軟件包可以從我們的 Programming Corner下載。
導入 C# DLL 文件
要導入 C# DLL 文件，必須在項目中引用 2 個 DLL 文件，并且以下命名空間用于引用 ATFX API 中的各種類和屬性。
using?EDM.RecordingInterface;
using?EDM.Recording;
using?ASAM.ODS.NVH;
using?Common;
using?Common.Spider;
using?EDM.Utils;
using?ASAM.ODS.ATFXML;
打開 ATFX 文件
要打開 ATFX 文件，請使用 RecordingManager 類調用 OpenRecording，它接受文件名并輸出包含錄制屬性和信號列表的 IRecording 對象。
using?EDM.RecordingInterface;
using?EDM.Recording;
var?recordingPath = "C:\Sig001.atfx";
// Open the ATFX file and get a IRecording object
RecordingManager.Manager.OpenRecording(recordingPath,?out?IRecording rec);
提取Recording 屬性
使用從 ATFX 文件提取中創建的 IRecording，可以通過調用 IRecording.RecordingProperty 來訪問Recording 屬性。
RecordingManager.Manager.OpenRecording(recordingPath,?out?IRecording rec);
RecordingProperty recordingProperties = rec.RecordingProperty;
// A couple of properties in IRecording.RecordingProperty
DateTime createTime = recordingProperties.CreateTime;
string instrument = recordingProperties.Instruments;
MeasurementConfigType measurementType = recordingProperties.MeasurementType;
string name = recordingProperties.RecordingName;
以下屏幕截圖顯示了顯示的Recording 屬性的示例：
提取信號數據
IRecording 還可用于訪問信號列表，這是一種 ISignal 類型，包含其自己的屬性和數據值，通過返回 List<ISignal> 的 IRecording.Signals。
RecordingManager.Manager.OpenRecording(recordingPath,?out?IRecording rec);
// Get the list of signals from the recording
List<ISignal> signals = rec.Signals;
// To get the Channel 4 signal, select the signal whose name is ‘Block(CH4)’
ISignal signalCh4 = signals.Where(sig => sig.Name ==?'Block(CH4)').First();
// Get the frame, which is formatted like [[x1, x2, x3…], [y1, y2, y3…],…]
double[][] frame = signalCh4.GetFrame(0);
double[] xValues = frame[0];
double[] yValues = frame[1];
// If applicable
double[] zValues = frame[2];
// Size of the frame
int?size = signalCh4.FrameSize;
以下屏幕截圖顯示了顯示的信號屬性和幀數據的示例：
