LibreOffice Module vcl (master)  1
graph.hxx
Go to the documentation of this file.
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 #pragma once
21 
22 #include <memory>
23 #include <vcl/dllapi.h>
24 #include <tools/solar.h>
25 #include <rtl/ustring.hxx>
26 #include <vcl/bitmapex.hxx>
28 #include <vcl/gfxlink.hxx>
29 #include <com/sun/star/uno/Reference.hxx>
33 
34 enum class GraphicType
35 {
36  NONE,
37  Bitmap,
39  Default
40 };
41 
42 namespace com::sun::star::graphic { class XGraphic; }
43 namespace vcl { class Font; }
44 
45 class Bitmap;
46 class GDIMetaFile;
47 class SvStream;
48 class ImpGraphic;
49 class OutputDevice;
50 class GraphicReader;
51 
53 {
54 private:
55  Size maSizePixel; // default is (0,0)
56 
57  bool mbUnlimitedSize : 1; // default is false
58  bool mbAntiAliase : 1; // default is false
59  bool mbSnapHorVerLines : 1; // default is false
60 
61 public:
63  const Size& rSizePixel = Size(),
64  bool bUnlimitedSize = false,
65  bool bAntiAliase = false,
66  bool bSnapHorVerLines = false)
67  : maSizePixel(rSizePixel),
68  mbUnlimitedSize(bUnlimitedSize),
69  mbAntiAliase(bAntiAliase),
70  mbSnapHorVerLines(bSnapHorVerLines)
71  {
72  }
73 
74  // data read access
75  const Size& getSizePixel() const { return maSizePixel; }
76  bool getUnlimitedSize() const { return mbUnlimitedSize; }
77  bool getAntiAliase() const { return mbAntiAliase; }
78  bool getSnapHorVerLines() const { return mbSnapHorVerLines; }
79 };
80 
81 class Image;
83 {
84 private:
85  std::shared_ptr<ImpGraphic> mxImpGraphic;
86  SAL_DLLPRIVATE void ImplTestRefCount();
87 
88 public:
89  SAL_DLLPRIVATE ImpGraphic* ImplGetImpGraphic() const { return mxImpGraphic.get(); }
90 
91  Graphic();
92  Graphic(std::shared_ptr<GfxLink> const & rGfxLink, sal_Int32 nPageIndex = 0);
93  Graphic( const GraphicExternalLink& rGraphicLink );
94  Graphic( const Graphic& rGraphic );
95  Graphic( Graphic&& rGraphic ) noexcept;
96  Graphic( const Image& rImage );
97  Graphic( const BitmapEx& rBmpEx );
98  Graphic( const std::shared_ptr<VectorGraphicData>& rVectorGraphicDataPtr );
99  Graphic( const Animation& rAnimation );
100  Graphic( const GDIMetaFile& rMtf );
101  Graphic( const css::uno::Reference< css::graphic::XGraphic >& rxGraphic );
102 
103  Graphic& operator=( const Graphic& rGraphic );
104  Graphic& operator=( Graphic&& rGraphic ) noexcept;
105  bool operator==( const Graphic& rGraphic ) const;
106  bool operator!=( const Graphic& rGraphic ) const;
107 
108  bool IsNone() const;
109 
110  void Clear();
111 
112  GraphicType GetType() const;
113  void SetDefaultType();
114  bool IsSupportedGraphic() const;
115 
116  bool IsTransparent() const;
117  bool IsAlpha() const;
118  bool IsAnimated() const;
119  bool IsEPS() const;
120 
121  bool isAvailable() const;
122  bool makeAvailable();
123 
124  // #i102089# Access of Bitmap potentially will have to rasterconvert the Graphic
125  // if it is a MetaFile. To be able to control this conversion it is necessary to
126  // allow giving parameters which control AntiAliasing and LineSnapping of the
127  // MetaFile when played. Defaults will use a no-AAed, not snapped conversion as
128  // before.
129  BitmapEx GetBitmapEx(const GraphicConversionParameters& rParameters = GraphicConversionParameters()) const;
131  const BitmapEx& GetBitmapExRef() const;
132 
133  Animation GetAnimation() const;
134  const GDIMetaFile& GetGDIMetaFile() const;
135 
136  css::uno::Reference< css::graphic::XGraphic > GetXGraphic() const;
137 
138  Size GetPrefSize() const;
139  void SetPrefSize( const Size& rPrefSize );
140 
141  MapMode GetPrefMapMode() const;
142  void SetPrefMapMode( const MapMode& rPrefMapMode );
143 
144  basegfx::B2DSize GetPPI() const;
145 
146  Size GetSizePixel( const OutputDevice* pRefDevice = nullptr ) const;
147 
148  sal_uLong GetSizeBytes() const;
149 
150  void Draw( OutputDevice* pOutDev,
151  const Point& rDestPt ) const;
152  void Draw( OutputDevice* pOutDev,
153  const Point& rDestPt,
154  const Size& rDestSize ) const;
155  static void DrawEx( OutputDevice* pOutDev, const OUString& rText,
156  vcl::Font& rFont, const BitmapEx& rBitmap,
157  const Point& rDestPt, const Size& rDestSize );
158 
159  void StartAnimation( OutputDevice* pOutDev,
160  const Point& rDestPt,
161  const Size& rDestSize,
162  tools::Long nExtraData = 0,
163  OutputDevice* pFirstFrameOutDev = nullptr );
164  void StopAnimation( const OutputDevice* pOutputDevice,
165  tools::Long nExtraData );
166 
167  void SetAnimationNotifyHdl( const Link<Animation*,void>& rLink );
168  Link<Animation*,void> GetAnimationNotifyHdl() const;
169 
170  sal_uInt32 GetAnimationLoopCount() const;
171 
172  BitmapChecksum GetChecksum() const;
173 
174  OUString getOriginURL() const;
175  void setOriginURL(OUString const & rOriginURL);
176 
177  OString getUniqueID() const;
178 
179  std::shared_ptr<GraphicReader>& GetReaderContext();
180  void SetReaderContext( const std::shared_ptr<GraphicReader> &pReader );
181  void SetDummyContext(bool value);
182  bool IsDummyContext() const;
183 
184  void SetGfxLink(const std::shared_ptr<GfxLink>& rGfxLink);
185  const std::shared_ptr<GfxLink> & GetSharedGfxLink() const;
186  GfxLink GetGfxLink() const;
187  bool IsGfxLink() const;
188 
189  const std::shared_ptr<VectorGraphicData>& getVectorGraphicData() const;
190 
192  sal_Int32 getPageNumber() const;
193 
194  static css::uno::Sequence<sal_Int8> getUnoTunnelId();
195 };
196 
197 namespace std {
198 
199 template <>
200 struct hash<Graphic>
201 {
202  std::size_t operator()(Graphic const & rGraphic) const
203  {
204  return static_cast<std::size_t>(rGraphic.GetChecksum());
205  }
206 };
207 
208 } // end namespace std
209 
210 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
sal_uInt64 BitmapChecksum
Definition: checksum.hxx:30
std::shared_ptr< ImpGraphic > mxImpGraphic
Definition: graph.hxx:85
signed char sal_Int8
BitmapChecksum GetChecksum() const
Definition: graph.cxx:518
#define VCL_DLLPUBLIC
Definition: dllapi.h:29
sal_uIntPtr sal_uLong
long Long
GraphicType
Definition: graph.hxx:34
std::size_t operator()(Graphic const &rGraphic) const
Definition: graph.hxx:202
bool getUnlimitedSize() const
Definition: graph.hxx:76
B2DVector B2DSize
const Size & getSizePixel() const
Definition: graph.hxx:75
SAL_DLLPRIVATE ImpGraphic * ImplGetImpGraphic() const
Definition: graph.hxx:89
bool getSnapHorVerLines() const
Definition: graph.hxx:78
Some things multiple-inherit from VclAbstractDialog and OutputDevice, so we need to use virtual inher...
Definition: outdev.hxx:288
#define SAL_WARN_UNUSED
Definition: image.hxx:39
GraphicConversionParameters(const Size &rSizePixel=Size(), bool bUnlimitedSize=false, bool bAntiAliase=false, bool bSnapHorVerLines=false)
Definition: graph.hxx:62
bool getAntiAliase() const
Definition: graph.hxx:77