Altium Designer Documentation


Created: June 8, 2017 | Updated: June 17, 2017
Applies to Altium Designer version: 17.1

The Graphic dialog.


This dialog allows the designer to modify properties of the image object, in terms of the image used and the appearance of the frame around that image. The image can be either embedded or linked, and its original aspect ratio can be maintained while scaling to fit within the frame.

For information on how a placed image object can be modified graphically, directly in the workspace, see Graphical Editing.


The Graphic dialog can be accessed prior to entering placement mode, from the Schematic – Default Primitives page of the Preferences dialog. This allows the default properties for the image object to be changed, which will be applied when placing subsequent image objects.

During placement, the dialog can be accessed by pressing the Tab key.

While attributes can be modified during placement, bear in mind that these will become the default settings for further placement unless the Permanent option on the Schematic – Default Primitives page of the Preferences dialog is enabled. When this option is enabled, changes made will affect only the object being placed and subsequent objects placed during the same placement session.

After placement, the dialog can be accessed in one of the following ways:

  • Double-clicking on the placed image object.
  • Placing the cursor over the image object, right-clicking and choosing Properties from the context menu.
  • Using the Edit » Change command and clicking once over the placed image object.


  • Border Width – this field sets the width of the border drawn around the graphic image. Available widths are: Smallest, Small, Medium, and Large.
  • Border Color – click the color sample to change the color used for the border around the graphic image, using the standard Choose Color dialog.
  • Location X1/Y1 – the current X (horizontal) and Y (vertical) coordinates for the bottom-left corner of the object. Edit these values to change the position of this corner in the horizontal and/or vertical planes respectively.
  • Location X2/Y2 – the current X (horizontal) and Y (vertical) coordinates for the top-right corner of the object. Edit these values to change the position of this corner in the horizontal and/or vertical planes respectively.


  • FileName – enter the path and filename of the image to be used directly into this field, or click the associated Browse button to the right to access a standard Open dialog, with which to search for an image.
The following image formats are supported: .bmp, .dcx, .dib, .emf, .jpg, .pcx, .png, .rle, .tif, .svg, .tga, .wmf.
  • Embedded – enable this option to store a copy of the placed image inside the schematic document. If this option is disabled, only a link to the image file will be stored.
Care should be taken when using linked images – if the location of the image changes, you will need to update the link accordingly, using the FileName field.
  • Border On – enable this option to display a border (or frame) around the image.
  • X:Y Ratio 1:1 – enable this option to retain the graphic image's original aspect ratio. The image will be scaled to fit optimally into the frame size specified, while maintaining the original aspect ratio of the image. If this option is disabled, the image is stretched to fit exactly into the drawn frame size, which can lead to distortion of the image.
  • Locked – enable this option to protect the image from being edited graphically.
If attempting to graphically modify an object that has its Locked property enabled, a dialog will appear asking for confirmation to proceed with the edit. If the Protect Locked Objects option is enabled on the Schematic – Graphical Editing page of the Preferences dialog, and the Locked option for that design object is enabled as well, then that object cannot be selected or graphically edited. Double click on the locked object directly and disable the Locked property, or disable the Protect Locked Objects option, to graphically edit the object.


Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
You are reporting an issue with the following selected text
and/or image within the active document: