Function parseCenterOption

src/coord/View.ts:761–796

(
    // `out` is a center in `dataRect` space.
    out: number[],
    viewInner: ViewInner,
    centerOption: RoamOptionMixin['center']
    // @return Whether a valid center is obtained.
)

}

function parseCenterOption(
    // `out` is a center in `dataRect` space.
    out: number[],
    viewInner: ViewInner,
    centerOption: RoamOptionMixin['center']
    // @return Whether a valid center is obtained.
): boolean {
    if (__DEV__) {
        assert(viewCoordSysIsInputReady(viewInner));
    }
    const dataRect = viewInner.dataRect;
    if (!centerOption) {
        return false;
    }
    // #16904 introduced percentage string here, such as '33%'. But it was based on canvas
    // width/height, which is not reasonable - the unit may incorrect, and it is unpredictable if
    // the `ViewInner['dataRect']` is not calculated based on the current canvas rect. Therefore the percentage
    // value is changed to based on `ViewInner['dataRect'].width/height` since v6. Under this definition, users
    // can use '0%' to map the top-left of `ViewInner['dataRect']` to the center of `ViewInner['viewRect']`.
    const lgCt = viewInner.lgCt;
    if (lgCt) {
        vectorSet(
            out,
            parsePercent(centerOption[0], lgCt.w),
            parsePercent(centerOption[1], lgCt.h)
        );
    }
    else if (dataRect) {
        vectorSet(
            out,
            parsePercent(centerOption[0], dataRect.width, dataRect.x),
            parsePercent(centerOption[1], dataRect.height, dataRect.y)
        );
    }
    return true;
}

/**
 * An inverse operation to `parseCenterOption`.