# CreateMetaFont

int CreateMetaFont (char newMetaFontName[], char existingFontName[], int pointSize, int bold, int italics, int underlined, int strikeout);

## Purpose

Creates a new metafont based on a predefined National Instruments font, an existing metafont, or a font supplied by the operating system.

Metafonts contain typeface information, point size, and text style.

## Parameters

Input
Name | Type | Description
newMetaFontName | string | Name to associate with the new metafont.
existingFontName | string | Name of the existing font on which to base the new metafont. The font can be a predefined font, one of the NI fonts, a user-defined font saved by a previous CreateMetaFont function call, or a font, such as Courier, supplied by the operating system. Predefined fonts—Contain typeface information only and use typefaces native to the operating system. Examples of predefined fonts include VAL_MENU_FONT, VAL_DIALOG_FONT, VAL_EDITOR_FONT, and VAL_APP_FONT. Predefined metafonts—Contain typeface information, point size, and text styles such as bold, underline, italic, and strikeout. These metafonts are used in the LabWindows/CVI environment. Examples of predefined metafonts include VAL_MENU_META_FONT, VAL_DIALOG_META_FONT, VAL_EDITOR_META_FONT, and VAL_APP_META_FONT. LabWindows/CVI-supplied metafonts—Supplied with LabWindows/CVI and installed while LabWindows/CVI is running. These metafonts use typefaces that are not native to the operating systems. Examples of LabWindows/CVI-supplied metafonts are VAL_7SEG_META_FONT and VAL_SYSTEM_META_FONT.
pointSize | integer | Point size of the new metafont. Any positive integer value is valid.
bold | integer | Indicates whether the newly created metafont has bold text. 0 = not bold 1 = bold
italics | integer | Indicates whether the newly created metafont has italicized text. 0 = not italic 1 = italic
underlined | integer | Indicates whether the newly created metafont has underlined text. 0 = not underlined 1 = underlined
strikeout | integer | Indicates whether the newly created metafont has strikeout text. 0 = not strikeout 1 = strikeout

## Return Value

Name | Type | Description
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
Code | Error Message String
xx | Success