New API doc - typos and questions

[scottlininger]

I just had a big one reported to me... posting it here so folks are aware until the next fix.

The face.material method is entirely missing from the new docs.

[scottlininger]

There's a new update live that fixes (most of) the problems reported above. There were one or two that will require me to pound on it a bit more. Keep 'em coming!

I also posted a new tutorial on reading attributes .

[thomthom]

Nice one Scott.

I seem to have come across three observer events that doesn't work. It would probably be useful to mark these in the docs with a warning so that people won't waste a whole lot of time trying to get them work work. ..like I have...

DefinitionObserver http://www.sketchucation.com/forums/scf/viewtopic.php?f=180&t=17631 (Completely busted)
EntitiesObserver.onContentsModified http://www.sketchucation.com/forums/scf/viewtopic.php?f=180&t=17970 (Add and Remove event works though. Haven't tried the Erase event.)

[scottlininger]

I also just got this one from a coworker:

Sketchup.get_resource_path example fails. Looks like there's a required parameter that's not properly documented.

-Scott

[thomthom]

These failing observers is quite severe. I don't suppose there's a chance the dev team can push out an update outside the servicepack schedule? (I don't know what your schedule is, but seeing that we just got an servicepack I'm a bit pessimistic to when this might be addressed...)

[remus]

A semi related typo:

in this tutorial pt4=[0,9,9] whereas it should be [0,9,0].

[Chris Fullmer]

::OFF TOPIC::
All right Remus, come clean. Your always in the Ruby forum, you spotted a typo in tutorial, you answer questions once in a while....how much ruby do you know? Are you making plugins and selling them overseas for big money or something?

Chris

[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/"