sketchup-api-stubs 0.7.3 → 0.7.4

Sign up to get free protection for your applications and to get access to all the features.
Files changed (149) hide show
  1. checksums.yaml +5 -5
  2. data/.yardopts +9 -9
  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 -400
  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 -522
  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 -573
  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 -514
  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 -353
  26. data/lib/sketchup-api-stubs/stubs/Layout/FormattedText.rb +349 -349
  27. data/lib/sketchup-api-stubs/stubs/Layout/Grid.rb +311 -311
  28. data/lib/sketchup-api-stubs/stubs/Layout/Group.rb +261 -261
  29. data/lib/sketchup-api-stubs/stubs/Layout/Image.rb +91 -91
  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 -567
  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 -694
  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 -562
  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 -1119
  76. data/lib/sketchup-api-stubs/stubs/Sketchup/EntitiesObserver.rb +125 -125
  77. data/lib/sketchup-api-stubs/stubs/Sketchup/Entity.rb +544 -544
  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 -280
  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 -1601
  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 -284
  108. data/lib/sketchup-api-stubs/stubs/Sketchup/OptionsProviderObserver.rb +58 -58
  109. data/lib/sketchup-api-stubs/stubs/Sketchup/Page.rb +770 -770
  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 -364
  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 -1301
  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 -311
  140. data/lib/sketchup-api-stubs/stubs/array.rb +741 -741
  141. data/lib/sketchup-api-stubs/stubs/geom.rb +348 -348
  142. data/lib/sketchup-api-stubs/stubs/languagehandler.rb +92 -92
  143. data/lib/sketchup-api-stubs/stubs/length.rb +278 -278
  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 -667
  149. metadata +3 -4
@@ -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,140 @@
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
+ # @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