@363045841yyt/klinechart-core 0.7.3

package/src/engine/renderers/candle.ts

@@ -0,0 +1,459 @@
+import type { RendererPlugin, RenderContext } from '../../plugin'
+import { RENDERER_PRIORITY } from '../../plugin'
+import type { KLineData } from '../../types/price'
+import { getKLineTrend, type kLineTrend } from '../../types/kLine'
+import { createAlignedKLineFromPx, createVerticalLineRect } from '../draw/pixelAlign'
+import { getColors, type PriceColors, type VolumePriceColors } from '../theme/colors'
+import { getPhysicalKLineConfig } from '../chart'
+import { VolumePriceRelation } from '../../types/volumePrice'
+import { analyzeVolumePriceRelationBatch, DEFAULT_VOLUME_PRICE_CONFIG } from '../../utils/volumePrice'
+import type { MarkerManager } from '../marker/registry'
+
+type CandleRenderData = {
+    i: number
+    aligned: ReturnType<typeof createAlignedKLineFromPx>
+    trend: kLineTrend
+    openY: number
+    closeY: number
+    highY: number
+    lowY: number
+    alignedHighY: number
+    alignedLowY: number
+    e: KLineData
+}
+
+type PreparedCandles = {
+    upKLines: CandleRenderData[]
+    downKLines: CandleRenderData[]
+    upBodyBuf: Float32Array
+    upBodyCount: number
+    downBodyBuf: Float32Array
+    downBodyCount: number
+    upWickBuf: Float32Array
+    upWickCount: number
+    downWickBuf: Float32Array
+    downWickCount: number
+    wickWidth: number
+    relations: VolumePriceRelation[] | null
+    showVolumePriceMarkers: boolean
+}
+
+/**
+ * 创建 K 线蜡烛图渲染器插件
+ */
+export function createCandleRenderer(): RendererPlugin {
+    return {
+        name: 'candle',
+        version: '1.0.0',
+        description: 'K线蜡烛图渲染器',
+        debugName: 'K线',
+        paneId: 'main',
+        priority: RENDERER_PRIORITY.MAIN,
+
+        draw(context: RenderContext) {
+            const { ctx, pane, data, range, scrollLeft, kWidth, kGap, dpr, kLinePositions, markerManager, settings } = context
+            const colors = getColors(context.theme)
+            const klineData = data as KLineData[]
+            if (!klineData.length) return
+
+            const prepared = prepareCandles({
+                pane,
+                data: klineData,
+                range,
+                kWidth,
+                kGap,
+                dpr,
+                kLinePositions,
+                settings,
+            })
+
+            const usedWebGL = drawCandlesWithWebGL(context, prepared, colors.PRICE)
+            if (!usedWebGL) {
+                drawCandlesWithCanvas2D(ctx, scrollLeft, prepared, colors.PRICE)
+            } else {
+                compositeWebGLToMainCanvas(ctx, context)
+            }
+
+            drawVolumePriceMarkers(context, prepared, markerManager as MarkerManager | undefined)
+        },
+    }
+}
+
+function prepareCandles(args: {
+    pane: RenderContext['pane']
+    data: KLineData[]
+    range: { start: number; end: number }
+    kWidth: number
+    kGap: number
+    dpr: number
+    kLinePositions: number[]
+    settings?: RenderContext['settings']
+}): PreparedCandles {
+    const { pane, data, range, kWidth, kGap, dpr, kLinePositions, settings } = args
+    const { kWidthPx } = getPhysicalKLineConfig(kWidth, kGap, dpr)
+    const showVolumePriceMarkers = settings?.showVolumePriceMarkers !== false
+    const relations = showVolumePriceMarkers
+        ? analyzeVolumePriceRelationBatch(data, range.start, range.end, DEFAULT_VOLUME_PRICE_CONFIG)
+        : null
+
+    const upKLines: CandleRenderData[] = []
+    const downKLines: CandleRenderData[] = []
+    const maxRects = Math.max(1, range.end - range.start)
+    const upBodyBuf = new Float32Array(maxRects * 4)
+    const downBodyBuf = new Float32Array(maxRects * 4)
+    const upWickBuf = new Float32Array(maxRects * 2 * 4)
+    const downWickBuf = new Float32Array(maxRects * 2 * 4)
+    let upBodyCount = 0
+    let downBodyCount = 0
+    let upWickCount = 0
+    let downWickCount = 0
+
+    // 预取 displayRange，避免循环内每根 K 线 4 次 getDisplayRange()
+    const { maxPrice, minPrice } = pane.yAxis.getDisplayRange()
+    const paddingTop = pane.yAxis.getPaddingTop()
+    const paddingBottom = pane.yAxis.getPaddingBottom()
+    const viewHeight = Math.max(1, pane.height - paddingTop - paddingBottom)
+    const isLinear = pane.yAxis.getScaleType() !== 'log'
+    let fastPriceToY: (price: number) => number
+    if (isLinear) {
+        const priceRange = maxPrice - minPrice || 1
+        const scaleK = viewHeight / priceRange
+        const scaleB = paddingTop + viewHeight
+        fastPriceToY = (price: number) => scaleB - (price - minPrice) * scaleK
+    } else {
+        // 对数模式回退到标准方法
+        fastPriceToY = (price: number) => pane.yAxis.priceToY(price)
+    }
+
+    for (let i = range.start; i < range.end && i < data.length; i++) {
+        const e = data[i]
+        if (!e) continue
+
+        const openY = fastPriceToY(e.open)
+        const closeY = fastPriceToY(e.close)
+        const highY = fastPriceToY(e.high)
+        const lowY = fastPriceToY(e.low)
+
+        const leftLogical = kLinePositions[i - range.start]
+        if (leftLogical === undefined) continue
+
+        const alignY = (logical: number) => Math.round(logical * dpr) / dpr
+        const alignedOpenY = alignY(openY)
+        const alignedCloseY = alignY(closeY)
+        const alignedHighY = alignY(highY)
+        const alignedLowY = alignY(lowY)
+        const alignedRawRectY = Math.min(alignedOpenY, alignedCloseY)
+        const alignedRawRectH = Math.max(Math.abs(alignedOpenY - alignedCloseY), 1)
+
+        const roundedLeftPx = Math.round(leftLogical * dpr)
+        const aligned = createAlignedKLineFromPx(
+            roundedLeftPx,
+            alignedRawRectY,
+            kWidthPx,
+            alignedRawRectH,
+            dpr
+        )
+
+        const trend: kLineTrend = getKLineTrend(e)
+        const renderData: CandleRenderData = {
+            i,
+            aligned,
+            trend,
+            openY,
+            closeY,
+            highY,
+            lowY,
+            alignedHighY,
+            alignedLowY,
+            e,
+        }
+
+        const bodyRect = aligned.bodyRect
+        const targetKLines = trend === 'up' ? upKLines : downKLines
+        const isUp = trend === 'up'
+
+        targetKLines.push(renderData)
+
+        if (isUp) {
+            const off = upBodyCount++ * 4
+            upBodyBuf[off] = bodyRect.x
+            upBodyBuf[off + 1] = bodyRect.y
+            upBodyBuf[off + 2] = bodyRect.width
+            upBodyBuf[off + 3] = bodyRect.height
+        } else {
+            const off = downBodyCount++ * 4
+            downBodyBuf[off] = bodyRect.x
+            downBodyBuf[off + 1] = bodyRect.y
+            downBodyBuf[off + 2] = bodyRect.width
+            downBodyBuf[off + 3] = bodyRect.height
+        }
+
+        const bodyTop = bodyRect.y
+        const bodyBottom = bodyRect.y + bodyRect.height
+        const bodyHigh = Math.max(e.open, e.close)
+        const bodyLow = Math.min(e.open, e.close)
+
+        if (e.high > bodyHigh) {
+            const wick = createVerticalLineRect(aligned.wickRect.x, alignedHighY, bodyTop, dpr)
+            if (wick) {
+                const buf = isUp ? upWickBuf : downWickBuf
+                const idx = isUp ? upWickCount++ : downWickCount++
+                const off = idx * 4
+                buf[off] = wick.x
+                buf[off + 1] = wick.y
+                buf[off + 2] = wick.width
+                buf[off + 3] = wick.height
+            }
+        }
+        if (e.low < bodyLow) {
+            const wick = createVerticalLineRect(aligned.wickRect.x, bodyBottom, alignedLowY, dpr)
+            if (wick) {
+                const buf = isUp ? upWickBuf : downWickBuf
+                const idx = isUp ? upWickCount++ : downWickCount++
+                const off = idx * 4
+                buf[off] = wick.x
+                buf[off + 1] = wick.y
+                buf[off + 2] = wick.width
+                buf[off + 3] = wick.height
+            }
+        }
+    }
+
+    const wickWidth = upKLines[0]?.aligned.wickRect.width ?? downKLines[0]?.aligned.wickRect.width ?? 1
+
+    return {
+        upKLines,
+        downKLines,
+        upBodyBuf,
+        upBodyCount,
+        downBodyBuf,
+        downBodyCount,
+        upWickBuf,
+        upWickCount,
+        downWickBuf,
+        downWickCount,
+        wickWidth,
+        relations,
+        showVolumePriceMarkers,
+    }
+}
+
+function drawCandlesWithCanvas2D(ctx: CanvasRenderingContext2D, scrollLeft: number, prepared: PreparedCandles, priceColors: PriceColors): void {
+    ctx.save()
+    ctx.translate(-scrollLeft, 0)
+
+    ctx.fillStyle = priceColors.UP
+    for (let i = 0; i < prepared.upBodyCount; i++) {
+        const off = i * 4
+        ctx.fillRect(prepared.upBodyBuf[off], prepared.upBodyBuf[off + 1], prepared.upBodyBuf[off + 2], prepared.upBodyBuf[off + 3])
+    }
+
+    ctx.fillStyle = priceColors.DOWN
+    for (let i = 0; i < prepared.downBodyCount; i++) {
+        const off = i * 4
+        ctx.fillRect(prepared.downBodyBuf[off], prepared.downBodyBuf[off + 1], prepared.downBodyBuf[off + 2], prepared.downBodyBuf[off + 3])
+    }
+
+    ctx.fillStyle = priceColors.UP
+    for (let i = 0; i < prepared.upWickCount; i++) {
+        const off = i * 4
+        ctx.fillRect(prepared.upWickBuf[off], prepared.upWickBuf[off + 1], prepared.wickWidth, prepared.upWickBuf[off + 3])
+    }
+
+    ctx.fillStyle = priceColors.DOWN
+    for (let i = 0; i < prepared.downWickCount; i++) {
+        const off = i * 4
+        ctx.fillRect(prepared.downWickBuf[off], prepared.downWickBuf[off + 1], prepared.wickWidth, prepared.downWickBuf[off + 3])
+    }
+
+    ctx.restore()
+}
+
+function drawCandlesWithWebGL(context: RenderContext, prepared: PreparedCandles, priceColors: PriceColors): boolean {
+    if (context.settings?.enableWebGLRendering === false) return false
+    const surface = context.candleWebGLSurface
+    if (!surface || !surface.isAvailable()) return false
+
+    surface.clear()
+
+    const bodyUpOk = prepared.upBodyCount === 0 || surface.drawRectBuffer(prepared.upBodyBuf.subarray(0, prepared.upBodyCount * 4), prepared.upBodyCount, priceColors.UP, context.scrollLeft)
+    const bodyDownOk = prepared.downBodyCount === 0 || surface.drawRectBuffer(prepared.downBodyBuf.subarray(0, prepared.downBodyCount * 4), prepared.downBodyCount, priceColors.DOWN, context.scrollLeft)
+    const wickUpOk = prepared.upWickCount === 0 || surface.drawRectBuffer(prepared.upWickBuf.subarray(0, prepared.upWickCount * 4), prepared.upWickCount, priceColors.UP, context.scrollLeft)
+    const wickDownOk = prepared.downWickCount === 0 || surface.drawRectBuffer(prepared.downWickBuf.subarray(0, prepared.downWickCount * 4), prepared.downWickCount, priceColors.DOWN, context.scrollLeft)
+
+    return bodyUpOk && bodyDownOk && wickUpOk && wickDownOk
+}
+
+function compositeWebGLToMainCanvas(ctx: CanvasRenderingContext2D, context: RenderContext): void {
+    const surface = context.candleWebGLSurface
+    if (!surface) return
+
+    surface.compositeTo(ctx)
+}
+
+function drawVolumePriceMarkers(
+    context: RenderContext,
+    prepared: PreparedCandles,
+    markerManager: MarkerManager | undefined
+): void {
+    const { ctx, range, kWidth, dpr } = context
+    const colors = getColors(context.theme)
+    if (!prepared.showVolumePriceMarkers || !markerManager || (context.zoomLevel ?? 1) < 2) {
+        return
+    }
+
+    ctx.save()
+    ctx.translate(-context.scrollLeft, 0)
+
+    for (const k of prepared.upKLines) {
+        const relation = prepared.relations?.[k.i - range.start]
+        if (relation !== undefined && relation !== VolumePriceRelation.OTHERS) {
+            const isRising = relation === VolumePriceRelation.RISE_WITH_VOLUME || relation === VolumePriceRelation.RISE_WITHOUT_VOLUME
+            const markerY = isRising ? k.alignedHighY - 15 : k.alignedLowY + 15
+            const posIndex = k.i - range.start
+            const markerX = context.kLineCenters[posIndex]!
+            drawVolumePriceMarker(ctx, markerX, markerY, relation, k.i, kWidth, 4, markerManager, dpr, colors.VOLUME_PRICE)
+        }
+    }
+
+    for (const k of prepared.downKLines) {
+        const relation = prepared.relations?.[k.i - range.start]
+        if (relation !== undefined && relation !== VolumePriceRelation.OTHERS) {
+            const isRising = relation === VolumePriceRelation.RISE_WITH_VOLUME || relation === VolumePriceRelation.RISE_WITHOUT_VOLUME
+            const markerY = isRising ? k.alignedHighY - 15 : k.alignedLowY + 15
+            const posIndex = k.i - range.start
+            const markerX = context.kLineCenters[posIndex]!
+            drawVolumePriceMarker(ctx, markerX, markerY, relation, k.i, kWidth, 4, markerManager, dpr, colors.VOLUME_PRICE)
+        }
+    }
+
+    ctx.restore()
+}
+
+/**
+* 绘制量价关系标记
+* 在K线图上标注量价关系标记符号
+*
+* @param ctx - Canvas绘图上下文
+* @param x - 标记的x坐标（三角形水平中心）
+* @param y - 标记的y坐标（三角形底边/顶点与K线的接触点）
+* @param relation - 量价关系类型
+* @param kWidth - K线宽度，作为三角形边长
+* @param gap - 三角形与K线的间距，默认为4
+* @param dpr - 设备像素比
+*/
+export function drawVolumePriceMarker(
+    ctx: CanvasRenderingContext2D,
+    x: number,
+    y: number,
+    relation: VolumePriceRelation,
+    kIndex: number,
+    kWidth: number,
+    gap: number = 4,
+    markerManager: MarkerManager,
+    dpr: number,
+    volumePriceColors: VolumePriceColors
+): void {
+    const align = (v: number) => Math.round(v * dpr) / dpr
+    x = align(x)
+    y = align(y)
+
+    const sideLength = Math.min(kWidth, 20)
+    const height = sideLength * Math.sqrt(3) / 2
+
+    let color: string
+    let isUp: boolean
+
+    switch (relation) {
+        case VolumePriceRelation.RISE_WITH_VOLUME:
+            color = volumePriceColors.RISE_WITH
+            isUp = true
+            break
+        case VolumePriceRelation.RISE_WITHOUT_VOLUME:
+            color = volumePriceColors.RISE_WITHOUT
+            isUp = true
+            break
+        case VolumePriceRelation.FALL_WITH_VOLUME:
+            color = volumePriceColors.FALL_WITH
+            isUp = false
+            break
+        case VolumePriceRelation.FALL_WITHOUT_VOLUME:
+            color = volumePriceColors.FALL_WITHOUT
+            isUp = false
+            break
+        default:
+            return
+    }
+
+    ctx.save()
+    ctx.beginPath()
+
+    if (isUp) {
+        const baseY = align(y - gap)
+        const tipY = align(baseY - height)
+
+        ctx.moveTo(x, tipY)
+        ctx.lineTo(align(x - sideLength / 2), baseY)
+        ctx.lineTo(align(x + sideLength / 2), baseY)
+    } else {
+        const baseY = align(y + gap)
+        const tipY = align(baseY + height)
+
+        ctx.moveTo(x, tipY)
+        ctx.lineTo(align(x - sideLength / 2), baseY)
+        ctx.lineTo(align(x + sideLength / 2), baseY)
+    }
+
+    ctx.closePath()
+
+    ctx.fillStyle = color
+    ctx.fill()
+
+    ctx.restore()
+
+    let boundingX: number
+    let boundingY: number
+
+    if (isUp) {
+        const baseY = align(y - gap)
+        const tipY = align(baseY - height)
+        boundingX = align(x - sideLength / 2)
+        boundingY = tipY
+    } else {
+        const baseY = align(y + gap)
+        const tipY = align(baseY + height)
+        boundingX = align(x - sideLength / 2)
+        boundingY = baseY
+    }
+
+    let markerTypeKey: string
+    switch (relation) {
+        case VolumePriceRelation.RISE_WITH_VOLUME:
+            markerTypeKey = 'RISE_WITH_VOLUME'
+            break
+        case VolumePriceRelation.RISE_WITHOUT_VOLUME:
+            markerTypeKey = 'RISE_WITHOUT_VOLUME'
+            break
+        case VolumePriceRelation.FALL_WITH_VOLUME:
+            markerTypeKey = 'FALL_WITH_VOLUME'
+            break
+        case VolumePriceRelation.FALL_WITHOUT_VOLUME:
+            markerTypeKey = 'FALL_WITHOUT_VOLUME'
+            break
+        default:
+            return
+    }
+
+    const markerId = `mk_price-volume_${kIndex}`
+    markerManager.register({
+        id: markerId,
+        type: 'triangle',
+        markerType: markerTypeKey,
+        x: boundingX,
+        y: boundingY,
+        width: sideLength,
+        height: height,
+        dataIndex: kIndex,
+        metadata: { relation }
+    })
+}

package/src/engine/renderers/crosshair.ts

@@ -0,0 +1,69 @@
+import type { RendererPlugin, RenderContext } from '../../plugin'
+import { RENDERER_PRIORITY, GLOBAL_PANE_ID } from '../../plugin'
+import { createHorizontalLineRect, createVerticalLineRect } from '../draw/pixelAlign'
+import { getColors } from '../theme/colors'
+
+/**
+ * 创建十字线渲染器插件
+ * 垂直线绘制到所有面板，水平线只绘制到活跃面板
+ */
+export function createCrosshairRendererPlugin(options: {
+  getCrosshairState: () => {
+    pos: { x: number; y: number } | null
+    activePaneId: string | null
+    isDragging: boolean
+    /** 十字线指向的价格（用于价格轴平移时跟随） */
+    price: number | null
+  }
+}): RendererPlugin {
+  return {
+    name: 'crosshair',
+    version: '1.0.0',
+    description: '十字线渲染器',
+    debugName: '十字线',
+    paneId: GLOBAL_PANE_ID,
+    priority: RENDERER_PRIORITY.SYSTEM_CROSSHAIR,
+    layer: 'overlay',
+
+    draw(context: RenderContext) {
+      const { pane, dpr, paneWidth, overlayCtx } = context
+      const colors = getColors(context.theme)
+      const state = options.getCrosshairState()
+
+      if (state.isDragging || !state.pos) return
+
+      const { x } = state.pos
+      const isActive = pane.id === state.activePaneId
+
+      // 使用价格计算 Y 坐标（支持价格轴平移）
+      let localY = -1
+      if (isActive && state.price !== null) {
+        localY = pane.yAxis.priceToY(state.price)
+      }
+
+      // 优先使用 overlayCtx，若不存在则跳过（不回落到主画布）
+      const ctx = overlayCtx
+      if (!ctx) return
+
+      ctx.save()
+      ctx.beginPath()
+      ctx.rect(0, 0, paneWidth, pane.height)
+      ctx.clip()
+
+      ctx.fillStyle = colors.CROSSHAIR.LINE
+
+      // 绘制垂直线
+      const v = createVerticalLineRect(x, 0, pane.height, dpr)
+      if (v) ctx.fillRect(v.x, v.y, v.width, v.height)
+
+      // 绘制水平线（仅在活跃面板）
+      if (isActive && localY >= 0) {
+        const safeY = Math.min(localY, pane.height - 1 / dpr)
+        const h = createHorizontalLineRect(0, paneWidth, safeY, dpr)
+        if (h) ctx.fillRect(h.x, h.y, h.width, h.height)
+      }
+
+      ctx.restore()
+    },
+  }
+}

package/src/engine/renderers/customMarkers.ts

@@ -0,0 +1,162 @@
+import type { RendererPlugin, RenderContext, MarkerManagerLike } from '../../plugin'
+import { RENDERER_PRIORITY, GLOBAL_PANE_ID } from '../../plugin'
+import type { KLineData } from '../../types/price'
+import type { CustomMarkerEntity, CustomMarkerShape } from '../marker/registry'
+import { drawShape, drawLabel, hitTestShape } from '../../semantic/drawShape'
+import { roundToPhysicalPixel } from '../draw/pixelAlign'
+
+/** 默认标记尺寸（相对于 K 线宽度的缩放因子） */
+const DEFAULT_SIZE_SCALE = 1.2
+/** 最大标记尺寸（像素） */
+const MAX_MARKER_SIZE = 24
+/** 最小标记尺寸（像素） */
+const MIN_MARKER_SIZE = 6
+
+/** 根据形状判断默认渲染位置（true = 上方，false = 下方） */
+function isShapeRenderAboveKLine(shape: CustomMarkerShape): boolean {
+    switch (shape) {
+        case 'arrow_up':
+        case 'flag':
+            return true // 上涨信号、重要事件 → 默认在K线上方
+        case 'arrow_down':
+        case 'circle':
+        case 'rectangle':
+        case 'diamond':
+        default:
+            return false // 下跌信号、普通标记 → 默认在K线下方
+    }
+}
+
+/**
+ * 创建自定义标记渲染器插件
+ * 负责渲染 semanticConfig 中配置的 customMarkers
+ */
+export function createCustomMarkersRenderer(): RendererPlugin {
+    return {
+        name: 'customMarkers',
+        version: '1.0.0',
+        description: '自定义标记渲染器',
+        debugName: '自定义标记',
+        paneId: GLOBAL_PANE_ID,
+        priority: RENDERER_PRIORITY.OVERLAY,
+
+        draw(context: RenderContext): void {
+            const { ctx, pane, data, range, scrollLeft, kWidth, kLineCenters, dpr, markerManager, zoomLevel } = context
+            if (!markerManager) return
+            if ((zoomLevel ?? 1) < 2) return
+
+            const customMarkers = markerManager.getCustomMarkers() as CustomMarkerEntity[]
+            if (!customMarkers || customMarkers.length === 0) return
+
+            const klineData = data as KLineData[]
+            if (!klineData.length) return
+            if (pane.role !== 'price') return
+
+            ctx.save()
+            ctx.translate(-scrollLeft, 0)
+
+            for (const marker of customMarkers) {
+                // 1. timestamp → index（直接在原数组上二分查找）
+                const kIndex = findIndexByTimestamp(klineData, marker.timestamp)
+                if (kIndex === -1) continue
+
+                // 2. 检查是否在可视区域内
+                if (kIndex < range.start || kIndex >= range.end) continue
+
+                // 3. 计算像素坐标
+                const posIndex = kIndex - range.start
+                if (posIndex < 0 || posIndex >= kLineCenters.length) continue
+
+                const pixelX = kLineCenters[posIndex]!
+
+                const kData = klineData[kIndex]!
+                const userSize = marker.style?.size
+                const actualSize = calculateMarkerSize(kWidth, userSize)
+
+                // 4. 判断标记渲染位置（上方或下方）
+                // 如果 offset.y < 0，说明用户想渲染在上方；否则根据形状默认判断
+                const isAboveKLine = (marker.offset?.y ?? 0) < 0
+                    ? true
+                    : (marker.offset?.y ?? 0) > 0
+                        ? false
+                        : isShapeRenderAboveKLine(marker.shape)
+
+                // 5. 计算 Y 坐标
+                let pixelY: number
+                if (isAboveKLine) {
+                    // 在K线上方（基于 high）
+                    const highY = pane.yAxis.priceToY(kData.high)
+                    pixelY = highY - actualSize / 2 - 4 + (marker.offset?.y ?? 0)
+                } else {
+                    // 在K线下方（基于 low）
+                    const lowY = pane.yAxis.priceToY(kData.low)
+                    pixelY = lowY + actualSize / 2 + 4 + (marker.offset?.y ?? 0)
+                }
+
+                // 6. 应用 X 偏移
+                const finalX = pixelX + (marker.offset?.x ?? 0)
+                const finalY = pixelY
+
+                // 7. 物理像素对齐
+                // X: kLineCenters 已对齐，直接使用；Y: priceToY 是浮点数，需要对齐
+                const alignedX = finalX
+                const alignedY = finalY
+                // 确保 size*2*dpr 为偶数，使 size/2 在物理像素上为整数
+                const alignedSize = Math.round(actualSize * dpr / 2) * 2 / dpr
+
+                // 8. 绘制形状和标签（使用对齐后的坐标和尺寸）
+                drawShape(ctx, marker.shape, alignedX, alignedY, alignedSize, marker.style || {})
+                if (marker.label) {
+                    // 标签位置：标记在K线上方 → 文字在标记上方；标记在K线下方 → 文字在标记下方
+                    drawLabel(ctx, marker.label, alignedX, alignedY, alignedSize, marker.style || {}, isAboveKLine)
+                }
+
+                // 9. 记录位置和实际大小用于 hitTest（使用对齐后的值）
+                markerManager.setCustomMarkerPosition(marker.id, alignedX - scrollLeft, alignedY, alignedSize, marker.shape)
+            }
+
+            ctx.restore()
+        },
+    }
+}
+
+/**
+ * 计算标记实际显示大小
+ * @param kWidth K线宽度
+ * @param userSize 用户配置的最大尺寸（可选）
+ * @returns 实际显示大小（像素）
+ */
+function calculateMarkerSize(kWidth: number, userSize?: number): number {
+    // 基于 kWidth 的基准大小
+    const baseSize = kWidth * DEFAULT_SIZE_SCALE
+
+    // 如果用户指定了最大尺寸，则限制不超过该值
+    const maxSize = userSize ?? MAX_MARKER_SIZE
+
+    // 最终大小：取基准大小和最大值中的较小者，但不小于最小值
+    return Math.max(MIN_MARKER_SIZE, Math.min(baseSize, maxSize))
+}
+
+/**
+ * 直接在有序数据上二分查找 timestamp 对应的 index
+ * 避免每帧分配新数组
+ */
+function findIndexByTimestamp(data: KLineData[], targetTs: number): number {
+    let left = 0
+    let right = data.length - 1
+
+    while (left <= right) {
+        const mid = Math.floor((left + right) / 2)
+        const midTs = data[mid]?.timestamp
+        if (midTs === undefined) break
+
+        if (midTs === targetTs) return mid
+        if (midTs < targetTs) {
+            left = mid + 1
+        } else {
+            right = mid - 1
+        }
+    }
+
+    return -1
+}