Google स्केचअप के लिए एक प्लगइन लिखना

Google स्केचअप तीन आयामी ग्राफिक्स बनाने और संपादित करने के लिए एक कार्यक्रम है। सुविधा और सादगी स्केचअप 3 डी मॉडलिंग और पेशेवरों के साथ शुरुआती दोनों द्वारा सराहना की जाएगी।

लेकिन हर कोई नहीं जानता कि स्केचअप में एक शक्तिशाली एपीआई है, जिसके साथ आप कार्यक्रम में नई कार्यक्षमता जोड़कर मॉड्यूल बना सकते हैं। इस पोस्ट में मैं स्केचअप वास्तुकला के सामान्य सिद्धांतों और प्लग-इन विकास प्रक्रिया को समझाने की कोशिश करूंगा। एक नई प्लग-इन बाइक लिखने से पहले , आपको अपनी आवश्यक कार्यक्षमता के साथ तैयार कार्यान्वयन के लिए स्केच सुविधा वेबसाइट को देखना चाहिए। एक उपयुक्त ओपन सोर्स प्लगइन मिला, आप आवश्यक कार्यक्षमता को लागू कर सकते हैं, जिससे कोड का मुख्य भाग अछूता रह जाएगा। उदाहरण के लिए, प्लग-इन कुछ गणना और निर्माण करता है, और आप केवल उनके आवेदन या दृश्य को बदलते हैं।

स्केचअप के लिए प्लगइन्स रूबी में लिखे गए हैं।

Google कोड आधिकारिक विकास प्रलेखन प्रदान करता है। इसमें 3 खंड होते हैं: परिचय, त्वरित संदर्भ और वस्तु संदर्भ।

1) परिचय - एक परिचयात्मक खंड जो एक साधारण प्लग-इन बनाने का एक उदाहरण दिखाता है।
2) त्वरित संदर्भ - कक्षाओं, विधियों पर एक संदर्भ अनुभाग।
3) ऑब्जेक्ट रेफरेंस - स्केचअप ऑब्जेक्ट मॉडल पर एक संदर्भ अनुभाग। ऑब्जेक्ट पदानुक्रम को बहुत आसानी से समूहों में विभाजित किया गया है, जो आपको कोड लिखने के लिए आवश्यक कक्षाओं को जल्दी से खोजने की अनुमति देता है।

मैं अपने स्वयं के अभ्यास से प्लग-इन विकास का एक उदाहरण लूंगा। सुविधा के लिए, अतिरिक्त कार्यक्षमता की आवश्यकता थी जो स्केचअप में उपलब्ध नहीं थी। कार्य जल्दी से और आसानी से वस्तु के आकार (चौड़ाई, ऊंचाई, मोटाई) का निर्धारण करना था। इस कार्यक्षमता के साथ एक तैयार प्लगइन पाया गया - गेटडिमेंशन , लेकिन इसका एक बड़ा माइनस था: इसने मैसेजबॉक्स में आकार दिखाया, जिसे लगातार बंद करना पड़ा, जिसने एक निश्चित असुविधा पैदा की। मैंने उसके कोड की जांच करने और परिणाम का आउटपुट बदलने का फैसला किया।

GetDimensions प्लगइन कोड:

require 'sketchup.rb'
def get_dimensions
model = Sketchup.active_model
mname = model.title
Sketchup::set_status_text(( "GET COMPONENT DIMENSIONS..." ), SB_PROMPT)
Sketchup::set_status_text( " " , SB_VCB_LABEL)
Sketchup::set_status_text( " " , SB_VCB_VALUE)
boundingBox = model.selection[0].bounds
dims = [ boundingBox.height,
boundingBox.width,
boundingBox.depth ]
dims.sort!

UI.messagebox( "Thickness: " + dims[0].to_s + "\nWidth: " + dims[1].to_s + "\nLength: " + dims[2].to_s)
end

if ( not file_loaded?( "GetDimensions.rb" ) )
add_separator_to_menu( "Plugins" )
UI.menu( "Plugins" ).add_item( "Get Dimensions" ) { get_dimensions }
end

file_loaded( "GetDimensions.rb" )

* This source code was highlighted with Source Code Highlighter .

कोड में प्लगइन लॉजिक ( get_dimensions ) होता है, जो मेन्यू आइटम ( Plugins -> गेट डायमेंशन ) जोड़कर और प्लगइन फाइल को सिस्टम में ही लोड करता है ( GetDimensions.rb )।

इंस्टॉल करने के लिए, प्लग-इन को निर्देशिका " C: \ Program Files \ Google \ Google SketchUp \ Plugins \ " में कॉपी किया जाना चाहिए, और प्रोग्राम स्वचालित रूप से स्टार्टअप पर इस फ़ोल्डर से सभी स्क्रिप्ट लोड करेगा।

चित्र की संरचना को संग्रहीत करने वाली मुख्य वस्तु model ।

इस प्लगइन में, पहले चयनित ऑब्जेक्ट और उसके आयाम लिए गए हैं। आकार आरोही क्रम में सॉर्ट किए जाते हैं और मैसेजबॉक्स में दिखाए जाते हैं, और प्लगइन का नाम स्टेटस बार में प्रदर्शित होता है।

स्टेटस बार ने तुरंत मुझे दिलचस्पी दी, और मैंने इसे प्राप्त आकारों के आउटपुट को स्थानांतरित करने का फैसला किया।

प्लगइन के एक छोटे से संशोधन के बाद, मैं इसे हासिल करने में कामयाब रहा:

def get_dimensions
model = Sketchup.active_model
entities = model.entities
boundingBox = model.selection[0].bounds

dims = [ boundingBox.height,
boundingBox.width,
boundingBox.depth ]
dims.sort!

Sketchup::set_status_text(( "Thickness: " + dims[0].to_s + ". Width: " + dims[1].to_s + ". Length: " + dims[2].to_s ), SB_PROMPT)
end

* This source code was highlighted with Source Code Highlighter .

एक तत्व का चयन करने के बाद, सेलेक्ट टूल का उपयोग करके, मेनू से गेट डायमेंशन कमांड चुनें। परिणामस्वरूप, स्थिति बार चयनित आइटम के आयामों को प्रदर्शित करेगा। एक आदेश के अधिक सुविधाजनक आह्वान के लिए, एक गर्म कुंजी सौंपी जानी चाहिए।



जब आप किसी ऑब्जेक्ट का चयन करते हैं तो अगला कदम आयामों को स्वचालित रूप से दिखाना था। मेरे दिमाग में दो विकल्प आए: मेरा अपना टूल बनाने के लिए, जो एलिमेंट सिलेक्ट के रूप में एलिमेंट्स का चयन करेगा, लेकिन उसी समय नीचे के साइज को दिखाएगा, या सेलेक्ट टूल को मॉडिफाई करेगा, ताकि वह सिलेक्ट होने पर ऑब्जेक्ट का साइज दिखा दे।

ऑब्जेक्ट रेफरेंस को खोजने के बाद, दूसरी विधि को लागू करने का विचार पैदा हुआ था।
जैसा कि यह निकला, ऑब्जर्वर क्लासेस -> सेलेक्शनऑब्जर्वर का उपयोग करके आप सेलेक्ट टूल की घटनाओं के लिए सदस्यता ले सकते हैं।

संशोधन के बाद, प्लगइन तर्क दो फ़ाइलों में विभाजित किया गया था:

Dimensions_load.rb

require 'sketchup.rb'
require 'Dimensions/GetDimensions.rb'

$PluginMenuName = "Tools"
$DimensionsMenuName = "Dimensions Tool"
$GetDimensionsMenuItem = "Get Dimensions"
$AutoDisplayMenuItem = "Auto Display Dimensions"

if (not file_loaded?( "dimensions_load.rb" ))
pluginMenu = UI.menu($PluginMenuName)
dimensions = Dimensions. new
pluginMenu.add_separator
getDimensionsSubMenu = pluginMenu.add_submenu($DimensionsMenuName){}
getDimensionsSubMenu.add_item($GetDimensionsMenuItem){dimensions.get_selection_dimensions}
autoDisplayItem = getDimensionsSubMenu.add_item($AutoDisplayMenuItem){dimensions.connect_observer}
getDimensionsSubMenu.set_validation_proc(autoDisplayItem){dimensions.menu_checked}
end

file_loaded( "dimensions_load.rb" )

* This source code was highlighted with Source Code Highlighter .

GetDimensions.rb

require 'sketchup.rb'
class Dimensions < Sketchup::SelectionObserver
def initialize()
@usedObserver = false
end

def onSelectionBulkChange(selection)
get_dimensions(selection)
end

def get_selection_dimensions
get_dimensions(Sketchup.active_model.selection)
end

def get_dimensions(selection)
boundingBox = selection[0].bounds
dims = [ boundingBox.height,
boundingBox.width,
boundingBox.depth ]
dims.sort!
Sketchup::set_status_text(( "Thickness: " + dims[0].to_s + ". Width: " + dims[1].to_s + ". Length: " + dims[2].to_s ), SB_PROMPT)
end

def connect_observer
if (@usedObserver) then
return remove_observer
else
return add_observer
end
end

def add_observer
@usedObserver = true
Sketchup.active_model.selection.add_observer self
return MF_CHECKED
end

def remove_observer
@usedObserver = false
Sketchup.active_model.selection.remove_observer self
return MF_UNCHECKED
end

def menu_checked
if (@usedObserver) then
return MF_CHECKED
else
return MF_UNCHECKED
end
end
end

file_loaded( "GetDimensions.rb" )

* This source code was highlighted with Source Code Highlighter .

अधिक विस्तार से कोड पर विचार करें।

सेलेक्ट टूल की घटनाओं को इंटरसेप्ट करने में सक्षम होने के लिए, SelectionObserver वर्ग से इनहेरिट करना आवश्यक है, onSelectionBulkChange(selection) विधि को ओवरराइड करें, जिसे ऑब्जेक्ट्स के Sketchup.active_model.selection.add_observer समय कहा जाएगा, और Sketchup.active_model.selection.add_observer का उपयोग करके घटनाओं की सदस्यता लें।

प्लगइन को टूल -> आयाम टूल मेनू में ले जाया गया है, जिसमें दो उप-आइटम हैं: आयाम और ऑटो डिस्प्ले आयाम प्राप्त करें ।

जैसा कि मैंने पहले कहा था, प्लगइन का कार्य ऑब्जेक्ट के मापदंडों को स्वचालित रूप से प्रदर्शित करना था जब इसे चुना जाता है। क्योंकि अतिरिक्त कार्यक्षमता की हमेशा आवश्यकता नहीं होती है, इसे अक्षम करने का निर्णय लिया गया था। ऑटो डिस्प्ले आयाम - आपको इसे सही समय पर चालू करने की अनुमति देता है, और आयाम प्राप्त करें - मांग पर प्लगइन को कॉल करना - अधिक लचीलेपन के लिए छोड़ दिया गया था।



प्लगइन का स्रोत कोड।

जैसा कि आप देख सकते हैं, मौजूदा प्लगइन को अपग्रेड करना खरोंच से लिखने की तुलना में बहुत आसान है। वैसे, मैंने पहली बार रूबी में कोड लिखा था, लेकिन मेरे महान प्रोग्रामिंग अनुभव के लिए धन्यवाद, वाक्यविन्यास को समझना मुश्किल नहीं था।

मैं आपको शुभकामना देता हूं कि आप स्केचअप के लिए अपने स्वयं के प्लगइन्स लिख रहे हैं।