/* ============================================================================== This file is part of the JUCE 6 technical preview. Copyright (c) 2020 - Raw Material Software Limited You may use this code under the terms of the GPL v3 (see www.gnu.org/licenses). For this technical preview, this file is not subject to commercial licensing. JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE DISCLAIMED. ============================================================================== */ #pragma once namespace juce { /** A singleton class responsible for sharing content between apps and devices. You can share text, images, files or an arbitrary data block. @tags{GUI} */ class JUCE_API ContentSharer : public DeletedAtShutdown { public: JUCE_DECLARE_SINGLETON (ContentSharer, false) /** Shares the given files. Each URL should be either a full file path or it should point to a resource within the application bundle. For resources on iOS it should be something like "content/image.png" if you want to specify a file from application bundle located in "content" directory. On Android you should specify only a filename, without an extension. Upon completion you will receive a callback with a sharing result. Note: Sadly on Android the returned success flag may be wrong as there is no standard way the sharing targets report if the sharing operation succeeded. Also, the optional error message is always empty on Android. */ void shareFiles (const Array& files, std::function callback); /** Shares the given text. Upon completion you will receive a callback with a sharing result. Note: Sadly on Android the returned success flag may be wrong as there is no standard way the sharing targets report if the sharing operation succeeded. Also, the optional error message is always empty on Android. */ void shareText (const String& text, std::function callback); /** A convenience function to share an image. This is useful when you have images loaded in memory. The images will be written to temporary files first, so if you have the images in question stored on disk already call shareFiles() instead. By default, images will be saved to PNG files, but you can supply a custom ImageFileFormat to override this. The custom file format will be owned and deleted by the sharer. e.g. @code Graphics g (myImage); g.setColour (Colours::green); g.fillEllipse (20, 20, 300, 200); Array images; images.add (myImage); ContentSharer::getInstance()->shareImages (images, myCallback); @endcode Upon completion you will receive a callback with a sharing result. Note: Sadly on Android the returned success flag may be wrong as there is no standard way the sharing targets report if the sharing operation succeeded. Also, the optional error message is always empty on Android. */ void shareImages (const Array& images, std::function callback, ImageFileFormat* imageFileFormatToUse = nullptr); /** A convenience function to share arbitrary data. The data will be written to a temporary file and then that file will be shared. If you have your data stored on disk already, call shareFiles() instead. Upon completion you will receive a callback with a sharing result. Note: Sadly on Android the returned success flag may be wrong as there is no standard way the sharing targets report if the sharing operation succeeded. Also, the optional error message is always empty on Android. */ void shareData (const MemoryBlock& mb, std::function callback); private: ContentSharer(); ~ContentSharer(); Array temporaryFiles; std::function callback; #if JUCE_CONTENT_SHARING struct Pimpl { virtual ~Pimpl() {} virtual void shareFiles (const Array& files) = 0; virtual void shareText (const String& text) = 0; }; std::unique_ptr pimpl; Pimpl* createPimpl(); void startNewShare (std::function); class ContentSharerNativeImpl; friend class ContentSharerNativeImpl; class PrepareImagesThread; friend class PrepareImagesThread; std::unique_ptr prepareImagesThread; class PrepareDataThread; friend class PrepareDataThread; std::unique_ptr prepareDataThread; void filesToSharePrepared(); #endif void deleteTemporaryFiles(); void sharingFinished (bool, const String&); }; } // namespace juce