sketchup-api-stubs 0.6.1 → 0.7.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (149) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +2 -0
  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 -401
  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 -523
  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 -569
  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 -455
  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 -359
  26. data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +349 -349
  27. data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -123
  28. data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
  29. data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -86
  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 -563
  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 -547
  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 -554
  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 -1097
  76. data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +125 -125
  77. data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +544 -537
  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 -262
  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 -1483
  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 -282
  108. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
  109. data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +770 -650
  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 -356
  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 -995
  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 -303
  140. data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
  141. data/lib/sketchup-api-stubs/stubs/geom.rb +348 -233
  142. data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
  143. data/lib/sketchup-api-stubs/stubs/length.rb +278 -262
  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 -660
  149. metadata +2 -16
@@ -1,349 +1,349 @@
1
- # Copyright:: Copyright 2019 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