一、读《CoreAPIOverview.pdf》：理解坐标系统
ｃｏｒｅＡＰＩ定义了两个坐标系统：用户空间（ｕｓｅｒｓｐａｃｅ）和设备空间（ｄｅｖｉｃｅｓｐａｃｅ）。此外，有的方法（ｍｅｔｈｏｄｓ）还使用了操作系统平台（ｐｌａｔｆｏｒｍ）自带的坐标系统，即所谓的机器平台空间（ｍａｃｈｉｎｅｐｏｒｔｓｐａｃｅ）。
用户空间：
用户空间描述的坐标用于大多数通过ＰＤ层方法访问的对象，也就是ＰＤＦ文件内部使用的坐标系统，如图1-3所示。和在ＰＤＦ中一样，媒介盒（ｍｅｄｉａｂｏｘ）是整个页面（ｐａｇｅ）大小（例如ＵＳｌｅｔｔｅｒ，或者Ａ４，等等）的矩形。当该页面被裁剪（ｃｒｏｐ）时（例如，选中Ａｃｒｏｂａｔ的Ｄｏｃｕｍｅｎｔ－＞ＣｒｏｐＰａｇｅｓ．．．菜单项），就要用到裁剪盒（ｃｒｏｐｂｏｘ）这种可选的矩形。
用户空间坐标系统的默认原点是页面媒介盒的左下角，ｘ坐标值向右增长，ｙ坐标值向上增长。表示坐标值的单位是固定点数（ｆｉｘｅｄｐｏｉｎｔｎｕｍｂｅｒｓ），矩形的类型是ＡＳＦｉｘｅｄＲｅｃｔ。
设备空间：
设备空间以屏幕像素（ｓｃｒｅｅｎｐｉｘｅｌｓ）为单位描述，如图1-4所示。插件(Plug-ins)在调用AV层的方法时，使用设备空间坐标系统来指定窗口中的某个位置在屏幕上的坐标。
注意：设备空间中的像素一般来说跟点(points)并不等价。一个点大约是1/72英寸。只有当显示设备的解像度(resolution)是72dpi，同时伸缩因子是1.0时，像素和点才大致吻合。
设备空间在Acrobat viewer窗口绘制PDF文件的部分定义了一个方孔(Aperture)。设备空间的原点是屏幕上可见页面的左上角。x坐标值向右增长，y坐标值向下增长。坐标以整数表示，矩形用类型AVRect表示。
注意：可见页面的左上角位置由页面的裁减盒跟媒介盒的交集决定。因此，当页面的裁减盒改变时，设备空间的坐标系统也改变。
用户空间和设备空间之间的转换：
有时插件必须将用户空间转换到设备空间，或者将设备空间转换到用户空间。
例如，假如你的插件要在一个注释(annotation)上面画一个矩形。你可以用PDAnnotGetRect获取注释的边界矩形；这个矩形是用PDF文件的坐标系统，即用户空间，来描述的；不会因为PDF文件视图(view)的变化而变化。你可以用AVPageViewDrawRect方法来画这个举行，但是因为该方法属于AV层，所以需要一个设备空间坐标的矩形。所以你还需要用AVPageViewRectToDevice方法来将矩形的坐标从用户空间转换到设备空间。完整的代码如下：
ASFixedRect userRect;
AVRect deviceRect;
PDAnnotGetRect(anAnnot, &userRect);
AVPageViewRectToDevice(pageView, &userRect,
AVPageViewDrawRect(pageView, &deviceRect);
当有多个页面被同时显示时，比如在Acrobat的不间断(continuous)显示模式中，用户空间的坐标就会发生混乱(ambiguous)。发生问题的原因是用户空间的坐标是相对于页面的，而同时有多个页面要显示，这样AVPageViewRectToDevice方法就不知道该以哪个页面为准。解决办法是事先调用AVPageViewSetPageNum方法来指定页面。完整的代码如下：
ASFixedRect userRect;
AVRect deviceRect;
AVPageViewSetPageNum(pageView, annotPageNum);
PDAnnotGetRect(anAnnot, &userRect);
AVPageViewRectToDevice(pageView, &userRect, &deviceRect);
AVPageViewDrawRect(pageView, &deviceRect);
机器平台空间：
假如你的插件需要使用QuickDraw(Macintoshi平台上)或GDI(Windows平台上)在屏幕上绘图，你就需要使用机器平台空间，如图1-5所示。
如果一个对象的坐标通过用户空间指定，而插件需要在机器平台空间中绘制它，就必须把该坐标通过调用AVPageViewGetPageToDevMatrix方法获取的矩阵(matrix)转换到机器平台空间。
