TweetFollow Us on Twitter

Introduction to Scripting GraphicConverter

Volume Number: 22 (2006)
Issue Number: 9
Column Tag: AppleScript Essentials

Introduction to Scripting GraphicConverter

by Benjamin S. Waldie

In last month's column, we began discussing scriptable creative applications. Specifically, we looked at Adobe Photoshop, and explored how opening, manipulating, and saving graphic files can be automated using AppleScript.

This month, we will discuss scripting GraphicConverter, another popular graphic conversion and manipulation application, which is available from Lemke Software GmbH. While not packed with all the bells and whistles of something like Adobe Photoshop, GraphicConverter does offer quite a lot of bang for your buck.

GraphicConverter supports opening approximately 190 different graphic file formats, and saving approximately 79 different graphic file formats. One of GraphicConverter's great fortes is converting graphics from one type to another, hence its name. It also possesses the ability to manipulate graphics by rotating them, scaling them; applying filters, and more, many of the types of tasks that users often want to automate in order to batch process their graphic files. Furthermore, many features of GraphicConverter are controllable via AppleScript.

If you are not yet familiar with GraphicConverter, or if you plan to follow along with the examples in this month's column, then I encourage you to download the fully functional demonstration version of GraphicConverter from the Lemke Software website at <http://www.lemkesoft.com/>. For the cost of the non-demo version (currently only $30 for a single user license!), you may find it well worth adding to your software collection, especially if you plan to automate graphic conversion and manipulation with AppleScript, but don't need all of the functionality of something like Photoshop.

Lemke Software updates GraphicConverter on a very regular basis, and many of these updates include changes to its AppleScript terminology, which may require that you make changes to existing scripts. In any case, to ensure the highest level of AppleScript support, it is best to ensure that you are using the latest version of GraphicConverter. Just be sure to review the release notes in order to determine which AppleScript changes, if any, have been made between versions. Also, in case an updated version of GraphicConverter introduces AppleScript changes before this month's column is published, please note that all code that follows was written and tested with GraphicConverter version 5.9.1.

Getting Started

Opening Graphics

Whether you plan to automate GraphicConverter for the purpose of converting graphic files from one type to another or for manipulating graphics, you will most likely need to open them first. The reason I say most likely is because there are actually ways to batch process and interact with graphic files using GraphicConverter and AppleScript without writing code to open them. I would encourage you to explore GraphicConverter's AppleScript dictionary carefully to learn more about these and many other scriptable functions that we won't have a chance to touch on in this month's column.

There are a few different ways that graphics can be opened in GraphicConverter via AppleScript. Like most applications, GraphicConverter has an open command, which may be used to open graphic files. The following example code demonstrates the usage of this command.

set theImage to choose file with prompt "Please select an image file:"
tell application "GraphicConverter"
   open theImage
end tell

Although the open command will usually suffice, you may actually want to consider using the silentopen command instead. At times, opening certain graphic files may cause a dialog or error message to be displayed, and the silentopen command will attempt to open a specified graphic file without displaying such a dialog.

While this command may not prevent all dialogs from being displayed, it can certainly help to reduce the possibility of one appearing and holding up your automated process.

tell application "GraphicConverter"
   silentopen theImage
end tell

    TIP: When using the silentopen command, if you still encounter a dialog when opening a certain type of file, be sure to select the Don't show this note again... checkbox in the dialog, in order to prevent that specific dialog from appearing again in the future.

GraphicConverter also has the ability to download and open an image using a URL, rather than referencing a local file. This is done using the urlopen command. For example:

tell application "GraphicConverter"
   urlopen "http://www.mactech.com/images/mt_logo_209x043.gif"
end tell

Working with Graphics



Figure 1. A Graphic Window in GraphicConverter

Referencing Graphics

When AppleScripting GraphicConverter, there is not an actual graphic class. Rather, a graphic is referenced using the window class. The following code will retrieve a reference to the frontmost graphic window.

tell application "GraphicConverter"
   front window
end tell
--> window "mt_logo_209x043.gif (Indexed)" of application "GraphicConverter"

You will notice that, in the result of the above code, the window's name contains the suffix (Indexed), following the graphic file's name. GraphicConverter has added this automatically to the window's (not the file's) name, in order to indicate that the mode of the graphic is set to Indexed Color.

As you might expect, based on the previous example's result, graphic windows can also be referenced by name. For example:

tell application "GraphicConverter"
   tell window "mt_logo_209x043.gif (Indexed)"
      -- Do something
   end tell
end tell

Again, the name of the graphic file referenced in the previous example does not actually contain the suffix (Indexed). Because of this, GraphicConverter is flexible, and you can optionally choose to refer to the graphic window using its referenced file's name, without the mode suffix. For example:

tell application "GraphicConverter"
   tell window "mt_logo_209x043.gif"
      -- Do something
   end tell
end tell

When referring to graphic windows by name, please be aware that the window name may change when performing various functions, such as changing the mode of the graphic, or saving the graphic using a new file name or type. Because of this, you may want to consider referring to graphic windows by their index, or front to back positioning. Of course, be aware that this may change as well, if new graphics are opened, or the windows are reordered. For example:

tell application "GraphicConverter"
   tell window 1
      -- Do something
   end tell
end tell

Throughout this month's column, I will be referring to graphic windows by index.

Working with Graphic Properties

In GraphicConverter, graphic windows possess a number of AppleScript-accessible properties, some of which are modifiable and some of which are read only. We will be discussing a few of these properties below. To view a complete list of accessible properties, please refer to the window class, located in the Standard Suite in GraphicConverter's AppleScript dictionary. See figure 2.



Figure 2. GraphicConverter Window Properties

Assuming that a graphic window corresponds to a saved graphic file, and is not a new unsaved window, you may retrieve a reference to that file by accessing the file property of the window. For example:

tell application "GraphicConverter"
   file of window 1
end tell
--> file "Macintosh HD:Users:bwaldie:Desktop:mt_logo_209x043.gif"

Another accessible property of a graphic window is resolution. This property's value will be a list, indicating the horizontal and vertical resolution of the graphic. For example:

tell application "GraphicConverter"
   resolution of window 1
end tell
--> {72, 72}

The resolution property is also modifiable, and may be adjusted, if desired. The following code will change the horizontal and vertical resolution of the frontmost graphic window to 150 dpi.

tell application "GraphicConverter"
   set resolution of window 1 to {150, 150}
end tell

In GraphicConverter, the resolution of a graphic may also be modified using the change resolution command, which can be found in the GraphicConverter Suite in GraphicConverter's AppleScript dictionary.

tell application "GraphicConverter"
   change resolution of window 1 to {150, 150} with resample
end tell

Unlike the resolution property of a graphic window, the change resolution command provides the ability to specify whether the image should be resampled to the new resolution.

Another modifiable property of a graphic window is mode. The value of this property will be an integer that specifies the mode of the graphic - 0 for bitmap, 1 for indexed color, 2 for grayscale, 3 for RGB, and 4 for CMYK. For example, the following code would change the mode of the frontmost graphic to CMYK.

tell application "GraphicConverter"
   set mode of window 1 to 4
end tell

Accessing File Info

As you may know, or recall from last month's column, it is possible to associate metadata, such as captions, keywords, and more, with certain types of graphics. In GraphicConverter, many of these metadata fields are accessible to AppleScript via properties of a graphic window.

The following code, for example, will retrieve the caption of the frontmost graphic window by accessing the window's IPTC caption property. If a caption is not applied to the graphic, then an empty string will be returned.

tell application "GraphicConverter"
   IPTC caption of window 1
end tell
--> "Trip to the beach."

To retrieve a list of keywords applied to a graphic, access the graphic window's IPTC keywords property.

tell application "GraphicConverter"
   IPTC keywords of window 1
end tell
--> {"Summer", "Vacation"}

GraphicConverter provides AppleScript with access to numerous IPTC metadata properties, which, in addition to being readable, may be modified if desired. The following code demonstrates how new keywords could be appended to the existing keywords of a graphic window.

tell application "GraphicConverter"
   tell window 1
      set theExistingKeywords to IPTC keywords
      set IPTC keywords to (theExistingKeywords & {"Beach", "Fun"})
      IPTC keywords
   end tell
end tell
--> {"Summer", "Vacation","Beach", "Fun"}

Another way to access and modify a graphic's metadata is by using the get file iptc and set file iptc commands, both of which can be found in the GraphicConverter Suite of GraphicConverter's AppleScript dictionary. However, unlike the previous examples, these commands will allow the metadata of the graphic file to be accessed directly, without actually opening the graphic.

The following example code demonstrates the usage of the get file iptc command. Note that this command will return a list of all IPTC metadata fields at once. If you plan to use this command, then you will need to determine which metadata field each list item corresponds to.

set theGraphicFile to choose file with prompt "Select a graphic file:"
tell application "GraphicConverter"
   get file iptc theGraphicFile
end tell
--> {"Trip to the beach.", "", "", "", "Ben Waldie", "", "", "", "Beach Fun", "", "", "", "", 
   "", "", "", "-1", "Summer,Vacation,Beach,Fun", "Copyright Automated Workflows, LLC", 
   "http://www.automatedworkflows.com"}

As the next example demonstrates, the set file iptc command requires that a list of metadata field values be provided following the to labeled parameter. Like the previous example, to properly utilize this command, you will need to determine which metadata field each list item corresponds to.

set theGraphicFile to choose file with prompt "Select a graphic file:"
tell application "GraphicConverter"
   set file iptc theGraphicFile to {"2006 Summer trip to the beach.", "", "", "", "Ben Waldie", 
   "", "", "", "Beach Time Fun", "", "", "", "", "", "", "", "-1", "Summer,Vacation,Beach,Fun", 
   "Copyright 2006 Automated Workflows, LLC", "http://www.automatedworkflows.com"}
end tell

Another command, get file exif, may be used to retrieve the EXIF (Exchangeable Image File Format) data of a graphic file, again, in list format.

Manipulating Graphics

As mentioned, GraphicConverter can also be used to perform certain types of image manipulations. Not all of these are presently AppleScriptable, but a number of them are, and we will discuss a handful of these now.

Rotating Graphics

In order to rotate a graphic window, use the rotate command, and specify the desired angle of rotation. For example, the following code would rotate a graphic 90 degrees counter-clockwise.

tell application "GraphicConverter"
   rotate window 1 to angle 90
end tell

To rotate clockwise, specify a negative numeric value for the angle parameter. The rotate command also has some optional properties, which you can find in GraphicConverter's AppleScript dictionary.

Mirroring Graphics

The mirror command may be used to mirror a graphic window either horizontally or vertically. The following code demonstrates the proper usage of this command.

tell application "GraphicConverter"
   mirror window 1 in horizontal
end tell

Unsharp Mask

In GraphicConverter, it is possible to manually apply numerous filters to graphic windows. Some of these, such as unsharp mask, are accessible via AppleScript. To apply the unsharp mask filter, use the unsharp mask command, and specify the desired values for the command's radius, amount, and threshold parameters. For example:

tell application "GraphicConverter"
   unsharp mask window 1 radius 100 amount 100 threshold 0
end tell

Changing Brightness

Many visual aspects of graphic windows, including the gamma, hue, brightness, contrast, and more, are modifiable using commands in the GraphicConverter Suite. This next example shows how to change the brightness of a graphic window to a specified value.

tell application "GraphicConverter"
   change brightness window 1 to -25
end tell

Outputting Graphics

The save command is used to save a graphic window. At its most basic level, this command requires a single parameter - a reference to the window to be saved. To save a window in this manner, the window must reference an existing file in the Finder.

tell application "GraphicConverter"
   save window 1
end tell

To save a newly created graphic window, which does not yet reference a file in the Finder, you will need to specify the format, as well as the output path for the saved file. This is done by using the save command's in and as parameters. These parameters may also be used when you want to save a graphic window that does reference an existing file into a new location, or in a different format.

GraphicConverter can save approximately 79 different formats of graphic files. For a complete list of available save types, consult the save command in the Standard Suite of GraphicConverter's AppleScript dictionary. The following example code demonstrates how to save a graphic window as a JPEG to a file named Converted Graphic.jpg on the desktop. Please note that this would overwrite an existing file with the same name, if present.

set theOutputPath to (path to desktop folder as string) & "Converted Graphic.jpg"
tell application "GraphicConverter"
   save window 1 in theOutputPath as JPEG
end tell

When manually saving graphics in GraphicConverter, you will find that certain formats, such as JPEG and TIFF, have modifiable options, which can affect the saved file's quality, file size, and more. While not all of these options may be specified using AppleScript, some can. Unlike the manual process, however, with AppleScript, these options are not specified during the save process. Rather, they are specified via properties of the graphic window.

JPEG is one format with certain options that are modifiable via AppleScript, such as quality and compression type. The following code demonstrates how to adjust some of these options and then save the frontmost graphic window in JPEG format to the desktop.

set theOutputPath to (path to desktop folder as string) & "Converted Graphic.jpg"
tell application "GraphicConverter"
   tell window 1
      set JPEG quality to 30
      set JPEG progressive to true
      save in theOutputPath as JPEG
   end tell
end tell

Resources for Continued Learning

If you are interested in learning more about scripting GraphicConverter, then I would encourage you to visit the GraphicConverter AppleScripts webpage on the Lemke Software website at <http://www.lemkesoft.com/en/graphscripts.htm>. Here, you will find a number of downloadable AppleScripts, which you may use or edit to meet the needs of your specific workflow. You can also search MacScripter.net's ScriptBuilders section at <http://scriptbuilders.net/> for GraphicConverter scripts.

In Closing

As you can see from the examples in this month's column, AppleScript can be used to automate a number of image manipulation and conversion processes using GraphicConverter. Yet, we have only really scratched the surface. Be sure to explore GraphicConverter's AppleScript dictionary more fully in order to learn more about its incredibly useful scriptable capabilities. Also, don't forget that new AppleScript features are introduced to this application on a fairly regular basis, so check the Lemke Software website frequently for updated versions.

Until next time, keep scripting!


Ben Waldie is the author of the best selling books "AppleScripting the Finder" and the "Mac OS X Technology Guide to Automator", available from <http://www.spiderworks.com>, as well as an AppleScript Training CD, available from <http://www.vtc.com>. Ben is also president of Automated Workflows, LLC, a company specializing in AppleScript and workflow automation consulting. For years, Ben has developed professional AppleScript-based solutions for businesses including Adobe, Apple, NASA, PC World, and TV Guide. For more information about Ben, please visit <http://www.automatedworkflows.com>, or email Ben at <ben@automatedworkflows.com>.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Macs Fan Control 1.5.14 - Monitor and co...
Macs Fan Control allows you to monitor and control almost any aspect of your computer's fans, with support for controlling fan speed, temperature sensors pane, menu-bar icon, and autostart with... Read more
VueScan 9.7.96 - Scanner software with a...
VueScan is a scanning program that works with most high-quality flatbed and film scanners to produce scans that have excellent color fidelity and color balance. VueScan is easy to use, and has... Read more
FileMaker Pro 19.6.1 - Quickly build cus...
FileMaker Pro is the tool you use to create a custom app. You also use FileMaker Pro to access your app on a computer. Start by importing data from a spreadsheet or using a built-in Starter app to... Read more
Duet 3.1.0.0 - Use your iPad as an exter...
Duet is the first app that allows you to use your iDevice as an extra display for your Mac using the Lightning or 30-pin cable. Note: This app requires a iOS companion app. Release notes were... Read more
Firefox 107.0.1 - Fast, safe Web browser...
Firefox offers a fast, safe Web browsing experience. Browse quickly, securely, and effortlessly. With its industry-leading features, Firefox is the choice of Web development professionals and casual... Read more
War Thunder 2.21.1.91 - Multiplayer war...
In War Thunder, aircraft, attack helicopters, ground forces and naval ships collaborate in realistic competitive battles. You can choose from over 1,500 vehicles and an extensive variety of combat... Read more
Numbers 12.2.1 - Apple's spreadshee...
With Apple Numbers, sophisticated spreadsheets are just the start. The whole sheet is your canvas. Just add dramatic interactive charts, tables, and images that paint a revealing picture of your data... Read more
DEVONthink Pro 3.8.7 - Knowledge base, i...
DEVONthink is DEVONtechnologies' document and information management solution. It supports a large variety of file formats and stores them in a database enhanced by artificial intelligence (AI). Many... Read more
Drive Genius 6.2.3 - $79.00
Drive Genius features a comprehensive Malware Scan. Automate your malware protection. Protect your investment from any threat. The Malware Scan is part of the automated DrivePulse utility. DrivePulse... Read more
VLC Media Player 3.0.18 - Popular multim...
VLC Media Player is a highly portable multimedia player for various audio and video formats (MPEG-1, MPEG-2, MPEG-4, DivX, MP3, OGG, ...) as well as DVDs, VCDs, and various streaming protocols. It... Read more

Latest Forum Discussions

See All

TouchArcade Game of the Week: ‘Sling Min...
The world of PC games has always blown my mind because there’s just SO MUCH stuff out there that it’s not uncommon at all for there to be a game that’s well-liked and well-reviewed, and seemingly quite popular with a solid fanbase, and have it be... | Read more »
SwitchArcade Round-Up: Reviews Featuring...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for December 2nd, 2022. So, today turned out a little quieter than the usual Friday. It was so quiet, in fact, that I decided to pen a few reviews. The Knight Witch, Railbound, and Donut... | Read more »
Blue Archive reveals its latest event st...
Nexon has announced the new update for Blue Archive, under the name of An Unconcealed Heart. Featuring a battle between two academies, the story will follow a group struggling to gain recognition, and will bring three new students to recruit. [... | Read more »
Dead Cells+ Is Out Now on Apple Arcade a...
Following the major update for Dead Cells on iOS and Android a few days ago, Playdigious has brought Dead Cells+ () to Apple Arcade. As an App Store Great, Dead Cells+ includes all prior paid DLC and content updates. It also has exclusive mobile... | Read more »
SwitchArcade Round-Up: ‘Romancing SaGa’,...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for December 1st, 2022. Wow, December. We’re already at the last month of the year? Phew. I have a lot of work to finish in the next few weeks. As for today, we’ve got a little news, a... | Read more »
‘Railbound’ Update Now Available Adding...
One of our favorite puzzlers released this year is Railbound from Afterburn Games, which hit in early September and earned our Game of the Week recognition for being an absolutely ace logic puzzler. The goal is to place rail pieces down in order to... | Read more »
The Seven Deadly Sins: Grand Cross celeb...
Netmarble Corporation has pulled out all the stops to celebrate the 3 and a half year anniversary of The Seven Deadly Sins: Grand Cross. The Grand Cross 3.5th Year Anniversary the Ultimate One, a rather wordy title, brings with it a brand new... | Read more »
‘Skullgirls Mobile’ Major Update 5.2 Out...
Developer Hidden Variable pushed out a major update for Skullgirls Mobile (Free) a few hours ago. The version 5.2 update brings in Black Dahlia (before the console and PC game), Retakes, XP Treats, free gifts, and more. Since launch, Skullgirls... | Read more »
Out Now: ‘Disgaea 4’, ‘Romancing SaGa: M...
Each and every day new mobile games are hitting the App Store, and so each week we put together a big old list of all the best new releases of the past seven days. Back in the day the App Store would showcase the same games for a week, and then... | Read more »
SwitchArcade Round-Up: ‘Elevator Action...
Hello gentle readers, and welcome to the SwitchArcade Round-Up for November 30th, 2022. We’re finishing up the month on a quiet note, friends. There are five new releases to look at today, with a few notables amongst them. We’ve got summaries for... | Read more »

Price Scanner via MacPrices.net

Holiday Sale: Apple AirPods Pro for only $199...
Amazon has new 2022 AirPods Pro in stock and on sale for $199.99 shipped as part of their Holiday sale. Their price is $50 off Apple’s MSRP, equaling their Black Friday price, and it’s the lowest... Read more
New Holiday Sale: Apple retailers are offerin...
Several Apple retailers lowered prices on 10.9″ iPad Airs overnight to lows of $100 off MSRP starting at $499. Their prices are the lowest available for iPad Airs anywhere this Holiday season right... Read more
New Holiday sale at Amazon: Take $50 off Appl...
Amazon has Apple’s new 10th-generation iPads in stock and on sale, for the first time, for $50 off MSRP starting at only $399. Their discount applies to all models and all colors. With the discount,... Read more
Holiday Sale: Get an 8.3″ Apple iPad mini for...
Sams Club has 10.9″ 64GB iPad minis on Holiday sale for $80-$100 off MSRP through December 7, 2022. With their discount, prices start at $399 — the cheapest price for a new iPad mini from any of the... Read more
Sams Club Holiday December Event sale: Apple...
Apple AirPods Max headphones are on sale at Sams Club for $110 off MSRP ($439) as part of their December Event sale, ending on December 7, 2022, valid for all colors. Sale price for online orders... Read more
Apple’s 10.2″ 64GB 9th-generation iPads are o...
Sams Club has 9th-generation 64GB iPads on Holiday sale for $60 off MSRP through December 7, 2022. With their discount, prices start at $259 — the cheapest price for a new iPad from any of the Apple... Read more
11″ 128GB WiFi M2 iPad Pro on sale for $749,...
B&H Photo has the new 11″ 128GB WiFi M2-powered iPad Pro (in Space Gray or Silver) on Holiday sale for $749 including free 1-2 day shipping to most US addresses. Their price is $50 off MSRP and... Read more
Find the best Holiday sale price on an iPad u...
We’ve updated our iPad Price Trackers with the latest information on the new 10th-generation iPads, M2-powered iPad Pros, M1 iPad Airs, iPad minis, and 9th generation iPads from Apple’s authorized... Read more
Apple retailers are offering $100-$150 Holida...
Apple retailers have posted their most-recent Holiday sale prices on 13″ MacBook Airs. Take up to $150 off MSRP on M2-powered Airs with these sales with prices starting at only $1099. Free shipping... Read more
Holiday Sale: Apple’s 14″ MacBook Pros with M...
B&H Photo is offering $200-$300 discounts on Apple’s 14″ MacBook Pros with M1 Pro CPUs as part of their Holiday 2022 sale, with prices starting at $1799. Free 1-2 day shipping is available to... Read more

Jobs Board

Support Technician II - *Apple* Support - O...
…problems and acting as a liaison between customers and resolving groups. As an Apple Technical Specialist, you will be supporting many of our popular Apple Read more
*Apple* Electronic Repair Technician - PlanI...
…a highly motivated individual to join our Production Department as an Apple Electronic Repair Technician. The computer repair technician will diagnose, assemble, Read more
Lead Developer - *Apple* tvOS - Rumble (Uni...
…earnings, and positive sentiment About the role: We are looking for a Lead Apple tvOS Developer to join our application engineering team to expand our video centric Read more
Tier 1 Endpoint Engineer - *Apple* - Red Ri...
…Desk on site, at our Client's location, with a focus on support to Apple products. This position will handle technical support requests directly from customers and Read more
Product Manager II - *Apple* - DISH (United...
…you will be doing We seek an ambitious, data-driven thinker to assist the Apple Product Development team as our new Retail Wireless division continues to grow and Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.