Question

DigitalMicrograph脚本文档提到了各种类型的Listener对象，可用于向脚本对象通知各种类型的事件。特别是，ImageDisplay对象明确支持键侦听器，以便在击键事件针对特定图像显示时可以通知脚本对象。是否可以通过类似的机制接收图像上的ROI在大小或位置上发生变化的通知？

Answer 1

是的。事实上，就投资回报率而言，有两种可能性。

第一个选项：收听特定的投资回报率

DigitalMicrograph中的任何ROI都有唯一的ID号。您可以像下面的脚本一样为该特定ROI-ID添加侦听器。请注意，相同的 ROI可以同时放在多个ImageDisplay上。（“链接的投资回报率”）。只要未释放ROI对象，就不会释放连接的侦听器对象，但您也可以显式删除连接。

Class myRListen : object
{
    myRListen( object self )  { Result( "\n myRListen " + self.ScriptObjectGetID() + " created.\n" ); }
    ~myRListen( object self ) { Result( "\n myRListen " + self.ScriptObjectGetID() + " destroyed.\n" ); }   
    void DoStuff( object self, ROI thisROI ){ Result( "ROI ID:" + thisROI.ROIGetID() + " acted!\n" ); }
}

// Main 
{
    Image   img1 := RealImage( "Test 1", 4, 256, 256 )
    img1 = iradius
    img1.ShowImage()
    Image   img2 := RealImage( "Test 2", 4, 256, 256 )
    img2 = icol
    img2.ShowImage()

    ROI testROI = NewROI()
    testROI.ROISetVolatile(0)
    testROI.ROISetRectangle( 50, 50, 100, 100 )
    img1.ImageGetImageDisplay(0).ImageDisplayAddROI(testROI)
    img2.ImageGetImageDisplay(0).ImageDisplayAddROI(testROI)

    // Connect the ROI of specific ID to the "DoStuff" method of listener on "changed" message.
    // The signature of the "DoStuff" method has to be of form ( object self , ROI thisROI )
    // The method returns a unique ID for this connection.

    Number roiID    = testROI.ROIGetID()
    object listener = Alloc(myRListen)          
    ConnectObject( roiID, "changed", "ConnectionID", listener, "DoStuff" )      
    if ( TwoButtonDialog( "Immediately disconnect?", "Yes", "No" ) )
        DisConnectObject( roiID, "changed", "ConnectionID" )
}

此方法仅接受“已更改”作为消息，并且第3个参数字符串（ConnectionID）应该是唯一的，以便可以用它来删除此特定连接，如图所示。这种方法的主要优点是简单。

第二个选项：收听特定的图像显示

还有一些侦听器可以连接到imageDisplay对象。这允许从此imageDisplay上的“任意”ROI捕获消息，但您可以再次使用unique-ROI-ID过滤掉您感兴趣的内容。只要imageDisplay未发布，侦听器对象就不会被释放，但是再次，您可以手动取消注册。

Class myRListen : object
{
    myRListen( object self )  { Result( "\n myRListen " + self.ScriptObjectGetID() + " created.\n" ); }
    ~myRListen( object self ) { Result( "\n myRListen " + self.ScriptObjectGetID() + " destroyed.\n" ); }   
    void DoROIStuff( object self, Number e_fl, ImageDisplay idisp, Number r_fl, Number r_fl2, ROI thisROI ){ Result( "ROI ID:" + thisROI.ROIGetID() + " acted!\n" ); }
}

// Main 
{
    Image   img := RealImage( "Test", 4, 256, 256 )
    img = iradius
    img.ShowImage()

    ROI testROI1 = NewROI()
    testROI1.ROISetVolatile( 0 )
    testROI1.ROISetRectangle( 50, 50, 100, 100 )
    ROI testROI2 = NewROI()
    testROI2.ROISetVolatile( 0 )
    testROI2.ROISetRectangle( 150, 150, 200, 200 )
    testROI2.ROISetColor( 0, 0, 1 )
    ImageDisplay disp = img.ImageGetImageDisplay( 0 )
    disp.ImageDisplayAddROI( testROI1 )
    disp.ImageDisplayAddROI( testROI2 ) 

    // Connect the ROI of specific ID to the "DoStuff" method of listener on "changed" message.
    // The signature of the "DoStuff" method has to be of form ( object self , ROI thisROI )
    // The method returns a unique ID for this connection.

    object listener = Alloc(myRListen)          
    Number listenerID = ImageDisplayAddEventListener( disp, listener, "roi_changed:DoROIStuff" )
    if ( TwoButtonDialog( "Immediately disconnect?", "Yes", "No" ) )
        ImageDisplayRemoveEventListener( disp, listenerID )
}

除非您必须通过多个imageDisplays监控特定的ROI，否则第二个选项是更通用的选项。注册roi_changed事件的方法不仅可以让您掌握ROI，还可以显示它所在的显示。数字变量包含事件标志，告诉您已更改的内容。

在GMS 2.3.1中，目前有以下ROI消息：

roi_added, 
roi_removed, 
roi_begin_track,
roi_end_track, 
roi_property_changed,
roi_display_changed, 
roi_changed

并且他们需要连接到签名方法

void RAction( object self, Number e_fl, ImageDisplay idisp, Number r_fl, Number r_fl2, ROI r )

实施例

您可以在FELIM script database上找到listerner类型的脚本示例，即：

是否可以通知DigitalMicrograph脚本对象图像的ROI更改？

1 个答案:

第一个选项：收听特定的投资回报率

第二个选项：收听特定的图像显示

实施例