Glyphs

Instance Method

layerGroupsInstances(_:masters:ignoreEmptyLayers:error:)layerGroupsInstances:masters:ignoreEmptyLayers:error:layerGroupsInstances_masters_ignoreEmptyLayers_error_

The layer identifier groups required by a set of instances.

func layerGroupsInstances(
    _ instances: [GSInstance]?,
    masters: [GSFontMaster]?,
    ignoreEmptyLayers: Bool,
    error: NSErrorPointer
) -> [NSMutableOrderedSet]
- (NSArray<NSMutableOrderedSet<NSString *> *> *) layerGroupsInstances:(NSArray<GSInstance *> *) instances
                                                              masters:(NSArray<GSFontMaster *> *) masters
                                                    ignoreEmptyLayers:(BOOL) ignoreEmptyLayers
                                                                error:(NSError **) error;
layerGroupsInstances_masters_ignoreEmptyLayers_error_(
    instances: list[GSInstance],
    masters: list[GSFontMaster],
    ignoreEmptyLayers: bool
) -> tuple[list[NSMutableOrderedSet<NSString *>], NSError]

Parameters

instances

The instances that determine which layers participate, or nil for forced grouping.

masters

The font masters to consider and include when necessary.

ignoreEmptyLayers

Whether to omit layers without content.

error

On return, an error encountered while resolving the masters of a variable instance.

Discussion

Passing nil for instances groups all active master, Intermediate, Alternative, and color layers independently of the font’s instances. Groups that share a layer identifier are combined.

See Also

Layer Groups