New API doc - typos and questions
-
new can accept a hex value (not string) as the parameter: for example 0xFF0000 (undocumented)
But, it reverses the red and blue values. Here is a Console session. (bug)
Sketchup;;Color.new 0xFF0000 Color( 0, 0, 255, 255) Sketchup;;Color.new 0x0000FF Color(255, 0, 0, 255) -
I've got some catching up to do. Thanks for all of the details, guys!
-
ModelObserver.onDeleteModelvsModelObserver.onEraseAll
http://code.google.com/apis/sketchup/docs/ourdoc/modelobserver.html#onDeleteModelWhen does the onDeleteModel event trigger? I don't think I've ever seen it trigger. When I open an existing model or create a new model
onEraseAllis triggered. -
This post on the API blog is showing start_timer with a fraction of a second resolution. In my experience, UI.start_timer has a whole second resolution and rounds partial seconds down to the nearest second.
t1=Time.now; UI.start_timer(0.1) {p Time.now-t1} ==> 0.01 t1=Time.now; UI.start_timer(0.999) {p Time.now-t1} ==> 0.01 t1=Time.now; UI.start_timer(1) {p Time.now-t1} ==> 1.001 t1=Time.now; UI.start_timer(1.9) {p Time.now-t1} ==> 1.002 -
Uses example from Geom.linear_combination.
I would guess the Point3d.linear_combination would only take 2 arguments - the weight, and other point since the first point is the receiver of the method.
-
MaterialsObserver
http://code.google.com/intl/nb/apis/sketchup/docs/ourdoc/materialsobserver.htmlObserver events that doesn't trigger:
Sketchup 6
onMaterialChange*
onMaterialRefChangeSketchup 7
onMaterialChange*
onMaterialRefChange
onMaterialSetCurrent- Only triggers when the name changes. Not when any of the other properties changes.
-
@unknownuser said:
This method is the same as the transform! method except that it does not record the move in an undo operation. This method is useful for transparently moving things during an animation.
.move! resets the rotational and scaling components of the receiver's transformation, and does not result in the same final translation as using .transform!
-
Layer.page_behaviorvsLayer.page_behavior=
http://code.google.com/intl/nb/apis/sketchup/docs/ourdoc/layer.html#page_behaviorThe flag values seems to contradict between descriptions of the two methods.
-
Pages.add_frame_change_observer
http://code.google.com/intl/nb/apis/sketchup/docs/ourdoc/pages.html#add_frame_change_observerI don't find any more info on this FrameChange observer. Missing documentation?
@unknownuser said:
The argument is an object that implements a method frameChange with the following form:
But then there's no example. And no FrameChange observer is listed in the Observer list.
-
Transformation.to_a
http://code.google.com/apis/sketchup/docs/ourdoc/transformation.html#to_a
It would be every helpful if this listed the many items in this array and explained which each of them represents
e.g. tra[14]= Z value
... -
@tig said:
Transformation.to_a
http://code.google.com/apis/sketchup/docs/ourdoc/transformation.html#to_a
It would be every helpful if this listed the many items in this array and explained which each of them represents
e.g. tra[14]= Z value
...I AGREE!!
-
I dont know if that would be possible, as what each element means varies a lot depending on the transformation (or combination of transformations) that have happened. The exception to this is the final column ([12],[13],[14]) which always represent translation.
-
@remus said:
I dont know if that would be possible, as what each element means varies a lot depending on the transformation (or combination of transformations) that have happened. The exception to this is the final column ([12],[13],[14]) which always represent translation.
Well, an explaination of the difference would be great. Because transformation is a big scary wolf when you start SU scripting... IMO...
-
I wonder if theyd mind linking out to another site, theres lots of stuff out there:
-
Got to disagree there.
.os_language and.get_localeshould both return the system settings, as that's what they indicate. They have their uses. But maybe there should be extra method to get the SU language... -
Ah, I see now:
http://code.google.com/apis/sketchup/docs/ourdoc/sketchup.html#get_locale@unknownuser said:
The get_locale method returns the language code for the language SketchUp is running in.
Valid return values include (but are not limited to): EN, QE, DE, FR, JP, ES, and IT.
Yes,
Sketchup.get_localeshould according to the docs NOT return the system locale... -
Yep, get_locale should not be an alias of os_language as doc suggests and os_language should read os language instead of local SU language.
-
Sketchup.os_languageSketchup.get_localeIn Polish version of SU6 PL both methods return 'pl' string.
Current description is misleading because I've got SU6 PL installed in Vista EN.
get_locale should refer to SU language instead of OS!@unknownuser said:
The os_language method is used to retrieve a two character code representing the os language. This is an alias for the get_locale method.
-
@unknownuser said:
Yep, get_locale should not be an alias of os_language as doc suggests and os_language should read os language instead of local SU language.
So, os_language reads the SU locale? that's the wrong method?
-
I have investigated the case and it turned out that SU reads the OS language settings , not the language version of the OS itself. I had the language settings set to Polish in VistaENG. That was why SU returned os_language as 'pl' and get_locale also as 'pl'. So the documentation in right when the OS language selected in OS settings has its presence in SU.
When OS language settings, say Portuguese, is not supported by SU then os_language returns 'en-US' which is wrong.
Advertisement