Azure icon collections

README.md

Azure Icon collections

Official icon sets

• https://azure.microsoft.com/en-gb/patterns/styles/glyphs-icons/
  • SVGs on web page
  • No bundled download
  • 1901 icon: Azure and generic microsoft-styled icons
  • No kategories
  • Update cycle: unknown
  • (Sundog / Glyphs)
• https://learn.microsoft.com/en-us/azure/architecture/icons/
  • SVGs on zip
  • Creation of visio support mentioned in the FAQ
  • 620 public Azure service icons
  • 29 kategories
  • Update cycle unknown but documentation contains changelog

Minor official icon sets

• https://learn.microsoft.com/en-us/microsoft-365/solutions/architecture-icons-templates?view=o365-worldwide
  • Microsoft 365 architecture templates and icons
  • SVG and Visio template downloads
• https://learn.microsoft.com/en-us/dynamics365/get-started/icons
  • Microsoft Dynamics 365 icons
  • SVG icons
  • last update: 2021 June
• https://learn.microsoft.com/en-us/power-platform/guidance/icons
  • Microsoft Power Platform icons
  • SVG icons
  • last update 2022 June

Visio shapes

• Useless because search is too flaky

Third-party

• https://code.benco.io/icon-collection/
  • https://github.com/benc-uk/icon-collection
  • last update: 2021 October
  • Azure & Microsoft SVG Icon Collection
    • Official' Azure Icons Set
    • Azure Docs scraping
    • 'CDS' Azure Icons Set
    • Azure Patterns Collection (Sundog / Glyphs)
• https://pacodelacruz.io/azure-icons-library-diagrams-net / https://github.com/pacodelacruz/diagrams-net-azure-libraries
  • draw.io collection
  • Based on https://github.com/benc-uk/icon-collection
    • Unknown if has newer icons. Might have because updated to 40px versions
  • Last update 2023 March
  • Azure-<category> on shape list
  • Uses compressed xml property
  • Used base64 data property containing SVG
• https://github.com/jgraph/drawio/tree/dev/src/main/webapp/img/lib/azure2
  • draw.io bundled collection
  • Azure on More shapes | Azure / <category> on shape list
  • Update cycle
    • last update: 01-FEB-2024: 23.1.1: https://github.com/jgraph/drawio/commit/dfa7176c0d913586c559c9d630ac74e19573c61f
    • previous update: 04-NOV-2022: 20.5.2: https://github.com/jgraph/drawio/commit/d37894baf125430e85840c2635563b10d1a6523d
    • previous update: 13-MAY-2021: 14.6.13: https://github.com/jgraph/drawio/commit/b316ba7eb91c31a2e9c27d6157feca078f0eedc2
  • Set of XML files. Shape collection done on code
• https://github.com/jgraph/drawio-libs
  • official draw.io extra collections
  • azure icons added 2019 June(Before major Azure icon overhaul)
  • Uses compressed xml property

Third-party tools

• https://github.com/jgraph/svg2xml
• https://jgraph.github.io/drawio-tools/tools/convert.html
• https://ipydrawio.readthedocs.io/en/stable/tutorials/working-with-custom-libraries/index.html
• jgraph/drawio#470
• https://jgraph.github.io/mxgraph/docs/js-api/files/index-txt.html
• https://tomd.xyz/how-i-use-drawio/
  • draw.io CLI usage

foo.py

# Copyright (c) 2024 Janne Kujanpää

# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:

# The above copyright notice and this permission notice shall be included in all
# copies or substantial portions of the Software.

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
# SOFTWARE.

import base64
import glob
import json
import sys
import zlib

mode = sys.argv[1]
globStr = sys.argv[2]
outputFile = sys.argv[3]

def create_data_shape(filename):
    with open(filename, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("ascii") 
        shape = {
            "data": "data:image/svg+xml;base64," + encoded_string,
            "w": 40,
            "h": 40,
            "title": filename
        }
        return shape

def create_xml_shape(filename):
    with open(filename, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read()).decode("ascii")
        image = encoded_string 
        style = "shape=image;verticalLabelPosition=bottom;verticalAlign=top;imageAspect=0;aspect=fixed;image=data:image/svg+xml," + image
        mxGraphModel = '<mxGraphModel><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="2" value="" style="' + style + '" vertex="1" parent="1"><mxGeometry width="40" height="40" as="geometry"/></mxCell></root></mxGraphModel>'
        mxGraphModel2 = zlib.compress(mxGraphModel.encode(), wbits=-15)
        mxGraphModel3 = base64.b64encode(mxGraphModel2).decode("ascii")
        shape = {
            "xml": mxGraphModel3,
            "w": 40,
            "h": 40,
            "title": filename
        }
        return shape

result = []
for filename in glob.iglob(globStr, recursive=True):
    if mode == "data":
        shape = create_data_shape(filename)
    else:
        shape = create_xml_shape(filename)
    result.append(shape)

outputStr = "<mxlibrary>" + json.dumps(result) + "</mxlibrary>"
with open(outputFile, "w") as text_file:
    text_file.write(outputStr)