v25.5.6964

Read before using


This document and the software sample codes are internal documents of Hamamatsu Photonics K.K.(it is described as the following HPK) and are disclosed upon request in order to enable the user to create a host software using DCAM-API. This document and the software sample codes are disclosed only for the purpose described above, and do not constitute a license, transfer, or any other entitlement for the owner. All of risk and result of using software depending on this document remains with the user. This document may include technical inaccuracies or typographical errors. HPK does not guarantee any damage arising from such errors or this document. HPK makes no commitment to update or keep current the information contained in this document. All brand and product names are trademarks or registered trademarks of their respective owners. HPK has copyright of this document with all rights reserved. No part of this documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form, or by any means, in any means, electronic, mechanical, magnetic, optical, chemical, manual or otherwise, without the prior written permission of HPK.

Go to top of this chapter


Overview


This document explains support parameter at C12300-321, C12300-321B and how to control them by DCAM Properties. This document requires knowledge of basic concept of DCAM-API and SDK. If you need description about them, please reffer other documents.

Go to top of this chapter


How to read the table


Property List is described according to the following rules.
1.Classfication
2.PropertyID
3.
4.
5.
6.
7.
8.ValueType
9.PropertyValue 10.Information
Description table
index item explanation
1 Classification Large classification of the Property.
2 Property ID Property ID that camera supported.
3 Property Ver DCAM-API version of this Property.
4 Readable Flag Whether it is possible to read the value from this Property. In the case of "-" is not readable. In the case of "R" is readable.
5 Writable Flag(Stable) Whether it is possible to change this Property value during status is "Stable". In the case of "-" is not writable. In the case of "W" is writable.
6 Writable Flag(Ready) Whether it is possible to change this Property value during status is "Ready". In the case of "-" is not writable. In the case of "W" is writable.
7 Writable Flag(Busy) Whether it is possible to change this Property value during status is "Busy". In the case of "-" is not writable. In the case of "W" is writable.
8 Value Type Property value types : MODE, LONG and REAL.
9 Property Value ID or minimum, maximum, default, step values from this Property.
10 Information Additional information about this Property.

Go to top of this chapter


Property List


Sensor mode and speed
DCAM_IDPROP_SENSORMODE
-
R
W
-
-
MODE
DCAMPROP_SENSORMODE__AREA
DCAMPROP_SENSORMODE__TDI (default)
DCAM_IDPROP_SENSORMODE_LINEBUNDLEHEIGHT
-
R
W
-
-
LONG
1 to 7167 , step 1 , default 150
DCAM_IDPROP_READOUT_DIRECTION
-
R
W
W
-
MODE
DCAMPROP_READOUT_DIRECTION__FORWARD (default)
DCAMPROP_READOUT_DIRECTION__BACKWARD
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
DCAMPROP_TESTPATTERN_KIND__IFLAT
DCAMPROP_TESTPATTERN_KIND__HORZGRADATION (default)
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 @ 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 It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_TRIGGER_MODE
-
R
-
-
-
MODE
DCAMPROP_TRIGGER_MODE__NORMAL
DCAM_IDPROP_TRIGGERACTIVE
-
R
-
-
-
MODE
DCAMPROP_TRIGGERACTIVE__SYNCREADOUT
DCAM_IDPROP_TRIGGERPOLARITY
-
R
-
-
-
MODE
DCAMPROP_TRIGGERPOLARITY__NEGATIVE
DCAM_IDPROP_TRIGGERENABLE_ACTIVE
-
R
W
W
-
MODE
DCAMPROP_TRIGGERENABLE_ACTIVE__ALWAYS (default)
DCAMPROP_TRIGGERENABLE_ACTIVE__START It cannot be used by DCAMPROP_SENSORMODE__AREA.
Sensor cooler
DCAM_IDPROP_SENSORTEMPERATURE_AVE
-
R
-
-
-
REAL (degrees Celsius)
-128 to 127
DCAM_IDPROP_SENSORTEMPERATURE_MIN
-
R
-
-
-
REAL (degrees Celsius)
-128 to 127
DCAM_IDPROP_SENSORTEMPERATURE_MAX
-
R
-
-
-
REAL (degrees Celsius)
-128 to 127
DCAM_IDPROP_SENSORTEMPERATURE_STATUS
-
R
-
-
-
MODE
DCAMPROP_SENSORTEMPERATURE_STATUS__NORMAL
DCAMPROP_SENSORTEMPERATURE_STATUS__WARNING
Binning and ROI
DCAM_IDPROP_BINNING
-
R
W
-
-
MODE
DCAMPROP_BINNING__1 (default)
DCAMPROP_BINNING__2 It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_SUBARRAYHPOS
-
R
W
-
-
LONG
0 to 4606 , step 2 , default 0
DCAM_IDPROP_SUBARRAYHSIZE
-
R
W
-
-
LONG
2 to 4608 , step 2 , default 4608
DCAM_IDPROP_SUBARRAYVPOS
-
R
W
-
-
LONG
0 to 7166 , step 1 , default 0
0 to 148 , step 2 , default 0 @ DCAMPROP_SENSORMODE__AREA
DCAM_IDPROP_SUBARRAYVSIZE
-
R
W
-
-
LONG
1 to 7167 , step 1 , default 150
2 to 150 , step 2 , default 150 @ DCAMPROP_SENSORMODE__AREA
DCAM_IDPROP_SUBARRAYMODE
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_BINNING_INDEPENDENT
-
R
W
-
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_BINNING_HORZ
-
R
W
-
-
LONG
1 to 2 , step 1 , default 1 It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_BINNING_VERT
-
R
W
-
-
LONG
1 to 2 , step 1 , default 1 It cannot be used by DCAMPROP_SENSORMODE__AREA.
Feature
DCAM_IDPROP_EXPOSURETIME
-
R
W
W
W
REAL (Second)
0.0075 to 0.75 , step 0.000000003 , default 0.0075 @ DCAMPROP_BINNING__1
0.005 to 0.375 , step 0.000000001 , default 0.005 @ DCAMPROP_BINNING__2
0.086 to 21.93 , step 0.086 , default 0.086 @ DCAMPROP_SENSORMODE__AREA
ALU
DCAM_IDPROP_CAPTUREMODE
-
R
W
W
-
MODE
DCAMPROP_CAPTUREMODE__NORMAL (default)
DCAMPROP_CAPTUREMODE__DARKCALIB It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAMPROP_CAPTUREMODE__SHADINGCALIB It can only be use after dark correction
DCAM_IDPROP_SUBTRACT
-
R
W
W
-
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON * After dark correction, the status will be automatically set to DCAMPROP_MODE__ON.
* To use the correction data within the camera, set the table number in DCAM_IDPROP_SUBTRACTIMAGEMEMORY and then set DCAMPROP_MODE__ON.
It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_SUBTRACTIMAGEMEMORY
-
R
W
W
-
MODE
0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15 It cannot be used by DCAMPROP_SENSORMODE__AREA.
DCAM_IDPROP_STORESUBTRACTIMAGETOMEMORY
-
R
W
W
-
MODE
0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15 It can only be use after dark correction
DCAM_IDPROP_SHADINGCORRECTION
-
R
W
W
-
MODE
DCAMPROP_MODE__OFF
DCAMPROP_MODE__ON * After shading correction, the status will be automatically set to DCAMPROP_MODE__ON.
* To use the correction data within the camera, set the table number in DCAM_IDPROP_SHADINGCALIBDATAMEMORY and then set DCAMPROP_MODE__ON.
DCAM_IDPROP_SHADINGCALIBDATAMEMORY
-
R
W
W
-
MODE
0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15
DCAM_IDPROP_SHADINGCALIB_SAMPLES
-
R
W
W
-
LONG
1 to 1024 , step 1 , default 128
DCAM_IDPROP_STORESHADINGCALIBDATATOMEMORY
-
R
W
W
-
MODE
0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15 It can only be use after shading correction
DCAM_IDPROP_SUBTRACT_DATASTATUS
-
R
-
-
-
MODE
DCAMPROP_CALIBDATASTATUS__NONE
DCAMPROP_CALIBDATASTATUS__FORWARD
DCAMPROP_CALIBDATASTATUS__BACKWARD
DCAMPROP_CALIBDATASTATUS__BOTH
DCAM_IDPROP_SHADINGCALIB_DATASTATUS
-
R
-
-
-
MODE
DCAMPROP_CALIBDATASTATUS__NONE
DCAMPROP_CALIBDATASTATUS__FORWARD
DCAMPROP_CALIBDATASTATUS__BACKWARD
DCAMPROP_CALIBDATASTATUS__BOTH
DCAM_IDPROP_SHADINGCALIB_METHOD
-
R
W
W
-
MODE
DCAMPROP_SHADINGCALIB_METHOD__MAXIMUM (default)
DCAMPROP_SHADINGCALIB_METHOD__USETARGET
DCAM_IDPROP_SHADINGCALIB_TARGET
-
R
W
W
-
LONG
1024 to 4095 , step 1 , default 4095
DCAM_IDPROP_SHADINGCALIB_STABLEMININTENSITY
-
R
W
W
-
LONG
256 to 4095 , step 1 , default 512
DCAM_IDPROP_DARKCALIB_STABLEMAXINTENSITY
-
R
W
W
-
LONG
32 to 4095 , step 1 , default 511
DCAM_IDPROP_SENSORGAPCORRECT_MODE
-
R
W
W
W
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_STORETAPCALIBDATATOMEMORY
-
R
W
-
-
MODE
1,2,3
DCAM_IDPROP_TAPCALIBDATAMEMORY
-
R
W
-
-
MODE
0,1,2,3
DCAM_IDPROP_NUMBEROF_TAPCALIB
-
R
-
-
-
LONG
return 18
DCAM_IDPROP_TAPCALIB_GAIN
-
R
W
-
-
LONG
0 to 63 , step 1 , default 0
Synchronous timing
DCAM_IDPROP_INTERNALFRAMERATE
-
R
-
-
-
REAL (Hz)
return number of frames per second in INTERNAL trigger mode.
DCAM_IDPROP_INTERNAL_FRAMEINTERVAL
-
R
-
-
-
REAL (Second)
return seconds of interval between frames in INTERNAL trigger mode.
DCAM_IDPROP_INTERNALLINERATE
-
R
W
W
W
REAL (Hz)
200.0 to 20000.0 , step 0.001 , default 20000.0 @ DCAMPROP_BINNING__1
200.0 to 15000.0 , step 0.001 , default 15000.0 @ DCAMPROP_BINNING__2
DCAM_IDPROP_INTERNALLINESPEED
-
R
W
W
W
REAL (m/s)
0.0096 to 0.96 , step 0.000000048 , default 0.96 @ DCAMPROP_BINNING__1
0.0192 to 1.44 , step 0.000048 , default 1.44 @ DCAMPROP_BINNING__2
System Information
DCAM_IDPROP_COLORTYPE
-
R
-
-
-
MODE
DCAMPROP_COLORTYPE__BW
DCAM_IDPROP_BITSPERCHANNEL
-
R
-
-
-
LONG
return 12
DCAM_IDPROP_IMAGE_WIDTH
-
R
-
-
-
LONG
return width pixel of current setting
DCAM_IDPROP_IMAGE_HEIGHT
-
R
-
-
-
LONG
return height line of current setting
DCAM_IDPROP_IMAGE_ROWBYTES
-
R
-
-
-
LONG
return horizontal rowbytes of current setting
DCAM_IDPROP_IMAGE_FRAMEBYTES
-
R
-
-
-
LONG
return bytes per frame of current setting
DCAM_IDPROP_IMAGE_TOPOFFSETBYTES
-
R
-
-
-
LONG
return offset bytes size to point first data in image
DCAM_IDPROP_IMAGE_PIXELTYPE
-
R
-
-
-
MODE
DCAM_PIXELTYPE_MONO16
DCAM_IDPROP_BUFFER_ROWBYTES
4.0
R
-
-
-
LONG
return row byte size of user attached buffer
DCAM_IDPROP_BUFFER_FRAMEBYTES
4.0
R
-
-
-
LONG
return byte size of a frame buffer that should be allocated when you use dcambuf_attach() function
DCAM_IDPROP_BUFFER_TOPOFFSETBYTES
4.0
R
-
-
-
LONG
return unnecessary data size in front of the actual image data
DCAM_IDPROP_BUFFER_PIXELTYPE
4.0
R
-
-
-
MODE
DCAM_PIXELTYPE_MONO16
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.000000
DCAM_IDPROP_IMAGEDETECTOR_PIXELHEIGHT
4.0
R
-
-
-
REAL (um)
return 48.000000
DCAM_IDPROP_TIMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_TIMESTAMP_PRODUCER__NONE
DCAM_IDPROP_FRAMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_FRAMESTAMP_PRODUCER__NONE
DCAM_IDPROP_CAMERASTATUS_INTENSITY
-
R
-
-
-
MODE
DCAMPROP_CAMERASTATUS_INTENSITY__GOOD
DCAMPROP_CAMERASTATUS_INTENSITY__TOODARK
DCAMPROP_CAMERASTATUS_INTENSITY__TOOBRIGHT
DCAMPROP_CAMERASTATUS_INTENSITY__UNCARE
DCAMPROP_CAMERASTATUS_INTENSITY__NODATA
DCAM_IDPROP_CAMERASTATUS_INPUTTRIGGER
-
R
-
-
-
MODE
DCAMPROP_CAMERASTATUS_INPUTTRIGGER__GOOD
DCAMPROP_CAMERASTATUS_INPUTTRIGGER__NONE

Go to top of this chapter