sketchup-api-stubs 0.7.4 → 0.7.8
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 +148 -145
- data/lib/sketchup-api-stubs/stubs/{array.rb → Array.rb} +741 -741
- data/lib/sketchup-api-stubs/stubs/Geom/BoundingBox.rb +322 -318
- 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 +523 -492
- data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb +478 -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 -348
- 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 +698 -411
- data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +183 -174
- data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
- data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +516 -514
- data/lib/sketchup-api-stubs/stubs/Layout/Ellipse.rb +29 -29
- data/lib/sketchup-api-stubs/stubs/Layout/Entities.rb +148 -143
- 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 -371
- 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 -220
- 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 -204
- 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/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 -140
- 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 +152 -152
- data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionary.rb +286 -281
- data/lib/sketchup-api-stubs/stubs/Sketchup/Axes.rb +149 -149
- data/lib/sketchup-api-stubs/stubs/Sketchup/Behavior.rb +302 -328
- data/lib/sketchup-api-stubs/stubs/Sketchup/Camera.rb +478 -577
- data/lib/sketchup-api-stubs/stubs/Sketchup/ClassificationSchema.rb +63 -63
- data/lib/sketchup-api-stubs/stubs/Sketchup/Classifications.rb +122 -122
- data/lib/sketchup-api-stubs/stubs/Sketchup/Color.rb +294 -281
- data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentDefinition.rb +619 -562
- data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +593 -593
- 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 -194
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionList.rb +426 -329
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionObserver.rb +74 -72
- data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionsObserver.rb +104 -102
- data/lib/sketchup-api-stubs/stubs/Sketchup/Dimension.rb +165 -165
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionLinear.rb +306 -312
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionObserver.rb +42 -38
- data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionRadial.rb +87 -87
- data/lib/sketchup-api-stubs/stubs/Sketchup/Drawingelement.rb +396 -390
- data/lib/sketchup-api-stubs/stubs/Sketchup/Edge.rb +502 -508
- data/lib/sketchup-api-stubs/stubs/Sketchup/EdgeUse.rb +211 -211
- data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb +1205 -1119
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesBuilder.rb +272 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +127 -125
- data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +545 -544
- data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb +60 -59
- data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb +126 -125
- data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb +937 -750
- data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +104 -104
- data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +750 -697
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +292 -285
- 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 -409
- data/lib/sketchup-api-stubs/stubs/Sketchup/ImageRep.rb +266 -226
- data/lib/sketchup-api-stubs/stubs/Sketchup/Importer.rb +189 -190
- data/lib/sketchup-api-stubs/stubs/Sketchup/InputPoint.rb +407 -393
- data/lib/sketchup-api-stubs/stubs/Sketchup/InstanceObserver.rb +84 -82
- data/lib/sketchup-api-stubs/stubs/Sketchup/InstancePath.rb +306 -303
- data/lib/sketchup-api-stubs/stubs/Sketchup/Layer.rb +326 -285
- data/lib/sketchup-api-stubs/stubs/Sketchup/LayerFolder.rb +422 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/Layers.rb +427 -244
- data/lib/sketchup-api-stubs/stubs/Sketchup/LayersObserver.rb +249 -136
- 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 +112 -112
- data/lib/sketchup-api-stubs/stubs/Sketchup/Loop.rb +137 -137
- data/lib/sketchup-api-stubs/stubs/Sketchup/Material.rb +414 -416
- data/lib/sketchup-api-stubs/stubs/Sketchup/Materials.rb +318 -311
- data/lib/sketchup-api-stubs/stubs/Sketchup/MaterialsObserver.rb +142 -141
- data/lib/sketchup-api-stubs/stubs/Sketchup/Menu.rb +93 -95
- data/lib/sketchup-api-stubs/stubs/Sketchup/Model.rb +1651 -1638
- data/lib/sketchup-api-stubs/stubs/Sketchup/ModelObserver.rb +357 -356
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb +131 -132
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb +284 -284
- data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
- data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +797 -770
- data/lib/sketchup-api-stubs/stubs/Sketchup/Pages.rb +363 -353
- data/lib/sketchup-api-stubs/stubs/Sketchup/PagesObserver.rb +77 -76
- data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb +477 -456
- data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb +43 -43
- data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb +364 -364
- data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb +45 -44
- data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb +150 -150
- data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb +459 -454
- 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 +260 -257
- data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfoObserver.rb +59 -57
- data/lib/sketchup-api-stubs/stubs/Sketchup/Skp.rb +40 -0
- data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb +69 -69
- data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb +217 -211
- data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb +262 -262
- data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb +217 -225
- data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb +237 -237
- data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb +837 -829
- data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb +132 -132
- data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb +156 -154
- data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb +75 -61
- data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
- data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1317 -1301
- data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +45 -43
- data/lib/sketchup-api-stubs/stubs/{sketchup.rb → Sketchup.rb} +1360 -1310
- 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 -310
- data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +496 -356
- data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +269 -229
- data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +240 -240
- data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +635 -633
- data/lib/sketchup-api-stubs/stubs/{ui.rb → UI.rb} +683 -667
- data/lib/sketchup-api-stubs/stubs/_top_level.rb +311 -311
- data/lib/sketchup-api-stubs.rb +1 -1
- metadata +15 -12
@@ -1,44 +1,45 @@
|
|
1
|
-
# Copyright:: Copyright
|
2
|
-
# License:: The MIT License (MIT)
|
3
|
-
|
4
|
-
# This observer interface is implemented to react to rendering options events.
|
5
|
-
#
|
6
|
-
#
|
7
|
-
#
|
8
|
-
#
|
9
|
-
#
|
10
|
-
#
|
11
|
-
# #
|
12
|
-
#
|
13
|
-
#
|
14
|
-
#
|
15
|
-
#
|
16
|
-
#
|
17
|
-
#
|
18
|
-
#
|
19
|
-
#
|
20
|
-
# rendering_options.
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
#
|
27
|
-
#
|
28
|
-
#
|
29
|
-
#
|
30
|
-
#
|
31
|
-
#
|
32
|
-
#
|
33
|
-
#
|
34
|
-
#
|
35
|
-
#
|
36
|
-
#
|
37
|
-
#
|
38
|
-
#
|
39
|
-
#
|
40
|
-
#
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
1
|
+
# Copyright:: Copyright 2022 Trimble Inc.
|
2
|
+
# License:: The MIT License (MIT)
|
3
|
+
|
4
|
+
# This observer interface is implemented to react to rendering options events.
|
5
|
+
#
|
6
|
+
# @abstract To implement this observer, create a Ruby class of this type, implement the
|
7
|
+
# desired methods, and add an instance of the observer to the objects of
|
8
|
+
# interests.
|
9
|
+
#
|
10
|
+
# @example
|
11
|
+
# # This is an example of an observer that watches the rendering options
|
12
|
+
# # for changes.
|
13
|
+
# class MyRenderingOptionsObserver < Sketchup::RenderingOptionsObserver
|
14
|
+
# def onRenderingOptionsChanged(rendering_options, type)
|
15
|
+
# puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
|
16
|
+
# end
|
17
|
+
# end
|
18
|
+
#
|
19
|
+
# # Attach the observer.
|
20
|
+
# rendering_options = Sketchup.active_model.rendering_options
|
21
|
+
# rendering_options.add_observer(MyRenderingOptionsObserver.new)
|
22
|
+
class Sketchup::RenderingOptionsObserver
|
23
|
+
|
24
|
+
# Instance Methods
|
25
|
+
|
26
|
+
# The onRenderingOptionsChanged method is invoked whenever the user changes
|
27
|
+
# their rendering options.
|
28
|
+
#
|
29
|
+
# @example
|
30
|
+
# def onRenderingOptionsChanged(rendering_options, type)
|
31
|
+
# puts "onRenderingOptionsChanged(#{rendering_options}, #{type})"
|
32
|
+
# end
|
33
|
+
#
|
34
|
+
# @param [Sketchup::RenderingOptions] rendering_options
|
35
|
+
#
|
36
|
+
# @param [Integer] type
|
37
|
+
# A number indicating which option was changed
|
38
|
+
# represented by one of the constants defined in
|
39
|
+
# {Sketchup::RenderingOptions}.
|
40
|
+
#
|
41
|
+
# @version SketchUp 6.0
|
42
|
+
def onRenderingOptionsChanged(rendering_options, type)
|
43
|
+
end
|
44
|
+
|
45
|
+
end
|
@@ -1,150 +1,150 @@
|
|
1
|
-
# Copyright:: Copyright
|
2
|
-
# License:: The MIT License (MIT)
|
3
|
-
|
4
|
-
# The SectionPlane class represents a section plane in a SketchUp model. Note
|
5
|
-
# that prior to SketchUp 2014 there was no way to create a SectionPlane object
|
6
|
-
# using Ruby. For older versions of SketchUp, you must manually create a
|
7
|
-
# section plane with the Section Plane Tool in SketchUp and then query the
|
8
|
-
# entities array to find the SectionPlane object.
|
9
|
-
#
|
10
|
-
# @version SketchUp 6.0
|
11
|
-
class Sketchup::SectionPlane < Sketchup::Drawingelement
|
12
|
-
|
13
|
-
# Instance Methods
|
14
|
-
|
15
|
-
# The activate method is used to make the section plane the active one of its
|
16
|
-
# parent component/group.
|
17
|
-
#
|
18
|
-
# @example
|
19
|
-
# entities = Sketchup.active_model.entities
|
20
|
-
# sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
|
21
|
-
# sp.activate
|
22
|
-
#
|
23
|
-
# @return self if successful
|
24
|
-
#
|
25
|
-
# @version SketchUp 2014
|
26
|
-
def activate
|
27
|
-
end
|
28
|
-
|
29
|
-
# The active? method indicates whether the section plane is active or not.
|
30
|
-
#
|
31
|
-
# @example
|
32
|
-
# entities = Sketchup.active_model.entities
|
33
|
-
# sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
|
34
|
-
# sp.activate
|
35
|
-
# if sp.active?
|
36
|
-
# puts "Yes, it is active"
|
37
|
-
# end
|
38
|
-
#
|
39
|
-
# @return [Boolean] boolean - true if active
|
40
|
-
#
|
41
|
-
# @version SketchUp 2014
|
42
|
-
def active?
|
43
|
-
end
|
44
|
-
|
45
|
-
# The get_plane method is used to retrieve the plane that the section plane is
|
46
|
-
# on.
|
47
|
-
#
|
48
|
-
# @example
|
49
|
-
# model = Sketchup.active_model
|
50
|
-
# entities = model.active_entities
|
51
|
-
# # Grab the first section plane from the model.
|
52
|
-
# sp = entities.grep(Sketchup::SectionPlane).first
|
53
|
-
# plane = sp.get_plane
|
54
|
-
# if (plane)
|
55
|
-
# puts plane.to_s
|
56
|
-
# else
|
57
|
-
# puts 'Failure'
|
58
|
-
# end
|
59
|
-
#
|
60
|
-
# @return plane - a plane. See the Geom module and Array class
|
61
|
-
# for further information on planes.
|
62
|
-
#
|
63
|
-
# @version SketchUp 6.0
|
64
|
-
def get_plane
|
65
|
-
end
|
66
|
-
|
67
|
-
# The {#name} method is used to retrieve the name of the section plane.
|
68
|
-
#
|
69
|
-
# @example
|
70
|
-
# model = Sketchup.active_model
|
71
|
-
# entities = model.active_entities
|
72
|
-
# # Grab the first section plane from the model.
|
73
|
-
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
74
|
-
# name = section_plane.name
|
75
|
-
#
|
76
|
-
# @return [String]
|
77
|
-
#
|
78
|
-
# @version SketchUp 2018
|
79
|
-
def name
|
80
|
-
end
|
81
|
-
|
82
|
-
# The {#name=} method is used to set the name of a section plane.
|
83
|
-
#
|
84
|
-
# @example
|
85
|
-
# model = Sketchup.active_model
|
86
|
-
# entities = Sketchup.active_model.entities
|
87
|
-
# # Grab the first section plane from the model.
|
88
|
-
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
89
|
-
# section_plane.name = "my section plane"
|
90
|
-
#
|
91
|
-
# @param [String] name
|
92
|
-
# The new name for the section plane object.
|
93
|
-
#
|
94
|
-
# @version SketchUp 2018
|
95
|
-
def name=(name)
|
96
|
-
end
|
97
|
-
|
98
|
-
# The set_plane method is used to set the plane that the section plane is
|
99
|
-
# on.
|
100
|
-
#
|
101
|
-
# @example
|
102
|
-
# model = Sketchup.active_model
|
103
|
-
# entities = model.active_entities
|
104
|
-
# # Grab the first section plane from the model.
|
105
|
-
# sp = entities.grep(Sketchup::SectionPlane).first
|
106
|
-
# sp = sp.set_plane my_plane_array
|
107
|
-
#
|
108
|
-
# @param plane
|
109
|
-
# An array representing the new plane,
|
110
|
-
#
|
111
|
-
# @return section_plane - the updated SectionPlane.
|
112
|
-
#
|
113
|
-
# @version SketchUp 6.0
|
114
|
-
def set_plane(plane)
|
115
|
-
end
|
116
|
-
|
117
|
-
# The {#symbol} method is used to retrieve the symbol of the section plane.
|
118
|
-
#
|
119
|
-
# @example
|
120
|
-
# model = Sketchup.active_model
|
121
|
-
# entities = model.active_entities
|
122
|
-
# # Grab the first section plane from the model.
|
123
|
-
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
124
|
-
# symbol = section_plane.symbol
|
125
|
-
#
|
126
|
-
# @return [String]
|
127
|
-
#
|
128
|
-
# @version SketchUp 2018
|
129
|
-
def symbol
|
130
|
-
end
|
131
|
-
|
132
|
-
# The {#symbol=} method is used to set the symbol of a section plane.
|
133
|
-
#
|
134
|
-
# @example
|
135
|
-
# model = Sketchup.active_model
|
136
|
-
# entities = Sketchup.active_model.entities
|
137
|
-
# # Grab the first section plane from the model.
|
138
|
-
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
139
|
-
# section_plane.symbol = "AB1"
|
140
|
-
#
|
141
|
-
# @note The symbol must be three characters or less.
|
142
|
-
#
|
143
|
-
# @param [String] symbol
|
144
|
-
# The new symbol for the section plane object.
|
145
|
-
#
|
146
|
-
# @version SketchUp 2018
|
147
|
-
def symbol=(symbol)
|
148
|
-
end
|
149
|
-
|
150
|
-
end
|
1
|
+
# Copyright:: Copyright 2022 Trimble Inc.
|
2
|
+
# License:: The MIT License (MIT)
|
3
|
+
|
4
|
+
# The SectionPlane class represents a section plane in a SketchUp model. Note
|
5
|
+
# that prior to SketchUp 2014 there was no way to create a SectionPlane object
|
6
|
+
# using Ruby. For older versions of SketchUp, you must manually create a
|
7
|
+
# section plane with the Section Plane Tool in SketchUp and then query the
|
8
|
+
# entities array to find the SectionPlane object.
|
9
|
+
#
|
10
|
+
# @version SketchUp 6.0
|
11
|
+
class Sketchup::SectionPlane < Sketchup::Drawingelement
|
12
|
+
|
13
|
+
# Instance Methods
|
14
|
+
|
15
|
+
# The activate method is used to make the section plane the active one of its
|
16
|
+
# parent component/group.
|
17
|
+
#
|
18
|
+
# @example
|
19
|
+
# entities = Sketchup.active_model.entities
|
20
|
+
# sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
|
21
|
+
# sp.activate
|
22
|
+
#
|
23
|
+
# @return self if successful
|
24
|
+
#
|
25
|
+
# @version SketchUp 2014
|
26
|
+
def activate
|
27
|
+
end
|
28
|
+
|
29
|
+
# The active? method indicates whether the section plane is active or not.
|
30
|
+
#
|
31
|
+
# @example
|
32
|
+
# entities = Sketchup.active_model.entities
|
33
|
+
# sp = entities.add_section_plane([50, 50, 0], [1.0, 1.0, 0])
|
34
|
+
# sp.activate
|
35
|
+
# if sp.active?
|
36
|
+
# puts "Yes, it is active"
|
37
|
+
# end
|
38
|
+
#
|
39
|
+
# @return [Boolean] boolean - true if active
|
40
|
+
#
|
41
|
+
# @version SketchUp 2014
|
42
|
+
def active?
|
43
|
+
end
|
44
|
+
|
45
|
+
# The get_plane method is used to retrieve the plane that the section plane is
|
46
|
+
# on.
|
47
|
+
#
|
48
|
+
# @example
|
49
|
+
# model = Sketchup.active_model
|
50
|
+
# entities = model.active_entities
|
51
|
+
# # Grab the first section plane from the model.
|
52
|
+
# sp = entities.grep(Sketchup::SectionPlane).first
|
53
|
+
# plane = sp.get_plane
|
54
|
+
# if (plane)
|
55
|
+
# puts plane.to_s
|
56
|
+
# else
|
57
|
+
# puts 'Failure'
|
58
|
+
# end
|
59
|
+
#
|
60
|
+
# @return plane - a plane. See the Geom module and Array class
|
61
|
+
# for further information on planes.
|
62
|
+
#
|
63
|
+
# @version SketchUp 6.0
|
64
|
+
def get_plane
|
65
|
+
end
|
66
|
+
|
67
|
+
# The {#name} method is used to retrieve the name of the section plane.
|
68
|
+
#
|
69
|
+
# @example
|
70
|
+
# model = Sketchup.active_model
|
71
|
+
# entities = model.active_entities
|
72
|
+
# # Grab the first section plane from the model.
|
73
|
+
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
74
|
+
# name = section_plane.name
|
75
|
+
#
|
76
|
+
# @return [String]
|
77
|
+
#
|
78
|
+
# @version SketchUp 2018
|
79
|
+
def name
|
80
|
+
end
|
81
|
+
|
82
|
+
# The {#name=} method is used to set the name of a section plane.
|
83
|
+
#
|
84
|
+
# @example
|
85
|
+
# model = Sketchup.active_model
|
86
|
+
# entities = Sketchup.active_model.entities
|
87
|
+
# # Grab the first section plane from the model.
|
88
|
+
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
89
|
+
# section_plane.name = "my section plane"
|
90
|
+
#
|
91
|
+
# @param [String] name
|
92
|
+
# The new name for the section plane object.
|
93
|
+
#
|
94
|
+
# @version SketchUp 2018
|
95
|
+
def name=(name)
|
96
|
+
end
|
97
|
+
|
98
|
+
# The set_plane method is used to set the plane that the section plane is
|
99
|
+
# on.
|
100
|
+
#
|
101
|
+
# @example
|
102
|
+
# model = Sketchup.active_model
|
103
|
+
# entities = model.active_entities
|
104
|
+
# # Grab the first section plane from the model.
|
105
|
+
# sp = entities.grep(Sketchup::SectionPlane).first
|
106
|
+
# sp = sp.set_plane my_plane_array
|
107
|
+
#
|
108
|
+
# @param plane
|
109
|
+
# An array representing the new plane,
|
110
|
+
#
|
111
|
+
# @return section_plane - the updated SectionPlane.
|
112
|
+
#
|
113
|
+
# @version SketchUp 6.0
|
114
|
+
def set_plane(plane)
|
115
|
+
end
|
116
|
+
|
117
|
+
# The {#symbol} method is used to retrieve the symbol of the section plane.
|
118
|
+
#
|
119
|
+
# @example
|
120
|
+
# model = Sketchup.active_model
|
121
|
+
# entities = model.active_entities
|
122
|
+
# # Grab the first section plane from the model.
|
123
|
+
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
124
|
+
# symbol = section_plane.symbol
|
125
|
+
#
|
126
|
+
# @return [String]
|
127
|
+
#
|
128
|
+
# @version SketchUp 2018
|
129
|
+
def symbol
|
130
|
+
end
|
131
|
+
|
132
|
+
# The {#symbol=} method is used to set the symbol of a section plane.
|
133
|
+
#
|
134
|
+
# @example
|
135
|
+
# model = Sketchup.active_model
|
136
|
+
# entities = Sketchup.active_model.entities
|
137
|
+
# # Grab the first section plane from the model.
|
138
|
+
# section_plane = entities.grep(Sketchup::SectionPlane).first
|
139
|
+
# section_plane.symbol = "AB1"
|
140
|
+
#
|
141
|
+
# @note The symbol must be three characters or less.
|
142
|
+
#
|
143
|
+
# @param [String] symbol
|
144
|
+
# The new symbol for the section plane object.
|
145
|
+
#
|
146
|
+
# @version SketchUp 2018
|
147
|
+
def symbol=(symbol)
|
148
|
+
end
|
149
|
+
|
150
|
+
end
|