OLA 文档中心

主题

2026-06-10

解包Y坐标 - UnpackPointY ​

函数简介 ​

从 PackPoint 返回的 int64 中解出 Y 坐标。各语言绑定请调用本组 DLL 接口，保证与插件内部 bit 布局一致。

接口名称 ​

UnpackPointY

DLL调用 ​

cpp
int32_t UnpackPointY(int64_t packed);

打包格式 ​

位布局与 PackPoint 一致：高 32 位为 y；packed == -1 时返回值仍按位域解析，有效性请配合 UnpackPoint 判断。

参数说明 ​

参数名类型说明
packed长整数型PackPoint 的返回值或回调返回值

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int ret = ola.UnpackPointY(0);
csharp
using OLAPlug;

var ola = new OLAPlugServer();
int ret = ola.UnpackPointY(0);
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
ret = ola.UnpackPointY(0)
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
int ret = ola.UnpackPointY(0);
cpp
var ola = com("OlaPlug.OlaSoft")
var ret = ola.UnpackPointY(0)
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ret = ola.UnpackPointY(0)
text
.局部变量 ola, OLAPlug
ola.创建 ()
ret ＝ ola.UnpackPointY(0)
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var ret = ola.UnpackPointY(0);
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
整数 ret = ola.UnpackPointY(0)
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int32_t ret = ola.UnpackPointY(0);

原生 DLL 调用 ​

cpp
int64_t packed = PackPoint(100, 200);
int32_t v = UnpackPointY(packed);
csharp
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long PackPoint(int x, int y);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int UnpackPointY(long packed);

long packed = PackPoint(100, 200);
int v = UnpackPointY(packed);
python
from ctypes import CDLL, c_int32, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.PackPoint.argtypes = [c_int32, c_int32]
ola.PackPoint.restype = c_int64
ola.UnpackPointY.argtypes = [c_int64]
ola.UnpackPointY.restype = c_int32

packed = ola.PackPoint(100, 200)
v = ola.UnpackPointY(packed)

返回值 ​

解包后的 Y 坐标（有符号 int32）。

注意事项 ​

  • 禁止使用 Windows LOWORD / HIWORD / MAKELPARAM 解包，负坐标会错误。
  • 本组接口 无 instance 参数，本地直接调用即可。