{"id":17093373,"url":"https://github.com/adamdehaven/specify","last_synced_at":"2025-04-12T22:43:34.065Z","repository":{"id":26521842,"uuid":"29974782","full_name":"adamdehaven/specify","owner":"adamdehaven","description":"An extension used to automate specifying dimensions (and adding dimension lines) of objects in Adobe Illustrator","archived":false,"fork":false,"pushed_at":"2022-09-05T21:31:20.000Z","size":933,"stargazers_count":21,"open_issues_count":4,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-12T22:43:15.817Z","etag":null,"topics":["adobe","adobe-illustrator","assets","cad","design","dimension","dimensions","javascript","ruler","scale","script","specifications"],"latest_commit_sha":null,"homepage":"https://specify.dehaven.org/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamdehaven.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-01-28T15:47:01.000Z","updated_at":"2025-02-13T10:59:31.000Z","dependencies_parsed_at":"2022-07-16T00:16:14.648Z","dependency_job_id":null,"html_url":"https://github.com/adamdehaven/specify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamdehaven%2Fspecify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamdehaven%2Fspecify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamdehaven%2Fspecify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamdehaven%2Fspecify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamdehaven","download_url":"https://codeload.github.com/adamdehaven/specify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248643047,"owners_count":21138353,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adobe","adobe-illustrator","assets","cad","design","dimension","dimensions","javascript","ruler","scale","script","specifications"],"created_at":"2024-10-14T14:06:34.590Z","updated_at":"2025-04-12T22:43:34.031Z","avatar_url":"https://github.com/adamdehaven.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Specify: A dimensioning extension for Adobe Illustrator\n\nAdobe Illustrator extension to automate specifying dimension measurements (and adding dimension lines) of single or multiple objects, and specifying the dimensions between two objects.\n\n- [Specify Homepage](https://specify.dehaven.org)\n- [Install Specify from Adobe Creative Cloud](https://exchange.adobe.com/creativecloud.details.106345.html)\n\n![Specify Hero Image](img/featured-new.png)\n\n## Installation\n\n### Extension Install\n\nSimply [download the Specify extension from Adobe Exchange](https://exchange.adobe.com/creativecloud.details.106345.html).\n\n### Extension Updates\n\nTo update to the latest version of the Specify extension:\n\n1. Open the Creative Cloud desktop app.\n2. Click to activate the `Marketplace` tab.\n3. Click `Plugins`, then `Manage Plugins` on the sidebar.\n4. Find the Specify extension in the list of plugins. If an update is available, simply click the `Update` button and then restart Illustrator.\n\n![Specify extension update panel in Adobe Exchange](img/extension-update-panel.png)\n\n## Usage\n\nTo run the extension, first select one or more objects in your open Illustrator document. You must have at least one object selected via Illustrator's Selection Tool \u003ckbd\u003eV\u003c/kbd\u003e or Direct Selection Tool \u003ckbd\u003eA\u003c/kbd\u003e.\n\nAfter [installing the Specify extension from Adobe Exchange](https://exchange.adobe.com/creativecloud.details.106345.html), simply navigate to `Window \u003e Extensions \u003e Specify` to get started. Run the extension by simply clicking the \"Specify Object(s)\" button in the extension panel.\n\n\u003e **NOTE**: If you receive an error that the extension is not compatible with your installed version of Adobe Illustrator, or if the extension becomes incompatible after an Adobe update, navigate to \"Manage Plugins\" within the Creative Cloud desktop application. Uninstall the Specify extension, and then simply re-install the extension.\n\n### Options and Styles\n\nWhen the extension initializes, you will be presented with a dialog that allows you to choose which dimension(s) of your object(s) you would like to specify. The dialog also allows for the customization of several options.\n\nAny changes to the settings defined in the Specify Dialog (including both the [Options Panel](#options-panel) and the [Styles Panel](#styles-panel)) will persist even after closing the Adobe Illustrator application (version `3.2.0` and newer).\n\nAfter configuring your desired settings, make sure to select which dimension(s) to dimension, and then simply click the \"Specify Object(s)\" button at the bottom right of the dialog. Specify will quickly output all selected dimensions onto a new **SPEC** layer, and then lock the layer to prevent accidental edits.\n\n### SPEC Layer\n\nYou are free to unlock the **SPEC** layer and edit as needed. You may change the color of individual dimension labels, adjust the placement of dimension groups, or even remove dimensions you no longer need.\n\nIf you make a mistake, no problem! Simply select the desired objects and run the extension again.\n\n## Options Panel\n\nThe Options Panel allows the user to select the side(s) of the object(s) to dimension, to use decimals or fractions for non-whole-number measurements, whether to dimension the object itself or between objects, and the scale of the artwork.\n\n![Specify Illustrator Extension Options Panel](img/specify-options-panel.png)\n\n### Dimensions\n\nThe options panel allows you to first choose which dimension(s) of your Illustrator object you would like to specify. You may choose top, right, bottom, left, or any combination of sides.\n\n### Multiple Objects\n\nIf exactly two objects are selected on your artboard, you will be given the option to dimension between the two objects, instead of their individual sides. When checked, this option will specify the selected dimension(s) between the two chosen objects.\n\n### Scale\n\nYou may define a custom scale for your artwork, which will apply a multiplier to the displayed units label.\n\nFor example, if you are designing an engineering drawing at 1/4 scale (or 1:4), you simply choose this ratio from the **Scale** dropdown menu, and then optionally enable the checkbox for [Custom Units Text](#custom-units-text) on the Styles Panel that corresponds to the unit labels you would like to output. In this example, choosing '1/4' will indicate the artwork is drawn at one-fourth scale, resulting in dimension values that are 4 times their drawn dimensions.\n\n### Decimals or Fractions\n\nYou may choose to use decimals or fractions for measurements that contain non-whole-numbers.\n\n#### Decimals\n\nIf you choose **Decimals**, you can specify how many decimal places to use for the measurement (0-5 decimal places). Trailing zeros will be automatically removed. Default is `2`.\n\n#### Fractions\n\nIf you choose to use **Fractions** you can specify the maximum denominator number to use. This setting will impact the rounding algorithm. Default is `64`. You may also choose whether to include a dash `-` between the whole number and the fraction. With this setting enabled, the measurement `1 3/4` is displayed as `1-3/4`.\n\n### SPEC Layer\n\nChoose whether to lock the **SPEC** layer after adding the dimensions.\n\n## Styles Panel\n\nThe Styles Panel allows the user to completely customize the label styles and the line styles for all dimensions.\n\n![Specify Illustrator Extension Styles Panel](img/specify-styles-panel.png)\n\n### Include Units in Label\n\nWhen checked, inserts the units in the label alongside the dimension measurement.\n\nThe extension automatically dimensions objects based on the Document's default units. To dimension in different units (i.e. Inches, Centimeters, etc.), first, select show Rulers via `View \u003e Rulers \u003e Show Rulers` ( \u003ckbd\u003e⌘Cmd\u003c/kbd\u003e + \u003ckbd\u003eR\u003c/kbd\u003e on Mac, \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eR\u003c/kbd\u003e on PC ).\n\nNext, right-click on the Ruler, and select your desired units. Otherwise, the extension will use the Document's selected units by default.\n\n### Custom Units Text\n\nWhen checked, allows the user to customize the text of the units label. For example, displaying the abbreviation for feet, \"ft\" instead of the ruler measurement unit.\n\n### Font Family\n\nSet the desired font family for the dimension label(s). Default is \u0026quot;Tahoma\u0026quot;.\n\n### Font Size\n\nSet the desired font size for the dimension label(s). If the value is less than one (e.g. 0.25) you must include a leading zero before the decimal point.\n\n### Color\n\nClick to select the color for the dimension label(s).\n\n### Gap\n\nSet the size of the desired gap between the dimension label(s) and the object.\n\n### Stroke Width\n\nSet the desired stroke width of the dimension line.\n\n### Head \u0026 Tail Length\n\nSet the desired length of the line at both ends of the dimension line.\n\n## Reset\n\nAt the bottom left of the Specify dialog is a Reset button that restores all defaults in both the Options Panel and the Styles panel.\n\n## Support\n\nDo you have questions? Would you like to contribute? Something else? Feel free to [open an issue on GitHub](https://github.com/adamdehaven/specify/issues).\n\nNot into looking at code? No worries. Reach out on Twitter [@adamdehaven](https://twitter.com/adamdehaven).\n\n## Examples\n\n![specify-example](img/specify-example.jpg)\n\n![specify-workplace-example](img/specify-workplace-example.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamdehaven%2Fspecify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamdehaven%2Fspecify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamdehaven%2Fspecify/lists"}