zjf
2023-03-06 392b76515f40376b6d36f40a114850ef63650384
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/////////////////////////////////////////////////////////////////////////////// 
// Copyright (C) 2002-2016, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Teigha(R) software pursuant to a license 
//   agreement with Open Design Alliance.
//   Teigha(R) Copyright (C) 2002-2016 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
///////////////////////////////////////////////////////////////////////////////
 
#ifndef _DbLayoutPaperPE_h_Included_
#define _DbLayoutPaperPE_h_Included_
 
#include "SmartPtr.h"
 
class OdDbLayout;
class OdGePoint3d;
 
/** \details
    This class is the Protocol Extension class for OdDbLayout objects.
    
    \remarks
    The Protocol Extension class can be registered on the OdDbLayout class 
    to provide a vectorization client the opportunity to customize the drawing
    of the background paper during PaperSpace vectorization.
    
    \sa
    TD_Db
 
    <group OdDb_Classes> 
*/
class TOOLKIT_EXPORT OdDbLayoutPaperPE : public OdRxObject
{
public:
  ODRX_DECLARE_MEMBERS(OdDbLayoutPaperPE);
 
  /** \details
      This function is called during vectorization to draw the paper.  
 
      \param pThis [in]  The layout that is being vectorized.
      \param pWd [in/out] Draw object that can be used by this function to set the 
        necessary attributes and create the necessary geometry.
      \param points [in] Contains the 4 corners of the paper.
 
      \returns
      true if the paper was successfully drawn, otherwise false, in which case
      the layout will do a default rendering of the paper.
  */
  virtual bool drawPaper(const OdDbLayout* pThis, OdGiWorldDraw* pWd, OdGePoint3d* points) = 0;
 
  /** \details
      This function is called during vectorization to draw the paper border.
 
      \param pThis [in]  The layout that is being vectorized.
      \param pWd [in/out] Draw object that can be used by this function to set the 
        necessary attributes and create the necessary geometry.
      \param points [in] Contains the 4 corners of the paper.
 
      \returns
      true if the border was successfully drawn, otherwise false, in which case
      the layout will do a default rendering of the border.
  */
  virtual bool drawBorder(const OdDbLayout* pThis, OdGiWorldDraw* pWd, OdGePoint3d* points) = 0;
 
  /** \details
      This function is called during vectorization to draw the paper margins.
 
      \param pThis [in]  The layout that is being vectorized.
      \param pWd [in/out] Draw object that can be used by this function to set the 
        necessary attributes and create the necessary geometry.
      \param points [in] Contains the 4 margin points.
 
      \returns
      true if the margins were successfully drawn, otherwise false, in which case
      the layout will do a default rendering of the margins.
  */
  virtual bool drawMargins(const OdDbLayout* pThis, OdGiWorldDraw* pWd, OdGePoint3d* points) = 0;
};
 
/** \details
    This template class is a specialization of the OdSmartPtr class for OdDbLayoutPaperPE object pointers.
*/
typedef OdSmartPtr<OdDbLayoutPaperPE> OdDbLayoutPaperPEPtr;
 
#endif //_DbLayoutPaperPE_h_Included_