include/xmloff/shapeimport.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_XMLOFF_SHAPEIMPORT_HXX
  21 #define INCLUDED_XMLOFF_SHAPEIMPORT_HXX
  22
  23 #include <sal/config.h>
  24 #include <xmloff/dllapi.h>
  25 #include <com/sun/star/drawing/HomogenMatrix.hpp>
  26 #include <com/sun/star/drawing/ProjectionMode.hpp>
  27 #include <com/sun/star/drawing/ShadeMode.hpp>
  28 #include <salhelper/simplereferenceobject.hxx>
  29 #include <xmloff/xmlictxt.hxx>
  30
  31 #include <basegfx/vector/b3dvector.hxx>
  32 #include <vector>
  33 #include <memory>
  34
  35 namespace com::sun::star::beans { class XPropertySet; }
  36 namespace com::sun::star::drawing { class XShape; }
  37 namespace com::sun::star::drawing { class XShapes; }
  38 namespace com::sun::star::frame { class XModel; }
  39 namespace com::sun::star::xml::sax { class XAttributeList; }
  40
  41 class SvXMLImport;
  42 class SvXMLTokenMap;
  43 class SvXMLStylesContext;
  44 class XMLSdPropHdlFactory;
  45 class SvXMLImportPropertyMapper;
  46 class XMLTableImport;
  47
  48
  49 enum SdXMLGroupShapeElemTokenMap
  50 {
  51     XML_TOK_GROUP_GROUP,
  52     XML_TOK_GROUP_RECT,
  53     XML_TOK_GROUP_LINE,
  54     XML_TOK_GROUP_CIRCLE,
  55     XML_TOK_GROUP_ELLIPSE,
  56     XML_TOK_GROUP_POLYGON,
  57     XML_TOK_GROUP_POLYLINE,
  58     XML_TOK_GROUP_PATH,
  59
  60     XML_TOK_GROUP_CONTROL,
  61     XML_TOK_GROUP_CONNECTOR,
  62     XML_TOK_GROUP_MEASURE,
  63     XML_TOK_GROUP_PAGE,
  64     XML_TOK_GROUP_CAPTION,
  65
  66     XML_TOK_GROUP_CHART,
  67     XML_TOK_GROUP_3DSCENE,
  68
  69     XML_TOK_GROUP_FRAME,
  70
  71     XML_TOK_GROUP_CUSTOM_SHAPE,
  72
  73     XML_TOK_GROUP_ANNOTATION,
  74
  75     XML_TOK_GROUP_A
  76 };
  77
  78 enum SdXMLFrameShapeElemTokenMap
  79 {
  80     XML_TOK_FRAME_TEXT_BOX,
  81     XML_TOK_FRAME_IMAGE,
  82     XML_TOK_FRAME_OBJECT,
  83     XML_TOK_FRAME_OBJECT_OLE,
  84     XML_TOK_FRAME_PLUGIN,
  85     XML_TOK_FRAME_FLOATING_FRAME,
  86     XML_TOK_FRAME_APPLET,
  87     XML_TOK_FRAME_TABLE
  88 };
  89
  90 enum SdXML3DSceneShapeElemTokenMap
  91 {
  92     XML_TOK_3DSCENE_3DSCENE,
  93     XML_TOK_3DSCENE_3DCUBE,
  94     XML_TOK_3DSCENE_3DSPHERE,
  95     XML_TOK_3DSCENE_3DLATHE,
  96     XML_TOK_3DSCENE_3DEXTRUDE
  97 };
  98
  99 enum SdXML3DObjectAttrTokenMap
 100 {
 101     XML_TOK_3DOBJECT_DRAWSTYLE_NAME,
 102     XML_TOK_3DOBJECT_TRANSFORM
 103 };
 104
 105 enum SdXML3DPolygonBasedAttrTokenMap
 106 {
 107     XML_TOK_3DPOLYGONBASED_VIEWBOX,
 108     XML_TOK_3DPOLYGONBASED_D
 109 };
 110
 111 enum SdXML3DCubeObjectAttrTokenMap
 112 {
 113     XML_TOK_3DCUBEOBJ_MINEDGE,
 114     XML_TOK_3DCUBEOBJ_MAXEDGE
 115 };
 116
 117 enum SdXML3DSphereObjectAttrTokenMap
 118 {
 119     XML_TOK_3DSPHEREOBJ_CENTER,
 120     XML_TOK_3DSPHEREOBJ_SIZE
 121 };
 122
 123 enum SdXML3DLightAttrTokenMap
 124 {
 125     XML_TOK_3DLIGHT_DIFFUSE_COLOR,
 126     XML_TOK_3DLIGHT_DIRECTION,
 127     XML_TOK_3DLIGHT_ENABLED,
 128     XML_TOK_3DLIGHT_SPECULAR
 129 };
 130
 131
 132 // dr3d:3dlight context
 133
 134 class SdXML3DLightContext final : public SvXMLImportContext
 135 {
 136     // local parameters which need to be read
 137     sal_Int32                   maDiffuseColor;
 138     ::basegfx::B3DVector        maDirection;
 139     bool                        mbEnabled;
 140     bool                        mbSpecular;
 141
 142 public:
 143     SdXML3DLightContext(
 144         SvXMLImport& rImport,
 145         const css::uno::Reference< css::xml::sax::XFastAttributeList >& xAttrList);
 146     virtual ~SdXML3DLightContext() override;
 147
 148     sal_Int32 GetDiffuseColor() const { return maDiffuseColor; }
 149     const ::basegfx::B3DVector& GetDirection() const { return maDirection; }
 150     bool GetEnabled() const { return mbEnabled; }
 151 };
 152
 153
 154 class SdXML3DSceneAttributesHelper
 155 {
 156 protected:
 157     SvXMLImport& mrImport;
 158
 159     // list for local light contexts
 160     ::std::vector< rtl::Reference< SdXML3DLightContext > >
 161                                 maList;
 162
 163     // local parameters which need to be read
 164     css::drawing::HomogenMatrix mxHomMat;
 165     bool                        mbSetTransform;
 166
 167     css::drawing::ProjectionMode mxPrjMode;
 168     sal_Int32                   mnDistance;
 169     sal_Int32                   mnFocalLength;
 170     sal_Int32                   mnShadowSlant;
 171     css::drawing::ShadeMode     mxShadeMode;
 172     sal_Int32                   maAmbientColor;
 173     bool                        mbLightingMode;
 174
 175     ::basegfx::B3DVector        maVRP;
 176     ::basegfx::B3DVector        maVPN;
 177     ::basegfx::B3DVector        maVUP;
 178     bool                        mbVRPUsed;
 179     bool                        mbVPNUsed;
 180     bool                        mbVUPUsed;
 181
 182 public:
 183     SdXML3DSceneAttributesHelper( SvXMLImport& rImporter );
 184
 185     /** creates a 3d light context and adds it to the internal list for later processing */
 186     SvXMLImportContext * create3DLightContext( const css::uno::Reference< css::xml::sax::XFastAttributeList >& xAttrList);
 187
 188     /** this should be called for each scene attribute */
 189     void processSceneAttribute( sal_uInt16 nPrefix, const OUString& rLocalName, const OUString& rValue );
 190
 191     /** this sets the scene attributes at this propertyset */
 192     void setSceneAttributes( const css::uno::Reference< css::beans::XPropertySet >& xPropSet );
 193 };
 194
 195
 196 class SvXMLShapeContext : public SvXMLImportContext
 197 {
 198 protected:
 199     css::uno::Reference< css::drawing::XShape >   mxShape;
 200     bool                                          mbTemporaryShape;
 201     OUString                                      msHyperlink;
 202
 203 public:
 204     SvXMLShapeContext( SvXMLImport& rImp, bool bTemporaryShape ) : SvXMLImportContext( rImp ), mbTemporaryShape(bTemporaryShape) {}
 205
 206
 207     const css::uno::Reference< css::drawing::XShape >& getShape() const { return mxShape; }
 208
 209     void setHyperlink( const OUString& rHyperlink );
 210 };
 211
 212
 213 struct XMLShapeImportHelperImpl;
 214 struct XMLShapeImportPageContextImpl;
 215 struct SdXMLEventContextData;
 216
 217 class XMLOFF_DLLPUBLIC XMLShapeImportHelper : public salhelper::SimpleReferenceObject
 218 {
 219     std::unique_ptr<XMLShapeImportHelperImpl> mpImpl;
 220
 221     std::shared_ptr<XMLShapeImportPageContextImpl> mpPageContext;
 222
 223     // PropertySetMappers and factory
 224     rtl::Reference<XMLSdPropHdlFactory>       mpSdPropHdlFactory;
 225     rtl::Reference<SvXMLImportPropertyMapper> mpPropertySetMapper;
 226     rtl::Reference<SvXMLImportPropertyMapper> mpPresPagePropsMapper;
 227
 228     // contexts for Style and AutoStyle import
 229     rtl::Reference<SvXMLStylesContext> mxStylesContext;
 230     rtl::Reference<SvXMLStylesContext> mxAutoStylesContext;
 231
 232     // contexts for xShape contents TokenMaps
 233     std::unique_ptr<SvXMLTokenMap>              mpGroupShapeElemTokenMap;
 234     std::unique_ptr<SvXMLTokenMap>              mpFrameShapeElemTokenMap;
 235     std::unique_ptr<SvXMLTokenMap>              mp3DSceneShapeElemTokenMap;
 236     std::unique_ptr<SvXMLTokenMap>              mp3DObjectAttrTokenMap;
 237     std::unique_ptr<SvXMLTokenMap>              mp3DPolygonBasedAttrTokenMap;
 238     std::unique_ptr<SvXMLTokenMap>              mp3DCubeObjectAttrTokenMap;
 239     std::unique_ptr<SvXMLTokenMap>              mp3DSphereObjectAttrTokenMap;
 240     std::unique_ptr<SvXMLTokenMap>              mp3DLightAttrTokenMap;
 241
 242     rtl::Reference< XMLTableImport > mxShapeTableImport;
 243
 244 protected:
 245     SvXMLImport& mrImporter;
 246
 247 public:
 248     XMLShapeImportHelper( SvXMLImport& rImporter,
 249         const css::uno::Reference< css::frame::XModel>& rModel,
 250     SvXMLImportPropertyMapper *pExtMapper=nullptr );
 251
 252     virtual ~XMLShapeImportHelper() override;
 253
 254     SvXMLShapeContext* CreateGroupChildContext(
 255         SvXMLImport& rImport, sal_uInt16 nPrefix, const OUString& rLocalName,
 256         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList,
 257         css::uno::Reference< css::drawing::XShapes > const & rShapes,
 258         bool bTemporaryShape = false);
 259
 260     SvXMLShapeContext* CreateFrameChildContext(
 261         SvXMLImport& rImport, sal_uInt16 nPrefix, const OUString& rLocalName,
 262         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList,
 263         css::uno::Reference< css::drawing::XShapes > const & rShapes,
 264         const css::uno::Reference< css::xml::sax::XAttributeList >& xFrameAttrList);
 265     static SvXMLImportContextRef CreateFrameChildContext(
 266         SvXMLImportContext *pThisContext, sal_uInt16 nPrefix, const OUString& rLocalName,
 267         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList );
 268
 269     SvXMLShapeContext* Create3DSceneChildContext(
 270         SvXMLImport& rImport, sal_uInt16 nPrefix, const OUString& rLocalName,
 271         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList,
 272         css::uno::Reference< css::drawing::XShapes > const & rShapes);
 273
 274     const SvXMLTokenMap& GetGroupShapeElemTokenMap();
 275     const SvXMLTokenMap& GetFrameShapeElemTokenMap();
 276     const SvXMLTokenMap& Get3DSceneShapeElemTokenMap();
 277     const SvXMLTokenMap& Get3DObjectAttrTokenMap();
 278     const SvXMLTokenMap& Get3DPolygonBasedAttrTokenMap();
 279     const SvXMLTokenMap& Get3DCubeObjectAttrTokenMap();
 280     const SvXMLTokenMap& Get3DSphereObjectAttrTokenMap();
 281     const SvXMLTokenMap& Get3DLightAttrTokenMap();
 282
 283     // Styles and AutoStyles contexts
 284     SvXMLStylesContext* GetStylesContext() const { return mxStylesContext.get(); }
 285     void SetStylesContext(SvXMLStylesContext* pNew);
 286     SvXMLStylesContext* GetAutoStylesContext() const { return mxAutoStylesContext.get(); }
 287     void SetAutoStylesContext(SvXMLStylesContext* pNew);
 288
 289     // get factories and mappers
 290     SvXMLImportPropertyMapper* GetPropertySetMapper() const { return mpPropertySetMapper.get(); }
 291     SvXMLImportPropertyMapper* GetPresPagePropsMapper() const { return mpPresPagePropsMapper.get(); }
 292
 293     // this function is called whenever the implementation classes like to add this new
 294     // shape to the given XShapes.
 295     virtual void addShape(
 296         css::uno::Reference< css::drawing::XShape >& rShape,
 297         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList,
 298         css::uno::Reference< css::drawing::XShapes >& rShapes);
 299
 300     // this function is called whenever the implementation classes have finished importing
 301     // a shape to the given XShapes. The shape is already inserted into its XShapes and
 302     // all properties and styles are set.
 303     virtual void finishShape(
 304         css::uno::Reference< css::drawing::XShape >& rShape,
 305         const css::uno::Reference< css::xml::sax::XAttributeList >& xAttrList,
 306         css::uno::Reference< css::drawing::XShapes >& rShapes);
 307
 308     // tdf#127791 help function for group shape events
 309     void addShapeEvents(SdXMLEventContextData& rData);
 310
 311     // helper functions processing groups after their component shapes are collected
 312     // e.g. for z-order sorting or adding events to the group
 313     void pushGroupForPostProcessing( css::uno::Reference< css::drawing::XShapes >& rShapes );
 314     void popGroupAndPostProcess();
 315
 316     void shapeWithZIndexAdded( css::uno::Reference< css::drawing::XShape > const & rShape,
 317                                sal_Int32 nZIndex );
 318     /// Updates the z-order of other shapes to be consistent again, needed due
 319     /// to the removal of rShape.
 320     void shapeRemoved(const css::uno::Reference<css::drawing::XShape>& rShape);
 321
 322     void addShapeConnection( css::uno::Reference< css::drawing::XShape > const & rConnectorShape,
 323                              bool bStart,
 324                              const OUString& rDestShapeId,
 325                              sal_Int32 nDestGlueId );
 326
 327     /** adds a mapping for a glue point identifier from an xml file to the identifier created after inserting
 328         the new glue point into the core. The saved mappings can be retrieved by getGluePointId() */
 329     void addGluePointMapping( css::uno::Reference< css::drawing::XShape > const & xShape,
 330                               sal_Int32 nSourceId, sal_Int32 nDestinnationId );
 331
 332     /** moves all current DestinationId's for rXShape by n */
 333     void moveGluePointMapping( const css::uno::Reference< css::drawing::XShape >& xShape, const sal_Int32 n );
 334
 335     /** retrieves a mapping for a glue point identifier from the current xml file to the identifier created after
 336         inserting the new glue point into the core. The mapping must be initialized first with addGluePointMapping() */
 337     sal_Int32 getGluePointId( const css::uno::Reference< css::drawing::XShape >& xShape, sal_Int32 nSourceId );
 338
 339     /** this method must be calling before the first shape is imported for the given page.
 340         Calls to this method can be nested */
 341     void startPage( css::uno::Reference< css::drawing::XShapes > const & rShapes );
 342
 343     /** this method must be calling after the last shape is imported for the given page
 344         Calls to this method can be nested */
 345     void endPage( css::uno::Reference< css::drawing::XShapes > const & rShapes );
 346
 347     void restoreConnections();
 348
 349     /** creates a property mapper for external chaining */
 350     static SvXMLImportPropertyMapper* CreateShapePropMapper(
 351         const css::uno::Reference< css::frame::XModel>& rModel, SvXMLImport& rImport );
 352
 353     /** defines if the import should increment the progress bar or not */
 354     void enableHandleProgressBar();
 355     bool IsHandleProgressBarEnabled() const;
 356
 357     /** queries the capability of the current model to create presentation shapes */
 358     bool IsPresentationShapesSupported() const;
 359
 360     XMLSdPropHdlFactory* GetSdPropHdlFactory() const { return mpSdPropHdlFactory.get(); }
 361
 362     const rtl::Reference< XMLTableImport >&     GetShapeTableImport();
 363 };
 364
 365 #endif // INCLUDED_XMLOFF_SHAPEIMPORT_HXX
 366
 367 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */