FontManager.ImageWithSystemSymbolName
-------------------------------------

Queries SF Symbol font for characters and returns them as image.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Font](component_Font.md) | [10.5](newinversion105.md) | ✅ Yes | ❌ No | ❌ No | ✅ Yes, on macOS | ✅ Yes |

MBS( "FontManager.ImageWithSystemSymbolName"; Name { ; Width; Height; ImageType; FileName } ) 

**MBS**( **"FontManager.ImageWithSystemSymbolName";** /\* Queries SF Symbol font for characters and returns them as image. \*/  
**$Name**; /\* The name of the symbole.g. "icloud" \*/   
**$Width**; /\* Optional; The width to use.e.g. 200 \*/   
**$Height**; /\* Optional; The image height to use.e.g. 200 \*/   
**$ImageType**; /\* Optional; The type of image to return.   
Either JPEG, PNG, GIF or BMP. Default is JPEG.e.g. "JPEG" \*/   
**$FileName**) /\* Optional; The filename to use for the picture.   
Default is "image" with the extension matching the image type.e.g. "test.jpg" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| Name | The name of the symbol | "icloud" |  |
| Width | The width to use. | 200 | Optional |
| Height | The image height to use. | 200 | Optional |
| ImageType | The type of image to return.    Either JPEG, PNG, GIF or BMP. Default is JPEG. | "JPEG" | Optional |
| FileName | The filename to use for the picture.    Default is "image" with the extension matching the image type. | "test.jpg" | Optional |

### Result

Returns container or error.

### Description

Queries SF Symbol font for characters and returns them as image.  
This function needs macOS 11.0 or iOS 14.  
On iOS ignores size and returns font with native size.  
On macOS if either height or width is empty/zero, we calculate the other value with proportional scaling.  
  
See website for list of symbols:  
<https://developer.apple.com/design/human-interface-guidelines/sf-symbols/overview/>  
### Examples

Query picture with 512 pixel width:

 Set Field \[ Test::Image ; MBS ("FontManager.ImageWithSystemSymbolName"; "icloud"; 512; ""; "png"; "test.png") \]  
### Release notes

- **Version 10.5**
    - Added [FontManager.ImageWithSystemSymbolName](https://www.mbsplugins.eu/FontManagerImageWithSystemSymbolName.shtml) function to query images for symbol names.

### Blog Entries

- [New in MBS FileMaker Plugin 10.5](https://www.mbsplugins.de/archive/2020-11-23/New_in_MBS_FileMaker_Plugin_10/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.5pr1](https://www.mbsplugins.de/archive/2020-10-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 6/2020, Seite 27](https://filemaker-magazin.de/neuigkeit/4118-Appetithappen-FMM_202006)

This function checks for a license.

Created 29th September 2020 , last changed 1st October 2020

  
[FontManager.FontFile](FontManagerFontFile.md) - [FontManager.ListFontFamilies](FontManagerListFontFamilies.md)

[HTML Version](FontManagerImageWithSystemSymbolName.shtml)