इस दस्तावेज़ में चार्ट एपीआई का इस्तेमाल करके, ग्राफ़Viz चार्ट बनाने का तरीका बताया गया है.
खास जानकारी
GraViz, कनेक्टिविटी ग्राफ़ को विज़ुअलाइज़ करने के लिए, ओपन सोर्स टूल का एक पैकेज है. आप DOT भाषा और अपनी पसंद के लेआउट इंजन का इस्तेमाल करके ग्राफ़विज़ ग्राफ़ बना सकते हैं.
GraViz चार्ट में ज़रूरी पैरामीटर के अलग सेट का इस्तेमाल किया जा सकता है. यहां इस्तेमाल किए जा सकने वाले पैरामीटर दिए गए हैं:
पैरामीटर | ज़रूरी है या ज़रूरी नहीं है | ब्यौरा |
---|---|---|
cht=gv[:<opt_engine>] |
ज़रूरी है | ग्राफ़विज़ चार्ट के बारे में बताता है. आपके पास Graveiz इंजन तय करने का विकल्प भी होता है. अगर आपको किसी लेआउट इंजन के बारे में बताना है, तो सेमीकोलन को शामिल करें : मार्क करें और <opt_engine> के लिए, इनमें से कोई एक स्ट्रिंग तय करें:
इन अलग-अलग इंजन की जानकारी के लिए, GraphViz की वेबसाइट देखें. |
chs=<width>x<height> |
ज़रूरी नहीं | अगर चार्ट का साइज़ तय नहीं किया जाता है, तो चार्ट का साइज़ अपने-आप बदल जाएगा. |
chl=<DOT_string> |
ज़रूरी है | DOT भाषा नोटेशन में बनाया जाने वाला चार्ट. आपको DOT भाषा का रेफ़रंस, GraViz की वेबसाइट पर मिल सकता है. |
chd |
इस्तेमाल नहीं किया गया | GraViz कोड इस मामले में असामान्य है, क्योंकि chd पैरामीटर को अनदेखा किया जाता है. इसे अपने यूआरएल में शामिल न करें. |
chof=<output_format> |
ज़रूरी नहीं | चार्ट के लिए आउटपुट फ़ॉर्मैट. पैरामीटर की जानकारी देखें और जानें कि कौनसे आउटपुट फ़ॉर्मैट काम करते हैं. chof=json की जानकारी देने पर, आपको एचटीएमएल इमेज मैप के तौर पर चार्ट का JSON फ़ॉर्मैट वापस मिलेगा. इसका इस्तेमाल, चार्ट में लिंक या इंटरैक्टिविटी जोड़ने के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, चार्ट इमेज मैप बनाना देखें. |
callback=<handling_function_name> |
ज़रूरी नहीं | chof=json तय करने पर, रिस्पॉन्स के तौर पर दिए गए JSON के साथ कॉल करने के लिए, फ़ंक्शन भी तय किया जा सकता है. इस फ़ंक्शन में, चार्ट का इमेज मैप भी शामिल होता है.
आपके फ़ंक्शन को एक ही JSON पैरामीटर स्वीकार करना होगा, जो चार्ट का JSON
पैरामीटर होगा. इसके बाद, आपका पेज चार्ट को रेंडर करने के लिए, आपके चार्ट को <img> एलिमेंट के तौर पर सेट कर सकता है. साथ ही, उसी यूआरएल को chof=json&callback=somefunc के साथ कॉल भी कर सकता है.
साथ ही, somefunc() फ़ंक्शन शामिल करता है, जो दिखाए गए JSON को पार्स करेगा और लिंक या इंटरैक्टिविटी जोड़ेगा. |
उदाहरण:
ब्यौरा | उदाहरण |
---|---|
डॉट इंजन का उदाहरण (डिफ़ॉल्ट). |
|
एक जैसे चार्ट के नीटो इंजन का उदाहरण. | cht=gv:neato |
एक डॉट चार्ट, जिसमें कोई साइज़ तय नहीं किया गया है. चार्ट का साइज़ अपने-आप तय हो जाता है. | cht=gv |
यह ज़्यादा जटिल चार्ट है. | cht=gv |
यहां मौजूदा ग्राफ़Viz चार्ट में कुछ सलाह और जानी-पहचानी सीमाएं दी गई हैं:
- इसके बजाय,
graph
एट्रिब्यूटsize
का इस्तेमाल नहीं किया जाना चाहिए. इसके बजाय, चार्ट एपीआई पैरामीटरchs
का इस्तेमाल करें. - नोड की ज़्यादा से ज़्यादा संख्या 200 हो सकती है और किनारों के लिए ज़्यादा से ज़्यादा 400 नोड हो सकते हैं.
- एंटी-एलियासिंग, पारदर्शिता, और वैकल्पिक फ़ॉन्ट का इस्तेमाल नहीं किया जा सकता.
node
एट्रिब्यूटimage
औरshapefile
इस्तेमाल नहीं किए जा सकते. इनके मौजूद होने पर गड़बड़ी दिखेगी.graph
एट्रिब्यूटratio
,margin
, औरpad
इस्तेमाल नहीं किए जा सकते. अगर यह एट्रिब्यूट मौजूद है, तो इन्हें अनदेखा कर दिया जाएगा.