配置

在版本 2.x 中，分割配置通过一个统一的样式系统进行管理，该系统可以使用指定对象在不同的特定层级上应用。

样式系统

样式可以应用于多个层级：

• 所有分割的全局样式
• 类型特定样式（例如，所有 Labelmaps）
• 视口特定样式
• 分割特定样式
• 片段特定样式

样式配置对象结构取决于表示类型：

// Labelmap 样式示例
{
  renderFill: true,
  renderOutline: true,
  outlineWidth: 3,
  fillAlpha: 0.7,
  outlineAlpha: 0.9
}

// Contour 样式示例
{
  renderFill: true,
  renderOutline: true,
  outlineWidth: 2
}

// Surface 样式示例
{
  renderFill: true,
  fillAlpha: 0.7
}

样式 API

新样式 API 使用指定对象针对特定配置：

import { segmentation } from '@cornerstonejs/tools';

// 获取特定上下文的样式
const style = segmentation.getStyle({
  viewportId: 'viewport1',            // 可选
  segmentationId: 'segmentation1',    // 可选
  type: Enums.SegmentationRepresentations.Labelmap,  // 必需
  segmentIndex: 1                     // 可选
});

// 为特定上下文设置样式
segmentation.setStyle(
  {
    viewportId: 'viewport1',
    segmentationId: 'segmentation1',
    type: Enums.SegmentationRepresentations.Labelmap
  },
  {
    renderFill: true,
    renderOutline: true,
    outlineWidth: 3
  }
);

// 重置为全局样式
segmentation.resetToGlobalStyle();

// 检查一个上下文是否有自定义样式
const hasCustomStyle = segmentation.hasCustomStyle({
  viewportId: 'viewport1',
  segmentationId: 'segmentation1',
  type: Enums.SegmentationRepresentations.Labelmap
});

非活动的分割

非活动分割的渲染现在在每个视口中控制：

// 设置是否在视口中渲染非活动的分割
segmentation.setRenderInactiveSegmentations('viewport1', true);

// 获取是否在视口中渲染非活动的分割
const renderInactive = segmentation.getRenderInactiveSegmentations('viewport1');

颜色管理

颜色 API 已更新为视口特定，并使用更一致的命名：

import { segmentation } from '@cornerstonejs/tools';

// 添加一个新的颜色 LUT
const colorLUTIndex = segmentation.addColorLUT(colorLUT);

// 为视口中的分割设置颜色 LUT
segmentation.setColorLUT('viewport1', 'segmentation1', colorLUTIndex);

// 获取特定片段的颜色
const color = segmentation.getSegmentIndexColor(
  'viewport1',
  'segmentation1',
  segmentIndex
);

// 为特定片段设置颜色
segmentation.setSegmentIndexColor(
  'viewport1',
  'segmentation1',
  segmentIndex,
  [255, 0, 0, 255]  // RGBA 颜色
);

样式层级

样式按以下优先级顺序应用（从高到低）：

1. 片段特定样式（当提供 segmentIndex 时）
2. 视口特定样式（当提供 viewportId 时）
3. 分割特定样式（当提供 segmentationId 时）
4. 类型特定样式（仅提供类型时）
5. 全局样式

示例：

// 设置所有 labelmaps 的全局样式
segmentation.setStyle(
  { type: Enums.SegmentationRepresentations.Labelmap },
  { renderOutline: true }
);

// 覆盖特定视口的样式
segmentation.setStyle(
  {
    viewportId: 'viewport1',
    type: Enums.SegmentationRepresentations.Labelmap
  },
  { renderOutline: false }
);

// 为特定片段设置样式
segmentation.setStyle(
  {
    viewportId: 'viewport1',
    segmentationId: 'segmentation1',
    type: Enums.SegmentationRepresentations.Labelmap,
    segmentIndex: 1
  },
  { outlineWidth: 5 }
);

提示

有关每种表示类型的可用样式选项的详细信息，请参阅 API 文档。