feature/frame class

Frame class to wrap all channels. Should be easier to use in code as access to any (available/calculated) channel is possible. Automatic transfers between host/gpu if not available in other.

components/rgbd-sources/include/ftl/rgbd/frame.hpp

@@ -71,9 +71,14 @@ public:
 	 * @param	Channel type
 	 * @returns	Reference to channel data
 	 * 
-	 * Returns non-const reference to channel data. Invalidates other copies of
-	 * the data (host/gpu) for the specified channel, next time getChannel() is
-	 * called a memory transfer may occur.
+	 * Returns non-const reference to channel memory. Invalidates other copies
+	 * of the data (host/gpu) for the specified channel, next time getChannel()
+	 * is called a memory transfer may occur.
+	 * 
+	 * NOTE:	If user of setChannel<T>() wants to modify contents instead of
+	 * 			replacing them, getChannel<T>() needs to be called first to
+	 * 			ensure there is valid contents in the returned reference!
+	 * 			(TODO: interface could be improved)
 	 */
 	template <typename T> T& setChannel(const ftl::rgbd::channel_t& channel);