Differences

This shows you the differences between two versions of the page.

--- geda:gschem_ug:attributes [2012/01/23 03:53]
vzh Missing dots in menu items
+++ geda:gschem_ug:attributes [2014/04/24 01:43]
vzh <key> formatting
@@ Line 1: / Line 1: @@
+| << [[colors_styles|Colors and styles]]  |  **[[geda:gschem_ug|gEDA gschem User Guide]]**  |  [[slots|Slots and slotting]] >> |
+===== Attributes =====
+Both [[components]] and [[pins_nets_buses|pins, nets and buses]] can have //attributes// attached to them.  Attributes are [[graphics#text|text]] in the format "''name=value''".  For example, nets can be named using a "''netname=''" attribute, and components can be named using a "''refdes=''" attribute.
+Attributes can also be added to a page without being attached to another object.  These are called //floating attributes//, and are most commonly used in symbols.  When a symbol is placed into a schematic page as a component, any floating attributes in the symbol become //inherited attributes// in the schematic.
+<note tip>Much of the power and flexibility of the gEDA suite is accessed through the use of attributes. For a full list of standard attributes and their meanings, see the [[geda:master_attributes_list|Master Attributes List]].</note>
+In addition to the name and value, attributes have two visibility settings.  The first controls whether the attribute //as a whole// is visible, and the second controls which parts of the attribute are shown (just the name, just the value, or both).
+There are two ways to add/edit attributes: editing them individually, or using the "Edit Attributes" window.
+==== Editing individual attributes ====
+To add a single attribute to a component, pin, net or bus, [[selecting|select]] the target object and use **Add→Attribute...**.  This will display the "Single Attribute Editor" window.  Enter a name and value, and set the desired visibility settings, then click **OK** to add the attribute.  If you use **Add→Attribute...** without selecting any object, the created attribute will be floating.
+To edit an individual attribute, select the attribute (not the object it's attached to) and use **Edit→Edit...** to display the "Single Attribute Editor" window again.  To update the attribute after making your changes, click **OK**.
+==== Editing multiple attributes ====
+A more powerful alternative is to use the "Edit Attributes" window.  To display the window, select a component, net, pin or bus, and use **Edit→Edit...**.
+The "Edit Attributes" window is divided into two parts.  The upper part shows all of the attributes that are currently attached to the object, and the lower part allows you to add attributes in a similar fashion to the "Single Attribute Editor".  The window automatically updates when the selected object changes.
+In the top part of the window, each row in the attribute list shows the name and value of an attribute, and its visibility settings ("Vis?" for overall visibility, and "N" and "V" for name and value visibility respectively).  Left-click the name or value of an attribute to edit it, and press <key>Enter</key> or move the focus to another field to save your changes.  To cancel your changes while editing the name or value of an attribute, press <key>Escape</key>.
+To delete an attribute, right click on it and select **Delete** from the context menu.
+If the **Show inherited attributes** checkbox is enabled, and a component is selected, any attributes inherited by the component from the symbol it was created from are also displayed, but cannot be edited.  To add an editable copy of the inherited attribute to the component, right click on the attribute and select **Promote** from the context menu.
+==== Bulk attribute visibility changes ====
+To change the visibility settings for several selected attributes at a time, use **Attributes→Toggle Visibility**, **Attributes→Show Name**, **Attributes→Show Value**, and **Attributes→Show Both** (which sets selected attributes to show both name and value).
+You can also change the visibility of all attributes that begin with a particular prefix using **Attributes→Hide Specific Text...** and **Attributes→Show Specific Text...**.  For example, you could enter "refdes=R" to hide all ''refdes'' attributes with values beginning with ''R''.

gEDA Project Wiki

User Tools

Site Tools

Differences

Page Tools