v24.9.6861

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 C15890-488N 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
-
-
-
MODE
DCAMPROP_SENSORMODE__AREA
Trigger
DCAM_IDPROP_TRIGGERSOURCE
-
R
W
W
W
MODE
DCAMPROP_TRIGGERSOURCE__INTERNAL (default)
DCAMPROP_TRIGGERSOURCE__SOFTWARE
DCAM_IDPROP_TRIGGER_MODE
-
R
W
W
-
MODE
DCAMPROP_TRIGGER_MODE__NORMAL (default)
DCAMPROP_TRIGGER_MODE__START
DCAM_IDPROP_TRIGGERACTIVE
-
R
-
-
-
MODE
DCAMPROP_TRIGGERACTIVE__EDGE
DCAM_IDPROP_TRIGGER_CONNECTOR
-
R
-
-
-
MODE
DCAMPROP_TRIGGER_CONNECTOR__BNC
Binning and ROI
DCAM_IDPROP_BINNING
-
R
W
-
-
MODE
DCAMPROP_BINNING__1 (default)
DCAMPROP_BINNING__2
DCAM_IDPROP_SUBARRAYHPOS
-
R
-
-
-
LONG
return 0
DCAM_IDPROP_SUBARRAYHSIZE
-
R
-
-
-
LONG
return 1280
DCAM_IDPROP_SUBARRAYVPOS
-
R
-
-
-
LONG
return 0
DCAM_IDPROP_SUBARRAYVSIZE
-
R
-
-
-
LONG
return 960
DCAM_IDPROP_SUBARRAYMODE
-
R
-
-
-
MODE
DCAMPROP_MODE__OFF
Feature
DCAM_IDPROP_EXPOSURETIME
-
R
-
-
-
REAL (Second)
return 0.000000
ALU
DCAM_IDPROP_FRAMEAVERAGINGMODE
-
R
W
W
W
MODE
DCAMPROP_MODE__OFF (default)
DCAMPROP_MODE__ON
DCAM_IDPROP_FRAMEAVERAGINGFRAMES
-
R
W
W
W
LONG
2 to 1024
Synchronous timing
DCAM_IDPROP_TIMING_READOUTTIME
-
R
-
-
-
REAL (Second)
return seconds how long takes to reading out a frame.
DCAM_IDPROP_TIMING_CYCLICTRIGGERPERIOD
-
R
-
-
-
REAL (Second)
return seconds which period cyclic trigger happens in.
DCAM_IDPROP_TIMING_MINTRIGGERBLANKING
-
R
-
-
-
REAL (Second)
return seconds required minimum trigger blanking.
DCAM_IDPROP_TIMING_MINTRIGGERINTERVAL
-
R
-
-
-
REAL (Second)
return seconds required minimum trigger interval.
DCAM_IDPROP_TIMING_INVALIDEXPOSUREPERIOD
-
R
-
-
-
REAL (Second)
return seconds of period which exposure is not started from trigger.
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.
System Information
DCAM_IDPROP_COLORTYPE
-
R
-
-
-
MODE
DCAMPROP_COLORTYPE__BW
DCAM_IDPROP_BITSPERCHANNEL
-
R
-
-
-
LONG
return 12
DCAM_IDPROP_NUMBEROF_CHANNEL
-
R
-
-
-
LONG
return 4
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_IMAGE_CAMERASTAMP
4.0
R
W
-
-
LONG
0 to 65535 , step 1 , default 0
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_RECORDFIXEDBYTES_PERFILE
4.0
R
-
-
-
LONG
return additional data size per a file
DCAM_IDPROP_RECORDFIXEDBYTES_PERSESSION
4.0
R
-
-
-
LONG
return additional data size per a session
DCAM_IDPROP_RECORDFIXEDBYTES_PERFRAME
4.0
R
-
-
-
LONG
return additional data size per a frame
DCAM_IDPROP_SYSTEM_ALIVE
-
R
-
-
-
MODE
DCAMPROP_SYSTEM_ALIVE__OFFLINE
DCAMPROP_SYSTEM_ALIVE__ONLINE
DCAM_IDPROP_IMAGEDETECTOR_PIXELWIDTH
4.0
R
-
-
-
REAL (um)
return 6.600000
DCAM_IDPROP_IMAGEDETECTOR_PIXELHEIGHT
4.0
R
-
-
-
REAL (um)
return 6.600000
DCAM_IDPROP_IMAGEDETECTOR_PIXELNUMHORZ
4.0
R
-
-
-
LONG
return 1280
DCAM_IDPROP_IMAGEDETECTOR_PIXELNUMVERT
4.0
R
-
-
-
LONG
return 960
DCAM_IDPROP_TIMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_TIMESTAMP_PRODUCER__IMAGINGDEVICE
DCAM_IDPROP_FRAMESTAMP_PRODUCER
4.0
R
-
-
-
MODE
DCAMPROP_FRAMESTAMP_PRODUCER__IMAGINGDEVICE
MAICO
DCAM_IDPROP_CONFOCALSCANMODE
4.0
R
W
W
-
MODE
DCAMPROP_CONFOCALSCANMODE__SIMULTANEOUS (default) acquisition are performed simultaneously on multiple channels to be measured
DCAMPROP_CONFOCALSCANMODE__SEQUENTIAL multiple channels are measured sequentially by changing the channel used for each frame
DCAM_IDPROP_CONFOCALSCANLINES
4.0
R
W
W
-
MODE
reduce the number of the scan lines in the horizontal direction and improve image output frame rate
240
480
960 (default)
DCAM_IDPROP_CONFOCALZOOM
4.0
R
W
W
-
LONG
1 to 2 , step 1 , default 1
DCAM_IDPROP_DISTORTIONCORRECTION
4.0
R
-
-
-
MODE
DCAMPROP_DISTORTIONCORRECTION__ON (default)
DCAM_IDPROP_SUBUNIT_IMAGEWIDTH
4.0
R
-
-
-
LONG
return width pixel of single subunit
return 1280
DCAM_IDPROP_NUMBEROFSUBUNIT
4.0
R
-
-
-
LONG
return max number of installed subunit
return 4
DCAM_IDPROP_SUBUNIT_CONTROL
4.0
R
W
W
-
MODE
DCAMPROP_SUBUNIT_CONTROL__OFF
DCAMPROP_SUBUNIT_CONTROL__ON
DCAMPROP_SUBUNIT_CONTROL__NOTINSTALLED the subunit is not installed or recognized
DCAM_IDPROP_SUBUNIT_LASERPOWER
4.0
R
W
W
W
LONG
0 to 100 , step 1 , default 0
DCAM_IDPROP_SUBUNIT_PMTGAIN
4.0
R
W
W
W
REAL
0.500000000 to 0.900000000 , step 0.010000000 , default 0.500000000
DCAM_IDPROP_SUBUNIT_TOPOFFSETBYTES
4.0
R
-
-
-
LONG
return unnecessary data size in front of the actual image data for each subunit
DCAM_IDPROP_SUBUNIT_PINHOLESIZE
4.0
R
-
-
-
MODE
return the size of each pinhole
DCAMPROP_SUBUNIT_PINHOLESIZE__ERROR
DCAMPROP_SUBUNIT_PINHOLESIZE__SMALL
DCAMPROP_SUBUNIT_PINHOLESIZE__MEDIUM
DCAMPROP_SUBUNIT_PINHOLESIZE__LARGE
DCAM_IDPROP_SUBUNIT_WAVELENGTH
4.0
R
-
-
-
LONG
return the wavelength of each subunit

Go to top of this chapter