数字显微照片脚本对象是否可以收到图像上 ROI 更改的通知

Question

数字显微图脚本文档提到了各种类型的侦听器对象，这些对象可用于通知脚本对象各种类型的事件。 特别是，ImageDisplay 对象对密钥侦听器具有显式支持，以便在击键事件以特定图像显示为目标时可以通知脚本对象。 是否可以通过类似机制收到图像上的ROI大小或位置已更改的通知？

Answer 1

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

---

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

数码显微照片中的任何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" )
}

此方法仅接受"changed"作为消息，并且第三个参数字符串 （ConnectionID） 应该是唯一的，以便它可用于删除此特定连接，如下所示。这种方法的主要优点是它的简单性。

---

第二种选择：收听特定图像显示

还有一些侦听器可以连接到 imageDisplay 对象。这允许在此图像显示器上捕获来自"任何"ROI 的消息，但您可以再次使用唯一的 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 )
}

除非您必须通过多个图像显示器监控特定的投资回报率，否则第二个选项是更通用的选项。您注册roi_changed事件的方法不仅可以为您提供投资回报率的句柄，还可以控制它所在的显示器。数字变量包含事件标志，告诉您发生了哪些更改。

在 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 脚本数据库上找到 listerner 类型的脚本示例，即：

• 交互式旋转轮廓
• 用于 SI 的 3D 线轮廓