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.
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
ptrIntPtrsizeInt32deleterAction
Returns
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
sizeInt32
Returns
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
srcIntPtrdestIntPtrlengthInt32
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
srcIntPtrsrcIndexInt32indexInt32lengthInt32
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
indexInt32destIntPtrdestIndexInt32lengthInt32
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
indexInt32lengthInt32
Returns
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
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
bytesindexInt32lengthInt32readOnlyBooleandeleterAction
Returns
wrapByteArray
Wrap a byte array. You can specify the start position and length.
public static Buffer wrapByteArray(byte[] bytes, int index, int length)
Parameters
bytesindexInt32lengthInt32
Returns
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
bytesindexInt32lengthInt32deleterAction
Returns
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
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
directBufferdeleterAction
Returns
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
srcsrcIndexInt32indexInt32lengthInt32
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
indexInt32destdestIndexInt32lengthInt32
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
srcsrcIndexInt32indexInt32lengthInt32
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
indexInt32destdestIndexInt32lengthInt32
Returns
- Boolean