Class: Toybox.Graphics.ResourceReference

Inherits:

Toybox.Lang.Object

• Toybox.Lang.Object
• Toybox.Graphics.ResourceReference

Overview

Object represents a reference for the resource allocated from the graphics memory pool rather than from the app's local memory. The underlying resource object could be temporarily purged from the system memory pool when all strong references are destroyed. The memory allocation is performed only when ResourceReference::get() method is invoked.

Since:

API Level 4.0.0

Direct Known Subclasses

Graphics.BitmapReference, Graphics.BufferedBitmapReference, Graphics.FontReference

Typedef Summary

• Options as { :resource as WatchUi.FontResource or WatchUi.BitmapResource or Graphics.BufferedBitmap, :rezId as Lang.ResourceId, :bufferedBitmap as { :bitmapResource as Lang.ResourceId, :width as Lang.Number, :height as Lang.Number, :palette as Lang.Array<Graphics.ColorType>, :colorDepth as Lang.Number } }

Instance Method Summary

• get() as WatchUi.BitmapResource or Graphics.BufferedBitmap or WatchUi.FontResource or Null

  Get the underlying resource object referenced by the ResourceReference, this trigger either the allocate from the system memory pool or return the existing resource in the pool.

Instance Method Details

get() as WatchUi.BitmapResource or Graphics.BufferedBitmap or WatchUi.FontResource or Null

Get the underlying resource object referenced by the ResourceReference, this trigger either the allocate from the system memory pool or return the existing resource in the pool.

Returns:

• Lang.Object —

  The resource object referenced, or null if failed.

Since:

API Level 4.0.0

Throws:

• (Graphics.OutOfGraphicsMemoryException) —

  Thrown if resource cannot be loaded or restored because there isn't enough free pool to load the resource