RCPointer

All Implemented Interfaces:

app.rive.core.RefCounted
```
public final class RCPointer
 implements RefCounted
                    
```
A reference-counted pointer to a native C++ object.
Begins with a reference count of 1 upon creation. Call acquire to increment the reference count, and release to decrement it. When the reference count reaches zero, the onDispose callback is invoked to clean up the native resource.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`public class`	`RCPointer.Companion`

Field Summary

Fields
Modifier and Type	Field	Description
`private final Integer`	`refCount`
`private final Boolean`	`isDisposed`
`private final Long`	`pointer`
`private final String`	`label`

Constructor Summary

Constructors
Constructor	Description
`RCPointer(Long cppPointer, String label, Function1<Long, Unit> onDispose)`

Method Summary

Modifier and Type	Method	Description
`Integer`	`getRefCount()`
`Boolean`	`getIsDisposed()`
`final Long`	`getPointer()`
`final String`	`getLabel()`
`Unit`	`acquire(String source)`	Acquire a reference.
`Unit`	`release(String source, String reason)`	Releases a reference to this pointer.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - RCPointer
```
RCPointer(Long cppPointer, String label, Function1<Long, Unit> onDispose)
```
    Parameters:
    
    cppPointer - The native pointer address.
    
    label - A label for the object pointed to, used for logging purposes, e.g.
    
    onDispose - A callback invoked when the reference count reaches zero to clean up the native resource.
- Method Detail
  - getRefCount
```
 Integer getRefCount()
```
  - getIsDisposed
```
 Boolean getIsDisposed()
```
  - getPointer
```
 final Long getPointer()
```
  - getLabel
```
 final String getLabel()
```
  - acquire
```
 Unit acquire(String source)
```
    Acquire a reference. Must be balanced with a call to release.
    
    Parameters:
    
    source - A string indicating the source of the acquisition, for logging purposes, e.g.
  - release
```
 Unit release(String source, String reason)
```
    Releases a reference to this pointer. When the reference count reaches zero, the onDispose callback is invoked to clean up the native resource.
    
    Parameters:
    
    source - A string indicating the source of the acquisition, for logging purposes, e.g.
    
    reason - An optional string indicating the reason for the release, for logging purposes.