poIImagePlane SetEdgeColor

Sets the color of the edges when the post-processing edge detection filter is active on an image plane.

Syntax

Imageplane_handle SetEdgeColor colorStr

Application

HyperView Tcl Modify

Description

The image plane offers several image post-processing filters that can be applied on the image or video. One of them is an edge detection filter, where detected edges in the image are rendered with a specified color. This command sets the RGB values for the color of the rendered edges.

Inputs

colorStr
A set of RGB color values that define the color. A string containing three RGB values between 0 and 255 must be passed.

Example

To create one image plane, and then use the edge detection filter to draw the edges in black:
Note: The image plane without the filter is shown in Figure 1 (below). The image plane with the edge detection filter active is shown in Figure 2 (below).
hwi OpenStack
if {[catch {
    hwi GetActiveClientHandle client_handle
    hwi GetSessionHandle session_handle
    client_handle GetImagePlaneCtrlHandle ipc_handle
    set ipid1 [ipc_handle AddImagePlane Logo1]
    ipc_handle GetImagePlaneHandle imageplane_handle $ipid1
    imageplane_handle SetFileName g:/samples2/VideoOverlay/Altair_logo.jpg
    imageplane_handle SetMode background
    imageplane_handle SetCrop 0 0 0.9995 0.995
    imageplane_handle SetFilterType Edge;
    imageplane_handle SetFilterMode Sobel;
    imageplane_handle SetEdgeColor "0 0 0";
    imageplane_handle SetMipMapMode Linear1
    puts "  Filter Type: [imageplane_handle GetFilterType]";
    puts "  Filter Mode: [imageplane_handle GetFilterMode]";
    puts "  Edge Color:  [imageplane_handle GetEdgeColor]";
    puts "  MipMap Mode: [imageplane_handle GetMipMapMode]";
    client_handle Draw
} result]} {
    global errorInfo;
    puts stderr $result;
    puts "[session_handle GetError]";
    puts stderr "*** Tcl TRACE ***";
    puts stderr $errorInfo;
} else {
    puts "No errors.";
    puts "Warnings: ";
    puts "    [session_handle GetError]";
}

hwi CloseStack

Errors

Returns HW_InvalidHandle if the image plane handle is invalid, or poIInvalidRGBValue if the specified color string is invalid.