[Plugin] AMS Library 3.5.2 (25 July 2017)

[Plugin] AMS Library 3.5.2 (25 July 2017)

Postby Anton_S » Sun Nov 17, 2013 9:29 am

Description
    AMS Library is a collection of tools and functions used to interact with SketchUp window and its sub-windows using Microsoft Windows API. It's capable of switching SketchUp full screen and changing visibility state of toolbar containers, status bar, scenes bar, and other elements of the windows. It is also capable of observing and making decisions to various events and messages of SketchUp window procedure. That is, AMS Library is capable of blocking and monitoring keyboard and mouse messages that reach Sketchup window procedure. Such feature is essential for developers who seek more control over SketchUp application, that is, for the purpose of creating games for example. As well, this library comes with many Windows API utilities that allow developer to tweak his/her webdialogs to a new level. In many ways, this library is written to achieve things that cannot be done with a standard SketchUp API.

    This library is mainly used by my Window Settings and MSPhysics extensions.
Requirements
  • Microsoft Windows XP, Vista, 7, 8, or 10 / Mac OS X 10.5+
  • SketchUp 6 or later
Usage
  • RubyDoc
  • Also included within the library's folder
Download
  • AMS Library can be downloaded and installed through PluginStore
  • A standalone RBZ format is also available at Google Drive

Installation Instructions
Follow these steps in case manually installing the plugin.
  1. Download ams_Lib_x.y.z.rbz
  2. Open SketchUp
  3. Select (Menu) Window->Preferences
  4. Navigate to Extensions section within the System Preferences dialog.
  5. Click Install Extension... button, select ams_Lib_x.y.z.rbz, and click Open.
  6. Ensure that AMS Library extensions is checked.

Uninstallation Instructions
Follow these steps in case you intend to uninstall the plugin.
  1. Navigate to your plugins folder:
    For Windows
    • For SU8 and below the plugins folder is located in
      • C:\Program Files (x86)\Google\Google SketchUp #\
    • For SU2013 the plugins folder is located in
      • C:\Program Files (x86)\SketchUp\SketchUp 2013\
    • For SU2014 and later the plugins folder is located in
      • C:\Users\[User Name]\AppData\Roaming\SketchUp\SketchUp 20##\SketchUp\
      • %appdata%\SketchUp\SketchUp 20##\SketchUp\
      • C:\ProgramData\SketchUp\SketchUp 20##\SketchUp\Plugins
    For Mac OS X
    • For SU8 and below the plugins folder is located in
      • [YOUR USER NAME]/Library/Application Support/Google SketchUp #/SketchUp/plugins
    • For SU2013 and later the plugins folder is located in
      • > Library > Application Support > SketchUp # > SketchUp > Plugins
  2. Select ams_Lib folder and ams_Lib.rb file, and delete them.
16
Last edited by Anton_S on Sun Aug 06, 2017 9:38 pm, edited 34 times in total.

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby wangyang0716 » Sat Jun 14, 2014 1:37 pm

that is very good
3

wangyang0716 
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby pcberdwin » Mon Aug 11, 2014 11:15 pm

Where can I find 1.1.0?
0
User avatar
pcberdwin 
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby Anton_S » Mon Aug 11, 2014 11:42 pm

pcberdwin wrote:Where can I find 1.1.0?

Are you asking this because you downloaded MSPhysics from Gitchub, which requires AMS Library 1.1.0? Well, if that's the purpose, you'll have wait until its finished.
0

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby pcberdwin » Tue Aug 12, 2014 10:56 pm

Ok thank you.
0
User avatar
pcberdwin 
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby Pherim » Wed Nov 05, 2014 2:15 pm

Doesn't seem to work with SU2015 64bit. Hope that will be fixed soon!
-1

Pherim 
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby scissors1121 » Wed Nov 05, 2014 9:01 pm

I don't want SU Viewer installed, but I keep getting the following error whenever I start up 2015:
"SU Window Settings extension requires AMS Library! Download AMS Library, extract it into the Plugins folder, and then restart SketchUp. Click OK to proceed to the library's homepage."
There is no Plugins folder for 2015, and I have uninstalled SU Viewer from the extension warehouse.

How do I get rid of this error message?

Thank you,
0

scissors1121 
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby Anton_S » Thu Nov 06, 2014 9:41 pm

Since SU2014 the plugins folder was changed to AppData location. To get rid of the plugin, copy this path to your explorer:
%appdata%\SketchUp\SketchUp 2015\SketchUp\Plugins

From there, delete the following:

  1. ams_Lib.rb and amsLib folder.
  2. ams_WindowSettings.rb and ams_WindowSettigns folder.

I will get this thing compatible with SU2015 and prevent the message from showing up each time...
Sorry for inconvenience.
-1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 1.0.9 (Apr 26, 2014)

Postby lionk » Sat Nov 08, 2014 3:32 pm

uninitialized constant
Win32::API::Callback
hope the issue can be resolved! thank you!
-1

lionk 
 

Re: [Plugin Tool] AMS Library 2.0.0

Postby davidheritier » Tue Dec 02, 2014 12:32 pm

hello thanks for this plugin!
but when your are full screen with nothing else how can you come back to toolbar?
thx again
-1

davidheritier 
 

Re: [Plugin Tool] AMS Library 2.2.0

Postby ying2014 » Sun Feb 15, 2015 9:17 am

Can I ask you a question?How do you make a *.html files does not display a dialog box in SketchUp ?just like the ams_WindowSettings.I think it is very cool.So ,if possible ,can you give a simple example?
-1

ying2014 
 

Re: [Plugin Tool] AMS Library 2.2.0

Postby Anton_S » Tue Feb 17, 2015 11:41 pm

Ying2014, here is a code snippet which allows you to remove borders from the dialog:
Code: Select all
# Create a web dialog
@title = 'MyDialog'
@dialog = UI::WebDialog.new(@title, false, 'MyDialog', width, height, ix, iy, true)
# Add Callbacks
@dialog.set_on_close(){
  @dialog = nil
  @handle = nil
}
# Set file
@dialog.set_file(html_path)
# Show dialog
RUBY_PLATFORM =~ /mswin|mingw/i ? @dialog.show : @dialog.show_modal
# Find dialog handle
@handle = AMS::Sketchup.find_window_by_caption(@title)
# Remove dialog caption and borders
if @handle
  layered = AMS::System.get_windows_version < 6.0 ? 0 : 0x00080000
  style_ex = 0x00010000 | layered # WS_EX_CONTROLPARENT | WS_EX_LAYERED
  style = 0x94000000 # WS_POPUP | WS_VISIBLE | WS_CLIPSIBLINGS
  AMS::Window.lock_update(@handle)
  AMS::Window.set_long(@handle, -20, style_ex)
  AMS::Window.set_long(@handle, -16, style)
  AMS::Window.lock_update(nil)
  AMS::Window.set_pos(@handle, 0, 0, 0, 0, 0, 0x0267)
end

Basically, what it does is creates a webdialog, finds its handle, and removes its borders. Along with removing borders it adds a layered style, which allows it to be made transparent.

To make the dialog draggable, you'd have to implement a few callbacks in your javascript file that would respond to mouse click and mouse move. Here is a snippet:
Code: Select all
function callback(name, data) {
  if (!data) data = "";
  window.location.href = "skp:" + name + "@" + data;
}
$(document).ready( function() {

  var md = false;
  var pos = [0,0];
  var dragged = false;
 
  // Detect Drag.
  $( "#some_id" ).mousedown(function(e) {
    md = true;
    var x = e.clientX;
    var y = e.clientY;
    pos = [x,y];
    callback("drag_start", null);
    dragged = false;
    return false;
  });
  $( document ).mousemove(function(e) {
    if (!md) return;
    var x = e.clientX;
    var y = e.clientY;
    var dx = x-pos[0];
    var dy = y-pos[1];
    if ((dx == 0) && (dy == 0)) return;
    dragged = true;
    callback("drag", "["+dx+","+dy+"]");
   return false;
  });
  $( document ).mouseup(function(e) {
    if (md) {
      md = false;
      callback("drag_end", null);
     return false;
    }
  });
});

In the code above, "#some_id" has to be changed to any id of an element in your HTML. It can also be changed to document to respond to drag anywhere in HTML.

Then have these callbacks implemented in SketchUp:
Code: Select all
@offset = [0,0]
@dialog.add_action_callback('drag_start'){ |dlg, params|
  c = AMS::Cursor.get_pos
  d = AMS::Window.get_origin(@handle)
  @offset = [c.x - d.x, c.y - d.y]
}
@dialog.add_action_callback('drag'){ |dlg, params|
  c = AMS::Cursor.get_pos
  x,y = [c.x - @offset.x, c.y - @offset.y]
  AMS::Window.set_origin(@handle, x, y, false)
}
@dialog.add_action_callback('drag_end'){ |dlg, params|
  @offset = [0,0]
}


To change dialog opacity, use this function:
AMS::Window.set_layered_attributes(@handle, 0, opacity, 2)

To make the dialog clip to screen and snap to viewport, you'd have to add more ruby functionality and modify dialog position in the 'drag' callback. I would advice looking into ams_WindowSettings/main.rb for source.
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 2.2.0

Postby ying2014 » Wed Feb 25, 2015 4:32 am

thanks!!It is very helpful to me
0

ying2014 
 

Re: [Plugin Tool] AMS Library 2.2.0

Postby wikii » Tue Sep 15, 2015 4:44 am

Anton_S wrote:Description
    AMS Library is a collection of tools and functions used to interact with SketchUp window and its sub-windows using Microsoft Windows API. It's capable to switch SketchUp full screen, show/hide toolbar containers, status bar, scenes bar, and more elements of the window. It's also capable to observe and make decisions to various events of the window procedure. In many ways, this library is written to achieve things that cannot be done with standard SketchUp API.

    This library includes Ruby FFI and and Win32 API extensions as part of the utility. Both of these gems are recompiled under my own name-space for compatibility with other extensions. I do not take ownership of such gems, nor I claim any credit for them. I just happen to rely on them so much that it was essential to include them in the library.
Requirements
  • Microsoft Windows XP, Vista, 7, or 8
  • SketchUp 6 or later
Usage
Download


It is a great lib!

one question:

when i use swo_on_maximize ,like this
class MySketchupObserver
def swo_on_maximize
r=AMS::C.get_viewport_rect()
p r
end
end
AMS::Sketchup.add_observer($o=MySketchupObserver.new)

I found get_viewport_rect returns the value of viewport before maximized.

So, can you provide a method like swo_on_maximized, will be called when maximize complete?

thank you for the great lib!

wikii
0

wikii 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 2.2.0

Postby Anton_S » Tue Sep 15, 2015 6:51 am

That's a good idea. I will add swo_on_post_[event] methods in the upcoming version.
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.0

Postby Anton_S » Wed Sep 16, 2015 12:06 pm

Hi Wikii. I added the post-events.
You should try out this example in Ruby console:
Code: Select all
class MySUWindowObserver
  def swo_on_maximize
    puts 'swo_on_maximize'
    p AMS::Sketchup.get_viewport_rect()
  end

  def swo_on_post_maximize
    puts 'swo_on_post_maximize'
    p AMS::Sketchup.get_viewport_rect()
  end

end # class MySUWindowObserver

my_obs = MySUWindowObserver.new
AMS::Sketchup.add_observer(my_obs)



AMS Library 3 ChangeLog: http://www.rubydoc.info/github/AntonSyn ... ANGELOG.md
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.0

Postby wikii » Thu Sep 17, 2015 9:36 am

Anton_S wrote:Hi Wikii. I added the post-events.
You should try out this example in Ruby console:
Code: Select all
class MySUWindowObserver
  def swo_on_maximize
    puts 'swo_on_maximize'
    p AMS::Sketchup.get_viewport_rect()
  end

  def swo_on_post_maximize
    puts 'swo_on_post_maximize'
    p AMS::Sketchup.get_viewport_rect()
  end

end # class MySUWindowObserver

my_obs = MySUWindowObserver.new
AMS::Sketchup.add_observer(my_obs)



AMS Library 3 ChangeLog: http://www.rubydoc.info/github/AntonSyn ... ANGELOG.md


Hi Anton_S !

It works well in my pc.
It is really cool!

Thank you for your working.

But I have one question more:

When I use win+left or win+right to fill Sketchup to half the size of the screen, which observer call catch this operation?

Thank you!

wikii
-1

wikii 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.0

Postby Anton_S » Thu Sep 17, 2015 2:59 pm

Currently, no observer catches such operation, but if you want to track window moving and resizing, you can always use swo_on_enter_size_move, swo_on_size_move, swo_on_exit_size_move, or/and swo_on_viewport_size. Check out available observers here: http://www.rubydoc.info/github/AntonSyn ... upObserver
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.0

Postby Pherim » Sat Sep 19, 2015 9:17 am

Hello, when I updated to 3.0.0 WindowsSettings didn't work any more, I had to delete both AMS Lib and WindowSettings and reinstall them to make it work again. Just thought I'd mention it in case anyone else has this problem.
0

Pherim 
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Pherim » Mon Oct 05, 2015 12:20 pm

I am not entirely sure, because I have not used SketchUp very much recently, but this plugin could be causing crashes for me, since I only noticed this happening after I installed the new version and it seems to have stopped since I deactivated it (and the Windows Settings plugin with it).
0

Pherim 
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Mon Oct 05, 2015 2:53 pm

Thanks for your feedback Pherim. It would be nice to know more details about the crash, so that I could fix it in case it came from that plugin:
  1. What Windows version and SU version were you using?
  2. Were you using AMS Library 3.0.1 and AMS Window Settings 4.2.0 - the latest versions of these plugins?
  3. When did the crash occur? Did it occur right away or after some time of using SU?
  4. What were you doing at the time the crash occurred? Like, what tool were you using or what command were you accessing?
  5. What is the list of other plugins you have installed?

Your response would be greatly appreciated,
Anton
0

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Pherim » Mon Oct 05, 2015 6:34 pm

Hello,
1. I'm using Windows 7 Professional 64bit and the newest version of Sketchup Make 2015 64bit.
2. Yes, both plugins were up to date. I am completely sure about this as I had to uninstall both and then reinstall them via the plugin store to make it work at all... just updating both plugins somehow did not work, as I wrote in the post before. I also updated it to 3.0.1 after I wrote this post.
3. I am not entirely sure, and right now I am unable to reproduce the crash... it's just that I noticed suddenly that when I changed the tool the cursor would not change as it was supposed to, and also the old tool would still be highlighted in the toolbar. And then, as soon as I right-clicked on a component (well, at least it was a component or group at least some of the times it happened), Sketchup crashed instantly. Well, at the moment it doesn't seem to happen even with your plugins active, but I'll be on guard about it.
4. Quite a lot I'm afraid... Though so far, they all worked fine together, and so did the old versions of your plugins.

At the moment everything seems to be fine. If this changes, I'll get in touch again.
0

Pherim 
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Mon Oct 05, 2015 8:21 pm

Thank you for your response, Pherim. I, too, came across cursor changing issues, but didn't consider it was related to my library. For AMS Library 3.x.y, the main difference between prior versions, is that I modified it to be Unicode rather than Ascii. That said, I probably implemented something improperly. I will look into that issue.
0

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Tue Oct 06, 2015 8:50 am

Hello Pherim. I tried to reproduce the crash or inconsistent cursor changing behavior with AMS Library 3.0.1, but, similarly to your trial, I couldn't. It is very likely that such bug persisted in version 3.0.0, but not in the current version, 3.0.1. But to be sure, I'll keep an eye on the library.
0

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby wikii » Sun Nov 22, 2015 3:59 am

AMS::Window.send_message can sent something to a sketchup window, but,how to get message in sketchup by ruby?

thank you.
0

wikii 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Sun Nov 22, 2015 6:24 am

Are you asking for a windows function, like GetMessage or PeekMessage?

Current version of AMS Library, doesn't have these functions implemented.
However, you can implement a Windows function manually, using Win32::API that is shipped with AMS::Library. Here is an example:
Code: Select all
module MyDesiredNamespace

  GetMessageA = AMS::Win32::API.new('GetMessageA', 'PLLL', 'I', 'User32')
  GetMessageW = AMS::Win32::API.new('GetMessageW', 'PLLL', 'I', 'User32')

  class << self

    # Get windows message ANSI.
    # @note GetMessage waits until the message is received. This means this
    #   function will freeze the computer until the message is triggered.
    # @param [Fixnum] filter_min Value of the lowest message value to be retrieved.
    # @param [Fixnum] filter_max Value of the highest message value to be retrieved.
    # @param [Fixnum] handle A handle to the window whose messages are to be retrieved.
    # @return [Array] Message inforamtion:
    #   [handle, message, wParam, lParam, time, x, y]
    # @see https://msdn.microsoft.com/en-us/library/windows/desktop/ms644936(v=vs.85).aspx
    def get_messageA(filter_min, filter_max, handle = AMS::Sketchup.get_main_window)
      buffer = "\0" * (4 * 7)
      # See https://github.com/djberg96/win32-api for Win32::API usage
      res = GetMessageA.call(buffer, handle, filter_min, filter_max)
      return buffer.unpack('lLlllll')
    end

    # Get windows message Unicode.
    # @note GetMessage waits until the message is received. This means this
    #   function will freeze the computer until the message is triggered.
    # @param [Fixnum] filter_min Value of the lowest message value to be retrieved.
    # @param [Fixnum] filter_max Value of the highest message value to be retrieved.
    # @param [Fixnum] handle A handle to the window whose messages are to be retrieved.
    # @return [Array] Message inforamtion:
    #   [handle, message, wParam, lParam, time, x, y]
    # @see https://msdn.microsoft.com/en-us/library/windows/desktop/ms644936(v=vs.85).aspx
    def get_messageW(filter_min, filter_max, handle = AMS::Sketchup.get_main_window)
      buffer = "\0" * (8 * 4) * (4 * 3)
      # See https://github.com/djberg96/win32-api for Win32::API usage
      res = GetMessageW.call(buffer, handle, filter_min, filter_max)
      return buffer.unpack('qLqqqll')
    end

  end # class << self
end # module MyDesiredNamespace

# In the following case, the function will return when left or right mouse
# buttons are click caption or non-client area of any window.
res = MyDesiredNamespace.get_messageW(0x0A1, 0x0A6, 0)


However, if you're aiming to monitor Sketchup action commands, which come when different tools are activated, then you'll probably want to use AMS::SketchupObserver with swp_on_command(id):
Code: Select all
class MyObserver

  def swp_on_command(id)
    # Process command here
    p id
    # Return 1 to block this command; 0 to pass this command
    0
  end

end

my_observer = MyObserver.new
AMS::Sketchup.add_observer(my_observer)
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby wikii » Sun Nov 22, 2015 7:49 am

Hi Anton_S

Thank you for you reply!

If I want send a message from Sketchup window A to Sketchup window B, I can use AMS::Window.send_message.

But ,how can Sketchup window B get to know there is a message come from window A?

I think , Window B must have an observer to get message when message come.

I want to konw , can window B respond message sent from A immediately?

Thank you for you great lib!

wikii
0

wikii 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Sun Nov 22, 2015 10:20 am

Hmm, communication between windows? That's interesting! I will look into that.
1

Anton_S 
PluginStore Author
PluginStore Author
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Jim » Sun Nov 22, 2015 11:14 pm

0
Hi

Jim 
Global Moderator
 

Re: [Plugin Tool] AMS Library 3.0.1

Postby Anton_S » Mon Nov 23, 2015 12:39 am

Thanks for the head start, Jim! That, SendMessageCallback, should do it. I will implement it into my library for an easy way to use. This is what I'm thinking to add in the future release:

A function to communicate to another window.
# Transmit information to another window.
# @param [Fixnum] dest_handle A handle to a destination window.
# @param [Fixnum] id A unique message identifier, a value b/w 0 and 4016.
# ID allows users to filter their messages from messages of other users.
# However, there is a downside, as some plugin developers might use
# same ID, but it's very unlikely.
# @param [String] data Message information.
AMS::Sketchup.send_message_to_window(dest_handle, id, data)


An observer that receives transmitted messages.
# Called when user sent message arrives to its destination window.
# @param [Fixnum] sender_handle A handle to a window that sent a message.
# @param [Fixnum] id Message id.
# @param [Fixnum] data Message information.
AMS::SketchupObsever.swo_on_message_received(sender_handle, id, data)


A bonus function that allows users to get handles to all Sketchup Windows.
# Get all SU windows
# @return [Array<Fixnum>] An array of all SketchUp main windows except this one.
AMS.get_all_sketchup_windows


An example, where this window communicates to all other SU windows:
Code: Select all
class MyDataTransferClass

  MY_PORT = 123

  # @param [String] Data in string form.
  def send_data_to_all_windows(data)
    su_windows = AMS.get_all_sketchup_windows
    su_windows.each { |dest_handle|
      AMS::Sketchup.send_message_to_window(dest_handle, MY_PORT, data)
    }
  end

  # Implement one of the SketchUp Window Observer callback methods.
  def swo_on_message_received(sender_handle, id, data)
    # Return if id is not yours
    if id != MY_PORT
    # Otherwise, do anything with data.
    # In our case, we'll evaluate it.
    eval(data)
  end

end # class MyDataTransferClass

# Create an instance of our communication class
my_data_transfer = MyDataTransferClass.new

# Register your class to SketchUp observers as it contains one of the SU observer methods.
AMS::Sketchup.add_observer(my_data_transfer)

# Send a message to all other SU windows.
my_data_transfer.send_data_to_all_windows("puts 'Hi, this is a message from another window!'")


Well, you have an insigt of how I'm planning to implement it. Once I'll add these functions into my library, I will notify you, wikii.

If anyone has any suggestions on improvement of this plan, please inform.
1

Anton_S 
PluginStore Author
PluginStore Author
 

SketchUcation One-Liner Adverts

by Ad Machine » 5 minutes ago



Ad Machine 
Robot
 

Next


 

Return to Plugins

Who is online

Users browsing this forum: Gesemp, johann_20, nongken, tsb yuki and 9 guests

Visit our sponsors: