sketchup-api-stubs 0.6.1 → 0.7.4

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 (149) hide show
  1. checksums.yaml +4 -4
  2. data/.yardopts +2 -0
  3. data/lib/sketchup-api-stubs.rb +1 -1
  4. data/lib/sketchup-api-stubs/sketchup.rb +145 -145
  5. data/lib/sketchup-api-stubs/stubs/Geom/BoundingBox.rb +318 -318
  6. data/lib/sketchup-api-stubs/stubs/Geom/Bounds2d.rb +172 -172
  7. data/lib/sketchup-api-stubs/stubs/Geom/LatLong.rb +126 -126
  8. data/lib/sketchup-api-stubs/stubs/Geom/OrientedBounds2d.rb +102 -102
  9. data/lib/sketchup-api-stubs/stubs/Geom/Point2d.rb +400 -401
  10. data/lib/sketchup-api-stubs/stubs/Geom/Point3d.rb +661 -661
  11. data/lib/sketchup-api-stubs/stubs/Geom/PolygonMesh.rb +492 -492
  12. data/lib/sketchup-api-stubs/stubs/Geom/Transformation.rb +478 -478
  13. data/lib/sketchup-api-stubs/stubs/Geom/Transformation2d.rb +263 -263
  14. data/lib/sketchup-api-stubs/stubs/Geom/UTM.rb +141 -141
  15. data/lib/sketchup-api-stubs/stubs/Geom/Vector2d.rb +522 -523
  16. data/lib/sketchup-api-stubs/stubs/Geom/Vector3d.rb +691 -691
  17. data/lib/sketchup-api-stubs/stubs/Layout.rb +25 -25
  18. data/lib/sketchup-api-stubs/stubs/Layout/AngularDimension.rb +573 -569
  19. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinition.rb +411 -411
  20. data/lib/sketchup-api-stubs/stubs/Layout/AutoTextDefinitions.rb +174 -186
  21. data/lib/sketchup-api-stubs/stubs/Layout/ConnectionPoint.rb +70 -70
  22. data/lib/sketchup-api-stubs/stubs/Layout/Document.rb +514 -455
  23. data/lib/sketchup-api-stubs/stubs/Layout/Ellipse.rb +29 -29
  24. data/lib/sketchup-api-stubs/stubs/Layout/Entities.rb +143 -155
  25. data/lib/sketchup-api-stubs/stubs/Layout/Entity.rb +353 -359
  26. data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +349 -349
  27. data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -123
  28. data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
  29. data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -86
  30. data/lib/sketchup-api-stubs/stubs/Layout/Label.rb +371 -371
  31. data/lib/sketchup-api-stubs/stubs/Layout/Layer.rb +218 -218
  32. data/lib/sketchup-api-stubs/stubs/Layout/LayerInstance.rb +128 -128
  33. data/lib/sketchup-api-stubs/stubs/Layout/Layers.rb +220 -232
  34. data/lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb +567 -563
  35. data/lib/sketchup-api-stubs/stubs/Layout/LockedEntityError.rb +10 -10
  36. data/lib/sketchup-api-stubs/stubs/Layout/LockedLayerError.rb +11 -11
  37. data/lib/sketchup-api-stubs/stubs/Layout/Page.rb +183 -183
  38. data/lib/sketchup-api-stubs/stubs/Layout/PageInfo.rb +387 -387
  39. data/lib/sketchup-api-stubs/stubs/Layout/Pages.rb +204 -216
  40. data/lib/sketchup-api-stubs/stubs/Layout/Path.rb +344 -344
  41. data/lib/sketchup-api-stubs/stubs/Layout/Rectangle.rb +174 -174
  42. data/lib/sketchup-api-stubs/stubs/Layout/SketchUpModel.rb +694 -547
  43. data/lib/sketchup-api-stubs/stubs/Layout/Style.rb +1519 -1519
  44. data/lib/sketchup-api-stubs/stubs/Layout/Table.rb +290 -290
  45. data/lib/sketchup-api-stubs/stubs/Layout/TableCell.rb +149 -149
  46. data/lib/sketchup-api-stubs/stubs/Layout/TableColumn.rb +139 -139
  47. data/lib/sketchup-api-stubs/stubs/Layout/TableRow.rb +135 -135
  48. data/lib/sketchup-api-stubs/stubs/Sketchup/Animation.rb +140 -140
  49. data/lib/sketchup-api-stubs/stubs/Sketchup/AppObserver.rb +157 -157
  50. data/lib/sketchup-api-stubs/stubs/Sketchup/ArcCurve.rb +209 -209
  51. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionaries.rb +152 -152
  52. data/lib/sketchup-api-stubs/stubs/Sketchup/AttributeDictionary.rb +281 -281
  53. data/lib/sketchup-api-stubs/stubs/Sketchup/Axes.rb +149 -149
  54. data/lib/sketchup-api-stubs/stubs/Sketchup/Behavior.rb +328 -328
  55. data/lib/sketchup-api-stubs/stubs/Sketchup/Camera.rb +577 -577
  56. data/lib/sketchup-api-stubs/stubs/Sketchup/ClassificationSchema.rb +63 -63
  57. data/lib/sketchup-api-stubs/stubs/Sketchup/Classifications.rb +122 -122
  58. data/lib/sketchup-api-stubs/stubs/Sketchup/Color.rb +281 -281
  59. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentDefinition.rb +562 -554
  60. data/lib/sketchup-api-stubs/stubs/Sketchup/ComponentInstance.rb +593 -593
  61. data/lib/sketchup-api-stubs/stubs/Sketchup/Console.rb +76 -76
  62. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionLine.rb +257 -257
  63. data/lib/sketchup-api-stubs/stubs/Sketchup/ConstructionPoint.rb +32 -32
  64. data/lib/sketchup-api-stubs/stubs/Sketchup/Curve.rb +194 -194
  65. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionList.rb +329 -329
  66. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionObserver.rb +72 -72
  67. data/lib/sketchup-api-stubs/stubs/Sketchup/DefinitionsObserver.rb +102 -102
  68. data/lib/sketchup-api-stubs/stubs/Sketchup/Dimension.rb +165 -165
  69. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionLinear.rb +312 -312
  70. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionObserver.rb +38 -38
  71. data/lib/sketchup-api-stubs/stubs/Sketchup/DimensionRadial.rb +87 -87
  72. data/lib/sketchup-api-stubs/stubs/Sketchup/Drawingelement.rb +390 -390
  73. data/lib/sketchup-api-stubs/stubs/Sketchup/Edge.rb +508 -508
  74. data/lib/sketchup-api-stubs/stubs/Sketchup/EdgeUse.rb +211 -211
  75. data/lib/sketchup-api-stubs/stubs/Sketchup/Entities.rb +1119 -1097
  76. data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +125 -125
  77. data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +544 -537
  78. data/lib/sketchup-api-stubs/stubs/Sketchup/EntityObserver.rb +59 -59
  79. data/lib/sketchup-api-stubs/stubs/Sketchup/ExtensionsManager.rb +125 -125
  80. data/lib/sketchup-api-stubs/stubs/Sketchup/Face.rb +750 -750
  81. data/lib/sketchup-api-stubs/stubs/Sketchup/FrameChangeObserver.rb +104 -104
  82. data/lib/sketchup-api-stubs/stubs/Sketchup/Group.rb +697 -697
  83. data/lib/sketchup-api-stubs/stubs/Sketchup/Http.rb +27 -27
  84. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Request.rb +285 -285
  85. data/lib/sketchup-api-stubs/stubs/Sketchup/Http/Response.rb +62 -62
  86. data/lib/sketchup-api-stubs/stubs/Sketchup/Image.rb +409 -409
  87. data/lib/sketchup-api-stubs/stubs/Sketchup/ImageRep.rb +226 -226
  88. data/lib/sketchup-api-stubs/stubs/Sketchup/Importer.rb +190 -190
  89. data/lib/sketchup-api-stubs/stubs/Sketchup/InputPoint.rb +393 -393
  90. data/lib/sketchup-api-stubs/stubs/Sketchup/InstanceObserver.rb +82 -82
  91. data/lib/sketchup-api-stubs/stubs/Sketchup/InstancePath.rb +303 -303
  92. data/lib/sketchup-api-stubs/stubs/Sketchup/Layer.rb +285 -262
  93. data/lib/sketchup-api-stubs/stubs/Sketchup/Layers.rb +244 -231
  94. data/lib/sketchup-api-stubs/stubs/Sketchup/LayersObserver.rb +136 -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 -123
  99. data/lib/sketchup-api-stubs/stubs/Sketchup/Loop.rb +137 -137
  100. data/lib/sketchup-api-stubs/stubs/Sketchup/Material.rb +416 -416
  101. data/lib/sketchup-api-stubs/stubs/Sketchup/Materials.rb +311 -311
  102. data/lib/sketchup-api-stubs/stubs/Sketchup/MaterialsObserver.rb +141 -141
  103. data/lib/sketchup-api-stubs/stubs/Sketchup/Menu.rb +95 -95
  104. data/lib/sketchup-api-stubs/stubs/Sketchup/Model.rb +1638 -1483
  105. data/lib/sketchup-api-stubs/stubs/Sketchup/ModelObserver.rb +356 -356
  106. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsManager.rb +132 -132
  107. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProvider.rb +284 -282
  108. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
  109. data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +770 -650
  110. data/lib/sketchup-api-stubs/stubs/Sketchup/Pages.rb +353 -353
  111. data/lib/sketchup-api-stubs/stubs/Sketchup/PagesObserver.rb +76 -76
  112. data/lib/sketchup-api-stubs/stubs/Sketchup/PickHelper.rb +456 -456
  113. data/lib/sketchup-api-stubs/stubs/Sketchup/RegionalSettings.rb +43 -43
  114. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptions.rb +364 -356
  115. data/lib/sketchup-api-stubs/stubs/Sketchup/RenderingOptionsObserver.rb +44 -44
  116. data/lib/sketchup-api-stubs/stubs/Sketchup/SectionPlane.rb +150 -150
  117. data/lib/sketchup-api-stubs/stubs/Sketchup/Selection.rb +454 -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 +57 -57
  122. data/lib/sketchup-api-stubs/stubs/Sketchup/Style.rb +69 -69
  123. data/lib/sketchup-api-stubs/stubs/Sketchup/Styles.rb +211 -211
  124. data/lib/sketchup-api-stubs/stubs/Sketchup/Text.rb +262 -262
  125. data/lib/sketchup-api-stubs/stubs/Sketchup/Texture.rb +225 -225
  126. data/lib/sketchup-api-stubs/stubs/Sketchup/TextureWriter.rb +237 -237
  127. data/lib/sketchup-api-stubs/stubs/Sketchup/Tool.rb +829 -829
  128. data/lib/sketchup-api-stubs/stubs/Sketchup/Tools.rb +132 -132
  129. data/lib/sketchup-api-stubs/stubs/Sketchup/ToolsObserver.rb +154 -154
  130. data/lib/sketchup-api-stubs/stubs/Sketchup/UVHelper.rb +61 -61
  131. data/lib/sketchup-api-stubs/stubs/Sketchup/Vertex.rb +142 -142
  132. data/lib/sketchup-api-stubs/stubs/Sketchup/View.rb +1301 -995
  133. data/lib/sketchup-api-stubs/stubs/Sketchup/ViewObserver.rb +43 -43
  134. data/lib/sketchup-api-stubs/stubs/UI/Command.rb +310 -310
  135. data/lib/sketchup-api-stubs/stubs/UI/HtmlDialog.rb +356 -356
  136. data/lib/sketchup-api-stubs/stubs/UI/Notification.rb +229 -229
  137. data/lib/sketchup-api-stubs/stubs/UI/Toolbar.rb +240 -240
  138. data/lib/sketchup-api-stubs/stubs/UI/WebDialog.rb +633 -633
  139. data/lib/sketchup-api-stubs/stubs/_top_level.rb +311 -303
  140. data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
  141. data/lib/sketchup-api-stubs/stubs/geom.rb +348 -233
  142. data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
  143. data/lib/sketchup-api-stubs/stubs/length.rb +278 -262
  144. data/lib/sketchup-api-stubs/stubs/numeric.rb +249 -249
  145. data/lib/sketchup-api-stubs/stubs/sketchup.rb +1310 -1310
  146. data/lib/sketchup-api-stubs/stubs/sketchupextension.rb +353 -353
  147. data/lib/sketchup-api-stubs/stubs/string.rb +24 -24
  148. data/lib/sketchup-api-stubs/stubs/ui.rb +667 -660
  149. metadata +2 -16
@@ -1,135 +1,135 @@
1
- # Copyright:: Copyright 2019 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,140 @@
1
- # Copyright:: Copyright 2019 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
+ # @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