WriteBuffer
Write data into the memory buffer allocated by the context.
Read time 3 minutesLast updated 7 days ago
Definition
- Type: Method
- Namespace: UnityEngine.LightTransport
- Assembly: UnityEditor.CoreModule
WriteBuffer<T>(BufferSlice<T>, NativeArray<T>)
Write data into the memory buffer allocated by the context.
public void WriteBuffer<T>(BufferSlice<T> dst, NativeArray<T> src) where T : struct
Parameters
The BufferSlice to write to.
The array in the CPU memory that should be written to the buffer. The array must remain valid until the write operation is complete.
Remarks
This is an asynchronous operation. Pass an EventID created with IDeviceContext.CreateEvent() to track the completion status, if desired. The RadeonRaysContext.WriteBuffer method returns immediately after enqueuing the command in the context.
Note: EventID is single-use. Once an EventID has been passed to this function, it may not be passed to subsequent IDeviceContext.WriteBuffer or IDeviceContext.ReadBuffer calls. Doing so will result in undefined behavior.
Examples
using Unity.Collections;using UnityEngine;using UnityEngine.LightTransport;IDeviceContext ctx = new RadeonRaysContext();ctx.Initialize();uint length = 8;var input = new NativeArray<byte>((int)length, Allocator.Persistent);for (int i = 0; i < length; ++i) input[i] = (byte)i;BufferID id = ctx.CreateBuffer(8);var writeEvent = ctx.CreateEvent();ctx.WriteBuffer(id.Slice<byte>(), input, writeEvent);bool flushOk = ctx.Flush();Assert.IsTrue(flushOk);bool eventOk = ctx.Wait(writeEvent);Assert.IsTrue(eventOk);ctx.DestroyEvent(writeEvent);// The contents of the input buffer has now been transferred into the buffer allocated by the context.input.Dispose();ctx.DestroyBuffer(id);ctx.Dispose();
WriteBuffer<T>(BufferSlice<T>, NativeArray<T>, EventID)
Write data into the memory buffer allocated by the context.
public void WriteBuffer<T>(BufferSlice<T> dst, NativeArray<T> src, EventID id) where T : struct
Parameters
The BufferSlice to write to.
The array in the CPU memory that should be written to the buffer. The array must remain valid until the write operation is complete.
The ID of the event to use to track completion of the write.
Remarks
This is an asynchronous operation. Pass an EventID created with IDeviceContext.CreateEvent() to track the completion status, if desired. The RadeonRaysContext.WriteBuffer method returns immediately after enqueuing the command in the context.
Note: EventID is single-use. Once an EventID has been passed to this function, it may not be passed to subsequent IDeviceContext.WriteBuffer or IDeviceContext.ReadBuffer calls. Doing so will result in undefined behavior.
Examples
using Unity.Collections;using UnityEngine;using UnityEngine.LightTransport;IDeviceContext ctx = new RadeonRaysContext();ctx.Initialize();uint length = 8;var input = new NativeArray<byte>((int)length, Allocator.Persistent);for (int i = 0; i < length; ++i) input[i] = (byte)i;BufferID id = ctx.CreateBuffer(8);var writeEvent = ctx.CreateEvent();ctx.WriteBuffer(id.Slice<byte>(), input, writeEvent);bool flushOk = ctx.Flush();Assert.IsTrue(flushOk);bool eventOk = ctx.Wait(writeEvent);Assert.IsTrue(eventOk);ctx.DestroyEvent(writeEvent);// The contents of the input buffer has now been transferred into the buffer allocated by the context.input.Dispose();ctx.DestroyBuffer(id);ctx.Dispose();