Skip to main content
Create a custom icon

Create a new icons (new parts), change ports and add properties.

David Chapman avatar
Written by David Chapman
Updated over a week ago

What are D3M Icons and how are they unique?

D3M Icons are elements that represent a device or some type of equipment that will appear in your diagram. Each icon in D3M has three components to it: 

  1. A picture or graphic to represent the device

  2. A technical view showcasing its physical and wireless ports, and

  3. Properties that can be used to store important information, quote parts & settings

Creating a new D3M Icon

You'll need to start by clicking on the New Icon button 

If you do not see the New Icon button, make sure you are looking at the organization or user library represented by these icons at the top of the library:

Step 1 - Name the Icon & Select an Image

First, you'll have to start by giving your new icon a name and selecting an image or graphic for your icon. You can select one of our hundreds of pre-designed vector graphics or click the Upload Custom Image button to import your own image.

Note about images: We currently support jpg, gif, and png images and require that they be less than 5MB in size. Under 1MB is recommended. For best results, dimensions should be in increments of 25px. 100px by 50px is great. 90px by 45px, not so much.

Step 2 - Creating the Technical View & Assigning Ports

The next step consists of determining the size of your icon and adding the appropriate ports to best represent your device. You'll want to include both physical and wireless ports to the best of your knowledge.

To set the size of your icon, simply click on the + and - buttons and adjust as needed. Each unit of width/height is 25px so if you have an image that is 100px by 50px you will want a width of 4 ( 100/25 = 4 ) and a height of 2 ( 50/25 = 2).

To add a port to your icon, notice the grey squares around the perimeter of the icon. Click on one of those squares to add/edit a port. You will then see a form like this:

Using this form you can give some information about the port.

Type: Select a port type that best represents the type of port you are trying to represent. The port will only be able to connect to other ports of the same type.

Label: Give the port a label that will be used to identify the port.

Side: Choose which side(s) of the port connections should connect to. Auto allows for D3M to choose what it thinks is the best side for the connection, which is typically one of the sides that is touching the perimeter of the icon.

Limit: Limit the number of connections that can be made to the port. A value of 0 means that unlimited connections can be made.

Once a port is created you can click and drag to relocate it within your icon as needed. When you're done click on Next Step.

Step 3 - Adding Properties to your Icon

Finally, you can setup some properties for your icons.

If you have quoting enabled for your D3M Organization, you will see a Quote Parts form. Type in a quote part number and hit enter to add it to the icon. If there is a quote part in your price book with that number, it will automatically get added to your quote when you drop this icon into a project.

Use the form at the bottom to add properties to your icon. Adding properties will allow you to store product & configuration data (Model Number, IP Address, Serial Number, etc.). These properties will also represent the columns in the D3M Inventory view. It's important to include any data your company will want to track about these devices. Consistency is key!

You're Done!

Now that you have created your icon, it will be available in your User Library in any project. You can always edit the icon in the future if it needs to change. If you think it would be useful for other users of your D3M Organization to have access to this icon, you can request it be promoted to the Organization Library.

Suggested Articles

Did this answer your question?