Plugins that have the capability flag HWPLUG_CAPS_VECTOR set can provide support for
drawing vector-based paths with Hollywood. Hollywood comes with a vectorgraphics library
which can use an internal vectorgraphics backend or an external one provided by a plugin.
The inbuilt vectorgraphics backend is platform-independent but has some restrictions
when it comes to filling complex shapes. That's why it might be better to write a vectorgraphics
plugin for certain advanced tasks. Vectorgraphics plugins might want to use the vector-based
drawing functionality offered by the host operating systems, e.g. Quartz on macOS
or GDI+ on Windows, or they could use platform-independent vector drawing backends like
Cairo.
Starting with Hollywood 6.0 vectorgraphics plugins support the HWEXT_VECTOR_EXACTFIT
extension. If this extension is set, GetPathExtents() must
take the transformation matrix it is passed into account when computing the path's
extents. If HWEXT_VECTOR_EXACTFIT is not set, Hollywood will compute the extents
of the transformed path but this is not recommended since it is your plugin that knows
best about the real extents. See Extension plugins to learn how to use plugin extension bits.
Starting with Hollywood 10.0 vectorgraphics plugins support the HWEXT_VECTOR_CUSTOMFT2
extension bit to tell Hollywood that they're using a custom FreeType2 implementation
that is not compatible with the one that is built into Hollywood. If this extension bit
is set, Hollywood will call your plugin whenever it needs to turn a font into an FT_Face.
Consequently, plugins which set HWEXT_VECTOR_CUSTOMFT2 must implement the OpenFont()
and CloseFont() vectors. Note that on WarpOS Hollywood will activate HWEXT_VECTOR_CUSTOMFT2
automatically for WarpOS plugins because those can only access a PPC build of
FreeType2 whose FT_Face handles are not compatible with the 68k ones expected by
Hollywood.