"Surfaces" in the SketchUp C API

PeteRimkus · April 29, 2022, 2:49pm

Hello.
I have started using the SketchUp C API to import SKP files into our standalone app.
Is there a way within the API to access what SketchUp considers a “Surface” which appears to be a set of connected faces.

For instance, when using the attached SKP file…

Faces and Surfaces.zip (7.8 MB)

…the webapp will report ‘info’ where some selections are faces:

and some are surfaces:

I don’t see a way in the API to get the surfaces - knowing that some faces are connected instead of all being independent would greatly increase our performance when making polygonal meshes from the faces.

Any ideas?

Thanks in advance.

DanRathbun · April 29, 2022, 5:48pm

The edges between “surface” faces are softened and/or smoothed.

The “surface” feature is a GUI feature and I do not think either API (Ruby nor C) has a “get surface” method / function.

So within any entities collection (model, group or component) you would need to filter the faces you get back. It might be easier to collect the edges, and filter out any that are not softened or smoothed. Then get the faces that share the remainder. You’ll need to decide whether you also need the unsoftened / unsmoothed border edges.

DanRathbun · April 29, 2022, 5:52pm

Another possibility is to go via the EdgeUse. If you have a face that is part of a surface, having a smoothed / softened edge, then you get the next connected edge from the edge’s EdgeUse object and from that the connected face. … And so on.

PeteRimkus · April 29, 2022, 6:52pm

Dan,

Thanks for verifying the issue regarding ‘surfaces’ and the API … and for the suggestions about how edges and “edgeuse” might help.

Pete

DanRathbun · April 30, 2022, 11:34am

It was a second thought because any entities collection might have more than 1 independent “surface” feature. The 1st suggestion would treat them all as one, which might lead to an erroneous import.

tt_su · May 4, 2022, 10:21am

Yea, no API for this. (You can log a ticket here: GitHub - SketchUp/api-issue-tracker: Public issue tracker for the SketchUp and LayOut's APIs)

Can you expand on this? I’d like to understand this scenario better.

I had to find the surfaces myself in the OBJ exporter for QuadFace Tools:

github.com

thomthom/quadface-tools/blob/52846435bcd6a4cfc20749c23389fb05b96c9215/src/TT_QuadFaceTools/entities.rb#L791


      
            def edges

              triangle1, triangle2 = @faces

              divider = triangle1.edges & triangle2.edges

              ( triangle1.edges + triangle2.edges ) - divider

            end

          

          end # class VirtualQuadFace

          

          

          # @since 0.7.0

          class Surface < Entity

          

            attr_reader :faces

          

            # @param [Sketchup::Entity] entities

            # @param [Boolean] sketchup_surface

            #

            # @return [Array<Sketchup::Entity, Surface>]

            # @since 0.7.0

            def self.get( entities, sketchup_surface = false  )

              cache = {}

It’s tied deeply with the logic of dealing with QFT quads, but maybe the gist of the logic will help you out?

PeteRimkus · June 1, 2022, 7:50pm

Thanks for the snippet … I’ll investigate to see if that will help.
What I’m doing is trying to build individual mesh entities out of connected facets. Fortunately we have some tools here that can take a large set of triangular facets and build what I need, but its basically a post-processor that I need to invoke whereas if the SketchUp API were to tell me what faces connect to make what the webapp will report as surfaces, them I think I can manage it upstream instead of downstream.

PeteRimkus · June 1, 2022, 7:54pm

I tried going to the issue tracker but got this:

… be gentle … its my first time…

tt_su · June 8, 2022, 9:07am

Hm… I think that might be something to do with the policies of the GitHub Enterprise you are member of. Sounds like they added restraints to your account?