hdevenginedotnet

Communication with hdevengine.dll

This is raised when errors occur within HDevEngine

The internal HALCON error code

Type of exception

Name of the originating HDevelop procedure

Script line in which the error occurred

Script line number at which the error occurred

User data which was added to the exception

Different types of errors when using HDevEngine

No special type

Unintialized input parameters for procedure call

HALCON error while executing an operator

Problems loading scripts or procedures files

Executes HDevelop programs and procedures at run time

The hdevenginecpp.dll is required for using this class.

Creates a new instance of HDevEngine

Returns true if this class has not yet been disposed

Changes a global setting of the engine

The name of the attribute, e.g. "ignore_invalid_lines" or "ignore_unresolved_lines" The new value of the attribute

Queries a global setting of the engine

The name of the attribute, e.g. "ignore_invalid_lines" or "ignore_unresolved_lines" The current value of the attribute

Starts the debug server that allows to attach HDevelop as as debugger to step through engine code.

With default settings server waits on port 57786 and engine runs normally until HDevelop is connected and F9 is pressed to stop execution.

Stops the debug server (resuming execution if stopped)

Sets the path for loading external procedures

List of directories in the path format of the operating system

Appends to the path for loading external procedures

List of directories in the path format of the operating system

Returns the names of available procedures

String tuple containing the procedure names

Returns the names of loaded procedures

String tuple containing the procedure names

Unloads a previously loaded procedure

The name of the procedure to unload

Unloads all previously loaded procedure

Returns the names of all global iconic variables

Returns the names of all global control variables

Gets the dimension of a global control variable

Sets the value of a global control variable

Sets the value of a global iconic variable

Gets the value of a global control variable

Gets the value of a global iconic variable

Gets the value of a global iconic image variable

Gets the value of a global iconic region variable

Gets the value of a global iconic XLD variable

Registers your implementation of visualization operators

An object implementing the IHDevOperators interface

Releases the resources used by this engine

Interface for implementation of HDevelop operators

This is intended for use with HDevEngine.SetHDevOperators. Note that two implementations are already provided ready-to-use, namely HDevOpFixedWindowImpl and HDevOpMultiWindowImpl.

Open a graphics window.

Row index of upper left corner. Default: 0 Column index of upper left corner. Default: 0 Width of the window. Default: 256 Height of the window. Default: 256 Color of the background of the new window. Default: "black" Window identifier. Caller assumes ownership of tuple

Close the active graphics window.

Activate a graphics window.

Window identifier.

Return the identifier of the activate graphics window.

Window identifier. Caller assumes ownership of tuple

Change position and size of a graphics window.

Row index of upper left corner. Default: 0 Column index of upper left corner. Default: 0 Width of the window. Default: 256 Height of the window. Default: 256

Modify the displayed image part.

Row of the upper left corner of the chosen image part. Default: 0 Column of the upper left corner of the chosen image part. Default: 0 Row of the lower right corner of the chosen image part. Default: 128 Column of the lower right corner of the chosen image part. Default: 128

Clear the active graphics window.

Displays image objects in the current graphics window.

Iconic object to be displayed. Attention! This will be disposed automatically by HDevEngine/.NET after DevDisplay returns. Do not keep a reference!

Displays text in the graphics window.

A tuple of strings containing the text message to be displayed. Each value of the tuple will be displayed in a single line. If set to 'window', the text position is given with respect to the window coordinate system.If set to 'image', image coordinates are used (this may be useful in zoomed images). he row coordinate of the desired text position. The column coordinate of the desired text position. A tuple of strings defining the colors of the texts. Generic parameter names. Generic parameter values.

Define the region fill mode.

Fill mode for region output. Default: "fill"

Define the contour fill style.

Fill style for contour output. Default: "stroke"

Define the region output shape.

Region output mode. Default: "original"

Set multiple output colors.

Number of output colors. Default: 6

Set output color.

Output color names. Default: "white"

Set "look-up-table" (lut).

Name of look-up-table, values of look-up-table (RGB) or file name. Default: "default"

Define the grayvalue output mode.

Grayvalue output name. Additional parameters possible. Default: "default"

Define the line width for region contour output.

Line width for region output in contour mode. Default: 1

Convenience implementation of HDevOperators for a single window

Dev* operators will be rerouted to this window ID

Creates an instance of the fixed window implementation

The window ID of an existing HALCON window

Creates an instance of the fixed window implementation

An existing HALCON window

Dispose the internal window reference

Does nothing except return the existing window ID

No action

Does nothing except return the existing window ID

No action

Convenience implementation of HDevOperators managing multiple windows

Window IDs of all open windows

Window IDs of all designated external windows

Flags indicating whether a fixed window is "dev-open"

Creates an instance initially managing zero open windows

List of IDs for existing HALCON windows

Creates an instance initially managing zero open windows

List of existing HALCON windows

Creates an instance with no fixed windows

Dispose the internal window reference

Opens a window, appends window ID and sets active window

Closes active window, removes it from list and activates another window

Sets the active window ID

No action for fixed windows, adapt size otherwise

This class wraps an object implementing IHDevOperators, registers internal delegates with the HDevEngine and calls the appropriate interface methods at callback time (including conversion of parameters and transformation of exceptions to return codes).

Encapsulates a local or external procedure

Creates an empty procedure instance

Loads an external procedure

Loads a local procedure

Loads an external procedure

Loads a local procedure

Creates a procedure call for this procedure

Create and execute a procedure call for this procedure

Check the load state of the procedure

Returns true if this class has not yet been disposed

Gets the names of the iconic input parameters

Gets the names of the iconic output parameters

Gets the names of the input control parameters

Gets the names of the output control parameters

Gets the dimensions of the iconic input parameters

Gets the dimensions of the iconic output parameters

Gets the dimensions of the input control parameters

Gets the dimensions of the output control parameters

Gets the number of parameters used for iconic input objects. Note that parameters are numbered from 1 to count.

Gets the number of parameters used for iconic output objects. Note that parameters are numbered from 1 to count.

Gets the number of parameters used for input control values. Note that parameters are numbered from 1 to count.

Gets the number of parameters used for output control values. Note that parameters are numbered from 1 to count.

Gets the name of a specific iconic input parameter

Gets the name of a specific iconic output parameter

Gets the name of a specific input control parameter

Gets the name of a specific output control parameter

Gets the dimension of a specific iconic input parameter

Gets the dimension of a specific iconic output parameter

Gets the dimension of a specific input control parameter

Gets the dimension of a specific output control parameter

Returns the names of all refered procedures

Compile all procedures that are used by the program and that can be compiled with a just-in-time compiler. The method returns true when all used procedures could be compiled by the just-in-time compiler. Procedures that could not be compiled are called normally by the HDevEngine interpreter. To check which procedure could not be compiled and what the reason is for that start HDevelop and check there the compilation states.

Returns the info of the refered procedure docu slot

Returns the info of the refered parameter docu slot

Returns all possible slots of the procedure docu

Returns all possible slots of the parameter docu

Releases the resources used by this engine

The name of the procedure

The short description of the procedure

Manages an execution instance for a local or external procedure

Creates a procedure call for the specified procedure

Returns true if this class has not yet been disposed

Gets the procedure associated with this procedure call

Executes the procedure

Stops execution on first line of procedure.

This is intended for debugging purposes when you wish to step through a specific procedure call. It only has an effect when a debug server is running and it will only stop once.

Resets the procedure execution

Sets input control parameter for procedure call

Sets iconic input object for procedure call

Sets input control parameter for procedure call

Gets the value of an output control parameter

Gets the object of an iconic output parameter

Gets the value of an output control parameter

Gets the image of an iconic output parameter

Gets the region of an iconic output parameter

Gets the xld contour of an iconic output parameter

Releases the resources used by this procedure call

Encapsulates a loaded HDevelop program

Creates an empty program instance

Loads an HDevelop program

Loads an HDevelop script

You can use this to exceute the program or local procedures. Path and file name of the HDevelop script

Creates a program call for this program

Create and execute a program call for this program

Check the load state of the program

Returns true if this class has not yet been disposed

Gets the variable names used for iconic objects

Gets the variable names used for control values

Gets the variable dimensions used for iconic objects

Gets the variable dimensions used for control values

Gets the number of variables used for iconic objects. Note that variables are numbered from 1 to count.

Gets the number of variables used for control values. Note that variables are numbered from 1 to count.

Gets the name of a specific iconic variable

Gets the name of a specific control variable

Gets the dimension of a specific iconic variable

Gets the dimension of a specific control variable

Returns the names of used local and external procedures

Returns the names of all local procedures

Releases the resources used by this engine

The name of the program

Manages an execution instance for an HDevelop program

Creates a program call for the specified program

Returns true if this class has not yet been disposed

Gets the program associated with this program call

Executes the program

Stops execution on first line of program.

This is intended for debugging purposes when you wish to step through a specific program call. It only has an effect when a debug server is running and it will only stop once.

Resets the program execution

Gets the value of a control variable (in main)

Gets the values of a control vector variable (in main)

Gets the value of a control variable (in main)

Gets the values of a control vector variable (in main)

Gets the object of an iconic variable (in main)

Gets the values of an iconic vector variable (in main)

Gets the object of an iconic variable (in main)

Gets the values of an iconic vector variable (in main)

Gets the image of an iconic variable (in main)

Gets the region of an iconic variable (in main)

Gets the xld contour of an iconic variable (in main)

Releases the resources used by this engine