Code Monkey home page Code Monkey logo

specify's Introduction

Specify: A dimensioning extension for Adobe Illustrator

Adobe Illustrator extension to automate specifying dimension measurements (and adding dimension lines) of single or multiple objects, and specifying the dimensions between two objects.

Specify Hero Image

Installation

Extension Install

Simply download the Specify extension from Adobe Exchange.

Extension Updates

To update to the latest version of the Specify extension:

  1. Open the Creative Cloud desktop app.
  2. Click to activate the Marketplace tab.
  3. Click Plugins, then Manage Plugins on the sidebar.
  4. Find the Specify extension in the list of plugins. If an update is available, simply click the Update button and then restart Illustrator.

Specify extension update panel in Adobe Exchange

Usage

To 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 V or Direct Selection Tool A.

After installing the Specify extension from Adobe Exchange, simply navigate to Window > Extensions > Specify to get started. Run the extension by simply clicking the "Specify Object(s)" button in the extension panel.

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.

Options and Styles

When 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.

Any changes to the settings defined in the Specify Dialog (including both the Options Panel and the Styles Panel) will persist even after closing the Adobe Illustrator application (version 3.2.0 and newer).

After 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.

SPEC Layer

You 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.

If you make a mistake, no problem! Simply select the desired objects and run the extension again.

Options Panel

The 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.

Specify Illustrator Extension Options Panel

Dimensions

The 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.

Multiple Objects

If 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.

Scale

You may define a custom scale for your artwork, which will apply a multiplier to the displayed units label.

For 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 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.

Decimals or Fractions

You may choose to use decimals or fractions for measurements that contain non-whole-numbers.

Decimals

If 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.

Fractions

If 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.

SPEC Layer

Choose whether to lock the SPEC layer after adding the dimensions.

Styles Panel

The Styles Panel allows the user to completely customize the label styles and the line styles for all dimensions.

Specify Illustrator Extension Styles Panel

Include Units in Label

When checked, inserts the units in the label alongside the dimension measurement.

The 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 > Rulers > Show Rulers ( ⌘Cmd + R on Mac, Ctrl + R on PC ).

Next, right-click on the Ruler, and select your desired units. Otherwise, the extension will use the Document's selected units by default.

Custom Units Text

When 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.

Font Family

Set the desired font family for the dimension label(s). Default is "Tahoma".

Font Size

Set 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.

Color

Click to select the color for the dimension label(s).

Gap

Set the size of the desired gap between the dimension label(s) and the object.

Stroke Width

Set the desired stroke width of the dimension line.

Head & Tail Length

Set the desired length of the line at both ends of the dimension line.

Reset

At the bottom left of the Specify dialog is a Reset button that restores all defaults in both the Options Panel and the Styles panel.

Support

Do you have questions? Would you like to contribute? Something else? Feel free to open an issue on GitHub.

Not into looking at code? No worries. Reach out on Twitter @adamdehaven.

Examples

specify-example

specify-workplace-example

specify's People

Contributors

adamdehaven avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

specify's Issues

Specify Dimensions Plugin for Adobe Illustrator - Extension missing

I've paid for the subscription for the Speccify Plugin for 5 different machines and now it has disappeared from Illustrator on all machines. I can't get it back. It's not in Creative Cloud plugins and when I go to Creative Cloud Exchange it wants me to buy it again. I have the order and subscription paid for and confirmation email.

Error Window when adding dimensions

Users are getting this error window/message when creating dimensions using the Specift Script in Illustrator, the folder is located at C:\Program Files\Adobe\Adobe Illustrator CC (64 Bit)\Presets\en_US\Scripts as required.

specify error => toggle Specify Dialog: IOError: File or folder does not exist

Font size not based off units

I've just given the new improved version a test & found that when using the advanced features & setting the font size to 20, it doesn't make it 20 of the units I have set in my preferences (I almost always work in mm). So in my test case, it sets it to 20 px (maybe?) rather than 20mm.

I wonder is it possible to have it set the font-size to either:

a) auto-detect the units from default font units in the AI preferences
b) auto-set the units to whatever your ruler units is
c) allow it to be selected from a dropdown list of possible unit types

On a side note, I'm super happy with the new UI & features available. Thanks for your work on this project.

[Feature Request]

Is your feature request related to a problem? Please describe.
I use the this to make measurements for objects that are arbitrary scaled to fit in a template so I end up having to manually edit the text for the measurements all the time. This causes the text to get misaligned with the lines, and if I have to measure many objects at the same time it can be burdensome to have to manually edit all the text alignment and numbers.

Describe the solution you'd like
Have an option to choose text alignment justification and/or be able to put a custom value in the measurements before creating the measure lines.

Describe anything you've already tried
current process is manually ungrouping the text and the lines and then relative center aligning the text to the line to make it center.

Additional context
I work in a print shop and use your tool for proofing and it's been a real life savor in time for the proofing process. I really appreciate this tool and these small features would help us out a ton. Thanks.

Feedback/Request

Thank you SO MUCH!!!

I've been searching for this for weeks, this is EXACTLY what I wanted to specify design dimensions.

Few points of feedback/requests if you don't mind:

Is there a way for the script to remember previous settings? Especially the decimal setting. Would save me a whole bunch of clicks.

Is there a way to key bind the script to run (f.e. using arrow keys for selecting the dimension.

Any chance you could make a similar script, or adjust this one, to allow defining colors in a similar way? Something resulting in:

screen shot 2016-11-11 at 09 59 22

That would be amazing and my gratitude would be eternal!

I'm sorry if this isn't the appropriate place for these comments, I couldn't find a better place.

Units

Hi, Is there a way to specify units?
I'm drawing in mm. To test the script, I created a circle that is 50mm in diameter. Then I ran the script and it created a dimension line that says "12." See below.

Thanks,
D.

screen shot 2015-05-07 at 2 14 52 pm

Font Issue

its will be completed tool if we have select custome font. Becouse I using Adobe Midle East Version. Onece i run this script text comming Arabic Numbers
Screen Shot 2020-03-11 at 4 48 59 PM

[Feature Request] Simple area calculation

Is your feature request related to a problem? Please describe.
No problem no - been using an older version of your code for years and just discovered it has been updated, so I purchased the new extension.
I use it to dimensions graphics in order to create proof/size verification screenshots for clients
The items I sell are priced by the area of the design - so I multiply the height and width your tool spits out and manually add a text box that states "12 square inch stamp size" for example

Describe the solution you'd like
Would be amazing if there was an option to check where the code would take the two dimensions, multiply them together, and then adds a simple text box with the calculated area along with the dimensions it already does
Could have a similar "decimal places" specification and/or custom units text

Describe anything you've already tried
There is another extension that appears to calculate an exact area based on complex paths, curves, whatever area the design "covers" - that is not necessary in this case. Just a simple multiplication of the overall height and width.

Extension retracted error

Hi! I have been using Specify with Adobe Illustrator 2019. I recently upgraded to Adobe Illustrator 2020 and the extension will no longer install. It give an error code and states the extension has been retracted by partner. Can you help me with this?

PLUGINS NOT WORKING ON AI

Hi, We have the Adobe Creative Cloud Ver 27.7 and we just purchased and paid for the plugins Specify Dimensions and Measurements to help us make our proofs become easier when putting the dimensions. It worked in one of our computer with the same version of Adobe but when we try to purchase again for another computer it didn't worked. It says it's not compatible with the version of Adobe Illustrator. Anyone has an idea what can we do about it? or How can we get a refund? TIA

Fractional unit to nearest 1/x [Feature Request]

Is your feature request related to a problem? Please describe.
I'm typically marking-up architecture/construction drawings and conventionally use fractional inches.
Usually they are rounded to the nearest 1/4", 1/8" or 1/16" like a tape measure. I thought that by specifying "Maximum fraction denominator" I would get the nearest 1/8" if I entered "8" but I actually got 5ths. Technically this is correct (no arguments there!) and it was the nearest fractional number with a denominator less than or equal to what I asked for....but no one uses 5ths or 7ths in this setting....

Describe the solution you'd like
Could there be an option to "round to the nearest fraction with a denominator <= X"?

Describe anything you've already tried
I can reduce the maximum denominator to force round whole numbers, but then I loose information because it would be rounding aggressively (say dropping from 1/8" to 1/4" precision and I could still get 1/3" increments if that were the closer number) so it's not an ideal solution.

Additional context
Screen shot showing "5.19 in" as "5-1/5 in" which is correct, of course, but unconventional.
image

Otherwise, thanks for building this!

[Bug Report] - Window Size

Describe the bug

After the latest update, the "Cancel" and "Specify Objec(s)" buttons falls off the Specify UI.

To Reproduce
Steps to reproduce the behavior:

  1. Launch application Illustrator
  2. Select object
  3. Run extension
  4. See bug

Expected behavior

Buttons should show up on UI.

Screenshots

https://www.linkpicture.com/q/Specify.jpg
image

Desktop (please complete the following information):

Windows 10
Adobe Illustrator CC v26.0.3 (64bit)

Additional context

None

Detect Document Color Mode

Add a switch in the script to detect document color mode (RGB vs. CYMK) to allow user to specify the color of the dimension lines and text.

Persistent Settings

Based on feedback from @KevinConsen in #6:

Is there a way for the script to remember previous settings? Especially the decimal setting. Would save me a whole bunch of clicks.

(Splitting into separate issue to work separately)

Label scaling

Firstly thank you so much for this. I've been in need of a script like this for a long time.

Would there be a way to increase the size the labels? Or even take into consideration of working at different scales? I typically work in a fairly large format so typically things will be a 10th of their actual size (so something that is 24", will read in AI as 2.4").

Thank you!

Ability to adjust size of leader lines

I'm not sure if leader line is the correct term, but I'm referring to the 2 lines perpendicular to the edge being defined, The size of these lines looks fine in your examples where the edge is 200px - 1000px, but the larger the size of the artwork, the more these lines get lost and the parallel line becomes too close to the edge being defined.

I'm not sure of the best implementation, but maybe it could be automatically sized based on the size of the art or possibly something like 50% of the dimension font size.

Please see attached images for further clarification.

Normal leaders on 48" box

Possible modification

[Feature Request]

Is your feature request related to a problem? Please describe.

Please add feature to be able to measure line/curve segment length in different angles other than horizontal or vertical position.

Describe the solution you'd like

Describe anything you've already tried

Additional context

Color Picker Dialog branch

Hi Adam,

i just did some work on the color picker dialog. I noticed you already started making a new UI, that's super nice. That https://scriptui.joonas.me/ site is pretty handy right. Only thing you need to build in is the functionality. But i find this so much faster and its also great for seeing issues immediately without having to launch an Adobe app and run the script.

I did some minor clean up now. I noticed the panels weren't aligning really nice, so i set them all to fill. I also tweaked the margins a bit here and there, looks a bit cleaner now. I put the custom unit aside of the checkbox options since it basically showed the same title twice, this saves space. I also made it less wide or was it that wide on purpose? I also simplified the labels, they were a bit to subscription perhaps and all that info is also in the tooltip already. So shorter labels look cleaner again :)

I did take out that into at the top, I'm not sure why its there. Its not clickable or anything and people can find the URL in the script. I would leave out or when the other UI Dialog gets there over time, perhaps that one can have it.

Do you mind if i also add gap size into this branch. I just added it and works properly. Im not 100% if the layout should be like this though. I was thinking of putting the stroke setting perhaps on the same line so it looks less messy on that line. But thing is, they all belong together since all are for the measurement lines.

specify-dialog-comparing
comparing current vs color picker dialog

IO Error: File or folder does not exist

Specify Error
SpecifyInstallLocation

We have one Windows 10 PC that the script doesn't seem to work for in our old version of Illustrastor, we are using the same files on 5 other Windows 10 PC's with the same version of Adobe CC without issues. I have even tried downloading a new copy of the script and re adding it to specified folder.

Layout Adjustment

First, this script is fantastic... I just start to use it and im impressioned with his possibilities.
It will help me a lot.

I have an idea to turn his layout into something more intuitive.
What about changing the buttons into an axis? I made a study... I hope you appreciate it.

image

Specify has disappeared

Hi! Specify has disappeared from my Illustrator Extensions folder and no longer shows up in my Plugins in Creative Cloud. I just paid for a renewal also.

Distance between centre of 2 objects

First up, great project :)

My issue that I would like to see is to have the ability to determine the distance between centres of 2 objects (e.g. 2 circles).

Pre-purchase question: UI customization

Sorry for opening an issue for this. I couldn't figure out a better way to ask.

  1. I had tried a different extension for dimensioning but it had a non-customizable UI. I prefer to have my Illustrator UI a bit lighter than some others so it was annoying. Luckily it had a free trial so I was able to cancel the subscription. So does this extension's UI follow the Illustrator UI settings (brightness, scale)?
  2. I'm also a little confused on what happens if I apply dimensions to an object then change that object. Do I then have to reapply the dimensions?

Straight Quotation Mark [ " ] instead of [ in ] abbreviation for 'inch' unit in UnitValue object

Thank you for your great script,
was looking to change/insert the
abbreviation of " in" to the abbreviation of ".
Using the method of escaping the straight quotation mark " ""

On Line 304
case RulerUnits.Inches: v = new UnitValue(v, "pt").as("in"); v = v.toFixed (decimals); unitsLabel = " in"; // add abbreviation break;

I switched out to

case RulerUnits.Inches: v = new UnitValue(v, "pt").as("in"); v = v.toFixed (decimals); unitsLabel = " \""; // add abbreviation break;

[Feature Request] Specify colors

Based on feedback from @KevinConsen in #6:

Any chance you could make a similar script, or adjust this one, to allow defining colors in a similar way? Something resulting in:

screen shot 2016-11-11 at 09 59 22

(Splitting into separate issue to work separately)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.