New API doc - typos and questions

scottlininger

Just saw another one: the Sketchup.break_edges= example is the Sketchup.break_edges? example.

Thom, step 1 with the observers is to confirm if it's the implementation that is broken or the documentation. Simone has filed A-list bugs against the observer problems you've found, and he and I have been chatting about it. Any fixes will have to wait until the next maintenance release.

Feel free to PM me if you want to brainstorm workarounds for what you're trying to accomplish. I know a few tricks.

remus

Dont pretend your not in on it as well

on a more serious note, it seems a shame to miss out on the ever so powerful ruby based capabilities of sketchup, so i thought i'd try my hand at it and see if i got anywhere.

I reckon i could just about right a box making script at the moment just as long as you dont want to change your box at all...

thomthom

Seems that InstanceObserver.onClose is dead as well. http://code.google.com/apis/sketchup/docs/ourdoc/instanceobserver.html#onClose
But onOpen works.

thomthom

Error 404 (Not Found)!!1

(code.google.com)

@unknownuser said:

For example, if a user has double-clicked into a component to edit its geometry, and then double clicked into a sub-group to edit that, the active_path might contain:

And there it stops. Doesn't actually display an example.

scottlininger

Self note: We should add these codes to the send_action docs:

http://groups.google.com/group/Ruby-API/msg/e30ee3f2b21cb228

thomthom

http://code.google.com/apis/sketchup/docs/ourdoc/toolsobserver.html


     # This is an example of an observer that watches tool interactions.
     class MyToolsObserver < Sketchup;;ShadowInfoObserver
       def onActiveToolChanged(tools, tool_name, tool_id)
         UI.messagebox("onActiveToolChanged; " + tool_name.to_s)
       end
     end

     # Attach the observer.
     Sketchup.active_model.tools.add_observer(MyToolsObserver.new)

Note that it refers to Sketchup::ShadowInfoObserver instead of Sketchup::ToolsObserver.

TIG

@unknownuser said:

Self note: We should add these codes to the send_action docs:

http://groups.google.com/group/Ruby-API/msg/e30ee3f2b21cb228

Does this list work 'across-platforms' - my understanding was that PCs and Macs differ ?

If there are such codes it makes like a lot easier...

Some "wrong": Sketchup.send_action 21513 >>> opens the Outliner ???
.

thomthom

Error 404 (Not Found)!!1

(code.google.com)

The manual says the argument should be either true or false, but the example sets it to 3.

Chris Fullmer

The FAQ page lists some sites that carry/catalog ruby scripts. the Sketchucation extensions index (thanks to Jim!) would also be a great resource to add to that list now

extensions url:

410 Gone

(www.sketchucation.com)

Chris

thomthom

http://code.google.com/apis/sketchup/docs/ourdoc/toolsobserver.html
It'd be nice if the ToolsObserver listed the full list of tools IDs.

I've begun a list here which associates constants to the IDs for convenient use in scripts: http://www.sketchucation.com/forums/scf/viewtopic.php?f=180&t=18124

Jim

@thomthom said:

http://code.google.com/apis/sketchup/docs/ourdoc/toolsobserver.html
It'd be nice if the ToolsObserver listed the full list of tools IDs.

I've begun a list here which associates constants to the IDs for convenient use in scripts: http://www.sketchucation.com/forums/scf/viewtopic.php?f=180&t=18124

In the back of my mind I have the idea the the tool id's were not reliable and shouldn't be used; but I can't remember why.

thomthom

@jim said:

@thomthom said:

http://code.google.com/apis/sketchup/docs/ourdoc/toolsobserver.html
It'd be nice if the ToolsObserver listed the full list of tools IDs.

I've begun a list here which associates constants to the IDs for convenient use in scripts: http://www.sketchucation.com/forums/scf/viewtopic.php?f=180&t=18124

In the back of my mind I have the idea the the tool id's were not reliable and shouldn't be used; but I can't remember why.

I thought is was the tool names as on Mac the first four characters where truncated? No?

Chris Fullmer

http://code.google.com/apis/sketchup/docs/ourdoc/componentinstance.html#definition

The ComponentInstance.definition example does not include the method in the example anywhere, so by definition it is not really an example.

This is the given example:

 point = Geom;;Point3d.new 10,20,30
 transform = Geom;;Transformation.new point
 model = Sketchup.active_model
 entities = model.active_entities
 path=Sketchup.find_support_file "Bed.skp",
   "Components/Components Sampler/"

Jim

Any ideas about a way to mark these errors as they are fixed?

thomthom

We could ask Coen to have a strike-through BBC tag. [deleted] or something...
Or, put a big fat FIXED in bold green. Might be easier.

avariant

From Image.explode:

entitiesarray     an Array object of entities if successful

which I interpret as the face and edges created in the explosion. However, the result from my testing always returns an empty array.

thomthom

I see that behaviour as well: http://www.sketchucation.com/forums/scf/viewtopic.php?f=11&t=17150&hilit=+explode

Chris Fullmer

http://code.google.com/apis/sketchup/docs/ourdoc/polygonmesh.html#add_polygon

add polygon detail just repeats the add_point example.

scottlininger

@thomthom said:

Seems that InstanceObserver.onClose is dead as well. http://code.google.com/apis/sketchup/docs/ourdoc/instanceobserver.html#onClose
But onOpen works.

Thomas,

I'm about to push an update with all of the recent changes above. This one puzzled me, though. The ToolsObserver examples work fine for me on the onOpen and onClose. Can you clarify what "dead as well" means?

@unknownuser said:

Does this list work 'across-platforms' - my understanding was that PCs and Macs differ ?

Tig, these action codes only work on the PC, but I still think I'll add them to the docs. There are some cool things in there that PC-only shops might need.

Thanks, guys! New update should be live in the next day or so.

scottlininger

@thomthom said:

We could ask Coen to have a strike-through BBC tag. [deleted] or something...
Or, put a big fat FIXED in bold green. Might be easier.

Jim, is there a way that I could be granted edit rights just to this thread? Then I could add a FIXED note inside the reports as I correct them?