From 759a56c3a5499ac1a2c01442991232901356a16b Mon Sep 17 00:00:00 2001 From: Evert Timberg Date: Sun, 13 Feb 2022 10:22:12 -0500 Subject: [PATCH] Document scale update plugin hooks (#10154) --- docs/developers/plugin_flowcharts.drawio | 2 +- docs/developers/plugins.md | 8 +++++++- docs/developers/scale_flowchart.png | Bin 0 -> 58555 bytes 3 files changed, 8 insertions(+), 2 deletions(-) create mode 100644 docs/developers/scale_flowchart.png diff --git a/docs/developers/plugin_flowcharts.drawio b/docs/developers/plugin_flowcharts.drawio index 2cbb3ca99..67cf72ce8 100644 --- a/docs/developers/plugin_flowcharts.drawio +++ b/docs/developers/plugin_flowcharts.drawio @@ -1 +1 @@ -7Vzdd6I4FP9reJw55APEx7GtMw/d7p7tw24fo0RlB4gLser89Rs0qUBUqLUkePacPsBNAuHe+8v9rA66SzbfM7Jc/MZCGjvQDTcOuncgBBhCp/hzw+2eEijCPItCOelAeI5+UUl0JXUVhTSvTOSMxTxaVolTlqZ0yis0kmVsXZ02Y3H1rUsypxrheUpinfpXFPKF/ArPPdB/0Gi+UG8GrhxJiJosCfmChGxdIqEHB91ljPH9VbK5o3HBPMWX/brxidG3jWU05W0WzJL49+1TOA/H49G/g+n6Zfzj/guSe+Nb9cE0FN8vb1nGF2zOUhI/HKijjK3SkBZPdcXdYc4jY0tBBIL4D+V8K4VJVpwJ0oInsRylm4j/XSz/6sm7l9LI/UY+eXezVTcpz7alRcXtS3nssGx3p9bpXJKMy9kqm9IzrFHaRrI55WfmSX0u+FZ6gZTBd8oSKvYjJmQ0Jjx6reoVkeo5f5t3kKC4kEJ8h0Dlc19JvJJvGtF5lArSn1RILdPlHccCS4Vc14uI0+cl2XFlLeBclRrJl3uAzaJNIf3TrH2lGaebs8yQoyiQ4JCng8LKugQ1SVqUUKZoV+ee9z8cGtS8EQ7YKjhADQ5PjEezYgMTOmMZPYGKg1BBMzJmURzfsZhlu7Uo9GgQYkHPecZ+0tJIACfI968EHb8KHXAEO2+0MnjwZ4En0Hj9Iiy3QUCBEpwO4GoCVAVOB3RdHVC4JaAGVgFK+WX2H5GfL5mhVZLBGvzuSDoVCwvGj/UTbsGSySpvPt0+xcwbtvMDjVfPP6PlaSfpXebgCgzzYI1hxg93AG8f98OWuAfAKuAPm3yc+4ysb8DDQeZBoJ+xhl0c17nExXlfzFAT/iyY0un0mPAngYe9DwbdbaNugFpiUCrTF/erxElrUO6e9S3LyLY0YcmilOelV/1REEpK61aVFuNaVqZhPlBaf2oBhucXiIv9nmvL1Qew2SwXnK1D4Y1jH4i19NzDE7t9q9FaZZXgLDEbQBeXtQ4jNu0wAr/Hum0gd4raHuOeXZgY3Lox70CmVw+LLzLEsG5YsXfesNYXKMvc1hDX5lft8LVsLGifZHskExrXUvhxNE/F9VQIX0S5aFScyNGUxN/kQBKF4V6naR79IpPd8wq1kdwWD/dGjnd/VJHOIko7+99KdvItTrkqdsqD8yocV9Wr9ylSly6RwkxJXOOMJIXExK4TEqVROrfN2AIMDFtbbPYY7sZt9Foep9i3y0R6RzwhmW4gM3Gs3E5FxTOecIC9qc9fDgTF0Ob4CVoFBLXvEhD2iTb3kWxplu/0RqhNMc+PxYeNJgIV/ry4+rWnkqTQ+93Y7gHKAzGYea6DwAIM9KYo/wEMwLYYsKy8Dk8bA5l7JpwI5yq/kRy0fyQR0S0cUG8KsH3IN8O2tV5olxeG9OSd3XGgUturxIGB5/lVV82xPBBERh25yxphOussa4tBZJcDiPRq4ImcsCUQVMmIa0DQ92E1GWM9BGGPGmT8wHAGBgZ98TI+cO74bW2/XS14UK9FXRZ47ihWRp3gWIdYx2HnsC8IMGCxBy2R07pLoyPk6H1/1dzljUSpAB6xHx2HqX5f4HM5DJQ/2uy42lXlVvtuzNr0FA717tmBbxoNGJpEg93hH2pdCLOr7RbphTBr4gkPVxEQYMPxBLLun4PsbrZBbT2s1jmRUhcFCGQo/LkdOF69Aweg8x019QWDht5ZLzg731wnLO5N9GyxZl8/436ZFte7Y0Dwzgbt2oLPaQzDx/4L5KgW2pGMVBC5SjISI1CtB9jfGYb0UFSVSh2LesPqjgRwh6Z7w3BfztbLz0jl6Ta7xHblV9S+9cxkuNdtXZc7TjT6NX0eGm9vwb1pb+neV8BtW86RXRl6rLf91vKMvc6v1EEEXOPZeqzXRFQfqvAnkmVMOdVxZtNP34BjrUXdxui9qXh02SHUOj1l2xmkt6da3iGkIphrRAQDT2WcVERgsD9B3B5+5m0//fBjeejhPw==7Zlbc6IwFMc/jY92uK8+Fi9td22nW7q17osTJUAqEhqCt0+/AYNAodS6rVanMz6Qkyv/c37JIdbk1nRxQYDvXGMTujVJMBc1uV2TJFGRpFr0E8zl2tJIDDZBJm+UGgy0gtwocGuITBjkGlKMXYr8vHGMPQ+Oac4GCMHzfDMLu/lZfWDDgsEYA7do7SOTOvwtVCG1X0JkO8nMosBrpiBpzA2BA0w8z5jkTk1uEYzp+mm6aEE3Ei/R5YFca08Pz7raMTv3Px9nk+GoWV8P1n1Pl80rEOjRnYfWpb6B9OGv3gRaozawJ7Pbu2TogC4TvaDJ5ONFTKiDbewBt5NadYJDz4TRqAIrpW16GPvMKDLjE6R0yWMBhBQzk0OnLq+FC0Qfo+5nKi8NMjXtBR85LiyTgkfJMtMpKg6ydWm3uJT021K6RAcckjEXYo6dpkF0B6q3/ct29ylo9lZcYoECYkNaoStvF4mZCUPumAuIp5AtkjUg0AUUzfKxCnjI25t2qVvZA/dsuZerVj0DbshnajmA0Ig6AgFlvixEgesyQCNvzx1EoeGDWJY52yPyvgSBv6bWQosoJt4p+AwSCheVEvFaucHfgu9DCZXzDNTc5GR4Tmz/o+lEGjrNm6vuH9TD3bEuSlSU69KxkLM7AVWRnSWgVJ+DEVC16gwBN5giK1rACFqYwCsP0YJHU3+Jb5NgIddtYReTuK9sqrBhKsweUIInMFPTkEaypn0mKloeFbGElY0tC4vyAbAEq0Fo/Z5po26HGHcDQ63f+XX5kLCIGVRScL7KMVMarlIRslJdpUNBVroapQDZgGV+ZZ7vgRFLM/MHiYtsjz2PmYKQkaJH8Y5YHnfOK6bINNeBAQO0AqN4vEh7HyOPxu+i6jW1XeqNqqgsgLVJRvkkuXyvDLi6cKbliONKbC07H/k2epNME2xZAaQFv2wWsLurtJL98FgOtCNjVN2S0TSW1F2i55wQsMw04FQUg4vPo0j5Q0JRX3w+vK89e1iv4DNDucoPmVC+g4GPvSCWrls81B08HYXB2wf6vjJZWd1fKlsaoT++yX+N/KpT98PI38/pXORkkwLHJyo8lfRXecGXIh86/W0eC2AfDIq6JSiNLwWK+joowGK56Sl/KqrioVlpFNSP9EYg6hj6JqDFferrX1apzf0d8dr90O/6waJz2eo3hedQ+Ut63/e8r+9cpXpte897sA/wqlWX7VwGjS98T3PX2nCzj12r9LbzaPjanZOqW94sJ1WRuX9OqlZdxsmVF1AQjXCipAifRworpn+Grr/u07+U5c4/7V1de6I4FP41XrqPEEB72dZOZ3c7ndnptjOduyhRmQHiQqzaX78BE/lIBJyCROvz9EIOJIRzzpucr6QdcO2tbgM4n33CNnI7es9edcCwo+uaoeud6K9nrxnlglOmgWMzWkJ4cF4RI/YYdeHYKMw8SDB2iTPPEsfY99GYZGgwCPAy+9gEu9m3zuEUCYSHMXRF6jfHJrMNdWD2EvpH5Exn/M1aj93xIH+YEcIZtPEyRQI3HXAdYEw2v7zVNXIj7nG+PP0z8T7P/x2i3tPQdC6J9dRddDedfdinyfYTAuST3+568fpr9ff6+z9wuIDmuD/8sny86hrs08ia8wvZlH3sEgdkhqfYh+5NQr0K8MK3UdRrj14lz9xhPKdEjRJ/IkLWTBfggmBKmhHPZXfRyiHfo+Z/mOzqOXVnuGI9xxdrfuGTYJ1qFF0+p+8lzeIr3q4i6xiLQ7wIxowR//21eCSjj19ndwty8/xEPg6Qw1jcIzCYItYfmXph//HWuf8BXm6NPrr6cd/lz0XMTKkhE8wtwh6ig6QPBMiFxHnJ6ipkKj/dPpeIlf5gkpVLuWjUL9BdsDddoanjU9Lj3IYEiUrguhSfkbCXM4eghzmMubKkc0RWlDCcb0A7cVaRSuzJ7xcUELQq5BC7CwbsI9g81AUcp8sUqhlplgI0p72FqVLomGfo7IKOlF8S6Eif09uCTtGoU9C5x8SZRAMYoQkO0A4EJZLWylE0cVz3Grs4iNsC20QD26D0kAT4F0rdGegjYFlNwszKwkzTRZRtaWmYGU3BTBME8EzNiRahp6WAl8CwDHoZ4CU43AG9nEJMBmM0HssUYjQwDbMBsOoVwQqUAmv/PCU3ImVLKSnrwoxwDf0xbRhJ8YM4E8+wN1qE5bPwoUwXvW3LBQgMfPjlzCllUcNa1hQXTT3HxdZXpotjmW1qnjWsirPGQKlZwxJnjQDF2t6LOtZ7Q+Si+JJiAIb0y+KYBF1w6cQShHHoIYgGZkfy440C5OGX+Jq1Ek0TJdCTt+tAVfRYjdl1msApReGjyGI9qAg7rbXYQ9GwdztQNy7yKIfCE3OkzCzgDE0COOOgjtQ51rcf4LSqEQtNLS9IE2MWwx1LGjf4emgDQvqLjgFGa9lxrGPGoOI6ZjYGq/dqBnKtL4eHqRY8RPcntyLdwTVekJNZiXKQMa22HSet1TjN78Xv2l2JzKpQUytSo8mMP6ns7+AIubnUkutMffp7THmIKFiuIpV3xtC9ZDc8x7Y3qoFC5xWO4v4i7s+xQ+3JqHPzqmMOpfIoVEwBXNv0NHtLJ50BloGuSxUGDMwM8FhPlVnPOv8SfU3qETyZxEt5TjbbMbxBXKYgruOKrFmg5ciafnZq95zZqgaTdLW8Wk0MJ8Xioa/yo2jQ3I2wQA0KvIqyVb042U5mEWkM/ReoaJjIyAGq33qQVQdnRO2X06mcZ9eVQpQueq1bsxxOqAVwWlZ5HmkDSVLowEiz2kTaEVrlHEDlSFPLAda5lVteUqGGWc41sx6z3FTdDNffa0SpOqDUSi3ycacAdek7Hn0z9iPjD/mRfh6HCzWQBFQP60KdfJqi9eKuyuEkxUxE7t2frmrUPaFWFrRiE6oYiPqKNvkrHy078sKM0MOYzliRB87m3rf5Coey/C9aj8cD/VhwVTc+qtZUAE0tfJQWVbCE74kXVWg9Q4Kdg1ZVgFbNlSP0mjmUyjGnVlUFENckpXNZXDFrcZotzTSyyOso7kRzNTvaXJYm23pz2DLxo9lOUfcUVbWyBaiVbgellS3MLDgtqyBvUGuyDRYHtgreawgPVM3nArU8TiDmczlIkv0ASnqTF3nlr1oR2ZjyG+/VnQRV3UnOelWUv8CdjFOvp7ls5JEDWg/EGCey2blVB5NLpz4HM/GDLnjx8H6Oz2UQwHXqAebUiX4Re5Nl5FSTmzgfqjbQShqY+UhKrgH9sRl0k46b5dzMv376+fp58mP0zbLuV4/98VbMyi8eCqu7lLFqrTl82OImlTAegwcd3/GnSrrqppaHpyQM2ZSrLpXtuUhuJ2iKsFCKGb0tzBSNusxMO7Ggv+DeSzewNOXeSwXRaqXcYRycIjiUwqa1ereiUe+EzWnBRTjByZLlyJpya6QCOFf0NF3RI0uqHcGCJqbU/vQd4kA3HgGVfyBqjvInE2qyTRNNWYPSwydbjb/tEzH4fRQUHbpZejhna8Uc0tGIIFCmGrtIu2rJK/c1A2TAw3tXIrEs/XxDENeOMoBDrW9KR+jehNPWCkCKRp0WfFyLOHcXm7N0qYSijX4hieoMlAxcCIfoahJX6qBL1fGcAlUzBmpfg+RxXiN3at7W8OddbEDIWiXC3DdibeYC0CXh5/ywioLPdU3cYm5l6wZSyAYnu7Owe8i0lpTzYnqx5azWPmtmzbiXlBZJn+srtfa9g3KWqtIqOiW85tl830lYv1B+EhYr1L5w8yk5SnMSYE91U0rPJVC7B9w3J1/ezpuj9sN2/6iwramPbXFbecrAovp0IvaVBrKsbfCIFHqZ/HuhjZiS/9IEbv4H5VpbU9s6EP41eQzje9xHSELoHAq0YaalLx3FVmyBYnlkObdfX8mRb9gOAcZx0sMwGWl18Wr3+1Yr2T19uFhPKAj9b8SFuKcp7rqnj3qaphqa1hP/irvZSexU4FHkyk65YIq2UAoVKY2RC6NSR0YIZigsCx0SBNBhJRmglKzK3eYEl58aAg9WBFMH4Kr0J3KZL1dhKrn8BiLPT5+sKrJlAdLOUhD5wCWrgkgf9/QhJYTtSov1EGJhvNQu98Qwbn684G8hgo8Pz/3J1/uH/m6y6/cMyZZAYcA+PPUvch1s7d+3d8+xsx16y98jovbTpbFNai/ocvPJKqHMJx4JAB7n0itK4sCFYlaF1/I+t4SEXKhy4TNkbCOxAGJGuMhnCyxb4RqxX2L4hSlrT4WW0VrOnFQ2aSVgdFMYJKpPxbZ8WFJLx+3WJxb1Cg5v2FL2i0hMHbjHgCmkAfUg29fPyBDDqQbJAnIt+UAKMWBoWdYOSMx7Wb9s6ANBXG9Nkfw0UnBKdqppPZ1ip5gclaODFwpq5KIEM+/Aj1R4CXAslzBewkTBH9CBfF1uFWAYc+4LIK18xOA0BImBVzz8lGEConAXEOZoLeAmfbmElMH1B7xZNb6cRbfLRkxtuCrECynyC6HCVpq9VbLzHqNOzUcyvr+zoXL19ftU97XZxOub50LK1sllVNlVazHtk+Q61F17tSyQ4I4wNBcazOCcUCg58cqpucvUt8kwRxgPCSY0Gau7JrRdg8sjRskLLLTY2ky3rDbZYjWEnAJdMlmRL0ZbfKkGoSeecXTIIbXAoJxPb21spW0t3+Xa39iaKXUA9fQjUe+//pbCG+Q+0cGfP5NQvZxMrGwxJx8pTyB9OdTLtYZWjuTlfUoW+D0EgcMHCi9eV+OqTxazOHo7ph4vn+g4odArBpy+oDBJ0jgV6Od2prasaL5KbevSstb2mVoSDM4l2rQdNawDo4bVZdSwmrMyMGeQ/tNJmVETco5LFu1/SJbmrfOAROpYZNmnZIEsNyBwuVO4ZT7Pk2OhXu98i1DPJiNtG/bmgXvEly5hb1Zg/0iR54mUiGtwurmRMSgD3+o83Ntd4v5j5+3OTmLNudIBfDG75ItaPYo1XbXcghnEry50MfICXna4xTiz9CtBDOQAfCkbFsh1d8iAEdqCWTKfMH4o7q+TxZhXPXO0j1nyPZIc3MtODUVHNSO4kXF95cKyB2aJdfKJH73CT7uQ+TyCn72dr3fX2bzeORV2dbobqdVz+h35N8ilNlwg5ewaaLp6XuyqHjCHPgi8M7mUylKII1xKNVOtZL4RCWAV7if/utCyO7Zk/QsoXrrkwgcceygQ3AXiFwUuDwpMHOyAECaI5YWZWCAnCkOBJ9qoF104Es7iiw3xQ+Oqe7htWfOlSCA8+p7YVOfj8oZUuVtRkj/e4oLIzxLztpzPn1dyvp7mBMXMW6nx/pf3e59X869LdlEr/0ZHH/8F \ No newline at end of file +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 \ No newline at end of file diff --git a/docs/developers/plugins.md b/docs/developers/plugins.md index e24cc9d82..972a6bff1 100644 --- a/docs/developers/plugins.md +++ b/docs/developers/plugins.md @@ -132,10 +132,16 @@ Plugins are notified during the initialization process. These hooks can be used ### Chart Update -Plugins are notified during throughout the update process. +Plugins are notified throughout the update process. ![Chart.js update flowchart](./update_flowchart.png) +### Scale Update + +Plugins are notified throughout the scale update process. + +![Chart.js scale update flowchart](./scale_flowchart.png) + ### Rendering Plugins can interact with the chart throughout the render process. The rendering process is documented in the flowchart below. Each of the green processes is a plugin notification. The red lines indicate how cancelling part of the render process can occur when a plugin returns `false` from a hook. Not all hooks are cancelable, however, in general most `before*` hooks can be cancelled. diff --git a/docs/developers/scale_flowchart.png b/docs/developers/scale_flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..29e680ff36ba0ae951ae41adc1536cd322ff80f0 GIT binary patch literal 58555 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
    7S-Ig|ubz(rZN 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