v25.5.6964

最初にお読みください。


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

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


概要


この書類は浜松ホトニクス社製 C15550-22UP でサポートされるパラメータを 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 (default)
DCAMPROP_SENSORMODE__PROGRESSIVE
DCAMPROP_SENSORMODE__PHOTONNUMBERRESOLVING
DCAM_IDPROP_READOUTSPEED
-
R
W
-
-
LONG
1 to 2 , step 1 , default 2 センサモードが AREA の場合のみ有効です。
1:ウルトラクワイエットスキャン
2:スタンダードスキャン
DCAM_IDPROP_READOUT_DIRECTION
-
R
W
-
-
MODE
DCAMPROP_READOUT_DIRECTION__FORWARD
DCAMPROP_READOUT_DIRECTION__BACKWARD @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAMPROP_READOUT_DIRECTION__FORWARDBIDIRECTION @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAMPROP_READOUT_DIRECTION__REVERSEBIDIRECTION @ DCAMPROP_SENSORMODE__PROGRESSIVE
Trigger
DCAM_IDPROP_TRIGGERSOURCE
-
R
W
W
W
MODE
DCAMPROP_TRIGGERSOURCE__INTERNAL (default)
DCAMPROP_TRIGGERSOURCE__EXTERNAL
DCAMPROP_TRIGGERSOURCE__SOFTWARE
DCAMPROP_TRIGGERSOURCE__MASTERPULSE
DCAM_IDPROP_TRIGGER_MODE
-
R
W
W
-
MODE
DCAMPROP_TRIGGER_MODE__NORMAL (default)
DCAMPROP_TRIGGER_MODE__START
DCAM_IDPROP_TRIGGERACTIVE
-
R
W
W
-
MODE
DCAMPROP_TRIGGERACTIVE__EDGE (default)
DCAMPROP_TRIGGERACTIVE__LEVEL @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
DCAMPROP_TRIGGERACTIVE__SYNCREADOUT @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
DCAM_IDPROP_TRIGGER_GLOBALEXPOSURE
-
R
W
-
-
MODE
DCAMPROP_TRIGGER_GLOBALEXPOSURE__DELAYED (default)
DCAMPROP_TRIGGER_GLOBALEXPOSURE__GLOBALRESET
DCAM_IDPROP_TRIGGERPOLARITY
-
R
W
W
W
MODE
DCAMPROP_TRIGGERPOLARITY__NEGATIVE (default)
DCAMPROP_TRIGGERPOLARITY__POSITIVE
DCAM_IDPROP_TRIGGER_CONNECTOR
-
R
-
-
-
MODE
DCAMPROP_TRIGGER_CONNECTOR__BNC
DCAM_IDPROP_TRIGGERTIMES
-
R
W
W
W
LONG
1 to 10000 , step 1 , default 1
DCAM_IDPROP_TRIGGERDELAY
-
R
W
W
W
REAL (Second)
0 to 10.0 , step 0.000001 , default 0 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
0 to 0.0331416 , step 0.0000072 , default 0 @ DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、OUTPUTTRIGGER_PREHSYNCCOUNT の設定により、設定値や設定範囲が変化します。
Sensor cooler
DCAM_IDPROP_SENSORTEMPERATURE
-
R
-
-
-
REAL (degrees Celsius)
-50 to 100
DCAM_IDPROP_SENSORCOOLER (水冷モードの場合のみ表示されます)
-
R
W
W
W
MODE
DCAMPROP_SENSORCOOLER__OFF
DCAMPROP_SENSORCOOLER__ON
DCAMPROP_SENSORCOOLER__MAX
DCAM_IDPROP_SENSORCOOLERSTATUS
-
R
-
-
-
MODE
DCAMPROP_SENSORCOOLERSTATUS__OFF
DCAMPROP_SENSORCOOLERSTATUS__READY
DCAMPROP_SENSORCOOLERSTATUS__BUSY
Binning and ROI
DCAM_IDPROP_BINNING
-
R
W
-
-
MODE
DCAMPROP_BINNING__1 (default)
DCAMPROP_BINNING__2 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
DCAMPROP_BINNING__4 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
DCAM_IDPROP_SUBARRAYHPOS
-
R
W
-
-
LONG
0 to 4092 , step 4 , default 0 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
0 to 4095 , step 1 , default 0 @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAM_IDPROP_SUBARRAYHSIZE
-
R
W
-
-
LONG
4 to 4096 , step 4 , default 4096 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
1 to 4096 , step 1 , default 4096 @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAM_IDPROP_SUBARRAYVPOS
-
R
W
-
-
LONG
0 to 2300 , step 4 , default 0
DCAM_IDPROP_SUBARRAYVSIZE
-
R
W
-
-
LONG
4 to 2304 , step 4 , default 2304
DCAM_IDPROP_SUBARRAYMODE
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
Feature
DCAM_IDPROP_EXPOSURETIME
-
R
W
W
W
REAL (Second)
0.000033949 to 1800.000015185 , step 0.00000001 , default 0.0082944 @ DCAMPROP_SENSORMODE__AREA and DCAM_IDPROP_READOUTSPEED=1 or DCAMPROP_SENSORMODE__PHOTONNUMBERRESOLVING
SUBARRAY プロパティの設定により、設定値や設定範囲が変化します。
0.0000072 to 1800.0 , step 0.00000001 , default 0.0082944 @ DCAMPROP_SENSORMODE__AREA and DCAM_IDPROP_READOUTSPEED=2
SUBARRAY プロパティの設定により、設定値や設定範囲が変化します。
0.0000072 to 0.0082944 , step 0.00000001 , default 0.0082944 @ DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、SUBARRAY プロパティの設定により、設定値や設定範囲が変化します。
ALU
DCAM_IDPROP_DEFECTCORRECT_MODE
-
R
W
W
W
MODE
DCAMPROP_DEFECTCORRECT_MODE__OFF
DCAMPROP_DEFECTCORRECT_MODE__ON (default) @ DCAMPROP_SENSORMODE__AREA or __PROGRESSIVE
DCAM_IDPROP_HOTPIXELCORRECT_LEVEL
-
R
W
W
W
MODE
DCAMPROP_HOTPIXELCORRECT_LEVEL__STANDARD (default)
DCAMPROP_HOTPIXELCORRECT_LEVEL__MINIMUM
DCAMPROP_HOTPIXELCORRECT_LEVEL__AGGRESSIVE
DCAM_IDPROP_CAPTUREMODE
-
R
-
-
-
MODE
DCAMPROP_CAPTUREMODE__NORMAL
DCAM_IDPROP_INTENSITYLUT_MODE
-
R
W
W
-
MODE
DCAMPROP_INTENSITYLUT_MODE__THROUGH (default)
DCAMPROP_INTENSITYLUT_MODE__PAGE @ DCAMPROP_SENSORMODE__AREA or __PROGRESSIVE
DCAM_IDPROP_INTENSITYLUT_PAGE
-
R
-
-
-
MODE
1
Output Trigger
DCAM_IDPROP_NUMBEROF_OUTPUTTRIGGERCONNECTOR
-
R
-
-
-
LONG
return 3
DCAM_IDPROP_OUTPUTTRIGGER_SOURCE
-
R
W
W
W
MODE
DCAMPROP_OUTPUTTRIGGER_SOURCE__READOUTEND (default)
DCAMPROP_OUTPUTTRIGGER_SOURCE__VSYNC
DCAMPROP_OUTPUTTRIGGER_SOURCE__HSYNC @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAMPROP_OUTPUTTRIGGER_SOURCE__TRIGGER
DCAM_IDPROP_OUTPUTTRIGGER_POLARITY
-
R
W
W
W
MODE
DCAMPROP_OUTPUTTRIGGER_POLARITY__NEGATIVE (default)
DCAMPROP_OUTPUTTRIGGER_POLARITY__POSITIVE
DCAM_IDPROP_OUTPUTTRIGGER_ACTIVE
-
R
-
-
-
MODE
DCAMPROP_OUTPUTTRIGGER_ACTIVE__EDGE
DCAM_IDPROP_OUTPUTTRIGGER_DELAY
-
R
W
W
W
REAL (Second)
0 to 10.0 , step 0.000001 , default 0
DCAM_IDPROP_OUTPUTTRIGGER_PERIOD
-
R
W
W
W
REAL (Second)
0.000001 to 10.0 , step 0.000001 , default 0.001
DCAM_IDPROP_OUTPUTTRIGGER_KIND
-
R
W
W
W
MODE
DCAMPROP_OUTPUTTRIGGER_KIND__LOW (default)
DCAMPROP_OUTPUTTRIGGER_KIND__EXPOSURE
DCAMPROP_OUTPUTTRIGGER_KIND__PROGRAMABLE
DCAMPROP_OUTPUTTRIGGER_KIND__TRIGGERREADY
DCAMPROP_OUTPUTTRIGGER_KIND__HIGH
DCAMPROP_OUTPUTTRIGGER_KIND__ANYROWEXPOSURE
DCAM_IDPROP_OUTPUTTRIGGER_PREHSYNCCOUNT
-
R
W
W
W
LONG
0 to 4607 , step 1 , default 0
Master Pulse
DCAM_IDPROP_MASTERPULSE_MODE
-
R
W
W
W
MODE
DCAMPROP_MASTERPULSE_MODE__CONTINUOUS (default)
DCAMPROP_MASTERPULSE_MODE__START
DCAMPROP_MASTERPULSE_MODE__BURST
DCAM_IDPROP_MASTERPULSE_TRIGGERSOURCE
-
R
W
W
W
MODE
DCAMPROP_MASTERPULSE_TRIGGERSOURCE__EXTERNAL (default)
DCAMPROP_MASTERPULSE_TRIGGERSOURCE__SOFTWARE
DCAM_IDPROP_MASTERPULSE_INTERVAL
-
R
W
W
W
REAL (Second)
0.000005 to 10.0 , step 0.000001 , default 0.1
DCAM_IDPROP_MASTERPULSE_BURSTTIMES
-
R
W
W
W
LONG
1 to 65535 , step 1 , default 1
Synchronous timing
DCAM_IDPROP_TIMING_READOUTTIME
-
R
-
-
-
REAL (Second)
フレームの読み出し時間を返します。
DCAM_IDPROP_TIMING_CYCLICTRIGGERPERIOD
-
R
-
-
-
REAL (Second)
サイクリックトリガの間隔を返します。
DCAM_IDPROP_TIMING_MINTRIGGERBLANKING
-
R
-
-
-
REAL (Second)
露光の終了からトリガレディまでの時間を返します。
DCAM_IDPROP_TIMING_MINTRIGGERINTERVAL
-
R
-
-
-
REAL (Second)
トリガ入力を受け付けてから、次のトリガを受け付けられるまでの時間を返します。
DCAM_IDPROP_TIMING_GLOBALEXPOSUREDELAY
-
R
-
-
-
REAL (Second)
グローバル露光が開始されるまでの時間を返します。
DCAM_IDPROP_TIMING_EXPOSURE
-
R
-
-
-
MODE
DCAMPROP_TIMING_EXPOSURE__ROLLING
DCAM_IDPROP_TIMING_INVALIDEXPOSUREPERIOD
-
R
-
-
-
REAL (Second)
トリガ入力から露光開始までに必要な時間を返します。
DCAM_IDPROP_INTERNALFRAMERATE
-
R
-
-
-
REAL (Hz)
内部同期モードにおいて、カメラが1秒間に出力するフレーム数を返します。 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
センサモードが AREA 又は PHOTONNUMBERRESOLVING の時は読み取り専用です。
20.088066082 to 60.099043223, step 0 @ CoaXPress connection and DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、サブアレイの設定により、設定値や設定範囲が変化します。
return 17.6996 @ USB 3.0 connection and DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、サブアレイの設定により、設定値や設定範囲が変化します。
DCAM_IDPROP_INTERNAL_FRAMEINTERVAL
-
R
-
-
-
REAL (Second)
内部同期モードにおいて、2つのフレーム間の時間を返します。 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
センサモードが AREA 又は PHOTONNUMBERRESOLVING の時は読み取り専用です。
0.016639200 to 0.049780800, step 0 @ CoaXPress connection and DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、サブアレイの設定により、設定値や設定範囲が変化します。
return 0.0564984 @ USB 3.0 connection and DCAMPROP_SENSORMODE__PROGRESSIVE
INTERNALLINESPEED や INTERNAL_LINEINTERVAL、サブアレイの設定により、設定値や設定範囲が変化します。
DCAM_IDPROP_INTERNALLINESPEED
-
R
W
W
W
REAL (m/s)
センサスピードを返します。 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
センサモードが AREA 又は PHOTONNUMBERRESOLVING の時は読み取り専用です。
0.019360269 to 0.638888889, step 0.000019576 @ DCAMPROP_SENSORMODE__PROGRESSIVE
DCAM_IDPROP_INTERNAL_LINEINTERVAL
-
R
W
W
W
REAL (Second)
2つのライン間の時間を返します。 @ DCAMPROP_SENSORMODE__AREA or __PHOTONNUMBERRESOLVING
センサモードが AREA 又は PHOTONNUMBERRESOLVING の時は読み取り専用です。
0.000007200 to 0.000237600, step 0.000000240 @ DCAMPROP_SENSORMODE__PROGRESSIVE
System Information
DCAM_IDPROP_COLORTYPE
-
R
-
-
-
MODE
DCAMPROP_COLORTYPE__BW
DCAM_IDPROP_BITSPERCHANNEL
-
R
W
-
-
LONG
12 to 16 , step 4 , default 16 @ DCAM_PIXELTYPE__MONO16, MONO12, MONO12P
8 to 8 , step 0 , default 8 @ DCAM_PIXELTYPE__MONO8
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
W
-
-
MODE
DCAM_PIXELTYPE_MONO8
DCAM_PIXELTYPE_MONO16 (default)
DCAM_PIXELTYPE_MONO12P @ CoaXPress connection
DCAM_PIXELTYPE_MONO12 @ USB 3.0 connection
DCAM_IDPROP_IMAGE_CAMERASTAMP
4.0
R
W
-
-
LONG
0 to 65535 , step 1 , default 0 @ USB 3.0 connection
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_MONO8
DCAM_PIXELTYPE_MONO16
DCAM_PIXELTYPE_MONO12P @ CoaXPress connection
DCAM_PIXELTYPE_MONO12 @ USB 3.0 connection
DCAM_IDPROP_RECORDFIXEDBYTES_PERFILE
4.0
R
-
-
-
LONG
1ファイルあたり必要となるデータサイズを返します。
DCAM_IDPROP_RECORDFIXEDBYTES_PERSESSION
4.0
R
-
-
-
LONG
1セッションあたり必要となるデータサイズを返します。
DCAM_IDPROP_RECORDFIXEDBYTES_PERFRAME
4.0
R
-
-
-
LONG
1フレームあたり必要となるデータサイズを返します。
DCAM_IDPROP_FRAMEBUNDLE_MODE
-
R
-
-
-
MODE
DCAMPROP_MODE__OFF
DCAMPROP_MODE__ON SUBARRAY プロパティの設定により、設定値が変化します。
DCAM_IDPROP_FRAMEBUNDLE_NUMBER
-
R
-
-
-
LONG
2 to 73728 , step 1 , default 2 @ CoaXPress connection
SUBARRAY プロパティの設定により、設定値や設定範囲が変化します。
2 to 1024 , step 1 , default 2 @ USB 3.0 connection
SUBARRAY プロパティの設定により、設定値や設定範囲が変化します。
DCAM_IDPROP_FRAMEBUNDLE_ROWBYTES
-
R
-
-
-
LONG
現在のプロパティ設定における、横一行のバイト数を返します。
DCAM_IDPROP_FRAMEBUNDLE_FRAMESTEPBYTES
-
R
-
-
-
LONG
同一フレームバンドル内の、フレームから次フレームまでのバイト数を返します。
DCAM_IDPROP_SYSTEM_ALIVE
-
R
-
-
-
MODE
DCAMPROP_SYSTEM_ALIVE__OFFLINE
DCAMPROP_SYSTEM_ALIVE__ONLINE
DCAM_IDPROP_CONVERSIONFACTOR_COEFF
-
R
-
-
-
REAL
現在の変換係数の係数値を返します。
DCAM_IDPROP_CONVERSIONFACTOR_OFFSET
-
R
-
-
-
REAL
現在の変換係数のオフセット値を返します。
DCAM_IDPROP_IMAGEDETECTOR_PIXELWIDTH
4.0
R
-
-
-
REAL (um)
return 4.600000
DCAM_IDPROP_IMAGEDETECTOR_PIXELHEIGHT
4.0
R
-
-
-
REAL (um)
return 4.600000
DCAM_IDPROP_IMAGEDETECTOR_PIXELNUMHORZ
4.0
R
-
-
-
LONG
return 4096
DCAM_IDPROP_IMAGEDETECTOR_PIXELNUMVERT
4.0
R
-
-
-
LONG
return 2304
DCAM_IDPROP_TIMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_TIMESTAMP_PRODUCER__IMAGINGDEVICE
DCAM_IDPROP_FRAMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_FRAMESTAMP_PRODUCER__IMAGINGDEVICE

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