全网首发：JDK绘制文字：三绘制句柄的内容是如何定义的

Posted 2022-03-31 柳鲲鹏

　　绘制句柄的初始化流程已搞清楚：

全网首发：JDK绘制文字：二、绘制句柄的初始化流程_柳鲲鹏的博客-CSDN博客

　　自然的，我们就会问：绘制句柄有什么东西？我们现在就来看看。还是以位图为例。

• ByteBinary1Bit.c

DECLARE_SOLID_DRAWGLYPHLIST(ByteBinary1Bit);

NativePrimitive ByteBinary1BitPrimitives[] = 
    ......
    REGISTER_SOLID_DRAWGLYPHLIST(ByteBinary1Bit),
    REGISTER_SOLID_DRAWGLYPHLISTAA(ByteBinary1Bit),
    REGISTER_XOR_DRAWGLYPHLIST(ByteBinary1Bit),
    ......
;

　　这些都是宏定义。

　　首先要注意，这里是NativePrimitive的数组，也就是有多个NativePrimitive实例。结合前面的分析，我们重点关心的是DRAWGLYPHLIST相关的宏。
　　注意，这些宏不是AnyByteBinary.h中定义的，而是LoopMacros.h定义的。
DEFINE_BYTE_BINARY_SOLID_DRAWGLYPHLIST(ByteBinary1Bit)

• DECLARE_SOLID_DRAWGLYPHLIST(LoopMacros.h)

　　我们先来看看声明的宏。

#define DECLARE_SOLID_DRAWGLYPHLIST(TYPE) \\
    DrawGlyphListFunc      NAME_SOLID_DRAWGLYPHLIST(TYPE)

其中DrawGlyphListFunc（GraphicsPrimitiveMgr.h）的定义是：

typedef void (DrawGlyphListFunc)(SurfaceDataRasInfo *pRasInfo,
                                 ImageRef *glyphs,
                                 jint totalGlyphs,
                                 jint fgpixel, jint fgcolor,
                                 jint cx1, jint cy1,
                                 jint cx2, jint cy2,
                                 struct _NativePrimitive *pPrim,
                                 CompositeInfo *pCompInfo);

NAME_SOLID_DRAWGLYPHLIST的宏定义是： 

#define NAME_SOLID_DRAWGLYPHLIST(TYPE)   TYPE ## DrawGlyphList

综合来看，就是声明了个函数。展开后的结果大体是这样的：

DrawGlyphListFunc ByteBinary1BitDrawGlyphList

这个函数有没有呢？有的，在vis_FuncArray.c这个文件中。

• REGISTER_SOLID_DRAWGLYPHLIST(LoopMacros.h)

#define REGISTER_SOLID_DRAWGLYPHLIST(TYPE) \\
    REGISTER_DRAWGLYPHLIST(AnyColor, SrcNoEa, TYPE, \\
                           NAME_SOLID_DRAWGLYPHLIST(TYPE))

关于NAME_SOLID_DRAWGLYPHLIST我们已经见过，而REGISTER_DRAWGLYPHLIST （GraphicsPrimitiveMgr.h）的宏定义是：

#define REGISTER_DRAWGLYPHLIST(SRC, COMP, DST, FUNC) \\
    REGISTER_PRIMITIVE(DrawGlyphList, SRC, COMP, DST, FUNC)

 REGISTER_PRIMITIVE（GraphicsPrimitiveMgr.h）的宏定义是：

#define REGISTER_PRIMITIVE(TYPE, SRC, COMP, DST, FUNC) \\
     \\
        & PrimitiveTypes.TYPE, \\
        & SurfaceTypes.SRC, \\
        & CompositeTypes.COMP, \\
        & SurfaceTypes.DST, \\
        FUNC, \\
        FUNC, \\
        0,   \\
        0   \\
    

这个宏展开后，数组中有不少字段，最关键的就是其中包含了ByteBinary1BitDrawGlyphList。

到了这里我们就明白了，绘制句柄是包含了同一种的多种处理函数。所以才出现了这样一句调用：pPrim->funcs.drawglyphlist