sketchup-api-stubs 0.7.7 → 0.7.9
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.
- checksums.yaml +4 -4
- data/lib/sketchup-api-stubs/sketchup.rb +151 -147
- data/lib/sketchup-api-stubs/stubs/{array.rb → Array.rb} +741 -741
- data/lib/sketchup-api-stubs/stubs/Geom/BoundingBox.rb +322 -322
- data/lib/sketchup-api-stubs/stubs/Geom/Bounds2d.rb +172 -172
- data/lib/sketchup-api-stubs/stubs/Geom/LatLong.rb +126 -126
- data/lib/sketchup-api-stubs/stubs/Geom/OrientedBounds2d.rb +102 -102
- data/lib/sketchup-api-stubs/stubs/Geom/Point2d.rb +400 -400
- data/lib/sketchup-api-stubs/stubs/Geom/Point3d.rb +661 -661
- data/lib/sketchup-api-stubs/stubs/Geom/PolygonMesh.rb +509 -509
- data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb +476 -478
- data/lib/sketchup-api-stubs/stubs/Geom/Transformation2d.rb +263 -263
- data/lib/sketchup-api-stubs/stubs/Geom/UTM.rb +141 -141
- data/lib/sketchup-api-stubs/stubs/Geom/Vector2d.rb +522 -522
- data/lib/sketchup-api-stubs/stubs/Geom/Vector3d.rb +693 -691
- data/lib/sketchup-api-stubs/stubs/{geom.rb → Geom.rb} +351 -351
- data/lib/sketchup-api-stubs/stubs/{languagehandler.rb → LanguageHandler.rb} +93 -92
- data/lib/sketchup-api-stubs/stubs/Layout/AngularDimension.rb +595 -573
- data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinition.rb +747 -411
- data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +183 -179
- data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
- data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +517 -515
- data/lib/sketchup-api-stubs/stubs/Layout/Ellipse.rb +29 -29
- data/lib/sketchup-api-stubs/stubs/Layout/Entities.rb +148 -148
- data/lib/sketchup-api-stubs/stubs/Layout/Entity.rb +353 -353
- data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +354 -349
- data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -311
- data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
- data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -91
- data/lib/sketchup-api-stubs/stubs/Layout/Label.rb +370 -370
- data/lib/sketchup-api-stubs/stubs/Layout/Layer.rb +218 -218
- data/lib/sketchup-api-stubs/stubs/Layout/LayerInstance.rb +128 -128
- data/lib/sketchup-api-stubs/stubs/Layout/Layers.rb +225 -225
- data/lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb +567 -567
- data/lib/sketchup-api-stubs/stubs/Layout/LockedEntityError.rb +10 -10
- data/lib/sketchup-api-stubs/stubs/Layout/LockedLayerError.rb +11 -11
- data/lib/sketchup-api-stubs/stubs/Layout/Page.rb +183 -183
- data/lib/sketchup-api-stubs/stubs/Layout/PageInfo.rb +387 -387
- data/lib/sketchup-api-stubs/stubs/Layout/Pages.rb +209 -209
- data/lib/sketchup-api-stubs/stubs/Layout/Path.rb +344 -344
- data/lib/sketchup-api-stubs/stubs/Layout/Rectangle.rb +174 -174
- data/lib/sketchup-api-stubs/stubs/Layout/ReferenceEntity.rb +82 -0
- data/lib/sketchup-api-stubs/stubs/Layout/SketchUpModel.rb +692 -694
- data/lib/sketchup-api-stubs/stubs/Layout/Style.rb +1519 -1519
- data/lib/sketchup-api-stubs/stubs/Layout/Table.rb +290 -290
- data/lib/sketchup-api-stubs/stubs/Layout/TableCell.rb +149 -149
- data/lib/sketchup-api-stubs/stubs/Layout/TableColumn.rb +139 -139
- data/lib/sketchup-api-stubs/stubs/Layout/TableRow.rb +135 -135
- data/lib/sketchup-api-stubs/stubs/Layout.rb +25 -25
- data/lib/sketchup-api-stubs/stubs/{length.rb → Length.rb} +278 -278
- data/lib/sketchup-api-stubs/stubs/{numeric.rb → Numeric.rb} +249 -249
- data/lib/sketchup-api-stubs/stubs/Sketchup/Animation.rb +144 -144
- data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.rb +169 -157
- data/lib/sketchup-api-stubs/stubs/Sketchup/ArcCurve.rb +209 -209
- data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionaries.rb +150 -152
- data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionary.rb +281 -286
- data/lib/sketchup-api-stubs/stubs/Sketchup/Axes.rb +149 -149
- data/lib/sketchup-api-stubs/stubs/Sketchup/Behavior.rb +302 -302
- data/lib/sketchup-api-stubs/stubs/Sketchup/Camera.rb +478 -478
- data/lib/sketchup-api-stubs/stubs/Sketchup/ClassificationSchema.rb +63 -63
- data/lib/sketchup-api-stubs/stubs/Sketchup/Classifications.rb +121 -122
- data/lib/sketchup-api-stubs/stubs/Sketchup/Color.rb +294 -294
- data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentDefinition.rb +659 -577
- data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +593 -594
- data/lib/sketchup-api-stubs/stubs/Sketchup/Console.rb +76 -76
- data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionLine.rb +257 -257
- data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionPoint.rb +32 -32
- data/lib/sketchup-api-stubs/stubs/Sketchup/Curve.rb +201 -201
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionList.rb +449 -425
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionObserver.rb +74 -74
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionsObserver.rb +104 -104
- data/lib/sketchup-api-stubs/stubs/Sketchup/Dimension.rb +165 -165
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionLinear.rb +306 -306
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionObserver.rb +42 -42
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionRadial.rb +87 -87
- data/lib/sketchup-api-stubs/stubs/Sketchup/Drawingelement.rb +406 -396
- data/lib/sketchup-api-stubs/stubs/Sketchup/Edge.rb +397 -502
- data/lib/sketchup-api-stubs/stubs/Sketchup/EdgeUse.rb +211 -211
- data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb +1239 -1126
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesBuilder.rb +261 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +127 -127
- data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +545 -545
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb +60 -60
- data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb +125 -126
- data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb +937 -917
- data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +102 -104
- data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +750 -750
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +282 -292
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Response.rb +62 -62
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http.rb +27 -27
- data/lib/sketchup-api-stubs/stubs/Sketchup/Image.rb +468 -468
- data/lib/sketchup-api-stubs/stubs/Sketchup/ImageRep.rb +266 -266
- data/lib/sketchup-api-stubs/stubs/Sketchup/Importer.rb +189 -189
- data/lib/sketchup-api-stubs/stubs/Sketchup/InputPoint.rb +406 -405
- data/lib/sketchup-api-stubs/stubs/Sketchup/InstanceObserver.rb +84 -84
- data/lib/sketchup-api-stubs/stubs/Sketchup/InstancePath.rb +306 -306
- data/lib/sketchup-api-stubs/stubs/Sketchup/Layer.rb +326 -327
- data/lib/sketchup-api-stubs/stubs/Sketchup/LayerFolder.rb +422 -422
- data/lib/sketchup-api-stubs/stubs/Sketchup/Layers.rb +427 -427
- data/lib/sketchup-api-stubs/stubs/Sketchup/LayersObserver.rb +249 -249
- data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing/ExtensionLicense.rb +86 -86
- data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing.rb +48 -48
- data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyle.rb +24 -24
- data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyles.rb +114 -112
- data/lib/sketchup-api-stubs/stubs/Sketchup/Loop.rb +137 -137
- data/lib/sketchup-api-stubs/stubs/Sketchup/Material.rb +414 -414
- data/lib/sketchup-api-stubs/stubs/Sketchup/Materials.rb +317 -318
- data/lib/sketchup-api-stubs/stubs/Sketchup/MaterialsObserver.rb +142 -142
- data/lib/sketchup-api-stubs/stubs/Sketchup/Menu.rb +93 -93
- data/lib/sketchup-api-stubs/stubs/Sketchup/Model.rb +1652 -1654
- data/lib/sketchup-api-stubs/stubs/Sketchup/ModelObserver.rb +357 -357
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb +130 -131
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb +271 -284
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
- data/lib/sketchup-api-stubs/stubs/Sketchup/Overlay.rb +490 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/OverlaysManager.rb +116 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +797 -797
- data/lib/sketchup-api-stubs/stubs/Sketchup/Pages.rb +361 -363
- data/lib/sketchup-api-stubs/stubs/Sketchup/PagesObserver.rb +77 -77
- data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb +478 -478
- data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb +43 -43
- data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb +361 -364
- data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb +45 -45
- data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb +150 -150
- data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb +458 -459
- data/lib/sketchup-api-stubs/stubs/Sketchup/SelectionObserver.rb +115 -115
- data/lib/sketchup-api-stubs/stubs/Sketchup/Set.rb +212 -212
- data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfo.rb +255 -257
- data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfoObserver.rb +59 -59
- data/lib/sketchup-api-stubs/stubs/Sketchup/Skp.rb +40 -40
- data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb +69 -69
- data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb +217 -217
- data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb +262 -262
- data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb +217 -217
- data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb +237 -237
- data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb +834 -835
- data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb +132 -132
- data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb +156 -156
- data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb +75 -71
- data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
- data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1311 -1307
- data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +45 -45
- data/lib/sketchup-api-stubs/stubs/{sketchup.rb → Sketchup.rb} +1377 -1353
- data/lib/sketchup-api-stubs/stubs/{sketchupextension.rb → SketchupExtension.rb} +353 -353
- data/lib/sketchup-api-stubs/stubs/{string.rb → String.rb} +24 -24
- data/lib/sketchup-api-stubs/stubs/UI/Command.rb +389 -317
- data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +494 -478
- data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +269 -269
- data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +241 -240
- data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +635 -633
- data/lib/sketchup-api-stubs/stubs/{ui.rb → UI.rb} +683 -672
- data/lib/sketchup-api-stubs/stubs/_top_level.rb +303 -311
- data/lib/sketchup-api-stubs.rb +1 -1
- metadata +20 -16
@@ -1,262 +1,262 @@
|
|
1
|
-
# Copyright:: Copyright
|
2
|
-
# License:: The MIT License (MIT)
|
3
|
-
|
4
|
-
# The Text class contains method to manipulate a Text entity object.
|
5
|
-
#
|
6
|
-
# @version SketchUp 6.0
|
7
|
-
class Sketchup::Text < Sketchup::Drawingelement
|
8
|
-
|
9
|
-
# Instance Methods
|
10
|
-
|
11
|
-
# The arrow_type method retrieves the current arrow type used for the leader
|
12
|
-
# text.
|
13
|
-
#
|
14
|
-
# Valid arrow types are 0 for none, 2 for dot, 3 for closed arrow, 4 for open
|
15
|
-
# arrow.
|
16
|
-
#
|
17
|
-
# @example
|
18
|
-
# type = text.arrow_type=0
|
19
|
-
#
|
20
|
-
# @return [Integer] a numerical representation for the type of
|
21
|
-
# arrow.
|
22
|
-
#
|
23
|
-
# @version SketchUp 6.0
|
24
|
-
def arrow_type
|
25
|
-
end
|
26
|
-
|
27
|
-
# The arrow_type= method sets the arrow type used for leader text.
|
28
|
-
#
|
29
|
-
# Valid arrow types are 0 for none, 2 for dot, 3 for closed arrow, 4 for open
|
30
|
-
# arrow.
|
31
|
-
#
|
32
|
-
# @example
|
33
|
-
# arrow = text.arrow_type=type
|
34
|
-
#
|
35
|
-
# @param [Integer] type
|
36
|
-
# A numerical representation of the type of arrow to be
|
37
|
-
# set.
|
38
|
-
#
|
39
|
-
# @return [Integer] a numerical representation for the type of
|
40
|
-
# arrow.
|
41
|
-
#
|
42
|
-
# @version SketchUp 6.0
|
43
|
-
def arrow_type=(type)
|
44
|
-
end
|
45
|
-
|
46
|
-
# The {#attached_to} method returns an array of the attached
|
47
|
-
# {Sketchup::InstancePath} object and the {Geom::Point3d}.
|
48
|
-
#
|
49
|
-
# @example
|
50
|
-
# # Have a text annotation attached to a drawing element and selected
|
51
|
-
# Sketchup.active_model.selection[0].attached_to
|
52
|
-
#
|
53
|
-
# @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
|
54
|
-
#
|
55
|
-
# @version SketchUp 2019
|
56
|
-
def attached_to
|
57
|
-
end
|
58
|
-
|
59
|
-
# The {#attached_to=} method will attach the {Sketchup::Text} to another
|
60
|
-
# {Sketchup::DrawingElement}.
|
61
|
-
#
|
62
|
-
# @example
|
63
|
-
# # Have a text annotation attached to a drawing element and selected
|
64
|
-
# array = Sketchup.active_model.selection[0].attached_to
|
65
|
-
# Sketchup.active_model.selection[0].attached_to = [array[0], Geom::Point3d.new(0, 0, 0)]
|
66
|
-
#
|
67
|
-
# @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
|
68
|
-
#
|
69
|
-
# @version SketchUp 2019
|
70
|
-
def attached_to=(path)
|
71
|
-
end
|
72
|
-
|
73
|
-
# The display_leader= method accepts true or false for whether to display the
|
74
|
-
# leader.
|
75
|
-
#
|
76
|
-
# Leader text that is not displayed is set to Hidden type.
|
77
|
-
#
|
78
|
-
# @example
|
79
|
-
# leader = text.display_leader=true
|
80
|
-
#
|
81
|
-
# @param [Boolean] status
|
82
|
-
# true if you want to display the leader text, false if
|
83
|
-
# you do not want to display the leader text.
|
84
|
-
#
|
85
|
-
# @return [Boolean] the status that you set.
|
86
|
-
#
|
87
|
-
# @version SketchUp 6.0
|
88
|
-
def display_leader=(status)
|
89
|
-
end
|
90
|
-
|
91
|
-
# The display_leader? method returns the status of the leader.
|
92
|
-
#
|
93
|
-
# @example
|
94
|
-
# status = text.display_leader
|
95
|
-
#
|
96
|
-
# @return [Boolean]
|
97
|
-
#
|
98
|
-
# @version SketchUp 6.0
|
99
|
-
def display_leader?
|
100
|
-
end
|
101
|
-
|
102
|
-
# The has_leader method is used to determine if the Text object has a leader.
|
103
|
-
#
|
104
|
-
# @example
|
105
|
-
# status = text.has_leader
|
106
|
-
#
|
107
|
-
# @return [Boolean]
|
108
|
-
#
|
109
|
-
# @version SketchUp 6.0
|
110
|
-
def has_leader?
|
111
|
-
end
|
112
|
-
|
113
|
-
# The leader_type method retrieves the currently set leader type.
|
114
|
-
#
|
115
|
-
# @example
|
116
|
-
# leader = text.leader_type
|
117
|
-
#
|
118
|
-
# @return [Integer] a numerical value representing the currently
|
119
|
-
# set leader type.
|
120
|
-
#
|
121
|
-
# @version SketchUp 6.0
|
122
|
-
def leader_type
|
123
|
-
end
|
124
|
-
|
125
|
-
# The leader_type = method sets the leader type.
|
126
|
-
#
|
127
|
-
# Valid leader types are 0 for none, 1 for View-based, and 2 for Pushpin
|
128
|
-
#
|
129
|
-
# @example
|
130
|
-
# leader = text.leader_type=1
|
131
|
-
#
|
132
|
-
# @param [Integer] type
|
133
|
-
# A numerical value representing the leader type to be
|
134
|
-
# set.
|
135
|
-
#
|
136
|
-
# @return [Integer] a numerical value representing the leader type
|
137
|
-
# you just set.
|
138
|
-
#
|
139
|
-
# @version SketchUp 6.0
|
140
|
-
def leader_type=(type)
|
141
|
-
end
|
142
|
-
|
143
|
-
# The line_weight method returns a line weight in number of pixels.
|
144
|
-
#
|
145
|
-
# Defalt line weight is 1.
|
146
|
-
#
|
147
|
-
# @example
|
148
|
-
# weight = text.line_weight
|
149
|
-
#
|
150
|
-
# @return [Integer] the line weight in pixels
|
151
|
-
#
|
152
|
-
# @version SketchUp 6.0
|
153
|
-
def line_weight
|
154
|
-
end
|
155
|
-
|
156
|
-
# The line_weight= method sets the line weight in pixels.
|
157
|
-
#
|
158
|
-
# Default line weight is 1.
|
159
|
-
#
|
160
|
-
# @example
|
161
|
-
# newweight = text.line_weight = 4
|
162
|
-
#
|
163
|
-
# @param [Integer] weight
|
164
|
-
# The line weight to be set (in pixels).
|
165
|
-
#
|
166
|
-
# @return [Integer] The line weight that has been set.
|
167
|
-
#
|
168
|
-
# @version SketchUp 6.0
|
169
|
-
def line_weight=(weight)
|
170
|
-
end
|
171
|
-
|
172
|
-
# The point method is used to get the point associated with the text.
|
173
|
-
#
|
174
|
-
# @example
|
175
|
-
# point3d = text.point
|
176
|
-
#
|
177
|
-
# @return [Geom::Point3d] a Point3d object.
|
178
|
-
#
|
179
|
-
# @version SketchUp 6.0
|
180
|
-
def point
|
181
|
-
end
|
182
|
-
|
183
|
-
# The point= method is used to set the point associated with the text.
|
184
|
-
#
|
185
|
-
# @example
|
186
|
-
# status = text.point = point3d
|
187
|
-
#
|
188
|
-
# @param [Geom::Point3d] point3d
|
189
|
-
# A Point3d object.
|
190
|
-
#
|
191
|
-
# @return [Geom::Point3d] true if successful, false if unsuccessful.
|
192
|
-
#
|
193
|
-
# @version SketchUp 6.0
|
194
|
-
def point=(point3d)
|
195
|
-
end
|
196
|
-
|
197
|
-
# The set_text method is used to set the text within a Text object without
|
198
|
-
# recording an Undo operation.
|
199
|
-
#
|
200
|
-
# @example
|
201
|
-
# text = text.set_text "This is another text"
|
202
|
-
#
|
203
|
-
# @param [String] textstring
|
204
|
-
# The string to be set within the Text object.
|
205
|
-
#
|
206
|
-
# @return [Sketchup::Text] the Text object
|
207
|
-
#
|
208
|
-
# @version SketchUp 6.0
|
209
|
-
def set_text(textstring)
|
210
|
-
end
|
211
|
-
|
212
|
-
# The text method is used to retrieve the string version of a Text object.
|
213
|
-
#
|
214
|
-
# @example
|
215
|
-
# textstring = text.text
|
216
|
-
#
|
217
|
-
# @return [String] the string representation of the Text
|
218
|
-
# object
|
219
|
-
#
|
220
|
-
# @version SketchUp 6.0
|
221
|
-
def text
|
222
|
-
end
|
223
|
-
|
224
|
-
# The text= method is used to set the string version of a Text object.
|
225
|
-
#
|
226
|
-
# @example
|
227
|
-
# textstring = text.text= "text"
|
228
|
-
#
|
229
|
-
# @param [String] textstring
|
230
|
-
#
|
231
|
-
# @return [String] the newly set text
|
232
|
-
#
|
233
|
-
# @version SketchUp 6.0
|
234
|
-
def text=(textstring)
|
235
|
-
end
|
236
|
-
|
237
|
-
# The vector method is used to get the vector associated with the text.
|
238
|
-
#
|
239
|
-
# @example
|
240
|
-
# vector = text.vector
|
241
|
-
#
|
242
|
-
# @return [Geom::Vector3d] a Vector3d object.
|
243
|
-
#
|
244
|
-
# @version SketchUp 6.0
|
245
|
-
def vector
|
246
|
-
end
|
247
|
-
|
248
|
-
# The vector= method is used to set the vector associated with the text.
|
249
|
-
#
|
250
|
-
# @example
|
251
|
-
# vector = text.vector
|
252
|
-
#
|
253
|
-
# @param [Geom::Vector3d] vector
|
254
|
-
# A Vector3d object.
|
255
|
-
#
|
256
|
-
# @return [Geom::Vector3d]
|
257
|
-
#
|
258
|
-
# @version SketchUp 6.0
|
259
|
-
def vector=(vector)
|
260
|
-
end
|
261
|
-
|
262
|
-
end
|
1
|
+
# Copyright:: Copyright 2023 Trimble Inc.
|
2
|
+
# License:: The MIT License (MIT)
|
3
|
+
|
4
|
+
# The Text class contains method to manipulate a Text entity object.
|
5
|
+
#
|
6
|
+
# @version SketchUp 6.0
|
7
|
+
class Sketchup::Text < Sketchup::Drawingelement
|
8
|
+
|
9
|
+
# Instance Methods
|
10
|
+
|
11
|
+
# The arrow_type method retrieves the current arrow type used for the leader
|
12
|
+
# text.
|
13
|
+
#
|
14
|
+
# Valid arrow types are 0 for none, 2 for dot, 3 for closed arrow, 4 for open
|
15
|
+
# arrow.
|
16
|
+
#
|
17
|
+
# @example
|
18
|
+
# type = text.arrow_type=0
|
19
|
+
#
|
20
|
+
# @return [Integer] a numerical representation for the type of
|
21
|
+
# arrow.
|
22
|
+
#
|
23
|
+
# @version SketchUp 6.0
|
24
|
+
def arrow_type
|
25
|
+
end
|
26
|
+
|
27
|
+
# The arrow_type= method sets the arrow type used for leader text.
|
28
|
+
#
|
29
|
+
# Valid arrow types are 0 for none, 2 for dot, 3 for closed arrow, 4 for open
|
30
|
+
# arrow.
|
31
|
+
#
|
32
|
+
# @example
|
33
|
+
# arrow = text.arrow_type=type
|
34
|
+
#
|
35
|
+
# @param [Integer] type
|
36
|
+
# A numerical representation of the type of arrow to be
|
37
|
+
# set.
|
38
|
+
#
|
39
|
+
# @return [Integer] a numerical representation for the type of
|
40
|
+
# arrow.
|
41
|
+
#
|
42
|
+
# @version SketchUp 6.0
|
43
|
+
def arrow_type=(type)
|
44
|
+
end
|
45
|
+
|
46
|
+
# The {#attached_to} method returns an array of the attached
|
47
|
+
# {Sketchup::InstancePath} object and the {Geom::Point3d}.
|
48
|
+
#
|
49
|
+
# @example
|
50
|
+
# # Have a text annotation attached to a drawing element and selected
|
51
|
+
# Sketchup.active_model.selection[0].attached_to
|
52
|
+
#
|
53
|
+
# @return [Array(Sketchup::InstancePath, Geom::Point3d), nil]
|
54
|
+
#
|
55
|
+
# @version SketchUp 2019
|
56
|
+
def attached_to
|
57
|
+
end
|
58
|
+
|
59
|
+
# The {#attached_to=} method will attach the {Sketchup::Text} to another
|
60
|
+
# {Sketchup::DrawingElement}.
|
61
|
+
#
|
62
|
+
# @example
|
63
|
+
# # Have a text annotation attached to a drawing element and selected
|
64
|
+
# array = Sketchup.active_model.selection[0].attached_to
|
65
|
+
# Sketchup.active_model.selection[0].attached_to = [array[0], Geom::Point3d.new(0, 0, 0)]
|
66
|
+
#
|
67
|
+
# @param [Array(Sketchup::InstancePath, Geom::Point3d)] path
|
68
|
+
#
|
69
|
+
# @version SketchUp 2019
|
70
|
+
def attached_to=(path)
|
71
|
+
end
|
72
|
+
|
73
|
+
# The display_leader= method accepts true or false for whether to display the
|
74
|
+
# leader.
|
75
|
+
#
|
76
|
+
# Leader text that is not displayed is set to Hidden type.
|
77
|
+
#
|
78
|
+
# @example
|
79
|
+
# leader = text.display_leader=true
|
80
|
+
#
|
81
|
+
# @param [Boolean] status
|
82
|
+
# true if you want to display the leader text, false if
|
83
|
+
# you do not want to display the leader text.
|
84
|
+
#
|
85
|
+
# @return [Boolean] the status that you set.
|
86
|
+
#
|
87
|
+
# @version SketchUp 6.0
|
88
|
+
def display_leader=(status)
|
89
|
+
end
|
90
|
+
|
91
|
+
# The display_leader? method returns the status of the leader.
|
92
|
+
#
|
93
|
+
# @example
|
94
|
+
# status = text.display_leader
|
95
|
+
#
|
96
|
+
# @return [Boolean]
|
97
|
+
#
|
98
|
+
# @version SketchUp 6.0
|
99
|
+
def display_leader?
|
100
|
+
end
|
101
|
+
|
102
|
+
# The has_leader method is used to determine if the Text object has a leader.
|
103
|
+
#
|
104
|
+
# @example
|
105
|
+
# status = text.has_leader
|
106
|
+
#
|
107
|
+
# @return [Boolean]
|
108
|
+
#
|
109
|
+
# @version SketchUp 6.0
|
110
|
+
def has_leader?
|
111
|
+
end
|
112
|
+
|
113
|
+
# The leader_type method retrieves the currently set leader type.
|
114
|
+
#
|
115
|
+
# @example
|
116
|
+
# leader = text.leader_type
|
117
|
+
#
|
118
|
+
# @return [Integer] a numerical value representing the currently
|
119
|
+
# set leader type.
|
120
|
+
#
|
121
|
+
# @version SketchUp 6.0
|
122
|
+
def leader_type
|
123
|
+
end
|
124
|
+
|
125
|
+
# The leader_type = method sets the leader type.
|
126
|
+
#
|
127
|
+
# Valid leader types are 0 for none, 1 for View-based, and 2 for Pushpin
|
128
|
+
#
|
129
|
+
# @example
|
130
|
+
# leader = text.leader_type=1
|
131
|
+
#
|
132
|
+
# @param [Integer] type
|
133
|
+
# A numerical value representing the leader type to be
|
134
|
+
# set.
|
135
|
+
#
|
136
|
+
# @return [Integer] a numerical value representing the leader type
|
137
|
+
# you just set.
|
138
|
+
#
|
139
|
+
# @version SketchUp 6.0
|
140
|
+
def leader_type=(type)
|
141
|
+
end
|
142
|
+
|
143
|
+
# The line_weight method returns a line weight in number of pixels.
|
144
|
+
#
|
145
|
+
# Defalt line weight is 1.
|
146
|
+
#
|
147
|
+
# @example
|
148
|
+
# weight = text.line_weight
|
149
|
+
#
|
150
|
+
# @return [Integer] the line weight in pixels
|
151
|
+
#
|
152
|
+
# @version SketchUp 6.0
|
153
|
+
def line_weight
|
154
|
+
end
|
155
|
+
|
156
|
+
# The line_weight= method sets the line weight in pixels.
|
157
|
+
#
|
158
|
+
# Default line weight is 1.
|
159
|
+
#
|
160
|
+
# @example
|
161
|
+
# newweight = text.line_weight = 4
|
162
|
+
#
|
163
|
+
# @param [Integer] weight
|
164
|
+
# The line weight to be set (in pixels).
|
165
|
+
#
|
166
|
+
# @return [Integer] The line weight that has been set.
|
167
|
+
#
|
168
|
+
# @version SketchUp 6.0
|
169
|
+
def line_weight=(weight)
|
170
|
+
end
|
171
|
+
|
172
|
+
# The point method is used to get the point associated with the text.
|
173
|
+
#
|
174
|
+
# @example
|
175
|
+
# point3d = text.point
|
176
|
+
#
|
177
|
+
# @return [Geom::Point3d] a Point3d object.
|
178
|
+
#
|
179
|
+
# @version SketchUp 6.0
|
180
|
+
def point
|
181
|
+
end
|
182
|
+
|
183
|
+
# The point= method is used to set the point associated with the text.
|
184
|
+
#
|
185
|
+
# @example
|
186
|
+
# status = text.point = point3d
|
187
|
+
#
|
188
|
+
# @param [Geom::Point3d] point3d
|
189
|
+
# A Point3d object.
|
190
|
+
#
|
191
|
+
# @return [Geom::Point3d] true if successful, false if unsuccessful.
|
192
|
+
#
|
193
|
+
# @version SketchUp 6.0
|
194
|
+
def point=(point3d)
|
195
|
+
end
|
196
|
+
|
197
|
+
# The set_text method is used to set the text within a Text object without
|
198
|
+
# recording an Undo operation.
|
199
|
+
#
|
200
|
+
# @example
|
201
|
+
# text = text.set_text "This is another text"
|
202
|
+
#
|
203
|
+
# @param [String] textstring
|
204
|
+
# The string to be set within the Text object.
|
205
|
+
#
|
206
|
+
# @return [Sketchup::Text] the Text object
|
207
|
+
#
|
208
|
+
# @version SketchUp 6.0
|
209
|
+
def set_text(textstring)
|
210
|
+
end
|
211
|
+
|
212
|
+
# The text method is used to retrieve the string version of a Text object.
|
213
|
+
#
|
214
|
+
# @example
|
215
|
+
# textstring = text.text
|
216
|
+
#
|
217
|
+
# @return [String] the string representation of the Text
|
218
|
+
# object
|
219
|
+
#
|
220
|
+
# @version SketchUp 6.0
|
221
|
+
def text
|
222
|
+
end
|
223
|
+
|
224
|
+
# The text= method is used to set the string version of a Text object.
|
225
|
+
#
|
226
|
+
# @example
|
227
|
+
# textstring = text.text= "text"
|
228
|
+
#
|
229
|
+
# @param [String] textstring
|
230
|
+
#
|
231
|
+
# @return [String] the newly set text
|
232
|
+
#
|
233
|
+
# @version SketchUp 6.0
|
234
|
+
def text=(textstring)
|
235
|
+
end
|
236
|
+
|
237
|
+
# The vector method is used to get the vector associated with the text.
|
238
|
+
#
|
239
|
+
# @example
|
240
|
+
# vector = text.vector
|
241
|
+
#
|
242
|
+
# @return [Geom::Vector3d] a Vector3d object.
|
243
|
+
#
|
244
|
+
# @version SketchUp 6.0
|
245
|
+
def vector
|
246
|
+
end
|
247
|
+
|
248
|
+
# The vector= method is used to set the vector associated with the text.
|
249
|
+
#
|
250
|
+
# @example
|
251
|
+
# vector = text.vector
|
252
|
+
#
|
253
|
+
# @param [Geom::Vector3d] vector
|
254
|
+
# A Vector3d object.
|
255
|
+
#
|
256
|
+
# @return [Geom::Vector3d]
|
257
|
+
#
|
258
|
+
# @version SketchUp 6.0
|
259
|
+
def vector=(vector)
|
260
|
+
end
|
261
|
+
|
262
|
+
end
|