Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/vtfontcvt/vtfontcvt.8
| Show All 18 Lines | |||||
| .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
| .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
| .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
| .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
| .\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
| .\" | .\" | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd June 9, 2014 | .Dd Mar 10, 2020 | ||||
| .Dt VTFONTCVT 8 | .Dt VTFONTCVT 8 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| .Nm vtfontcvt | .Nm vtfontcvt | ||||
| .Nd "convert font files for use by the video console" | .Nd "convert font files for use by the video console" | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .Nm | .Nm | ||||
| .Op Fl n | |||||
| .Op Fl f Ar font Ns | Ns Ar source Ns | Ns Ar compressed-source | |||||
| .Op Fl h Ar height | .Op Fl h Ar height | ||||
| .Fl o Ar output_file | |||||
| .Op Fl v | .Op Fl v | ||||
| .Op Fl w Ar width | .Op Fl w Ar width | ||||
| .Ar normal_font | .Ar normal_font | ||||
| .Op Ar bold_font | .Op Ar bold_font | ||||
| .Ar output_file | |||||
| .Sh DESCRIPTION | .Sh DESCRIPTION | ||||
| The | The | ||||
| .Nm | .Nm | ||||
| utility reads source font files in either BDF or Unifont HEX format and | utility reads source font files in either BDF or Unifont HEX format and | ||||
| outputs a binary font file for use by | outputs a binary font file, C source, or C source with font data compressed | ||||
| by using LZ4 compression method. | |||||
| The output in C source is intended to be used to embed the font into program | |||||
| binary. | |||||
| The binary font file is for use by | |||||
| .Xr vt 4 . | .Xr vt 4 . | ||||
| HEX format files must have the file extension | HEX format files must have the file extension | ||||
| .Pa .hex . | .Pa .hex . | ||||
| .Pp | .Pp | ||||
| The following options are available: | The following options are available: | ||||
| .Bl -tag -width "12345678" | .Bl -tag -width "12345678" | ||||
| .It Fl f Ar font Ns | Ns Ar source Ns | Ns Ar compressed-source | |||||
| Specify the output format. | |||||
| The default is binary | |||||
| .Ar font | |||||
| file. | |||||
| .It Fl h Ar height | .It Fl h Ar height | ||||
| Set font height. | Set font height. | ||||
| The default is 16. | The default is 16. | ||||
| Font height is set automatically for HEX files that have a | Font height is set automatically for HEX files that have a | ||||
| .Ql # Height: Ar height | .Ql # Height: Ar height | ||||
| comment before any font data. | comment before any font data. | ||||
| .It Fl n | |||||
| Do not apply output filtering with C source output. | |||||
| .It Fl o Ar output_file | |||||
| Specify the name for the output file. | |||||
| .It Fl v | .It Fl v | ||||
| Display verbose statistics about the converted font. | Display verbose statistics about the converted font. | ||||
| .It Fl w Ar width | .It Fl w Ar width | ||||
| Set font width. | Set font width. | ||||
| The default is 8. | The default is 8. | ||||
| Font width is set automatically for HEX files that have a | Font width is set automatically for HEX files that have a | ||||
| .Ql # Width: Ar width | .Ql # Width: Ar width | ||||
| comment before any font data. | comment before any font data. | ||||
| Show All 9 Lines | |||||