sketchup-api-stubs 0.7.9 → 0.7.11

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