{"id":15675339,"url":"https://github.com/adjivas/image3font","last_synced_at":"2025-03-30T06:14:59.257Z","repository":{"id":62570476,"uuid":"117190956","full_name":"adjivas/Image3font","owner":"adjivas","description":"A image's converter to multi-colours font written in FontForge/FontTools's HyLang.","archived":false,"fork":false,"pushed_at":"2018-01-17T13:13:23.000Z","size":1602,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-07T22:17:49.804Z","etag":null,"topics":["color-font","fontforge","fonttools","glyph","imagemagick","opentype","svg"],"latest_commit_sha":null,"homepage":"https://adjivas.github.io/Image3font/","language":"Hy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adjivas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-01-12T04:09:03.000Z","updated_at":"2023-08-03T15:36:49.000Z","dependencies_parsed_at":"2022-11-03T17:01:07.073Z","dependency_job_id":null,"html_url":"https://github.com/adjivas/Image3font","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adjivas%2FImage3font","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adjivas%2FImage3font/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adjivas%2FImage3font/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adjivas%2FImage3font/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adjivas","download_url":"https://codeload.github.com/adjivas/Image3font/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246281312,"owners_count":20752213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["color-font","fontforge","fonttools","glyph","imagemagick","opentype","svg"],"created_at":"2024-10-03T15:58:42.467Z","updated_at":"2025-03-30T06:14:59.234Z","avatar_url":"https://github.com/adjivas.png","language":"Hy","readme":"# Image3font\n\n[![travis-badge](https://travis-ci.org/adjivas/Image3font.svg?branch=master\u0026style=flat)](https://travis-ci.org/adjivas/Image3font)\n[![project-badge](https://img.shields.io/pypi/v/image3font.svg)](https://pypi.org/project/image3font)\n[![license-badge](http://img.shields.io/badge/license-GPLv3-blue.svg?style=flat-square)](https://github.com/adjivas/Image3font/blob/master/LICENSE)\n\nA image's converter to font written in\n[FontForge](https://github.com/fontforge/fontforge)/[FontTools](https://github.com/fonttools/fonttools)'\n[Hy](https://github.com/hylang/hy) language and the futur of\n[image2font](https://github.com/limaconoob/Image2font/)'s repository.\n\n### Installation\n\nThe [image3font](https://pypi.org/project/image3font) package is listed\nin the Python Package Index (PyPI), so you can install it with pip:\n\n    pip install image3font\n\n### Usage\n\nSee command help:\n* **-h, --help** - show this help message and exit.\n* **-v, --version** - show the version and exit.\n* **-m MANIFEST, --manifest MANIFEST** - specify the manifest.\n\n#### Layout\n\n*Image3font* uses conventions for file placement:\n```\nimage3font.toml\nsrc/\nsrc/{:hex}.{svg,jpeg,...}\nsrc/{:hex}-{:y}-{:x}.svg (need the wand dependency)\n```\n\n-   **image3font.toml** stores in the root of your project.\n-   **image** goes in the **src** directory.\n\n### Dependency\n\n-   [fontforge](https://github.com/fontforge/fontforge) must be\n    installed.\n\n#### Requirement\n\nThe [requirements.txt](requirements.txt) describes the image3font's dependencies:\n\n-   [hy](https://github.com/hylang/hy) - A dialect of Lisp that's\n    embedded in Python.\n-   [fonttools](https://github.com/fonttools/fonttools) - A library to\n    manipulate font files from Python.\n-   [docopt](https://github.com/docopt/docopt) - Pythonic command line\n    arguments parser.\n-   [toml](https://github.com/uiri/toml) - Python lib for TOML.\n-   [wand](https://github.com/dahlia/wand) - The ctypes-based simple [ImageMagick](https://github.com/ImageMagick/ImageMagick) binding for Python (tested on imagemagick6 6.9.9.33-1).\n\n\n### Manifest\n\nThe *image3font.toml* file for each font is called its manifest. Every\nmanifest file consists of two fields and two sections:\n\n- **path** (optional)\nFontpath of input font. If not specified this\nwill be infered from a empty font.\n\n- **source** (default = \"src\") \nCan be used to configure the SVG's\ndirectory.\n\n#### \\[fontforge\\]'s section\n\nList of fields according to\n[FontForge](https://fontforge.github.io/en-US/documentation/scripting/native)/Script's\nspecification.\n\n- **path**\n\nPath where save the compiled font.\n\n- **fontname**\n\nName contained in the postscript FontName field.\n\n- **familyname** (default = \"fontname\")\n\nName contained in the\npostscript FamilyName field. If not specified this will be inferred as\nfontname.\n\n- **fullname** (default = \"fontname\")\n\nName contained in the postscript\nFullName field. If not specified this will be inferred as fontname.\n\n- **weight** (optional)\n\nName contained in the postscript Weight field.\n\n- **copyright** (optional)\n\nName contained in the postscript Notice\nfield.\n\n-   **version** (optional)\n-   **encoding** (default = \"UnicodeFull\")\n-   **em** (default = 2028)\n\n#### \\[fonttools\\]'s section\n\nList of fields according to\n[FontTools/Name-IDs](https://www.microsoft.com/typography/otspec/name.htm#nameIDs)'s\nspecification.\n\n- **copyright**\n\nCopyright string from the font vendor. © Copyright the\nMonotype Corporation plc, 1990.\n\n- **familyname**\n\nName the user sees. Times New Roman\n\n- **subfamilyname**\n\nName of the style. Bold\n\n- **unique\\_id**\n\nA unique identifier that applications can store to\nidentify the font being used. Monotype: Times New Roman Bold:1990\n\n- **full\\_name**\n\nComplete, unique, human readable name of the font.\nThis name is used by Windows. Times New Roman Bold\n\n- **version**\n\nRelease and version information from the font vendor.\nVersion 1.00 June 1, 1990, initial release.\n\n- **postscript\\_name**\n\nName the font will be known by on a PostScript\nprinter. TimesNewRoman-Bold\n\n- **trademark**\n\nTrademark string. Times New Roman is a registered\ntrademark of the Monotype Corporation.\n\n- **manufacturer**\n\nManufacturer. Monotype Corporation. plc\n\n- **designer**\n\nDesigner. Stanley Morison\n\n- **description**\n\nDescription. Designed in 1932 for the Times of London\nnewspaper. Excellent readability and a narrow overall width, allowing\nmore words per line than most fonts.\n\n- **url\\_vendor**\n\nURL of Vendor. \u003chttp://www.monotype.com\u003e\n\n- **url\\_designer** \n\nURL of Designer. \u003chttp://www.monotype.com\u003e\n\n- **license**\n\nLicense Description. This font may be installed on all of\nyour machines and printers, but you may not sell or give these fonts to\nanyone else.\n\n- **url\\_license**\nLicense Info URL. \u003chttp://www.monotype.com/license\u003e\n\n- **reserved**\nReserved.\n\n- **preferred\\_familyname**\n\nPreferred Family. No name string present,\nsince it is the same as name ID 1 (Font Family name).\n\n- **preferred\\_subfamilyname**\n\nPreferred Subfamily. No name string\npresent, since it is the same as name ID 2 (Font Subfamily name).\n\n- **compatible\\_full**\n\nCompatible Full (Macintosh only). No name string\npresent, since it is the same as name ID 4 (Full name).\n\n- **sample\\_text**\n\nSample text. quick brown fox jumps over the lazy\ndog.\n\n- **postscript\\_cid**\n\nPostScript CID findfont name. No name string\npresent. Thus, the PostScript Name defined by name ID 6 should be used\nwith the \"findfont\" invocation for locating the font in the context of a\nPostScript interpreter.\n\n- **wws\\_familyname**\n\nWWS family name: Since Times New Roman is a WWS\nfont, this field does not need to be specified. If the font contained\nstyles such as \"caption\", \"display\", \"handwriting\", etc, that would be\nnoted here.\n\n- **wws\\_subfamilyname**\n\nWWS subfamily name: Since Times New Roman is a\nWWS font, this field does not need to be specified.\n\n- **light\\_background**\n\nLight background palette name. No name string\npresent, since this is not a color font.\n\n- **dark\\_background**\n\nDark background palette name. No name string\npresent, since this is not a color font.\n\n- **variations\\_postscript**\n\nVariations PostScript name prefix. No name\nstring present, since this is not a variable font.\n\n### Knowledge\n\nThis is a reading list of material relevant to *Image3Font*. It includes\nprior research that has - at one time or another - influenced the design\nof *image3font*, as well as publications about *imag3font*.\n\n-   [SVG in OpenType](https://www.w3.org/2013/10/SVG_in_OpenType) - SVG\n    Glyphs in OpenType Specification.\n-   [Otspec](https://www.microsoft.com/typography/otspec) - OpenType\n    specification.\n\n- [FontForge\nscripting](https://fontforge.github.io/en-US/documentation/scripting/native)\nWriting scripts to change fonts in FontForge.\n\n-   [Adobe\n    Opentype](http://www.adobe.com/devnet/opentype/afdko/topic_feature_file_syntax.html)\n    Adobe OpenType feature.\n\n### License\n\n*Image3font*'s code in this repo uses the [GNU GPL\nv3](http://www.gnu.org/licenses/gpl-3.0.html)\n[license](https://raw.githubusercontent.com/adjivas/Image3font/master/LICENSE).\n\n#### Dependencies\n\nMany thanks goes to *command/etc*'s project:\n\n-   [FontForge](https://github.com/fontforge/fontforge) - [GNU GPL v3\n    license](https://github.com/fontforge/fontforge/blob/master/LICENSE).\n-   [FontTools](https://github.com/fonttools/fonttools) - [MIT Open\n    Source\n    license](https://github.com/fonttools/fonttools/blob/master/LICENSE).\n-   [HyLang](https://github.com/hylang/hy) - [MIT Open Source\n    license](https://github.com/hylang/hy/blob/master/LICENSE).\n-   [docopt](https://github.com/docopt/docopt) - [MIT Open Source\n    license](https://github.com/docopt/docopt/blob/master/LICENSE-MIT).\n-   [Toml](https://github.com/uiri/toml) - [MIT Open Source\n    license](https://github.com/uiri/toml/blob/master/LICENSE).\n-   [Wand](https://github.com/dahlia/wand) - [MIT Open Source\n    license](https://github.com/dahlia/wand/blob/master/LICENSE).\n-   [Wikipedia (for the picture\n    neko!)](https://en.wikipedia.org/wiki/Catgirl).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadjivas%2Fimage3font","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadjivas%2Fimage3font","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadjivas%2Fimage3font/lists"}