Lmk4 ActiveX Server
Public Slots | Signals | List of all members
LMKAxServer Class Reference

Detailed Description

Declaration of the ActiveX interface class.

The functions are grouped by their functionality.

To test these functions you can use the Excel file "lmk4axservertest.xls" in the subdirectory "Examples" of your LabSoft installation. For every function there is a button. If the button is pressed, a Visual Basic function is called. The source code of all VB functions is within the mentioned Excel file.


Opening and closing of the LabSoft application

      

These functions are needed at the begin and the end of the work with LabSoft. The program is started and the connection to it is established.

iOpen() Opens the LabSoft application
iClose() Closes the LabSoft application
iShow() Change visibility of the program


Access to camera features

      

These functions are needed to initialize a camera-lens-combination and to change some camera parameters like the exposure time and the filter wheel of a wheel color camera.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Camera, lens and recalibration".


iCamera_List() List of camera and lens calibration data for this installation
iSetNewCamera() Open a camera
iSetNewCamera2() Open a camera
iCamera_Firmware() Get version of firmware in camera and lens
iGetCameraLensPath() Get name and path of camera and lens
iGetIntegrationTime() Determine current exposure time
iSetIntegrationTime() Set new exposure time
iAutoScanTime() Determine a good exposure time
iGetFilterWheel() Determine filter state (color camera only)
iSetFilterWheel() Set new filter position (color camera only)
iColorAutoScanTime() Determine good exposure times for every color filter
iCamera_GetParameter() Read some additional camera properties
iCamera_SetOverdriveRegion()Set the region, which is used for overdrive control
iCamera_GetOverdriveRegion()Get the region, which is used for overdrive control
iCamera_GetFocusAndContrast()Get Focus and contrast information of a region in the camera image
iCamera_GetSaturation()Get saturation information of camera image or region in camera image

Controllable lens

In the LabSoft these functions are available in the
Exposure time dialog: Menu point "Camera | Exposure time"
iHaveControllableLens() Controlable lens connected?
iLensInit() Reinitialize controllable lens
iGetLensID() Get ID of lens
iGetFocus() Get current focus position
iSetFocus() Set focus position
iSetFocusParameter() Set parameter for autofocus
iGetFocusParameter() Get parameter for autofocus
iAutoFocus() Make autofocus procedure
iReFocus() Make autofocus procedure in a small range around the last good value
iGetMinMaxAperture() Get range of aperture values
iGetAperture() Get current aperture vaue
iSetAperture() Set aperture value


Capturing of images

      

With these functions you can capture either camera images or luminance images or color images.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Capturing images".

Beginning from LabSoft version 13.6.x there are new capturing algorithms for color images:

One important difference between these functions and the older function iColorHighDynPic2() is, that now different exposure times for every filter are used. That increases the accuracy of color cordinates and decreases the capturing time in most cases.

Beginning from LabSoft version 11.4.x, the capturing functions iSinglePic(), iMultiPic(), iHighDynPic() and iColorHighDynPic() are obsolete. Beginning vom LabSoft version 14.xx the capturing function iHighDynPic2() is obsolete. The obsolete functions should be replaced by iSinglePic2(), iMultiPic2(), iHighDynPic3() and iColorHighDynPic2() in new applications. These new functions only contain the minimum set of parameters like exposure time and number of shots. All other parameters can be set by the specialized functions like iSetSmear(), iSetModulationFrequency(), iSetAutoscan(), iSetScatteredLight() and iSetTriggerMode(). Reason: If in later versions new parameters are introduced, the function interfaces of the capturing algorithms stay the same.


Capturing functions In the LabSoft these functions are available in the menu "Capture"
iGrab() Capturing a camera image
iSinglePic2() Capturing a luminance image with SinglePic algorithm
iMultiPic2() Capturing a luminance image with MultiPic algorithm
iHighDynPic3() Capturing a luminance image with HighDyn algorithm
iColorCaptureMultiPic() Capturing a color image with MultiPic algorithm
iColorCaptureHighDyn() Capturing a color image with HighDyn algorithm
iSinglePicFromFile() Convert camera image file to luminance image
iSinglePicsFromDirectory() Convert dir with camera images to dir with luminance images

Parameterization


In the LabSoft these functions are available in the
Capture properties dialog, page "Capture options".
Menu point: "Capture | properties"
iCaptureGetLastInfo() Determine information about last capture
iLoadCaptureParameterSet() Load predefined parameter set for the next captures
iSetSmear() Switch smear correction on or off
iGetSmear() Inform about smear correction state
iSetModulationFrequency() Set modulation frequency
iGetModulationFrequency() Get modulation frequency
iSetAutoscan() Switch autoscan algorithm on or off
iGetAutoscan() Inform about autoscan state
iSetScatteredLight() Switch scattered light correction on or off
iGetScatteredLight() Inform about scattered light correction state
iSetTriggerMode() Switch trigger mode on or off (no Lmk6 cameras)
iGetTriggerMode() Inform about trigger mode state (no Lmk6 cameras)
iIsTriggerAvailable() Trigger modi of Lmk6 camera available?
iSetTriggerCommonParameter()Set common trigger parameters for Lmk6 cameras
iGetTriggerCommonParameter()Get common trigger parameters for Lmk6 cameras
iSetTriggerStrobeParameter()Set strobe trigger parameters for Lmk6 cameras
iGetTriggerStrobeParameter()Get strobe trigger parameters for Lmk6 cameras
iSetTriggerImageParameter() Set image trigger parameters for Lmk6 cameras
iGetTriggerImageParameter() Get image trigger parameters for Lmk6 cameras
iSetTrigger() Switch trigger mode on or off for Lmk6 cameras
iGetTrigger() Is trigger mode on or off for Lmk6 cameras?
iGetMaxCameraTime() Inform about maximum of possible exposure time
iSetMaxCameraTime() Set maximum of possible exposure time
iSetAutomatic() Set Automatic-Flag for all exposure times
iGetAutomatic() Get the state of Automatic-Flag for exposure times
iSetSuppressProgressDialog()Suppress view of progress dialog while capturing an luminance or color image
iGetSuppressProgressDialog()Get the state of suppressing view of progress dialog
iSetSuppressOverflow() Suppress overflow warning in measurement series
iGetSuppressOverflow() Get the state of suppress overflow warning in measurement series
iSetDarkening() Darkening computer monitor while capturing
iGetDarkening() Get the state of darkening computer monitor while capturing

Obsolete functions Please use the other one!
iSinglePic() Obsolete, use iSinglePic2() instead
iMultiPic() Obsolete, use iMultiPic2() instead
iHighDynPic() Obsolete, use iHighDynPic3() instead
iHighDynPic2() Obsolete, use iHighDynPic3() instead
iColorHighDynPic() Obsolete, use iColorHighDynPic2() instead
iColorHighDynPic2() Obsolete, use iColorCaptureMultiPic() or iColorCaptureHighDyn() instead

Recalibration functions


In the LabSoft these functions are available in the
Capture properties dialog, page "Recalibration".
Menu point: "Capture | properties"
iGetConvertingUnits() Get converting informations
iSetConvertingUnits() Set new converting values
iGetRecalibrationFactor() Get recalibration factor
iSetRecalibrationFactor() Set recalibration factor
iGetFocusFactorList() List of available focus factors
iSetFocusFactor() Set a focus factor
iGetGreyFilterList() List of available grey filters
iSetGreyFilter() Selection of a grey filter
iSetGreyFilterList() Switch grey filters on or off
iGetColorCorrList() List of available color correction factors
iSetColorCorr() Selection of a color correction factor
iGetColorFactorsList() List of available color matrices
iSetColorFactors() Set a color matrix
iGetColorFactorsSize() Number of color factor sets
iGetColorFactorsName() Get name of color factor set
iCopyColorFactors() Copy factors from one set to another
iDefaultColorFactors() Reset color factor set to default values
iAdjustColorFactors() Change color factors to adjust to a given color
iSaveColorFactorsFile() Save color factors file to use at next program start


Loading and saving protocols

      

With protocol files all data, including images and statistical evaluations, are saved together in one single file.
You can later load it again and reconstract a certain state of your work.
The H5 import function is due to load protocol files of a previous software of TechnoTeam, called "Lmk2000".
In the LabSoft the associated functions are in the menu "Protocol".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Protocols".

iSaveProtokoll() Save a protocol into a file
iLoadProtokoll() Load a protocol from a file
iImportHDF5Protocol() Import a HDF5 protocol


Access to the images

      

This section contains all functions concerning access to the images within the LabSoft program.

  • You can load and save images to files and to your own memory.
  • You can get the values of single pixels within the images.

The direct use of this functionality in the LabSoft program is described in the manual in chapter "Images".

Indices of the images used in the functions

IndexImage
-3 Camera image
-2 Luminance image
-1 Color image
0 or larger Indices of evaluation images. iGetNumberImages() gives the number of them.


Available functions 
iGetNumberImages() Determine number of evaluation images
iImageCreate() Creates a new evaluation image
iImageDelete() Deletes an existing evaluation image
iSaveImage() Save image
iSaveImageRegion() Save part of an image
iLoadImage() Load image
iGetIndexOfImage() Get index of image given image name
iGetImageName() Get the name of an image given by image index
iGetPermanentImageName()Get the permanent name of an image given by image index
iSetImageName() Set the name of an image given by image index
iSelectImage() Bring image to front
iGetSelectedImage() Index of current image on top
iImageGetSize() Get image size and parameter
iImageSetSize() Set image size
iGetImageCaptureParameter()Get information of last capture to this image
iImageGetPixelGrey() Get a pixel value of a grey image
iImageGetPixelColor() Get a pixel value of a color image
iImageGetDumpToMemory() Get a memory dump of a region into memory
iImageGetDumpToFile() Get a memory dump of a region into a file


Access to region lists

      

With these functions you have access to measurement regions within the images.
You can create or delete regions. You can change region properties.

The indices of the region lists are the same like in the case of the images.
That means -3, -2 and -1 acesses the region list, shared in camera, luminance and color image.
The other indices belong to the lists, used in evaluation images.

The direct use of this functionality in the LabSoft program is described in the manual in chapter "Measuring regions".

Region types and their properties

Region typeType identifierNumber of pointsMeaning of points
Rectangle 02 Top-left,bottom-right corner
Line 12 First and second line end point
Circle 22 Middle point and point on circumference
Polygon 33 or more Corner points
Polyline 43 or more Corner points
Ellipse 53
  • First point: Middle point
  • Second point: End point of first half axis
  • Third point: Distance to first point is length of second half axis
Circular ring63
  • First point: Middle point
  • Second point: Distance to first point is length of first circle
  • Third point: Distance to first point is length of first circle
OR group 72 Top-left,bottom-right corner
XOR group 82 Top-left,bottom-right corner
AND group 92 Top-left,bottom-right corner

All coordinates are in the units of the coordinate system used. All regions except the OR, XOR and AND group can be created via iCreateRegion().
Groups can be created via iCreateGroup().


Available functions 
iGetRegionListSize() Determine the number of regions
iIsRegionSelected() Is a region selected?
iSelectRegion() Selects or deselects a region
iCreateRegion() Create a region
iDeleteRegion() Delete a region
iCreateGroup() Create a group region
iDeleteGroup() Delete a group region
iGetPropertiesRegion() Get the properties of a region
iMoveRegion() Moves a region
iChangeRegion() Set the properties of a region
iGetRegionName() Read region name
iSetRegionName() Change region name
iGetPositionRegionName()Read position of region name
iSetPositionRegionName()Change position of region name
iSaveRegionList() Save region list
iSaveRegionListCS() Save region list in units of coordinate system
iLoadRegionList() Load region list
iLoadRegionListCS() Load region list in units of coordinate system
iGetIndexOfRegion() Get index of region given region name
iClearUndoRegionList() Delete the undo stack of region list (saves memory and time)


Access to the coordinate systems

      

A coordinate system is assigned to every image. You can access to this coordinate systems via the following functions.

The indices of the coordinate systems are the same like in the case of the images.
That means -3, -2 and -1 acesses the coordinate systems in camera, luminance and color image.
The other indices belong to the coordinate systems, used in evaluation images.

The direct use of this functionality in the LabSoft program is described in the manual in chapter "Coordinate systems".


Available functions 
iCoordSystemGetValueUnit() Get the values and units of the axis
iCoordSystemSetValueUnit() Set the values and units of the axis
iCoordSystemSetCartesian() Set the parameter of a cartesian system
iCoordSystemSetPolar() Set the parameter of a polar system
iCoordSystemGetCartesian() Get the parameter of the current cart. system
iCoordSystemGetPolar() Get the parameter of the current polar system
iCoordSystemPixelToCoord() Convert pixel indices to coordinates
iCoordSystemCoordToPixel() Convert coordinates to pixel indices
iCoordSystemWriteFile() Write parameter into a file
iCoordSystemReadFile() Read parameter from a file


Access to image views

      

This section contains all functions concerning access to the image views within the LabSoft program.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Images".

The indices of the image views are the same as the images they contain:

IndexImage
-3 Camera image
-2 Luminance image
-1 Color image
0 or larger Indices of evaluation images. iGetNumberImages() gives the number of them.

Available functions 
iGetViewPalette() Get index of used palette
iSetViewPalette() Change used palette
iLoadIsoPalette() Load iso palette from a file
iLoadUserPalette() Load user palette from a file
iGetViewScaling() Get used scaling of image view
iSetViewScaling() Set new scaling of image view
iGetViewScalingRect() Get used scaling rectangle of image view
iSetViewScalingRect() Set new scaling rectangle of image view
iGetViewZoom() Get used zoom of image view
iSetViewZoom() Set new zoom of image view

Access to the statistics

      

There is one list of statistic objects of every statistic type, regardless the images and region lists.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Statistic ealuations".

The access to these specialized statistics is done by their type identifiers.

Available statistic types

IndexImage
0 Standard statistic in grey images
1 Standard statistic in color images
2 Sectional view in grey images
3 Sectional view in color images
4 Histogram in grey images
5 Histogram in color images
6 Bit histogram in grey images (only images of camera image type)
7 Bit histogram in color images (only images of color camera image type)
8 Projection in grey images
9 Projection in color images
20 Luminance objects in grey images
22 Integral objects in grey images
23 Integral objects in color images
24 Symbol objects in grey images
25 Symbol objects in color images
26 Light arc objects in grey images
28 Spiralwoundfilaments in grey images
31 Chromaticity line diagrams in color images
33 Chromaticity area diagrams in color images
34 3d view in grey images
36 Integral objects in grey images (negative contrast)
38 Symbol objects in grey images (negative contrast)
39 Symbol objects in color images (negative contrast)
40 Contrasts objects in grey images
42 Focus objects in grey images
44 Quantil objects in grey images

Color statistics are always in RGB color space.

The order of classes (in class statistics) or colors (in color statistics):

  • class=0 = dark or blue
  • class=1 = medium or green
  • class=2 = bright or red
statparameter.png
  

Some functions read or write lists of parameters:

The meaning, number, sequence and value range of the parameters are the same
as those in the corresponding parameter dialog of LabSoft.

You can open this dialog from the context menu in an image with the menu point
"Statistics" or in the main menu with the menu point "Evaluation | statistics".

An example for the luminance object:

Luminance objects have three parameters as shown in the image on the left side.
Therefore:

  • Number of parameters: 3
  • Parameter list contains three values: 663 779 1
    (Threshold 0, Threshold 1, Smoothing)

Access to standard values  
iGetStatisticSize() Determine number of objects in a statistic vector
iGetStatisticObject() Determine image and region of statistic object
iGetStandardStatistic() Obsolete
iGetStandardStatistic2() Determine parameter of the standard statistic
iGetFlagsStatistic() Obsolete. Use next function instead
iGetFlagsStatistic2() Read the current state of calculation flags
iGetGeometricStatistic() Get the geometric center of statistical object
iGetPhotometricStatistic() Get the photometric center of statistical object
iGetMinMaxStatistic() Get the min max values of statistical object

Access to special values  
iGetGreySecViewValues() Get the values of the sectional view in a grey image
iGetColorSecViewValues() Get the values of the sectional view in a color image
iGetGreyHistogramValues() Get the values of the histogram in a grey image
iGetColorHistogramValues() Get the values of the histogram in a color image
iGetGreyProjectionValues() Get the values of the projection in a grey image
iGetColorProjectionValues() Get the values of the projection in a color image
iGetArcObjectResults() Get the results of an arc object in a grey image
iGetArcObjectValues() Get the values of an arc object in a grey image
iGetQuantilObjectResults() Get the results of an quantile object in a grey image

Access to time statistics  
iGetTimeSummaryStatistic() Change a summary of time statistic
iGetTimeSizeStatistic() Get the number of entries in a time statistic
iGetTimeValuesStatistic() Get the entries themselves of a time statistic
iResetTimeStatistic() Reset a time statistic

Access to classes and line equations  
iGetNumClasses() Get the number of classes
iGetClass() Get name and visibility of class
iSetClass() Set name and visibility of class
iGetNumEquations() Get the number of line equations
iGetEquation() Get an equation and its result
iAppendEquation() Append an equation
iDeleteEquation() Delete an equation

Changing statistic objects  
iSetFlagsStatistic() Obsolete. Use next function instead
iSetFlagsStatistic2() Set the state of calculation flags
iHaveStatistic() Proof, if a statistic exists
iCreateStatistic() Create a new statistic
iDeleteStatistic() Delete an existing statistic
iGetStatisticParameter() Read the parameters of a statistic
iSetStatisticParameter() Change the parameters of a statistic

Changing assignment of parameter sets to objects  
iParamStatistics_Connect() Take the statistic parameter of one object over to another
iParamStatistics_Disconnect()Separate the statistic parameter set of one object
iParamStatistics_GetName() Get the name of a parameter set
iParamStatistics_SetName() Set the name of a parameter set


Image processing and arithmetic

      

There are several types of image processing algorithms:

  • Operations with two source images results in a destination image.
  • Operations with one source image and some parameters results in a destination image.
  • Operations with one source image results in a destination image.

Some annotations:

  • The type of the algorithm is encoded by a string, for example "add" for addition.
  • The indizes of the source and destination images are numbers.
  • The parameters needed are within a string.

Arithmetic functions are available in the LabSoft in the Image processing dialog, page "Arithmetic".
This dialog can be opened via menu point "Evaluation | Image processing".
See table with possible operations below.
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Image processing".

imageArithmeticII() Image arithmetic with 2 src images and 1 dst image
imageArithmeticIP1() Image arithmetic with 1 src image, 1 parameter and 1 dst image
imageArithmeticIP3() Image arithmetic with 1 src image, 3 color parameter and 1 dst image
imageArithmeticI() Image arithmetic with 1 src image and 1 dst image

Coordinate transformation is available in the LabSoft in the Coordinate transformation dialog.
This dialog can be opened via menu point "Evaluation | Coordinate transformation".
But you need precalculated index images.
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Coordinate transformation".

iCoordinateTransformationI()Coordinate transformation with two index images
iCoordinateTransformationF()Coordinate transformation with two index files

Projective rectification is available in the LabSoft in the Projective rectification dialog.
This dialog can be opened via menu point "Evaluation | Projective rectification".
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Projective rectification".

iProjectiveRectification()Projective rectification of an image

Most color calculation possibilities are available in the LabSoft in the lower part of the menu "Evaluation".
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Evaluating color images".
iGetColor() Conversion of a color value from CIE-RGB
iGetColorRGB() Conversion of a color value to CIE-RGB
iSplitColorImage() Split a color image into color extracts
iMergeColorImage() Create a color image from color extracts
iColorDiffImgImg() Calculate a color difference between two images
iColorDiffImgCol() Calculate a color difference to a reference color
iImageGetRefColorInRGB()Get the reference color of an image
iImageSetRefColorInRGB()Set the reference color of an image

Possible operations and their parameters

Operation Code imageArithmeticII() imageArithmeticIP1() imageArithmeticIP3()

imageArithmeticI()

Addition add yes yes yes  
Subtraction sub yes yes yes  
Multiplication mul yes yes yes  
Division div yes yes yes  
Minimum min yes yes yes  
Maximum max yes yes yes  
Greater than grt yes yes yes  
Smaller than smt yes yes yes  
Binarization bin  yes yes  
Power pow  yes   
Mirror mir  yes   
Rotate rot  yes   
Scaling sca  yes   
Box filter box  yes   
Median filter med  yes   
Erosion ero  yes   
Dilatation dil  yes   
Negation neg    yes
Inversion inv    yes
Exponent exp    yes
Logarithmus log    yes


Access to tables independently of their usage in statistics

      

Maybe these functions are usefull if someone will have a copy of some tables in his own application.
All tables in the LabSoft are shown in the lower part of the application.


iTableGetNumber() Returns the number of tables in the result tab widget
iTableGetNameAndCaption() Returns the name and the caption of an existing table
iTableGetIndex() Search for a table, given by name or caption
iTableGetNumberColumns() Returns the number of columns of a table
iTableGetNumberLines() Returns the number of lines of a table
iTableGetColumn() Returns the column header of a column of a table
iTableGetCell() Returns the content of a cell of a table
iTableGetAllContent() Returns all cells of a table as a list

Export of bitmaps (images, graphics and diagrams) to bitmap files

      

Maybe these functions are usefull if someone will have a copy of some bitmaps in his own application.


iBitmapGetList() Returns a list of exportable bitmaps
iExportBitmapToFile() Export a bitmap to a bitmap file

Export of data to Excel

      

These functions are needed to export data to Excel. In the LabSoft there is the associated
dialog Export to MS Excel in the menu point "Protocol | Export to MS Excel".
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Printing and exporting", section "Export to Microsoft Excel".


iExcelOpenFile() Opening an Excel file
iExcelSetVisible() Set visibility
iExcelSelectAll() Select all data (images, tables, diagrams)
iExcelUnselectAll() Unselect all data (images, tables, diagrams)
iExcelCopySelected() Copy all selected data to Excel
iExcelGetNumberItems() Get number of items in Excel dialog
iExcelGetItemProperties() Get parameters of item in Excel dialog
iExcelSetItemProperties() Set parameters of item in Excel dialog
iExcelCopyItem() Copy one item to Excel
iExcelSave() Saving an Excel file
iExcelClose() Closing an Excel file


Export of data to Word

      

These functions are needed to export data to Word. In the LabSoft there is the associated
dialog Export to MS Word in the menu point "Protocol | Export to MS Word".
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Printing and exporting", section "Export to Microsoft Word".


iWordOpenFile() Opening a Word file
iWordSetVisible() Set visibility
iWordSelectAll() Select all data (images, tables, diagrams)
iWordUnselectAll() Unselect all data (images, tables, diagrams)
iWordCopySelected() Copy all selected data to Word
iWordGetNumberItems() Get number of items in Word dialog
iWordGetItemProperties() Get parameters of item in Word dialog
iWordSetItemProperties() Set parameters of item in Word dialog
iWordCopyItem() Copy one item to Word
iWordSave() Saving a Word file
iWordClose() Closing a Word file


Calculation and export of a luminous intensity distribution (LID)

      

These functions need precalculated calibration data for LIDs.


The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Calculation of a luminous intensity distribution".
iLIDopenDialog() Opens dialog for LID calculation
iLIDgetCountParam() Get number of available parameter set in LID calculation dialog
iLIDgetParamName() Get name of a parameter set in LID calculation dialog
iLIDexecute() Executes a LID calculation with one of the parameter set
iLIDcloseDialog() Closes dialog for LID calculation
iLIDMergeCaptureProcess()Captures a big LID image out of several images

The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Exporting a luminous intensity distribution".
iLEXopenDialog() Opens dialog for LID export into a file
iLEXsetImage() Select image for export
iLEXsetDescription()Descriptions for export file
iLEXsetParameter() Parameters for export file
iLEXgetAngles() Get current angle area from dialog
iLEXanglesFromImage()Set angle area from image coordinate system
iLEXanglesFromSelRect()Set angle area from selected rectangle coordinate system
iLEXsetAngles() Select angle area for export file
iLEXsetOrigin() Modification of origin of coordinate system
iLEXsetCoordSystem()Types of coordinate system orientation used
iLEXexecute() Export of LID into a file
iLEXcloseDialog() Closes dialog for LID export into a file


Other maybe usefull functions

      

In some cases possibly usefull stuff, not belonging to the other categories.

iExecMenuPoint() Execute any menu items of the Lmk4 program
iGetErrorInformation() More precisely error description
iGetProgramInfo() Get information about program version and camera
iExecTclCommand() Execute a TCL command by the embedded interpreter
iWriteToStatusLine() Writes a string to the status line of the program
iReadFromStatusLine() Read a string from the status line of the program


Access to camera set-up dialog functions

The associated dialog in the LabSoft is the Camera set-up dialog. It can be opened with the menu point "Camera | Camera set-up dialog".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Capturing images",
section "Camera set-up (orientation, focussing)".

      


iCameraSetupDialogOpen() Opens the dialog "Camera set-up
iCameraSetupLoadProject() Load predefined project file *.cap
iCameraSetupMeasurementStart() Start measurement in camera or luminance image
iCameraSetupMeasurementStop() Stop measurement in camera or luminance image
iCameraSetupSaveResult() Save calculated results in *.car file
iCameraSetupResultCircles() Get position of circles found in image
iCameraSetupResultGeo() Get results of geometric adjustment
iCameraSetupResultPhoto() Get results of photometric adjustment
iCameraSetupDialogClose() Closes the dialog "Camera set-up


"Search for regions and using them automatically" dialog

The associated dialog in the LabSoft is the Searching for regions and using them automatically dialog.
It can be opened with the menu point "Evaluation | Searching for regions and using them automatically".
The direct use of this functionality in the LabSoft program is described in the manual in chapter
"Image processing and evaluation images", section "Searching for regions and using them automatically".

      


iSR_Open() Opens the dialog
iSR_Close() Closes the dialog
iSR_Execute() Execute search and usage
iSR_SetSearchingFor() Set parameters to section "Searching for regions"
iSR_GetSearchingFor() Get parameters from section "Searching for regions"
iSR_SetChangeRegions() Set parameters to section "Change regions"
iSR_GetChangeRegions() Get parameters from section "Change regions"
iSR_SetUseRegions() Set parameters to section "Use regions"
iSR_GetUseRegions() Get parameters from section "Use regions"
iSR_SetStatistics() Set parameters to section "Generate statistics"
iSR_GetStatistics() Get parameters from section "Generate statistics"


BlackMura add-on functions

      

If the ActiveX program version is installed and the BlackMura add-on too you can access the BlackMura functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the BlackMura dialog. It can be opened with the menu point "Evaluation | BlackMura application".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "BlackMura software package".


iBlackMuraOpenDialog() Opens the dialog for BlackMura measurements
iBlackMuraCloseDialog() Closes the dialog for BlackMura measurements
iBlackMuraLoadProject() Loads BlackMura project file
iBlackMuraSaveProject() Saves BlackMura project file
iBlackMuraGetProjectFileName() Get BlackMura project file name
iBlackMuraLoadAdjFile() Loads Camera adjustment file
iBlackMuraAdjImageCopy() Copy adjustment image from "Camera image" to "Adjustment image"
iBlackMuraBrightCapture() Makes a BlackMura bright capture and calculates results
iBlackMuraBrightLoad() Load a BlackMura bright image and calculates results
iBlackMuraDarkCapture() Makes a BlackMura dark capture and calculates results
iBlackMuraDarkLoad() Load a BlackMura dark image and calculates results
iBlackMuraSetFlagsProject() Set flags for DarkMura project
iBlackMuraGetFlagsProject() Get flags for DarkMura project
iBlackMuraSetDstDirectory() Set the destination directory for saving images
iBlackMuraGetDstDirectory() Get the destination directory for saving images
iBlackMuraSetSerialNumber() Set the serial number of next display to examine
iBlackMuraGetSerialNumber() Get the serial number of next display to examine
iBlackMuraSetMeasureFlags() Set flags for DarkMura measurement
iBlackMuraGetMeasureFlags() Get flags for DarkMura measurement
iBlackMuraAutomaticMeasure() Automatic measurement using DVI interface


Matrix module add-on functions

      

If the ActiveX program version is installed and the Matrix module add-on too you can access the Matrix module functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the Measurement of LED matrix modules dialog. It can be opened with the menu point "Evaluation | Matrix modules application".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Matrix modules software package".


iMatrixModuleOpenDialog() Opens the dialog for Matrix module measurements
iMatrixModuleCloseDialog() Closes the dialog
iMatrixModuleReadParameter() Load a parameter set (*.ini format)
iMatrixModuleExecute() Executes calculation with the loaded parameter set
iMatrixModuleWriteResults() Writes a result file (*.csv format)


Sticking images Level-3 add-on functions

      

If the ActiveX program version is installed and the Sticking images Level-3 add-on too you can access the Sticking images functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the StickingImages 3-Level dialog. It can be opened with the menu point "Evaluation | StickingImages application".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Sticking images software package".


iSI3_OpenDialog() Opens the Sticking images Level-3 dialog
iSI3_CloseDialog() Closes the Sticking images Level-3 dialog
iSI3_LoadProject() Load project file *.stimp
iSI3_SaveProject() Save project file *.stimp
iSI3_StartMeasure() Starts measurement
iSI3_StopMeasure() Stopps measurement
iSI3_SetParameters() Set parameters of measurement
iSI3_GetParameters() Get parameters of measurement
iSI3_LoadParameters() Load parameters of measurement *.ini
iSI3_SaveParameters() Save parameters of measurement *.ini
iSI3_DefaultParameters() Set parameters to default values
iSI3_TeachRegions() Teach regions
iSI3_TeachNonUniformity() Teach nonuniformity


Sticking images Level-2 add-on functions

      

If the ActiveX program version is installed and the Sticking images Level-2 add-on too you can access the Sticking images functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the StickingImages 2-Level dialog. It can be opened with the menu point "Evaluation | StickingImages 2-Level".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Sticking images2 software package".


iSI2_OpenDialog() Opens the Sticking images Level-2 dialog
iSI2_CloseDialog() Closes the Sticking images Level-2 dialog
iSI2_LoadProject() Load project file *.si2
iSI2_SaveProject() Save project file *.*.si2
iSI2_LoadTeachIn() Load TeachIn file *.car
iSI2_SetSchedule() Set schedule of measurement
iSI2_GetSchedule() Get schedule of measurement
iSI2_SetDefaults() Set parameters to default values
iSI2_SetImageDir() Set image saving parameters
iSI2_GetImageDir() Get image saving parameters
iSI2_StartMeasure() Starts measurement
iSI2_StopMeasure() Stopps measurement


Pixel crosstalk add-on functions

      

If the ActiveX program version is installed and the Pixel crosstalk add-on too you can access the Pixel crosstalk functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the Pixel Crosstalk dialog. It can be opened with the menu point "Evaluation | Pixel crosstalk".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Pixel Crosstalk software package".


iPCT_OpenDialog() Opens the Pixel crosstalk dialog
iPCT_CloseDialog() Closes the Pixel crosstalk dialog
iPCT_SetFlags() Set the flags for measurement
iPCT_GetFlags() Get the flags for measurement
iPCT_LoadParameters() Load parameters set from *.ini file
iPCT_SaveParameters() Save parameters set to *.ini file
iPCT_CaptureDarkImage() Capture dark image
iPCT_LoadDarkImage() Load dark image from file
iPCT_CapturePixelImage() Capture pixel image
iPCT_LoadPixelImage() Load pixel image from file
iPCT_ExecAutomatically() Execute all steps automatically


Sparkle add-on functions

      

If the ActiveX program version is installed and the Sparkle add-on too you can access the Sparkle functionality also via ActiveX function calls.
The associated dialog in the LabSoft is the Sparkle measurement dialog. It can be opened with the menu point "Evaluation | Sparkle measurement".
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Sparkle software package".


iSPA_OpenDialog() Opens the Sparkle dialog
iSPA_CloseDialog() Closes the Sparkle dialog
iSPA_Autoscan() Autoscan to get suitable exposure time
iSPA_SetCaptureParam() Set exposure time and count of images
iSPA_GetCaptureParam() Get exposure time and count of images
iSPA_Capture() Capture a luminance image for Sparkle
iSPA_SetCameraParameter() Set capture parameters for Sparkle algorithm
iSPA_GetCameraParameter() Set capture parameters for Sparkle algorithm
iSPA_SetMeasurementRegion() Set measurement region for Sparkle algorithm
iSPA_GetMeasurementRegion() Get measurement region for Sparkle algorithm
iSPA_ReadCarFile() Read camera adjustment result file
iSPA_ReadParameterFile() Read Sparkle parameter file
iSPA_WriteParameterFile() Write Sparkle parameter file
iSPA_SetMovementParameter() Set drive unit movement paramter
iSPA_GetMovementParameter() Get drive unit movement paramter
iSPA_LoopMeasure() Complete measurement (captures and movement)
iSPA_SingleMeasure() Single measure (no capture, no movement)


Template image generator

      

The template image generator is a dialog in the LabSoft program, which can be opened for example
with the menu points "Evaluation | Create a luminance test image" or "Evaluation | Create a color test image.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Template image generator".

In this dialog there are several tabsheets, for example "Adjustment", "Luminance" or "Color".
The name of these tabsheets are used here as categories, for example in method iTIG_GetListOfCategories().

Every tabsheet contains several types of template images. All types of a category can be determined here with iTIG_GetListOfOperations().
If a operation is selected, someone can get ( iTIG_GetListOfParameterNames(), iTIG_GetParameterValue() )
and set ( iTIG_SetParameterValue() ) the parameters.

After this an image can be created by iTIG_CreateImage().
Other methods are available for loading and saving images and parameters. etc.


iTIG_GetNumberTargetDisplays() Number of connected displays
iTIG_SetTarget() Set target for template image generation
iTIG_GetTarget() Get current target for template image generation
iTIG_GetTargetProperties() Get properties of current target
iTIG_GetBorderProperties() Get properties of image border
iTIG_SetBorderProperties() Set properties of image border
iTIG_GetListOfCategories() Get list of categories of template images
iTIG_GetListOfOperations() Get list of types of template images for the given category
iTIG_SetOperation() Set a type of template image or an option
iTIG_IsOperation() Ask, if a type of template image is selected
iTIG_GetListOfParameterNames() Get a parameter name list for the currently selected template image type
iTIG_GetParameterValue() Get a certain parameter value
iTIG_SetParameterValue() Set a certain parameter value
iTIG_ShowDialog() Make template image dialog visible
iTIG_HideDialog() Make template image dialog invisible
iTIG_CreateImage() Create template image with the adjusted parameters
iTIG_DeleteImage() Remove template image from the display
iTIG_LoadParameter() Load file with predefined parameter values
iTIG_SaveParameter() Save file with adjusted parameter values
iTIG_LoadImage() Load template image file to the target
iTIG_SaveImage() Save template image to a file


Access to Motor control add-on

      

The job of the motor control is to provide the computer-controlled movement of a travelling unit or a goniometer.
This only works if the corresponding add-on has been installed.
The Motor control dialog can be opened with a menu point in the "Motors" menu.
The direct use of this functionality in the LabSoft program is described in the manual in chapter "Motor control".


iMotor_ReadIni() Read of ini file with information aboute the axes
iMotor_OpenAxes() Initialisation of all axes
iMotor_NumberOfAxes() Get number of axes
iMotor_GetAxisInfo() Get names, min and max position and speed
iMotor_GetAxisSpeed() Get speed of an axis
iMotor_SetAxisSpeed() Set speed of an axis
iMotor_GetAxisPosition() Get position of an axis
iMotor_SetAxisPosition() Set position of an axis (axis begin to move)
iMotor_IsAxisMoving() Is the axis moving?
iMotor_CloseAxes() Close axes access


Callback signals

There are some callback signals, which can be catched by the user if needed.


vSignalImageContentChanged()

Every time an image is updated, this signal is send with the index of the image.
After this time point the user can read the new image data or call for changed statistic data.

vSignalWaitTrigger()




If the user captures images via the MultiPic, HighDyn or ColorHighdyn algorithm,
it is not clear at which points the next camera image has to be triggered.
And in the case of highdyn captures it is furthermore unclear,
how many camera images needed and has to be triggered.
Thats why before every needed trigger signal this signal is send to the user.

Inherits QObject, and QAxBindable.

Public Slots

int iAdjustColorFactors (int _iIndex, double _dCurrent_R, double _dCurrent_G, double _dCurrent_B, double _dWished_R, double _dWished_G, double _dWished_B)
 Change color factors to adjust to a given color. More...
 
int iAppendEquation (int _iTyp, int _iObject, QString &_qsName, QString &_qsFormula, int _iWhereToShow)
 Append an equation. More...
 
int iAutoFocus (int linear, int adaptive, double &sharpness, double &edge)
 Make autofocus procedure. More...
 
int iAutoScanTime ()
 Determine a good exposure time. More...
 
int iBitmapGetList (QStringList &bitmapList)
 List of all available bitmaps in program (images, graphics, diagrams) More...
 
int iBlackMuraAdjImageCopy ()
 Copy adjustment image from "Camera image" to "Adjustment image". More...
 
int iBlackMuraAutomaticMeasure (int _iBrightImage, int _iDarkImage, double _dTimeDelay)
 Automatic measurement using DVI interface for the display to be measured. More...
 
int iBlackMuraBrightCapture ()
 Makes a BlackMura bright capture and calculates results. More...
 
int iBlackMuraBrightLoad (QString _qFileName)
 Load a bright image and calculates results. More...
 
int iBlackMuraCloseDialog ()
 Closes the dialog for BlackMura measurements. More...
 
int iBlackMuraDarkCapture ()
 Makes a BlackMura dark capture and calculates results.
 
int iBlackMuraDarkLoad (QString _qFileName)
 Load a dark image and calculates results. More...
 
int iBlackMuraGetDstDirectory (QString &_qrDstDirectory)
 Get the destination directory for saving images. More...
 
int iBlackMuraGetFlagsProject (int &_irShowCoord, int &_irShowMeasurementRegion, int &_irShowAdjustmentRegions, int &_irShowBrightClassification)
 Get flags for DarkMura project. More...
 
int iBlackMuraGetMeasureFlags (int &_irShowDarkClassification, int &_irSaveAutomatically)
 Get flags for DarkMura measurement. More...
 
int iBlackMuraGetProjectFileName (QString &_qrFileName)
 Get BlackMura project file name. More...
 
int iBlackMuraGetSerialNumber (QString &_qrSerialNumber)
 Get the serial number of next display to examine. More...
 
int iBlackMuraLoadAdjFile (QString _qFileName)
 
int iBlackMuraLoadProject (QString _qFileName)
 Loads BlackMura project file. More...
 
int iBlackMuraOpenDialog ()
 Opens the dialog for BlackMura measurements.
 
int iBlackMuraSaveProject (QString _qFileName)
 Saves BlackMura project file. More...
 
int iBlackMuraSetDstDirectory (QString _qDstDirectory)
 Set the destination directory for saving images. More...
 
int iBlackMuraSetFlagsProject (int _iShowCoord, int _iShowMeasurementRegion, int _iShowAdjustmentRegions, int _iShowBrightClassification)
 Set flags for DarkMura project. More...
 
int iBlackMuraSetMeasureFlags (int _iShowDarkClassification, int _iSaveAutomatically)
 Set flags for DarkMura measurement. More...
 
int iBlackMuraSetSerialNumber (QString _qSerialNumber)
 Set the serial number of next display to examine. More...
 
int iCamera_Firmware (int &fpga, int &firmware, int &build, int &lens)
 Get version of firmware in camera and lens. More...
 
int iCamera_GetFocusAndContrast (int _iTop, int _iLeft, int _iBottom, int _iRight, double &_drFocus, double &_drContrast)
 Get Focus and contrast information of a region in the camera image. More...
 
int iCamera_GetOverdriveRegion (int &_irUseRegion, int &_irTop, int &_irBottom, int &_irLeft, int &_irRight)
 Get the region, which is used for overdrive control. More...
 
int iCamera_GetParameter (QString _qName, QString &_qrValue)
 Read some additional camera properties. More...
 
int iCamera_GetSaturation (int _iWholeImage, int _iTop, int _iLeft, int _iBottom, int _iRight, double &_drSaturation)
 Get saturation information of camera image or region in camera image. More...
 
int iCamera_List (QStringList &list)
 List of camera and lens calibration data for this installation. More...
 
int iCamera_SetOverdriveRegion (int _iUseRegion, int _iTop, int _iBottom, int _iLeft, int _iRight)
 Set the region, which is used for overdrive control. More...
 
int iCameraSetupDialogClose ()
 Closes the dialog "Camera set-up. More...
 
int iCameraSetupDialogOpen ()
 Opens the dialog "Camera set-up. More...
 
int iCameraSetupLoadProject (QString _qFileName)
 Load predefined project file. More...
 
int iCameraSetupMeasurementStart (int _iLuminanceImage)
 Start measurement in camera or luminance image. More...
 
int iCameraSetupMeasurementStop ()
 Stop measurement in camera or luminance image. More...
 
int iCameraSetupResultCircles (int &success, QStringList &middle_x, QStringList &middle_y, QStringList &radius)
 Get position of circles found in image. More...
 
int iCameraSetupResultGeo (int &success, double &optical_x_pix, double &optical_x_mm, double &optical_y_pix, double &optical_y_mm, double &horizontal, double &vertical, double &axial, double &repro_x, double &repro_y)
 Get results of geometric adjustment. More...
 
int iCameraSetupResultPhoto (int &success, double &minimum, double &maximum, QStringList &vertical, QStringList &horizontal)
 Get results of geometric adjustment. More...
 
int iCameraSetupSaveResult (QString _qFileName)
 Save calculated results. More...
 
int iCaptureGetLastInfo (int &_irSuccess, int &_irAlgorithm, QString &_qrGreyFilter, QString &_qrColorFilter, int &_ulpPicCount, double &_drMaxTime, double &_drMintTime, double &_drOverflow, double &_drMaxLoad, double &_drCaptureTime, int &_irSmear, double &_drFrequency)
 Determine information about the preceeding capture. More...
 
int iChangeRegion (int _iList, int _iIndex, int _iNumPoints, QStringList &_slX, QStringList &_slY)
 Set the properties of a region. More...
 
int iClearUndoRegionList (int _iList)
 Delete the undo stack of region list (saves memory and time) More...
 
int iClose (int _iQuestion)
 Closes the Lmk4 application. More...
 
int iColorAutoScanTime (QStringList &_qslExposureTimes)
 Determine good exposure times for every color filter. More...
 
int iColorCaptureHighDyn (QStringList &_qslExposureTimes, double _dStartRatio, double _dFactor, int _iCountPic)
 Capturing of color images with the HighDyn algorithm. More...
 
int iColorCaptureMultiPic (QStringList &_qslExposureTimes, int _iCountPic)
 Capturing of color images with the MultiPic algorithm. More...
 
int iColorDiffImgCol (int _iSrcColorImage1, QStringList &_qslColor2inRGB, int _iDstGreyImage, int _iColorDifferenceType, double _dMinimumLuminance, int _iSmoothing, QStringList &_qslParameter)
 Calculate a color difference to a reference color. More...
 
int iColorDiffImgImg (int _iSrcColorImage1, int _iSrcColorImage2, int _iDstGreyImage, int _iColorDifferenceType, double _dMinimumLuminance, int _iSmoothing, QStringList &_qslParameter)
 Calculate a color difference between two images. More...
 
int iColorHighDynPic (double _dMaxTime, double _dMinTime, double _dFactor, int _iSmear, double _dModFrequency)
 HighDyn-Farbbild-Aufnahme. More...
 
int iColorHighDynPic2 (double _dMaxTime, double _dMinTime, double _dFactor, int _iPicCount)
 HighDyn capturing for color image. More...
 
int iConvertCameraCalibrationData (int _iDestinationType, QString _qSourcePath, QString _qDestinationPath)
 Convert camera calibration data. More...
 
int iCoordinateTransformationF (int srcImage, QString xIndexImage, QString yIndexImage, int targetImage)
 Coordinate transformation with two index images. More...
 
int iCoordinateTransformationI (int srcImage, int xIndexImage, int yIndexImage, int targetImage)
 Coordinate transformation with two index images. More...
 
int iCoordSystemCoordToPixel (int _iImage, double _dCoordXorPhi, double _dCoordYorRadius, double &_drPixelX, double &_drPixelY)
 Convert coordinates to pixel indices. More...
 
int iCoordSystemGetCartesian (int _iImage, int &_irIsCartesian, double &_drScalingX, double &_drOffsetX, double &_drScalingY, double &_drOffsetY)
 Set the parameter of a cartesian system. More...
 
int iCoordSystemGetPolar (int _iImage, int &_irIsPolar, double &_drXm, double &_drYm, double &_drFactorR, double &_drFactorP, double &_drOffsetP)
 Set the parameter of a polar system. More...
 
int iCoordSystemGetValueUnit (int _iImage, QString &_qrValueX, QString &_qrUnitX, QString &_qrValueY, QString &_qrUnitY, QString &_qrUnitArea)
 Get the values and units of the axi. More...
 
int iCoordSystemPixelToCoord (int _iImage, double _dPixelX, double _dPixelY, double &_drCoordXorPhi, double &_drCoordYorRadius)
 Convert pixel indices to coordinates. More...
 
int iCoordSystemReadFile (int _iImage, QString _qFileName)
 Read parameter from a file. More...
 
int iCoordSystemSetCartesian (int _iImage, double _dScalingX, double _dOffsetX, double _dScalingY, double _dOffsetY)
 Set the parameter of a cartesian system. More...
 
int iCoordSystemSetPolar (int _iImage, double _dXm, double _dYm, double _dFactorR, double _dFactorP, double _dOffsetP)
 Set the parameter of a polar system. More...
 
int iCoordSystemSetValueUnit (int _iImage, QString _qValueX, QString _qUnitX, QString _qValueY, QString _qUnitY, QString _qUnitArea)
 Set the values and units of the axi. More...
 
int iCoordSystemWriteFile (int _iImage, QString _qFileName)
 Write parameter into a file. More...
 
int iCopyColorFactors (int _iSrcIndex, int _iDstIndex)
 Copy factors from one set to another. More...
 
int iCreateGroup (int _iList, int _iGroupType, int _iNumRegions, QStringList &_slRegionIndices)
 Creates a group. More...
 
int iCreateRegion (int _iList, int _iType, int _iNumPoints, QStringList &_slX, QStringList &_slY)
 Create a region. More...
 
int iCreateStatistic (int _iTyp, int _iImage, int _iRegion, int _iNumberParam, QStringList &_slrParamList)
 Create a new statistic. More...
 
int iDatabaseClose ()
 Closes the currently opened database. More...
 
int iDatabaseImageOptionsGet (int &_irSaveMode, QString &_qrDirectory)
 Get the options for saving images. More...
 
int iDatabaseImageOptionsSet (int _iSaveMode, QString _qDirectory)
 Set the options for saving images. More...
 
int iDatabaseOpen (QString _qDatabaseName, QString _qUserName, QString _qPassword)
 Opens a database for read / write access. More...
 
int iDatasetCopy (int _iSrcContentId, QString _qDstDatabaseName, QString _qDstUserName, QString _qDstPassword, int &_irDstContentId)
 Copy a dataset to another database. More...
 
int iDatasetDelete (int _iContentId)
 Delete a dataset in database. More...
 
int iDatasetInfo (int _iContentId, int &_irType, QString &_qrCreated, QString &_qrChanged, QString &_qrUser, int &_irImages, int &_irCompressionMode, QString &_qImageDirectory, QString &_qDescription)
 Common informations about a dataset. More...
 
int iDatasetList (int _iTypeOfSets, int &_irNumber, QStringList &_qslContentIds, QStringList &_qslTypes)
 Get a list of datasets in the database. More...
 
int iDatasetRead (int _iContentId)
 Read a dataset from the database into LabSoft. More...
 
int iDatasetUserTableInfo (int &_irNumberEntries, QStringList &_qslNameList, QStringList &_qslCaptionList, QStringList &_qslTypes, QStringList &_qslDefaults, QStringList &_qslComments)
 Get informations about construction of the user table. More...
 
int iDatasetUserTableRead (int _iContentId, QStringList &_qslNames, QStringList &_qslValues)
 Read informations of a dataset from the user table. More...
 
int iDatasetUserTableWrite (int _iContentId, QStringList &_qslNames, QStringList &_qslValues)
 Write informations of a dataset into the user table. More...
 
int iDatasetWrite (int _iType, QString _qDescription, int &_irContentId)
 Write a dataset from LabSoft to the database. More...
 
int iDefaultColorFactors (int _iIndex)
 Reset color factor set = set to default values. More...
 
int iDeleteEquation (int _iTyp, int _iObject, int _iEquation)
 Delete an equation. More...
 
int iDeleteGroup (int _iList, int _iRegionIndex)
 Ungroup action. More...
 
int iDeleteRegion (int _iList, int _iIndex)
 Delete a region. More...
 
int iDeleteStatistic (int _iTyp, int _iObject)
 Delete an existing statistic. More...
 
int iExcelClose ()
 Close Excel program. More...
 
int iExcelCopyItem (int _iIndex)
 Copy one item to Excel. More...
 
int iExcelCopySelected ()
 Copy all selected items to Excel. More...
 
int iExcelGetItemProperties (int _iIndex, int &_irType, QString &_qrName, QString &_qrSheet, int &_irClear, QString &_qrRange, int &_irSelected)
 Get the informations about a data entry. More...
 
int iExcelGetNumberItems (int &_irNumber)
 Get number of data entries in Excel dialog. More...
 
int iExcelOpenFile (QString _qFileName)
 Open an Excel file for data export. More...
 
int iExcelSave ()
 Save Excel file. More...
 
int iExcelSelectAll ()
 Select all items in Excel dialog. More...
 
int iExcelSetItemProperties (int _iIndex, QString _qSheet, int _iClear, QString _qRange, int _iSelect)
 Set the informations about a data entry. More...
 
int iExcelSetVisible (int _iVisible)
 Change visbility of Excel program. More...
 
int iExcelUnselectAll ()
 Unselect all items in Excel dialog. More...
 
int iExecMenuPoint (QString _qMenuPoint)
 Execute any menu items of the Lmk4 program. More...
 
int iExecTclCommand (QString _qCommand, int &_irReturn, QString &_qResult)
 Execute a TCL command by the embedded tcl interpreter. More...
 
int iExportBitmapToFile (QString bitmapName, QString fileName)
 Export a bitmap of a image, graphic or diagram to a bitmap file. More...
 
int iGetAperture (int &value)
 Get current aperture vaue. More...
 
int iGetArcObjectResults (int _iObject, int _iClass, double &_drLength, double &_drWidth, double &_drDeflection, double &_drAbsMax)
 Get the results of an arc object in a grey image. More...
 
int iGetArcObjectValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrY, QStringList &_slrValues)
 Get the values of the lightarc in a grey image. More...
 
int iGetAutomatic (int &_irAutomatic)
 Get the state of Automatic-Flag for exposure times. More...
 
int iGetAutoscan (int &_irAutoscan)
 Get use of autoscan algorithm. More...
 
int iGetCameraLensPath (QString &_qrCameraLensPath)
 Returns path to current camera lens combination. More...
 
int iGetCameraParameter (QString _qParameterName, QString &_qrParameterValue)
 Read access to camera parameter. More...
 
int iGetClass (int _iTyp, int _iObject, int _iClass, QString &_qsClassName, int &_irVisible)
 Get name and visibility of class. More...
 
int iGetColor (double _iInputR, double _iInputG, double _iInputB, double _iReferenceR, double _iReferenceG, double _iReferenceB, int _iColorSpace, double &_iOutputColor1, double &_iOutputColor2, double &_iOutputColor3)
 
int iGetColorCorrList (QStringList &_qList, QStringList &_qSelected)
 List of available color correction factors. More...
 
int iGetColorFactorsList (QStringList &_qList, int &_iSelect)
 List of available color matrices. More...
 
int iGetColorFactorsName (int _iIndex, QString &_qrName)
 Get name of color factor set. More...
 
int iGetColorFactorsSize (int &_irNumber)
 Number of color factor sets. More...
 
int iGetColorHistogramValues (int _iObject, int _iColor, int &_irNumber, QStringList &_slrX, QStringList &_slrValues)
 Get the values of the histogram in a color image. More...
 
int iGetColorProjectionValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrY, QStringList &_slrValues1, QStringList &_slrValues2, QStringList &_slrValues3)
 Get the values of the projection in a color image. More...
 
int iGetColorRGB (int _iColorSpace, double _dInput1, double _dInput2, double _dInput3, double _dReferenceR, double _dReferenceG, double _dReferenceB, double &_dOutputColorR, double &_dOutputColorG, double &_dOutputColorB)
 Conversion of a color value from a color space to CIE-RGB. More...
 
int iGetColorSecViewValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrY, QStringList &_slrValues1, QStringList &_slrValues2, QStringList &_slrValues3)
 Get the values of the sectional view in a color image. More...
 
int iGetConvertingUnits (QString &_qName, QString &_qUnit, double &_dFactor)
 Get converting informations. More...
 
int iGetDarkening (int &_iDarkening, int &_iSwitchMonitorOff, double &_dTimeOut)
 Get the state of darkening computer monitor while capturing. More...
 
int iGetEquation (int _iTyp, int _iObject, int _iEquation, QString &_qsName, QString &_qsFormula, int &_iWhereToShow, int &_irValid, double &_drResult)
 Get an equation and its result. More...
 
int iGetErrorInformation (QString &_rErrorInformation)
 More precisely error description. More...
 
int iGetFilterWheel (int &_irCurrentFilter, QString &_srCurrentFilter)
 Determine filter state. More...
 
int iGetFlagsStatistic (int _iTyp, int _iObject, int &_irGeo, int &_irPhoto, int &_irMinMax, int &_irTime, int &_irHorseshoe)
 Get Flags for statistic evaluations. More...
 
int iGetFlagsStatistic2 (int _iTyp, int _iObject, int &_irGeo, int &_irPhoto, int &_irMinMax, int &_irTime, int &_irMaxCountTime, int &_irHorseshoe)
 Get Flags for statistic evaluations. More...
 
int iGetFocus (double &value)
 Get current focus position. More...
 
int iGetFocusFactorList (QStringList &_qList, int &_iSelect)
 List of available focus factors. More...
 
int iGetFocusParameter (int &subsampling, int &top, int &bottom, int &left, int &right)
 Get parameter for autofocus. More...
 
int iGetGeometricStatistic (int _iTyp, int _iObject, int _iClass, double &_drX, double &_drY)
 Get geometric center of object or class. More...
 
int iGetGreyFilterList (QStringList &_qList, QStringList &_qSelected)
 List of available grey filters. More...
 
int iGetGreyHistogramValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrValues)
 Get the values of the histogram in a grey image. More...
 
int iGetGreyProjectionValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrY, QStringList &_slrValues)
 Get the values of the projection in a grey image. More...
 
int iGetGreySecViewValues (int _iObject, int &_irNumber, QStringList &_slrX, QStringList &_slrY, QStringList &_slValues)
 Get the values of the sectional view in a grey image. More...
 
int iGetImageCaptureParameter (int _iImage, int &_irHaveParam, QStringList &_qslParamNames, QStringList &_qslParamValues)
 Get information of last capture to this image. More...
 
int iGetImageName (int _iImageIndex, QString &_qsImageName)
 Determines the name of an image. More...
 
int iGetIndexOfImage (QString _qName, int &_irIndex)
 Get index of image given image name. More...
 
int iGetIndexOfRegion (int _iList, QString _qName, int &_irIndex)
 Get index of region given region name. More...
 
int iGetIntegrationTime (double &_drCurrentTime, double &_drPreviousTime, double &_drNextTime, double &_drMinTime, double &_drMaxTime)
 Determine current exposure time and other time parameters. More...
 
int iGetLensID (QString &lensID)
 Get ID of lens. More...
 
int iGetMaxCameraTime (double &_drMaxCameraTime)
 Determine the maximum possible exposure time. More...
 
int iGetMinMaxAperture (int &minimum, int &maximum)
 Get range of aperture values. More...
 
int iGetMinMaxStatistic (int _iTyp, int _iObject, int _iClass, double &_drMinX, double &_drMinY, double &_drMinV, double &_drMaxX, double &_drMaxY, double &_drMaxV)
 Get photometric center of object or class. More...
 
int iGetModulationFrequency (double &_drModFrequency)
 Get the modulation frequency. More...
 
int iGetNumberImages (int &_irNumber)
 Determine number of evaluation images. More...
 
int iGetNumClasses (int _iTyp, int _iObject, int &_irNumClasses)
 Get the number of classes. More...
 
int iGetNumEquations (int _iTyp, int _iObject, int &_irNumEquations)
 Get the number of line equations. More...
 
int iGetPermanentImageName (int _iImageIndex, QString &_qsImageName)
 Determines the name of an image. More...
 
int iGetPhotometricStatistic (int _iTyp, int _iObject, int _iClass, double &_drX, double &_drY)
 Get photometric center of object or class. More...
 
int iGetPositionRegionName (int list, int index, int &position)
 Read position of region name. More...
 
int iGetProgramInfo (QString &_qrProgramType, QString &_qrProgramVersion, QString &_qrCameraType, QString &_qrCameraNumber, QString &_qrLensNumber)
 Get some information about program version and camera current used. More...
 
int iGetPropertiesRegion (int _iList, int _iIndex, int &_irType, int &_irPoints, QStringList &_slX, QStringList &_slY)
 Get the properties of a region. More...
 
int iGetQuantilObjectResults (int _iObject, double &_drQuantile1, double &_drQuantile2, double &_drQuantile3)
 Get the results of an quantile object in a grey image. More...
 
int iGetRawFocus (int &value)
 Get current focus position. More...
 
int iGetRawMinMaxFocus (int &minimum, int &maximum)
 Get range of focus values. More...
 
int iGetRecalibrationFactor (double &_dFactor)
 Get recalibration factor. More...
 
int iGetRegionListSize (int _iList, int &_irSize)
 Determine the number of regions in a list. More...
 
int iGetRegionName (int _iList, int _iIndex, QString &_qrName)
 Read region name. More...
 
int iGetScatteredLight (int &_irScatteredLight)
 Is scattered light correction switched on? More...
 
int iGetSelectedImage (int &image)
 Index of current image on top. More...
 
int iGetSmear (int &_irSmear)
 Get the parameter for smear correction. More...
 
int iGetStandardStatistic (int _iStatistic, int _iObject, int _iClass, int &_irSize, double &_drMin, double &_drMax, double &_drMean, double &_drVar)
 Determine parameter of the standard statistic. More...
 
int iGetStandardStatistic2 (int _iStatistic, int _iObject, int _iClass, double &_drArea, double &_drMin, double &_drMax, double &_drMean, double &_drVar)
 Determine parameter of the standard statistic. More...
 
int iGetStatisticObject (int _iStatistic, int _iObject, int &_iImage, int &_iRegion)
 Determine image and region a statistic object is calculated for. More...
 
int iGetStatisticParameter (int _iTyp, int _iObject, int &_irNumberParam, QStringList &_slrParamList)
 Read the parameters of a statistic. More...
 
int iGetStatisticSize (int _iStatistic, int &_irSize)
 Determine number of objects in a statistic vector. More...
 
int iGetSuppressOverflow (int &_irSuppress)
 Get the state of suppress overflow warning in measurement series. More...
 
int iGetSuppressProgressDialog (int &_irSuppress)
 Get the state of suppressing view of progress dialog. More...
 
int iGetTimeSizeStatistic (int _iTyp, int _iObject, int &_irSize)
 Number of elements of a time statistics. More...
 
int iGetTimeSummaryStatistic (int _iTyp, int _iObject, int _iClass, int _iWhichEl, int &_irCount, double &_drMin, double &_drMax, double &_drMean, double &_drVar)
 Summary of a time statistics. More...
 
int iGetTimeValuesStatistic (int _iTyp, int _iObject, int _iClass, int _iWhichEl, QStringList &_qslTime, QStringList &_qslValues)
 List of time statistic times and values. More...
 
int iGetTrigger (int &type)
 Is trigger mode switched on or off for Lmk6 camera? More...
 
int iGetTriggerCommonParameter (double &timeout, double &capturedistance, double &exposuredelay, int &triggerhigh, int &strobehigh)
 Get common trigger parameter for Lmk6 camera. More...
 
int iGetTriggerImageParameter (int &top, int &bottom, int &left, int &right, int &reserved, int &level, double &exposure)
 Get image trigger parameter for Lmk6 camera. More...
 
int iGetTriggerMode (int &_irTriggerMode, double &_drTimeout)
 Is trigger mode switched on? More...
 
int iGetTriggerStrobeParameter (int &parametrizable, double &delay, double &duration)
 Get strobe trigger parameter for Lmk6 camera. More...
 
int iGetViewPalette (int image, int &palette)
 Get index of used palette. More...
 
int iGetViewScaling (int image, double &scaling, double &minimum, double &maximum)
 Get used scaling of image view. More...
 
int iGetViewScalingRect (int image, int &top, int &bottom, int &left, int &right)
 Get used scaling rectangle of image view. More...
 
int iGetViewZoom (int image, double &zoom, int &top, int &left)
 Get current zooming parameters. More...
 
int iGrab ()
 
int iHaveControllableLens (int &have)
 Controllable lens connected ? More...
 
int iHaveStatistic (int _iImage, int _iRegion, int &_irHave, int &_irType, int &_irIndex)
 Proof, if a statistic exists for a image / region / statistic type. More...
 
int iHighDynPic (double _dMaxTime, double _dMinTime, double _dFactor, int _iSmear, double _dModFrequency)
 HighDyn-Leuchtdichtebild-Aufnahme. More...
 
int iHighDynPic2 (double _dMaxTime, double _dMinTime, double _dFactor, int _iPicCount)
 HighDyn capturing for luminance image. More...
 
int iHighDynPic3 (double _dExposureTime, double _dStartRatio, double _dFactor, int _iCountPic)
 HighDyn capturing for luminance image. More...
 
int iImageCreate (int _iColorImage, QString _qImageName, int &_irIndex)
 Creates an evaluation image. More...
 
int iImageDelete (int _iIndex)
 Deletes an evaluation image. More...
 
int iImageGetDumpToFile (int _iImage, int _iFirstLine, int _iLastLine, int _iFirstColumn, int _iLastColumn, QString _FileName)
 Get a memory dump of a image region into a file. More...
 
int iImageGetDumpToMemory (int _iImage, int _iFirstLine, int _iLastLine, int _iFirstColumn, int _iLastColumn, QByteArray &_rDump)
 Get a memory dump of a image region into memory. More...
 
int iImageGetPixelColor (int _iImage, int _iLine, int _iColumn, double &_drRed, double &_drGreen, double &_drBlue)
 Get a pixel value of a color image. More...
 
int iImageGetPixelGrey (int _iImage, int _iLine, int _iColumn, double &_drValue)
 Get a pixel value of a grey image. More...
 
int iImageGetRefColorInRGB (int _iImage, double &_drRed, double &_drGreen, double &_drBlue)
 Get the reference color of an image. More...
 
int iImageGetSize (int _iImage, int &_irFirstLine, int &_irLastLine, int &_irFirstColumn, int &_irLastColumn, int &_irDimensions)
 Get image size and parameter. More...
 
int iImageSetRefColorInRGB (int _iImage, double _dRed, double _dGreen, double _dBlue)
 Set the reference color of an image. More...
 
int iImageSetSize (int _iIndex, int _iFirstLine, int _iLastLine, int _iFirstColumn, int _iLastColumn)
 Changes the size of an existing image. More...
 
int iImportHDF5Protocol (QString _qPathName)
 Import a HDF5 protocol. More...
 
int iIsOpen ()
 Application is running? More...
 
int iIsRegionSelected (int _iList, int _iRegion, int &_irIsSelected)
 Is a region selected? More...
 
int iIsTriggerAvailable (int &interntrigger, int &externtrigger, int &imagetrigger)
 Which trigger modi for Lmk6 camera are available? More...
 
int iLensInit ()
 Reinitialize controllable lens.
 
int iLEXanglesFromImage ()
 Set angle area from image coordinate system. More...
 
int iLEXanglesFromSelRect ()
 Set angle area from selected rectangle coordinate system. More...
 
int iLEXcloseDialog ()
 Closes dialog for LID export into a file. More...
 
int iLEXexecute (QString _qFileName)
 Export of LID into a file. More...
 
int iLEXgetAngles (double &_dThetaTop, double &_dThetaBottom, double &_dThetaDelta, double &_dPhiMin, double &_dPhiMax, double &_dPhiDelta)
 
int iLEXopenDialog ()
 Opens dialog for LID export into a file.
 
int iLEXsetAngles (double _dThetaTop, double _dThetaBottom, double _dThetaDelta, double _dPhiMin, double _dPhiMax, double _dPhiDelta)
 Select angle area for export file. More...
 
int iLEXsetCoordSystem (QString _qSrcCoordSystem, QString _qDstCoordSystem)
 Types of coordinate system orientation used. More...
 
int iLEXsetDescription (QString _qDescription, QString _qNumber, QString _qLaboratory, QString _qManufactory, QString _qUserName)
 Descriptions for export file. More...
 
int iLEXsetImage (QString _qImageName)
 
int iLEXsetOrigin (double _dThetaDiff, int _iThetaSign, double _dPhiDiff, int _iPhiSign)
 Modification of origin of coordinate system. More...
 
int iLEXsetParameter (double _dTemperatur, double _dWattage, double _dVoltage, double _dCurrent, double _dLightFlux)
 Parameters for export file. More...
 
int iLIDcloseDialog ()
 Closes LID dialog. More...
 
int iLIDexecute (int _iIndex)
 Executes a LID calculation with one of the parameter set. More...
 
int iLIDgetCountParam (int &_iCount)
 Get number of available parameter set in LID calculation dialog. More...
 
int iLIDgetParamName (int _iIndex, QString &_qParamName)
 Get name of a parameter set in LID calculation dialog. More...
 
int iLIDMergeCaptureProcess (int _iLIDIndex, double _dPhiMin, double _dPhiMax, double _dPhiStep, double _dThetaMin, double _dThetaMax, double _dThetaStep, int _iShowPositioningMessageBoxes)
 Captures a big LID image out of several images. More...
 
int iLIDopenDialog (QString _qFileName)
 Opens dialog for LID calculation. More...
 
int iLoadCaptureParameterSet (QString _qParameterSet)
 Load predefined parameter set for the next captures. More...
 
int iLoadImage (int _iNumber, QString _qFileName)
 Load image. More...
 
int iLoadIsoPalette (int image, QString filename)
 Load iso color palette from a file. More...
 
int iLoadProtokoll (QString _qPathName)
 Load a protocol from a file. More...
 
int iLoadRegionList (int _iList, QString _qFileName, int _iOverwrite)
 Load region list. More...
 
int iLoadRegionListCS (int _iList, QString _qFileName, int _iOverwrite)
 Load region list in units of coordinate system. More...
 
int iLoadUserPalette (int image, QString filename)
 Load iso color palette from a file. More...
 
int imageArithmeticI (QString _qCode, int _iSrcImage, int _iDstImage)
 Image arithmetic with one source image and one destination image. More...
 
int imageArithmeticII (QString _qCode, int _iSrcImage1, int _iSrcImage2, int _iDstImage)
 Image arithmetic with two source images and one destination image. More...
 
int imageArithmeticIP1 (QString _qCode, int _iSrcImage, QString _qParameter, int _iDstImage)
 Image arithmetic with one source image, one parameter and one destination image. More...
 
int imageArithmeticIP3 (QString _qCode, int _iSrcImage, QString _qRed, QString _qGreen, QString _qBlue, int _iDstImage)
 Image arithmetic with one source image, three color parameter and one destination image. More...
 
int iMatrixModuleCloseDialog ()
 Closes the dialog for Matrix module measurements. More...
 
int iMatrixModuleExecute ()
 Executes calculation with the current parameter set. More...
 
int iMatrixModuleOpenDialog ()
 Opens the dialog for Matrix module measurements. More...
 
int iMatrixModuleReadParameter (QString filename)
 Load a parameter set (*.ini format) More...
 
int iMatrixModuleWriteResults (QString filename)
 Writes a result file (*.csv format) More...
 
int iMergeColorImage (int _iSrcGreyImage1, int _iSrcGreyImage2, int _iSrcGreyImage3, int _iDstColorImage, int _iColorSpace)
 Create a color image from color extracts. More...
 
int iMotor_CloseAxes ()
 Close axes access. More...
 
int iMotor_GetAxisInfo (int index, QString &name, double &minposition, double &normposition, double &maxposition, double &minspeed, double &normspeed, double &maxspeed)
 Get names, min and max of an axis. More...
 
int iMotor_GetAxisPosition (int index, double &position)
 Get position of an axis. More...
 
int iMotor_GetAxisSpeed (int index, double &speed)
 Get speed of an axis. More...
 
int iMotor_IsAxisMoving (int index, int &moving)
 Is the axis moving? More...
 
int iMotor_NumberOfAxes (int &number)
 Get number of axes. More...
 
int iMotor_OpenAxes ()
 Initialisation of all axes. More...
 
int iMotor_ReadIni (QString filename)
 Read of ini file with information about the axes. More...
 
int iMotor_SetAxisPosition (int index, double position)
 Set position of an axis (axis begin to move) More...
 
int iMotor_SetAxisSpeed (int index, double speed)
 Set speed of an axis. More...
 
int iMoveRegion (int _iList, int _iRegionIndex, double _dX, double _dY)
 Move a region the wished distance. More...
 
int iMultiPic (double _dExposureTime, int _iCountPic, int _iSmear, double _dModFrequency)
 MultiPic capture algorithm. More...
 
int iMultiPic2 (double _dExposureTime, int _iCountPic)
 MultiPic capture algorithm. More...
 
int iOpen ()
 Opens the Lmk4 application. More...
 
int iOpenRegisterFile (QString _qFileName, int _iMode)
 Open register file. More...
 
int iOpenRegisterMapFile (QString _qFileName)
 Open register map file. More...
 
int iParamStatistics_Connect (int _iType, int _iFirstIndex, int _iSecondIndex)
 Take the statistic parameter of one object over to another. More...
 
int iParamStatistics_Disconnect (int _iType, int _iIndex)
 Separate the statistic parameter set of one object. More...
 
int iParamStatistics_GetName (int _iType, int _iIndex, QString &_qsName)
 Get the name of a parameter set. More...
 
int iParamStatistics_SetName (int _iType, int _iIndex, QString _qsNewName)
 Set the name of a parameter set. More...
 
int iPCT_CaptureDarkImage ()
 Capture dark image.
 
int iPCT_CapturePixelImage ()
 Capture pixel image.
 
int iPCT_CloseDialog ()
 Closes the Pixel crosstalk dialog.
 
int iPCT_ExecAutomatically ()
 Execute all steps automatically.
 
int iPCT_GetFlags (int &createTemplate, int &darkCapture, int &pixelCapture, int &red, int &green, int &blue, int &white)
 Get flags for Pixel crosstalk measurement. More...
 
int iPCT_LoadDarkImage (QString filename)
 Load dark image from file. More...
 
int iPCT_LoadParameters (QString filename)
 Load parameters set from *.ini file. More...
 
int iPCT_LoadPixelImage (QString filename)
 Load pixel image from file. More...
 
int iPCT_OpenDialog ()
 Opens the Pixel crosstalk dialog.
 
int iPCT_SaveParameters (QString filename)
 Save parameters set to *.ini file. More...
 
int iPCT_SetFlags (int createTemplate, int darkCapture, int pixelCapture, int red, int green, int blue, int white)
 Set flags for Pixel crosstalk measurement. More...
 
int iPing ()
 
int iProjectiveRectification (int srcimage, QString parameterfile, int dstimage)
 Projective rectification of an image. More...
 
int iReadFromStatusLine (QString &_qMessage)
 Read a string from the status line of the program. More...
 
int iReadIniFileEntries (QString _qFileName, QString _qSection, QStringList &_qslEntries)
 Read list of entries in a section of an inifile. More...
 
int iReadIniFileEntry (QString _qFileName, QString _qSection, QString _qEntry, QString _qDefault, QString &_qValue)
 Read value of an entry in a section of an inifile. More...
 
int iReadIniFileSections (QString _qFileName, QStringList &_qslSections)
 Read list of sections in an inifile. More...
 
int iReadPhysicalRegister (int _iRegister, int &_irValue)
 Read physical register of camera. More...
 
int iReadRegisterMap (QString _qRegisterName, int &_irValue)
 read register value More...
 
int iReFocus (double &sharpness, double &edge)
 Make autofocus procedure in a small range around the last good value. More...
 
int iResetTimeStatistic (int _iTyp, int _iObject)
 Reset a time statistic. More...
 
int iSaveColorFactorsFile ()
 Save color factors file to use at next program start. More...
 
int iSaveImage (int _iNumber, QString _qFileName)
 Save image. More...
 
int iSaveImageRegion (int _iImage, int _iRegion, QString _qFileName)
 Save image region. More...
 
int iSaveProtokoll (QString _qPathName)
 Save a protocol into a file. More...
 
int iSaveRegionList (int _iList, QString _qFileName, int _iOverwrite)
 Save region list. More...
 
int iSaveRegionListCS (int _iList, QString _qFileName, int _iOverwrite)
 Save region list in units of coordinate system. More...
 
int iSelectImage (int _iIndex)
 Bring image to front in LabSoft. More...
 
int iSelectRegion (int _iList, int _iRegion, int _iSelected)
 Selects or deselects a region. More...
 
int iSetAperture (int value)
 Set aperture value. More...
 
int iSetAutomatic (int _iAutomatic)
 Set Automatic-Flag for all exposure times. More...
 
int iSetAutoscan (int _iAutoscan)
 Set use of autoscan algorithm. More...
 
int iSetCameraParameter (QString _qParameterName, QString &_qrParameterValue)
 Write access to camera parameter. More...
 
int iSetClass (int _iTyp, int _iObject, int _iClass, QString _qsClassName, int _iVisible)
 Set name and visibility of class. More...
 
int iSetColorCorr (int _iIndex, int _iSelect)
 Selection of a color correction factor. More...
 
int iSetColorFactors (int _iIndex)
 Set a color matrix. More...
 
int iSetConvertingUnits (QString _qName, QString _qUnit, double _dFactor)
 Set new converting values. More...
 
int iSetDarkening (int _iDarkening, int _iSwitchMonitorOff, double _dTimeOut)
 Darkening computer monitor while capturing. More...
 
int iSetFilterWheel (int _iCurrentFilter)
 Set new filter position. More...
 
int iSetFlagsStatistic (int _iTyp, int _iObject, int _iGeo, int _iPhoto, int _iMinMax, int _iTime, int _iHorseshoe)
 Set Flags for statistic evaluations. More...
 
int iSetFlagsStatistic2 (int _iTyp, int _iObject, int _iGeo, int _iPhoto, int _iMinMax, int _iTime, int _iMaxCountTime, int _iHorseshoe)
 Set Flags for statistic evaluations. More...
 
int iSetFocus (double value)
 Set focus position. More...
 
int iSetFocusFactor (int _iIndex)
 Set a focus factor. More...
 
int iSetFocusParameter (int subsampling, int top, int bottom, int left, int right)
 Set parameter for autofocus. More...
 
int iSetGreyFilter (int _iIndex, int _iSelect)
 Selection of a grey filter. More...
 
int iSetGreyFilterList (QStringList &_qSelected)
 Set grey filters. More...
 
int iSetImageName (int _iIndex, QString _qName)
 Changes the name of an image. More...
 
int iSetIntegrationTime (double _dWishedTime, double &_drRealizedTime)
 Set new exposure time. More...
 
int iSetMaxCameraTime (double _dMaxCameraTime)
 Set the maximum possible exposure time. More...
 
int iSetModulationFrequency (double _dModFrequency)
 Set the frequency of modulated light. More...
 
int iSetNewCamera (QString _qPathToLens)
 Set new camera calibration data. More...
 
int iSetNewCamera2 (QString _qNameCamera, QString _qNameLens)
 Set new camera calibration data. More...
 
int iSetPositionRegionName (int list, int index, int position)
 Write position of region name. More...
 
int iSetRawFocus (int value)
 Set focus position. More...
 
int iSetRecalibrationFactor (double _dFactor)
 Set recalibration factor. More...
 
int iSetRegionName (int _iList, int _iIndex, QString _qrName)
 Change region name. More...
 
int iSetScatteredLight (int _iScatteredLight)
 Use of scattered light correction. More...
 
int iSetSmear (int _iSmear)
 Set the parameter for smear correction. More...
 
int iSetStatisticParameter (int _iTyp, int _iObject, int &_irNumberParam, QStringList &_slrParamList)
 Change the parameters of a statistic. More...
 
int iSetSuppressOverflow (int _iSuppress)
 Suppress overflow warning in measurement series. More...
 
int iSetSuppressProgressDialog (int _iSuppress)
 Suppress view of progress dialog while capturing an luminance or color image. More...
 
int iSetTrigger (int type)
 Switch trigger mode on or off for Lmk6 camera. More...
 
int iSetTriggerCommonParameter (double timeout, double capturedistance, double exposuredelay, int triggerhigh, int strobehigh)
 Set common trigger parameter for Lmk6 camera. More...
 
int iSetTriggerImageParameter (int top, int bottom, int left, int right, int reserved, int level, double exposure)
 Set image trigger parameter for Lmk6 camera. More...
 
int iSetTriggerMode (int _iTriggerMode, double _dTimeout)
 Switch on or off triggered mode of capturing. More...
 
int iSetTriggerStrobeParameter (int parametrizable, double delay, double duration)
 Set strobe trigger parameter for Lmk6 camera. More...
 
int iSetViewPalette (int image, int palette)
 Change color palette. More...
 
int iSetViewScaling (int image, double scaling, double minimum, double maximum)
 Set new scaling of image view. More...
 
int iSetViewScalingRect (int image, int top, int bottom, int left, int right)
 Set new scaling rectangle of image view. More...
 
int iSetViewZoom (int image, double zoom, int top, int left)
 Set new zooming parameters. More...
 
int iShow (int _iShowStatus)
 Change visibility of the program. More...
 
int iSI2_CloseDialog ()
 Closes the Sticking images Level-2 dialog.
 
int iSI2_GetImageDir (int &saveImages, QString &directoryName)
 Get image saving parameters. More...
 
int iSI2_GetSchedule (double &rollingTime, double &burnInTime, double &relaxationTime, int &firstTriggered, int &corrNonUniformity)
 Get schedule of measurement. More...
 
int iSI2_LoadProject (QString filename)
 Load project file *.si2. More...
 
int iSI2_LoadTeachIn (QString filename)
 Load TeachIn file *.car. More...
 
int iSI2_OpenDialog ()
 Opens the Sticking images Level-2 dialog.
 
int iSI2_SaveProject (QString filename)
 Save project file *.*.si2. More...
 
int iSI2_SetDefaults ()
 Set parameters to default values.
 
int iSI2_SetImageDir (int saveImages, QString directoryName)
 Set image saving parameters. More...
 
int iSI2_SetSchedule (double rollingTime, double burnInTime, double relaxationTime, int firstTriggered, int corrNonUniformity)
 Set schedule of measurement. More...
 
int iSI2_StartMeasure ()
 Starts measurement.
 
int iSI2_StopMeasure ()
 Stopps measurement.
 
int iSI3_CloseDialog ()
 Closes the Sticking images Level-3 dialog.
 
int iSI3_DefaultParameters ()
 Set parameters to default values.
 
int iSI3_GetParameters (int &binalevel, int &maxobjectsize, double &horzscanfactor, int &bordersize, int &showregions, int &corrnonuniformity)
 Get parameters of measurement. More...
 
int iSI3_LoadParameters (QString filename)
 Load parameters of measurement *.ini. More...
 
int iSI3_LoadProject (QString filename)
 Load project file *.stimp. More...
 
int iSI3_OpenDialog ()
 Opens the Sticking images Level-3 dialog.
 
int iSI3_SaveParameters (QString filename)
 Save parameters of measurement *.ini. More...
 
int iSI3_SaveProject (QString filename)
 Save project file *.stimp. More...
 
int iSI3_SetParameters (int binalevel, int maxobjectsize, double horzscanfactor, int bordersize, int showregions, int corrnonuniformity)
 Set parameters of measurement. More...
 
int iSI3_StartMeasure ()
 Starts measurement.
 
int iSI3_StopMeasure ()
 Stops measurement.
 
int iSI3_TeachNonUniformity ()
 Teach nonuniformity.
 
int iSI3_TeachRegions ()
 Teach regions.
 
int iSinglePic (double _dExposureTime, int _iSmear, double _dModFrequency)
 SinglePic capture algorithm. More...
 
int iSinglePic2 (double _dExposureTime)
 SinglePic capture algorithm. More...
 
int iSinglePicFromFile (QString _qFileName)
 Convert camera image file to luminance image. More...
 
int iSinglePicsFromDirectory (QString _qSrcDirectory, QString _qDstDirectory)
 Converts a directory with camera images to a directory with luminance images. More...
 
int iSPA_Autoscan (double &time)
 Make autoscan algorithm and take over exposure time. More...
 
int iSPA_Capture ()
 Capture luminance image. More...
 
int iSPA_CloseDialog ()
 Closes the Sparkle dialog.
 
int iSPA_GetCameraParameter (double &fieldAngle, double &resolution, int &showAngle, int &defaultValues)
 Get capture parameters. More...
 
int iSPA_GetCaptureParam (double &time, int &count)
 Get exposure time and number of images for MultiPic algorithm. More...
 
int iSPA_GetMeasurementRegion (int &height, int &width, int &top, int &left, int &showRegion, int &showDisplay)
 Get measuring region. More...
 
int iSPA_GetMovementParameter (double &middle, double &range, double &step)
 Get movement parameters for measurement. More...
 
int iSPA_LoopMeasure (double &value, double &position)
 Complete measurement with image displays, diagram and tables. More...
 
int iSPA_OpenDialog ()
 Opens the Sparkle dialog.
 
int iSPA_ReadCarFile (QString filename)
 Read camera adjustment file *.car, contains information about display to be measured. More...
 
int iSPA_ReadParameterFile (QString filename)
 Read parameter file *.spa. More...
 
int iSPA_SetCameraParameter (double fieldAngle, double resolution, int showAngle, int defaultValues)
 Set capture parameters. More...
 
int iSPA_SetCaptureParam (double time, int count)
 Set exposure time and number of images for MultiPic algorithm. More...
 
int iSPA_SetMeasurementRegion (int height, int width, int top, int left, int showRegion, int showDisplay)
 Set measuring region. More...
 
int iSPA_SetMovementParameter (double middle, double range, double step)
 Set movement parameters for measurement. More...
 
int iSPA_SingleMeasure (double &value)
 Single measurement in luminance image. More...
 
int iSPA_WriteParameterFile (QString filename)
 Write parameter file *.spa. More...
 
int iSplitColorImage (int _iSrcColorImage, int _iDstGreyImage1, int _iDstGreyImage2, int _iDstGreyImage3, int _iColorSpace)
 Split a color image into color extracts. More...
 
int iSR_Close ()
 Closes the dialog.
 
int iSR_Execute ()
 Execute search and usage.
 
int iSR_GetChangeRegions (int &enlarge, int &smoothing, int &minsize, int &maxsize, int &convex, int &rectangles)
 Get parameters from section "Change regions". More...
 
int iSR_GetSearchingFor (int &image, double &threshold, int &smoothing)
 Get parameters from section "Searching for regions. More...
 
int iSR_GetStatistics (int &statistic, int &separate)
 Get parameters from section "Generate statistics. More...
 
int iSR_GetUseRegions (int &usage, int &delexisting, int &createmiss, double &distance, double &area, double &circumference, double &shape, double &rotation, double &displacement)
 Get parameters from section "Use regions". More...
 
int iSR_Open ()
 Opens the dialog.
 
int iSR_SetChangeRegions (int enlarge, int smoothing, int minsize, int maxsize, int convex, int rectangles)
 Set parameters to section "Change regions". More...
 
int iSR_SetSearchingFor (int image, double threshold, int smoothing)
 Set parameters to section "Searching for regions. More...
 
int iSR_SetStatistics (int statistic, int separate)
 Set parameters to section "Generate statistics". More...
 
int iSR_SetUseRegions (int usage, int delexisting, int createmiss, double distance, double area, double circumference, double shape, double rotation, double displacement)
 Set parameters to section "Use regions". More...
 
int iTableGetAllContent (int _iTable, QStringList &_qslContent)
 Returns all cells of a table as a list. More...
 
int iTableGetCell (int _iTable, int _iLine, int _iColumn, QString &_qrCell)
 Returns the content of a cell of a table. More...
 
int iTableGetColumn (int _iTable, int _iColumn, QString &_qrName, QString &_qrCaption, QString &_qrUnit)
 Returns the column header of a column of a table. More...
 
int iTableGetIndex (QString _qNameOrCaption, int &_irTable)
 Search for a table, given by name or caption. More...
 
int iTableGetNameAndCaption (int _iTable, QString &_qrName, QString &_qrCaption)
 Returns the name and the caption of an existing table. More...
 
int iTableGetNumber (int &_irNumber)
 Returns the number of tables in the result tab widget. More...
 
int iTableGetNumberColumns (int _iTable, int &_irNumberColumns)
 Returns the number of columns of a table. More...
 
int iTableGetNumberLines (int _iTable, int &_irNumberLines)
 Returns the number of lines of a table. More...
 
int iTIG_CreateImage ()
 Create template image with the adjusted parameters. More...
 
int iTIG_DeleteImage ()
 Remove template image from the display. More...
 
int iTIG_GetBorderProperties (int &_irUse, int &_irLeft, int &_irRight, int &_irTop, int &_irBottom, int &_irValue)
 Get properties of image border. More...
 
int iTIG_GetListOfCategories (QStringList &_qslCategories)
 Get list of categories of template images. More...
 
int iTIG_GetListOfOperations (QString _qCategory, QStringList &_qslOperations)
 Get list of types of template images for the given category. More...
 
int iTIG_GetListOfParameterNames (QStringList &_qrParameters)
 Get a parameter name list for the currently selected template image type. More...
 
int iTIG_GetNumberTargetDisplays (int &_irNumber)
 Number of connected displays. More...
 
int iTIG_GetParameterValue (QString _qName, double &_drValue)
 Get a certain parameter value. More...
 
int iTIG_GetTarget (int &_irIndex, QString &_qrImageName)
 Get current target for template image generation. More...
 
int iTIG_GetTargetProperties (int &_irType, int &_irHeight, int &_irWidth, int &_irLines, int &_irColumns)
 Get properties of current target. More...
 
int iTIG_HideDialog ()
 Make template image dialog invisible. More...
 
int iTIG_IsOperation (QString _qCategory, QString _qOperation, int &_irSet)
 Ask, if a type of template image is selected. More...
 
int iTIG_LoadImage (QString _qFileName)
 Load template image file to the target. More...
 
int iTIG_LoadParameter (QString _qFileName)
 Load file with predefined parameter values. More...
 
int iTIG_SaveImage (QString _qFileName)
 Save template image to a file. More...
 
int iTIG_SaveParameter (QString _qFileName)
 Save file with adjusted parameter values. More...
 
int iTIG_SetBorderProperties (int _iUse, int _iLeft, int _iRight, int _iTop, int _iBottom, int _iValue)
 Set properties of image border. More...
 
int iTIG_SetOperation (QString _qCategory, QString _qOperation, int _iSet)
 Set a type of template image or an option. More...
 
int iTIG_SetParameterValue (QString _qName, double _dValue)
 Set a certain parameter value. More...
 
int iTIG_SetTarget (int _iIndex, QString _qImageName)
 Set target for template image generation. More...
 
int iTIG_ShowDialog ()
 Make template image dialog visible. More...
 
int iWordClose ()
 Close Word program. More...
 
int iWordCopyItem (int _iIndex)
 Copy one item to Word. More...
 
int iWordCopySelected ()
 Copy all selected items to Word. More...
 
int iWordGetItemProperties (int _iIndex, int &_irType, QString &_qrName, QString &_qrMarker, int &_irSelected)
 Get the informations about a data entry. More...
 
int iWordGetNumberItems (int &_irNumber)
 Get number of data entries in Word dialog. More...
 
int iWordOpenFile (QString _qFileName)
 Open an Word file for data export. More...
 
int iWordSave ()
 Save Word file. More...
 
int iWordSelectAll ()
 Select all items in Word dialog. More...
 
int iWordSetItemProperties (int _iIndex, QString _qMarker, int _iSelect)
 Set the informations about a data entry. More...
 
int iWordSetVisible (int _iVisible)
 Change visbility of Word program. More...
 
int iWordUnselectAll ()
 Unselect all items in Word dialog. More...
 
int iWriteIniFileEntry (QString _qFileName, QString _qSection, QString _qEntry, QString _qValue)
 Write value of an entry in a section of an inifile. More...
 
int iWritePhysicalRegister (int _iRegister, int _iValue)
 Write physical register of camera. More...
 
int iWriteRegisterFile (QString _qFileName)
 Write register file. More...
 
int iWriteRegisterMap (QString _qRegisterName, int _iValue)
 
int iWriteToStatusLine (QString _qMessage)
 Writes a string to the status line of the program. More...
 

Signals

void vSignalImageContentChanged (int _iImage)
 After changing of an image, this signal is thrown. More...
 
void vSignalWaitTrigger (double _dTimeout)
 If capturing algorithm waits for extern trigger signal. More...
 

Member Function Documentation

int LMKAxServer::iAdjustColorFactors ( int  _iIndex,
double  _dCurrent_R,
double  _dCurrent_G,
double  _dCurrent_B,
double  _dWished_R,
double  _dWished_G,
double  _dWished_B 
)
slot

Change color factors to adjust to a given color.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

If you have measured the color with the help of another device you can adjust the color measured by the program (current color) to the color measured by this device (wished color). The changes will take effect by the next color capture.

The color values are given in CIE-RGB color space. If you need some color space transformation, please use

  • iGetColorRGB() to calculate RGB values from an other color space
  • iGetColor() to calculate color values in a color space from RGB value
Parameters
_iIndexIndex of set
_dCurrent_RCurrent color, red value
_dCurrent_GCurrent color, green value
_dCurrent_BCurrent color, blue value
_dWished_RWished color, red value
_dWished_GWished color, green value
_dWished_BWished color, blue value
int LMKAxServer::iAppendEquation ( int  _iTyp,
int  _iObject,
QString &  _qsName,
QString &  _qsFormula,
int  _iWhereToShow 
)
slot

Append an equation.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_qsNameName of equation
_qsFormulaFormula to calculate
_iWhereToShowWhere to show in result table
int LMKAxServer::iAutoFocus ( int  linear,
int  adaptive,
double &  sharpness,
double &  edge 
)
slot

Make autofocus procedure.

Parameters
linear1 = use linear scan
adaptive1 = use adaptive scan (preferred), both on: combine linear and adaptive scan
sharpnessValue of sharpness, the higher, the better
edgeMean edge quality in percent (Maximum = 100%)
  • If both linear and adaptive are switched off, adaptive is used.
  • If both linear and adaptive scan are switched on, adaptive scan is used in range found by linear scan.
int LMKAxServer::iAutoScanTime ( )
slot

Determine a good exposure time.

int LMKAxServer::iBitmapGetList ( QStringList &  bitmapList)
slot

List of all available bitmaps in program (images, graphics, diagrams)

Parameters
bitmapListList of all bitmaps
int LMKAxServer::iBlackMuraAdjImageCopy ( )
slot

Copy adjustment image from "Camera image" to "Adjustment image".

int LMKAxServer::iBlackMuraAutomaticMeasure ( int  _iBrightImage,
int  _iDarkImage,
double  _dTimeDelay 
)
slot

Automatic measurement using DVI interface for the display to be measured.

Parameters
_iBrightImageif not zero, capture bright image and calculate it
_iDarkImageif not zero, capture dark image and calculate it
_dTimeDelayTime delay between uploading the template image to the display and start capturing
int LMKAxServer::iBlackMuraBrightCapture ( )
slot

Makes a BlackMura bright capture and calculates results.

int LMKAxServer::iBlackMuraBrightLoad ( QString  _qFileName)
slot

Load a bright image and calculates results.

Parameters
_qFileNameImage filename
int LMKAxServer::iBlackMuraCloseDialog ( )
slot

Closes the dialog for BlackMura measurements.

int LMKAxServer::iBlackMuraDarkLoad ( QString  _qFileName)
slot

Load a dark image and calculates results.

Parameters
_qFileNameImage filename
int LMKAxServer::iBlackMuraGetDstDirectory ( QString &  _qrDstDirectory)
slot

Get the destination directory for saving images.

Parameters
_qrDstDirectoryDestination directory for images
int LMKAxServer::iBlackMuraGetFlagsProject ( int &  _irShowCoord,
int &  _irShowMeasurementRegion,
int &  _irShowAdjustmentRegions,
int &  _irShowBrightClassification 
)
slot

Get flags for DarkMura project.

Parameters
_irShowCoordShow coordinate system
_irShowMeasurementRegionShow measurement region
_irShowAdjustmentRegionsShow regions in adjustment image
_irShowBrightClassificationShow classification in bright image
int LMKAxServer::iBlackMuraGetMeasureFlags ( int &  _irShowDarkClassification,
int &  _irSaveAutomatically 
)
slot

Get flags for DarkMura measurement.

Parameters
_irShowDarkClassificationShow classification in dark image
_irSaveAutomaticallySave captures images automatically
int LMKAxServer::iBlackMuraGetProjectFileName ( QString &  _qrFileName)
slot

Get BlackMura project file name.

Parameters
_qrFileNameFilename of current BlackMura project
int LMKAxServer::iBlackMuraGetSerialNumber ( QString &  _qrSerialNumber)
slot

Get the serial number of next display to examine.

Parameters
_qrSerialNumberSerial number of next display to capture
int LMKAxServer::iBlackMuraLoadAdjFile ( QString  _qFileName)
slot

Loads Camera adjustment file

Parameters
_qFileNameFilename of BlackMura project
int LMKAxServer::iBlackMuraLoadProject ( QString  _qFileName)
slot

Loads BlackMura project file.

Parameters
_qFileNameFilename of BlackMura project
int LMKAxServer::iBlackMuraSaveProject ( QString  _qFileName)
slot

Saves BlackMura project file.

Parameters
_qFileNameFilename of BlackMura project
int LMKAxServer::iBlackMuraSetDstDirectory ( QString  _qDstDirectory)
slot

Set the destination directory for saving images.

Parameters
_qDstDirectoryDestination directory for images
int LMKAxServer::iBlackMuraSetFlagsProject ( int  _iShowCoord,
int  _iShowMeasurementRegion,
int  _iShowAdjustmentRegions,
int  _iShowBrightClassification 
)
slot

Set flags for DarkMura project.

Parameters
_iShowCoordShow coordinate system
_iShowMeasurementRegionShow measurement region
_iShowAdjustmentRegionsShow regions in adjustment image
_iShowBrightClassificationShow classification in bright image
int LMKAxServer::iBlackMuraSetMeasureFlags ( int  _iShowDarkClassification,
int  _iSaveAutomatically 
)
slot

Set flags for DarkMura measurement.

Parameters
_iShowDarkClassificationShow classification in dark image
_iSaveAutomaticallySave captures images automatically
int LMKAxServer::iBlackMuraSetSerialNumber ( QString  _qSerialNumber)
slot

Set the serial number of next display to examine.

Parameters
_qSerialNumberSerial number of next display to capture
int LMKAxServer::iCamera_Firmware ( int &  fpga,
int &  firmware,
int &  build,
int &  lens 
)
slot

Get version of firmware in camera and lens.

Only available for Lmk6 cameras (TTQ, TTS, TTT)

Parameters
fpgaVersion of FPGA
firmwareVersion of camera firmware
buildBuild number
lens- Controlable lens: 256 * major version + minor version
  • otherwise: 0
int LMKAxServer::iCamera_GetFocusAndContrast ( int  _iTop,
int  _iLeft,
int  _iBottom,
int  _iRight,
double &  _drFocus,
double &  _drContrast 
)
slot

Get Focus and contrast information of a region in the camera image.

Parameters
_iTopFirst line of region
_iLeftFirst column of region
_iBottomLast line of region
_iRightLast column of region
_drFocusFocus result in percent (values between 0.0 and 100.0)
_drContrastContrast between bright and dark (values between 0. and 10.0)
int LMKAxServer::iCamera_GetOverdriveRegion ( int &  _irUseRegion,
int &  _irTop,
int &  _irBottom,
int &  _irLeft,
int &  _irRight 
)
slot

Get the region, which is used for overdrive control.

Parameters
_irUseRegion- 1: Following region coordinates are used
  • 0: Whole image size is used, following coordinates are image size
_irTopUpper border of region used
_irBottomLower border of region used
_irLeftLeft border of region used
_irRightRight border of region used
int LMKAxServer::iCamera_GetParameter ( QString  _qName,
QString &  _qrValue 
)
slot

Read some additional camera properties.

Parameters
_qNameName of the parameter wished. Currently are supported by some camera types:
  • Gain: Gain value of the camera chip
  • Temperature: Temperature of the camera chip
  • VARI_SPEC_TEMPERATURE: Temperature of LCDF
  • VARI_SPEC_WAVELENGTH: Wavelength of LCDF
_qrValueReturn value of the function. The interpretation of the string depends on the parameter itself. For example the gain is an integer value, the temperature is a floating point.
int LMKAxServer::iCamera_GetSaturation ( int  _iWholeImage,
int  _iTop,
int  _iLeft,
int  _iBottom,
int  _iRight,
double &  _drSaturation 
)
slot

Get saturation information of camera image or region in camera image.

Parameters
_iWholeImage- 1: Use whole image (_iTop, _iLeft, _iBottom and _iRight are meaningless)
  • 0: Use given region coordinates
_iTopFirst line of region
_iLeftFirst column of region
_iBottomLast line of region
_iRightLast column of region
_drSaturationSaturation of image or region in percent (values between 0.0 and 100.0, 100.0 = overdriven image or region)
int LMKAxServer::iCamera_List ( QStringList &  list)
slot

List of camera and lens calibration data for this installation.

Every camera - lens combination is one entry, for example:

TTQ4567|o5678f16
TTQ4567|o6789f25
TTS1234|o2345f50
TTS1234|03456f70
Parameters
listList of combinations
int LMKAxServer::iCamera_SetOverdriveRegion ( int  _iUseRegion,
int  _iTop,
int  _iBottom,
int  _iLeft,
int  _iRight 
)
slot

Set the region, which is used for overdrive control.

Parameters
_iUseRegion- 1: Following region coordinates will be used
  • 0: Whole image size is used, Following coordinates will be ignored
_iTopUpper border of region used
_iBottomLower border of region used
_iLeftLeft border of region used
_iRightRight border of region used
int LMKAxServer::iCameraSetupDialogClose ( )
slot

Closes the dialog "Camera set-up.

int LMKAxServer::iCameraSetupDialogOpen ( )
slot

Opens the dialog "Camera set-up.

int LMKAxServer::iCameraSetupLoadProject ( QString  _qFileName)
slot

Load predefined project file.

File extension is usually *.cap

Parameters
_qFileNameFile name of existing file
int LMKAxServer::iCameraSetupMeasurementStart ( int  _iLuminanceImage)
slot

Start measurement in camera or luminance image.

Every time a new image is captured or loaded, the measurement results are calculated.

Parameters
_iLuminanceImage- 0 Calculation in camera image
  • 1 Calculation in luminance image
int LMKAxServer::iCameraSetupMeasurementStop ( )
slot

Stop measurement in camera or luminance image.

int LMKAxServer::iCameraSetupResultCircles ( int &  success,
QStringList &  middle_x,
QStringList &  middle_y,
QStringList &  radius 
)
slot

Get position of circles found in image.

Parameters
successSearch of adjustment successful?
middle_xx coordinates of the 5 circles
middle_yy coordinates of the 5 circles
radiusRadii of the 5 circles
int LMKAxServer::iCameraSetupResultGeo ( int &  success,
double &  optical_x_pix,
double &  optical_x_mm,
double &  optical_y_pix,
double &  optical_y_mm,
double &  horizontal,
double &  vertical,
double &  axial,
double &  repro_x,
double &  repro_y 
)
slot

Get results of geometric adjustment.

Parameters
successSearch of adjustment successful?
optical_x_pixOptical axis in x in pixels
optical_x_mmOptical axis in x in millimeters
optical_y_pixOptical axis in y in pixels
optical_y_mmOptical axis in y in millimeters
horizontalHorizontal angle
verticalVertical angle
axialAxial angle
repro_xReproduction scale in x
repro_yReproduction scale in y
int LMKAxServer::iCameraSetupResultPhoto ( int &  success,
double &  minimum,
double &  maximum,
QStringList &  vertical,
QStringList &  horizontal 
)
slot

Get results of geometric adjustment.

Parameters
successSearch of adjustment successful?
minimumMinimum value in image
maximumMaximum value in image
vertical6 values of vertical modulation rectangles
horizontal6 values of horizontal modulation rectangles
int LMKAxServer::iCameraSetupSaveResult ( QString  _qFileName)
slot

Save calculated results.

File extension is usually *.car

Parameters
_qFileNameFile name of result file
int LMKAxServer::iCaptureGetLastInfo ( int &  _irSuccess,
int &  _irAlgorithm,
QString &  _qrGreyFilter,
QString &  _qrColorFilter,
int &  _ulpPicCount,
double &  _drMaxTime,
double &  _drMintTime,
double &  _drOverflow,
double &  _drMaxLoad,
double &  _drCaptureTime,
int &  _irSmear,
double &  _drFrequency 
)
slot

Determine information about the preceeding capture.

Parameters
_irSuccess1=success, 0=no success
_irAlgorithm1=SinglePic ... 4 ColorHighDyn
_qrGreyFilterUnused
_qrColorFilterListe of color filters
_ulpPicCountNumber of camera images (MultiPic)
_drMaxTimeMaximal exposure time
_drMintTimeMinimal exposure time
_drOverflowPercentage of overdriven pixels
_drMaxLoadPercentage of overdrive
_drCaptureTimeCapture date and time as double number
_irSmearNumber of smear images
_drFrequencyModulation frequency
int LMKAxServer::iChangeRegion ( int  _iList,
int  _iIndex,
int  _iNumPoints,
QStringList &  _slX,
QStringList &  _slY 
)
slot

Set the properties of a region.

Only in the case of a polygon it is possible to change the number of points.

Parameters
_iListIndex of region list
_iIndexIndex of the region
_iNumPointsNumber of points
_slXNew x-coordinates
_slYNew y-coordinates
int LMKAxServer::iClearUndoRegionList ( int  _iList)
slot

Delete the undo stack of region list (saves memory and time)

Parameters
_iListInput: Index of region list (same as image index)
int LMKAxServer::iClose ( int  _iQuestion)
slot

Closes the Lmk4 application.

Parameters
_iQuestion!=0: Opens a dialogue window in the application. The user can choose, wether he wish to save the current state or not or cancel th closing of the program.
=0: No dialogue window
Returns
0=ok, 1=User do not want to close the application, >1 Error code
int LMKAxServer::iColorAutoScanTime ( QStringList &  _qslExposureTimes)
slot

Determine good exposure times for every color filter.

Parameters
_qslExposureTimesReturn value: List of exposure times. One time for every color filter.

Attention: The list of exposure times contains one value for every filter in the filter wheel, independent of this filter is used in color capturing or not. In most cameras there are at least 5 filters:

  1. Glass
  2. X1
  3. X2
  4. Z
  5. Y

In some cases there is additionally a sixt filter available. The list of capture times therefore contains either 5 or 6 entries. Color captures are mostly done with X1, X2, Z and Y filters. Therefore the first entry in the exposure time list is irrelevant for color captures. And in the case of 6 filters, the last entry too.

You can use the returned list of exposure times in the functions iColorCaptureMultiPic() and iColorCaptureHighDyn().

int LMKAxServer::iColorCaptureHighDyn ( QStringList &  _qslExposureTimes,
double  _dStartRatio,
double  _dFactor,
int  _iCountPic 
)
slot

Capturing of color images with the HighDyn algorithm.

Parameters
_qslExposureTimesList of exposure times. One time for every color filter.
_dStartRatioEvery is multiplied with this parameter to determine the start exposure time for one of the color filters. The default value for this parameter should be 10.
_dFactorThe exposure time is decreased by this factor until there is no overdrive in the images captured.
_iCountPicNumber of captures for every filter and exposure time.

Attention: The list of exposure times contains one value for every filter in the filter wheel, independent of this filter is used in color capturing or not. In most cameras there are at least 5 filters:

  1. Glass
  2. X1
  3. X2
  4. Z
  5. Y

In some cases there is additionally a sixt filter available. The list of capture times therefore contains either 5 or 6 entries. Color captures are mostly done with X1, X2, Z and Y filters. Therefore the first entry in the exposure time list is irrelevant for color captures. And in the case of 6 filters, the last entry too.

You can use 6 entries in your list albeit your filter wheel contains only 5 filters. In this case the program simply ignores the unnecessary sixt parameter.

int LMKAxServer::iColorCaptureMultiPic ( QStringList &  _qslExposureTimes,
int  _iCountPic 
)
slot

Capturing of color images with the MultiPic algorithm.

Parameters
_qslExposureTimesList of exposure times. One time for every color filter.
_iCountPicNumber of captures for every filter

Attention: The list of exposure times contains one value for every filter in the filter wheel, independent of this filter is used in color capturing or not. In most cameras there are at least 5 filters:

  1. Glass
  2. X1
  3. X2
  4. Z
  5. Y

In some cases there is additionally a sixt filter available. The list of capture times therefore contains either 5 or 6 entries. Color captures are mostly done with X1, X2, Z and Y filters. Therefore the first entry in the exposure time list is irrelevant for color captures. And in the case of 6 filters, the last entry too.

You can use 6 entries in your list albeit your filter wheel contains only 5 filters. In this case the program simply ignores the unnecessary sixt parameter.

int LMKAxServer::iColorDiffImgCol ( int  _iSrcColorImage1,
QStringList &  _qslColor2inRGB,
int  _iDstGreyImage,
int  _iColorDifferenceType,
double  _dMinimumLuminance,
int  _iSmoothing,
QStringList &  _qslParameter 
)
slot

Calculate a color difference to a reference color.

Parameters
_iSrcColorImage1Index of source color image
_qslColor2inRGBComparison color in CIE RGB
_iDstGreyImageIndex of target grey image
_iColorDifferenceTypeType of color difference:
  • 0 = dE(CIE_RGB) (mean square distance in CIE RBG color space)
  • 1 = dE(L*u*v*) (mean square distance in L*u*v* color space)
  • 2 = dE(L*a*b*) (mean square distance in L*a*b* color space)
  • 3 = dE(L*a*b*,A,B,C) (_qslParameter must contain 3 additional values A, B, C)
  • 4 = dE(Lu'v',A,B) (_qslParameter must contain 3 additional values A, B)
  • 5 = L2(Lxy) (mean square distance in Lxy color space)
  • 6 = Loo(Lxy) (Loo distance in Lxy color space)
_dMinimumLuminanceMinimum luminance for calculation of color distance
_iSmoothingPrior smoothing of color image, box filter size
_qslParameterParameter list for dE(L*a*b*,A,B,C) and dE(Lu'v',A,B)
int LMKAxServer::iColorDiffImgImg ( int  _iSrcColorImage1,
int  _iSrcColorImage2,
int  _iDstGreyImage,
int  _iColorDifferenceType,
double  _dMinimumLuminance,
int  _iSmoothing,
QStringList &  _qslParameter 
)
slot

Calculate a color difference between two images.

Parameters
_iSrcColorImage1Index of source color image 1
_iSrcColorImage2Index of source color image 2
_iDstGreyImageIndex of target grey image
_iColorDifferenceTypeType of color difference:
  • 0 = dE(CIE_RGB) (mean square distance in CIE RBG color space)
  • 1 = dE(L*u*v*) (mean square distance in L*u*v* color space)
  • 2 = dE(L*a*b*) (mean square distance in L*a*b* color space)
  • 3 = dE(L*a*b*,A,B,C) (_qslParameter must contain 3 additional values A, B, C)
  • 4 = dE(Lu'v',A,B) (_qslParameter must contain 3 additional values A, B)
  • 5 = L2(Lxy) (mean square distance in Lxy color space)
  • 6 = Loo(Lxy) (Loo distance in Lxy color space)
_dMinimumLuminanceMinimum luminance for calculation of color distance
_iSmoothingPrior smoothing of color image, box filter size
_qslParameterParameter list for dE(L*a*b*,A,B,C) and dE(Lu'v',A,B)
int LMKAxServer::iColorHighDynPic ( double  _dMaxTime,
double  _dMinTime,
double  _dFactor,
int  _iSmear,
double  _dModFrequency 
)
slot

HighDyn-Farbbild-Aufnahme.

Parameters
_dMaxTimeLargest exposure time
_dMinTimeSmallest exposure time (proposal: 0.0)
_dFactorFactor between two times (proposal 3.0)
_iSmearNumber of smear images (0=no smear correction)
_dModFrequencyModulation frequency (0=no modulation)
int LMKAxServer::iColorHighDynPic2 ( double  _dMaxTime,
double  _dMinTime,
double  _dFactor,
int  _iPicCount 
)
slot

HighDyn capturing for color image.

Parameters
_dMaxTimeLargest exposure time
_dMinTimeSmallest exposure time (proposal: 0.0)
_dFactorFactor between two times (proposal 3.0)
_iPicCountNumber of shots per integration time
int LMKAxServer::iConvertCameraCalibrationData ( int  _iDestinationType,
QString  _qSourcePath,
QString  _qDestinationPath 
)
slot

Convert camera calibration data.

This function exists only in the development version of LabSoft. Useable only for TechnoTeam themselves.

Parameters
_iDestinationType- 0 Titan to FrameLink
  • 1 Titan to Pleora
  • 2 Titan to Sapera
_qSourcePathPath to existing calibration data either for DX4 or SVS camera
_qDestinationPathNone existing or empty directory for converted data
int LMKAxServer::iCoordinateTransformationF ( int  srcImage,
QString  xIndexImage,
QString  yIndexImage,
int  targetImage 
)
slot

Coordinate transformation with two index images.

The function calculates the pixels of a target image using a source image and two index images. To calculate the value of the target image at the location (i, j),

  • from the x-index image, the x-coordinate x (i, j) and
  • taken from the y-index image, the y-coordinate y (i, j) and
  • in the source image the value p (x, y) is taken and
  • copied to the destination image.
Parameters
srcImageIndex of the source image
xIndexImageFilename of the index images with x-coordinates
yIndexImageFilename of the index images with y-coordinates
targetImageIndex of the target image

The image size of xIndexImage, yIndexImage and target image should be the same.

int LMKAxServer::iCoordinateTransformationI ( int  srcImage,
int  xIndexImage,
int  yIndexImage,
int  targetImage 
)
slot

Coordinate transformation with two index images.

The function calculates the pixels of a target image using a source image and two index images. To calculate the value of the target image at the location (i, j),

  • from the x-index image, the x-coordinate x (i, j) and
  • taken from the y-index image, the y-coordinate y (i, j) and
  • in the source image the value p (x, y) is taken and
  • copied to the destination image.
Parameters
srcImageIndex of the source image
xIndexImageIndex of the index images with x-coordinates
yIndexImageIndex of the index images with y-coordinates
targetImageIndex of the target image

The image size of xIndexImage, yIndexImage and target image should be the same.

int LMKAxServer::iCoordSystemCoordToPixel ( int  _iImage,
double  _dCoordXorPhi,
double  _dCoordYorRadius,
double &  _drPixelX,
double &  _drPixelY 
)
slot

Convert coordinates to pixel indices.

Parameters
_iImageIndex of image
_dCoordXorPhix coordinate in cartesian system or phi in polar system
_dCoordYorRadiusy coordinate in cartesian system or radius in polar system
_drPixelXx coordinate in pixel system
_drPixelYy coordinate in pixel system
int LMKAxServer::iCoordSystemGetCartesian ( int  _iImage,
int &  _irIsCartesian,
double &  _drScalingX,
double &  _drOffsetX,
double &  _drScalingY,
double &  _drOffsetY 
)
slot

Set the parameter of a cartesian system.

Parameters
_iImageIndex of image
_irIsCartesian1 if cartesian, 0 if polar. Next parameter only valid if cartesian
_drScalingXScaling in x direction
_drOffsetXOffset in x direction
_drScalingYScaling in y direction
_drOffsetYOffset in y direction
int LMKAxServer::iCoordSystemGetPolar ( int  _iImage,
int &  _irIsPolar,
double &  _drXm,
double &  _drYm,
double &  _drFactorR,
double &  _drFactorP,
double &  _drOffsetP 
)
slot

Set the parameter of a polar system.

Parameters
_iImageIndex of image
_irIsPolar1 if polar, 0 if cartesian. Next parameter only valid if polar
_drXmMiddle point in x
_drYmMiddle point in y
_drFactorRFactor of radius
_drFactorP-1 or +1 direction of phi angle
_drOffsetPOffset of phi angle
int LMKAxServer::iCoordSystemGetValueUnit ( int  _iImage,
QString &  _qrValueX,
QString &  _qrUnitX,
QString &  _qrValueY,
QString &  _qrUnitY,
QString &  _qrUnitArea 
)
slot

Get the values and units of the axi.

Parameters
_iImageIndex of image
_qrValueXValue of x axis
_qrUnitXUnit of x axis
_qrValueYValue of y axis
_qrUnitYUnit of y axis
_qrUnitAreaUnit of area
int LMKAxServer::iCoordSystemPixelToCoord ( int  _iImage,
double  _dPixelX,
double  _dPixelY,
double &  _drCoordXorPhi,
double &  _drCoordYorRadius 
)
slot

Convert pixel indices to coordinates.

Parameters
_iImageIndex of image
_dPixelXx coordinate in pixel system
_dPixelYy coordinate in pixel system
_drCoordXorPhix coordinate in cartesian system or phi in polar system
_drCoordYorRadiusy coordinate in cartesian system or radius in polar system
int LMKAxServer::iCoordSystemReadFile ( int  _iImage,
QString  _qFileName 
)
slot

Read parameter from a file.

Parameters
_iImageIndex of image
_qFileNameFilename of existing file
int LMKAxServer::iCoordSystemSetCartesian ( int  _iImage,
double  _dScalingX,
double  _dOffsetX,
double  _dScalingY,
double  _dOffsetY 
)
slot

Set the parameter of a cartesian system.

Formula for both axis is: Coord = Scaling * Pixel - Offset

Parameters
_iImageIndex of image
_dScalingXScaling in x direction
_dOffsetXOffset in x direction
_dScalingYScaling in y direction
_dOffsetYOffset in y direction
int LMKAxServer::iCoordSystemSetPolar ( int  _iImage,
double  _dXm,
double  _dYm,
double  _dFactorR,
double  _dFactorP,
double  _dOffsetP 
)
slot

Set the parameter of a polar system.

Parameters
_iImageIndex of image
_dXmMiddle point in x
_dYmMiddle point in y
_dFactorRFactor of radius
_dFactorP-1 or +1 direction of phi angle
_dOffsetPOffset of phi angle
int LMKAxServer::iCoordSystemSetValueUnit ( int  _iImage,
QString  _qValueX,
QString  _qUnitX,
QString  _qValueY,
QString  _qUnitY,
QString  _qUnitArea 
)
slot

Set the values and units of the axi.

Parameters
_iImageIndex of image
_qValueXValue of x axis
_qUnitXUnit of x axis
_qValueYValue of y axis
_qUnitYUnit of y axis
_qUnitAreaUnit of area
int LMKAxServer::iCoordSystemWriteFile ( int  _iImage,
QString  _qFileName 
)
slot

Write parameter into a file.

Parameters
_iImageIndex of image
_qFileNameFilename, existing file is overwritten
int LMKAxServer::iCopyColorFactors ( int  _iSrcIndex,
int  _iDstIndex 
)
slot

Copy factors from one set to another.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

Parameters
_iSrcIndexIndex of source factor set
_iDstIndexIndex of destination factor set
int LMKAxServer::iCreateGroup ( int  _iList,
int  _iGroupType,
int  _iNumRegions,
QStringList &  _slRegionIndices 
)
slot

Creates a group.

Parameters
_iListIndex of region list
_iGroupTypeType of region
  • 7 OR group
  • 8 XOR group
  • 9 AND group
_iNumRegionsNumber of regions
_slRegionIndicesList of region indices
int LMKAxServer::iCreateRegion ( int  _iList,
int  _iType,
int  _iNumPoints,
QStringList &  _slX,
QStringList &  _slY 
)
slot

Create a region.

Parameters
_iListIndex of region list
_iType0...4 see above
_iNumPointsNumber of points
_slXList of x-points
_slYList of y-points
int LMKAxServer::iCreateStatistic ( int  _iTyp,
int  _iImage,
int  _iRegion,
int  _iNumberParam,
QStringList &  _slrParamList 
)
slot

Create a new statistic.

Parameters
_iTypIndex of statistic type
_iImageImage
_iRegionIndex of region in this image
_iNumberParamNumber of parameters for this statistic
_slrParamListList of parameters for this statistic
int LMKAxServer::iDatabaseClose ( )
slot

Closes the currently opened database.

int LMKAxServer::iDatabaseImageOptionsGet ( int &  _irSaveMode,
QString &  _qrDirectory 
)
slot

Get the options for saving images.

Parameters
_irSaveModeReturns how images should be saved. Note, that only Sqlite files support modes 1 and 2:
  • 0 Uncompressed
  • 1 Compressed
  • 2 As files in the image directory
  • 3 Not save
_qrDirectoryReturns directory name for saving the images
int LMKAxServer::iDatabaseImageOptionsSet ( int  _iSaveMode,
QString  _qDirectory 
)
slot

Set the options for saving images.

Parameters
_iSaveModeHow images should be saved. Note, that only Sqlite files support modes 1 and 2:
  • 0 Uncompressed
  • 1 Compressed
  • 2 As files in the image directory
  • 3 Not save
_qDirectoryDirectory name for saving the images
int LMKAxServer::iDatabaseOpen ( QString  _qDatabaseName,
QString  _qUserName,
QString  _qPassword 
)
slot

Opens a database for read / write access.

Parameters
_qDatabaseNameName of database:
  • In the case of a Sqlite file this is simply the path name.
  • In the case of a ODBC connection it is the name of the connection
_qUserNameName of the user
_qPasswordPassword for database read / write permissions
int LMKAxServer::iDatasetCopy ( int  _iSrcContentId,
QString  _qDstDatabaseName,
QString  _qDstUserName,
QString  _qDstPassword,
int &  _irDstContentId 
)
slot

Copy a dataset to another database.

Parameters
_iSrcContentIdPrimary key of the set to copy
_qDstDatabaseNameName of database:
  • In the case of a Sqlite file this is simply the path name.
  • In the case of a ODBC connection it is the name of the connection
_qDstUserNameName of the user
_qDstPasswordPassword for database read / write permissions
_irDstContentIdReturns the primary key of the set written
int LMKAxServer::iDatasetDelete ( int  _iContentId)
slot

Delete a dataset in database.

Parameters
_iContentIdPrimary key of the set to delete
int LMKAxServer::iDatasetInfo ( int  _iContentId,
int &  _irType,
QString &  _qrCreated,
QString &  _qrChanged,
QString &  _qrUser,
int &  _irImages,
int &  _irCompressionMode,
QString &  _qImageDirectory,
QString &  _qDescription 
)
slot

Common informations about a dataset.

Parameters
_iContentIdPrimary key of the set
_irTypeReturns the type of dataset
  • 1 type "TTPROTOCOL"
  • 2 type "TTRESULT"
_qrCreatedReturns the datetime of creation, format YYYY-MM-DD HH:MM:SS
_qrChangedReturns the datetime of last change, format YYYY-MM-DD HH:MM:SS
_qrUserReturns the name of user, which has created the set
_irImagesReturns the number of images of set
_irCompressionModeReturns the save mode of images:
  • 0 Uncompressed
  • 1 Compressed
  • 2 As files in the image directory
  • 3 Not save
_qImageDirectoryReturns the image directory, if images saved as files
_qDescriptionReturns the string meanwhile creation
int LMKAxServer::iDatasetList ( int  _iTypeOfSets,
int &  _irNumber,
QStringList &  _qslContentIds,
QStringList &  _qslTypes 
)
slot

Get a list of datasets in the database.

Parameters
_iTypeOfSetsType of datasets, which should be reported:
  • 1 only type "TTPROTOCOL"
  • 2 only type "TTRESULT"
  • 3 both
_irNumberReturns number of data sets found
_qslContentIdsReturns a list with the primary keys of the sets found
_qslTypesReturns a list with the types of the sets found, see _iTypeOfSets
int LMKAxServer::iDatasetRead ( int  _iContentId)
slot

Read a dataset from the database into LabSoft.

Parameters
_iContentIdPrimary key of the set to read
int LMKAxServer::iDatasetUserTableInfo ( int &  _irNumberEntries,
QStringList &  _qslNameList,
QStringList &  _qslCaptionList,
QStringList &  _qslTypes,
QStringList &  _qslDefaults,
QStringList &  _qslComments 
)
slot

Get informations about construction of the user table.

Parameters
_irNumberEntriesReturns the number of entries = length of following lists
_qslNameListReturns a list with the names of the entries
_qslCaptionListReturns a list with the captions of the entries in a dialog
_qslTypesReturns a list with the types of the entries:
  • 1 Integer
  • 2 Real
  • 3 String
  • 4 Blob
_qslDefaultsReturns a list of default values
_qslCommentsReturns a list of comments for every entry
int LMKAxServer::iDatasetUserTableRead ( int  _iContentId,
QStringList &  _qslNames,
QStringList &  _qslValues 
)
slot

Read informations of a dataset from the user table.

Parameters
_iContentIdPrimary key of the set to read
_qslNamesNames of the values to read. See iDatasetUserTableInfo() for the possible names.
_qslValuesReturns values read. If the function is successfull, the number of values is equal the number of names.
int LMKAxServer::iDatasetUserTableWrite ( int  _iContentId,
QStringList &  _qslNames,
QStringList &  _qslValues 
)
slot

Write informations of a dataset into the user table.

Parameters
_iContentIdPrimary key of the set to change
_qslNamesNames of the values to change. See iDatasetUserTableInfo() for the possible names.
_qslValuesValues to set.
int LMKAxServer::iDatasetWrite ( int  _iType,
QString  _qDescription,
int &  _irContentId 
)
slot

Write a dataset from LabSoft to the database.

Parameters
_iTypeType of dataset:
  • 1 type "TTPROTOCOL"
  • 2 type "TTRESULT"
_qDescriptionString meanwhile creation
_irContentIdReturns the primary key of the set written
int LMKAxServer::iDefaultColorFactors ( int  _iIndex)
slot

Reset color factor set = set to default values.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

Parameters
_iIndexIndex of set
int LMKAxServer::iDeleteEquation ( int  _iTyp,
int  _iObject,
int  _iEquation 
)
slot

Delete an equation.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iEquationIndex of equation
int LMKAxServer::iDeleteGroup ( int  _iList,
int  _iRegionIndex 
)
slot

Ungroup action.

This operation ungroup some regions. The group is deleted, the regions itselfs not.

Parameters
_iListIndex of region list
_iRegionIndexThis group object
int LMKAxServer::iDeleteRegion ( int  _iList,
int  _iIndex 
)
slot

Delete a region.

Parameters
_iListIndex of region list
_iIndexIndex of the region to delete
int LMKAxServer::iDeleteStatistic ( int  _iTyp,
int  _iObject 
)
slot

Delete an existing statistic.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
int LMKAxServer::iExcelClose ( )
slot

Close Excel program.

int LMKAxServer::iExcelCopyItem ( int  _iIndex)
slot

Copy one item to Excel.

Parameters
_iIndexIndex of the entry
int LMKAxServer::iExcelCopySelected ( )
slot

Copy all selected items to Excel.

int LMKAxServer::iExcelGetItemProperties ( int  _iIndex,
int &  _irType,
QString &  _qrName,
QString &  _qrSheet,
int &  _irClear,
QString &  _qrRange,
int &  _irSelected 
)
slot

Get the informations about a data entry.

Parameters
_iIndexIndex of the entry
_irTypeReturns type of entry. Possible values:
  • 0 Image
  • 1 Table
  • 2 Graphic (e.g. sectional view or histogram)
  • 3 Diagram (e.g. 3D view or chromaticity diagram)
_qrNameReturns data name
_qrSheetReturns sheet name
_irClearReturns wether the sheet has to be cleared before export
_qrRangeReturns position of upper left corner of data, e.g. "A1"
_irSelectedIs item selected?
int LMKAxServer::iExcelGetNumberItems ( int &  _irNumber)
slot

Get number of data entries in Excel dialog.

Parameters
_irNumberreturns the number of data entries
int LMKAxServer::iExcelOpenFile ( QString  _qFileName)
slot

Open an Excel file for data export.

Parameters
_qFileNameFilename of Excel file
int LMKAxServer::iExcelSave ( )
slot

Save Excel file.

int LMKAxServer::iExcelSelectAll ( )
slot

Select all items in Excel dialog.

int LMKAxServer::iExcelSetItemProperties ( int  _iIndex,
QString  _qSheet,
int  _iClear,
QString  _qRange,
int  _iSelect 
)
slot

Set the informations about a data entry.

Parameters
_iIndexIndex of the entry
_qSheetChange sheet name (don't change current value if empty string)
_iClearShould sheet be cleared before export?
  • -1 = don't change behaviour
  • 0 = don't clear sheet
  • 1 = clear sheet
_qRangeChange position on sheet (don't change current value if empty string)
_iSelectShould item be selected in dialog?
  • -1 = don't change behaviour
  • 0 = deselect
  • 1 = select
int LMKAxServer::iExcelSetVisible ( int  _iVisible)
slot

Change visbility of Excel program.

Parameters
_iVisible0=invisible, 1=visible
int LMKAxServer::iExcelUnselectAll ( )
slot

Unselect all items in Excel dialog.

int LMKAxServer::iExecMenuPoint ( QString  _qMenuPoint)
slot

Execute any menu items of the Lmk4 program.

You can call every menu item of the main menu, which is available at this time (some points could be hidden or disabled sometimes!). Please not, that some menu items open dialogues or message boxes!

Parameters
_qMenuPointWished menu item. For example starts "Capture|SinglePic" a Singlepic capture. The strings have to be written in the same way, as they are shown within the program. Because the menu strings are language dependend, you have to regard this. You can either always use the English strings or you can use the strings of the current language setting. For example in the german version the singlepic capture can also be called with "Aufnahme|SinglePic".
int LMKAxServer::iExecTclCommand ( QString  _qCommand,
int &  _irReturn,
QString &  _qResult 
)
slot

Execute a TCL command by the embedded tcl interpreter.

Parameters
_qCommandCommand to be executed
_irReturnReturn value
_qResultResult string
int LMKAxServer::iExportBitmapToFile ( QString  bitmapName,
QString  fileName 
)
slot

Export a bitmap of a image, graphic or diagram to a bitmap file.

Parameters
bitmapNameName of bitmap (see iBitmapGetList)
fileNameName of file (*.bmp, *.jpg)
int LMKAxServer::iGetAperture ( int &  value)
slot

Get current aperture vaue.

Parameters
valueGet current aperture value
int LMKAxServer::iGetArcObjectResults ( int  _iObject,
int  _iClass,
double &  _drLength,
double &  _drWidth,
double &  _drDeflection,
double &  _drAbsMax 
)
slot

Get the results of an arc object in a grey image.

Parameters
_iObjectIndex of object
_iClassIndex of class
_drLengthDistance between the two end points of arc
_drWidthWidth of arc
_drDeflectionDeflection of arc
_drAbsMaxAbsolute maximum of luminance
int LMKAxServer::iGetArcObjectValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrY,
QStringList &  _slrValues 
)
slot

Get the values of the lightarc in a grey image.

The values are either sectional view or projection values.

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrYy-coordinates
_slrValuesArc values
int LMKAxServer::iGetAutomatic ( int &  _irAutomatic)
slot

Get the state of Automatic-Flag for exposure times.

If this flag is set, all exposure times will automatically adjusted if camera exposure time is reduced or enlarged.

Parameters
_irAutomaticReturn value: 1=option is switched on, 0=option is switched off
int LMKAxServer::iGetAutoscan ( int &  _irAutoscan)
slot

Get use of autoscan algorithm.

Is autoscan switched on?

Parameters
_irAutoscan=1 Autoscan is switched on, =0 Autoscan is switched of
int LMKAxServer::iGetCameraLensPath ( QString &  _qrCameraLensPath)
slot

Returns path to current camera lens combination.

Parameters
_qrCameraLensPathpath to current camera lens combination
int LMKAxServer::iGetCameraParameter ( QString  _qParameterName,
QString &  _qrParameterValue 
)
slot

Read access to camera parameter.

Parameters
_qParameterNameName of parameter
_qrParameterValueParameter value(s) as string

The function is only available in TechnoTeam developer mode. The function fails if no camera is connected.

int LMKAxServer::iGetClass ( int  _iTyp,
int  _iObject,
int  _iClass,
QString &  _qsClassName,
int &  _irVisible 
)
slot

Get name and visibility of class.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class
_qsClassNameName of class
_irVisibleClass visible in images, tables and diagrams
int LMKAxServer::iGetColor ( double  _iInputR,
double  _iInputG,
double  _iInputB,
double  _iReferenceR,
double  _iReferenceG,
double  _iReferenceB,
int  _iColorSpace,
double &  _iOutputColor1,
double &  _iOutputColor2,
double &  _iOutputColor3 
)
slot

Conversion of a color value from CIE-RGB to another color space.

The color value is given in CIE-RGB and is converted into a color value in the target color space. If there is a reference color needed for this color space, the reference color is also in CIE-RGB. If there is no reference color needed, the three variables can be set to zero.

The destination color space is given be the value of "_iColorSpace":

  • CIE-RGB, _iColorSpace = 1
  • S-RGB, _iColorSpace = 2
  • EBU-RGB, _iColorSpace = 4
  • XYZ, _iColorSpace = 16
  • Lxy, _iColorSpace = 32
  • Luv, _iColorSpace = 64
  • Lu'v', _iColorSpace = 128
  • L*u*v*, _iColorSpace = 256
  • C*h*s*_uv, _iColorSpace = 512
  • L*a*b*, _iColorSpace = 1024
  • C*h*_ab, _iColorSpace = 2048
  • HSV, _iColorSpace = 4096
  • HSI, _iColorSpace = 8192
  • WST, _iColorSpace = 16384
  • Lrg, _iColorSpace = 32768
  • LWS, _iColorSpace = 65536

The three components of the destionation color are available in _iOutputColor after the function call returned.

Parameters
_iInputRRed component of input color
_iInputGGreen component of input color
_iInputBBlue component of input color
_iReferenceRRed component of reference color
_iReferenceGGreen component of reference color
_iReferenceBBlue component of reference color
_iColorSpaceWished destination color space
_iOutputColor1First component of calculated color
_iOutputColor2Second component of calculated color
_iOutputColor3Third component of calculated color
int LMKAxServer::iGetColorCorrList ( QStringList &  _qList,
QStringList &  _qSelected 
)
slot

List of available color correction factors.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qListList of factors
_qSelectedList with "0" for "no selected" and "1" for "selected"
int LMKAxServer::iGetColorFactorsList ( QStringList &  _qList,
int &  _iSelect 
)
slot

List of available color matrices.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qListList of matrices
_iSelectList with "0" for "no selected" and "1" for "selected"
int LMKAxServer::iGetColorFactorsName ( int  _iIndex,
QString &  _qrName 
)
slot

Get name of color factor set.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

Parameters
_iIndexIndex of set
_qrNameName of color factor set
int LMKAxServer::iGetColorFactorsSize ( int &  _irNumber)
slot

Number of color factor sets.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

Parameters
_irNumberNumber of color factor sets
int LMKAxServer::iGetColorHistogramValues ( int  _iObject,
int  _iColor,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrValues 
)
slot

Get the values of the histogram in a color image.

The color space is always RGB.

Parameters
_iObjectIndex of object
_iColorWished color [0...2]
_irNumberNumber of values
_slrXx-coordinates
_slrValuesHistogram values
int LMKAxServer::iGetColorProjectionValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrY,
QStringList &  _slrValues1,
QStringList &  _slrValues2,
QStringList &  _slrValues3 
)
slot

Get the values of the projection in a color image.

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrYy-coordinates
_slrValues1Values of Color 1
_slrValues2Values of Color 2
_slrValues3Values of Color 3
int LMKAxServer::iGetColorRGB ( int  _iColorSpace,
double  _dInput1,
double  _dInput2,
double  _dInput3,
double  _dReferenceR,
double  _dReferenceG,
double  _dReferenceB,
double &  _dOutputColorR,
double &  _dOutputColorG,
double &  _dOutputColorB 
)
slot

Conversion of a color value from a color space to CIE-RGB.

The color value is given in a color space and is converted into a CIE-RGB value. If there is a reference color needed for this color space, the reference color is in CIE-RGB. If there is no reference color needed, the three variables can be set to zero.

The source color space is given be the value of "_iColorSpace":

  • CIE-RGB, _iColorSpace = 1
  • S-RGB, _iColorSpace = 2
  • EBU-RGB, _iColorSpace = 4
  • XYZ, _iColorSpace = 16
  • Lxy, _iColorSpace = 32
  • Luv, _iColorSpace = 64
  • Lu'v', _iColorSpace = 128
  • L*u*v*, _iColorSpace = 256
  • C*h*s*_uv, _iColorSpace = 512
  • L*a*b*, _iColorSpace = 1024
  • C*h*_ab, _iColorSpace = 2048
  • HSV, _iColorSpace = 4096
  • HSI, _iColorSpace = 8192
  • WST, _iColorSpace = 16384
  • Lrg, _iColorSpace = 32768
  • LWS, _iColorSpace = 65536
Parameters
_iColorSpaceGiven source color space
_dInput1First component of input color
_dInput2Second component of input color
_dInput3Third component of input color
_dReferenceRRed component of reference color in RGB
_dReferenceGGreen component of reference color in RGB
_dReferenceBBlue component of reference color in RGB
_dOutputColorRRed component of calculated color
_dOutputColorGGreen component of calculated color
_dOutputColorBThird component of calculated color
int LMKAxServer::iGetColorSecViewValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrY,
QStringList &  _slrValues1,
QStringList &  _slrValues2,
QStringList &  _slrValues3 
)
slot

Get the values of the sectional view in a color image.

The color space used is the same as in the image

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrYy-coordinates
_slrValues1Wished values of color 1 as string list
_slrValues2Wished values of color 2 as string list
_slrValues3Wished values of color 3 as string list
int LMKAxServer::iGetConvertingUnits ( QString &  _qName,
QString &  _qUnit,
double &  _dFactor 
)
slot

Get converting informations.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qNameName used, default is "L"
_qUnitUnit used, default is "cd/m^2"
_dFactorFactor used, default is "1"
int LMKAxServer::iGetDarkening ( int &  _iDarkening,
int &  _iSwitchMonitorOff,
double &  _dTimeOut 
)
slot

Get the state of darkening computer monitor while capturing.

Parameters
_iDarkening1=darkening monitor, 2=no darkening
_iSwitchMonitorOff1=If darkening is wished, switch monitor off
_dTimeOutWait time in seconds after switch off before start of capture
int LMKAxServer::iGetEquation ( int  _iTyp,
int  _iObject,
int  _iEquation,
QString &  _qsName,
QString &  _qsFormula,
int &  _iWhereToShow,
int &  _irValid,
double &  _drResult 
)
slot

Get an equation and its result.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iEquationIndex of equation
_qsNameName of equation
_qsFormulaFormula to calculate
_iWhereToShowWhere to show in result table
_irValidValid result?
_drResultResult of calculation
int LMKAxServer::iGetErrorInformation ( QString &  _rErrorInformation)
slot

More precisely error description.

Parameters
_rErrorInformationString with error stack information
int LMKAxServer::iGetFilterWheel ( int &  _irCurrentFilter,
QString &  _srCurrentFilter 
)
slot

Determine filter state.

If there is no filter wheel, the function returns of course an error code.

Parameters
_irCurrentFilterPosition of filter wheel
_srCurrentFilterName of current filter
int LMKAxServer::iGetFlagsStatistic ( int  _iTyp,
int  _iObject,
int &  _irGeo,
int &  _irPhoto,
int &  _irMinMax,
int &  _irTime,
int &  _irHorseshoe 
)
slot

Get Flags for statistic evaluations.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irGeoCalculate geometric center
_irPhotoCalculate photometric center
_irMinMaxCalculate position of min max
_irTimeGet time flags (OR combination of bits):
  • 1 Mean
  • 2 Dispersion
  • 4 Min
  • 8 Max
_irHorseshoeColor diagram
int LMKAxServer::iGetFlagsStatistic2 ( int  _iTyp,
int  _iObject,
int &  _irGeo,
int &  _irPhoto,
int &  _irMinMax,
int &  _irTime,
int &  _irMaxCountTime,
int &  _irHorseshoe 
)
slot

Get Flags for statistic evaluations.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irGeoCalculate geometric center
_irPhotoCalculate photometric center
_irMinMaxCalculate position of min max
_irTimeGet time flags (OR combination of bits):
  • 1 Mean
  • 2 Dispersion
  • 4 Min
  • 8 Max
_irMaxCountTimeMaximum number of time statistic values
_irHorseshoeColor diagram
int LMKAxServer::iGetFocus ( double &  value)
slot

Get current focus position.

Parameters
valueCurrent focus position in percent
int LMKAxServer::iGetFocusFactorList ( QStringList &  _qList,
int &  _iSelect 
)
slot

List of available focus factors.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qListList of factors
_iSelectIndex of currently used factor, indexes begin with "0"
int LMKAxServer::iGetFocusParameter ( int &  subsampling,
int &  top,
int &  bottom,
int &  left,
int &  right 
)
slot

Get parameter for autofocus.

Parameters
subsamplingSubsampling of camera image, possible values are 1, 2 and 4
topFirst row of region
bottomLast row of region
leftFirst column of region
rightLast column of region
int LMKAxServer::iGetGeometricStatistic ( int  _iTyp,
int  _iObject,
int  _iClass,
double &  _drX,
double &  _drY 
)
slot

Get geometric center of object or class.

Geometric calculation flag has to be set before.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_drXx-coordinate of center
_drYy-coordinate of center
int LMKAxServer::iGetGreyFilterList ( QStringList &  _qList,
QStringList &  _qSelected 
)
slot

List of available grey filters.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qListList of filters
_qSelectedList with "0" for "no selected" and "1" for "selected"
int LMKAxServer::iGetGreyHistogramValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrValues 
)
slot

Get the values of the histogram in a grey image.

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrValuesHistogram values
int LMKAxServer::iGetGreyProjectionValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrY,
QStringList &  _slrValues 
)
slot

Get the values of the projection in a grey image.

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrYy-coordinates
_slrValuesValues
int LMKAxServer::iGetGreySecViewValues ( int  _iObject,
int &  _irNumber,
QStringList &  _slrX,
QStringList &  _slrY,
QStringList &  _slValues 
)
slot

Get the values of the sectional view in a grey image.

Parameters
_iObjectIndex of object
_irNumberNumber of values
_slrXx-coordinates
_slrYy-coordinates
_slValuesWished values as string list
int LMKAxServer::iGetImageCaptureParameter ( int  _iImage,
int &  _irHaveParam,
QStringList &  _qslParamNames,
QStringList &  _qslParamValues 
)
slot

Get information of last capture to this image.

Parameters
_iImageIndex of image
_irHaveParam1=Have param, 0=have not
_qslParamNamesList of parameter names
_qslParamValuesList of associated values
int LMKAxServer::iGetImageName ( int  _iImageIndex,
QString &  _qsImageName 
)
slot

Determines the name of an image.

See also comment on function iGetPermanentImageName(). See also iSetImageName().

Parameters
_iImageIndex-3 for camera image, -2 for luminance image, -1 for color image, from 0 on for evaluation images
_qsImageNameReturn value = wished image name
int LMKAxServer::iGetIndexOfImage ( QString  _qName,
int &  _irIndex 
)
slot

Get index of image given image name.

Parameters
_qNameName of image
_irIndexIndex of image
  • -3 Camera image (Name=_CAMPIC_)
  • -2 Luminance image (Name=_LUMPIC_)
  • -1 Color image (Name=_COLPIC_)
  • 0...N Evaluation image
int LMKAxServer::iGetIndexOfRegion ( int  _iList,
QString  _qName,
int &  _irIndex 
)
slot

Get index of region given region name.

Parameters
_iListInput: Index of region list (same as image index)
_qNameInput: Name of region
_irIndexOutput: Index of this region
int LMKAxServer::iGetIntegrationTime ( double &  _drCurrentTime,
double &  _drPreviousTime,
double &  _drNextTime,
double &  _drMinTime,
double &  _drMaxTime 
)
slot

Determine current exposure time and other time parameters.

Parameters
_drCurrentTimeCurrent integration time
_drPreviousTimeNext smaller (proposed) time
_drNextTimeNext larger (proposed) time
_drMinTimeMinimal possible time
_drMaxTimeMaximal possible time
int LMKAxServer::iGetLensID ( QString &  lensID)
slot

Get ID of lens.

Parameters
lensIDreturns the ID of the lens
int LMKAxServer::iGetMaxCameraTime ( double &  _drMaxCameraTime)
slot

Determine the maximum possible exposure time.

Normally this time is restricted by camera properties. In some cases it could be usefull to use an even smaller maximum exposure time.

Parameters
_drMaxCameraTimeMaximum time is currently?
int LMKAxServer::iGetMinMaxAperture ( int &  minimum,
int &  maximum 
)
slot

Get range of aperture values.

Parameters
minimumsmallest available aperture value
maximumlargest available aperture value
int LMKAxServer::iGetMinMaxStatistic ( int  _iTyp,
int  _iObject,
int  _iClass,
double &  _drMinX,
double &  _drMinY,
double &  _drMinV,
double &  _drMaxX,
double &  _drMaxY,
double &  _drMaxV 
)
slot

Get photometric center of object or class.

Photometric calculation flag has to be set before.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_drMinXx-coordinate of minimum
_drMinYy-coordinate of minimum
_drMinVValue of minimum
_drMaxXx-coordinate of maximum
_drMaxYy-coordinate of maximum
_drMaxVValue of maximum
int LMKAxServer::iGetModulationFrequency ( double &  _drModFrequency)
slot

Get the modulation frequency.

Parameters
_drModFrequencyFrequency of light source. 0 if no modulation is to be concerend
int LMKAxServer::iGetNumberImages ( int &  _irNumber)
slot

Determine number of evaluation images.

Parameters
_irNumberCurrent number of evaluation images
int LMKAxServer::iGetNumClasses ( int  _iTyp,
int  _iObject,
int &  _irNumClasses 
)
slot

Get the number of classes.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irNumClassesNumber of classes
int LMKAxServer::iGetNumEquations ( int  _iTyp,
int  _iObject,
int &  _irNumEquations 
)
slot

Get the number of line equations.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irNumEquationsNumber of equations
int LMKAxServer::iGetPermanentImageName ( int  _iImageIndex,
QString &  _qsImageName 
)
slot

Determines the name of an image.

The difference between this function and iGetImageName() is, that the previous function gives language dependent image names in the case of camera, luminance and color images. In these cases iGetPermanentImageName() gives always the same names: "_CAMPIC_", "_LUMIC_" and "_COLPIC_". If you plan to use the LabSoft either in german or in english you should prefer iGetPermanentImageName() instead of iGetImageName() to avoid mistakes.

Parameters
_iImageIndex-3 for camera image, -2 for luminance image, -1 for color image, from 0 on for evaluation images
_qsImageNameReturn value = wished image name
int LMKAxServer::iGetPhotometricStatistic ( int  _iTyp,
int  _iObject,
int  _iClass,
double &  _drX,
double &  _drY 
)
slot

Get photometric center of object or class.

Photometric calculation flag has to be set before.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_drXx-coordinate of center
_drYy-coordinate of center
int LMKAxServer::iGetPositionRegionName ( int  list,
int  index,
int &  position 
)
slot

Read position of region name.

Parameters
listIndex of region list
indexIndex of the region
positionreturn position of region name
  • 0 invisible
  • 1 topright
  • 2 right
  • ... 8 top
  • 9 middle
int LMKAxServer::iGetProgramInfo ( QString &  _qrProgramType,
QString &  _qrProgramVersion,
QString &  _qrCameraType,
QString &  _qrCameraNumber,
QString &  _qrLensNumber 
)
slot

Get some information about program version and camera current used.

Parameters
_qrProgramTypeType of program version
_qrProgramVersionNumber of program version
_qrCameraTypeType of camera
_qrCameraNumberNumber of camera
_qrLensNumberNumber of lens
int LMKAxServer::iGetPropertiesRegion ( int  _iList,
int  _iIndex,
int &  _irType,
int &  _irPoints,
QStringList &  _slX,
QStringList &  _slY 
)
slot

Get the properties of a region.

Parameters
_iListIndex of region list
_iIndexIndex of the region
_irTypeType?
_irPointsPoint number?
_slXx-coordinates?
_slYy-coordinates?
int LMKAxServer::iGetQuantilObjectResults ( int  _iObject,
double &  _drQuantile1,
double &  _drQuantile2,
double &  _drQuantile3 
)
slot

Get the results of an quantile object in a grey image.

Parameters
_iObjectIndex of object
_drQuantile1Value of Quantile 1
_drQuantile2Value of Quantile 2
_drQuantile3Value of Quantile 3
int LMKAxServer::iGetRawFocus ( int &  value)
slot

Get current focus position.

Parameters
valueCurrent focus position absolute
int LMKAxServer::iGetRawMinMaxFocus ( int &  minimum,
int &  maximum 
)
slot

Get range of focus values.

Parameters
minimumsmallest available focus value
maximumlargest available focus value
int LMKAxServer::iGetRecalibrationFactor ( double &  _dFactor)
slot

Get recalibration factor.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_dFactorFactor currently used, default is "1"
int LMKAxServer::iGetRegionListSize ( int  _iList,
int &  _irSize 
)
slot

Determine the number of regions in a list.

Parameters
_iListIndex of region list
_irSizeNumber of regions within
int LMKAxServer::iGetRegionName ( int  _iList,
int  _iIndex,
QString &  _qrName 
)
slot

Read region name.

Parameters
_iListIndex of region list
_iIndexIndex of the region
_qrNameName
int LMKAxServer::iGetScatteredLight ( int &  _irScatteredLight)
slot

Is scattered light correction switched on?

Parameters
_irScatteredLight=0 Switch on of scattered light correction, =1 switch on.
int LMKAxServer::iGetSelectedImage ( int &  image)
slot

Index of current image on top.

Parameters
imageIndex of selected image
int LMKAxServer::iGetSmear ( int &  _irSmear)
slot

Get the parameter for smear correction.

Parameters
_irSmear0 means no smear correction, otherwise smear correction with at least 10 dark images captured. >10 number of dark images.
int LMKAxServer::iGetStandardStatistic ( int  _iStatistic,
int  _iObject,
int  _iClass,
int &  _irSize,
double &  _drMin,
double &  _drMax,
double &  _drMean,
double &  _drVar 
)
slot

Determine parameter of the standard statistic.

Standard statistic is calculated in nearly all statistic types in the same way like in the standard statistic type itself.

Parameters
_iStatisticIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_irSizePixel number?
_drMinMinimum is?
_drMaxMaximum is?
_drMeanMean value is?
_drVarVariance is?
int LMKAxServer::iGetStandardStatistic2 ( int  _iStatistic,
int  _iObject,
int  _iClass,
double &  _drArea,
double &  _drMin,
double &  _drMax,
double &  _drMean,
double &  _drVar 
)
slot

Determine parameter of the standard statistic.

Standard statistic is calculated in nearly all statistic types in the same way like in the standard statistic type itself.

Parameters
_iStatisticIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_drAreaArea is?
_drMinMinimum is?
_drMaxMaximum is?
_drMeanMean value is?
_drVarVariance is?
int LMKAxServer::iGetStatisticObject ( int  _iStatistic,
int  _iObject,
int &  _iImage,
int &  _iRegion 
)
slot

Determine image and region a statistic object is calculated for.

The index of the image and the index of the region list are always identical.

Parameters
_iStatisticIndex of statistic type
_iObjectIndex of object
_iImageImage number is? -3,...,N
_iRegionRegion number is?
int LMKAxServer::iGetStatisticParameter ( int  _iTyp,
int  _iObject,
int &  _irNumberParam,
QStringList &  _slrParamList 
)
slot

Read the parameters of a statistic.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irNumberParamGet number of parameters
_slrParamListGet parameter list
int LMKAxServer::iGetStatisticSize ( int  _iStatistic,
int &  _irSize 
)
slot

Determine number of objects in a statistic vector.

Parameters
_iStatisticIndex of statistic type
_irSizeSize is?
int LMKAxServer::iGetSuppressOverflow ( int &  _irSuppress)
slot

Get the state of suppress overflow warning in measurement series.

Parameters
_irSuppressReturn value: 1=suppress warning, 0=allow warning
int LMKAxServer::iGetSuppressProgressDialog ( int &  _irSuppress)
slot

Get the state of suppressing view of progress dialog.

Parameters
_irSuppressReturn value: 1=Dialog is hided, 0=Dialog is shown
int LMKAxServer::iGetTimeSizeStatistic ( int  _iTyp,
int  _iObject,
int &  _irSize 
)
slot

Number of elements of a time statistics.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irSizeNumber of elements
int LMKAxServer::iGetTimeSummaryStatistic ( int  _iTyp,
int  _iObject,
int  _iClass,
int  _iWhichEl,
int &  _irCount,
double &  _drMin,
double &  _drMax,
double &  _drMean,
double &  _drVar 
)
slot

Summary of a time statistics.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_iWhichElFor which element summary is needed: -0 number of pixels -1 mean values -2 variances -3 minima -4 maxima
_irCountNumber of time values
_drMinMinimum
_drMaxMaximum
_drMeanMean
_drVarVariance
int LMKAxServer::iGetTimeValuesStatistic ( int  _iTyp,
int  _iObject,
int  _iClass,
int  _iWhichEl,
QStringList &  _qslTime,
QStringList &  _qslValues 
)
slot

List of time statistic times and values.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class or color
_iWhichElFor which element summary is needed: -0 number of pixels -1 mean values -2 variances -3 minima -4 maxima
_qslTimeList of times
_qslValuesList of values
int LMKAxServer::iGetTrigger ( int &  type)
slot

Is trigger mode switched on or off for Lmk6 camera?

Parameters
type- 0 No trigger
  • 1 Internal trigger
  • 2 External trigger
  • 3 Image trigger
int LMKAxServer::iGetTriggerCommonParameter ( double &  timeout,
double &  capturedistance,
double &  exposuredelay,
int &  triggerhigh,
int &  strobehigh 
)
slot

Get common trigger parameter for Lmk6 camera.

Parameters
timeoutTimout in seconds (external and image trigger)
capturedistanceDistance between captures in seconds (internal trigger)
exposuredelayDelay between trigger signal and exposure in seconds
triggerhigh= 1 rising edge of trigger signal, = 0 alling edge of trigger signal
strobehigh= 1 rising edge of strobe signal, = 0 alling edge of strobe signal
int LMKAxServer::iGetTriggerImageParameter ( int &  top,
int &  bottom,
int &  left,
int &  right,
int &  reserved,
int &  level,
double &  exposure 
)
slot

Get image trigger parameter for Lmk6 camera.

Parameters
toptop edge of region in the image to detect image trigger
bottombottom edge of region in the image to detect image trigger
leftleft edge of region in the image to detect image trigger
rightright edge of region in the image to detect image trigger
reservedParameter is currently not used
levelGrey threshold for image trigger in camera image.
exposureExposure time for image trigger (it is different fom normal exposure time)
int LMKAxServer::iGetTriggerMode ( int &  _irTriggerMode,
double &  _drTimeout 
)
slot

Is trigger mode switched on?

This function is not useable for Lmk6 cameras (TTQ, TTS, TTT, ...)

Parameters
_irTriggerMode=1 Switch trigger mode on, =0 switch off
_drTimeoutTimeout in seconds in trigger mode
int LMKAxServer::iGetTriggerStrobeParameter ( int &  parametrizable,
double &  delay,
double &  duration 
)
slot

Get strobe trigger parameter for Lmk6 camera.

Parameters
parametrizable= 0, strobe signal while capture is running, = 1 parametrizable strobe signal
delayDelay between exposure and strobe signal in seconds
durationDuration of strobe signal in seconds
int LMKAxServer::iGetViewPalette ( int  image,
int &  palette 
)
slot

Get index of used palette.

The function is only available for grey scale images.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
paletteReturns index of the used palette:
  • 0 grey
  • 1 overflow
  • 2 Color
  • 3 Lmk1
  • 4 Lmk2
  • 5 Blue
  • 6 Green
  • 7 Red
  • 8 Isocolor
  • 9 Userdefined
int LMKAxServer::iGetViewScaling ( int  image,
double &  scaling,
double &  minimum,
double &  maximum 
)
slot

Get used scaling of image view.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
scalingReturns decades of scaling:
  • 0 linear
  • 2...8 logarithmic
minimumReturns minimum of scaling (valid only for linear scaling)
maximumReturns maximum of scaling

If minimum = maximum = 0 then automatic scaling.

int LMKAxServer::iGetViewScalingRect ( int  image,
int &  top,
int &  bottom,
int &  left,
int &  right 
)
slot

Get used scaling rectangle of image view.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
topReturns upper border of scaling rect
bottomReturns lower border of scaling rect
leftReturns left border of scaling rect
rightReturns right border of scaling rect

If top = bottom = left = right = 0 then whole image.

int LMKAxServer::iGetViewZoom ( int  image,
double &  zoom,
int &  top,
int &  left 
)
slot

Get current zooming parameters.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
zoomReturns current zooming factor (0.02 .... 50.0)
topReturns upper border
leftReturns left border

If zoom = 0 then always show whole image.

int LMKAxServer::iGrab ( )
slot

Capturing of a camera image

int LMKAxServer::iHaveControllableLens ( int &  have)
slot

Controllable lens connected ?

Parameters
have1 = available, 0 = not available
int LMKAxServer::iHaveStatistic ( int  _iImage,
int  _iRegion,
int &  _irHave,
int &  _irType,
int &  _irIndex 
)
slot

Proof, if a statistic exists for a image / region / statistic type.

Parameters
_iImageImage
_iRegionIndex of region in this image
_irHaveStatistic object available?
_irTypeOf which type?
_irIndexIndex in statistic list?
int LMKAxServer::iHighDynPic ( double  _dMaxTime,
double  _dMinTime,
double  _dFactor,
int  _iSmear,
double  _dModFrequency 
)
slot

HighDyn-Leuchtdichtebild-Aufnahme.

Parameters
_dMaxTimeLargest exposure time
_dMinTimeSmallest exposure time (proposal: 0.0)
_dFactorFactor between two times (proposal 3.0)
_iSmearNumber of smear images (0=no smear correction)
_dModFrequencyModulation frequency (0=no modulation)
int LMKAxServer::iHighDynPic2 ( double  _dMaxTime,
double  _dMinTime,
double  _dFactor,
int  _iPicCount 
)
slot

HighDyn capturing for luminance image.

Parameters
_dMaxTimeLargest exposure time
_dMinTimeSmallest exposure time (proposal: 0.0)
_dFactorFactor between two times (proposal 3.0)
_iPicCountNumber of shots per integration time
int LMKAxServer::iHighDynPic3 ( double  _dExposureTime,
double  _dStartRatio,
double  _dFactor,
int  _iCountPic 
)
slot

HighDyn capturing for luminance image.

Parameters
_dExposureTimeExposure time (like in multipic algorithm).
_dStartRatioExposure time is multiplied with this parameter to determine the longest exposure time. The default value for this parameter should be 10.
_dFactorThe exposure time is decreased by this factor until there is no overdrive in the images captured. Proposal: 3.0
_iCountPicNumber of captures for every exposure time.
int LMKAxServer::iImageCreate ( int  _iColorImage,
QString  _qImageName,
int &  _irIndex 
)
slot

Creates an evaluation image.

The image gets the size of the previous image (luminance image or previous evaluation image).

Parameters
_iColorImage0=Grey image, 1=Color image
_qImageNameWished image name
_irIndexIndex of the image created
int LMKAxServer::iImageDelete ( int  _iIndex)
slot

Deletes an evaluation image.

See also iImageCreate().

Parameters
_iIndexIndex of the image
int LMKAxServer::iImageGetDumpToFile ( int  _iImage,
int  _iFirstLine,
int  _iLastLine,
int  _iFirstColumn,
int  _iLastColumn,
QString  _FileName 
)
slot

Get a memory dump of a image region into a file.

The pixels themselves are float values (4 bytes per value) line by line. In the case of a color image the color values of every pixel are subsequently (blue - green - red).

Parameters
_iImageIndex of image
_iFirstLineFirst wished image line of dump
_iLastLineLast wished image line of dump
_iFirstColumnFirst wished image column of dump
_iLastColumnLast wished image column of dump
_FileNameCopy image there

The size of the dump is (_iLastLine - _iFirstLine ) * (_iLastColumn - _iFirstColumn + 1 ) * 4 bytes in the case of a grey image. The dump of a color image is three times larger.

If the coordinates of the lines and columns are outside the image, the function returnes an error.

int LMKAxServer::iImageGetDumpToMemory ( int  _iImage,
int  _iFirstLine,
int  _iLastLine,
int  _iFirstColumn,
int  _iLastColumn,
QByteArray &  _rDump 
)
slot

Get a memory dump of a image region into memory.

The pixels themselves are float values (4 bytes per value) line by line. In the case of a color image the color values of every pixel are subsequently (blue - green - red).

Parameters
_iImageIndex of image
_iFirstLineFirst wished image line of dump
_iLastLineLast wished image line of dump
_iFirstColumnFirst wished image column of dump
_iLastColumnLast wished image column of dump
_rDumpCopy image there

The size of the dump is (_iLastLine - _iFirstLine ) * (_iLastColumn - _iFirstColumn + 1 ) * 4 bytes in the case of a grey image. The dump of a color image is three times larger.

If the coordinates of the lines and columns are outside the image, the function returnes an error.

int LMKAxServer::iImageGetPixelColor ( int  _iImage,
int  _iLine,
int  _iColumn,
double &  _drRed,
double &  _drGreen,
double &  _drBlue 
)
slot

Get a pixel value of a color image.

Parameters
_iImageIndex of image
_iLineLine index
_iColumnColumn index
_drRedGets the red component of the pixel value
_drGreenGets the green component of the pixel value
_drBlueGets the blue component of the pixel value

The function returns an error if the pixel position is outside or the image is a color image.

int LMKAxServer::iImageGetPixelGrey ( int  _iImage,
int  _iLine,
int  _iColumn,
double &  _drValue 
)
slot

Get a pixel value of a grey image.

Parameters
_iImageIndex of image
_iLineLine index
_iColumnColumn index
_drValueGets the pixel value

The function returns an error if the pixel position is outside or the image is a color image.

int LMKAxServer::iImageGetRefColorInRGB ( int  _iImage,
double &  _drRed,
double &  _drGreen,
double &  _drBlue 
)
slot

Get the reference color of an image.

Parameters
_iImageIndex of the image
_drRedReturns red component of reference color
_drGreenReturns green component of reference color
_drBlueReturns blue component of reference color
int LMKAxServer::iImageGetSize ( int  _iImage,
int &  _irFirstLine,
int &  _irLastLine,
int &  _irFirstColumn,
int &  _irLastColumn,
int &  _irDimensions 
)
slot

Get image size and parameter.

These informations are needed for the other access functions. See also iImageSetSize().

Parameters
_iImageIndex of image to inform about
_irFirstLineGets the index of the first line
_irLastLineGets the index of the last line
_irFirstColumnGets the index of the first column
_irLastColumnGets the index of the last column
_irDimensions1 in case of grey images, 3 in case of color images

The number of lines is _irLastLine - _irFirstLine + 1. The number of columns is _irLastColumn - _irFirstColumn + 1.

int LMKAxServer::iImageSetRefColorInRGB ( int  _iImage,
double  _dRed,
double  _dGreen,
double  _dBlue 
)
slot

Set the reference color of an image.

Parameters
_iImageIndex of the image
_dRedRed component of reference color
_dGreenGreen component of reference color
_dBlueBlue component of reference color
int LMKAxServer::iImageSetSize ( int  _iIndex,
int  _iFirstLine,
int  _iLastLine,
int  _iFirstColumn,
int  _iLastColumn 
)
slot

Changes the size of an existing image.

See also iImageGetSize().

Parameters
_iIndexIndex of the image
_iFirstLineWished first line
_iLastLineWished last line
_iFirstColumnWished first column
_iLastColumnWished last column
int LMKAxServer::iImportHDF5Protocol ( QString  _qPathName)
slot

Import a HDF5 protocol.

Parameters
_qPathNameLoad from this file. File extension: ".h5"
Returns
0=ok, !=0 Error code
int LMKAxServer::iIsOpen ( )
slot

Application is running?

Returns
0=Application is not running, 1=Application is running
int LMKAxServer::iIsRegionSelected ( int  _iList,
int  _iRegion,
int &  _irIsSelected 
)
slot

Is a region selected?

Parameters
_iListIndex of region list
_iRegionIndex of region
_irIsSelectedSelected?
int LMKAxServer::iIsTriggerAvailable ( int &  interntrigger,
int &  externtrigger,
int &  imagetrigger 
)
slot

Which trigger modi for Lmk6 camera are available?

Parameters
interntriggerIs intern trigger mode avaiable?
externtriggerIs extern trigger mode avaiable?
imagetriggerIs image trigger mode avaiable?

See LabSoft handbook how trigger modi are made available.

int LMKAxServer::iLEXanglesFromImage ( )
slot

Set angle area from image coordinate system.

int LMKAxServer::iLEXanglesFromSelRect ( )
slot

Set angle area from selected rectangle coordinate system.

int LMKAxServer::iLEXcloseDialog ( )
slot

Closes dialog for LID export into a file.

int LMKAxServer::iLEXexecute ( QString  _qFileName)
slot

Export of LID into a file.

The file extension determines the file format:

  • *.ldt Eulumndat
  • *.ies IES file format
Parameters
_qFileNameFile name for export of data
int LMKAxServer::iLEXgetAngles ( double &  _dThetaTop,
double &  _dThetaBottom,
double &  _dThetaDelta,
double &  _dPhiMin,
double &  _dPhiMax,
double &  _dPhiDelta 
)
slot

Get current angle area from dialog

Parameters
_dThetaTopMinimum theta angle
_dThetaBottomMaximum theta angle
_dThetaDeltaSteps in theta direction
_dPhiMinMinimum phi angle
_dPhiMaxMaximum phi angle
_dPhiDeltaSteps in phi direction
int LMKAxServer::iLEXsetAngles ( double  _dThetaTop,
double  _dThetaBottom,
double  _dThetaDelta,
double  _dPhiMin,
double  _dPhiMax,
double  _dPhiDelta 
)
slot

Select angle area for export file.

Be careful: The meaning of _dThetaTop and _dThetaBottom varies in dependency of the used coordinate system "A" or "C".

Parameters
_dThetaTopMinimum theta angle
_dThetaBottomMaximum theta angle
_dThetaDeltaSteps in theta direction
_dPhiMinMinimum phi angle
_dPhiMaxMaximum phi angle
_dPhiDeltaSteps in phi direction
int LMKAxServer::iLEXsetCoordSystem ( QString  _qSrcCoordSystem,
QString  _qDstCoordSystem 
)
slot

Types of coordinate system orientation used.

Parameters
_qSrcCoordSystemType of source coordinate system (A or C)
_qDstCoordSystemType of target coordinate system (A or C)
int LMKAxServer::iLEXsetDescription ( QString  _qDescription,
QString  _qNumber,
QString  _qLaboratory,
QString  _qManufactory,
QString  _qUserName 
)
slot

Descriptions for export file.

All strings are free chooseable, no special content is needed

Parameters
_qDescriptionDescription string
_qNumberNumber of test
_qLaboratoryLaboratory
_qManufactoryManufacturer
_qUserNameUser name
int LMKAxServer::iLEXsetImage ( QString  _qImageName)
slot

Select image for export

Parameters
_qImageNameName of LID image to export.
int LMKAxServer::iLEXsetOrigin ( double  _dThetaDiff,
int  _iThetaSign,
double  _dPhiDiff,
int  _iPhiSign 
)
slot

Modification of origin of coordinate system.

Parameters
_dThetaDiffModification in theta
_iThetaSignOrientation in theta
_dPhiDiffModification in phi
_iPhiSignOrientation in phi
int LMKAxServer::iLEXsetParameter ( double  _dTemperatur,
double  _dWattage,
double  _dVoltage,
double  _dCurrent,
double  _dLightFlux 
)
slot

Parameters for export file.

All values are free chooseable, no special content is needed

Parameters
_dTemperaturTemperature
_dWattageWattage
_dVoltageVoltage
_dCurrentCurrent
_dLightFluxLightflux
int LMKAxServer::iLIDcloseDialog ( )
slot

Closes LID dialog.

int LMKAxServer::iLIDexecute ( int  _iIndex)
slot

Executes a LID calculation with one of the parameter set.

Parameters
_iIndexuse this data set in calculation
int LMKAxServer::iLIDgetCountParam ( int &  _iCount)
slot

Get number of available parameter set in LID calculation dialog.

Parameters
_iCountReturn number of data sets
int LMKAxServer::iLIDgetParamName ( int  _iIndex,
QString &  _qParamName 
)
slot

Get name of a parameter set in LID calculation dialog.

Parameters
_iIndexfor this index of data set
_qParamNamereturn name of data set
int LMKAxServer::iLIDMergeCaptureProcess ( int  _iLIDIndex,
double  _dPhiMin,
double  _dPhiMax,
double  _dPhiStep,
double  _dThetaMin,
double  _dThetaMax,
double  _dThetaStep,
int  _iShowPositioningMessageBoxes 
)
slot

Captures a big LID image out of several images.

Parameters
_iLIDIndexIndex of LID transformation dataset (0 indexed)
_dPhiMinField of view of the result merged LID image - PhiMin
_dPhiMaxField of view of the result merged LID image - PhiMax
_dPhiStepField of view of the result merged LID image - PhiStep
_dThetaMinField of view of the result merged LID image - ThetaMin
_dThetaMaxField of view of the result merged LID image - ThetaMax
_dThetaStepField of view of the result merged LID image - ThetaStep
_iShowPositioningMessageBoxesGUI messageboxes for desired positions (0= dont show; 1= show)
int LMKAxServer::iLIDopenDialog ( QString  _qFileName)
slot

Opens dialog for LID calculation.

Parameters
_qFileNamePath and name of lid2.ini
int LMKAxServer::iLoadCaptureParameterSet ( QString  _qParameterSet)
slot

Load predefined parameter set for the next captures.

Possible parameter sets can defined via the menu point "Capture | properties". Make all your decisions there and save the parameter set via the button "Save" in this dialog. This predefined parameter sets can then be used in the function iLoadCaptureParameterSet().

Loading and saving of capture parameter sets is described in the manual in the section "Capturing images | Capture parameterization". See at the end of this section the subsection "Loading and saving capture parameters".

Parameters
_qParameterSetThe name of the parameter set.
int LMKAxServer::iLoadImage ( int  _iNumber,
QString  _qFileName 
)
slot

Load image.

Attention while loading into camera image: The size of this image can not be changed in the program.

Parameters
_iNumberIndex of image to load
_qFileNameSource file name
int LMKAxServer::iLoadIsoPalette ( int  image,
QString  filename 
)
slot

Load iso color palette from a file.

The function is only available for grey scale images.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
filenameLoad palette values from there
int LMKAxServer::iLoadProtokoll ( QString  _qPathName)
slot

Load a protocol from a file.

Parameters
_qPathNameLoad from this file. File extension: ".ttcs"
Returns
0=ok, !=0 Error code
int LMKAxServer::iLoadRegionList ( int  _iList,
QString  _qFileName,
int  _iOverwrite 
)
slot

Load region list.

The same file formats (csv, txt) available like in menu point "Regions | Load | *".

Parameters
_iListIndex of region list
_qFileNameDestination file name
_iOverwriteOverwrite existing regions, otherwise append.
int LMKAxServer::iLoadRegionListCS ( int  _iList,
QString  _qFileName,
int  _iOverwrite 
)
slot

Load region list in units of coordinate system.

The same file formats (csv, txt) available like in menu point "Regions | Load | *".

Parameters
_iListIndex of region list
_qFileNameDestination file name
_iOverwriteOverwrite existing regions, otherwise append.
int LMKAxServer::iLoadUserPalette ( int  image,
QString  filename 
)
slot

Load iso color palette from a file.

The function is only available for grey scale images.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
filenameLoad palette values from there
int LMKAxServer::imageArithmeticI ( QString  _qCode,
int  _iSrcImage,
int  _iDstImage 
)
slot

Image arithmetic with one source image and one destination image.

Parameters
_qCodeOperation code, see table
_iSrcImageIndex of source image
_iDstImageIndex of destination image
int LMKAxServer::imageArithmeticII ( QString  _qCode,
int  _iSrcImage1,
int  _iSrcImage2,
int  _iDstImage 
)
slot

Image arithmetic with two source images and one destination image.

Parameters
_qCodeOperation code, see table
_iSrcImage1Index of first source image
_iSrcImage2Index of second source image
_iDstImageIndex of destination image
int LMKAxServer::imageArithmeticIP1 ( QString  _qCode,
int  _iSrcImage,
QString  _qParameter,
int  _iDstImage 
)
slot

Image arithmetic with one source image, one parameter and one destination image.

Parameters
_qCodeOperation code, see table
_iSrcImageIndex of source image
_qParameterParameter of algorithm
_iDstImageIndex of destination image
int LMKAxServer::imageArithmeticIP3 ( QString  _qCode,
int  _iSrcImage,
QString  _qRed,
QString  _qGreen,
QString  _qBlue,
int  _iDstImage 
)
slot

Image arithmetic with one source image, three color parameter and one destination image.

Parameters
_qCodeOperation code, see table
_iSrcImageIndex of source image
_qRedParameter of algorithm
_qGreenParameter of algorithm
_qBlueParameter of algorithm
_iDstImageIndex of destination image
int LMKAxServer::iMatrixModuleCloseDialog ( )
slot

Closes the dialog for Matrix module measurements.

int LMKAxServer::iMatrixModuleExecute ( )
slot

Executes calculation with the current parameter set.

The parameter set can be previously loaded with iMatrixModuleReadParameter().

int LMKAxServer::iMatrixModuleOpenDialog ( )
slot

Opens the dialog for Matrix module measurements.

int LMKAxServer::iMatrixModuleReadParameter ( QString  filename)
slot

Load a parameter set (*.ini format)

The parameter file should be previously saved after interactively teaching in the dialog itself.

Parameters
filenameName of the parameter file to be loaded
int LMKAxServer::iMatrixModuleWriteResults ( QString  filename)
slot

Writes a result file (*.csv format)

The file format is a simple CSV file which contains the data tables, calculated by iMatrixModuleExecute().

Parameters
filenamename of the file
int LMKAxServer::iMergeColorImage ( int  _iSrcGreyImage1,
int  _iSrcGreyImage2,
int  _iSrcGreyImage3,
int  _iDstColorImage,
int  _iColorSpace 
)
slot

Create a color image from color extracts.

Parameters
_iSrcGreyImage1Index of source grey image 1 or less then -3 if not used
_iSrcGreyImage2Index of source grey image 2 or less then -3 if not used
_iSrcGreyImage3Index of source grey image 3 or less then -3 if not used
_iDstColorImageIndex of target color image
_iColorSpaceColor space, see iGetColor() for definitions
int LMKAxServer::iMotor_CloseAxes ( )
slot

Close axes access.

After this function access th axes is no longer allowed

int LMKAxServer::iMotor_GetAxisInfo ( int  index,
QString &  name,
double &  minposition,
double &  normposition,
double &  maxposition,
double &  minspeed,
double &  normspeed,
double &  maxspeed 
)
slot

Get names, min and max of an axis.

Parameters
indexInput index of wished axis
nameReturns name of axis
minpositionReturns minimum position of axis
normpositionReturns normal position of axis
maxpositionReturns maximum position of axis
minspeedReturns minimum speed of axis
normspeedReturns normal speed of axis
maxspeedReturns maximum speed of axis
int LMKAxServer::iMotor_GetAxisPosition ( int  index,
double &  position 
)
slot

Get position of an axis.

Parameters
indexInput index of wished axis
positionReturns current position
int LMKAxServer::iMotor_GetAxisSpeed ( int  index,
double &  speed 
)
slot

Get speed of an axis.

Parameters
indexInput index of wished axis
speedReturns speed currently set
int LMKAxServer::iMotor_IsAxisMoving ( int  index,
int &  moving 
)
slot

Is the axis moving?

Parameters
indexInput index of wished axis
movingReturns: 0 = axis is stopped, 1 = axis is moving
int LMKAxServer::iMotor_NumberOfAxes ( int &  number)
slot

Get number of axes.

Parameters
numberReturns number of axes (all other functions use index = 0...numbers-1)
int LMKAxServer::iMotor_OpenAxes ( )
slot

Initialisation of all axes.

Iinitialize all axes (possible after iMotor_ReadIni())

int LMKAxServer::iMotor_ReadIni ( QString  filename)
slot

Read of ini file with information about the axes.

Parameters
filenameFull path name of initialization file (in "Motors" directory of LabSoft installation)
int LMKAxServer::iMotor_SetAxisPosition ( int  index,
double  position 
)
slot

Set position of an axis (axis begin to move)

Parameters
indexInput index of wished axis
positionInput wished position (axis is immediatelymoving afterwards!)
int LMKAxServer::iMotor_SetAxisSpeed ( int  index,
double  speed 
)
slot

Set speed of an axis.

Parameters
indexInput index of wished axis
speedInput wished speed
int LMKAxServer::iMoveRegion ( int  _iList,
int  _iRegionIndex,
double  _dX,
double  _dY 
)
slot

Move a region the wished distance.

Parameters
_iListIndex of region list
_iRegionIndexThis region
_dXMove in x direction in the associated coordinate system
_dYMove in x direction in the associated coordinate system
int LMKAxServer::iMultiPic ( double  _dExposureTime,
int  _iCountPic,
int  _iSmear,
double  _dModFrequency 
)
slot

MultiPic capture algorithm.

Parameters
_dExposureTimeExposure time to use
_iCountPicNumber of camera images
_iSmearNumber of smear images (0=no smear correction)
_dModFrequencyModulation frequency (0=no modulation)
int LMKAxServer::iMultiPic2 ( double  _dExposureTime,
int  _iCountPic 
)
slot

MultiPic capture algorithm.

Parameters
_dExposureTimeExposure time to use
_iCountPicNumber of camera images
int LMKAxServer::iOpen ( )
slot

Opens the Lmk4 application.

After opening, the main window is visible.

Returns
0=ok, !=0 Error code
int LMKAxServer::iOpenRegisterFile ( QString  _qFileName,
int  _iMode 
)
slot

Open register file.

Parameters
_qFileNameFile name
_iModeOpen Mode
int LMKAxServer::iOpenRegisterMapFile ( QString  _qFileName)
slot

Open register map file.

Parameters
_qFileNameFile name
int LMKAxServer::iParamStatistics_Connect ( int  _iType,
int  _iFirstIndex,
int  _iSecondIndex 
)
slot

Take the statistic parameter of one object over to another.

From this time on the two objects use the same set of statistic parameter. The second object get the parameter of the first one. The previous parameter set of the second object will be deleted.

Parameters
_iTypeIndex of statistic type
_iFirstIndexIndex of first object
_iSecondIndexIndex of second object
int LMKAxServer::iParamStatistics_Disconnect ( int  _iType,
int  _iIndex 
)
slot

Separate the statistic parameter set of one object.

From this time this statistic object has its one parameter set.

Parameters
_iTypeIndex of statistic type
_iIndexIndex of object
int LMKAxServer::iParamStatistics_GetName ( int  _iType,
int  _iIndex,
QString &  _qsName 
)
slot

Get the name of a parameter set.

If two objects have the same name of their parameter set, they use the same parameters. This function is usefull, if someone wants to use the two functions iParamStatistics_Connect() and iParamStatistics_Disconnect().

Parameters
_iTypeIndex of statistic type
_iIndexIndex of object
_qsNameCurrent name of parameter set
int LMKAxServer::iParamStatistics_SetName ( int  _iType,
int  _iIndex,
QString  _qsNewName 
)
slot

Set the name of a parameter set.

The name of the set have to be different from all existing.

Parameters
_iTypeIndex of statistic type
_iIndexIndex of object
_qsNewNameWished name of parameter set
int LMKAxServer::iPCT_GetFlags ( int &  createTemplate,
int &  darkCapture,
int &  pixelCapture,
int &  red,
int &  green,
int &  blue,
int &  white 
)
slot

Get flags for Pixel crosstalk measurement.

Parameters
createTemplateIf set, the automatic measurement creates the needed images via template generator
darkCaptureIf set, the algorithm takes a capture of dark image
pixelCaptureIf set, the algorithm takes one or more captures of images with pixels set to red, green, blue or white)
redFor pixel capture: One capture with red pixels set?
greenFor pixel capture: One capture with green pixels set?
blueFor pixel capture: One capture with blue pixels set?
whiteFor pixel capture: One capture with white pixels set?
int LMKAxServer::iPCT_LoadDarkImage ( QString  filename)
slot

Load dark image from file.

Parameters
filenameRead image from this file
int LMKAxServer::iPCT_LoadParameters ( QString  filename)
slot

Load parameters set from *.ini file.

Parameters
filenameRead parameters from this *.ini file
int LMKAxServer::iPCT_LoadPixelImage ( QString  filename)
slot

Load pixel image from file.

Parameters
filenameRead image from this file
int LMKAxServer::iPCT_SaveParameters ( QString  filename)
slot

Save parameters set to *.ini file.

Parameters
filenameWrite parameters to this *.ini file
int LMKAxServer::iPCT_SetFlags ( int  createTemplate,
int  darkCapture,
int  pixelCapture,
int  red,
int  green,
int  blue,
int  white 
)
slot

Set flags for Pixel crosstalk measurement.

Parameters
createTemplateIf set, the automatic measurement creates the needed images via template generator
darkCaptureIf set, the algorithm takes a capture of dark image
pixelCaptureIf set, the algorithm takes one or more captures of images with pixels set to red, green, blue or white)
redFor pixel capture: One capture with red pixels set?
greenFor pixel capture: One capture with green pixels set?
blueFor pixel capture: One capture with blue pixels set?
whiteFor pixel capture: One capture with white pixels set?
int LMKAxServer::iPing ( )
slot

classic Ping, return 27

int LMKAxServer::iProjectiveRectification ( int  srcimage,
QString  parameterfile,
int  dstimage 
)
slot

Projective rectification of an image.

Parameters
srcimageIndex of the source image
parameterfileName of file in *.prorect format
dstimageIndex of the target image
int LMKAxServer::iReadFromStatusLine ( QString &  _qMessage)
slot

Read a string from the status line of the program.

Parameters
_qMessageCurrent message shown
int LMKAxServer::iReadIniFileEntries ( QString  _qFileName,
QString  _qSection,
QStringList &  _qslEntries 
)
slot

Read list of entries in a section of an inifile.

Parameters
_qFileNameInifile name
_qSectionSection name
_qslEntriesList of entries in the section
int LMKAxServer::iReadIniFileEntry ( QString  _qFileName,
QString  _qSection,
QString  _qEntry,
QString  _qDefault,
QString &  _qValue 
)
slot

Read value of an entry in a section of an inifile.

Parameters
_qFileNameInifile name
_qSectionSection name
_qEntryEntry name
_qDefaultDefault value if not found
_qValueCurrent value of entry
int LMKAxServer::iReadIniFileSections ( QString  _qFileName,
QStringList &  _qslSections 
)
slot

Read list of sections in an inifile.

Parameters
_qFileNameInifile name
_qslSectionsList of sections in inifile
int LMKAxServer::iReadPhysicalRegister ( int  _iRegister,
int &  _irValue 
)
slot

Read physical register of camera.

Parameters
_iRegisterNumber of register
_irValueWrite there value
int LMKAxServer::iReadRegisterMap ( QString  _qRegisterName,
int &  _irValue 
)
slot

read register value

Parameters
_qRegisterNameRegister name
_irValueValue
int LMKAxServer::iReFocus ( double &  sharpness,
double &  edge 
)
slot

Make autofocus procedure in a small range around the last good value.

Parameters
sharpnessValue of sharpness, the higher, the better
edgeMean edge quality in percent (Maximum = 100%)
int LMKAxServer::iResetTimeStatistic ( int  _iTyp,
int  _iObject 
)
slot

Reset a time statistic.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object, -1 for all of this type
int LMKAxServer::iSaveColorFactorsFile ( )
slot

Save color factors file to use at next program start.

Color factors sets are reachable within the program with "Capture | properties | Color factors | Change". See LabSoft manual chapter 5.3.1 "Color factors".

After changing one color factor set the values are not saved to file. It can be done afterwards with this function.

int LMKAxServer::iSaveImage ( int  _iNumber,
QString  _qFileName 
)
slot

Save image.

The function overwrites an existing file.

Parameters
_iNumberIndex of image to save
_qFileNameDestination file name
int LMKAxServer::iSaveImageRegion ( int  _iImage,
int  _iRegion,
QString  _qFileName 
)
slot

Save image region.

The function overwrites an existing file. The region is determined by the index of a rectangular region in the image region list.

Parameters
_iImageIndex of image to save
_iRegionIndex of region to save
_qFileNameDestination file name
int LMKAxServer::iSaveProtokoll ( QString  _qPathName)
slot

Save a protocol into a file.

Parameters
_qPathNameSave into this file. File extension: ".ttcs"
Returns
0=ok, !=0 Error code
int LMKAxServer::iSaveRegionList ( int  _iList,
QString  _qFileName,
int  _iOverwrite 
)
slot

Save region list.

The same file formats (csv, txt) available like in menu point "Regions | Save as".

Parameters
_iListIndex of region list
_qFileNameDestination file name
_iOverwriteOverwrite existing file?
int LMKAxServer::iSaveRegionListCS ( int  _iList,
QString  _qFileName,
int  _iOverwrite 
)
slot

Save region list in units of coordinate system.

The same file formats (csv, txt) available like in menu point "Regions | Save as".

Parameters
_iListIndex of region list
_qFileNameDestination file name
_iOverwriteOverwrite existing file?
int LMKAxServer::iSelectImage ( int  _iIndex)
slot

Bring image to front in LabSoft.

Parameters
_iIndexIndex of image (-3, ..., number of evaluation images - 1)
int LMKAxServer::iSelectRegion ( int  _iList,
int  _iRegion,
int  _iSelected 
)
slot

Selects or deselects a region.

Parameters
_iListIndex of region list
_iRegionIndex of region
_iSelectedSelect or deselect!
int LMKAxServer::iSetAperture ( int  value)
slot

Set aperture value.

Parameters
valueSet new aperture value
int LMKAxServer::iSetAutomatic ( int  _iAutomatic)
slot

Set Automatic-Flag for all exposure times.

If this flag is set, all exposure times will automatically adjusted if camera exposure time is reduced or enlarged.

Parameters
_iAutomatic1=switch option on, 0=switch option off
int LMKAxServer::iSetAutoscan ( int  _iAutoscan)
slot

Set use of autoscan algorithm.

Determination of a good exposure time before the capturing algorithm.

Parameters
_iAutoscan=1 Use autoscan, =0 do not use
int LMKAxServer::iSetCameraParameter ( QString  _qParameterName,
QString &  _qrParameterValue 
)
slot

Write access to camera parameter.

Parameters
_qParameterNameName of parameter
_qrParameterValueParameter value(s) as string

The function is only available in TechnoTeam developer mode. The function fails if no camera is connected.

int LMKAxServer::iSetClass ( int  _iTyp,
int  _iObject,
int  _iClass,
QString  _qsClassName,
int  _iVisible 
)
slot

Set name and visibility of class.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iClassIndex of class
_qsClassNameName of class
_iVisibleClass visible in images, tables and diagrams
int LMKAxServer::iSetColorCorr ( int  _iIndex,
int  _iSelect 
)
slot

Selection of a color correction factor.

Parameters
_iIndexIndex of factor, indexes begin with "0"
_iSelectSelect (1) or unselect (0) this factor
int LMKAxServer::iSetColorFactors ( int  _iIndex)
slot

Set a color matrix.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_iIndexIndex of color matrix, indexes begin with "0"
int LMKAxServer::iSetConvertingUnits ( QString  _qName,
QString  _qUnit,
double  _dFactor 
)
slot

Set new converting values.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_qNamewished Name
_qUnitwished Unit
_dFactorwished factor
int LMKAxServer::iSetDarkening ( int  _iDarkening,
int  _iSwitchMonitorOff,
double  _dTimeOut 
)
slot

Darkening computer monitor while capturing.

Parameters
_iDarkening1=darkening monitor, 2=no darkening
_iSwitchMonitorOff1=If darkening is wished, switch monitor off
_dTimeOutWait time in seconds after switch off before start of capture
int LMKAxServer::iSetFilterWheel ( int  _iCurrentFilter)
slot

Set new filter position.

Parameters
_iCurrentFilterWished new position
int LMKAxServer::iSetFlagsStatistic ( int  _iTyp,
int  _iObject,
int  _iGeo,
int  _iPhoto,
int  _iMinMax,
int  _iTime,
int  _iHorseshoe 
)
slot

Set Flags for statistic evaluations.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iGeoCalculate geometric center
_iPhotoCalculate photometric center
_iMinMaxCalculate position of min max
_iTimeGet time flags (OR combination of bits):
  • 1 Mean
  • 2 Dispersion
  • 4 Min
  • 8 Max
_iHorseshoeColor diagram
int LMKAxServer::iSetFlagsStatistic2 ( int  _iTyp,
int  _iObject,
int  _iGeo,
int  _iPhoto,
int  _iMinMax,
int  _iTime,
int  _iMaxCountTime,
int  _iHorseshoe 
)
slot

Set Flags for statistic evaluations.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_iGeoCalculate geometric center
_iPhotoCalculate photometric center
_iMinMaxCalculate position of min max
_iTimeGet time flags (OR combination of bits):
  • 1 Mean
  • 2 Dispersion
  • 4 Min
  • 8 Max
_iMaxCountTimeMaximum number of time statistic values.
_iHorseshoeColor diagram
int LMKAxServer::iSetFocus ( double  value)
slot

Set focus position.

Parameters
valueRequired focus position in percent
int LMKAxServer::iSetFocusFactor ( int  _iIndex)
slot

Set a focus factor.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_iIndexIndex of factor, indexes begin with "0"
int LMKAxServer::iSetFocusParameter ( int  subsampling,
int  top,
int  bottom,
int  left,
int  right 
)
slot

Set parameter for autofocus.

Parameters
subsamplingSubsampling of camera image, possible values are 1, 2 and 4
topFirst row of region
bottomLast row of region
leftFirst column of region
rightLast column of region
int LMKAxServer::iSetGreyFilter ( int  _iIndex,
int  _iSelect 
)
slot

Selection of a grey filter.

Parameters
_iIndexIndex of filter, indexes begin with "0"
_iSelectSelect (1) or unselect (0) this grey filter
int LMKAxServer::iSetGreyFilterList ( QStringList &  _qSelected)
slot

Set grey filters.

See function iGetGreyFilterList(). In this function the program returns a list of the available grey filters and wether they are switched on or off. Use this function to get the appropriate list size.

Parameters
_qSelectedList with "0" for "no selected" and "1" for "selected"
int LMKAxServer::iSetImageName ( int  _iIndex,
QString  _qName 
)
slot

Changes the name of an image.

See also iGetImageName().

Parameters
_iIndexIndex of the image
_qNameWished name of image
int LMKAxServer::iSetIntegrationTime ( double  _dWishedTime,
double &  _drRealizedTime 
)
slot

Set new exposure time.

Parameters
_dWishedTimeWished integration time
_drRealizedTimeRealized integration time
int LMKAxServer::iSetMaxCameraTime ( double  _dMaxCameraTime)
slot

Set the maximum possible exposure time.

The maximum values is of course restricted by camera properties. But you can use an even smaller time to avoid to long meausrement times.

Parameters
_dMaxCameraTimeWished value
int LMKAxServer::iSetModulationFrequency ( double  _dModFrequency)
slot

Set the frequency of modulated light.

If the light source is driven by alternating current, there are some restriction for the exposure times. Please inform the program about the modulation frequency.

Parameters
_dModFrequencyFrequency of light source. 0 if no modulation is to be concerend
int LMKAxServer::iSetNewCamera ( QString  _qPathToLens)
slot

Set new camera calibration data.

Parameters
_qPathToLensPath to the camera calibration data. More exactly spoken path to the lens sub directory. After calling this function the camera is completely reinitialized.

If the string is empty a currently existing camera connection is finished.

Returns
0=ok, !=0 Error code
int LMKAxServer::iSetNewCamera2 ( QString  _qNameCamera,
QString  _qNameLens 
)
slot

Set new camera calibration data.

Parameters
_qNameCameraName of camera, for example "dxm2150"
_qNameLensName of lens, for example "oC202564f50"
                                        If both strings are empty, a currently existing 
                                        camera connection is finished.
Returns
0=ok, !=0 Error code
int LMKAxServer::iSetPositionRegionName ( int  list,
int  index,
int  position 
)
slot

Write position of region name.

Parameters
listIndex of region list
indexIndex of the region
positionreturn position of region name
  • 0 invisible
  • 1 topright
  • 2 right
  • ... 8 top
  • 9 middle
int LMKAxServer::iSetRawFocus ( int  value)
slot

Set focus position.

Parameters
valueRequired focus position absolute
int LMKAxServer::iSetRecalibrationFactor ( double  _dFactor)
slot

Set recalibration factor.

See dialog "Camera|Recalibration" in LabSoft main menu.

Parameters
_dFactorFactor wished
int LMKAxServer::iSetRegionName ( int  _iList,
int  _iIndex,
QString  _qrName 
)
slot

Change region name.

Parameters
_iListIndex of region list
_iIndexIndex of the region
_qrNameName
int LMKAxServer::iSetScatteredLight ( int  _iScatteredLight)
slot

Use of scattered light correction.

Only useable, if a parameter set is available in program

Parameters
_iScatteredLight=0 Switch on of scattered light correction, =1 switch on.
int LMKAxServer::iSetSmear ( int  _iSmear)
slot

Set the parameter for smear correction.

Parameters
_iSmear0 means no smear correction, otherwise smear correction with at least 10 dark images captured. >10 number of dark images.
int LMKAxServer::iSetStatisticParameter ( int  _iTyp,
int  _iObject,
int &  _irNumberParam,
QStringList &  _slrParamList 
)
slot

Change the parameters of a statistic.

Parameters
_iTypIndex of statistic type
_iObjectIndex of object
_irNumberParamNumber of parameters for this statistic
_slrParamListList of parameters for this statistic
int LMKAxServer::iSetSuppressOverflow ( int  _iSuppress)
slot

Suppress overflow warning in measurement series.

Parameters
_iSuppress1=suppress warning, 0=allow warning
int LMKAxServer::iSetSuppressProgressDialog ( int  _iSuppress)
slot

Suppress view of progress dialog while capturing an luminance or color image.

Parameters
_iSuppress1=Dialog is hided, 0=Dialog is shown
int LMKAxServer::iSetTrigger ( int  type)
slot

Switch trigger mode on or off for Lmk6 camera.

Parameters
type- 0 No trigger
  • 1 Internal trigger
  • 2 External trigger
  • 3 Image trigger
int LMKAxServer::iSetTriggerCommonParameter ( double  timeout,
double  capturedistance,
double  exposuredelay,
int  triggerhigh,
int  strobehigh 
)
slot

Set common trigger parameter for Lmk6 camera.

Parameters
timeoutTimout in seconds (external and image trigger)
capturedistanceDistance between captures in seconds (internal trigger)
exposuredelayDelay between trigger signal and exposure in seconds
triggerhigh= 1 rising edge of trigger signal, = 0 alling edge of trigger signal
strobehigh= 1 rising edge of strobe signal, = 0 alling edge of strobe signal
int LMKAxServer::iSetTriggerImageParameter ( int  top,
int  bottom,
int  left,
int  right,
int  reserved,
int  level,
double  exposure 
)
slot

Set image trigger parameter for Lmk6 camera.

Parameters
toptop edge of region in the image to detect image trigger
bottombottom edge of region in the image to detect image trigger
leftleft edge of region in the image to detect image trigger
rightright edge of region in the image to detect image trigger
reservedParameter is currently not used
levelGrey threshold for image trigger in camera image.
exposureExposure time for image trigger (it is different fom normal exposure time)
int LMKAxServer::iSetTriggerMode ( int  _iTriggerMode,
double  _dTimeout 
)
slot

Switch on or off triggered mode of capturing.

This mode is only usefull, if

  • Camera is not Lmk6 (TTQ, TTS, TTT, ...)
  • Hardware is available
  • in camera.ini feature is enabled
Parameters
_iTriggerMode=1 Switch trigger mode on, =0 switch off
_dTimeoutTimeout in seconds in trigger mode
int LMKAxServer::iSetTriggerStrobeParameter ( int  parametrizable,
double  delay,
double  duration 
)
slot

Set strobe trigger parameter for Lmk6 camera.

Parameters
parametrizable= 0, strobe signal while capture is running, = 1 parametrizable strobe signal
delayDelay between exposure and strobe signal in seconds
durationDuration of strobe signal in seconds
int LMKAxServer::iSetViewPalette ( int  image,
int  palette 
)
slot

Change color palette.

The function is only available for grey scale images.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
paletteIndex of the new palette, see iGetViewPalette() for possible values
int LMKAxServer::iSetViewScaling ( int  image,
double  scaling,
double  minimum,
double  maximum 
)
slot

Set new scaling of image view.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
scalingReturns decades of scaling:
  • 0 linear
  • 2...8 logarithmic
minimumMinimum of scaling (valid only for linear scaling)
maximumMaximum of scaling

If minimum = maximum = 0 then automatic scaling.

int LMKAxServer::iSetViewScalingRect ( int  image,
int  top,
int  bottom,
int  left,
int  right 
)
slot

Set new scaling rectangle of image view.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
topUpper border of scaling rect
bottomLower border of scaling rect
leftLeft border of scaling rect
rightRight border of scaling rect

If top = bottom = left = right = 0 then whole image.

int LMKAxServer::iSetViewZoom ( int  image,
double  zoom,
int  top,
int  left 
)
slot

Set new zooming parameters.

Parameters
imageIndex of image (-3, ..., number of evaluation images - 1)
zoomNew zooming factor (0.0, 0.02 .... 50.0)
topNew upper border
leftNew left border

If zoom = 0 then always show whole image. If the coordinates outside the image, then they will be corrected.

int LMKAxServer::iShow ( int  _iShowStatus)
slot

Change visibility of the program.

Parameters
_iShowStatus- 0 hide(), better use 2=showMinimized instead
  • 1 show()
  • 2 showMinimized()
  • 3 showNormal()
  • 4 showMaximized()
  • 5 showFullScreen()
  • others: show()
int LMKAxServer::iSI2_GetImageDir ( int &  saveImages,
QString &  directoryName 
)
slot

Get image saving parameters.

Parameters
saveImagesSave images?
directoryNameDirectory to save image
int LMKAxServer::iSI2_GetSchedule ( double &  rollingTime,
double &  burnInTime,
double &  relaxationTime,
int &  firstTriggered,
int &  corrNonUniformity 
)
slot

Get schedule of measurement.

Parameters
rollingTimePattern rolling time in seconds
burnInTimeBurnIn time in seconds
relaxationTimeRelaxation time in seconds
firstTriggeredFirst image triggered
corrNonUniformityCorrection of nonuniformity
int LMKAxServer::iSI2_LoadProject ( QString  filename)
slot

Load project file *.si2.

Parameters
filenameRead project file *.si2
int LMKAxServer::iSI2_LoadTeachIn ( QString  filename)
slot

Load TeachIn file *.car.

Parameters
filenameRead camera adjustment result file *.car
int LMKAxServer::iSI2_SaveProject ( QString  filename)
slot

Save project file *.*.si2.

Parameters
filenameSave project file *.si2
int LMKAxServer::iSI2_SetImageDir ( int  saveImages,
QString  directoryName 
)
slot

Set image saving parameters.

Parameters
saveImagesSave images?
directoryNameDirectory to save image
int LMKAxServer::iSI2_SetSchedule ( double  rollingTime,
double  burnInTime,
double  relaxationTime,
int  firstTriggered,
int  corrNonUniformity 
)
slot

Set schedule of measurement.

Parameters
rollingTimePattern rolling time in seconds
burnInTimeBurnIn time in seconds
relaxationTimeRelaxation time in seconds
firstTriggeredFirst image triggered
corrNonUniformityCorrection of nonuniformity
int LMKAxServer::iSI3_GetParameters ( int &  binalevel,
int &  maxobjectsize,
double &  horzscanfactor,
int &  bordersize,
int &  showregions,
int &  corrnonuniformity 
)
slot

Get parameters of measurement.

Parameters
binalevelBinarization level in percent
maxobjectsizeMaximum scan object size
horzscanfactorHorizontal scan factor
bordersizeBorder size
showregionsShow regions in image?
corrnonuniformityCorrection of nonuniformity?
int LMKAxServer::iSI3_LoadParameters ( QString  filename)
slot

Load parameters of measurement *.ini.

Parameters
filenameof parameter file *.ini
int LMKAxServer::iSI3_LoadProject ( QString  filename)
slot

Load project file *.stimp.

Parameters
filenameName of project file *.stimp
int LMKAxServer::iSI3_SaveParameters ( QString  filename)
slot

Save parameters of measurement *.ini.

Parameters
filenameof parameter file *.ini
int LMKAxServer::iSI3_SaveProject ( QString  filename)
slot

Save project file *.stimp.

Parameters
filenameName of project file *.stimp
int LMKAxServer::iSI3_SetParameters ( int  binalevel,
int  maxobjectsize,
double  horzscanfactor,
int  bordersize,
int  showregions,
int  corrnonuniformity 
)
slot

Set parameters of measurement.

Parameters
binalevelBinarization level in percent
maxobjectsizeMaximum scan object size
horzscanfactorHorizontal scan factor
bordersizeBorder size
showregionsShow regions in image?
corrnonuniformityCorrection of nonuniformity?
int LMKAxServer::iSinglePic ( double  _dExposureTime,
int  _iSmear,
double  _dModFrequency 
)
slot

SinglePic capture algorithm.

Parameters
_dExposureTimeExposure time to use
_iSmearNumber of smear images (0=no smear correction)
_dModFrequencyModulation frequency (0=no modulation)
int LMKAxServer::iSinglePic2 ( double  _dExposureTime)
slot

SinglePic capture algorithm.

Parameters
_dExposureTimeExposure time to use
int LMKAxServer::iSinglePicFromFile ( QString  _qFileName)
slot

Convert camera image file to luminance image.

The function takes a *.pus or *.rc2 file with a previous captured and saved camera image and converts it into a luminance image. It requires that the camera calibration data are already loaded into the program.

Parameters
_qFileNameFile name of camera image
int LMKAxServer::iSinglePicsFromDirectory ( QString  _qSrcDirectory,
QString  _qDstDirectory 
)
slot

Converts a directory with camera images to a directory with luminance images.

The function takes a directory with *.pus files of previous captured and saved camera images and converts them into a directory with luminance images. It requires that the camera calibration data are already loaded into the program.

Parameters
_qSrcDirectoryDirectory with existing camera images
_qDstDirectoryDirectory with luminance images to create
int LMKAxServer::iSPA_Autoscan ( double &  time)
slot

Make autoscan algorithm and take over exposure time.

This function is only allowed after opening camera connection.

Parameters
timeExposure time
int LMKAxServer::iSPA_Capture ( )
slot

Capture luminance image.

This function is only allowed after opening camera connection.

int LMKAxServer::iSPA_GetCameraParameter ( double &  fieldAngle,
double &  resolution,
int &  showAngle,
int &  defaultValues 
)
slot

Get capture parameters.

This function is only allowed after opening camera connection.

Parameters
fieldAngleField angle (Default 7°)
resolutionCamera pixel resolution (Default 10 Pixel/mm)
showAngleShow field angle in image
defaultValuesUse defaults for angle and resolution
int LMKAxServer::iSPA_GetCaptureParam ( double &  time,
int &  count 
)
slot

Get exposure time and number of images for MultiPic algorithm.

This function is only allowed after opening camera connection.

Parameters
timeExposure time
countNumber of images
int LMKAxServer::iSPA_GetMeasurementRegion ( int &  height,
int &  width,
int &  top,
int &  left,
int &  showRegion,
int &  showDisplay 
)
slot

Get measuring region.

This function is only allowed after opening camera connection.

Parameters
heightHeight of region, power of two
widthWidth of region, power of two
topUpper border of region
leftLeft border of region
showRegionShow region in image
showDisplayShow display size (from *.car file)
int LMKAxServer::iSPA_GetMovementParameter ( double &  middle,
double &  range,
double &  step 
)
slot

Get movement parameters for measurement.

This function is only allowed after opening drive unit connection.

Parameters
middleMiddle point of measurement range
rangeExtension of range
stepMovement steps
int LMKAxServer::iSPA_LoopMeasure ( double &  value,
double &  position 
)
slot

Complete measurement with image displays, diagram and tables.

This function is only allowed after opening both camera and movement unit. Two tables, a diagram and the "Sparkle" image are displayed.

Parameters
valueCalculated maximum sparkle value
positionPosition of drive unit for maximum sparkle value
int LMKAxServer::iSPA_ReadCarFile ( QString  filename)
slot

Read camera adjustment file *.car, contains information about display to be measured.

This function is only allowed after opening camera connection.

Parameters
filenameName der *.car-Datei
int LMKAxServer::iSPA_ReadParameterFile ( QString  filename)
slot

Read parameter file *.spa.

This function is only allowed after opening camera connection.

Parameters
filenameName of *.spa file
int LMKAxServer::iSPA_SetCameraParameter ( double  fieldAngle,
double  resolution,
int  showAngle,
int  defaultValues 
)
slot

Set capture parameters.

This function is only allowed after opening camera connection.

Parameters
fieldAngleField angle (Default 7°)
resolutionCamera pixel resolution (Default 10 Pixel/mm)
showAngleShow field angle in image
defaultValuesUse defaults for angle and resolution
int LMKAxServer::iSPA_SetCaptureParam ( double  time,
int  count 
)
slot

Set exposure time and number of images for MultiPic algorithm.

This function is only allowed after opening camera connection.

Parameters
timeExposure time
countNumber of images
int LMKAxServer::iSPA_SetMeasurementRegion ( int  height,
int  width,
int  top,
int  left,
int  showRegion,
int  showDisplay 
)
slot

Set measuring region.

This function is only allowed after opening camera connection.

Parameters
heightHeight of region, power of two
widthWidth of region, power of two
topUpper border of region
leftLeft border of region
showRegionShow region in image
showDisplayShow display size (from *.car file)
int LMKAxServer::iSPA_SetMovementParameter ( double  middle,
double  range,
double  step 
)
slot

Set movement parameters for measurement.

This function is only allowed after opening drive unit connection.

Parameters
middleMiddle point of measurement range
rangeExtension of range
stepMovement steps
int LMKAxServer::iSPA_SingleMeasure ( double &  value)
slot

Single measurement in luminance image.

No capturing, no moving, no diagrams or tables.

Parameters
valueCalculated single sparkle value
int LMKAxServer::iSPA_WriteParameterFile ( QString  filename)
slot

Write parameter file *.spa.

This function is only allowed after opening camera connection.

Parameters
filenameName of *.spa file
int LMKAxServer::iSplitColorImage ( int  _iSrcColorImage,
int  _iDstGreyImage1,
int  _iDstGreyImage2,
int  _iDstGreyImage3,
int  _iColorSpace 
)
slot

Split a color image into color extracts.

Parameters
_iSrcColorImageIndex of source color image
_iDstGreyImage1Index of target grey image 1 or less then -3 if not needed
_iDstGreyImage2Index of target grey image 2 or less then -3 if not needed
_iDstGreyImage3Index of target grey image 3 or less then -3 if not needed
_iColorSpaceColor space, see iGetColor() for definitions
int LMKAxServer::iSR_GetChangeRegions ( int &  enlarge,
int &  smoothing,
int &  minsize,
int &  maxsize,
int &  convex,
int &  rectangles 
)
slot

Get parameters from section "Change regions".

Parameters
enlargeEnlarge (or reduce) size of contour found
smoothingSmoothing of contour
minsizeMinimum region size
maxsizeMaximum region size
convex!=0 use convex envelope
rectangles!=0 use rectangles
int LMKAxServer::iSR_GetSearchingFor ( int &  image,
double &  threshold,
int &  smoothing 
)
slot

Get parameters from section "Searching for regions.

Parameters
imageIndex of image, see section "Access to the images"
thresholdMinimum luminance threshold in image
smoothingSize of smoothing filter in image
int LMKAxServer::iSR_GetStatistics ( int &  statistic,
int &  separate 
)
slot

Get parameters from section "Generate statistics.

Parameters
statisticCreating statistics:
  • 0 = No statistics
  • 1 = Standard statistics
  • 2 = Luminance oobjects
  • 3 = Symbol objects
separateseparate parameter sets for every object:
  • 0 = no
  • 1 = yes
int LMKAxServer::iSR_GetUseRegions ( int &  usage,
int &  delexisting,
int &  createmiss,
double &  distance,
double &  area,
double &  circumference,
double &  shape,
double &  rotation,
double &  displacement 
)
slot

Get parameters from section "Use regions".

Parameters
usageUsage of existing regions:
  • 0 = overwrite
  • 1 = maintain existing
  • 2 = use and change existing
delexisting!=0 Delete existing regions if not found
createmiss!=0 Create missing regions if not found
distanceIf "use and change existing": weighting of the distance
areaIf "use and change existing": weighting of the area
circumferenceIf "use and change existing": weighting of the circumference
shapeIf "use and change existing": weighting of the shape
rotationIf "use and change existing": weighting of the rotation
displacementIf "use and change existing": Maximum displacement between old and new region
int LMKAxServer::iSR_SetChangeRegions ( int  enlarge,
int  smoothing,
int  minsize,
int  maxsize,
int  convex,
int  rectangles 
)
slot

Set parameters to section "Change regions".

Parameters
enlargeEnlarge (or reduce) size of contour found
smoothingSmoothing of contour
minsizeMinimum region size
maxsizeMaximum region size
convex!=0 use convex envelope
rectangles!=0 use rectangles
int LMKAxServer::iSR_SetSearchingFor ( int  image,
double  threshold,
int  smoothing 
)
slot

Set parameters to section "Searching for regions.

Parameters
imageIndex of image, see section "Access to the images"
thresholdMinimum luminance threshold in image
smoothingSize of smoothing filter in image
int LMKAxServer::iSR_SetStatistics ( int  statistic,
int  separate 
)
slot

Set parameters to section "Generate statistics".

Parameters
statisticCreating statistics:
  • 0 = No statistics
  • 1 = Standard statistics
  • 2 = Luminance oobjects
  • 3 = Symbol objects
separateseparate parameter sets for every object:
  • 0 = no
  • 1 = yes
int LMKAxServer::iSR_SetUseRegions ( int  usage,
int  delexisting,
int  createmiss,
double  distance,
double  area,
double  circumference,
double  shape,
double  rotation,
double  displacement 
)
slot

Set parameters to section "Use regions".

Parameters
usageUsage of existing regions:
  • 0 = overwrite
  • 1 = maintain existing
  • 2 = use and change existing
delexisting!=0 Delete existing regions if not found
createmiss!=0 Create missing regions if not found
distanceIf "use and change existing": weighting of the distance
areaIf "use and change existing": weighting of the area
circumferenceIf "use and change existing": weighting of the circumference
shapeIf "use and change existing": weighting of the shape
rotationIf "use and change existing": weighting of the rotation
displacementIf "use and change existing": Maximum displacement between old and new region
int LMKAxServer::iTableGetAllContent ( int  _iTable,
QStringList &  _qslContent 
)
slot

Returns all cells of a table as a list.

The entries are sorted line by line.

Parameters
_iTableIndex of wished table
_qslContentList with content of all cells
int LMKAxServer::iTableGetCell ( int  _iTable,
int  _iLine,
int  _iColumn,
QString &  _qrCell 
)
slot

Returns the content of a cell of a table.

Parameters
_iTableIndex of wished table
_iLineIndex of wished table line
_iColumnIndex of wished table column
_qrCellReturns the content of table cell
int LMKAxServer::iTableGetColumn ( int  _iTable,
int  _iColumn,
QString &  _qrName,
QString &  _qrCaption,
QString &  _qrUnit 
)
slot

Returns the column header of a column of a table.

Parameters
_iTableIndex of wished table
_iColumnIndex of wished column
_qrNameReturns the name of the column
_qrCaptionReturns the caption of the column
_qrUnitReturns the unit of the column
int LMKAxServer::iTableGetIndex ( QString  _qNameOrCaption,
int &  _irTable 
)
slot

Search for a table, given by name or caption.

Parameters
_qNameOrCaptionSearched name or caption of a table
_irTableIndex of table or -1 if not found
int LMKAxServer::iTableGetNameAndCaption ( int  _iTable,
QString &  _qrName,
QString &  _qrCaption 
)
slot

Returns the name and the caption of an existing table.

Parameters
_iTableIndex of wished table
_qrNameReturns the name of the table
_qrCaptionReturns the caption of the table
int LMKAxServer::iTableGetNumber ( int &  _irNumber)
slot

Returns the number of tables in the result tab widget.

Parameters
_irNumberReturns the number of tables
int LMKAxServer::iTableGetNumberColumns ( int  _iTable,
int &  _irNumberColumns 
)
slot

Returns the number of columns of a table.

Parameters
_iTableIndex of wished table
_irNumberColumnsReturns the number of columns in table
int LMKAxServer::iTableGetNumberLines ( int  _iTable,
int &  _irNumberLines 
)
slot

Returns the number of lines of a table.

Parameters
_iTableIndex of wished table
_irNumberLinesReturns the number of lines in table
int LMKAxServer::iTIG_CreateImage ( )
slot

Create template image with the adjusted parameters.

int LMKAxServer::iTIG_DeleteImage ( )
slot

Remove template image from the display.

Template images can only be deleted from a display. If the target is an evaluation image, deletion is not possible.

int LMKAxServer::iTIG_GetBorderProperties ( int &  _irUse,
int &  _irLeft,
int &  _irRight,
int &  _irTop,
int &  _irBottom,
int &  _irValue 
)
slot

Get properties of image border.

Parameters
_irUseUse an image border?
_irLeftSize of left border in pixels
_irRightSize of right border in pixels
_irTopSize of top border in pixels
_irBottomSize of bottom border in pixels
_irValueFill value of border
int LMKAxServer::iTIG_GetListOfCategories ( QStringList &  _qslCategories)
slot

Get list of categories of template images.

Parameters
_qslCategoriesSave list of categories there
int LMKAxServer::iTIG_GetListOfOperations ( QString  _qCategory,
QStringList &  _qslOperations 
)
slot

Get list of types of template images for the given category.

Parameters
_qCategoryOne of the possible categories
_qslOperationsSave list of template image types there
int LMKAxServer::iTIG_GetListOfParameterNames ( QStringList &  _qrParameters)
slot

Get a parameter name list for the currently selected template image type.

Parameters
_qrParametersWrite list of parameter names there
int LMKAxServer::iTIG_GetNumberTargetDisplays ( int &  _irNumber)
slot

Number of connected displays.

At least there is one - on which the program is shown.

Parameters
_irNumberGet number of available displays, at least one
int LMKAxServer::iTIG_GetParameterValue ( QString  _qName,
double &  _drValue 
)
slot

Get a certain parameter value.

Parameters
_qNameName of parameter
_drValueValue of parameter (if bool, then 0 or 1)
int LMKAxServer::iTIG_GetTarget ( int &  _irIndex,
QString &  _qrImageName 
)
slot

Get current target for template image generation.

Parameters
_irIndexValues:
  • -1 Use given image name
  • 0...N-1 One of the connected displays
_qrImageNameImage name is only returned if _irIndex = -1
int LMKAxServer::iTIG_GetTargetProperties ( int &  _irType,
int &  _irHeight,
int &  _irWidth,
int &  _irLines,
int &  _irColumns 
)
slot

Get properties of current target.

The size of the target image is fixed.

Parameters
_irTypeValues:
  • 1 Monochrome image
  • 2 Color image
  • 3 Display. In this case the type (monochrome or color) is chosen automatically.
_irHeightHeight in millimeter
_irWidthWidth in millimeter
_irLinesNumber of image lines
_irColumnsNumber of image columns
int LMKAxServer::iTIG_HideDialog ( )
slot

Make template image dialog invisible.

int LMKAxServer::iTIG_IsOperation ( QString  _qCategory,
QString  _qOperation,
int &  _irSet 
)
slot

Ask, if a type of template image is selected.

Normally an operation is represented by a radio button in the Template image generator dialog. In this case only one operation can be set at one time.

Parameters
_qCategoryName of category
_qOperationName of operation or option
_irSetIs this operation selected?
int LMKAxServer::iTIG_LoadImage ( QString  _qFileName)
slot

Load template image file to the target.

This operation is only allowed for category "User defined".

Parameters
_qFileNameName of an image file. Allowed file extensions are .puc, *.pus, *.pf, *.pco, *.pcf, *.bmp, *.png and *.jpg
int LMKAxServer::iTIG_LoadParameter ( QString  _qFileName)
slot

Load file with predefined parameter values.

Parameters
_qFileNameName of an existing parameter file with extension *.ini
int LMKAxServer::iTIG_SaveImage ( QString  _qFileName)
slot

Save template image to a file.

Parameters
_qFileNameName of an image file. Allowed file extensions are .puc, *.pus, *.pf, *.pco, *.pcf, *.bmp, *.png and *.jpg
int LMKAxServer::iTIG_SaveParameter ( QString  _qFileName)
slot

Save file with adjusted parameter values.

Parameters
_qFileNameName of a parameter file with extension *.ini
int LMKAxServer::iTIG_SetBorderProperties ( int  _iUse,
int  _iLeft,
int  _iRight,
int  _iTop,
int  _iBottom,
int  _iValue 
)
slot

Set properties of image border.

Parameters
_iUseUse an image border?
_iLeftSize of left border in pixels
_iRightSize of right border in pixels
_iTopSize of top border in pixels
_iBottomSize of bottom border in pixels
_iValueFill value of border
int LMKAxServer::iTIG_SetOperation ( QString  _qCategory,
QString  _qOperation,
int  _iSet 
)
slot

Set a type of template image or an option.

Parameters
_qCategoryName of category
_qOperationName of operation or option
_iSetSet or unset. This parameter is only valid, if this is an option (CheckBox, not radiobutton in this tabsheet / category)
int LMKAxServer::iTIG_SetParameterValue ( QString  _qName,
double  _dValue 
)
slot

Set a certain parameter value.

Parameters
_qNameName of parameter
_dValueValue of parameter (if bool, then 0 or 1)
int LMKAxServer::iTIG_SetTarget ( int  _iIndex,
QString  _qImageName 
)
slot

Set target for template image generation.

Parameters
_iIndexValues:
  • -1 Use given image name
  • 0...N-1 One of the connected displays
_qImageNameImage name is only necessary if _iIndex = -1
int LMKAxServer::iTIG_ShowDialog ( )
slot

Make template image dialog visible.

int LMKAxServer::iWordClose ( )
slot

Close Word program.

int LMKAxServer::iWordCopyItem ( int  _iIndex)
slot

Copy one item to Word.

Parameters
_iIndexIndex of the entry
int LMKAxServer::iWordCopySelected ( )
slot

Copy all selected items to Word.

int LMKAxServer::iWordGetItemProperties ( int  _iIndex,
int &  _irType,
QString &  _qrName,
QString &  _qrMarker,
int &  _irSelected 
)
slot

Get the informations about a data entry.

Parameters
_iIndexIndex of the entry
_irTypeReturns type of entry. Possible values:
  • 0 Image
  • 1 Table
  • 2 Graphic (e.g. sectional view or histogram)
  • 3 Diagram (e.g. 3D view or chromaticity diagram)
_qrNameReturns data name
_qrMarkerReturns text marker name
_irSelectedIs item selected?
int LMKAxServer::iWordGetNumberItems ( int &  _irNumber)
slot

Get number of data entries in Word dialog.

Parameters
_irNumberReturns number of items
int LMKAxServer::iWordOpenFile ( QString  _qFileName)
slot

Open an Word file for data export.

Parameters
_qFileNameFilename of Word file
int LMKAxServer::iWordSave ( )
slot

Save Word file.

int LMKAxServer::iWordSelectAll ( )
slot

Select all items in Word dialog.

int LMKAxServer::iWordSetItemProperties ( int  _iIndex,
QString  _qMarker,
int  _iSelect 
)
slot

Set the informations about a data entry.

Parameters
_iIndexIndex of the entry
_qMarkerChange marker name (don't change current value if empty string)
_iSelectShould item be selected in dialog?
  • -1 = don't change behaviour
  • 0 = deselect
  • 1 = select
int LMKAxServer::iWordSetVisible ( int  _iVisible)
slot

Change visbility of Word program.

Parameters
_iVisible0=invisible, 1=visible
int LMKAxServer::iWordUnselectAll ( )
slot

Unselect all items in Word dialog.

int LMKAxServer::iWriteIniFileEntry ( QString  _qFileName,
QString  _qSection,
QString  _qEntry,
QString  _qValue 
)
slot

Write value of an entry in a section of an inifile.

Parameters
_qFileNameInifile name
_qSectionSection name
_qEntryEntry name
_qValuenew value of entry
int LMKAxServer::iWritePhysicalRegister ( int  _iRegister,
int  _iValue 
)
slot

Write physical register of camera.

Parameters
_iRegisterNumber of register
_iValueNew value
int LMKAxServer::iWriteRegisterFile ( QString  _qFileName)
slot

Write register file.

Parameters
_qFileNameFile name
int LMKAxServer::iWriteRegisterMap ( QString  _qRegisterName,
int  _iValue 
)
slot

Write register value

Parameters
_qRegisterNameRegister name
_iValueValue
int LMKAxServer::iWriteToStatusLine ( QString  _qMessage)
slot

Writes a string to the status line of the program.

Parameters
_qMessageMessage to be shown
void LMKAxServer::vSignalImageContentChanged ( int  _iImage)
signal

After changing of an image, this signal is thrown.

Every time an image is updated, this signal is send with the index of the image. After this time point the user can read the new image data or call for changed statistic data.

Parameters
_iImage- -3 Camera image
  • -2 Luminance image
  • -1 Color image
  • 0..N-1 Evaluation images
void LMKAxServer::vSignalWaitTrigger ( double  _dTimeout)
signal

If capturing algorithm waits for extern trigger signal.

If the user captures images via the MultiPic, HighDyn or ColorHighdyn algorithm, it is not clear at which points the next camera image has to be triggered. And in the case of highdyn captures it is furthermore unclear, how many camera images needed and has to be triggered. Thats why before every needed trigger signal this signal is send to the user.

The user should not send the trigger signal within the function which has captured the callback signal. He has to return from thsi function and to wait some time (at least 1 ms or more) and then send the trigger signal to the camera.

Parameters
_dTimeoutHow long programm waits for the trigger signal. Time is given in seconds.