v25.5.6964

最初にお読みください


この書類およびサンプルコードは浜松ホトニクス株式会社(以下HPK)の内部文書であり、DCAM-APIを使ってホストソフトウエアソフトウエアを作成するユーザーの要求で開示されます。 上記目的に従い、所有者はこの書類およびサンプルコードに対してライセンス/転送などの権利を有しません。 この書類に基づいて開発されたソフトウエアを使って発生するいかなる損害もユーザーの責任となります。 この書類には技術的または記述上の誤りが含まれる可能性がありますが、HPKはそれらに伴う損害を補償しません。 HPKはこの書類に含まれる情報が更新された場合に通知は行いません。 ブランド名ならびに製品名は商標または登録商標です。 HPKの許可無く、本書類の一部または全部の複製/翻訳/意訳を認めません。

このチャプターの先頭へ戻る


概要


この書類は浜松ホトニクス社製 C10650-461 でサポートされるパラメータを Property でどのように操作するかを説明します。 この書類は DCAM-API ならびに SDK について基本的な知識がある事を前提に書かれています。 DCAM-API ならびに SDK の概念や、関数についての使い方は別書類を参照ください。

このチャプターの先頭へ戻る


表の見方


プロパティリストの項目に記載されているPropertyの値については、以下のルールに従って記述されています。
1.Classfication
2.PropertyID
3.
4.
5.
6.
7.
8.ValueType
9.PropertyValue 10.Information
データ記述テーブル
番号 項目 説明
1 Classification プロパティの大分類が記述されます。
2 Property ID カメラがサポートしているプロパティIDが記述されます。
3 Property Ver このプロパティのDCAM-APIバージョンが記述されます。
4 Readable Flag このプロパティから値を読み出すことが可能かどうかが記述されます。"R"の場合は読み出し可能、"-"の場合は読み出し不可能です。
5 Writable Flag(Stable) このプロパティがStableステータス中に、値を書き込むことが可能かどうかが記述されます。"W"の場合は書き込み可能、"-"の場合は書き込み不可能です。
6 Writable Flag(Ready) このプロパティがReadyステータス中に、値を書き込むことが可能かどうかが記述されます。"W"の場合は書き込み可能、"-"の場合は書き込み不可能です。
7 Writable Flag(Busy) このプロパティがBusyステータス中に、値を書き込むことが可能かどうかが記述されます。"W"の場合は書き込み可能、"-"の場合は書き込み不可能です。
8 Value Type このプロパティから返る値の型が記述されます。
9 Property Value このプロパティから返るID又は返り値の最小、最大、初期値、ステップが記述されます。
10 Information その他プロパティに関する補足情報が記述されます。

このチャプターの先頭へ戻る


プロパティ リスト


Sensor mode and speed
DCAM_IDPROP_SENSORMODE
-
R
W
-
-
MODE
DCAMPROP_SENSORMODE__AREA
DCAMPROP_SENSORMODE__TDI (default)
DCAM_IDPROP_SENSORMODE_LINEBUNDLEHEIGHT
-
R
W
-
-
LONG
327 to 5375 , step 1 , default 327
DCAM_IDPROP_OUTPUT_INTENSITY
-
R
W
-
-
MODE
DCAMPROP_OUTPUT_INTENSITY__NORMAL (default)
DCAMPROP_OUTPUT_INTENSITY__TESTPATTERN
DCAM_IDPROP_TESTPATTERN_KIND
-
R
W
-
-
MODE
DCAMPROP_TESTPATTERN_KIND__FLAT (default)
DCAMPROP_TESTPATTERN_KIND__IFLAT
DCAMPROP_TESTPATTERN_KIND__HORZGRADATION
DCAMPROP_TESTPATTERN_KIND__IHORZGRADATION
DCAMPROP_TESTPATTERN_KIND__VERTGRADATION
DCAMPROP_TESTPATTERN_KIND__IVERTGRADATION
DCAMPROP_TESTPATTERN_KIND__LINE
DCAMPROP_TESTPATTERN_KIND__ILINE
DCAMPROP_TESTPATTERN_KIND__DIAGONAL
DCAMPROP_TESTPATTERN_KIND__IDIAGONAL
DCAM_IDPROP_TESTPATTERN_OPTION
-
R
W
-
-
LONG
0 to n , step 1 , default 0 @ DCAM_IDPROP_TESTPATTERN_KIND,
DCAMPROP_TESTPATTERN_KIND__FLAT(IFLAT), n = 255
DCAMPROP_TESTPATTERN_KIND__HORZGRADATION(IHORZGRADATION), n = 9
DCAMPROP_TESTPATTERN_KIND__VERTGRADATION(IVERTGRADATION), n = 9
DCAMPROP_TESTPATTERN_KIND__LINE(ILINE), n = 8
Trigger
DCAM_IDPROP_TRIGGERSOURCE
-
R
W
W
W
MODE
DCAMPROP_TRIGGERSOURCE__INTERNAL (default)
DCAMPROP_TRIGGERSOURCE__EXTERNAL @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_TRIGGER_MODE
-
R
-
-
-
MODE
DCAMPROP_TRIGGER_MODE__NORMAL
DCAM_IDPROP_TRIGGERACTIVE
-
R
W
W
W
MODE
DCAMPROP_TRIGGERACTIVE__EDGE (default)
DCAMPROP_TRIGGERACTIVE__SYNCREADOUT @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_TRIGGERPOLARITY
-
R
-
-
-
MODE
DCAMPROP_TRIGGERPOLARITY__NEGATIVE
DCAM_IDPROP_TRIGGERENABLE_ACTIVE
-
R
W
W
W
MODE
DCAMPROP_TRIGGERENABLE_ACTIVE__ALWAYS (default)
DCAMPROP_TRIGGERENABLE_ACTIVE__START @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_TRIGGERENABLE_POLARITY
-
R
-
-
-
MODE
DCAMPROP_TRIGGERENABLE_POLARITY__NEGATIVE
Binning and ROI
DCAM_IDPROP_BINNING
-
R
W
-
-
MODE
DCAMPROP_BINNING__1 (default)
DCAMPROP_BINNING__2 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_SUBARRAYHPOS
-
R
W
-
-
LONG
0 to 6144 , step 2 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_SUBARRAYHSIZE
-
R
W
-
-
LONG
2 to 4608 , step 2 , default 4608 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_SUBARRAYVPOS
-
R
W
-
-
LONG
0 to 127 , step 1 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_SUBARRAYVSIZE
-
R
W
-
-
LONG
1 to 128 , step 1 , default 128 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_SUBARRAYMODE
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_BINNING_INDEPENDENT
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_BINNING_HORZ
-
R
W
-
-
LONG
1 to 2 , step 1 , default 1 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_BINNING_VERT
-
R
W
-
-
LONG
1 to 2 , step 1 , default 1 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
Feature
DCAM_IDPROP_EXPOSURETIME
-
R
W
W
W
REAL (Second)
0.060672 to 2.064512 , step 0.000128 , default 0.060672 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__1
0.034432 to 1.03226 , step 0.000102 , default 0.034432 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__2
0.064 to 16.32 , step 0.064 , default 0.064 @ DCAM_IDPROP_SENSORMODE, DCAMPROP_SENSORMODE__AREA
ALU
DCAM_IDPROP_CAPTUREMODE
-
R
W
W
-
MODE
DCAMPROP_CAPTUREMODE__NORMAL (default)
DCAMPROP_CAPTUREMODE__DARKCALIB
DCAMPROP_CAPTUREMODE__SHADINGCALIB @ DCAM_IDPROP_SUBTRACT, DCAMPROP_MODE__ON
ダーク補正後に使用してください。
DCAMPROP_CAPTUREMODE__TAPGAINCALIB
DCAM_IDPROP_SUBTRACT
-
R
W
W
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_SUBTRACTIMAGEMEMORY
-
R
W
W
-
MODE
0 to 7 , step 1 , default 0
DCAM_IDPROP_STORESUBTRACTIMAGETOMEMORY
-
R
W
W
-
MODE
0 to 7 , step 1 , default 0
DCAM_IDPROP_SHADINGCORRECTION
-
R
W
W
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_SHADINGCALIBDATAMEMORY
-
R
W
W
-
MODE
0 to 7 , step 1 , default 0
DCAM_IDPROP_SHADINGCALIB_SAMPLES
-
R
W
W
-
LONG
1 to 1024 , step 1 , default 32
DCAM_IDPROP_STORESHADINGCALIBDATATOMEMORY
-
R
W
W
-
MODE
0 to 7 , step 1 , default 0
DCAM_IDPROP_SHADINGCALIB_METHOD
-
R
W
W
-
MODE
DCAMPROP_SHADINGCALIB_METHOD__AVERAGE (default)
DCAMPROP_SHADINGCALIB_METHOD__MAXIMUM
DCAMPROP_SHADINGCALIB_METHOD__USETARGET
DCAM_IDPROP_SHADINGCALIB_TARGET
-
R
W
W
-
LONG
16384 to 65535 , step 1 , default 16384
DCAM_IDPROP_SHADINGCALIB_STABLEMININTENSITY
-
R
W
W
-
LONG
4096 to 65535 , step 1 , default 8192
DCAM_IDPROP_DARKCALIB_STABLEMAXINTENSITY
-
R
W
W
-
LONG
512 to 65535 , step 1 , default 8191
DCAM_IDPROP_SHADINGCALIB_STABLESAMPLES
-
R
W
W
-
LONG
0 to 100 , step 1 , default 10
DCAM_IDPROP_SHADINGCALIB_STABLEMAXERRORPERCENT
-
R
W
W
-
LONG
0 to 200 , step 1 , default 50
DCAM_IDPROP_TAPGAINCALIB_METHOD
-
R
W
-
-
MODE
DCAMPROP_TAPGAINCALIB_METHOD__AVE (default)
DCAMPROP_TAPGAINCALIB_METHOD__MAX
DCAMPROP_TAPGAINCALIB_METHOD__MIN
DCAM_IDPROP_TAPCALIB_BASEDATAMEMORY
-
R
W
-
-
MODE
0 to 63 , step 1 , default 0
DCAM_IDPROP_STORETAPCALIBDATATOMEMORY
-
R
W
-
-
MODE
1 to 3 , step 1 , default 1
DCAM_IDPROP_TAPCALIBDATAMEMORY
-
R
W
-
-
MODE
0 to 3 , step 1 , default 0
DCAM_IDPROP_NUMBEROF_TAPCALIB
-
R
-
-
-
LONG
return 4
DCAM_IDPROP_TAPCALIB_GAIN
-
R
W
-
-
LONG
0 to 63 , step 1 , default 0
DCAM_IDPROP_OUTPUTDATA_OPERATION
-
R
W
-
-
MODE
DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAMPROP_OUTPUTDATA_OPERATION__ALIGNED (default)
Synchronous timing
DCAM_IDPROP_INTERNALFRAMERATE
-
R
-
-
-
REAL (Hz)
内部同期モードにおいて、カメラが1秒間に出力するフレーム数を返します。
DCAM_IDPROP_INTERNAL_FRAMEINTERVAL
-
R
-
-
-
REAL (Second)
内部同期モードにおいて、2つのフレーム間の時間を返します。
DCAM_IDPROP_INTERNALLINERATE
-
R
W
W
W
REAL (Hz)
62.0 to 2109.0 , step 0.001 , default 2109.0 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__1
62.0 to 1858.0 , step 0.001 , default 1858.0 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__2
DCAM_IDPROP_INTERNALLINESPEED
-
R
W
W
W
REAL (m/s)
0.002967 to 0.101217 , step 0.000017 , default 0.101217 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__1
0.005952 to 0.178368 , step 0.000017 , default 0.178368 @ DCAM_IDPROP_BINNING, DCAMPROP_BINNING__2
System Information
DCAM_IDPROP_COLORTYPE
-
R
-
-
-
MODE
DCAMPROP_COLORTYPE__BW
DCAM_IDPROP_BITSPERCHANNEL
-
R
-
-
-
LONG
return 16
DCAM_IDPROP_IMAGE_WIDTH
-
R
-
-
-
LONG
現在のプロパティ設定における、横方向の画素数を返します。
DCAM_IDPROP_IMAGE_HEIGHT
-
R
-
-
-
LONG
現在のプロパティ設定における、縦方向の画素数を返します。
DCAM_IDPROP_IMAGE_ROWBYTES
-
R
-
-
-
LONG
現在のプロパティ設定における、次の行にアクセスするための横一行のバイト数を返します。
DCAM_IDPROP_IMAGE_FRAMEBYTES
-
R
-
-
-
LONG
現在のプロパティ設定における、一枚の画像あたりのバイト数を返します。
DCAM_IDPROP_IMAGE_TOPOFFSETBYTES
-
R
-
-
-
LONG
画像の最初のデータを指定するためのオフセットバイト数を返します。
DCAM_IDPROP_IMAGE_PIXELTYPE
-
R
-
-
-
MODE
DCAM_PIXELTYPE_MONO16
DCAM_IDPROP_BUFFER_ROWBYTES
4.0
R
-
-
-
LONG
アタッチされたバッファの横一行のバイト数を返します。
DCAM_IDPROP_BUFFER_FRAMEBYTES
4.0
R
-
-
-
LONG
dcambuf_attach()関数を使用するときに確保するべきバッファのサイズを返します。
DCAM_IDPROP_BUFFER_TOPOFFSETBYTES
4.0
R
-
-
-
LONG
実際の画像データの先頭に存在する不必要なデータサイズを返します。
DCAM_IDPROP_BUFFER_PIXELTYPE
4.0
R
-
-
-
MODE
DCAM_PIXELTYPE_MONO16
DCAM_IDPROP_RECORDFIXEDBYTES_PERFILE
-
R
-
-
-
LONG
1ファイルあたり必要となるデータサイズを返します。
DCAM_IDPROP_RECORDFIXEDBYTES_PERSESSION
-
R
-
-
-
LONG
1セッションあたり必要となるデータサイズを返します。
DCAM_IDPROP_RECORDFIXEDBYTES_PERFRAME
-
R
-
-
-
LONG
1フレームあたり必要となるデータサイズを返します。
DCAM_IDPROP_SYSTEM_ALIVE
-
R
-
-
-
MODE
DCAMPROP_SYSTEM_ALIVE__OFFLINE
DCAMPROP_SYSTEM_ALIVE__ONLINE
DCAM_IDPROP_IMAGEDETECTOR_PIXELWIDTH
4.0
R
-
-
-
REAL (um)
return 48.0
DCAM_IDPROP_IMAGEDETECTOR_PIXELHEIGHT
4.0
R
-
-
-
REAL (um)
return 48.0
DCAM_IDPROP_TIMESTAMP_PRODUCER
-
R
-
-
-
MODE
DCAMPROP_TIMESTAMP_PRODUCER__DCAMMODULE
DCAM_IDPROP_FRAMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_FRAMESTAMP_PRODUCER__DCAMMODULE
DCAM_IDPROP_CAMERASTATUS_INTENSITY
-
R
-
-
-
MODE
DCAMPROP_CAMERASTATUS_INTENSITY__GOOD
DCAMPROP_CAMERASTATUS_INTENSITY__TOODARK
DCAMPROP_CAMERASTATUS_INTENSITY__TOOBRIGHT
DCAMPROP_CAMERASTATUS_INTENSITY__UNCARE
DCAM_IDPROP_CAMERASTATUS_INPUTTRIGGER
-
R
-
-
-
MODE
DCAMPROP_CAMERASTATUS_INPUTTRIGGER__GOOD
DCAMPROP_CAMERASTATUS_INPUTTRIGGER__NONE
DCAMPROP_CAMERASTATUS_INPUTTRIGGER__TOOFREQUENT
DCAM_IDPROP_CAMERASTATUS_CALIBRATION
-
R
-
-
-
MODE
DCAMPROP_CAMERASTATUS_CALIBRATION__DONE
DCAMPROP_CAMERASTATUS_CALIBRATION__NOTYET
DCAMPROP_CAMERASTATUS_CALIBRATION__NOTRIGGER
DCAMPROP_CAMERASTATUS_CALIBRATION__TOOFREQUENTTRIGGER
DCAMPROP_CAMERASTATUS_CALIBRATION__OUTOFADJUSTABLERANGE
DCAMPROP_CAMERASTATUS_CALIBRATION__UNSUITABLETABLE
DCAM_IDPROP_CALIBREGION_MODE
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_NUMBEROF_CALIBREGION
-
R
W
-
-
LONG
1 to 4 , step 1 , default 1
DCAM_IDPROP_CALIBREGION_HPOS
-
R
W
-
-
LONG
0 to 6142 , step 2 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_CALIBREGION_HSIZE
-
R
W
-
-
LONG
0 to 6144 , step 2 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_MASKREGION_MODE
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_NUMBEROF_MASKREGION
-
R
W
-
-
LONG
1 to 4 , step 1 , default 1
DCAM_IDPROP_MASKREGION_HPOS
-
R
W
-
-
LONG
0 to 6142 , step 2 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW
DCAM_IDPROP_MASKREGION_HSIZE
-
R
W
-
-
LONG
0 to 6144 , step 2 , default 0 @ DCAM_IDPROP_OUTPUTDATA_OPERATION, DCAMPROP_OUTPUTDATA_OPERATION__RAW

このチャプターの先頭へ戻る