Access to "Include in Animation" from Ruby API


Why was this feature left out? Most of our models consist of an animation fly-through, and several still scenes for various key viewpoints. The stills are not included in the animation for obvious reasons. I have automated our process of creating scenes for production, but the automation becomes pointless if the end user has to manually find and uncheck each scene to be excluded from the animation. This is extremely frustrating and some method of creating an excluded scene is entirely necessary if any scenes at all are to be created from the Ruby API. Pages.add is crippled without this feature. I am so frustrated with this that I absolutely refuse to upgrade my pro licenses until this feature is added, as it is the single largest improvement that can be incorporated into Sketchup for our use.


I recall it is all in the ‘naming’…
to exclude from an animation from ruby, both ‘page.label’ and ‘’ need brackets (around_name)

@DanRathbun had some detailed post’s about pages…



The brackets are just added in the UI to show the scene isn’t included in the animation. They are not a part of the actual scene name. A scene can have brackets in the name while being included in the animation and if the same scene is later excluded it will show with double brackets in the scene tab.


Dan asked for this feature with no success as far as I can find. Since page.label is read only, adding brackets here is not a possibility. If you add brackets to, you simply put brackets in the name string like eneroth mentioned.


:earth_africa: :astonished:

The native animation feature(s) have always been rudimentary, and likely not expanded as they were considered a professional feature. (Ie, there are limitations in the Free / Make editions with regard to animation export.)

Basically I think that their status (as to expansion) is “in limbo” and have been put off as the 3rd party animation extensions have been filling the gap for the most part. That and other features have had higher priority.

True, as of SketchUp v2017, this FR has not yet been implemented. (It is just one of those minor API omissions that has not yet percolated to the top of the “to do” list.)

This is likely to change in the future, especially for SketchUp Pro as there have been quite a few animation feature requests that are (or should) only be implemented in the Pro edition(s).

There are other long hoped for “core” feature requests that’ll probably be implemented before animation gets any more “love”, but these other “core” features are happening slowly, so it’s only a matter of time.

Actually, the brackets are added to the page object’s label (read-only) property.

Adding brackets to the name property will have no effect on the animation page set.

So, currently (as of SketchUp v2017,) there is no easy API means to set a page to be included or not be included in animation.

I posted a query method (to determine if a user has manually set a page to be included in animation,) that should work for any old version (even if a page’s name has it’s own brackets.) :

I did explore a possible workaround using template pages in this thread:

I also wonder if a component file with a scene could be used ? The component could be only a cpoint at the ORIGIN, but have the proper kind of page (included or not included in animation.)


That is an interesting idea, I was not able to find scene information saved into my component files after inserting the components back into a new model though.


Well if there is anyone else out there in the Sketchup Universe that needs to include (or exclude) scenes in their animation programmatically and simply, pipe up. Otherwise, this will likely not happen. Thanks.



The new API additions for SketchUp 2018 are live in the API docs:

Feel free to update …

See API Release Notes:


This is makes me happy to see!


This is a huge relief to me. I am almost crying right now, I am so excited about this.


so have you???




I was just discussing this with my boss, we will be bringing current 6 licenses in the next few weeks. :smile:




This topic was automatically closed 91 days after the last reply. New replies are no longer allowed.