The JUCE cross-platform C++ framework, with DISTRHO/KXStudio specific changes
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1105 lines
35KB

  1. /*
  2. ==============================================================================
  3. This file is part of the JUCE library - "Jules' Utility Class Extensions"
  4. Copyright 2004-11 by Raw Material Software Ltd.
  5. ------------------------------------------------------------------------------
  6. JUCE can be redistributed and/or modified under the terms of the GNU General
  7. Public License (Version 2), as published by the Free Software Foundation.
  8. A copy of the license is included in the JUCE distribution, or can be found
  9. online at www.gnu.org/licenses.
  10. JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
  11. WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
  12. A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  13. ------------------------------------------------------------------------------
  14. To release a closed-source product which uses JUCE, commercial licenses are
  15. available: visit www.rawmaterialsoftware.com/juce for more information.
  16. ==============================================================================
  17. */
  18. class ValueTree::SharedObject : public ReferenceCountedObject
  19. {
  20. public:
  21. typedef ReferenceCountedObjectPtr<SharedObject> Ptr;
  22. explicit SharedObject (const Identifier& t) noexcept
  23. : type (t), parent (nullptr)
  24. {
  25. }
  26. SharedObject (const SharedObject& other)
  27. : ReferenceCountedObject(),
  28. type (other.type), properties (other.properties), parent (nullptr)
  29. {
  30. for (int i = 0; i < other.children.size(); ++i)
  31. {
  32. SharedObject* const child = new SharedObject (*other.children.getObjectPointerUnchecked(i));
  33. child->parent = this;
  34. children.add (child);
  35. }
  36. }
  37. ~SharedObject()
  38. {
  39. jassert (parent == nullptr); // this should never happen unless something isn't obeying the ref-counting!
  40. for (int i = children.size(); --i >= 0;)
  41. {
  42. const Ptr c (children.getObjectPointerUnchecked(i));
  43. c->parent = nullptr;
  44. children.remove (i);
  45. c->sendParentChangeMessage();
  46. }
  47. }
  48. void sendPropertyChangeMessage (ValueTree& tree, const Identifier& property)
  49. {
  50. for (int i = valueTreesWithListeners.size(); --i >= 0;)
  51. if (ValueTree* const v = valueTreesWithListeners[i])
  52. v->listeners.call (&ValueTree::Listener::valueTreePropertyChanged, tree, property);
  53. }
  54. void sendPropertyChangeMessage (const Identifier& property)
  55. {
  56. ValueTree tree (this);
  57. for (ValueTree::SharedObject* t = this; t != nullptr; t = t->parent)
  58. t->sendPropertyChangeMessage (tree, property);
  59. }
  60. void sendChildAddedMessage (ValueTree& tree, ValueTree& child)
  61. {
  62. for (int i = valueTreesWithListeners.size(); --i >= 0;)
  63. if (ValueTree* const v = valueTreesWithListeners[i])
  64. v->listeners.call (&ValueTree::Listener::valueTreeChildAdded, tree, child);
  65. }
  66. void sendChildAddedMessage (ValueTree child)
  67. {
  68. ValueTree tree (this);
  69. for (ValueTree::SharedObject* t = this; t != nullptr; t = t->parent)
  70. t->sendChildAddedMessage (tree, child);
  71. }
  72. void sendChildRemovedMessage (ValueTree& tree, ValueTree& child)
  73. {
  74. for (int i = valueTreesWithListeners.size(); --i >= 0;)
  75. if (ValueTree* const v = valueTreesWithListeners[i])
  76. v->listeners.call (&ValueTree::Listener::valueTreeChildRemoved, tree, child);
  77. }
  78. void sendChildRemovedMessage (ValueTree child)
  79. {
  80. ValueTree tree (this);
  81. for (ValueTree::SharedObject* t = this; t != nullptr; t = t->parent)
  82. t->sendChildRemovedMessage (tree, child);
  83. }
  84. void sendChildOrderChangedMessage (ValueTree& tree)
  85. {
  86. for (int i = valueTreesWithListeners.size(); --i >= 0;)
  87. if (ValueTree* const v = valueTreesWithListeners[i])
  88. v->listeners.call (&ValueTree::Listener::valueTreeChildOrderChanged, tree);
  89. }
  90. void sendChildOrderChangedMessage()
  91. {
  92. ValueTree tree (this);
  93. for (ValueTree::SharedObject* t = this; t != nullptr; t = t->parent)
  94. t->sendChildOrderChangedMessage (tree);
  95. }
  96. void sendParentChangeMessage()
  97. {
  98. ValueTree tree (this);
  99. for (int j = children.size(); --j >= 0;)
  100. if (SharedObject* const child = children.getObjectPointer (j))
  101. child->sendParentChangeMessage();
  102. for (int i = valueTreesWithListeners.size(); --i >= 0;)
  103. if (ValueTree* const v = valueTreesWithListeners[i])
  104. v->listeners.call (&ValueTree::Listener::valueTreeParentChanged, tree);
  105. }
  106. const var& getProperty (const Identifier& name) const noexcept
  107. {
  108. return properties [name];
  109. }
  110. var getProperty (const Identifier& name, const var& defaultReturnValue) const
  111. {
  112. return properties.getWithDefault (name, defaultReturnValue);
  113. }
  114. void setProperty (const Identifier& name, const var& newValue, UndoManager* const undoManager)
  115. {
  116. if (undoManager == nullptr)
  117. {
  118. if (properties.set (name, newValue))
  119. sendPropertyChangeMessage (name);
  120. }
  121. else
  122. {
  123. if (const var* const existingValue = properties.getVarPointer (name))
  124. {
  125. if (*existingValue != newValue)
  126. undoManager->perform (new SetPropertyAction (this, name, newValue, *existingValue, false, false));
  127. }
  128. else
  129. {
  130. undoManager->perform (new SetPropertyAction (this, name, newValue, var::null, true, false));
  131. }
  132. }
  133. }
  134. bool hasProperty (const Identifier& name) const noexcept
  135. {
  136. return properties.contains (name);
  137. }
  138. void removeProperty (const Identifier& name, UndoManager* const undoManager)
  139. {
  140. if (undoManager == nullptr)
  141. {
  142. if (properties.remove (name))
  143. sendPropertyChangeMessage (name);
  144. }
  145. else
  146. {
  147. if (properties.contains (name))
  148. undoManager->perform (new SetPropertyAction (this, name, var::null, properties [name], false, true));
  149. }
  150. }
  151. void removeAllProperties (UndoManager* const undoManager)
  152. {
  153. if (undoManager == nullptr)
  154. {
  155. while (properties.size() > 0)
  156. {
  157. const Identifier name (properties.getName (properties.size() - 1));
  158. properties.remove (name);
  159. sendPropertyChangeMessage (name);
  160. }
  161. }
  162. else
  163. {
  164. for (int i = properties.size(); --i >= 0;)
  165. undoManager->perform (new SetPropertyAction (this, properties.getName(i), var::null,
  166. properties.getValueAt(i), false, true));
  167. }
  168. }
  169. void copyPropertiesFrom (const SharedObject& source, UndoManager* const undoManager)
  170. {
  171. for (int i = properties.size(); --i >= 0;)
  172. if (! source.properties.contains (properties.getName (i)))
  173. removeProperty (properties.getName (i), undoManager);
  174. for (int i = 0; i < source.properties.size(); ++i)
  175. setProperty (source.properties.getName(i), source.properties.getValueAt(i), undoManager);
  176. }
  177. ValueTree getChildWithName (const Identifier& typeToMatch) const
  178. {
  179. for (int i = 0; i < children.size(); ++i)
  180. {
  181. SharedObject* const s = children.getObjectPointerUnchecked (i);
  182. if (s->type == typeToMatch)
  183. return ValueTree (s);
  184. }
  185. return ValueTree::invalid;
  186. }
  187. ValueTree getOrCreateChildWithName (const Identifier& typeToMatch, UndoManager* undoManager)
  188. {
  189. for (int i = 0; i < children.size(); ++i)
  190. {
  191. SharedObject* const s = children.getObjectPointerUnchecked (i);
  192. if (s->type == typeToMatch)
  193. return ValueTree (s);
  194. }
  195. SharedObject* const newObject = new SharedObject (typeToMatch);
  196. addChild (newObject, -1, undoManager);
  197. return ValueTree (newObject);
  198. }
  199. ValueTree getChildWithProperty (const Identifier& propertyName, const var& propertyValue) const
  200. {
  201. for (int i = 0; i < children.size(); ++i)
  202. {
  203. SharedObject* const s = children.getObjectPointerUnchecked (i);
  204. if (s->getProperty (propertyName) == propertyValue)
  205. return ValueTree (s);
  206. }
  207. return ValueTree::invalid;
  208. }
  209. bool isAChildOf (const SharedObject* const possibleParent) const noexcept
  210. {
  211. for (const SharedObject* p = parent; p != nullptr; p = p->parent)
  212. if (p == possibleParent)
  213. return true;
  214. return false;
  215. }
  216. int indexOf (const ValueTree& child) const noexcept
  217. {
  218. return children.indexOf (child.object);
  219. }
  220. void addChild (SharedObject* child, int index, UndoManager* const undoManager)
  221. {
  222. if (child != nullptr && child->parent != this)
  223. {
  224. if (child != this && ! isAChildOf (child))
  225. {
  226. // You should always make sure that a child is removed from its previous parent before
  227. // adding it somewhere else - otherwise, it's ambiguous as to whether a different
  228. // undomanager should be used when removing it from its current parent..
  229. jassert (child->parent == nullptr);
  230. if (child->parent != nullptr)
  231. {
  232. jassert (child->parent->children.indexOf (child) >= 0);
  233. child->parent->removeChild (child->parent->children.indexOf (child), undoManager);
  234. }
  235. if (undoManager == nullptr)
  236. {
  237. children.insert (index, child);
  238. child->parent = this;
  239. sendChildAddedMessage (ValueTree (child));
  240. child->sendParentChangeMessage();
  241. }
  242. else
  243. {
  244. if (! isPositiveAndBelow (index, children.size()))
  245. index = children.size();
  246. undoManager->perform (new AddOrRemoveChildAction (this, index, child));
  247. }
  248. }
  249. else
  250. {
  251. // You're attempting to create a recursive loop! A node
  252. // can't be a child of one of its own children!
  253. jassertfalse;
  254. }
  255. }
  256. }
  257. void removeChild (const int childIndex, UndoManager* const undoManager)
  258. {
  259. const Ptr child (children.getObjectPointer (childIndex));
  260. if (child != nullptr)
  261. {
  262. if (undoManager == nullptr)
  263. {
  264. children.remove (childIndex);
  265. child->parent = nullptr;
  266. sendChildRemovedMessage (ValueTree (child));
  267. child->sendParentChangeMessage();
  268. }
  269. else
  270. {
  271. undoManager->perform (new AddOrRemoveChildAction (this, childIndex, nullptr));
  272. }
  273. }
  274. }
  275. void removeAllChildren (UndoManager* const undoManager)
  276. {
  277. while (children.size() > 0)
  278. removeChild (children.size() - 1, undoManager);
  279. }
  280. void moveChild (int currentIndex, int newIndex, UndoManager* undoManager)
  281. {
  282. // The source index must be a valid index!
  283. jassert (isPositiveAndBelow (currentIndex, children.size()));
  284. if (currentIndex != newIndex
  285. && isPositiveAndBelow (currentIndex, children.size()))
  286. {
  287. if (undoManager == nullptr)
  288. {
  289. children.move (currentIndex, newIndex);
  290. sendChildOrderChangedMessage();
  291. }
  292. else
  293. {
  294. if (! isPositiveAndBelow (newIndex, children.size()))
  295. newIndex = children.size() - 1;
  296. undoManager->perform (new MoveChildAction (this, currentIndex, newIndex));
  297. }
  298. }
  299. }
  300. void reorderChildren (const OwnedArray<ValueTree>& newOrder, UndoManager* undoManager)
  301. {
  302. jassert (newOrder.size() == children.size());
  303. if (undoManager == nullptr)
  304. {
  305. children.clear();
  306. children.ensureStorageAllocated (newOrder.size());
  307. for (int i = 0; i < newOrder.size(); ++i)
  308. children.add (newOrder.getUnchecked(i)->object);
  309. sendChildOrderChangedMessage();
  310. }
  311. else
  312. {
  313. for (int i = 0; i < children.size(); ++i)
  314. {
  315. SharedObject* const child = newOrder.getUnchecked(i)->object;
  316. if (children.getObjectPointerUnchecked (i) != child)
  317. {
  318. const int oldIndex = children.indexOf (child);
  319. jassert (oldIndex >= 0);
  320. moveChild (oldIndex, i, undoManager);
  321. }
  322. }
  323. }
  324. }
  325. bool isEquivalentTo (const SharedObject& other) const
  326. {
  327. if (type != other.type
  328. || properties.size() != other.properties.size()
  329. || children.size() != other.children.size()
  330. || properties != other.properties)
  331. return false;
  332. for (int i = 0; i < children.size(); ++i)
  333. if (! children.getObjectPointerUnchecked(i)->isEquivalentTo (*other.children.getObjectPointerUnchecked(i)))
  334. return false;
  335. return true;
  336. }
  337. XmlElement* createXml() const
  338. {
  339. XmlElement* const xml = new XmlElement (type.toString());
  340. properties.copyToXmlAttributes (*xml);
  341. for (int i = 0; i < children.size(); ++i)
  342. xml->addChildElement (children.getObjectPointerUnchecked(i)->createXml());
  343. return xml;
  344. }
  345. void writeToStream (OutputStream& output) const
  346. {
  347. output.writeString (type.toString());
  348. output.writeCompressedInt (properties.size());
  349. for (int j = 0; j < properties.size(); ++j)
  350. {
  351. output.writeString (properties.getName (j).toString());
  352. properties.getValueAt(j).writeToStream (output);
  353. }
  354. output.writeCompressedInt (children.size());
  355. for (int i = 0; i < children.size(); ++i)
  356. writeObjectToStream (output, children.getObjectPointerUnchecked(i));
  357. }
  358. static void writeObjectToStream (OutputStream& output, const SharedObject* const object)
  359. {
  360. if (object != nullptr)
  361. {
  362. object->writeToStream (output);
  363. }
  364. else
  365. {
  366. output.writeString (String::empty);
  367. output.writeCompressedInt (0);
  368. output.writeCompressedInt (0);
  369. }
  370. }
  371. //==============================================================================
  372. class SetPropertyAction : public UndoableAction
  373. {
  374. public:
  375. SetPropertyAction (SharedObject* const target_, const Identifier& name_,
  376. const var& newValue_, const var& oldValue_,
  377. const bool isAddingNewProperty_, const bool isDeletingProperty_)
  378. : target (target_), name (name_), newValue (newValue_), oldValue (oldValue_),
  379. isAddingNewProperty (isAddingNewProperty_), isDeletingProperty (isDeletingProperty_)
  380. {
  381. }
  382. bool perform()
  383. {
  384. jassert (! (isAddingNewProperty && target->hasProperty (name)));
  385. if (isDeletingProperty)
  386. target->removeProperty (name, nullptr);
  387. else
  388. target->setProperty (name, newValue, nullptr);
  389. return true;
  390. }
  391. bool undo()
  392. {
  393. if (isAddingNewProperty)
  394. target->removeProperty (name, nullptr);
  395. else
  396. target->setProperty (name, oldValue, nullptr);
  397. return true;
  398. }
  399. int getSizeInUnits()
  400. {
  401. return (int) sizeof (*this); //xxx should be more accurate
  402. }
  403. UndoableAction* createCoalescedAction (UndoableAction* nextAction)
  404. {
  405. if (! (isAddingNewProperty || isDeletingProperty))
  406. {
  407. if (SetPropertyAction* const next = dynamic_cast <SetPropertyAction*> (nextAction))
  408. if (next->target == target && next->name == name
  409. && ! (next->isAddingNewProperty || next->isDeletingProperty))
  410. return new SetPropertyAction (target, name, next->newValue, oldValue, false, false);
  411. }
  412. return nullptr;
  413. }
  414. private:
  415. const Ptr target;
  416. const Identifier name;
  417. const var newValue;
  418. var oldValue;
  419. const bool isAddingNewProperty : 1, isDeletingProperty : 1;
  420. JUCE_DECLARE_NON_COPYABLE (SetPropertyAction)
  421. };
  422. //==============================================================================
  423. class AddOrRemoveChildAction : public UndoableAction
  424. {
  425. public:
  426. AddOrRemoveChildAction (SharedObject* target_, const int childIndex_, SharedObject* newChild_)
  427. : target (target_),
  428. child (newChild_ != nullptr ? newChild_ : target_->children.getObjectPointer (childIndex_)),
  429. childIndex (childIndex_),
  430. isDeleting (newChild_ == nullptr)
  431. {
  432. jassert (child != nullptr);
  433. }
  434. bool perform()
  435. {
  436. if (isDeleting)
  437. target->removeChild (childIndex, nullptr);
  438. else
  439. target->addChild (child, childIndex, nullptr);
  440. return true;
  441. }
  442. bool undo()
  443. {
  444. if (isDeleting)
  445. {
  446. target->addChild (child, childIndex, nullptr);
  447. }
  448. else
  449. {
  450. // If you hit this, it seems that your object's state is getting confused - probably
  451. // because you've interleaved some undoable and non-undoable operations?
  452. jassert (childIndex < target->children.size());
  453. target->removeChild (childIndex, nullptr);
  454. }
  455. return true;
  456. }
  457. int getSizeInUnits()
  458. {
  459. return (int) sizeof (*this); //xxx should be more accurate
  460. }
  461. private:
  462. const Ptr target, child;
  463. const int childIndex;
  464. const bool isDeleting;
  465. JUCE_DECLARE_NON_COPYABLE (AddOrRemoveChildAction)
  466. };
  467. //==============================================================================
  468. class MoveChildAction : public UndoableAction
  469. {
  470. public:
  471. MoveChildAction (SharedObject* const parent_, const int startIndex_, const int endIndex_) noexcept
  472. : parent (parent_), startIndex (startIndex_), endIndex (endIndex_)
  473. {
  474. }
  475. bool perform()
  476. {
  477. parent->moveChild (startIndex, endIndex, nullptr);
  478. return true;
  479. }
  480. bool undo()
  481. {
  482. parent->moveChild (endIndex, startIndex, nullptr);
  483. return true;
  484. }
  485. int getSizeInUnits()
  486. {
  487. return (int) sizeof (*this); //xxx should be more accurate
  488. }
  489. UndoableAction* createCoalescedAction (UndoableAction* nextAction)
  490. {
  491. if (MoveChildAction* next = dynamic_cast <MoveChildAction*> (nextAction))
  492. if (next->parent == parent && next->startIndex == endIndex)
  493. return new MoveChildAction (parent, startIndex, next->endIndex);
  494. return nullptr;
  495. }
  496. private:
  497. const Ptr parent;
  498. const int startIndex, endIndex;
  499. JUCE_DECLARE_NON_COPYABLE (MoveChildAction)
  500. };
  501. //==============================================================================
  502. const Identifier type;
  503. NamedValueSet properties;
  504. ReferenceCountedArray<SharedObject> children;
  505. SortedSet<ValueTree*> valueTreesWithListeners;
  506. SharedObject* parent;
  507. private:
  508. SharedObject& operator= (const SharedObject&);
  509. JUCE_LEAK_DETECTOR (SharedObject)
  510. };
  511. //==============================================================================
  512. ValueTree::ValueTree() noexcept
  513. {
  514. }
  515. const ValueTree ValueTree::invalid;
  516. ValueTree::ValueTree (const Identifier& type_)
  517. : object (new ValueTree::SharedObject (type_))
  518. {
  519. jassert (type_.toString().isNotEmpty()); // All objects should be given a sensible type name!
  520. }
  521. ValueTree::ValueTree (SharedObject* const object_)
  522. : object (object_)
  523. {
  524. }
  525. ValueTree::ValueTree (const ValueTree& other)
  526. : object (other.object)
  527. {
  528. }
  529. ValueTree& ValueTree::operator= (const ValueTree& other)
  530. {
  531. if (listeners.size() > 0)
  532. {
  533. if (object != nullptr)
  534. object->valueTreesWithListeners.removeValue (this);
  535. if (other.object != nullptr)
  536. other.object->valueTreesWithListeners.add (this);
  537. }
  538. object = other.object;
  539. listeners.call (&ValueTree::Listener::valueTreeRedirected, *this);
  540. return *this;
  541. }
  542. #if JUCE_COMPILER_SUPPORTS_MOVE_SEMANTICS
  543. ValueTree::ValueTree (ValueTree&& other) noexcept
  544. : object (static_cast <SharedObject::Ptr&&> (other.object))
  545. {
  546. }
  547. #endif
  548. ValueTree::~ValueTree()
  549. {
  550. if (listeners.size() > 0 && object != nullptr)
  551. object->valueTreesWithListeners.removeValue (this);
  552. }
  553. bool ValueTree::operator== (const ValueTree& other) const noexcept
  554. {
  555. return object == other.object;
  556. }
  557. bool ValueTree::operator!= (const ValueTree& other) const noexcept
  558. {
  559. return object != other.object;
  560. }
  561. bool ValueTree::isEquivalentTo (const ValueTree& other) const
  562. {
  563. return object == other.object
  564. || (object != nullptr && other.object != nullptr
  565. && object->isEquivalentTo (*other.object));
  566. }
  567. ValueTree ValueTree::createCopy() const
  568. {
  569. return ValueTree (createCopyIfNotNull (object.get()));
  570. }
  571. bool ValueTree::hasType (const Identifier& typeName) const
  572. {
  573. return object != nullptr && object->type == typeName;
  574. }
  575. Identifier ValueTree::getType() const
  576. {
  577. return object != nullptr ? object->type : Identifier();
  578. }
  579. ValueTree ValueTree::getParent() const
  580. {
  581. return ValueTree (object != nullptr ? object->parent
  582. : static_cast <SharedObject*> (nullptr));
  583. }
  584. ValueTree ValueTree::getSibling (const int delta) const
  585. {
  586. if (object == nullptr || object->parent == nullptr)
  587. return invalid;
  588. const int index = object->parent->indexOf (*this) + delta;
  589. return ValueTree (object->parent->children.getObjectPointer (index));
  590. }
  591. const var& ValueTree::operator[] (const Identifier& name) const
  592. {
  593. return object == nullptr ? var::null : object->getProperty (name);
  594. }
  595. const var& ValueTree::getProperty (const Identifier& name) const
  596. {
  597. return object == nullptr ? var::null : object->getProperty (name);
  598. }
  599. var ValueTree::getProperty (const Identifier& name, const var& defaultReturnValue) const
  600. {
  601. return object == nullptr ? defaultReturnValue
  602. : object->getProperty (name, defaultReturnValue);
  603. }
  604. ValueTree& ValueTree::setProperty (const Identifier& name, const var& newValue,
  605. UndoManager* const undoManager)
  606. {
  607. jassert (name.toString().isNotEmpty()); // Must have a valid property name!
  608. jassert (object != nullptr); // Trying to add a property to a null ValueTree will fail!
  609. if (object != nullptr)
  610. object->setProperty (name, newValue, undoManager);
  611. return *this;
  612. }
  613. bool ValueTree::hasProperty (const Identifier& name) const
  614. {
  615. return object != nullptr && object->hasProperty (name);
  616. }
  617. void ValueTree::removeProperty (const Identifier& name, UndoManager* const undoManager)
  618. {
  619. if (object != nullptr)
  620. object->removeProperty (name, undoManager);
  621. }
  622. void ValueTree::removeAllProperties (UndoManager* const undoManager)
  623. {
  624. if (object != nullptr)
  625. object->removeAllProperties (undoManager);
  626. }
  627. int ValueTree::getNumProperties() const
  628. {
  629. return object == nullptr ? 0 : object->properties.size();
  630. }
  631. Identifier ValueTree::getPropertyName (const int index) const
  632. {
  633. return object == nullptr ? Identifier()
  634. : object->properties.getName (index);
  635. }
  636. void ValueTree::copyPropertiesFrom (const ValueTree& source, UndoManager* const undoManager)
  637. {
  638. jassert (object != nullptr || source.object == nullptr); // Trying to add properties to a null ValueTree will fail!
  639. if (source.object == nullptr)
  640. removeAllProperties (undoManager);
  641. else if (object != nullptr)
  642. object->copyPropertiesFrom (*(source.object), undoManager);
  643. }
  644. //==============================================================================
  645. class ValueTreePropertyValueSource : public Value::ValueSource,
  646. private ValueTree::Listener
  647. {
  648. public:
  649. ValueTreePropertyValueSource (const ValueTree& vt, const Identifier& prop, UndoManager* um)
  650. : tree (vt), property (prop), undoManager (um)
  651. {
  652. tree.addListener (this);
  653. }
  654. ~ValueTreePropertyValueSource()
  655. {
  656. tree.removeListener (this);
  657. }
  658. var getValue() const { return tree [property]; }
  659. void setValue (const var& newValue) { tree.setProperty (property, newValue, undoManager); }
  660. private:
  661. ValueTree tree;
  662. const Identifier property;
  663. UndoManager* const undoManager;
  664. void valueTreePropertyChanged (ValueTree& treeWhosePropertyHasChanged,
  665. const Identifier& changedProperty)
  666. {
  667. if (tree == treeWhosePropertyHasChanged && property == changedProperty)
  668. sendChangeMessage (false);
  669. }
  670. void valueTreeChildAdded (ValueTree&, ValueTree&) {}
  671. void valueTreeChildRemoved (ValueTree&, ValueTree&) {}
  672. void valueTreeChildOrderChanged (ValueTree&) {}
  673. void valueTreeParentChanged (ValueTree&) {}
  674. JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (ValueTreePropertyValueSource)
  675. };
  676. Value ValueTree::getPropertyAsValue (const Identifier& name, UndoManager* const undoManager)
  677. {
  678. return Value (new ValueTreePropertyValueSource (*this, name, undoManager));
  679. }
  680. //==============================================================================
  681. int ValueTree::getNumChildren() const
  682. {
  683. return object == nullptr ? 0 : object->children.size();
  684. }
  685. ValueTree ValueTree::getChild (int index) const
  686. {
  687. return ValueTree (object != nullptr ? object->children.getObjectPointer (index)
  688. : static_cast <SharedObject*> (nullptr));
  689. }
  690. ValueTree ValueTree::getChildWithName (const Identifier& type) const
  691. {
  692. return object != nullptr ? object->getChildWithName (type) : ValueTree::invalid;
  693. }
  694. ValueTree ValueTree::getOrCreateChildWithName (const Identifier& type, UndoManager* undoManager)
  695. {
  696. return object != nullptr ? object->getOrCreateChildWithName (type, undoManager) : ValueTree::invalid;
  697. }
  698. ValueTree ValueTree::getChildWithProperty (const Identifier& propertyName, const var& propertyValue) const
  699. {
  700. return object != nullptr ? object->getChildWithProperty (propertyName, propertyValue) : ValueTree::invalid;
  701. }
  702. bool ValueTree::isAChildOf (const ValueTree& possibleParent) const
  703. {
  704. return object != nullptr && object->isAChildOf (possibleParent.object);
  705. }
  706. int ValueTree::indexOf (const ValueTree& child) const
  707. {
  708. return object != nullptr ? object->indexOf (child) : -1;
  709. }
  710. void ValueTree::addChild (const ValueTree& child, int index, UndoManager* const undoManager)
  711. {
  712. jassert (object != nullptr); // Trying to add a child to a null ValueTree!
  713. if (object != nullptr)
  714. object->addChild (child.object, index, undoManager);
  715. }
  716. void ValueTree::removeChild (const int childIndex, UndoManager* const undoManager)
  717. {
  718. if (object != nullptr)
  719. object->removeChild (childIndex, undoManager);
  720. }
  721. void ValueTree::removeChild (const ValueTree& child, UndoManager* const undoManager)
  722. {
  723. if (object != nullptr)
  724. object->removeChild (object->children.indexOf (child.object), undoManager);
  725. }
  726. void ValueTree::removeAllChildren (UndoManager* const undoManager)
  727. {
  728. if (object != nullptr)
  729. object->removeAllChildren (undoManager);
  730. }
  731. void ValueTree::moveChild (int currentIndex, int newIndex, UndoManager* undoManager)
  732. {
  733. if (object != nullptr)
  734. object->moveChild (currentIndex, newIndex, undoManager);
  735. }
  736. //==============================================================================
  737. void ValueTree::createListOfChildren (OwnedArray<ValueTree>& list) const
  738. {
  739. jassert (object != nullptr);
  740. for (int i = 0; i < object->children.size(); ++i)
  741. list.add (new ValueTree (object->children.getObjectPointerUnchecked(i)));
  742. }
  743. void ValueTree::reorderChildren (const OwnedArray<ValueTree>& newOrder, UndoManager* undoManager)
  744. {
  745. jassert (object != nullptr);
  746. object->reorderChildren (newOrder, undoManager);
  747. }
  748. //==============================================================================
  749. void ValueTree::addListener (Listener* listener)
  750. {
  751. if (listener != nullptr)
  752. {
  753. if (listeners.size() == 0 && object != nullptr)
  754. object->valueTreesWithListeners.add (this);
  755. listeners.add (listener);
  756. }
  757. }
  758. void ValueTree::removeListener (Listener* listener)
  759. {
  760. listeners.remove (listener);
  761. if (listeners.size() == 0 && object != nullptr)
  762. object->valueTreesWithListeners.removeValue (this);
  763. }
  764. void ValueTree::sendPropertyChangeMessage (const Identifier& property)
  765. {
  766. if (object != nullptr)
  767. object->sendPropertyChangeMessage (property);
  768. }
  769. //==============================================================================
  770. XmlElement* ValueTree::createXml() const
  771. {
  772. return object != nullptr ? object->createXml() : nullptr;
  773. }
  774. ValueTree ValueTree::fromXml (const XmlElement& xml)
  775. {
  776. ValueTree v (xml.getTagName());
  777. v.object->properties.setFromXmlAttributes (xml);
  778. forEachXmlChildElement (xml, e)
  779. v.addChild (fromXml (*e), -1, nullptr);
  780. return v;
  781. }
  782. String ValueTree::toXmlString() const
  783. {
  784. const ScopedPointer<XmlElement> xml (createXml());
  785. return xml != nullptr ? xml->createDocument (String::empty) : String::empty;
  786. }
  787. //==============================================================================
  788. void ValueTree::writeToStream (OutputStream& output) const
  789. {
  790. SharedObject::writeObjectToStream (output, object);
  791. }
  792. ValueTree ValueTree::readFromStream (InputStream& input)
  793. {
  794. const String type (input.readString());
  795. if (type.isEmpty())
  796. return ValueTree::invalid;
  797. ValueTree v (type);
  798. const int numProps = input.readCompressedInt();
  799. if (numProps < 0)
  800. {
  801. jassertfalse; // trying to read corrupted data!
  802. return v;
  803. }
  804. for (int i = 0; i < numProps; ++i)
  805. {
  806. const String name (input.readString());
  807. jassert (name.isNotEmpty());
  808. const var value (var::readFromStream (input));
  809. v.object->properties.set (name, value);
  810. }
  811. const int numChildren = input.readCompressedInt();
  812. v.object->children.ensureStorageAllocated (numChildren);
  813. for (int i = 0; i < numChildren; ++i)
  814. {
  815. ValueTree child (readFromStream (input));
  816. v.object->children.add (child.object);
  817. child.object->parent = v.object;
  818. }
  819. return v;
  820. }
  821. ValueTree ValueTree::readFromData (const void* const data, const size_t numBytes)
  822. {
  823. MemoryInputStream in (data, numBytes, false);
  824. return readFromStream (in);
  825. }
  826. ValueTree ValueTree::readFromGZIPData (const void* const data, const size_t numBytes)
  827. {
  828. MemoryInputStream in (data, numBytes, false);
  829. GZIPDecompressorInputStream gzipStream (in);
  830. return readFromStream (gzipStream);
  831. }
  832. void ValueTree::Listener::valueTreeRedirected (ValueTree&) {}
  833. //==============================================================================
  834. #if JUCE_UNIT_TESTS
  835. class ValueTreeTests : public UnitTest
  836. {
  837. public:
  838. ValueTreeTests() : UnitTest ("ValueTrees") {}
  839. static String createRandomIdentifier()
  840. {
  841. char buffer[50] = { 0 };
  842. const char chars[] = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_-:";
  843. Random r;
  844. for (int i = 1 + r.nextInt (numElementsInArray (buffer) - 2); --i >= 0;)
  845. buffer[i] = chars [r.nextInt (sizeof (chars) - 1)];
  846. return CharPointer_ASCII (buffer);
  847. }
  848. static String createRandomWideCharString()
  849. {
  850. juce_wchar buffer[50] = { 0 };
  851. Random r;
  852. for (int i = r.nextInt (numElementsInArray (buffer) - 1); --i >= 0;)
  853. {
  854. if (r.nextBool())
  855. {
  856. do
  857. {
  858. buffer[i] = (juce_wchar) (1 + r.nextInt (0x10ffff - 1));
  859. }
  860. while (! CharPointer_UTF16::canRepresent (buffer[i]));
  861. }
  862. else
  863. buffer[i] = (juce_wchar) (1 + r.nextInt (0x7e));
  864. }
  865. return CharPointer_UTF32 (buffer);
  866. }
  867. static ValueTree createRandomTree (UndoManager* undoManager, int depth)
  868. {
  869. Random r;
  870. ValueTree v (createRandomIdentifier());
  871. for (int i = r.nextInt (10); --i >= 0;)
  872. {
  873. switch (r.nextInt (5))
  874. {
  875. case 0: v.setProperty (createRandomIdentifier(), createRandomWideCharString(), undoManager); break;
  876. case 1: v.setProperty (createRandomIdentifier(), r.nextInt(), undoManager); break;
  877. case 2: if (depth < 5) v.addChild (createRandomTree (undoManager, depth + 1), r.nextInt (v.getNumChildren() + 1), undoManager); break;
  878. case 3: v.setProperty (createRandomIdentifier(), r.nextBool(), undoManager); break;
  879. case 4: v.setProperty (createRandomIdentifier(), r.nextDouble(), undoManager); break;
  880. default: break;
  881. }
  882. }
  883. return v;
  884. }
  885. void runTest()
  886. {
  887. beginTest ("ValueTree");
  888. for (int i = 10; --i >= 0;)
  889. {
  890. MemoryOutputStream mo;
  891. ValueTree v1 (createRandomTree (nullptr, 0));
  892. v1.writeToStream (mo);
  893. MemoryInputStream mi (mo.getData(), mo.getDataSize(), false);
  894. ValueTree v2 = ValueTree::readFromStream (mi);
  895. expect (v1.isEquivalentTo (v2));
  896. ScopedPointer <XmlElement> xml1 (v1.createXml());
  897. ScopedPointer <XmlElement> xml2 (v2.createCopy().createXml());
  898. expect (xml1->isEquivalentTo (xml2, false));
  899. ValueTree v4 = v2.createCopy();
  900. expect (v1.isEquivalentTo (v4));
  901. }
  902. }
  903. };
  904. static ValueTreeTests valueTreeTests;
  905. #endif