Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Add font.superfamily support with genre-aware resolution #30155

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
socram-somel wants to merge 1 commit into matplotlib:main
base: main
Choose a base branch
Loading
from bruswaine:feature_29866

Conversation

Copy link

@socram-somel socram-somel commented Jun 9, 2025

Closes #29866

Adds support for rcParam 'font.superfamily', allowing users to define logical font groups (superfamilies) that span multiple genres like 'serif', 'sans', and 'mono'.

Each superfamily maps genre + weight + style to real font names using keys like 'bold-italic' or 'normal-normal'.

Font resolution uses genre from font.family and matches against the selected superfamily, trying exact and fallback variants in order of specificity to generality.

Superfamilies can be defined by name (preloaded registry) or passed as inline dicts in rcParams['font.superfamily'].

Legacy behavior is preserved unless superfamily is set. If set, genre-aware matching replaces generic family name.

Includes defaults for DejaVu, Noto, Liberation, and more.

PR summary

PR checklist

Closes matplotlib#29866
This commit adds support for rcParam 'font.superfamily',
allowing users to define logical font groups (superfamilies)
that span multiple genres like 'serif', 'sans', and 'mono'.
Each superfamily maps genre + weight + style to real font
names using keys like 'bold-italic' or 'normal-normal'.
Font resolution uses genre from font.family and matches
against the selected superfamily, trying exact and fallback
variants in order of specificity to generality.
Superfamilies can be defined by name (preloaded registry)
or passed as inline dicts in rcParams['font.superfamily'].
Legacy behavior is preserved unless superfamily is set.
If set, genre-aware matching replaces generic family name.
Includes defaults for DejaVu, Noto, Liberation, and more.
Co-authored-by: Tiago Marques <tiago.l.marques@tecnico.ulisboa.pt>
Copy link
Contributor

@anntzer anntzer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I still don't know if we really want that feature, but if we do, it would definitely not by using a hard-coded table, but more likely by extracting the relevant metadata from the font files.

tacaswell reacted with thumbs up emoji
Copy link
Author

I still don't know if we really want that feature, but if we do, it would definitely not by using a hard-coded table, but more likely by extracting the relevant metadata from the font files.

Ok, I'll look into that. About the part of extracting metadata, is it worth to add more dependencies to mpl ?

Copy link
Contributor

anntzer commented Jun 23, 2025

Hopefully it can be done without additional dependencies.

Copy link
Member

We already have fonttools as a dependency. I would be surprised if there was metadata available to us in fonts that we could not get out with the dependencies we already have.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@anntzer anntzer anntzer requested changes

Requested changes must be addressed to merge this pull request.

Assignees
No one assigned
Projects
Status: Needs decision
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

[ENH]: Allow specifying a typeface instead of a font

AltStyle によって変換されたページ (->オリジナル) /