Struct StoreHandle 

pub struct StoreHandle<'a> { /* private fields */ }

Property storage handle.

This handle can be used to store the properties of a plugin. It uses the atom system to encode the properties and is backed by a storage callback function.

The written properties a buffered and flushed when requested. Create new properties by calling draft and write them like any other atom. Once you are done, you can commit your properties by calling commit_all or commit. You have to commit manually: Uncommitted properties will be discarded when the handle is dropped.

Implementations

impl<'a> StoreHandle<'a>

pub fn new(store_fn: LV2_State_Store_Function, handle: LV2_State_Handle) -> Self

Create a new store handle.

pub fn draft<K: ?Sized>( &mut self, property_key: URID<K>, ) -> StatePropertyWriter<'_>

Draft a new property.

This will return a new handle to create a property. Once the property is completely written, you can commit it by calling commit or commit_all. Then, and only then, it will be saved by the host.

If you began to write a property and don’t want the written things to be stored, you can discard it with discard or discard_all.

pub fn commit_pair<K: ?Sized>( store_fn: LV2_State_Store_Function, handle: LV2_State_Handle, key: URID<K>, space: SpaceElement, ) -> Result<(), StateErr>

Internal helper function to store a property.

pub fn commit_all(&mut self) -> Result<(), StateErr>

Commit all created properties.

This will also clear the property buffer.

pub fn commit<K: ?Sized>( &mut self, key: URID<K>, ) -> Option<Result<(), StateErr>>

Commit one specific property.

This method returns None if the requested property was not marked for commit, Some(Ok(())) if the property was stored and Some(Err(_)) if an error occured while storing the property.

pub fn discard_all(&mut self)

Discard all drafted properties.

pub fn discard<K: ?Sized>(&mut self, key: URID<K>)

Discard a drafted property.

If no property with the given key was drafted before, this is a no-op.