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.
Files changed (150) hide show
  1. checksums.yaml +4 -4
  2. data/lib/sketchup-api-stubs.rb +1 -1
  3. data/lib/sketchup-api-stubs/sketchup.rb +147 -145
  4. data/lib/sketchup-api-stubs/stubs/Geom/BoundingBox.rb +322 -318
  5. data/lib/sketchup-api-stubs/stubs/Geom/Bounds2d.rb +172 -172
  6. data/lib/sketchup-api-stubs/stubs/Geom/LatLong.rb +126 -126
  7. data/lib/sketchup-api-stubs/stubs/Geom/OrientedBounds2d.rb +102 -102
  8. data/lib/sketchup-api-stubs/stubs/Geom/Point2d.rb +400 -400
  9. data/lib/sketchup-api-stubs/stubs/Geom/Point3d.rb +661 -661
  10. data/lib/sketchup-api-stubs/stubs/Geom/PolygonMesh.rb +498 -492
  11. data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb +478 -478
  12. data/lib/sketchup-api-stubs/stubs/Geom/Transformation2d.rb +263 -263
  13. data/lib/sketchup-api-stubs/stubs/Geom/UTM.rb +141 -141
  14. data/lib/sketchup-api-stubs/stubs/Geom/Vector2d.rb +522 -522
  15. data/lib/sketchup-api-stubs/stubs/Geom/Vector3d.rb +691 -691
  16. data/lib/sketchup-api-stubs/stubs/Layout.rb +25 -25
  17. data/lib/sketchup-api-stubs/stubs/Layout/AngularDimension.rb +573 -573
  18. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinition.rb +411 -411
  19. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +179 -174
  20. data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
  21. data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +515 -514
  22. data/lib/sketchup-api-stubs/stubs/Layout/Ellipse.rb +29 -29
  23. data/lib/sketchup-api-stubs/stubs/Layout/Entities.rb +148 -143
  24. data/lib/sketchup-api-stubs/stubs/Layout/Entity.rb +353 -353
  25. data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +349 -349
  26. data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -311
  27. data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
  28. data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -91
  29. data/lib/sketchup-api-stubs/stubs/Layout/Label.rb +370 -371
  30. data/lib/sketchup-api-stubs/stubs/Layout/Layer.rb +218 -218
  31. data/lib/sketchup-api-stubs/stubs/Layout/LayerInstance.rb +128 -128
  32. data/lib/sketchup-api-stubs/stubs/Layout/Layers.rb +225 -220
  33. data/lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb +567 -567
  34. data/lib/sketchup-api-stubs/stubs/Layout/LockedEntityError.rb +10 -10
  35. data/lib/sketchup-api-stubs/stubs/Layout/LockedLayerError.rb +11 -11
  36. data/lib/sketchup-api-stubs/stubs/Layout/Page.rb +183 -183
  37. data/lib/sketchup-api-stubs/stubs/Layout/PageInfo.rb +387 -387
  38. data/lib/sketchup-api-stubs/stubs/Layout/Pages.rb +209 -204
  39. data/lib/sketchup-api-stubs/stubs/Layout/Path.rb +344 -344
  40. data/lib/sketchup-api-stubs/stubs/Layout/Rectangle.rb +174 -174
  41. data/lib/sketchup-api-stubs/stubs/Layout/SketchUpModel.rb +694 -694
  42. data/lib/sketchup-api-stubs/stubs/Layout/Style.rb +1519 -1519
  43. data/lib/sketchup-api-stubs/stubs/Layout/Table.rb +290 -290
  44. data/lib/sketchup-api-stubs/stubs/Layout/TableCell.rb +149 -149
  45. data/lib/sketchup-api-stubs/stubs/Layout/TableColumn.rb +139 -139
  46. data/lib/sketchup-api-stubs/stubs/Layout/TableRow.rb +135 -135
  47. data/lib/sketchup-api-stubs/stubs/Sketchup/Animation.rb +144 -140
  48. data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.rb +157 -157
  49. data/lib/sketchup-api-stubs/stubs/Sketchup/ArcCurve.rb +209 -209
  50. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionaries.rb +152 -152
  51. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionary.rb +286 -281
  52. data/lib/sketchup-api-stubs/stubs/Sketchup/Axes.rb +149 -149
  53. data/lib/sketchup-api-stubs/stubs/Sketchup/Behavior.rb +302 -328
  54. data/lib/sketchup-api-stubs/stubs/Sketchup/Camera.rb +478 -577
  55. data/lib/sketchup-api-stubs/stubs/Sketchup/ClassificationSchema.rb +63 -63
  56. data/lib/sketchup-api-stubs/stubs/Sketchup/Classifications.rb +122 -122
  57. data/lib/sketchup-api-stubs/stubs/Sketchup/Color.rb +294 -281
  58. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentDefinition.rb +577 -562
  59. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +604 -593
  60. data/lib/sketchup-api-stubs/stubs/Sketchup/Console.rb +76 -76
  61. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionLine.rb +257 -257
  62. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionPoint.rb +32 -32
  63. data/lib/sketchup-api-stubs/stubs/Sketchup/Curve.rb +201 -194
  64. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionList.rb +362 -329
  65. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionObserver.rb +74 -72
  66. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionsObserver.rb +104 -102
  67. data/lib/sketchup-api-stubs/stubs/Sketchup/Dimension.rb +165 -165
  68. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionLinear.rb +306 -312
  69. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionObserver.rb +42 -38
  70. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionRadial.rb +87 -87
  71. data/lib/sketchup-api-stubs/stubs/Sketchup/Drawingelement.rb +396 -390
  72. data/lib/sketchup-api-stubs/stubs/Sketchup/Edge.rb +502 -508
  73. data/lib/sketchup-api-stubs/stubs/Sketchup/EdgeUse.rb +211 -211
  74. data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb +1126 -1119
  75. data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +127 -125
  76. data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +545 -544
  77. data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb +60 -59
  78. data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb +126 -125
  79. data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb +751 -750
  80. data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +104 -104
  81. data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +699 -697
  82. data/lib/sketchup-api-stubs/stubs/Sketchup/Http.rb +27 -27
  83. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +285 -285
  84. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Response.rb +62 -62
  85. data/lib/sketchup-api-stubs/stubs/Sketchup/Image.rb +417 -409
  86. data/lib/sketchup-api-stubs/stubs/Sketchup/ImageRep.rb +266 -226
  87. data/lib/sketchup-api-stubs/stubs/Sketchup/Importer.rb +189 -190
  88. data/lib/sketchup-api-stubs/stubs/Sketchup/InputPoint.rb +405 -393
  89. data/lib/sketchup-api-stubs/stubs/Sketchup/InstanceObserver.rb +84 -82
  90. data/lib/sketchup-api-stubs/stubs/Sketchup/InstancePath.rb +306 -303
  91. data/lib/sketchup-api-stubs/stubs/Sketchup/Layer.rb +327 -285
  92. data/lib/sketchup-api-stubs/stubs/Sketchup/LayerFolder.rb +422 -0
  93. data/lib/sketchup-api-stubs/stubs/Sketchup/Layers.rb +427 -244
  94. data/lib/sketchup-api-stubs/stubs/Sketchup/LayersObserver.rb +249 -136
  95. data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing.rb +48 -48
  96. data/lib/sketchup-api-stubs/stubs/Sketchup/Licensing/ExtensionLicense.rb +86 -86
  97. data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyle.rb +24 -24
  98. data/lib/sketchup-api-stubs/stubs/Sketchup/LineStyles.rb +112 -112
  99. data/lib/sketchup-api-stubs/stubs/Sketchup/Loop.rb +137 -137
  100. data/lib/sketchup-api-stubs/stubs/Sketchup/Material.rb +414 -416
  101. data/lib/sketchup-api-stubs/stubs/Sketchup/Materials.rb +318 -311
  102. data/lib/sketchup-api-stubs/stubs/Sketchup/MaterialsObserver.rb +142 -141
  103. data/lib/sketchup-api-stubs/stubs/Sketchup/Menu.rb +93 -95
  104. data/lib/sketchup-api-stubs/stubs/Sketchup/Model.rb +1651 -1638
  105. data/lib/sketchup-api-stubs/stubs/Sketchup/ModelObserver.rb +357 -356
  106. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb +131 -132
  107. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb +284 -284
  108. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
  109. data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +797 -770
  110. data/lib/sketchup-api-stubs/stubs/Sketchup/Pages.rb +363 -353
  111. data/lib/sketchup-api-stubs/stubs/Sketchup/PagesObserver.rb +77 -76
  112. data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb +478 -456
  113. data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb +43 -43
  114. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb +364 -364
  115. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb +45 -44
  116. data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb +150 -150
  117. data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb +459 -454
  118. data/lib/sketchup-api-stubs/stubs/Sketchup/SelectionObserver.rb +115 -115
  119. data/lib/sketchup-api-stubs/stubs/Sketchup/Set.rb +212 -212
  120. data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfo.rb +257 -257
  121. data/lib/sketchup-api-stubs/stubs/Sketchup/ShadowInfoObserver.rb +59 -57
  122. data/lib/sketchup-api-stubs/stubs/Sketchup/Skp.rb +40 -0
  123. data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb +69 -69
  124. data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb +217 -211
  125. data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb +262 -262
  126. data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb +217 -225
  127. data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb +237 -237
  128. data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb +835 -829
  129. data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb +132 -132
  130. data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb +156 -154
  131. data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb +71 -61
  132. data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
  133. data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1307 -1301
  134. data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +45 -43
  135. data/lib/sketchup-api-stubs/stubs/UI/Command.rb +317 -310
  136. data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +387 -356
  137. data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +255 -229
  138. data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +240 -240
  139. data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +633 -633
  140. data/lib/sketchup-api-stubs/stubs/_top_level.rb +311 -311
  141. data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
  142. data/lib/sketchup-api-stubs/stubs/geom.rb +351 -348
  143. data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
  144. data/lib/sketchup-api-stubs/stubs/length.rb +278 -278
  145. data/lib/sketchup-api-stubs/stubs/numeric.rb +249 -249
  146. data/lib/sketchup-api-stubs/stubs/sketchup.rb +1342 -1310
  147. data/lib/sketchup-api-stubs/stubs/sketchupextension.rb +353 -353
  148. data/lib/sketchup-api-stubs/stubs/string.rb +24 -24
  149. data/lib/sketchup-api-stubs/stubs/ui.rb +668 -667
  150. metadata +4 -2
@@ -1,135 +1,135 @@
1
- # Copyright:: Copyright 2020 Trimble Inc.
2
- # License:: The MIT License (MIT)
3
-
4
- # A {Layout::TableColumn} is a single row from a table.
5
- #
6
- # @example
7
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
8
- # rows = 4
9
- # columns = 4
10
- # table = Layout::Table.new(bounds, rows, columns)
11
- # rows.times { |index|
12
- # row = table.row(index)
13
- # }
14
- #
15
- # @version LayOut 2018
16
- class Layout::TableRow
17
-
18
- # Instance Methods
19
-
20
- # The {#bottom_edge_style} method returns the {Layout::Style} of a
21
- # {Layout::TableRow}'s bottom edge.
22
- #
23
- # @example
24
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
25
- # rows = 4
26
- # columns = 4
27
- # table = Layout::Table.new(bounds, rows, columns)
28
- # style = table.get_row(1).bottom_edge_style
29
- #
30
- # @return [Layout::Style]
31
- #
32
- # @version LayOut 2018
33
- def bottom_edge_style
34
- end
35
-
36
- # The {#bottom_edge_style=} method sets the {Layout::Style} of a
37
- # {Layout::TableRow}'s bottom edge.
38
- #
39
- # @example
40
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
41
- # rows = 4
42
- # columns = 4
43
- # table = Layout::Table.new(bounds, rows, columns)
44
- # style = Layout::Style.new
45
- # style.stroke_width = 2.0
46
- # table.get_row(1).bottom_edge_style = style
47
- #
48
- # @param [Layout::Style] style
49
- #
50
- # @raise [LockedLayerError] if the {Layout::Table} is on a locked
51
- # {Layout::Layer}
52
- #
53
- # @raise [LockedEntityError] if the {Layout::Table} is locked
54
- #
55
- # @version LayOut 2018
56
- def bottom_edge_style=(style)
57
- end
58
-
59
- # The {#height} method returns the height of the {Layout::TableRow}.
60
- #
61
- # @example
62
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
63
- # rows = 4
64
- # columns = 4
65
- # table = Layout::Table.new(bounds, rows, columns)
66
- # height = table.get_row(1).height
67
- #
68
- # @return [Float]
69
- #
70
- # @version LayOut 2018
71
- def height
72
- end
73
-
74
- # The {#height=} method sets the height of the {Layout::TableRow}.
75
- #
76
- # @example
77
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
78
- # rows = 4
79
- # columns = 4
80
- # table = Layout::Table.new(bounds, rows, columns)
81
- # table.get_row(1).height = 3.0
82
- #
83
- # @param [Float] height
84
- #
85
- # @raise [ArgumentError] if height is not a valid height
86
- #
87
- # @raise [LockedLayerError] if the {Layout::Table} is on a locked
88
- # {Layout::Layer}
89
- #
90
- # @raise [LockedEntityError] if the {Layout::Table} is locked
91
- #
92
- # @version LayOut 2018
93
- def height=(height)
94
- end
95
-
96
- # The {#top_edge_style} method returns the {Layout::Style} of a
97
- # {Layout::TableRow}'s top edge.
98
- #
99
- # @example
100
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
101
- # rows = 4
102
- # columns = 4
103
- # table = Layout::Table.new(bounds, rows, columns)
104
- # style = table.get_row(1).top_edge_style
105
- #
106
- # @return [Layout::Style]
107
- #
108
- # @version LayOut 2018
109
- def top_edge_style
110
- end
111
-
112
- # The {#top_edge_style=} method sets the {Layout::Style} of a
113
- # {Layout::TableRow}'s top edge.
114
- #
115
- # @example
116
- # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
117
- # rows = 4
118
- # columns = 4
119
- # table = Layout::Table.new(bounds, rows, columns)
120
- # style = Layout::Style.new
121
- # style.stroke_width = 2.0
122
- # table.get_row(1).top_edge_style = style
123
- #
124
- # @param [Layout::Style] style
125
- #
126
- # @raise [LockedLayerError] if the {Layout::Table} is on a locked
127
- # {Layout::Layer}
128
- #
129
- # @raise [LockedEntityError] if the {Layout::Table} is locked
130
- #
131
- # @version LayOut 2018
132
- def top_edge_style=(style)
133
- end
134
-
135
- end
1
+ # Copyright:: Copyright 2020 Trimble Inc.
2
+ # License:: The MIT License (MIT)
3
+
4
+ # A {Layout::TableColumn} is a single row from a table.
5
+ #
6
+ # @example
7
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
8
+ # rows = 4
9
+ # columns = 4
10
+ # table = Layout::Table.new(bounds, rows, columns)
11
+ # rows.times { |index|
12
+ # row = table.row(index)
13
+ # }
14
+ #
15
+ # @version LayOut 2018
16
+ class Layout::TableRow
17
+
18
+ # Instance Methods
19
+
20
+ # The {#bottom_edge_style} method returns the {Layout::Style} of a
21
+ # {Layout::TableRow}'s bottom edge.
22
+ #
23
+ # @example
24
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
25
+ # rows = 4
26
+ # columns = 4
27
+ # table = Layout::Table.new(bounds, rows, columns)
28
+ # style = table.get_row(1).bottom_edge_style
29
+ #
30
+ # @return [Layout::Style]
31
+ #
32
+ # @version LayOut 2018
33
+ def bottom_edge_style
34
+ end
35
+
36
+ # The {#bottom_edge_style=} method sets the {Layout::Style} of a
37
+ # {Layout::TableRow}'s bottom edge.
38
+ #
39
+ # @example
40
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
41
+ # rows = 4
42
+ # columns = 4
43
+ # table = Layout::Table.new(bounds, rows, columns)
44
+ # style = Layout::Style.new
45
+ # style.stroke_width = 2.0
46
+ # table.get_row(1).bottom_edge_style = style
47
+ #
48
+ # @param [Layout::Style] style
49
+ #
50
+ # @raise [LockedLayerError] if the {Layout::Table} is on a locked
51
+ # {Layout::Layer}
52
+ #
53
+ # @raise [LockedEntityError] if the {Layout::Table} is locked
54
+ #
55
+ # @version LayOut 2018
56
+ def bottom_edge_style=(style)
57
+ end
58
+
59
+ # The {#height} method returns the height of the {Layout::TableRow}.
60
+ #
61
+ # @example
62
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
63
+ # rows = 4
64
+ # columns = 4
65
+ # table = Layout::Table.new(bounds, rows, columns)
66
+ # height = table.get_row(1).height
67
+ #
68
+ # @return [Float]
69
+ #
70
+ # @version LayOut 2018
71
+ def height
72
+ end
73
+
74
+ # The {#height=} method sets the height of the {Layout::TableRow}.
75
+ #
76
+ # @example
77
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
78
+ # rows = 4
79
+ # columns = 4
80
+ # table = Layout::Table.new(bounds, rows, columns)
81
+ # table.get_row(1).height = 3.0
82
+ #
83
+ # @param [Float] height
84
+ #
85
+ # @raise [ArgumentError] if height is not a valid height
86
+ #
87
+ # @raise [LockedLayerError] if the {Layout::Table} is on a locked
88
+ # {Layout::Layer}
89
+ #
90
+ # @raise [LockedEntityError] if the {Layout::Table} is locked
91
+ #
92
+ # @version LayOut 2018
93
+ def height=(height)
94
+ end
95
+
96
+ # The {#top_edge_style} method returns the {Layout::Style} of a
97
+ # {Layout::TableRow}'s top edge.
98
+ #
99
+ # @example
100
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
101
+ # rows = 4
102
+ # columns = 4
103
+ # table = Layout::Table.new(bounds, rows, columns)
104
+ # style = table.get_row(1).top_edge_style
105
+ #
106
+ # @return [Layout::Style]
107
+ #
108
+ # @version LayOut 2018
109
+ def top_edge_style
110
+ end
111
+
112
+ # The {#top_edge_style=} method sets the {Layout::Style} of a
113
+ # {Layout::TableRow}'s top edge.
114
+ #
115
+ # @example
116
+ # bounds = Geom::Bounds2d.new(1, 1, 4, 4)
117
+ # rows = 4
118
+ # columns = 4
119
+ # table = Layout::Table.new(bounds, rows, columns)
120
+ # style = Layout::Style.new
121
+ # style.stroke_width = 2.0
122
+ # table.get_row(1).top_edge_style = style
123
+ #
124
+ # @param [Layout::Style] style
125
+ #
126
+ # @raise [LockedLayerError] if the {Layout::Table} is on a locked
127
+ # {Layout::Layer}
128
+ #
129
+ # @raise [LockedEntityError] if the {Layout::Table} is locked
130
+ #
131
+ # @version LayOut 2018
132
+ def top_edge_style=(style)
133
+ end
134
+
135
+ end
@@ -1,140 +1,144 @@
1
- # Copyright:: Copyright 2020 Trimble Inc.
2
- # License:: The MIT License (MIT)
3
-
4
- # The {Sketchup::Animation} interface is implemented to create animations
5
- # inside SketchUp. At any given time, a single animation can be active on a
6
- # {Sketchup::View}. To make your own, build a Ruby class that contains the
7
- # methods described below:
8
- #
9
- # # This is an example of a simple animation that floats the camera up to
10
- # # a z position of 200". The only required method for an animation is
11
- # # nextFrame. It is called whenever you need to show the next frame of
12
- # # the animation. If nextFrame returns false, the animation will stop.
13
- # class FloatUpAnimation
14
- # def nextFrame(view)
15
- # new_eye = view.camera.eye
16
- # new_eye.z = new_eye.z + 1.0
17
- # view.camera.set(new_eye, view.camera.target, view.camera.up)
18
- # view.show_frame
19
- # return new_eye.z < 500.0
20
- # end
21
- # end
22
- #
23
- # # This adds an item to the Camera menu to activate our custom animation.
24
- # UI.menu("Camera").add_item("Run Float Up Animation") {
25
- # Sketchup.active_model.active_view.animation = FloatUpAnimation.new
26
- # }
27
- #
28
- # {Sketchup::Animation} objects are activated by using the
29
- # {Sketchup::View#animation=} method on a {Sketchup::View}
30
- # object. To stop an animation set the view's animation object to +nil+, like
31
- # so:
32
- #
33
- # Sketchup.active_model.active_view.animation = nil
34
- #
35
- # @version SketchUp 6.0
36
- class Sketchup::Animation
37
-
38
- # Instance Methods
39
-
40
- # The {#nextFrame} method is invoked by SketchUp to tell the animation to
41
- # display its next frame. This method should set up the camera and then call
42
- # {Sketchup::View#show_frame}.
43
- #
44
- # The {#nextFrame} method is the only required method of the
45
- # {Sketchup::Animation} interface that you must implement.
46
- #
47
- # @example
48
- # def nextFrame(view)
49
- # # Insert your handler code for updating the camera or other entities.
50
- # view.show_frame
51
- # return true
52
- # end
53
- #
54
- # @param [Sketchup::View] view
55
- # The view for the animation.
56
- #
57
- # @return [Boolean] continue - +true+ if you want the animation to continue
58
- # on to the next frame, +false+ if you want the animation
59
- # to stop after this frame.
60
- #
61
- # @version SketchUp 6.0
62
- #
63
- # @version SketchUp 6.0
64
- def nextFrame(view)
65
- end
66
-
67
- # The {#pause} method is invoked by SketchUp when the animation is paused.
68
- #
69
- # This method is optional (you do not need to implement this method unless you
70
- # want to perform some specialized function when the animation is paused). You
71
- # cannot call this method in your code explicitly and expect an animation to
72
- # pause, only certain SketchUp events cause the method to be called.
73
- #
74
- # @example
75
- # def pause
76
- # # Insert handler code for whatever you need to do when it is paused.
77
- # end
78
- #
79
- # @note The user interface for pausing and resuming animations isn't integrated
80
- # with the Ruby API in the current version, so this method is probably not
81
- # useful to you.
82
- #
83
- # @return [nil]
84
- #
85
- # @version SketchUp 6.0
86
- def pause
87
- end
88
-
89
- # The {#resume} method is invoked by SketchUp when the animation is resumed
90
- # after being paused.
91
- #
92
- # This method is optional (you do not need to implement this method unless you
93
- # want to perform some specialized function when the animation is resumed).
94
- # You cannot call this method in your code explicitly and expect an animation
95
- # to stop, only certain SketchUp events cause the method to be called.
96
- #
97
- # @example
98
- # def resume
99
- # # Insert your handler code for whatever you need to do as you resume.
100
- # end
101
- #
102
- # @note The user interface for pausing and resuming animations isn't integrated
103
- # with the Ruby API in the current version, so this method is probably not
104
- # useful to you.
105
- #
106
- # @return [nil]
107
- #
108
- # @version SketchUp 6.0
109
- def resume
110
- end
111
-
112
- # The {#stop} method is invoked by SketchUp when the animation is stopped.
113
- #
114
- # This method is optional (you do not need to implement this method unless you
115
- # want to perform some specialized function when the animation is stopped). You
116
- # cannot call this method in your code explicitly and expect an animation to
117
- # stop, only certain SketchUp events cause the method to be called.
118
- #
119
- # Perhaps the most common way for this method to be called is when your Ruby
120
- # code sets {Sketchup::View#animation=} to +nil+. See the class comments for
121
- # an example of this.
122
- #
123
- # @example
124
- # class MyAnimation
125
- # def stop
126
- # # Insert your handler code for cleaning up after your animation.
127
- # end
128
- # end
129
- #
130
- # @note Do not call {#Sketchup::View#animation=} from this method. This will
131
- # cause a recursive loop and crash SketchUp 2017 and earlier versions.
132
- # As of SketchUp 2018 this will raise a +RunTimeError+.
133
- #
134
- # @return [nil]
135
- #
136
- # @version SketchUp 6.0
137
- def stop
138
- end
139
-
140
- end
1
+ # Copyright:: Copyright 2020 Trimble Inc.
2
+ # License:: The MIT License (MIT)
3
+
4
+ # The {Sketchup::Animation} interface is implemented to create animations
5
+ # inside SketchUp. At any given time, a single animation can be active on a
6
+ # {Sketchup::View}. To make your own, build a Ruby class that contains the
7
+ # methods described below:
8
+ #
9
+ # # This is an example of a simple animation that floats the camera up to
10
+ # # a z position of 200". The only required method for an animation is
11
+ # # nextFrame. It is called whenever you need to show the next frame of
12
+ # # the animation. If nextFrame returns false, the animation will stop.
13
+ # class FloatUpAnimation
14
+ # def nextFrame(view)
15
+ # new_eye = view.camera.eye
16
+ # new_eye.z = new_eye.z + 1.0
17
+ # view.camera.set(new_eye, view.camera.target, view.camera.up)
18
+ # view.show_frame
19
+ # return new_eye.z < 500.0
20
+ # end
21
+ # end
22
+ #
23
+ # # This adds an item to the Camera menu to activate our custom animation.
24
+ # UI.menu("Camera").add_item("Run Float Up Animation") {
25
+ # Sketchup.active_model.active_view.animation = FloatUpAnimation.new
26
+ # }
27
+ #
28
+ # {Sketchup::Animation} objects are activated by using the
29
+ # {Sketchup::View#animation=} method on a {Sketchup::View}
30
+ # object. To stop an animation set the view's animation object to +nil+, like
31
+ # so:
32
+ #
33
+ # Sketchup.active_model.active_view.animation = nil
34
+ #
35
+ # @abstract Implement the methods described in this class to create a an
36
+ # animation. You can not sub-class this class because it is not defined by
37
+ # the API.
38
+ #
39
+ # @version SketchUp 6.0
40
+ class Sketchup::Animation
41
+
42
+ # Instance Methods
43
+
44
+ # The {#nextFrame} method is invoked by SketchUp to tell the animation to
45
+ # display its next frame. This method should set up the camera and then call
46
+ # {Sketchup::View#show_frame}.
47
+ #
48
+ # The {#nextFrame} method is the only required method of the
49
+ # {Sketchup::Animation} interface that you must implement.
50
+ #
51
+ # @example
52
+ # def nextFrame(view)
53
+ # # Insert your handler code for updating the camera or other entities.
54
+ # view.show_frame
55
+ # return true
56
+ # end
57
+ #
58
+ # @param [Sketchup::View] view
59
+ # The view for the animation.
60
+ #
61
+ # @return [Boolean] continue - +true+ if you want the animation to continue
62
+ # on to the next frame, +false+ if you want the animation
63
+ # to stop after this frame.
64
+ #
65
+ # @version SketchUp 6.0
66
+ #
67
+ # @version SketchUp 6.0
68
+ def nextFrame(view)
69
+ end
70
+
71
+ # The {#pause} method is invoked by SketchUp when the animation is paused.
72
+ #
73
+ # This method is optional (you do not need to implement this method unless you
74
+ # want to perform some specialized function when the animation is paused). You
75
+ # cannot call this method in your code explicitly and expect an animation to
76
+ # pause, only certain SketchUp events cause the method to be called.
77
+ #
78
+ # @example
79
+ # def pause
80
+ # # Insert handler code for whatever you need to do when it is paused.
81
+ # end
82
+ #
83
+ # @note The user interface for pausing and resuming animations isn't integrated
84
+ # with the Ruby API in the current version, so this method is probably not
85
+ # useful to you.
86
+ #
87
+ # @return [nil]
88
+ #
89
+ # @version SketchUp 6.0
90
+ def pause
91
+ end
92
+
93
+ # The {#resume} method is invoked by SketchUp when the animation is resumed
94
+ # after being paused.
95
+ #
96
+ # This method is optional (you do not need to implement this method unless you
97
+ # want to perform some specialized function when the animation is resumed).
98
+ # You cannot call this method in your code explicitly and expect an animation
99
+ # to stop, only certain SketchUp events cause the method to be called.
100
+ #
101
+ # @example
102
+ # def resume
103
+ # # Insert your handler code for whatever you need to do as you resume.
104
+ # end
105
+ #
106
+ # @note The user interface for pausing and resuming animations isn't integrated
107
+ # with the Ruby API in the current version, so this method is probably not
108
+ # useful to you.
109
+ #
110
+ # @return [nil]
111
+ #
112
+ # @version SketchUp 6.0
113
+ def resume
114
+ end
115
+
116
+ # The {#stop} method is invoked by SketchUp when the animation is stopped.
117
+ #
118
+ # This method is optional (you do not need to implement this method unless you
119
+ # want to perform some specialized function when the animation is stopped). You
120
+ # cannot call this method in your code explicitly and expect an animation to
121
+ # stop, only certain SketchUp events cause the method to be called.
122
+ #
123
+ # Perhaps the most common way for this method to be called is when your Ruby
124
+ # code sets {Sketchup::View#animation=} to +nil+. See the class comments for
125
+ # an example of this.
126
+ #
127
+ # @example
128
+ # class MyAnimation
129
+ # def stop
130
+ # # Insert your handler code for cleaning up after your animation.
131
+ # end
132
+ # end
133
+ #
134
+ # @note Do not call {#Sketchup::View#animation=} from this method. This will
135
+ # cause a recursive loop and crash SketchUp 2017 and earlier versions.
136
+ # As of SketchUp 2018 this will raise a +RunTimeError+.
137
+ #
138
+ # @return [nil]
139
+ #
140
+ # @version SketchUp 6.0
141
+ def stop
142
+ end
143
+
144
+ end