sketchucation logo sketchucation
    • Login
    ℹ️ Licensed Extensions | FredoBatch, ElevationProfile, FredoSketch, LayOps, MatSim and Pic2Shape will require license from Sept 1st More Info

    New API doc - typos and questions

    Scheduled Pinned Locked Moved Developers' Forum
    370 Posts 35 Posters 256.4k Views 35 Watching
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • TIGT Offline
      TIG Moderator
      last edited by

      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

      1 Reply Last reply Reply Quote 0
      • Chris FullmerC Offline
        Chris Fullmer
        last edited by

        @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!! πŸ˜„

        Lately you've been tan, suspicious for the winter.
        All my Plugins I've written

        1 Reply Last reply Reply Quote 0
        • R Offline
          remus
          last edited by

          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.

          http://remusrendering.wordpress.com/

          1 Reply Last reply Reply Quote 0
          • thomthomT Offline
            thomthom
            last edited by

            @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...

            Thomas Thomassen β€” SketchUp Monkey & Coding addict
            List of my plugins and link to the CookieWare fund

            1 Reply Last reply Reply Quote 0
            • R Offline
              remus
              last edited by

              I wonder if theyd mind linking out to another site, theres lots of stuff out there:

              301 Moved Permanently

              favicon

              (www.ugrad.cs.ubc.ca)

              Google Search

              favicon

              (www.google.co.uk)

              http://remusrendering.wordpress.com/

              1 Reply Last reply Reply Quote 0
              • thomthomT Offline
                thomthom
                last edited by

                Got to disagree there. .os_language and .get_locale should 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...

                Thomas Thomassen β€” SketchUp Monkey & Coding addict
                List of my plugins and link to the CookieWare fund

                1 Reply Last reply Reply Quote 0
                • thomthomT Offline
                  thomthom
                  last edited by

                  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_locale should according to the docs NOT return the system locale...

                  Thomas Thomassen β€” SketchUp Monkey & Coding addict
                  List of my plugins and link to the CookieWare fund

                  1 Reply Last reply Reply Quote 0
                  • T Offline
                    tomasz
                    last edited by

                    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. πŸ˜• πŸ˜„

                    Author of [Thea Render for SketchUp](http://www.thearender.com/sketchup)

                    1 Reply Last reply Reply Quote 0
                    • T Offline
                      tomasz
                      last edited by

                      Sketchup.os_language
                      
                      Sketchup.get_locale
                      

                      In 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.

                      Author of [Thea Render for SketchUp](http://www.thearender.com/sketchup)

                      1 Reply Last reply Reply Quote 0
                      • thomthomT Offline
                        thomthom
                        last edited by

                        @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?

                        Thomas Thomassen β€” SketchUp Monkey & Coding addict
                        List of my plugins and link to the CookieWare fund

                        1 Reply Last reply Reply Quote 0
                        • T Offline
                          tomasz
                          last edited by

                          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.

                          Author of [Thea Render for SketchUp](http://www.thearender.com/sketchup)

                          1 Reply Last reply Reply Quote 0
                          • thomthomT Offline
                            thomthom
                            last edited by

                            Animation
                            http://code.google.com/intl/nb/apis/sketchup/docs/ourdoc/animation.html

                            The first example on that page:

                            
                                 # This is an example of a simple animation that floats the camera up to
                                 # a z position of 200". The only required method for an animation is
                                 # nextFrame. It is called whenever you need to show the next frame of
                                 # the animation. If nextFrame returns false, the animation will stop.
                                 class FloatUpAnimation
                                   def nextFrame(view)
                                     new_eye = view.camera.eye
                                     new_eye.z = new_eye.z + 1.0
                                     view.camera.set(new_eye, view.camera.target, view.camera.up)
                                     view.show_frame
                                     return new_eye.z < 500.0
                                   end
                                 end
                            
                                 # This adds an item to the Camera menu to activate our custom animation.
                                 UI.menu("Camera").add_item("Run Float Up Animation") {
                                   Sketchup.active_model.active_view.animation = FloatUpAnimation.new
                                 } 
                            
                            

                            It makes a class named FloatUpAnimation, but no mention of Animation. A bit confusing.
                            Is it like the Observers?
                            Should it say class FloatUpAnimation < Animation

                            Thomas Thomassen β€” SketchUp Monkey & Coding addict
                            List of my plugins and link to the CookieWare fund

                            1 Reply Last reply Reply Quote 0
                            • scottliningerS Offline
                              scottlininger
                              last edited by

                              It is like observers. It doesn't actually have to be a subclass to work. Any object that replies to the nextFrame callback can be used as an animation.

                              • Scott Lininger
                                SketchUp Software Engineer
                                Have you visited the Ruby API Docs?
                              1 Reply Last reply Reply Quote 0
                              • thomthomT Offline
                                thomthom
                                last edited by

                                @unknownuser said:

                                It is like observers. It doesn't actually have to be a subclass to work. Any object that replies to the nextFrame callback can be used as an animation.

                                Isn't observer like that as well? I realised once that I had used the wrong observer class as a base, but the observer still worked.

                                Thomas Thomassen β€” SketchUp Monkey & Coding addict
                                List of my plugins and link to the CookieWare fund

                                1 Reply Last reply Reply Quote 0
                                • scottliningerS Offline
                                  scottlininger
                                  last edited by

                                  @thomthom said:

                                  @unknownuser said:

                                  It is like observers. It doesn't actually have to be a subclass to work. Any object that replies to the nextFrame callback can be used as an animation.

                                  Isn't observer like that as well? I realised once that I had used the wrong observer class as a base, but the observer still worked.

                                  Yes, that's how observers are as well.

                                  πŸ˜„

                                  • Scott Lininger
                                    SketchUp Software Engineer
                                    Have you visited the Ruby API Docs?
                                  1 Reply Last reply Reply Quote 0
                                  • thomthomT Offline
                                    thomthom
                                    last edited by

                                    How much of this thread have you processed Scott?
                                    I think I'm loosing track of what I have reported.

                                    Thomas Thomassen β€” SketchUp Monkey & Coding addict
                                    List of my plugins and link to the CookieWare fund

                                    1 Reply Last reply Reply Quote 0
                                    • scottliningerS Offline
                                      scottlininger
                                      last edited by

                                      @thomthom said:

                                      How much of this thread have you processed Scott?
                                      I think I'm loosing track of what I have reported.

                                      I have a lot of catch up to do. I have a paper copy here that I've marked as I update. I'll remerge that back into the forum soon.

                                      • Scott Lininger
                                        SketchUp Software Engineer
                                        Have you visited the Ruby API Docs?
                                      1 Reply Last reply Reply Quote 0
                                      • D Offline
                                        designforlife
                                        last edited by

                                        A small thing, just noticed a typo that I don't think is already covered. The entry for EntityObserver.onChangeEntity method states:

                                        @unknownuser said:

                                        The onEraseEntity method is invoked when your entity is modified.

                                        Mike

                                        1 Reply Last reply Reply Quote 0
                                        • thomthomT Offline
                                          thomthom
                                          last edited by

                                          Scott: I think it's worth to also add some notes on the observers that aren't working. Especially those that seem to cause bugsplats. http://forums.sketchucation.com/viewtopic.php?f=180&t=20676

                                          Thomas Thomassen β€” SketchUp Monkey & Coding addict
                                          List of my plugins and link to the CookieWare fund

                                          1 Reply Last reply Reply Quote 0
                                          • C Offline
                                            cjthompson
                                            last edited by

                                            I'm not sure if you've caught this yet, but transformation.xaxis, yaxis, and zaxis return vectors, not points.

                                            1 Reply Last reply Reply Quote 0
                                            • 1
                                            • 2
                                            • 6
                                            • 7
                                            • 8
                                            • 9
                                            • 10
                                            • 18
                                            • 19
                                            • 8 / 19
                                            • First post
                                              Last post
                                            Buy SketchPlus
                                            Buy SUbD
                                            Buy WrapR
                                            Buy eBook
                                            Buy Modelur
                                            Buy Vertex Tools
                                            Buy SketchCuisine
                                            Buy FormFonts

                                            Advertisement