LEADTOOLS Medical(Leadtools.Dicomアセンブリ)

フレームを表示

InsertImageメソッド








データの項目は、設定しました。
挿入するimage。
imageを挿入する位置を示す0から始まるインデックス。
使う圧縮の型。
光度測定の定数。
結果として生じるimageビット数を表す値。設定可能な値は、以下の通りです。
意味
0 オリジナルファイルのビット数(変換しません)を保持します。
8への1 結果として生じるimageで指定されたピクセル当たりビットを使います。
12 結果として生じるimageで12ビット/ピクセルを使います。
16 結果として生じるimageで16ビット/ピクセルを使います。
24 結果として生じるimageで24ビット/ピクセルを使います。
32 結果として生じるimageで32ビット/ピクセルを使います。
Qファクター(Q)は、圧縮プロセスに損失の程度を決定する数です。2~255の値を設定できます。このとき2は最高品質で255は最大圧縮です。
このメソッドの動作を制御するFlags。
ピクセルデータ要素でimageを挿入します。
構文
'Declaration
 
Public Sub InsertImage( _
   ByVal element As DicomElement, _
   ByVal image As RasterImage, _
   ByVal index As Integer, _
   ByVal compression As DicomImageCompressionType, _
   ByVal photometric As DicomImagePhotometricInterpretationType, _
   ByVal bitsPerPixel As Integer, _
   ByVal qualityFactor As Integer, _
   ByVal flags As DicomSetImageFlags _
) 
'Usage
 
Dim instance As DicomDataSet
Dim element As DicomElement
Dim image As RasterImage
Dim index As Integer
Dim compression As DicomImageCompressionType
Dim photometric As DicomImagePhotometricInterpretationType
Dim bitsPerPixel As Integer
Dim qualityFactor As Integer
Dim flags As DicomSetImageFlags
 
instance.InsertImage(element, image, index, compression, photometric, bitsPerPixel, qualityFactor, flags)
public void insertImage(DicomElement element, RasterImage image, int index, DicomImageCompressionType compression, DicomImagePhotometricInterpretationType photometric, int bitsPerPixel, int qualityFactor, int dicomSetImageFlags)
 function Leadtools.Dicom.DicomDataSet.InsertImage( 
   element ,
   image ,
   index ,
   compression ,
   photometric ,
   bitsPerPixel ,
   qualityFactor ,
   flags 
)

パラメーター

要素
データの項目は、設定しました。
image
挿入するimage。
インデックス
imageを挿入する位置を示す0から始まるインデックス。
圧縮
使う圧縮の型。
光度測定の
光度測定の定数。
bitsPerPixel
結果として生じるimageビット数を表す値。設定可能な値は、以下の通りです。
意味
0 オリジナルファイルのビット数(変換しません)を保持します。
8への1 結果として生じるimageで指定されたピクセル当たりビットを使います。
12 結果として生じるimageで12ビット/ピクセルを使います。
16 結果として生じるimageで16ビット/ピクセルを使います。
24 結果として生じるimageで24ビット/ピクセルを使います。
32 結果として生じるimageで32ビット/ピクセルを使います。
qualityFactor
Qファクター(Q)は、圧縮プロセスに損失の程度を決定する数です。2~255の値を設定できます。このとき2は最高品質で255は最大圧縮です。
フラグ
このメソッドの動作を制御するFlags。
解説
大部分のDICOMファイルは、型DicomTag.PixelDataの1つのデータ要素を備えているだけです。したがって、ほとんどの場合、メソッドがファイルで唯一のピクセルデータ要素にimageを自動的に挿入するため、要素をnullに設定することができます。要素がnullでないならば、それはピクセルデータ要素自体をポイントしなければなりません。

DICOMファイルがDicomClassType.BasicDirectoryであるならば、ファイルは1ピクセル以上のデータ要素を格納するかもしれません。この場合、imageを挿入するピクセルデータ要素を要素で指定しなければなりません。

可能性がある圧縮(光度測定の)BitsPerPixelとQファクターの組合せの表のために、圧縮方式の一覧表を参照します。

JPEG 2000圧縮を使うとき、より多くのオプションのために、Jpeg2000Optionsを参照します。

このメソッドは、以下の要素の一つ以上を挿入もするか、削除もするか、更新もします:

タグ 名前
(7FE0,0010) 画素データ。
(0002,0010) 構文UIDを転送します。
(0028,0101) ビットは保存しました。
(0028,0100) 割り当てビット。
(0028,0102) 高位ビット。
(0028,0103) ピクセル表現。
(0028,0010) 行。
(0028,0011) 列数。
(0028,0002) ピクセルにつきサンプル。
(0028,0006) 平面構成。
(0028,0004) 光度測定解釈。
(0028,0106) 最も少ないimageピクセル値。
(0028,0107) 最大のimageピクセル値。
(0028,1101) Redパレットカラールックアップテーブル記述子。
(0028,1102) 緑パレットカラールックアップテーブル記述子。
(0028,1103) 青パレットカラールックアップテーブル記述子。
(0028,1201) Redパレットカラールックアップテーブルデータ。
(0028,1202) 緑パレットカラールックアップテーブルデータ。
(0028,1203) 青パレットカラールックアップテーブルデータ。
(0028,1199) パレットカラールックアップテーブルUID。
(0028,1052) Interceptを規模を改めます。
(0028,1053) Slopeを規模を改めます。
(0028,1054) 規模を改めます型。
(0028,1221) 分かれたRedパレットカラールックアップテーブルデータ。
(0028,1222) 分かれた緑パレットカラールックアップテーブルデータ。
(0028,1223) 分かれた青パレットカラールックアップテーブルデータ。
(0028,3010) VOI LUTシーケンス。
(0028,1050) ウィンドウ中心。
(0028,1051) チャネル幅。
(0028,1055) ウィンドウ中心&幅説明。
(0028,0008) フレームの数
(0054,0070) タイムスロットVector。
(5200,9229) 共有機能グループシーケンス。
(5200,9230) フレームにつき機能グループシーケンス。
共有機能グループシーケンス要素またはフレームにつき機能グループシーケンス要素が追加されるならば、(0028,9132)フレームVOI LUTシーケンス要素か(0028,9145)ピクセル値変換シーケンス要素を格納する項目子要素は追加されるかもしれません。

(0028,9132)フレームVOI LUTシーケンス子要素
タグ 名前
(0028,1050) ウィンドウ中心
(0028,1051) チャネル幅
(0028,1055) ウィンドウ中心&幅説明

(0028,9145)ピクセル値変換シーケンス子要素
タグ 名前
(0028,1052) Interceptを規模を改めます
(0028,1053) Slopeを規模を改めます
(0028,1054) 規模を改めます型。

このメソッドは、いろいろなDICOM IODクラスによって押しつけられる画素データ規制に無関心です;たとえば、このメソッドは、「デジタルX線像記憶装置」データセットにカラー画像を挿入するのにユーザーを見込みます。

このメソッドは、常に「フレームの数」(0028、0008)要素を挿入して、その値を設定します。

マルチフレーム機能グループモジュールは、共有機能グループシーケンス項目やフレームにつき機能グループシーケンスアイテムを備えているかもしれません。これらの項目のどちらでも、ピクセル値変換シーケンス(0028,9145)項目またはフレームVOI LUTシーケンス(0028,9132)項目を持っているかもしれません。5種類のDICOM_SETIMAGE_MFGフラグを使用して、ピクセル値変換シーケンスまたはフレームVOI LUTシーケンスの情報を追加するか、既存の情報を変更できます。

対応するシーケンス(フレームVOI LUTシーケンスまたはピクセル値変換シーケンス)がすでに存在しない場合だけ、以下のフラグが使われます。


この場合、シーケンスは、フラグ(フレームにつき機能グループシーケンスまたは共有機能グループシーケンス)によって示される順序に置かれます。
フレームVOI LUTシーケンスまたはピクセル値変換シーケンスがDICOMデータセットの中にすでに存在するならば、4つの上記のフラグは無視されます、そして、シーケンスはシーケンスがすでに存在する場所に置かれます。

マルチフレーム機能グループの上の詳細な論議のために、マルチフレーム機能グループを参照します。

それを再圧縮することなく、データセットにimageを挿入するために、Leadtools.Dicom.Common.HighLevelServices.HighLevelDicomExtension.InsertImageNoRecompressionを呼び出します。それを再圧縮することなく、データセットにビデオを挿入するために、Leadtools.Dicom.Common.HighLevelServices.InsertVideoNoRecompressionを呼び出します。

注意:
DicomSetImageFlags.MfgVoiLutPerFrameは、DicomSetImageFlags.MfgVoiLutSharedと結合されることができません。
DicomSetImageFlags.MfgModalityLutPerFrameは、DicomSetImageFlags.MfgModalityLutSharedと結合されることができません。
高レベルな機能性が、DICOMデータセットにMPEG2を埋め込むためにありません。マルチメディアのツールキット(DICOMライタ)は、MPEG2圧縮でDICOMファイルを作成することができます。
このメソッドは主な医学的なSDKの一部でないDICOM転送構文(例えば圧縮がサポートするビデオ)をエンコードするのに用いられることができません、そして、それはLEADTOOLS Medicalマルチメディアモジュールだけによってサポートされます。
サンプル
サンプルのために、参照しますGetImage
必要条件

ターゲットプラットホーム

参照

参照

DicomDataSetクラス
DicomDataSetメンバ
GetImage(DicomElement、Int32、Int32、RasterByteOrder、DicomGetImageFlags)メソッド
GetImages(DicomElement、Int32、Int32、Int32、RasterByteOrder、DicomGetImageFlags)メソッド
InsertImagesメソッド
SetImageメソッド
SetImagesメソッド

Leadtools.Dicomは、Medicalツールキットサーバのライセンスと、解除キーが必要です。詳細は、以下を参照してください。Imaging Pro/Document/Medicalの機能