include/svx/e3dsceneupdater.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_SVX_E3DSCENEUPDATER_HXX
  21 #define INCLUDED_SVX_E3DSCENEUPDATER_HXX
  22
  23 #include <svx/svxdllapi.h>
  24 #include <memory>
  25
  26 class SdrObject;
  27 class E3dScene;
  28
  29 namespace drawinglayer::geometry
  30 {
  31 class ViewInformation3D;
  32 }
  33
  34 /** Helper for 3d object changes affecting 2d geometry
  35
  36    This class is a helper to encapsulate 3D object changes which shall
  37    change the scene's 2D geometry. E.g. when moving one 3D object in a
  38    scene, the visualisation would not change since the scene's 2D
  39    attributes are defined by its 2D object transformation and the
  40    changed content would be projected to the same 2D bounds as
  41    before. To reflect the fact that the 2D positions may 'change' for
  42    the user's imagination, it is necessary to calculate a new 2D
  43    object transformation of the scene (the SnapRect) using the old 3D
  44    transformation stack and the possibly modified 3D content and to
  45    use it. This is only desirable if changes to the scene's content
  46    are intended to change the scene's 2D geometry attributes
  47 */
  48 class SVXCORE_DLLPUBLIC E3DModifySceneSnapRectUpdater
  49 {
  50     // the scene which may be changed. This gets set to the outmost scene
  51     // of the to-be-changed 3D object when the scene has a 3d transformation
  52     // stack at construction time. In all other cases it's set to zero and
  53     // no action needs to be taken
  54     E3dScene* mpScene;
  55
  56     // the 3d transformation stack at the time of construction, valid when
  57     // mpScene is not zero
  58     std::unique_ptr<drawinglayer::geometry::ViewInformation3D> mpViewInformation3D;
  59
  60 public:
  61     // the constructor evaluates and sets the members at construction time
  62     E3DModifySceneSnapRectUpdater(const SdrObject* mpObject);
  63
  64     // the destructor will take action if mpScene is not zero and modify the
  65     // 2D geometry of the target scene
  66     ~E3DModifySceneSnapRectUpdater();
  67 };
  68
  69 #endif // INCLUDED_SVX_E3DSCENEUPDATER_HXX
  70
  71 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */