// nih-plug: plugins, but rewritten in Rust // Copyright (C) 2022 Robbert van der Helm // // This program is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // This program is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with this program. If not, see . //! Utilities for saving a [crate::plugin::Plugin]'s state. use serde::de::Error; use serde::{Deserialize, Serialize}; use std::collections::HashMap; /// A plain, unnormalized value for a parameter. #[derive(Debug, Serialize, Deserialize)] #[serde(rename_all = "snake_case")] pub(crate) enum ParamValue { F32(f32), I32(i32), Bool(bool), } /// A plugin's state so it can be restored at a later point. #[derive(Debug, Serialize, Deserialize)] pub(crate) struct State { /// The plugin's parameter values. These are stored unnormalized. This mean sthe old values will /// be recalled when when the parameter's range gets increased. Doing so may still mess with /// parmaeter automation though, depending on how the host impelments that. pub params: HashMap, /// Arbitrary fields that should be persisted together with the plugin's parameters. Any field /// on the [Params] struct that's annotated with `#[persist = "stable_name"]` will be persisted /// this way. /// /// The individual JSON-serialized fields are encoded as base64 strings so they don't take up as /// much space in the preset. Storing them as a plain JSON string would have also been possible, /// but that can get messy with escaping since those will likely also contain double quotes. #[serde(serialize_with = "encode_fields")] #[serde(deserialize_with = "decode_fields")] pub fields: HashMap>, } fn encode_fields(bytes: &HashMap>, serializer: S) -> Result where S: serde::Serializer, { serializer.collect_map( bytes .into_iter() .map(|(id, json)| (id, base64::encode(json))), ) } fn decode_fields<'de, D>(deserializer: D) -> Result>, D::Error> where D: serde::Deserializer<'de>, { let base64_map: HashMap = HashMap::deserialize(deserializer)?; let decoded_map: Result>, D::Error> = base64_map .into_iter() .map(|(id, base64)| { base64::decode(base64) .map(|decoded| (id, decoded)) .map_err(|err| D::Error::custom(format!("base64 decode failed: {}", err))) }) .collect(); Ok(decoded_map?) }