topic Re: FindInserts what does includeShadows flag do? in Revit API Forum

FindInserts what does includeShadows flag do?

hzamani — Mon, 16 Dec 2019 01:22:51 GMT

Hi,

Curious what does the includeShadows flag do in FindInserts method of the HostObject class.

The documentation says "True if shadows should be included in the return." But this doesn't make any sense to me.

Could anyone possibly shine some light on this?

jeremytammik — Mon, 16 Dec 2019 21:20:48 GMT

Good question. Thank you for asking.

I see two more of the same in the revitapidocs page:

I'll ask the development team for you.

jeremytammik — Tue, 17 Dec 2019 10:42:26 GMT

The development team replied:

An internal WallShadowCutoutGStep is created when 2 walls are joined, e.g., by Modify > Geometry > Join, and then a window is placed on one wall.

In that case, Revit will cut an opening on the other joined wall, as you can see in this picture:

For this API - FindInserts, here is a short demo - I try to find the Inserts on the joined wall but not the wall with the window.

The window instance (ID: 354965) is returned if includeShadows is true, and nothing returned for false.

Many thanks to Phil Xia for this detailed explanation!

Revitalizer — Tue, 17 Dec 2019 10:57:00 GMT

Thank you for bringing light into the shadow 🙂

Rudi

hzamani — Wed, 18 Dec 2019 21:31:42 GMT

Thank you very much Jeremy for following this up and the complete answer.

Makes much sense now.

amir.aroesti — Wed, 17 Jun 2020 06:19:58 GMT

And what about includeSharedEmbeddedInserts ?

jeremytammik — Wed, 17 Jun 2020 06:40:29 GMT

Have you searched the Internet for the answer yourself yet? I see a number of hits when I try it out...

amir.aroesti — Wed, 17 Jun 2020 09:32:54 GMT

the fact that I found out this post of related subject can indicate that I did try to search the internet before.

maybe not good enough but I tried.☹️

jeremytammik — Wed, 17 Jun 2020 10:34:56 GMT

Okey-doke. Well, I cannot do much more myself. Searching for 'Revit includeSharedEmbeddedInserts' turns up this:

That shows an image showing a sample result with the following explanation:

Get the door, window, or other inserts that are hosted in the embedded wall.

amir.aroesti — Wed, 17 Jun 2020 11:04:02 GMT