Table of Contents

Class Buffer

Namespace
easyar

Buffer stores the original byte array, which can be used to access image data. In the Java API, you can get the buffer from Image and then copy data to a Java byte array. In all versions of EasyAR Sense, you can access image data. Reference Image.

Buffer

Methods

wrap

Wrap a raw memory block of a specified length. When the Buffer is completely released, the deleter callback will be called to perform user-defined memory cleanup behavior. The deleter must be thread-safe.

void easyar_Buffer_wrap(void * ptr, int size, easyar_FunctorOfVoid deleter, easyar_Buffer * * Return)
static std::shared_ptr<Buffer> wrap(void * ptr, int size, std::function<void()> deleter)
public static @Nonnull Buffer wrap(long ptr, int size, @Nonnull FunctorOfVoid deleter)
companion object fun wrap(ptr: Long, size: Int, deleter: FunctorOfVoid): Buffer
+ (easyar_Buffer *)wrap:(void *)ptr size:(int)size deleter:(void (^)())deleter
public static func wrap(_ ptr: OpaquePointer?, _ size: Int32, _ deleter: @escaping () -> Void) -> Buffer
public static Buffer wrap(IntPtr ptr, int size, Action deleter)

Parameters

ptr IntPtr
size Int32
deleter Action

Returns

Buffer

create

Create a Buffer of a specified byte length.

void easyar_Buffer_create(int size, easyar_Buffer * * Return)
static std::shared_ptr<Buffer> create(int size)
public static @Nonnull Buffer create(int size)
companion object fun create(size: Int): Buffer
+ (easyar_Buffer *)create:(int)size
public static func create(_ size: Int32) -> Buffer
public static Buffer create(int size)

Parameters

size Int32

Returns

Buffer

data

Return the raw memory address.

void * easyar_Buffer_data(const easyar_Buffer * This)
void * data()
public long data()
fun data(): Long
- (void *)data
public func data() -> OpaquePointer?
public virtual IntPtr data()

Returns

IntPtr

size

The byte length of the Buffer.

int easyar_Buffer_size(const easyar_Buffer * This)
int size()
public int size()
fun size(): Int
- (int)size
public func size() -> Int32
public virtual int size()

Returns

Int32

memoryCopy

Copy the raw memory. Mainly used for languages or environments with imperfect memory operations.

void easyar_Buffer_memoryCopy(void * src, void * dest, int length)
static void memoryCopy(void * src, void * dest, int length)
public static void memoryCopy(long src, long dest, int length)
companion object fun memoryCopy(src: Long, dest: Long, length: Int): Unit
+ (void)memoryCopy:(void *)src dest:(void *)dest length:(int)length
public static func memoryCopy(_ src: OpaquePointer?, _ dest: OpaquePointer?, _ length: Int32) -> Void
public static void memoryCopy(IntPtr src, IntPtr dest, int length)

Parameters

src IntPtr
dest IntPtr
length Int32

Returns

Void

tryCopyFrom

Try to copy data from the raw memory address to the Buffer. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

bool easyar_Buffer_tryCopyFrom(easyar_Buffer * This, void * src, int srcIndex, int index, int length)
bool tryCopyFrom(void * src, int srcIndex, int index, int length)
public boolean tryCopyFrom(long src, int srcIndex, int index, int length)
fun tryCopyFrom(src: Long, srcIndex: Int, index: Int, length: Int): Boolean
- (bool)tryCopyFrom:(void *)src srcIndex:(int)srcIndex index:(int)index length:(int)length
public func tryCopyFrom(_ src: OpaquePointer?, _ srcIndex: Int32, _ index: Int32, _ length: Int32) -> Bool
public virtual bool tryCopyFrom(IntPtr src, int srcIndex, int index, int length)

Parameters

src IntPtr
srcIndex Int32
index Int32
length Int32

Returns

Boolean

tryCopyTo

Try to copy data from the Buffer to the raw memory address. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

bool easyar_Buffer_tryCopyTo(easyar_Buffer * This, int index, void * dest, int destIndex, int length)
bool tryCopyTo(int index, void * dest, int destIndex, int length)
public boolean tryCopyTo(int index, long dest, int destIndex, int length)
fun tryCopyTo(index: Int, dest: Long, destIndex: Int, length: Int): Boolean
- (bool)tryCopyTo:(int)index dest:(void *)dest destIndex:(int)destIndex length:(int)length
public func tryCopyTo(_ index: Int32, _ dest: OpaquePointer?, _ destIndex: Int32, _ length: Int32) -> Bool
public virtual bool tryCopyTo(int index, IntPtr dest, int destIndex, int length)

Parameters

index Int32
dest IntPtr
destIndex Int32
length Int32

Returns

Boolean

partition

Create a sub-Buffer and reference the original Buffer. A Buffer will not be released until all sub-Buffers are released.

void easyar_Buffer_partition(easyar_Buffer * This, int index, int length, easyar_Buffer * * Return)
std::shared_ptr<Buffer> partition(int index, int length)
public @Nonnull Buffer partition(int index, int length)
fun partition(index: Int, length: Int): Buffer
- (easyar_Buffer *)partition:(int)index length:(int)length
public func partition(_ index: Int32, _ length: Int32) -> Buffer
public virtual Buffer partition(int index, int length)

Parameters

index Int32
length Int32

Returns

Buffer

wrapByteArray

Wrap a byte array.

public static @Nonnull Buffer wrapByteArray(byte @Nonnull[] bytes)
companion object fun wrapByteArray(bytes: Array<Byte>): Buffer
public static Buffer wrapByteArray(byte[] bytes)

Parameters

bytes

Returns

Buffer

wrapByteArray

Wrap a byte array. You can specify the start position and length, and whether the Buffer is read-only or readable/writable (read-only Buffers may be released faster). You can specify a deleter callback, which will be called when the Buffer is completely released to perform user-defined memory cleanup behavior. The deleter must be thread-safe.

public static @Nonnull Buffer wrapByteArray(byte @Nonnull[] bytes, int index, int length, boolean readOnly, @Nonnull FunctorOfVoid deleter)
companion object fun wrapByteArray(bytes: Array<Byte>, index: Int, length: Int, readOnly: Boolean, deleter: FunctorOfVoid): Buffer

Parameters

bytes
index Int32
length Int32
readOnly Boolean
deleter Action

Returns

Buffer

wrapByteArray

Wrap a byte array. You can specify the start position and length.

public static Buffer wrapByteArray(byte[] bytes, int index, int length)

Parameters

bytes
index Int32
length Int32

Returns

Buffer

wrapByteArray

Wrap a byte array. You can specify the start position and length. You can specify a deleter callback, which will be called when the Buffer is completely released to perform user-defined memory cleanup behavior. The deleter must be thread-safe.

public static Buffer wrapByteArray(byte[] bytes, int index, int length, Action deleter)

Parameters

bytes
index Int32
length Int32
deleter Action

Returns

Buffer

wrapBuffer

Wrap a java.nio.Buffer.

public static @Nonnull Buffer wrapBuffer(java.nio.@Nonnull Buffer directBuffer)
companion object fun wrapBuffer(directBuffer: java.nio.Buffer): Buffer

Parameters

directBuffer

Returns

Buffer

wrapBuffer

Wrap a java.nio.Buffer. You can specify a deleter callback, which will be called when the Buffer is completely released to perform user-defined memory cleanup behavior. The deleter must be thread-safe.

public static @Nonnull Buffer wrapBuffer(java.nio.@Nonnull Buffer directBuffer, @Nonnull FunctorOfVoid deleter)
companion object fun wrapBuffer(directBuffer: java.nio.Buffer, deleter: Action): Buffer

Parameters

directBuffer
deleter Action

Returns

Buffer

copyFromByteArray

Copy data from a byte array to the Buffer. If the copy fails, an exception is thrown. The reasons for failure are: the source data range or the target data range exceeds the available range.

public void copyFromByteArray(byte @Nonnull[] src)
fun copyFromByteArray(src: Array<Byte>): Unit
public void copyFromByteArray(byte[] src)

Parameters

src

copyFromByteArray

Copy data from a byte array to the Buffer. If the copy fails, an exception is thrown. The reasons for failure are: the source data range or the target data range exceeds the available range.

public void copyFromByteArray(byte @Nonnull[] src, int srcIndex, int index, int length)
fun copyFromByteArray(src: Array<Byte>, srcIndex: Int, index: Int, length: Int): Unit
public void copyFromByteArray(byte[] src, int srcIndex, int index, int length)

Parameters

src
srcIndex Int32
index Int32
length Int32

copyToByteArray

Copy data from the Buffer to a byte array. If the copy fails, an exception is thrown. The reasons for failure are: the source data range or the target data range exceeds the available range.

public void copyToByteArray(byte @Nonnull[] dest)
fun copyToByteArray(dest: Array<Byte>): Unit
public void copyToByteArray(byte[] dest)

Parameters

dest

copyToByteArray

Copy data from the Buffer to a byte array. If the copy fails, an exception is thrown. The reasons for failure are: the source data range or the target data range exceeds the available range.

public void copyToByteArray(int index, byte @Nonnull[] dest, int destIndex, int length)
fun copyToByteArray(index: Int, dest: Array<Byte>, destIndex: Int, length: Int): Unit
public void copyToByteArray(int index, byte[] dest, int destIndex, int length)

Parameters

index Int32
dest
destIndex Int32
length Int32

tryCopyFromByteArray

Copy data from a byte array to the Buffer. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

public func tryCopyFromByteArray(_ src: [UInt8]) -> Bool

Parameters

src

Returns

Boolean

tryCopyFromByteArray

Copy data from a byte array to the Buffer. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

public func tryCopyFromByteArray(_ src: [UInt8], _ srcIndex: Int32, _ index: Int32, _ length: Int32) -> Bool

Parameters

src
srcIndex Int32
index Int32
length Int32

Returns

Boolean

tryCopyToByteArray

Copy data from the Buffer to a byte array. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

public func tryCopyToByteArray(_ dest: [UInt8]) -> Bool

Parameters

dest

Returns

Boolean

tryCopyToByteArray

Copy data from the Buffer to a byte array. If the copy is successful, return true, otherwise return false. The reasons for failure are: the source data range or the target data range exceeds the available range.

public func tryCopyToByteArray(_ index: Int32, _ dest: [UInt8], _ destIndex: Int32, _ length: Int32) -> Bool

Parameters

index Int32
dest
destIndex Int32
length Int32

Returns

Boolean