vcl/inc/implimagetree.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_VCL_INC_IMPLIMAGETREE_HXX
  21 #define INCLUDED_VCL_INC_IMPLIMAGETREE_HXX
  22
  23 #include <sal/config.h>
  24
  25 #include <memory>
  26 #include <unordered_map>
  27 #include <utility>
  28 #include <vector>
  29
  30 #include <com/sun/star/uno/Reference.hxx>
  31 #include <rtl/ustring.hxx>
  32 #include <vcl/bitmapex.hxx>
  33 #include <vcl/dllapi.h>
  34 #include <i18nlangtag/languagetag.hxx>
  35 #include <vcl/ImageTree.hxx>
  36
  37 namespace com { namespace sun { namespace star { namespace container {
  38     class XNameAccess;
  39 }}}}
  40
  41 struct ImageRequestParameters
  42 {
  43     OUString msName;
  44     OUString msStyle;
  45     BitmapEx& mrBitmap;
  46     bool mbLocalized;
  47     ImageLoadFlags meFlags;
  48
  49     ImageRequestParameters(const OUString & rName, const OUString & rStyle, BitmapEx& rBitmap, bool bLocalized, ImageLoadFlags eFlags)
  50         : msName(rName)
  51         , msStyle(rStyle)
  52         , mrBitmap(rBitmap)
  53         , mbLocalized(bLocalized)
  54         , meFlags(eFlags)
  55     {}
  56
  57     bool convertToDarkTheme();
  58     sal_Int32 scalePercentage();
  59 };
  60
  61 class ImplImageTree
  62 {
  63 public:
  64     ImplImageTree();
  65     ~ImplImageTree();
  66
  67     OUString getImageUrl(
  68         OUString const & name, OUString const & style, OUString const & lang);
  69
  70     bool loadImage(
  71         OUString const & name, OUString const & style,
  72         BitmapEx & bitmap, bool localized,
  73         const ImageLoadFlags eFlags = ImageLoadFlags::NONE);
  74
  75     bool loadDefaultImage(
  76         OUString const & style,
  77         BitmapEx& bitmap,
  78         const ImageLoadFlags eFlags = ImageLoadFlags::NONE);
  79
  80     /** a crude form of life cycle control (called from DeInitVCL; otherwise,
  81      *  if the ImplImageTree singleton were destroyed during exit that would
  82      *  be too late for the destructors of the bitmaps in maIconCache)*/
  83     void shutdown();
  84
  85     css::uno::Reference< css::container::XNameAccess > getNameAccess();
  86
  87 private:
  88     ImplImageTree(const ImplImageTree&) = delete;
  89     ImplImageTree& operator=(const ImplImageTree&) = delete;
  90
  91     typedef std::unordered_map<OUString, std::pair<bool, BitmapEx>, OUStringHash> IconCache;
  92     typedef std::unordered_map<OUString, OUString, OUStringHash> IconLinkHash;
  93
  94     struct IconSet
  95     {
  96         OUString maURL;
  97         css::uno::Reference<css::container::XNameAccess> maNameAccess;
  98         IconCache maIconCache;
  99         IconLinkHash maLinkHash;
 100
 101         IconSet()
 102         {}
 103
 104         IconSet(const OUString & rURL)
 105             : maURL(rURL)
 106         {}
 107     };
 108
 109     /// Map between the theme name(s) and the content.
 110     typedef std::unordered_map<OUString, IconSet, OUStringHash> StyleIconSet;
 111
 112     /// Remember all the (used) icon styles and individual icons in them.
 113     StyleIconSet maIconSets;
 114
 115     /// Style used for the current operations; switches switch several times during fallback search.
 116     OUString maCurrentStyle;
 117
 118     IconSet& getCurrentIconSet()
 119     {
 120         return maIconSets[maCurrentStyle];
 121     }
 122
 123     bool doLoadImage(ImageRequestParameters& rParameters);
 124
 125     std::vector<OUString> getPaths(OUString const & name, LanguageTag& rLanguageTag);
 126
 127     bool checkPathAccess();
 128
 129     void setStyle(OUString const & rStyle);
 130
 131     void createStyle();
 132
 133     bool iconCacheLookup(ImageRequestParameters& rParameters);
 134
 135     bool findImage(std::vector<OUString> const & rPaths, ImageRequestParameters& rParameters);
 136
 137     void loadImageLinks();
 138
 139     void parseLinkFile(std::shared_ptr<SvStream> const & aStream);
 140
 141     /// Return name of a real .png according to links.txt.
 142     OUString const & getRealImageName(OUString const & rName);
 143
 144
 145     /** Return name of the fallback style for the provided one.
 146
 147         Must not be cyclic :-)  The last theme in the chain returns an empty string.
 148     */
 149     static OUString fallbackStyle(const OUString &rStyle);
 150 };
 151
 152 #endif
 153
 154 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */