SketchUp-Ruby Resources

Pauline01

thx again it's very very nice!

Align

thanx for this awesome thread! i give it a 10

thomthom

Jim, maybe include the path to install plugins on Mac as well. That one seem to be the most confusing amongst users it seems.

RickW

@vashstamp3de said:

I hope this helps...(and not violating someone )
http://xoomer.virgilio.it/kites/programmi/grafica/sketcplugins.html
Good Luck!

Just point the Windowizer link to Smustard, please. It currently points to a broken link on RLD.

thomthom

Might be worth noting that definition names can't be trusted to be unique: http://forums.sketchucation.com/viewtopic.php?f=11&t=28094

thomthom

Very nice list Dan!

@dan rathbun said:

Ruby Best Practices, by Gregory T. Brown
** PDF
http://sandal.github.com/rbp-book/pdfs/rbp_1-0.pdf

This one looks very interesting.

Dan Rathbun

@thomthom said:

Very nice list Dan!

Thanks.. (but I didn't find all these myself.) I had it posted over at GG, but it kept getting farther down the topic stack. Over here I know right where it is, and can format it.

@thomthom said:

This one looks very interesting.

Jim found that one.

P.S. - @Jim your free to cut and paste anything from here to the top of the thread.

Dan Rathbun

UPDATES / ADDITIONS (in this topic.)

Ruby Interpreter DLLs (Win32)

Edited Instructions to be more clear and precise.

Added DLL for:

latest Ruby v 1.8.7 p330

RUBY PROGRAMMING REFERENCES - CHM format

Added CHMs for:

latest Ruby v 1.8.7 p330* latest Ruby v 1.9.2 p136

Jim

This site has many videos of Ruby talks recorded at various Ruby Conferences - http://confreaks.net

Some good stuff there - if you can find them...

rricon

Hello,

Where to find the .h file of msvcrt-ruby18.dll file ?

Regards,

Dan Rathbun

@rricon said:

Where to find the .h file of msvcrt-ruby18.dll file ?

In the source:
ftp;//ftp.ruby-lang.org/pub/ruby/1.8/ruby-1.8.6-p287.zip

Dan Rathbun

book: "Programming Ruby - The Pragmatic Programmer's Guide"
Copyright 2000 Addison Wesley Longman, Inc.

ProgrammingRuby.zip
Released under the terms of the Open Publication License V1.0.

todd burch

Chunky Bacon. I didn't see a link for Why's Poignant Guide to Ruby. A true classic.

http://mislav.uniqpath.com/poignant-guide/book/chapter-1.html

Dan Rathbun

The Bastards Book of Ruby
A Programming Primer for Counting and Other Unconventional Tasks

Regular Expressions

Cheatsheet

http://www.regular-expressions.info/

mptak

http://rubyjs.org/

Javascript implementation of Ruby. For what its worth.

Jim

http://opalrb.org/

Ruby to JavaScript compiler, for what it's worth.

Dan Rathbun

Ruby Interpreter DLLs (Win32)

Instructions: (Win32 ONLY)

These Instructions Were Aimed at SketchUp Releases 6.x & 7.x ONLY

Navigate (Explore) on your computer, to the Google Sketchup application folder, and ...

Backup the current "Deceased" 1.8.0 dll, msvcrt-ruby18.dll by renaming it:

msvcrt-ruby180_p0.dll* or similar if it's a newer version. For example, if the old dll is v1.8.6-p287, then rename it msvcrt-ruby186_p287.dll

Download your choice of a newer version Ruby Interpreter Win32 DLL (below)
Make a copy of the new file and name it: msvcrt-ruby18.dll

(Sketchup is hardcoded to load this DLL filename.)

ALL Ruby 1.8 Trunk Releases Are Now Obsolete

1.8.0 [floatr:2qufrnyfOBSOLETE[/floatr:2qufrnyf]]

This intial release (p0) was distro'd with SU 6 - 7.x (Win32)
Just in case you lost or corrupted the original DLL.

1.8.1 .. 1.8.4 [floatr:2qufrnyfOBSOLETE[/floatr:2qufrnyf]]

1.8.1 thru 1.8.4 are obsolete (no sense posting them.)

1.8.5 [floatr:2qufrnyfOBSOLETE[/floatr:2qufrnyf]]

This intial release (p0) was distro'd with SU 6 - 2013 (Mac)
For testing rubies on PC (as they will run under Ruby onthe Mac.)
The last patchlevel that will be released for 1.8.5
Branch v 1.8.5 is now considered obsolete.

1.8.6 [floatr:2qufrnyfOBSOLETE[/floatr:2qufrnyf]]

This patchlevel was distro'd with SketchUp Win32 versions 8 & 2013
ruby-1.8.6-p369-i386-mswin32-dll.zip

1.8.7 [floatr:2qufrnyfOBSOLETE[/floatr:2qufrnyf]]

ruby-1.8.7-p330-i386-mswin32-dll.zip

ALL Ruby 1.8 Trunk Releases Are Now Obsolete

Dan Rathbun

RUBY PROGRAMMING REFERENCES - CHM format*
Method References for Ruby Core and Extended Modules & Classes

~ Arranged by Ruby version and PatchLevel ~

1.8.6 [floatr:1ywbewgh]END OF LIFE[/floatr:1ywbewgh]
[floatr:1ywbewgh]announced 2011-09-11[/floatr:1ywbewgh]
Ruby ver 1.8.6 p398
ruby-1.8.6-p398-doc-chm-2.zip
dl.txt
DL library documentation (from v1.8.6-p287)
Online version at ruby-doc.org

Latest ver 1.8.6
Online at Ruby-Doc.org
Core <> Libraries [framed webpage]

1.8.7 [floatr:1ywbewgh]END OF LIFE[/floatr:1ywbewgh]
[floatr:1ywbewgh]2014-06-30[/floatr:1ywbewgh]
Ruby ver 1.8.7 p330
ruby-1.8.7-p330-doc-chm.zip
Latest ver 1.8.7
Online at Ruby-Doc.org
Core <> Libraries [framed webpage]

1.9.1 [floatr:1ywbewgh]END OF LIFE[/floatr:1ywbewgh]
[floatr:1ywbewgh]2012-01-31[/floatr:1ywbewgh]
Latest ver 1.9.1
Online at Ruby-Doc.org
Keywords <> Core <> Libraries [framed webpage]

1.9.2 [floatr:1ywbewgh]END OF LIFE[/floatr:1ywbewgh]
[floatr:1ywbewgh]2014-07-31[/floatr:1ywbewgh]
Latest ver 1.9.2
Online at Ruby-Doc.org
Keywords <> Core <> Libraries [framed webpage]

1.9.3 [floatr:1ywbewgh]END OF LIFE[/floatr:1ywbewgh]
[floatr:1ywbewgh]2015-02-23[/floatr:1ywbewgh]
Latest ver 1.9.3
Online at Ruby-Doc.org
Keywords <> Core <> Libraries [framed webpage]

2.0.0 [floatr:1ywbewgh]SECURITY MAINTENANCE ONLY[/floatr:1ywbewgh]
[floatr:1ywbewgh]ends 2016-02-24[/floatr:1ywbewgh]
Ruby ver 2.0.0-p247
ruby-2.0.0-p247-core-doc-chm.zip
ruby-2.0.0-p247-stdlib-doc-chm.zip
Latest ver 2.0.0
Online at Ruby-Doc.org
Core <> Libraries [framed webpage]

2.1.6 [floatr:1ywbewgh]STABLE - MAINTENANCE[/floatr:1ywbewgh]

Ruby ver 2.1.6
ruby-2.1.6-core-doc-chm.zip
ruby-2.1.6-stdlib-doc-chm.zip
Latest ver 2.1.6
Online at Ruby-Doc.org
[url=http://ruby-doc.org/core-2.1.6/index.html:1ywbewgh]Core[/url:1ywbewgh] <> [url=http://www.ruby-doc.org/stdlib-2.1.6/:1ywbewgh]Libraries[/url:1ywbewgh] [framed webpage]

2.2.2 [floatr:1ywbewgh]STABLE - CURRENT[/floatr:1ywbewgh]

Ruby ver 2.2.2
ruby-2.2.2-core-doc-chm.zip
ruby-2.2.2-stdlib-doc-chm.zip
Latest ver 2.2.2
Online at Ruby-Doc.org
[url=http://ruby-doc.org/core-2.2.2/index.html:1ywbewgh]Core[/url:1ywbewgh] <> [url=http://www.ruby-doc.org/stdlib-2.2.2/:1ywbewgh]Libraries[/url:1ywbewgh] [framed webpage]

*** Compiled HTML Help Markup**

NOTICE: CHMs for older patchlevels under each version may be deleted to save server space.
( Get 'em while they're hot! )

Dan Rathbun

Ruby Newbie's Guide to Getting Started

Go to this post... Ruby Resources

(1) make a checklist of all the Tutorials, and go thru them 1 by 1, and check them off the list as you do.

(2) make a checklist of all the free downloadable books, and down load them one by one. Put them in a folder on your Desktop (or wherever you can find them easily.) And read them.

(3) For Standard ruby Reference, get the CHM for Ruby here, put it in this same folder.

Get comfortable with Standard Ruby. When your ready to script for Sketchup:

(4) On the Reference list (link above,) go to the Sketchup Specific section, and download Alex's Cheatsheet, and bookmark the Sketchup API Documentation website. (You'll be referencing it a lot.) It has the methods for the modules and classes for 'talking' to Sketchup, and manipulating it's models.

(5) Go through all the available Sketchup Ruby tutorials (on the list.)

(6) Read the code examples in your plugins/Examples folder.

(7) Have fun. Start fooling around with Ruby under Sketchup. Usually the best thing is to start by customizing the examples.

(8) Whenever you have questions, come back to this forum, and first do a search (it's likely your question has already been asked.) If not.. start a new topic (make the the topic title simple but informative... a shortened version of your question. Don't make it "Help Me!", that does not work well.)

(9) Before going into advanced Sketchup scripting, download more advanced plugins from the plugins forum (or other websites.. see the Resource list,) and examine them. See how they did things. This the best way to learn how to do things right. If you have a question about why an author did something a certain way... you can either Private Message them, or see if there is a discussion topic specific to their plugin, here in the Developer's forum, and post a question at the end of that topic. If no topic exists, create one by putting the plugin name in square brackets following by 'coding questions.' Please don't ask coding questions in the Plugin distribution topic of the Plugins forum. Ask them here in the Developers forum.

And ... welcome to the world of Ruby !

August

In his main post above, Dan basically suggests becoming very familiar with Ruby before beginning to use it with Sketchup. And he has a very good point, especially when it comes to the powerful and rather esoteric ways that Dan himself can use Ruby.

However, in the other direction, the Bastard's Book above, http://ruby.bastardsbook.com/, makes the point that "Programming and knitting are both skills that require continual practice but aren't easily improved by doing things other than, well, actually programming or knitting." So he presents lots of simple ways to get in your practice. "The good thing about programming compared to knitting a scarf is that you can experiment and mess up all you want without having to go out and buy more yarn."

Even further in that direction, Matthew Scarpino's book, "Automatic Sketchup", gives you ways to get that fundamental practice by working in Sketchup. And that's your goal, isn't it? I would even recommend Matt's book and SketchUp Ruby for initial programming instruction -- the instant gratification of creating SU objects is hard to beat.

And don't let the Amazon price for this out-of-print book scare you off. It's available free at the author's site. See also this thread, Automatic Sketchup book can now be freely downloaded.