fix(segmentation): restrict overlay segmentation menu to same frame of reference as viewport background display set (#5900)

- Add FrameOfReferenceUID to SEG and RTSTRUCT displaySet in SOP Class Handlers so the FOR is available for filtering
- Sync optimisticOverlayDisplaySets when background display set changes so the overlay menu reflects the correct state after a background switch
- Add FOR matching guard to the hydrate segmentation synchronizer to prevent the hydration synchronizer from blindly mirroring segmentations from a source viewport to a target viewport if their primary Frames of Reference do not align.
- fix segmentation overlay order reversal on viewport re-render

extensions/dicom-microscopy/src/services/MicroscopyService.ts

@@ -329,16 +329,16 @@ export default class MicroscopyService extends PubSubService {
     const studyMetadata = DicomMetadataStore.getStudy(StudyInstanceUID);
     const smDisplaySet = displaySets.find(ds => ds.Modality === 'SM');
 
-    const { FrameOfReferenceUID, othersFrameOfReferenceUID } = smDisplaySet;
+    const { frameOfReferenceUID, othersFrameOfReferenceUID } = smDisplaySet;
 
     if (!studyMetadata) {
       return;
     }
 
-    let derivedDisplaySets = FrameOfReferenceUID
+    let derivedDisplaySets = frameOfReferenceUID
       ? displaySets.filter(
           ds =>
-            ds.ReferencedFrameOfReferenceUID === FrameOfReferenceUID ||
+            ds.ReferencedFrameOfReferenceUID === frameOfReferenceUID ||
             // sometimes each depth instance has the different FrameOfReferenceID
             othersFrameOfReferenceUID.includes(ds.ReferencedFrameOfReferenceUID)
         )

extensions/dicom-microscopy/src/utils/getSourceDisplaySet.js

@@ -22,7 +22,7 @@ export default function getSourceDisplaySet(allDisplaySets, microscopySRDisplayS
   const referencedDisplaySet = otherDisplaySets.find(
     displaySet =>
       displaySet.Modality === 'SM' &&
-      (displaySet.FrameOfReferenceUID === ReferencedFrameOfReferenceUID ||
+      (displaySet.frameOfReferenceUID === ReferencedFrameOfReferenceUID ||
         // sometimes each depth instance has the different FrameOfReferenceID
         displaySet.othersFrameOfReferenceUID.includes(ReferencedFrameOfReferenceUID))
   );