(FPM2) 特徴点応用マッチング結果

Namespace: FVIL.FPM2
Assembly: FVILbasic (in FVILbasic.dll) Version: 3.1.0.0 (3.1.0.17)

Syntax

C#
[SerializableAttribute]
public class CFviFPM2Result : CFviDataObject, 
	IEnumerable<F_SEARCH_RESULT>, IXmlSerializable
Visual Basic
<SerializableAttribute>
Public Class CFviFPM2Result
	Inherits CFviDataObject
	Implements IEnumerable(Of F_SEARCH_RESULT), IXmlSerializable

Remarks

特徴点応用マッチング結果を格納するクラスです。

このクラスは、アンマネージ環境のヒープに F_SEARCH_RESULT 構造体の配列を確保します。
確保した領域のアドレスは、Address に保管され、 Clear()()()() が呼ばれた時や このインスタンスが解放される時に自動的に解放されます。

このクラスは、.NET 環境とネイティブ環境の間で大量の画像処理データの受け渡しを行うことを目的としています。
通常、.NET 環境の固定長配列をネイティブ環境に受け渡す場合は マーシャリングが必要になり、 データのコピーが少なくとも１回は発生します。 ネイティブ環境の処理結果を .NET 環境に反映する場合(In,Out 属性の引数の場合)は、計２回発生します。 このクラスを使用するとマーシャリングの必要が無い為、データコピーのコスト削減が行えます。


領域の確保と解放について:

領域の確保と解放は FIE ライブラリを使用しています。 外部で確保した領域を設定することもできますが、 アロケータを一致させる必要がありますのでご注意ください。(下表参照) 自動的に解放したくない場合は、 IsAttach を true に設定することで回避できます。

操作メソッドFIE 関数
確保Resize(Int32)fnOAL_calloc(SIZE_T, SIZE_T)
解放Clear()()()()fnOAL_free(IntPtr)

その他の操作:
操作メソッド概要
領域設定SetBuffer(F_SEARCH_RESULT_PTR, Int32, Boolean)外部で確保した領域を設定する場合に使用します。
アタッチAttach(Object)同一型のインスタンスが保有する領域にアタッチします。
移動MoveFrom(Object)同一型のインスタンスが保有する領域をこのインスタンスに移動します。
複製CopyFrom(Object)同一型のインスタンスの内容を複製します。
初期値と範囲:
プロパティ初期値範囲説明
Item[([( Int32])]) (なし)F_SEARCH_RESULT配列の要素の取得または設定を行います。
AddressIntPtr.ZeroIntPtr.Zero または 有効なアドレス配列の先頭アドレスの取得を行います。
Count00,1~配列の要素数の取得を行います。
IsAttachfalsefalse/trueアタッチ状態の取得または設定を行います。
SizeOfItemsizeof(F_SEARCH_RESULT)sizeof(F_SEARCH_RESULT)配列要素１つ分のサイズ(byte)を取得します。
Size0SizeOfItem × Count配列全体のサイズ(byte)を取得します。

Inheritance Hierarchy

System..::..Object
FVIL..::..CFviObject
FVIL.Data..::..CFviDataObject
FVIL.FPM2..::..CFviFPM2Result

See Also