sketchup-api-stubs 0.7.3 → 0.7.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (149) hide show
  1. checksums.yaml +5 -5
  2. data/.yardopts +9 -9
  3. data/lib/sketchup-api-stubs.rb +1 -1
  4. data/lib/sketchup-api-stubs/sketchup.rb +145 -145
  5. data/lib/sketchup-api-stubs/stubs/Geom/BoundingBox.rb +318 -318
  6. data/lib/sketchup-api-stubs/stubs/Geom/Bounds2d.rb +172 -172
  7. data/lib/sketchup-api-stubs/stubs/Geom/LatLong.rb +126 -126
  8. data/lib/sketchup-api-stubs/stubs/Geom/OrientedBounds2d.rb +102 -102
  9. data/lib/sketchup-api-stubs/stubs/Geom/Point2d.rb +400 -400
  10. data/lib/sketchup-api-stubs/stubs/Geom/Point3d.rb +661 -661
  11. data/lib/sketchup-api-stubs/stubs/Geom/PolygonMesh.rb +492 -492
  12. data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb +478 -478
  13. data/lib/sketchup-api-stubs/stubs/Geom/Transformation2d.rb +263 -263
  14. data/lib/sketchup-api-stubs/stubs/Geom/UTM.rb +141 -141
  15. data/lib/sketchup-api-stubs/stubs/Geom/Vector2d.rb +522 -522
  16. data/lib/sketchup-api-stubs/stubs/Geom/Vector3d.rb +691 -691
  17. data/lib/sketchup-api-stubs/stubs/Layout.rb +25 -25
  18. data/lib/sketchup-api-stubs/stubs/Layout/AngularDimension.rb +573 -573
  19. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinition.rb +411 -411
  20. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +174 -186
  21. data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
  22. data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +514 -514
  23. data/lib/sketchup-api-stubs/stubs/Layout/Ellipse.rb +29 -29
  24. data/lib/sketchup-api-stubs/stubs/Layout/Entities.rb +143 -155
  25. data/lib/sketchup-api-stubs/stubs/Layout/Entity.rb +353 -353
  26. data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +349 -349
  27. data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -311
  28. data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
  29. data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -91
  30. data/lib/sketchup-api-stubs/stubs/Layout/Label.rb +371 -371
  31. data/lib/sketchup-api-stubs/stubs/Layout/Layer.rb +218 -218
  32. data/lib/sketchup-api-stubs/stubs/Layout/LayerInstance.rb +128 -128
  33. data/lib/sketchup-api-stubs/stubs/Layout/Layers.rb +220 -232
  34. data/lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb +567 -567
  35. data/lib/sketchup-api-stubs/stubs/Layout/LockedEntityError.rb +10 -10
  36. data/lib/sketchup-api-stubs/stubs/Layout/LockedLayerError.rb +11 -11
  37. data/lib/sketchup-api-stubs/stubs/Layout/Page.rb +183 -183
  38. data/lib/sketchup-api-stubs/stubs/Layout/PageInfo.rb +387 -387
  39. data/lib/sketchup-api-stubs/stubs/Layout/Pages.rb +204 -216
  40. data/lib/sketchup-api-stubs/stubs/Layout/Path.rb +344 -344
  41. data/lib/sketchup-api-stubs/stubs/Layout/Rectangle.rb +174 -174
  42. data/lib/sketchup-api-stubs/stubs/Layout/SketchUpModel.rb +694 -694
  43. data/lib/sketchup-api-stubs/stubs/Layout/Style.rb +1519 -1519
  44. data/lib/sketchup-api-stubs/stubs/Layout/Table.rb +290 -290
  45. data/lib/sketchup-api-stubs/stubs/Layout/TableCell.rb +149 -149
  46. data/lib/sketchup-api-stubs/stubs/Layout/TableColumn.rb +139 -139
  47. data/lib/sketchup-api-stubs/stubs/Layout/TableRow.rb +135 -135
  48. data/lib/sketchup-api-stubs/stubs/Sketchup/Animation.rb +140 -140
  49. data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.rb +157 -157
  50. data/lib/sketchup-api-stubs/stubs/Sketchup/ArcCurve.rb +209 -209
  51. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionaries.rb +152 -152
  52. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionary.rb +281 -281
  53. data/lib/sketchup-api-stubs/stubs/Sketchup/Axes.rb +149 -149
  54. data/lib/sketchup-api-stubs/stubs/Sketchup/Behavior.rb +328 -328
  55. data/lib/sketchup-api-stubs/stubs/Sketchup/Camera.rb +577 -577
  56. data/lib/sketchup-api-stubs/stubs/Sketchup/ClassificationSchema.rb +63 -63
  57. data/lib/sketchup-api-stubs/stubs/Sketchup/Classifications.rb +122 -122
  58. data/lib/sketchup-api-stubs/stubs/Sketchup/Color.rb +281 -281
  59. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentDefinition.rb +562 -562
  60. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +593 -593
  61. data/lib/sketchup-api-stubs/stubs/Sketchup/Console.rb +76 -76
  62. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionLine.rb +257 -257
  63. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionPoint.rb +32 -32
  64. data/lib/sketchup-api-stubs/stubs/Sketchup/Curve.rb +194 -194
  65. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionList.rb +329 -329
  66. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionObserver.rb +72 -72
  67. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionsObserver.rb +102 -102
  68. data/lib/sketchup-api-stubs/stubs/Sketchup/Dimension.rb +165 -165
  69. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionLinear.rb +312 -312
  70. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionObserver.rb +38 -38
  71. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionRadial.rb +87 -87
  72. data/lib/sketchup-api-stubs/stubs/Sketchup/Drawingelement.rb +390 -390
  73. data/lib/sketchup-api-stubs/stubs/Sketchup/Edge.rb +508 -508
  74. data/lib/sketchup-api-stubs/stubs/Sketchup/EdgeUse.rb +211 -211
  75. data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb +1119 -1119
  76. data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +125 -125
  77. data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +544 -544
  78. data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb +59 -59
  79. data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb +125 -125
  80. data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb +750 -750
  81. data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +104 -104
  82. data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +697 -697
  83. data/lib/sketchup-api-stubs/stubs/Sketchup/Http.rb +27 -27
  84. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +285 -285
  85. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Response.rb +62 -62
  86. data/lib/sketchup-api-stubs/stubs/Sketchup/Image.rb +409 -409
  87. data/lib/sketchup-api-stubs/stubs/Sketchup/ImageRep.rb +226 -226
  88. data/lib/sketchup-api-stubs/stubs/Sketchup/Importer.rb +190 -190
  89. data/lib/sketchup-api-stubs/stubs/Sketchup/InputPoint.rb +393 -393
  90. data/lib/sketchup-api-stubs/stubs/Sketchup/InstanceObserver.rb +82 -82
  91. data/lib/sketchup-api-stubs/stubs/Sketchup/InstancePath.rb +303 -303
  92. data/lib/sketchup-api-stubs/stubs/Sketchup/Layer.rb +285 -280
  93. data/lib/sketchup-api-stubs/stubs/Sketchup/Layers.rb +244 -231
  94. data/lib/sketchup-api-stubs/stubs/Sketchup/LayersObserver.rb +136 -136
  95. data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing.rb +48 -48
  96. data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing/ExtensionLicense.rb +86 -86
  97. data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyle.rb +24 -24
  98. data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyles.rb +112 -123
  99. data/lib/sketchup-api-stubs/stubs/Sketchup/Loop.rb +137 -137
  100. data/lib/sketchup-api-stubs/stubs/Sketchup/Material.rb +416 -416
  101. data/lib/sketchup-api-stubs/stubs/Sketchup/Materials.rb +311 -311
  102. data/lib/sketchup-api-stubs/stubs/Sketchup/MaterialsObserver.rb +141 -141
  103. data/lib/sketchup-api-stubs/stubs/Sketchup/Menu.rb +95 -95
  104. data/lib/sketchup-api-stubs/stubs/Sketchup/Model.rb +1638 -1601
  105. data/lib/sketchup-api-stubs/stubs/Sketchup/ModelObserver.rb +356 -356
  106. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb +132 -132
  107. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb +284 -284
  108. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
  109. data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +770 -770
  110. data/lib/sketchup-api-stubs/stubs/Sketchup/Pages.rb +353 -353
  111. data/lib/sketchup-api-stubs/stubs/Sketchup/PagesObserver.rb +76 -76
  112. data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb +456 -456
  113. data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb +43 -43
  114. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb +364 -364
  115. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb +44 -44
  116. data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb +150 -150
  117. data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb +454 -454
  118. data/lib/sketchup-api-stubs/stubs/Sketchup/SelectionObserver.rb +115 -115
  119. data/lib/sketchup-api-stubs/stubs/Sketchup/Set.rb +212 -212
  120. data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfo.rb +257 -257
  121. data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfoObserver.rb +57 -57
  122. data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb +69 -69
  123. data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb +211 -211
  124. data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb +262 -262
  125. data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb +225 -225
  126. data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb +237 -237
  127. data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb +829 -829
  128. data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb +132 -132
  129. data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb +154 -154
  130. data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb +61 -61
  131. data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
  132. data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1301 -1301
  133. data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +43 -43
  134. data/lib/sketchup-api-stubs/stubs/UI/Command.rb +310 -310
  135. data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +356 -356
  136. data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +229 -229
  137. data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +240 -240
  138. data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +633 -633
  139. data/lib/sketchup-api-stubs/stubs/_top_level.rb +311 -311
  140. data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
  141. data/lib/sketchup-api-stubs/stubs/geom.rb +348 -348
  142. data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
  143. data/lib/sketchup-api-stubs/stubs/length.rb +278 -278
  144. data/lib/sketchup-api-stubs/stubs/numeric.rb +249 -249
  145. data/lib/sketchup-api-stubs/stubs/sketchup.rb +1310 -1310
  146. data/lib/sketchup-api-stubs/stubs/sketchupextension.rb +353 -353
  147. data/lib/sketchup-api-stubs/stubs/string.rb +24 -24
  148. data/lib/sketchup-api-stubs/stubs/ui.rb +667 -667
  149. metadata +3 -4
@@ -1,349 +1,349 @@
1
- # Copyright:: Copyright 2020 Trimble Inc.
2
- # License:: The MIT License (MIT)
3
-
4
- # A formatted text entity.
5
- #
6
- # @version LayOut 2018
7
- class Layout::FormattedText < Layout::Entity
8
-
9
- # Constants
10
-
11
- ANCHOR_TYPE_BOTTOM_CENTER = nil # Stub value.
12
- ANCHOR_TYPE_BOTTOM_LEFT = nil # Stub value.
13
- ANCHOR_TYPE_BOTTOM_RIGHT = nil # Stub value.
14
- ANCHOR_TYPE_CENTER_CENTER = nil # Stub value.
15
- ANCHOR_TYPE_CENTER_LEFT = nil # Stub value.
16
- ANCHOR_TYPE_CENTER_RIGHT = nil # Stub value.
17
- ANCHOR_TYPE_TOP_CENTER = nil # Stub value.
18
- ANCHOR_TYPE_TOP_LEFT = nil # Stub value.
19
- ANCHOR_TYPE_TOP_RIGHT = nil # Stub value.
20
-
21
- GROW_MODE_BOUNDED = nil # Stub value.
22
- GROW_MODE_UNBOUNDED = nil # Stub value.
23
-
24
- # Class Methods
25
-
26
- # The {.new_from_file} method creates a new {Layout::FormattedText} from a text
27
- # file.
28
- #
29
- # The anchor type can be one of the following values:
30
- # [+ANCHOR_TYPE_TOP_LEFT+]
31
- # [+ANCHOR_TYPE_CENTER_LEFT+]
32
- # [+ANCHOR_TYPE_BOTTOM_LEFT+]
33
- # [+ANCHOR_TYPE_TOP_RIGHT+]
34
- # [+ANCHOR_TYPE_CENTER_RIGHT+]
35
- # [+ANCHOR_TYPE_BOTTOM_RIGHT+]
36
- # [+ANCHOR_TYPE_TOP_CENTER+]
37
- # [+ANCHOR_TYPE_CENTER_CENTER+]
38
- # [+ANCHOR_TYPE_BOTTOM_CENTER+]
39
- #
40
- # @example
41
- # anchor = Geom::Point2d.new(1, 1)
42
- # text = Layout::FormattedText.new("C:/Test.txt", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
43
- #
44
- # @overload new_from_file(path, bounds)
45
- #
46
- # @param [String] path
47
- # @param [Geom::Bounds2d] bounds
48
- # @return [Layout::FormattedText]
49
- #
50
- # @overload new_from_file(path, anchor_point, anchor_type)
51
- #
52
- # @param [String] path
53
- # @param [Geom::Point2d] anchor_point The anchor point for the
54
- # {Layout::FormattedText}'s position.
55
- # @param [Integer] anchor_type Defines which point of the
56
- # {Layout::FormattedText} is set by anchor_point.
57
- # @return [Layout::FormattedText]
58
- #
59
- # @raise [ArgumentError] if the passed in string is empty
60
- #
61
- # @raise [ArgumentError] if bounds is zero size
62
- #
63
- # @raise [ArgumentError] if path does not refer to a valid file
64
- #
65
- # @version LayOut 2018
66
- def self.new_from_file(*args)
67
- end
68
-
69
- # Instance Methods
70
-
71
- # The {#append_plain_text} method appends new text with a given style to the
72
- # end of the existing plain text of the {Layout::FormattedText}.
73
- #
74
- # @example
75
- # anchor = Geom::Point2d.new(1, 1)
76
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
77
- # style = text.style(0)
78
- # text.append_plain_text("foo", style)
79
- #
80
- # @note This method does not support more than two different style runs in a
81
- # single text string.
82
- #
83
- # @param [String] plain_text
84
- #
85
- # @param [Layout::Style] style
86
- #
87
- # @raise [ArgumentError] if plain_text is empty
88
- #
89
- # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
90
- # {Layout::Layer}
91
- #
92
- # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
93
- #
94
- # @version LayOut 2018
95
- def append_plain_text(plain_text, style)
96
- end
97
-
98
- # The {#apply_style} method sets the {Layout::Style} for the text starting at
99
- # the given character index, and running for the given number of characters.
100
- #
101
- # @example
102
- # anchor = Geom::Point2d.new(1, 1)
103
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
104
- # style = text.style(0)
105
- # style.text_bold = true
106
- # text.apply_style(style, 2, 4)
107
- #
108
- # @param [Layout::Style] style
109
- #
110
- # @param [Integer] index
111
- #
112
- # @param [Integer] length
113
- #
114
- # @raise [IndexError] if index is out of range
115
- #
116
- # @raise [ArgumentError] if length is not greater than zero
117
- #
118
- # @raise [RangeError] if the range specified by index and length is not
119
- # valid for this {Layout::FormattedText}
120
- #
121
- # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
122
- # {Layout::Layer}
123
- #
124
- # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
125
- #
126
- # @version LayOut 2018
127
- def apply_style(style, index = 0, length = length_to_end_of_text)
128
- end
129
-
130
- # The {#display_text} method returns the display text representation of the
131
- # {Layout::FormattedText}.
132
- #
133
- # @example
134
- # anchor = Geom::Point2d.new(1, 1)
135
- # text = Layout::FormattedText.new("<PageNumber>", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
136
- # doc.add_entity(text, doc.layers.first, doc.pages.first)
137
- # text = text.display_text(doc.pages.first)
138
- #
139
- # @note Passing an invalid {Layout::Page} will prevent an auto text tag from
140
- # being substituted with its display representation.
141
- #
142
- # @param [Layout::Page] page
143
- # The {Layout::Page} to use to convert an auto text
144
- # tag to display text
145
- #
146
- # @raise [ArgumentError] if page is not in the same {Layout::Document} as
147
- # the {Layout::FormattedText}
148
- #
149
- # @return [String]
150
- #
151
- # @version LayOut 2018
152
- def display_text(page = nil)
153
- end
154
-
155
- # The {#grow_mode} method returns the mode for how the {Layout::FormattedText}
156
- # sizes itself.
157
- #
158
- # The grow mode can be one of the following values:
159
- # [+Layout::FormattedText::GROW_MODE_BOUNDED+]
160
- # [+Layout::FormattedText::GROW_MODE_UNBOUNDED+]
161
- #
162
- # @example
163
- # anchor = Geom::Point2d.new(1, 1)
164
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
165
- # mode = text.grow_mode
166
- #
167
- # @return [Integer] grow_mode
168
- #
169
- # @version LayOut 2018
170
- def grow_mode
171
- end
172
-
173
- # The {#grow_mode=} method sets the mode for how the {Layout::FormattedText}
174
- # sizes itself.
175
- #
176
- # The grow mode can be one of the following values:
177
- # [+Layout::FormattedText::GROW_MODE_BOUNDED+]
178
- # [+Layout::FormattedText::GROW_MODE_UNBOUNDED+]
179
- #
180
- # @example
181
- # anchor = Geom::Point2d.new(1, 1)
182
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
183
- # text.grow_mode = GROW_MODE_UNBOUNDED
184
- #
185
- # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
186
- # {Layout::Layer}
187
- #
188
- # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
189
- #
190
- # @raise [ArgumentError] if grow_mode is not a valid grow mode
191
- #
192
- # @return [Integer] grow_mode
193
- #
194
- # @version LayOut 2018
195
- def grow_mode=(grow_mode)
196
- end
197
-
198
- # The {#initialize} method creates a new {Layout::FormattedText}.
199
- #
200
- # The anchor type can be one of the following values:
201
- # [+ANCHOR_TYPE_TOP_LEFT+]
202
- # [+ANCHOR_TYPE_CENTER_LEFT+]
203
- # [+ANCHOR_TYPE_BOTTOM_LEFT+]
204
- # [+ANCHOR_TYPE_TOP_RIGHT+]
205
- # [+ANCHOR_TYPE_CENTER_RIGHT+]
206
- # [+ANCHOR_TYPE_BOTTOM_RIGHT+]
207
- # [+ANCHOR_TYPE_TOP_CENTER+]
208
- # [+ANCHOR_TYPE_CENTER_CENTER+]
209
- # [+ANCHOR_TYPE_BOTTOM_CENTER+]
210
- #
211
- # @example
212
- # anchor = Geom::Point2d.new(1, 1)
213
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
214
- #
215
- # @overload initialize(text, bounds)
216
- #
217
- # @param [String] text
218
- # @param [Geom::Bounds2d] bounds
219
- # @return [Layout::FormattedText]
220
- #
221
- # @overload initialize(text, anchor_point, anchor_type)
222
- #
223
- # @param [String] text
224
- # @param [Geom::Point2d] anchor_point The anchor point for the
225
- # {Layout::FormattedText}'s position.
226
- # @param [Integer] anchor_type Defines which point of the
227
- # {Layout::FormattedText} is set by anchor_point.
228
- # @return [Layout::FormattedText]
229
- #
230
- # @raise [ArgumentError] if the passed in string is empty
231
- #
232
- # @raise [ArgumentError] if bounds is zero size
233
- #
234
- # @version LayOut 2018
235
- def initialize(*args)
236
- end
237
-
238
- # The {#plain_text} method returns the plain text representation of the
239
- # {Layout::FormattedText}.
240
- #
241
- # @example
242
- # anchor = Geom::Point2d.new(1, 1)
243
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
244
- # text = text.plain_text
245
- #
246
- # @return [String]
247
- #
248
- # @version LayOut 2018
249
- def plain_text
250
- end
251
-
252
- # The {#plain_text=} method sets the plain text representation of the
253
- # {Layout::FormattedText}.
254
- #
255
- # @example
256
- # anchor = Geom::Point2d.new(1, 1)
257
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
258
- # text.plain_text = "foo"
259
- #
260
- # @param [String] plain_text
261
- #
262
- # @raise [ArgumentError] if plain_text is empty
263
- #
264
- # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
265
- # {Layout::Layer}
266
- #
267
- # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
268
- #
269
- # @version LayOut 2018
270
- def plain_text=(plain_text)
271
- end
272
-
273
- # The {#rtf} method returns the raw RTF representation of the
274
- # {Layout::FormattedText}.
275
- #
276
- # @example
277
- # anchor = Geom::Point2d.new(1, 1)
278
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
279
- # rtf_text = text.rtf
280
- #
281
- # @note Passing an invalid {Layout::Page} will prevent an auto text tag from
282
- # being substituted with its display representation.
283
- #
284
- # @overload rtf
285
- #
286
- # @return [String] The RTF text string. If the {Layout::FormattedText} is
287
- # auto text, this will be an auto text tag.
288
- #
289
- # @overload rtf(page)
290
- #
291
- # @param [Layout::Page] page The {Layout::Page} to use to convert an auto
292
- # text tag to display text
293
- # @return [String] The RTF text string. If the {Layout::FormattedText} is
294
- # auto text, this will be the display text.
295
- #
296
- # @raise [ArgumentError] if page is not in the same {Layout::Document} as
297
- # the {Layout::FormattedText}
298
- #
299
- # @version LayOut 2018
300
- def rtf(*args)
301
- end
302
-
303
- # The {#rtf=} method sets the raw RTF representation of the
304
- # {Layout::FormattedText}.
305
- #
306
- # @example
307
- # anchor = Geom::Point2d.new(1, 1)
308
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
309
- # text.rtf = "{\rtf1\ansi{\fonttbl\f0\fswiss Helvetica;}\f0\pard This is some {\b bold} text.\par}"
310
- #
311
- # @param [String] rtf_text
312
- #
313
- # @raise [ArgumentError] if rtf_text is an empty string
314
- #
315
- # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
316
- # {Layout::Layer}
317
- #
318
- # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
319
- #
320
- # @version LayOut 2018
321
- def rtf=(rtf_text)
322
- end
323
-
324
- # The {#style} method returns a {Layout::Style} for the text starting at the
325
- # given character index, and running for the given length.
326
- #
327
- # @example
328
- # anchor = Geom::Point2d.new(1, 1)
329
- # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
330
- # style = text.style(0)
331
- #
332
- # @param [Integer] index
333
- #
334
- # @param [Integer] length
335
- #
336
- # @raise [IndexError] if index is out of range
337
- #
338
- # @raise [ArgumentError] if length is not greater than zero
339
- #
340
- # @raise [RangeError] if the range specified by index and length is not
341
- # valid for this {Layout::FormattedText}
342
- #
343
- # @return [Layout::Style]
344
- #
345
- # @version LayOut 2018
346
- def style(index = 0, length = 1)
347
- end
348
-
349
- end
1
+ # Copyright:: Copyright 2020 Trimble Inc.
2
+ # License:: The MIT License (MIT)
3
+
4
+ # A formatted text entity.
5
+ #
6
+ # @version LayOut 2018
7
+ class Layout::FormattedText < Layout::Entity
8
+
9
+ # Constants
10
+
11
+ ANCHOR_TYPE_BOTTOM_CENTER = nil # Stub value.
12
+ ANCHOR_TYPE_BOTTOM_LEFT = nil # Stub value.
13
+ ANCHOR_TYPE_BOTTOM_RIGHT = nil # Stub value.
14
+ ANCHOR_TYPE_CENTER_CENTER = nil # Stub value.
15
+ ANCHOR_TYPE_CENTER_LEFT = nil # Stub value.
16
+ ANCHOR_TYPE_CENTER_RIGHT = nil # Stub value.
17
+ ANCHOR_TYPE_TOP_CENTER = nil # Stub value.
18
+ ANCHOR_TYPE_TOP_LEFT = nil # Stub value.
19
+ ANCHOR_TYPE_TOP_RIGHT = nil # Stub value.
20
+
21
+ GROW_MODE_BOUNDED = nil # Stub value.
22
+ GROW_MODE_UNBOUNDED = nil # Stub value.
23
+
24
+ # Class Methods
25
+
26
+ # The {.new_from_file} method creates a new {Layout::FormattedText} from a text
27
+ # file.
28
+ #
29
+ # The anchor type can be one of the following values:
30
+ # [+ANCHOR_TYPE_TOP_LEFT+]
31
+ # [+ANCHOR_TYPE_CENTER_LEFT+]
32
+ # [+ANCHOR_TYPE_BOTTOM_LEFT+]
33
+ # [+ANCHOR_TYPE_TOP_RIGHT+]
34
+ # [+ANCHOR_TYPE_CENTER_RIGHT+]
35
+ # [+ANCHOR_TYPE_BOTTOM_RIGHT+]
36
+ # [+ANCHOR_TYPE_TOP_CENTER+]
37
+ # [+ANCHOR_TYPE_CENTER_CENTER+]
38
+ # [+ANCHOR_TYPE_BOTTOM_CENTER+]
39
+ #
40
+ # @example
41
+ # anchor = Geom::Point2d.new(1, 1)
42
+ # text = Layout::FormattedText.new("C:/Test.txt", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
43
+ #
44
+ # @overload new_from_file(path, bounds)
45
+ #
46
+ # @param [String] path
47
+ # @param [Geom::Bounds2d] bounds
48
+ # @return [Layout::FormattedText]
49
+ #
50
+ # @overload new_from_file(path, anchor_point, anchor_type)
51
+ #
52
+ # @param [String] path
53
+ # @param [Geom::Point2d] anchor_point The anchor point for the
54
+ # {Layout::FormattedText}'s position.
55
+ # @param [Integer] anchor_type Defines which point of the
56
+ # {Layout::FormattedText} is set by anchor_point.
57
+ # @return [Layout::FormattedText]
58
+ #
59
+ # @raise [ArgumentError] if the passed in string is empty
60
+ #
61
+ # @raise [ArgumentError] if bounds is zero size
62
+ #
63
+ # @raise [ArgumentError] if path does not refer to a valid file
64
+ #
65
+ # @version LayOut 2018
66
+ def self.new_from_file(*args)
67
+ end
68
+
69
+ # Instance Methods
70
+
71
+ # The {#append_plain_text} method appends new text with a given style to the
72
+ # end of the existing plain text of the {Layout::FormattedText}.
73
+ #
74
+ # @example
75
+ # anchor = Geom::Point2d.new(1, 1)
76
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
77
+ # style = text.style(0)
78
+ # text.append_plain_text("foo", style)
79
+ #
80
+ # @note This method does not support more than two different style runs in a
81
+ # single text string.
82
+ #
83
+ # @param [String] plain_text
84
+ #
85
+ # @param [Layout::Style] style
86
+ #
87
+ # @raise [ArgumentError] if plain_text is empty
88
+ #
89
+ # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
90
+ # {Layout::Layer}
91
+ #
92
+ # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
93
+ #
94
+ # @version LayOut 2018
95
+ def append_plain_text(plain_text, style)
96
+ end
97
+
98
+ # The {#apply_style} method sets the {Layout::Style} for the text starting at
99
+ # the given character index, and running for the given number of characters.
100
+ #
101
+ # @example
102
+ # anchor = Geom::Point2d.new(1, 1)
103
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
104
+ # style = text.style(0)
105
+ # style.text_bold = true
106
+ # text.apply_style(style, 2, 4)
107
+ #
108
+ # @param [Layout::Style] style
109
+ #
110
+ # @param [Integer] index
111
+ #
112
+ # @param [Integer] length
113
+ #
114
+ # @raise [IndexError] if index is out of range
115
+ #
116
+ # @raise [ArgumentError] if length is not greater than zero
117
+ #
118
+ # @raise [RangeError] if the range specified by index and length is not
119
+ # valid for this {Layout::FormattedText}
120
+ #
121
+ # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
122
+ # {Layout::Layer}
123
+ #
124
+ # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
125
+ #
126
+ # @version LayOut 2018
127
+ def apply_style(style, index = 0, length = length_to_end_of_text)
128
+ end
129
+
130
+ # The {#display_text} method returns the display text representation of the
131
+ # {Layout::FormattedText}.
132
+ #
133
+ # @example
134
+ # anchor = Geom::Point2d.new(1, 1)
135
+ # text = Layout::FormattedText.new("<PageNumber>", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
136
+ # doc.add_entity(text, doc.layers.first, doc.pages.first)
137
+ # text = text.display_text(doc.pages.first)
138
+ #
139
+ # @note Passing an invalid {Layout::Page} will prevent an auto text tag from
140
+ # being substituted with its display representation.
141
+ #
142
+ # @param [Layout::Page] page
143
+ # The {Layout::Page} to use to convert an auto text
144
+ # tag to display text
145
+ #
146
+ # @raise [ArgumentError] if page is not in the same {Layout::Document} as
147
+ # the {Layout::FormattedText}
148
+ #
149
+ # @return [String]
150
+ #
151
+ # @version LayOut 2018
152
+ def display_text(page = nil)
153
+ end
154
+
155
+ # The {#grow_mode} method returns the mode for how the {Layout::FormattedText}
156
+ # sizes itself.
157
+ #
158
+ # The grow mode can be one of the following values:
159
+ # [+Layout::FormattedText::GROW_MODE_BOUNDED+]
160
+ # [+Layout::FormattedText::GROW_MODE_UNBOUNDED+]
161
+ #
162
+ # @example
163
+ # anchor = Geom::Point2d.new(1, 1)
164
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
165
+ # mode = text.grow_mode
166
+ #
167
+ # @return [Integer] grow_mode
168
+ #
169
+ # @version LayOut 2018
170
+ def grow_mode
171
+ end
172
+
173
+ # The {#grow_mode=} method sets the mode for how the {Layout::FormattedText}
174
+ # sizes itself.
175
+ #
176
+ # The grow mode can be one of the following values:
177
+ # [+Layout::FormattedText::GROW_MODE_BOUNDED+]
178
+ # [+Layout::FormattedText::GROW_MODE_UNBOUNDED+]
179
+ #
180
+ # @example
181
+ # anchor = Geom::Point2d.new(1, 1)
182
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
183
+ # text.grow_mode = GROW_MODE_UNBOUNDED
184
+ #
185
+ # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
186
+ # {Layout::Layer}
187
+ #
188
+ # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
189
+ #
190
+ # @raise [ArgumentError] if grow_mode is not a valid grow mode
191
+ #
192
+ # @return [Integer] grow_mode
193
+ #
194
+ # @version LayOut 2018
195
+ def grow_mode=(grow_mode)
196
+ end
197
+
198
+ # The {#initialize} method creates a new {Layout::FormattedText}.
199
+ #
200
+ # The anchor type can be one of the following values:
201
+ # [+ANCHOR_TYPE_TOP_LEFT+]
202
+ # [+ANCHOR_TYPE_CENTER_LEFT+]
203
+ # [+ANCHOR_TYPE_BOTTOM_LEFT+]
204
+ # [+ANCHOR_TYPE_TOP_RIGHT+]
205
+ # [+ANCHOR_TYPE_CENTER_RIGHT+]
206
+ # [+ANCHOR_TYPE_BOTTOM_RIGHT+]
207
+ # [+ANCHOR_TYPE_TOP_CENTER+]
208
+ # [+ANCHOR_TYPE_CENTER_CENTER+]
209
+ # [+ANCHOR_TYPE_BOTTOM_CENTER+]
210
+ #
211
+ # @example
212
+ # anchor = Geom::Point2d.new(1, 1)
213
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
214
+ #
215
+ # @overload initialize(text, bounds)
216
+ #
217
+ # @param [String] text
218
+ # @param [Geom::Bounds2d] bounds
219
+ # @return [Layout::FormattedText]
220
+ #
221
+ # @overload initialize(text, anchor_point, anchor_type)
222
+ #
223
+ # @param [String] text
224
+ # @param [Geom::Point2d] anchor_point The anchor point for the
225
+ # {Layout::FormattedText}'s position.
226
+ # @param [Integer] anchor_type Defines which point of the
227
+ # {Layout::FormattedText} is set by anchor_point.
228
+ # @return [Layout::FormattedText]
229
+ #
230
+ # @raise [ArgumentError] if the passed in string is empty
231
+ #
232
+ # @raise [ArgumentError] if bounds is zero size
233
+ #
234
+ # @version LayOut 2018
235
+ def initialize(*args)
236
+ end
237
+
238
+ # The {#plain_text} method returns the plain text representation of the
239
+ # {Layout::FormattedText}.
240
+ #
241
+ # @example
242
+ # anchor = Geom::Point2d.new(1, 1)
243
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
244
+ # text = text.plain_text
245
+ #
246
+ # @return [String]
247
+ #
248
+ # @version LayOut 2018
249
+ def plain_text
250
+ end
251
+
252
+ # The {#plain_text=} method sets the plain text representation of the
253
+ # {Layout::FormattedText}.
254
+ #
255
+ # @example
256
+ # anchor = Geom::Point2d.new(1, 1)
257
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
258
+ # text.plain_text = "foo"
259
+ #
260
+ # @param [String] plain_text
261
+ #
262
+ # @raise [ArgumentError] if plain_text is empty
263
+ #
264
+ # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
265
+ # {Layout::Layer}
266
+ #
267
+ # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
268
+ #
269
+ # @version LayOut 2018
270
+ def plain_text=(plain_text)
271
+ end
272
+
273
+ # The {#rtf} method returns the raw RTF representation of the
274
+ # {Layout::FormattedText}.
275
+ #
276
+ # @example
277
+ # anchor = Geom::Point2d.new(1, 1)
278
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
279
+ # rtf_text = text.rtf
280
+ #
281
+ # @note Passing an invalid {Layout::Page} will prevent an auto text tag from
282
+ # being substituted with its display representation.
283
+ #
284
+ # @overload rtf
285
+ #
286
+ # @return [String] The RTF text string. If the {Layout::FormattedText} is
287
+ # auto text, this will be an auto text tag.
288
+ #
289
+ # @overload rtf(page)
290
+ #
291
+ # @param [Layout::Page] page The {Layout::Page} to use to convert an auto
292
+ # text tag to display text
293
+ # @return [String] The RTF text string. If the {Layout::FormattedText} is
294
+ # auto text, this will be the display text.
295
+ #
296
+ # @raise [ArgumentError] if page is not in the same {Layout::Document} as
297
+ # the {Layout::FormattedText}
298
+ #
299
+ # @version LayOut 2018
300
+ def rtf(*args)
301
+ end
302
+
303
+ # The {#rtf=} method sets the raw RTF representation of the
304
+ # {Layout::FormattedText}.
305
+ #
306
+ # @example
307
+ # anchor = Geom::Point2d.new(1, 1)
308
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
309
+ # text.rtf = "{\rtf1\ansi{\fonttbl\f0\fswiss Helvetica;}\f0\pard This is some {\b bold} text.\par}"
310
+ #
311
+ # @param [String] rtf_text
312
+ #
313
+ # @raise [ArgumentError] if rtf_text is an empty string
314
+ #
315
+ # @raise [LockedLayerError] if the {Layout::FormattedText} is on a locked
316
+ # {Layout::Layer}
317
+ #
318
+ # @raise [LockedEntityError] if the {Layout::FormattedText} is locked
319
+ #
320
+ # @version LayOut 2018
321
+ def rtf=(rtf_text)
322
+ end
323
+
324
+ # The {#style} method returns a {Layout::Style} for the text starting at the
325
+ # given character index, and running for the given length.
326
+ #
327
+ # @example
328
+ # anchor = Geom::Point2d.new(1, 1)
329
+ # text = Layout::FormattedText.new("Test", anchor, Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT)
330
+ # style = text.style(0)
331
+ #
332
+ # @param [Integer] index
333
+ #
334
+ # @param [Integer] length
335
+ #
336
+ # @raise [IndexError] if index is out of range
337
+ #
338
+ # @raise [ArgumentError] if length is not greater than zero
339
+ #
340
+ # @raise [RangeError] if the range specified by index and length is not
341
+ # valid for this {Layout::FormattedText}
342
+ #
343
+ # @return [Layout::Style]
344
+ #
345
+ # @version LayOut 2018
346
+ def style(index = 0, length = 1)
347
+ end
348
+
349
+ end