Adaptive Outlines（適応枠線） / Adaptive Outlines

日本語 | English

日本語

adaptiveOutlines: true で密度や近傍状況に応じて枠線/不透明度を自動調整します。

• outlineWidthPreset: 'thin' | 'medium' | 'thick' | 'adaptive'
• adaptiveParams: 近傍半径/しきい値/Z軸補正/重なり検出 など
• 透過制御: boxOpacityResolver / outlineOpacityResolver（優先度: resolver > adaptive > fixed）
• 表示モード: outlineRenderMode: 'standard' | 'inset' | 'emulation-only'

代表パターン

// 密集域は細め、疎な場所とTopNは太め
const heatbox = new Heatbox(viewer, {
  adaptiveOutlines: true,
  outlineWidthPreset: 'adaptive',
  adaptiveParams: {
    neighborhoodRadius: 50,
    densityThreshold: 5,
    zScaleCompensation: true,
    overlapDetection: true
  },
  outlineRenderMode: 'inset',
  outlineInset: 1.5
});

// TopN を強調しつつ、その他は抑制
const heatbox = new Heatbox(viewer, {
  adaptiveOutlines: true,
  outlineWidthPreset: 'thick',
  highlightTopN: 20,
  boxOpacityResolver: ({ isTopN }) => (isTopN ? 0.9 : 0.5),
  outlineOpacityResolver: ({ isTopN }) => (isTopN ? 1.0 : 0.4)
});

ヒント

• 密集域の線太り→ overlapRiskFactor を上げる or outlineRenderMode: 'emulation-only'
• 遠距離で線が見えにくい→ cameraDistanceFactor を上げる
• 細部の抜け→ 'uniform' へ戻す or outlineInset を小さめに

English

Enable adaptiveOutlines: true to adjust outline width and opacity based on density and context.

• outlineWidthPreset: 'thin' | 'medium' | 'thick' | 'adaptive'
• adaptiveParams: neighborhood radius, density threshold, Z-scale compensation, overlap detection, etc.
• Opacity control via resolvers: boxOpacityResolver / outlineOpacityResolver
• Display mode: outlineRenderMode: 'standard' | 'inset' | 'emulation-only'

Patterns

const heatbox = new Heatbox(viewer, {
  adaptiveOutlines: true,
  outlineWidthPreset: 'adaptive',
  adaptiveParams: { neighborhoodRadius: 50, densityThreshold: 5, zScaleCompensation: true, overlapDetection: true },
  outlineRenderMode: 'inset', outlineInset: 1.5
});

const heatbox = new Heatbox(viewer, {
  adaptiveOutlines: true,
  outlineWidthPreset: 'thick',
  highlightTopN: 20,
  boxOpacityResolver: ({ isTopN }) => (isTopN ? 0.9 : 0.5),
  outlineOpacityResolver: ({ isTopN }) => (isTopN ? 1.0 : 0.4)
});

Tips:

• Thick lines in dense areas → enable overlapDetection and consider 'inset' mode
• Thin at far distance → clamp with adaptiveParams.outlineWidthRange
• Missing details → switch to 'medium' preset or reduce outlineInset