-
- All Implemented Interfaces:
-
app.rive.AssetOps
public class FontAsset.Companion implements AssetOps<FontHandle, FontAsset>
-
-
Method Summary
Modifier and Type Method Description final FontAssetcreate(CommandQueue riveWorker, ByteArray bytes)Creates and decodes a font asset from the given byte array on the provided Rive worker. final Result<FontAsset>fromBytes(CommandQueue riveWorker, ByteArray bytes)Decodes a font asset from bytes. FontHandledecode(CommandQueue worker, ByteArray bytes)Decode the asset from the given byte array on the provided Rive worker. Unitdelete(CommandQueue worker, FontHandle handle)Delete the asset from the provided Rive worker. Unitregister(CommandQueue worker, String key, FontHandle handle)Register the asset with the provided Rive worker under the given key. Unitunregister(CommandQueue worker, String key)Unregister the asset from the provided Rive worker for the given key. FontAssetconstruct(FontHandle handle, CommandQueue worker)Construct the asset by taking ownership of the worker reference acquired by the factory. StringgetTag()The tag used for logging purposes. StringgetLabel()A label for the asset type, used in logging. -
-
Method Detail
-
create
final FontAsset create(CommandQueue riveWorker, ByteArray bytes)
Creates and decodes a font asset from the given byte array on the provided Rive worker.
The font can only be used on the same RiveWorker it was created on.
Must be registered with FontAsset.register to be used for referenced fonts. Remove every registration with FontAsset.unregister, preferably before closing the font.
⚠️ The lifetime of the returned font is managed by the caller. Make sure to call close when you are done with it to release its resources. The returned font holds a reference to riveWorker, so closing it is required before the worker can fully release memory associated with this font.
This is the replacement for fromBytes. Its temporary name avoids a source-incompatible overload; it will be renamed to
fromBytesin 12.0 when the result-returning API is removed.- Parameters:
riveWorker- The Rive worker that owns the font.bytes- The byte array containing the font data to decode.
-
fromBytes
@Deprecated(message = Use create. This result-returning implementation will be removed in 12.0, when create will be renamed to fromBytes and return the font directly.) final Result<FontAsset> fromBytes(CommandQueue riveWorker, ByteArray bytes)
Decodes a font asset from bytes.
- Parameters:
riveWorker- The Rive worker that owns the font.bytes- The encoded font bytes.
-
decode
FontHandle decode(CommandQueue worker, ByteArray bytes)
Decode the asset from the given byte array on the provided Rive worker.
-
delete
Unit delete(CommandQueue worker, FontHandle handle)
Delete the asset from the provided Rive worker.
-
register
Unit register(CommandQueue worker, String key, FontHandle handle)
Register the asset with the provided Rive worker under the given key.
-
unregister
Unit unregister(CommandQueue worker, String key)
Unregister the asset from the provided Rive worker for the given key.
-
construct
FontAsset construct(FontHandle handle, CommandQueue worker)
Construct the asset by taking ownership of the worker reference acquired by the factory.
-
-
-
-