# Fontconfig_actor

A [Syndicate actor](https://syndicate-lang.org) for querying [Fontconfig](https://www.freedesktop.org/software/fontconfig/).

The actor responds to observations of font properties by asserting what it determines to be the most appropriate font.

The assertion format is `<fontconfig {pattern…} {attributes…}>` (see [protocol.prs](./protocol.prs)). The `pattern` field is a dictionary of properties to match fonts against and the `attributes` field is a dictionary of the properties of a font selected by Fontconfig. An application observes a `pattern` and takes the `file` and `index` fields of a corresponding assertion and reads font data from the file-system. In the case that `pattern` does not match any fonts an assertion will still be made, so it is possible that all of the properties in `pattern` will be contradicted in `attributes`.

For a list of possibly supported properties see the [Fontconfig documentation](https://www.freedesktop.org/software/fontconfig/fontconfig-devel/x19.html). When the value of a property is a Preserves symbol (rather than a string in double-quotes) it will be resolved to a Fontconfig constant if possible. Constants are not resolved from integers to symbols in the `attributes` field. For example, `{slant: oblique}` is transformed to `{slant: 110}` from `pattern` to `attributes`.

Example [Syndicate server](https://git.syndicate-lang.org/syndicate-lang/syndicate-rs) configuration:
```
<require-service <daemon fontconfig_actor>>
<daemon fontconfig_actor {
  argv: [ "/usr/local/bin/fontconfig_actor" ]
  protocol: application/syndicate
}>

let ?fontspace = dataspace
<fontspace $fontspace>

? <service-object <daemon fontconfig_actor> ?cap> [
  $cap <serve $fontspace>
]

$fontspace [
  ? <fontconfig {size: 8.0, spacing: proportional} ?properties> [
    $log ! <log "-" { line: <fontconfig $properties> }>
  ]
]
```