background image

MC136x/MC137x GenICam Reference Manual 

 

25 

 

3.  General Programming Guide 

3.1.  Camera States 

The feature CameraState indicates der current state of the camera.  
 
The camera has 4 states:   
 

IDLE 

the camera is in IDLE state 
 

LIVE 

the camera is streaming live frames from the camera to the host 
 

RECORDING 

the camera is in recording mode. Recorded frames will be stored in the cameras  internal buffer. If 
LIVE streaming was enabled when recording starts, a live image stream is send to the host while 
recording is running. 
 

STREAMING 

the camera is streams recorded frame data from the cameras internal buffer to the host. 
 
The accessibility of camera features depends on the current camera state. The table below shows 
this dependencies. 
 

 

available 

unavailable 

IDLE 

all states 

LIVE 

all „read only“ features 

CameraHeadReset 

ExposureTimeRaw 

GainRaw 

BlackLevelRaw 

SlopsMode 

SlopsDualRaw 

SlopsTripleRaw 

AcquisitionStop 

RecordStart 

others 

RECORDING 

all „read only“ features 

CameraHeadReset 

AcquisitionStop 

RecordStop 

others 

STREAMING 

all „read only“ features 

CameraHeadReset 

AcquisitionStop 

others 

 
 
 
 
 

Summary of Contents for MC136 Series

Page 1: ... io on n G Ge en nI IC Ca am m R Re ef fe er re en nc ce e M Ma an nu ua al l MC136x MC137x Camera Manual Rev 1 0 Copyright 2009 Mikrotron GmbH Mikrotron GmbH Landshuter Str 20 22 D 85716 Unterschleissheim Germany Tel 49 89 726342 00 Fax 49 89 726342 99 info mikrotron de www mikrotron de ...

Page 2: ...s 12 2 4 Record Controls 16 2 5 Stream Controls 19 2 6 Analog Controls 21 2 7 Camera State 24 3 General Programming Guide 25 3 1 Camera States 25 3 2 State Transformations 26 4 Record Programming Guide 27 4 1 Continuous Recording single sequence 27 4 2 Continuous Recording with more than one sequence 29 4 3 Single Recording 30 4 4 Triggered Recording 30 5 Streaming Programming Guide 31 6 Summarize...

Page 3: ...igE Vision is based on GEN i CAM which ensures compatibility to a wide range of programming interfaces and applications The description of this manual covers the Mikrotron cameras from the series MC136x and MC137x 1 1 General Target The configuration status and control capabilities of the cameras are accessible by a number of camera features This manual gives you an overview of the features define...

Page 4: ...interfaces are currently defined in the GenICam standard each one is given with the typical widget used to map it on a graphical user interface Interface Type Widget IInteger maps to a slider with value min max and increment IFloat maps to a slider with value min and max plus a physical unit IString maps to an edit box showing a string IEnumeration maps to a drop down box ICommand maps to a comman...

Page 5: ...camera is receipt by an ACK 0x06 Each read command returns the current value of the requested features followed by a trailing ACK If a command fails a NACK 0x15 is returned The format of the values you will get from the functions of the API of your choice may be differ from this description Please read the documentation of your SDK for details how they handle read write commands to the camera 2 1 ...

Page 6: ...eature provides the version Feature name DeviceVersion Access Read only Interface IString Unit Range Response e g Version 1 0 0 0 Note the string is limited by a trailing 0 DeviceID This feature provides the serial numbe Feature name DeviceID Access Read only Interface IString Unit Range Response e g 01234 0 Note the string is limited by a trailing 0 DeviceScanType This feature specifies the scan ...

Page 7: ...x GenICam Reference Manual 7 CameraHeadReset This feature ist used to reset the camera and to put it in its power up state Feature name CameraHeadReset Access Write only Interface ICommand Unit Range Response Note ...

Page 8: ...Unit pixel hex Range Response 1024 Note WidthMax This feature represents the maximum width in pixels of the image after horizontal binning decimation or any other function changing the horizontal dimensions of the image Feature name WidthMax Access Read only Interface IInteger Unit pixel Range Response 1280 Note HeightMax This feature represents the maximum height in pixels of the image after vert...

Page 9: ... height expelled by the camera in pixels Feature name Height Access Read Write Interface IInteger Unit pixel Range 1 1024 Response e g 0400 Invalidation RecordMaxFrames RecordMaxFramesPerSequence AcquisitionFrameRateMax AcquisitionFrameRateRaw ExposureTimeMax AcquisitionSource Precondition CameraState Idle Note Height OffsetY HeightMax OffsetX This feature represents the horizontal offset from the...

Page 10: ... use during the acquisition Feature name PixelFormat Access Read only Interface IEnumeration Unit Range Response Note Mono8 monocrome BayerGR8 color PixelCoding This feature indicates the coding of the pixels in the image The camera returns frame data in raw format that means in the native format of the sensor The color version of the camera uses a Bayer Filter in front of the sensor The data retu...

Page 11: ...mat register Feature name PixelSize Access Read only Interface IEnumeration Unit Range Response Note Bpp8 PixelColorFilter This feature indicates the type of color filter that is applied to the image This value must always be coherent with the PixelFormat register Feature name PixelColorFilter Access Read only Interface IEnumeration Unit Range Response Note None monochrome ...

Page 12: ...by an AcquistionStop command Feature name AcquisitionMode Access Read Write Interface IEnumeration Unit Range Continuous Response Continuous Invalidation Precondition CameraState Idle Note AcquisitionSource This feature defines the streaming source of frame data from the camera Feature name AcquisitionSource Access Read Write Interface IEnumeration Unit Range Live Memory Response e g 00 Invalidati...

Page 13: ... AcquisitionFrameRateRaw Access Read Write Interface IInteger Unit Hz fps frame per second Range 1 AcquisitionFrameRateMax Response e g 500 Invalidation ExposureTimeRaw ExposureTimeMax Precondition CameraState Idle AcquisitionFrameRateMax Note ExposureMode This feature is used to set the exposure mode of the camera Currently there is only Timed exposure available The exposure duration time is defi...

Page 14: ... exposed to light Feature name ExposureTimeRaw Access Read Write Interface IInteger Unit microseconds us Range 2 ExposureTimeMax Response e g 2 Invalidation Precondition CameraState Idle or LIVE ExposureTimeMax Note AcquisitionStart This feature starts the frame acquisition The frame source is specified by AcquisitionSource Feature name AcquisitionStart Access Write only Interface ICommand Unit Ra...

Page 15: ...n of the device at the end of the current frame If no Acquisition is in progress the command is ignored Feature name AcquisitionStop Access Write only Interface ICommand Unit Range Response Invalidation CameraState Precondition CameraState Live or Recording or Streaming Note CameraState Idle ...

Page 16: ...re name RecordMode Access Read Write Interface IEnumeration Unit Range Single Continuous Response Continuous Invalidation RecordNumberOfSequences RecordMaxFrames RecordMaxFramesPerSequence Precondition CameraState Idle Note Single Continuous default if single recording RecordNumberOfSequences is set to1 sequence automatically RecordNumberOfSequences This feature defines the number of different seq...

Page 17: ...recondition CameraState Idle RecordMaxFramesPerSequence Note RecordMaxFrames This feature indicates the maximal number of frames that can be recorded in sum of all defined sequences Feature name RecordMaxFrames Access Read only Interface IInteger Unit number of picture Range Response e g 3274 Note RecordNumberOfFrames This feature indicates the number of recorded frames in sum off all defined sequ...

Page 18: ...rdNumberOfFramesPerSequence Access Read only Interface IInteger Unit number of picture Range Response e g 3274 Note RecordStart This feature starts the recording to the camera internal buffer Recording will start at the first of the number of defined sequences Feature name RecordStart Access Write only Interface ICommand Unit Range Response Invalidation CameraState Precondition CameraState Idle or...

Page 19: ...ve to each buffer and starts with 0 Feature name StreamStartNumber Access Read Write Interface IInteger Unit number of picture Range 0 StreamEndNumber Response e g 0 Invalidation RecordNumberOfFramesPerSequence StreamStartNumber StreamEndNumber Precondition CameraState Idle StreamSequenceSelector StreamEndNumber Note StreamStartNumber StreamEndNumber StreamEndNumber This feature is used to set the...

Page 20: ...ber To read a frame set this feature to the requested frame number Feature name StreamSingleFrame Access Read Write Interface IInteger Unit number of picture Range 0 RecordNumberOfFramesPerSequence 1 Response e g 0 Invalidation Precondition CameraState Idle StreamSequenceSelector StreamStartNumber RecordNumberOfFramesPerSequence Note StreamSingleFrame RecordNumberOfFramesPerSequence 1 ...

Page 21: ...aw Access Read Write Interface IInteger Unit Range 50 200 Response e g 50 Invalidation Precondition CameraState Idle or Live Note SlopsMode This feature is used to set the mode of the multiple slope feature of the camera The multiple slope mode used to extend the dynamic range of the camera Feature name SlopsMode Access Read Write Interface IEnumeration Unit Range NormalShutter DualSlope TripleSlo...

Page 22: ...TripleSlope Note SlopsDualMin This feature indicates the minimum of the dual slope Feature name SlopsDualMin Access Read only Interface IInteger Unit Range Response 1 Invalidation Precondition CameraState Idle or Live SlopsMode DualSlope or TripleSlope Note SlopsDualMax This feature indicates the maximum of the dual slope Feature name SlopsDualMax Access Read only Interface IInteger Unit Range Res...

Page 23: ...de TripleSlope Note SlopsTripleMin This feature indicates the minimum of the triple slope Feature name SlopsTripleMin Access Read only Interface IInteger Unit Range Response e g 2 Invalidation Precondition CameraState Idle or Live SlopsMode TripleSlope Note SlopsTripleMax This feature indicates the maximum of the triple slope Feature name SlopsTripleMax Access Read only Interface IInteger Unit Ran...

Page 24: ...dle Live Streaming Recording Invalidation Idle Live Idle Streaming Idle Recording RecordNumberOfFrames RecordNumberOfFramesPerSequences Live Idle Live Recording RecordNumberOfFrames RecordNumberOfFramesPerSequences Recording Idle RecordNumberOfFrames RecordNumberOfFramesPerSequences Streaming Idle Precondition CameraState Idle StreamSequenceSelector StreamStartNumber RecordNumberOfFramesPerSequenc...

Page 25: ...starts a live image stream is send to the host while recording is running STREAMING the camera is streams recorded frame data from the cameras internal buffer to the host The accessibility of camera features depends on the current camera state The table below shows this dependencies available unavailable IDLE all states LIVE all read only features CameraHeadReset ExposureTimeRaw GainRaw BlackLevel...

Page 26: ...nsitions Transition Precondition Transition trigger IDLE LIVE AcquisitionSource Live AcquisitionMode Continuous AcquisitionStart LIVE IDLE AcquisitionStop IDLE RECORDING RecordStart or trigger button on camera RECORDING IDLE RecorStop or trigger button on camera LIVE RECORDING RecordStart or trigger butto on camera IDLE STREAMING AcquisitionSource Memory AcquisitionStart or AcquisitionStart and St...

Page 27: ...n one sequence RecordStart RecordStop or trigger button on camera Sequence jump only with trigger button on camera Single Recording RecordStart RecordStop or trigger button on camera Triggered Recording trigger button on camera trigger button on camera The different recording mode will be discussed in detail in the chapters below 4 1 Continuous Recording single sequence In continuous mode the came...

Page 28: ...ecording is running the Trigger LED on the camera is blinking and the feature CameraState returns the state Recording Recording gets stopped with the feature RecordStop or the trigger button on the back side of the camera After the record stop event is given recording continuous until the additional number of frames RecordTrailer are recorded to the buffer Now the camera state changes to Idle and ...

Page 29: ...uttom But if the trigger buttom is used you must give the camera a RecordStop after the trigger event The jump from one sequence to the next can only be done by the hardware trigger button of the camera The programming flow of a continuous recording with more sequences is RecordMode Continuous RecordNumberOfSequences Two Four or Eight sequences RecordTrailer x Range 0 RecordMaxFramesPerSequence 1 ...

Page 30: ...ber of recorded frames form the feature nRecordNumberOfFrames which sould be equal to RecordNumberOfFramesPerSequence 4 4 Triggered Recording Triggered recording means that recording is started with the trigger button of the camera A possibly running data transfer from the camera to the host has to be stopped by command AquisitionStop before recording starts Recording is done in continuous recordi...

Page 31: ...e 1 for the last frame If you did recording in multi sequence mode you must select the sequence you want to read from with the feature StreamSequenceSelector before reading The programming flow StreamSequenceSelector 0 or 1 or Read the feature RecordNumberOfFramesPerSequence StreamStartNumber StreamEndNumber 0 AcquisitionSource Memory Perform AcquisitionStart Discard the next frame from the camera...

Page 32: ... the feature RecordNumberOfFramesPerSequence StreamEndNumber x Range StreamStartNumber RecordNumberOfFramesPerSequence 1 StreamStartNumber x Range 0 StreamEndNumber AcquisitionSource Memory Perform AcquisitionStart CameraState gets Streaming The feature CameraState will be set automatically to Idle after streaming ends ...

Page 33: ...ize R e g Bpp8 IEnumeration PixelColorFilter R e g None IEnumeration Acquisition and Trigger Controls AcquisitionMode R W Continuous IEnumeration AcquisitionSource R W Live Memory IEnumeration AcquisitionFrameRateMax R IInteger AcquisitionFrameRateRaw R W Range 1 AcquisitionFrameRateMax IInteger ExposureMode R W Timed IEnumeration ExposureTimeMax R IInteger ExposureTimeRaw R W Range 2 ExposureTime...

Page 34: ...alog Controls GainRaw R W 0 600 IInteger BlackLevelRaw R W 50 200 IInteger SlopsMode R W NormalShutter DualSlpoe TripleSlope IEnumeration SlopsDualRaw R W SlopsDualMin SlopsDualMax IInteger SlopsDualMin R IInteger SlopsDualMax R IInteger SlopsTripleRaw R W SlopsTripleMin SlopsTripleMax IInteger SlopsTripleMin R IInteger SlopsTripleMax R IInteger Camera State CameraState R Idle Live Streaming Recor...

Reviews: