sketchup-api-stubs 0.7.4 → 0.7.5
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.rb +1 -1
- data/lib/sketchup-api-stubs/sketchup.rb +147 -145
- 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 +498 -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 +691 -691
- data/lib/sketchup-api-stubs/stubs/Layout.rb +25 -25
- data/lib/sketchup-api-stubs/stubs/Layout/AngularDimension.rb +573 -573
- data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinition.rb +411 -411
- data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +179 -174
- data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
- data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +515 -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 +349 -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 +694 -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/Sketchup/Animation.rb +144 -140
- data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.rb +157 -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 +577 -562
- data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +604 -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 +362 -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 +1126 -1119
- 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 +751 -750
- data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +104 -104
- data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +699 -697
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http.rb +27 -27
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +285 -285
- data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Response.rb +62 -62
- data/lib/sketchup-api-stubs/stubs/Sketchup/Image.rb +417 -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 +405 -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 +327 -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.rb +48 -48
- data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing/ExtensionLicense.rb +86 -86
- 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 +478 -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 +257 -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 +835 -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 +71 -61
- data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
- data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1307 -1301
- data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +45 -43
- data/lib/sketchup-api-stubs/stubs/UI/Command.rb +317 -310
- data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +387 -356
- data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +255 -229
- data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +240 -240
- data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +633 -633
- data/lib/sketchup-api-stubs/stubs/_top_level.rb +311 -311
- data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
- data/lib/sketchup-api-stubs/stubs/geom.rb +351 -348
- data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
- data/lib/sketchup-api-stubs/stubs/length.rb +278 -278
- data/lib/sketchup-api-stubs/stubs/numeric.rb +249 -249
- data/lib/sketchup-api-stubs/stubs/sketchup.rb +1342 -1310
- data/lib/sketchup-api-stubs/stubs/sketchupextension.rb +353 -353
- data/lib/sketchup-api-stubs/stubs/string.rb +24 -24
- data/lib/sketchup-api-stubs/stubs/ui.rb +668 -667
- metadata +4 -2
@@ -1,257 +1,257 @@
|
|
1
|
-
# Copyright:: Copyright 2020 Trimble Inc.
|
2
|
-
# License:: The MIT License (MIT)
|
3
|
-
|
4
|
-
# The ShadowInfo class contains method to extract the shadow information for a
|
5
|
-
# model. The majority of the shadow information returned exists in the Model
|
6
|
-
# Info > Location and Model Info > Shadows dialogs inside SketchUp.
|
7
|
-
#
|
8
|
-
# The following shadow information keys are maintained in SketchUp:
|
9
|
-
#
|
10
|
-
# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that 'City' is called 'Location' in the UI
|
11
|
-
# - +Country+ (in Model Info > Geo-location > Set Manual Location...)
|
12
|
-
# - +Dark+ (in Window > Shadows)
|
13
|
-
# - +DayOfYear+
|
14
|
-
# - +DaylightSavings+
|
15
|
-
# - +DisplayNorth+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes' on Mac
|
16
|
-
# - +DisplayOnAllFaces+ (in Window > Shadows)
|
17
|
-
# - +DisplayOnGroundPlane+ (in Window > Shadows)
|
18
|
-
# - +DisplayShadows+ (in Window > Shadows)
|
19
|
-
# - +EdgesCastShadows+ (in Window > Shadows)
|
20
|
-
# - +Latitude+ (in Model Info > Geo-location > Set Manual Location...)
|
21
|
-
# - +Light+ (in Window > Shadows)
|
22
|
-
# - +Longitude+ (in Model Info > Geo-location > Set Manual Location...)
|
23
|
-
# - +
|
24
|
-
# - +ShadowTime+ (in Window > Shadows)
|
25
|
-
# - +ShadowTime_time_t+ (ShadowTime in Epoch time)
|
26
|
-
# - +SunDirection+ (Generated based on ShadowTime)
|
27
|
-
# - +SunRise+ (Generated based on ShadowTime)
|
28
|
-
# - +SunRise_time_t+ (SunRise in Epoch time)
|
29
|
-
# - +SunSet+ (Generated based on ShadowTime)
|
30
|
-
# - +SunSet_time_t+ (SunSet in Epoch time)
|
31
|
-
# - +TZOffset+ (in Window > Shadows)
|
32
|
-
# - +UseSunForAllShading+ (in Window > Shadows)
|
33
|
-
#
|
34
|
-
# You access the ShadowInfo object by calling Model.shadow_info:
|
35
|
-
#
|
36
|
-
# @example
|
37
|
-
# model = Sketchup.active_model
|
38
|
-
# shadowinfo = model.shadow_info
|
39
|
-
# UI.messagebox("My city is: " + shadowinfo["City"].to_s)
|
40
|
-
#
|
41
|
-
# @version SketchUp 6.0
|
42
|
-
class Sketchup::ShadowInfo < Sketchup::Entity
|
43
|
-
|
44
|
-
# Includes
|
45
|
-
|
46
|
-
include Enumerable
|
47
|
-
|
48
|
-
# Class Methods
|
49
|
-
|
50
|
-
# The each_key method iterates through all of the shadow information keys.
|
51
|
-
#
|
52
|
-
# @example
|
53
|
-
# shadowinfo.each_key { |key|
|
54
|
-
#
|
55
|
-
# @return [nil]
|
56
|
-
#
|
57
|
-
# @version SketchUp 6.0
|
58
|
-
#
|
59
|
-
# @yield [key] Variable to hold each key as they are found.
|
60
|
-
def self.each_key
|
61
|
-
end
|
62
|
-
|
63
|
-
# The keys method is a class method that returns an array with all of the
|
64
|
-
# attribute keys
|
65
|
-
#
|
66
|
-
# @example
|
67
|
-
# keys = Sketchup::ShadowInfo.keys
|
68
|
-
#
|
69
|
-
# @return [Array<String>] an array of keys
|
70
|
-
#
|
71
|
-
# @version SketchUp 6.0
|
72
|
-
def self.keys
|
73
|
-
end
|
74
|
-
|
75
|
-
# Instance Methods
|
76
|
-
|
77
|
-
# The [] method retrieves a value from the array of keys
|
78
|
-
#
|
79
|
-
# @example
|
80
|
-
# value = shadowinfo["key"]
|
81
|
-
#
|
82
|
-
# @param [String] key
|
83
|
-
# The key of the shadowinfo value to retrieve.
|
84
|
-
#
|
85
|
-
# @return [Object, nil] the value that is retrieved.
|
86
|
-
#
|
87
|
-
# @version SketchUp 6.0
|
88
|
-
def [](key)
|
89
|
-
end
|
90
|
-
|
91
|
-
# The set value []= method is used to set the value in the array of shadow
|
92
|
-
# info options.
|
93
|
-
#
|
94
|
-
# @example
|
95
|
-
# model = Sketchup.active_model
|
96
|
-
# shadowinfo = model.shadow_info
|
97
|
-
# value = shadowinfo["City"]
|
98
|
-
# UI.messagebox value
|
99
|
-
# value = shadowinfo["City"]="Denver, CO"
|
100
|
-
# UI.messagebox value
|
101
|
-
#
|
102
|
-
# @param [String] key
|
103
|
-
# The key of the shadowinfo value to set.
|
104
|
-
#
|
105
|
-
# @param [Object] value
|
106
|
-
# The value to be set.
|
107
|
-
#
|
108
|
-
# @return [Object] the value that was set if successful, or false
|
109
|
-
# if unsuccessful.
|
110
|
-
#
|
111
|
-
# @version SketchUp 6.0
|
112
|
-
def []=(key, value)
|
113
|
-
end
|
114
|
-
|
115
|
-
# The add_observer method is used to add an observer to the current object.
|
116
|
-
#
|
117
|
-
# @example
|
118
|
-
# status = object.add_observer observer
|
119
|
-
#
|
120
|
-
# @param [Object] observer
|
121
|
-
# An observer.
|
122
|
-
#
|
123
|
-
# @return [Boolean] true if successful, false if unsuccessful.
|
124
|
-
#
|
125
|
-
# @version SketchUp 6.0
|
126
|
-
def add_observer(observer)
|
127
|
-
end
|
128
|
-
|
129
|
-
# The count method is inherited from the Enumerable mix-in module.
|
130
|
-
#
|
131
|
-
# @example
|
132
|
-
# shadow_info = Sketchup.active_model.shadow_info
|
133
|
-
# number = shadow_info.count
|
134
|
-
#
|
135
|
-
# @return [Integer]
|
136
|
-
#
|
137
|
-
# @version SketchUp 2014
|
138
|
-
def count
|
139
|
-
end
|
140
|
-
|
141
|
-
# The {#each} method iterates through all of the shadow information key/value
|
142
|
-
# pairs.
|
143
|
-
#
|
144
|
-
# @example
|
145
|
-
# model = Sketchup.active_model
|
146
|
-
# shadow_info = model.shadow_info
|
147
|
-
# shadow_info.each { |key, value|
|
148
|
-
# puts "#{key} : #{value}"
|
149
|
-
# }
|
150
|
-
#
|
151
|
-
# @return [nil]
|
152
|
-
#
|
153
|
-
# @see #each_pair
|
154
|
-
#
|
155
|
-
# @version SketchUp 6.0
|
156
|
-
#
|
157
|
-
# @yield [key, value]
|
158
|
-
#
|
159
|
-
# @yieldparam [String] key
|
160
|
-
#
|
161
|
-
# @yieldparam [Object] value
|
162
|
-
def each
|
163
|
-
end
|
164
|
-
|
165
|
-
# The each_key method iterates through all of the shadow information keys.
|
166
|
-
#
|
167
|
-
# @example
|
168
|
-
# shadowinfo.each_key { |key|
|
169
|
-
#
|
170
|
-
# @return [nil]
|
171
|
-
#
|
172
|
-
# @version SketchUp 6.0
|
173
|
-
#
|
174
|
-
# @yield [key] Variable to hold each key as they are found.
|
175
|
-
def each_key
|
176
|
-
end
|
177
|
-
|
178
|
-
# The #
|
179
|
-
#
|
180
|
-
# @example
|
181
|
-
# model = Sketchup.active_model
|
182
|
-
# shadow_info = model.shadow_info
|
183
|
-
# shadow_info.each_pair { |key, value|
|
184
|
-
# puts "#{key} : #{value}"
|
185
|
-
# }
|
186
|
-
#
|
187
|
-
# @return [nil]
|
188
|
-
#
|
189
|
-
# @see #each
|
190
|
-
#
|
191
|
-
# @version SketchUp 6.0
|
192
|
-
#
|
193
|
-
# @yield [key, value]
|
194
|
-
#
|
195
|
-
# @yieldparam [String] key
|
196
|
-
#
|
197
|
-
# @yieldparam [Object] value
|
198
|
-
def each_pair
|
199
|
-
end
|
200
|
-
|
201
|
-
# The keys method is a class method that returns an array with all of the
|
202
|
-
# attribute keys
|
203
|
-
#
|
204
|
-
# @example
|
205
|
-
# keys = Sketchup::ShadowInfo.keys
|
206
|
-
#
|
207
|
-
# @return [Array<String>] an array of keys
|
208
|
-
#
|
209
|
-
# @version SketchUp 6.0
|
210
|
-
def keys
|
211
|
-
end
|
212
|
-
|
213
|
-
# The {#length} method returns the number of options in the shadow options
|
214
|
-
# collection
|
215
|
-
#
|
216
|
-
# @example
|
217
|
-
# shadow_info = Sketchup.active_model.shadow_info
|
218
|
-
# number = shadow_info.length
|
219
|
-
#
|
220
|
-
# @return [Integer]
|
221
|
-
#
|
222
|
-
# @see #size
|
223
|
-
#
|
224
|
-
# @version SketchUp 2014
|
225
|
-
def length
|
226
|
-
end
|
227
|
-
|
228
|
-
# The remove_observer method is used to remove an observer from the current
|
229
|
-
# object.
|
230
|
-
#
|
231
|
-
# @example
|
232
|
-
# status = object.remove_observer observer
|
233
|
-
#
|
234
|
-
# @param [Object] observer
|
235
|
-
# An observer.
|
236
|
-
#
|
237
|
-
# @return [Boolean] true if successful, false if unsuccessful.
|
238
|
-
#
|
239
|
-
# @version SketchUp 6.0
|
240
|
-
def remove_observer(observer)
|
241
|
-
end
|
242
|
-
|
243
|
-
# The {#size} method is an alias for {#length}.
|
244
|
-
#
|
245
|
-
# @example
|
246
|
-
# shadow_info = Sketchup.active_model.shadow_info
|
247
|
-
# number = shadow_info.size
|
248
|
-
#
|
249
|
-
# @return [Integer]
|
250
|
-
#
|
251
|
-
# @see #length
|
252
|
-
#
|
253
|
-
# @version SketchUp 2014
|
254
|
-
def size
|
255
|
-
end
|
256
|
-
|
257
|
-
end
|
1
|
+
# Copyright:: Copyright 2020 Trimble Inc.
|
2
|
+
# License:: The MIT License (MIT)
|
3
|
+
|
4
|
+
# The ShadowInfo class contains method to extract the shadow information for a
|
5
|
+
# model. The majority of the shadow information returned exists in the Model
|
6
|
+
# Info > Location and Model Info > Shadows dialogs inside SketchUp.
|
7
|
+
#
|
8
|
+
# The following shadow information keys are maintained in SketchUp:
|
9
|
+
#
|
10
|
+
# - +City+ (in Model Info > Geo-location > Set Manual Location...) Note that 'City' is called 'Location' in the UI
|
11
|
+
# - +Country+ (in Model Info > Geo-location > Set Manual Location...)
|
12
|
+
# - +Dark+ (in Window > Shadows)
|
13
|
+
# - +DayOfYear+
|
14
|
+
# - +DaylightSavings+
|
15
|
+
# - +DisplayNorth+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes' on Mac
|
16
|
+
# - +DisplayOnAllFaces+ (in Window > Shadows)
|
17
|
+
# - +DisplayOnGroundPlane+ (in Window > Shadows)
|
18
|
+
# - +DisplayShadows+ (in Window > Shadows)
|
19
|
+
# - +EdgesCastShadows+ (in Window > Shadows)
|
20
|
+
# - +Latitude+ (in Model Info > Geo-location > Set Manual Location...)
|
21
|
+
# - +Light+ (in Window > Shadows)
|
22
|
+
# - +Longitude+ (in Model Info > Geo-location > Set Manual Location...)
|
23
|
+
# - +NorthAngle+ (in View > Toolbars > Solar North) Note that 'Toolbar' is called 'Tool Palettes' on Mac
|
24
|
+
# - +ShadowTime+ (in Window > Shadows)
|
25
|
+
# - +ShadowTime_time_t+ (ShadowTime in Epoch time)
|
26
|
+
# - +SunDirection+ (Generated based on ShadowTime)
|
27
|
+
# - +SunRise+ (Generated based on ShadowTime)
|
28
|
+
# - +SunRise_time_t+ (SunRise in Epoch time)
|
29
|
+
# - +SunSet+ (Generated based on ShadowTime)
|
30
|
+
# - +SunSet_time_t+ (SunSet in Epoch time)
|
31
|
+
# - +TZOffset+ (in Window > Shadows)
|
32
|
+
# - +UseSunForAllShading+ (in Window > Shadows)
|
33
|
+
#
|
34
|
+
# You access the ShadowInfo object by calling Model.shadow_info:
|
35
|
+
#
|
36
|
+
# @example
|
37
|
+
# model = Sketchup.active_model
|
38
|
+
# shadowinfo = model.shadow_info
|
39
|
+
# UI.messagebox("My city is: " + shadowinfo["City"].to_s)
|
40
|
+
#
|
41
|
+
# @version SketchUp 6.0
|
42
|
+
class Sketchup::ShadowInfo < Sketchup::Entity
|
43
|
+
|
44
|
+
# Includes
|
45
|
+
|
46
|
+
include Enumerable
|
47
|
+
|
48
|
+
# Class Methods
|
49
|
+
|
50
|
+
# The each_key method iterates through all of the shadow information keys.
|
51
|
+
#
|
52
|
+
# @example
|
53
|
+
# shadowinfo.each_key { |key| puts key }
|
54
|
+
#
|
55
|
+
# @return [nil]
|
56
|
+
#
|
57
|
+
# @version SketchUp 6.0
|
58
|
+
#
|
59
|
+
# @yield [key] Variable to hold each key as they are found.
|
60
|
+
def self.each_key
|
61
|
+
end
|
62
|
+
|
63
|
+
# The keys method is a class method that returns an array with all of the
|
64
|
+
# attribute keys
|
65
|
+
#
|
66
|
+
# @example
|
67
|
+
# keys = Sketchup::ShadowInfo.keys
|
68
|
+
#
|
69
|
+
# @return [Array<String>] an array of keys
|
70
|
+
#
|
71
|
+
# @version SketchUp 6.0
|
72
|
+
def self.keys
|
73
|
+
end
|
74
|
+
|
75
|
+
# Instance Methods
|
76
|
+
|
77
|
+
# The [] method retrieves a value from the array of keys
|
78
|
+
#
|
79
|
+
# @example
|
80
|
+
# value = shadowinfo["key"]
|
81
|
+
#
|
82
|
+
# @param [String] key
|
83
|
+
# The key of the shadowinfo value to retrieve.
|
84
|
+
#
|
85
|
+
# @return [Object, nil] the value that is retrieved.
|
86
|
+
#
|
87
|
+
# @version SketchUp 6.0
|
88
|
+
def [](key)
|
89
|
+
end
|
90
|
+
|
91
|
+
# The set value []= method is used to set the value in the array of shadow
|
92
|
+
# info options.
|
93
|
+
#
|
94
|
+
# @example
|
95
|
+
# model = Sketchup.active_model
|
96
|
+
# shadowinfo = model.shadow_info
|
97
|
+
# value = shadowinfo["City"]
|
98
|
+
# UI.messagebox value
|
99
|
+
# value = shadowinfo["City"]="Denver, CO"
|
100
|
+
# UI.messagebox value
|
101
|
+
#
|
102
|
+
# @param [String] key
|
103
|
+
# The key of the shadowinfo value to set.
|
104
|
+
#
|
105
|
+
# @param [Object] value
|
106
|
+
# The value to be set.
|
107
|
+
#
|
108
|
+
# @return [Object] the value that was set if successful, or false
|
109
|
+
# if unsuccessful.
|
110
|
+
#
|
111
|
+
# @version SketchUp 6.0
|
112
|
+
def []=(key, value)
|
113
|
+
end
|
114
|
+
|
115
|
+
# The add_observer method is used to add an observer to the current object.
|
116
|
+
#
|
117
|
+
# @example
|
118
|
+
# status = object.add_observer observer
|
119
|
+
#
|
120
|
+
# @param [Object] observer
|
121
|
+
# An observer.
|
122
|
+
#
|
123
|
+
# @return [Boolean] true if successful, false if unsuccessful.
|
124
|
+
#
|
125
|
+
# @version SketchUp 6.0
|
126
|
+
def add_observer(observer)
|
127
|
+
end
|
128
|
+
|
129
|
+
# The count method is inherited from the Enumerable mix-in module.
|
130
|
+
#
|
131
|
+
# @example
|
132
|
+
# shadow_info = Sketchup.active_model.shadow_info
|
133
|
+
# number = shadow_info.count
|
134
|
+
#
|
135
|
+
# @return [Integer]
|
136
|
+
#
|
137
|
+
# @version SketchUp 2014
|
138
|
+
def count
|
139
|
+
end
|
140
|
+
|
141
|
+
# The {#each} method iterates through all of the shadow information key/value
|
142
|
+
# pairs.
|
143
|
+
#
|
144
|
+
# @example
|
145
|
+
# model = Sketchup.active_model
|
146
|
+
# shadow_info = model.shadow_info
|
147
|
+
# shadow_info.each { |key, value|
|
148
|
+
# puts "#{key} : #{value}"
|
149
|
+
# }
|
150
|
+
#
|
151
|
+
# @return [nil]
|
152
|
+
#
|
153
|
+
# @see #each_pair
|
154
|
+
#
|
155
|
+
# @version SketchUp 6.0
|
156
|
+
#
|
157
|
+
# @yield [key, value]
|
158
|
+
#
|
159
|
+
# @yieldparam [String] key
|
160
|
+
#
|
161
|
+
# @yieldparam [Object] value
|
162
|
+
def each
|
163
|
+
end
|
164
|
+
|
165
|
+
# The each_key method iterates through all of the shadow information keys.
|
166
|
+
#
|
167
|
+
# @example
|
168
|
+
# shadowinfo.each_key { |key| puts key }
|
169
|
+
#
|
170
|
+
# @return [nil]
|
171
|
+
#
|
172
|
+
# @version SketchUp 6.0
|
173
|
+
#
|
174
|
+
# @yield [key] Variable to hold each key as they are found.
|
175
|
+
def each_key
|
176
|
+
end
|
177
|
+
|
178
|
+
# The {#each_pair} method is an alias for {#each}.
|
179
|
+
#
|
180
|
+
# @example
|
181
|
+
# model = Sketchup.active_model
|
182
|
+
# shadow_info = model.shadow_info
|
183
|
+
# shadow_info.each_pair { |key, value|
|
184
|
+
# puts "#{key} : #{value}"
|
185
|
+
# }
|
186
|
+
#
|
187
|
+
# @return [nil]
|
188
|
+
#
|
189
|
+
# @see #each
|
190
|
+
#
|
191
|
+
# @version SketchUp 6.0
|
192
|
+
#
|
193
|
+
# @yield [key, value]
|
194
|
+
#
|
195
|
+
# @yieldparam [String] key
|
196
|
+
#
|
197
|
+
# @yieldparam [Object] value
|
198
|
+
def each_pair
|
199
|
+
end
|
200
|
+
|
201
|
+
# The keys method is a class method that returns an array with all of the
|
202
|
+
# attribute keys
|
203
|
+
#
|
204
|
+
# @example
|
205
|
+
# keys = Sketchup::ShadowInfo.keys
|
206
|
+
#
|
207
|
+
# @return [Array<String>] an array of keys
|
208
|
+
#
|
209
|
+
# @version SketchUp 6.0
|
210
|
+
def keys
|
211
|
+
end
|
212
|
+
|
213
|
+
# The {#length} method returns the number of options in the shadow options
|
214
|
+
# collection
|
215
|
+
#
|
216
|
+
# @example
|
217
|
+
# shadow_info = Sketchup.active_model.shadow_info
|
218
|
+
# number = shadow_info.length
|
219
|
+
#
|
220
|
+
# @return [Integer]
|
221
|
+
#
|
222
|
+
# @see #size
|
223
|
+
#
|
224
|
+
# @version SketchUp 2014
|
225
|
+
def length
|
226
|
+
end
|
227
|
+
|
228
|
+
# The remove_observer method is used to remove an observer from the current
|
229
|
+
# object.
|
230
|
+
#
|
231
|
+
# @example
|
232
|
+
# status = object.remove_observer observer
|
233
|
+
#
|
234
|
+
# @param [Object] observer
|
235
|
+
# An observer.
|
236
|
+
#
|
237
|
+
# @return [Boolean] true if successful, false if unsuccessful.
|
238
|
+
#
|
239
|
+
# @version SketchUp 6.0
|
240
|
+
def remove_observer(observer)
|
241
|
+
end
|
242
|
+
|
243
|
+
# The {#size} method is an alias for {#length}.
|
244
|
+
#
|
245
|
+
# @example
|
246
|
+
# shadow_info = Sketchup.active_model.shadow_info
|
247
|
+
# number = shadow_info.size
|
248
|
+
#
|
249
|
+
# @return [Integer]
|
250
|
+
#
|
251
|
+
# @see #length
|
252
|
+
#
|
253
|
+
# @version SketchUp 2014
|
254
|
+
def size
|
255
|
+
end
|
256
|
+
|
257
|
+
end
|