Table of Contents

Introduction
Who Should Read This?
How Does It Work?
Download(s)
System and Software Requirements
Adobe Photoshop Reserved Words

Tutorials
Overview
  1. Starting a Flex Project
  2. Hello World Panel
  3. Placing the CSXS Library

  4. Shortcut Buttons Panel
    1. JavaScript
    2. Design the Panel
    3. ActionScript
    4. Photoshop Persistent
    5. CSXS Logger AIR Debugger (Optional)

  5. Setting Up Script Listener

  6. Color Picker Panel
    1. JavaScript
    2. Design the Panel
    3. Find Character ID Code to Register Events
    4. ActionScript
    5. Create Custom Icons

  7. Flickr Search Panel
    1. Design the Panel
    2. Create a Flickr Service
    3. Design a Custom Module
    4. Modify Panel's Properties
    5. Connect on Preferences

  8. Per Layer Metadata Panel
    1. View Metadata
    2. JavaScript
    3. Find Character ID Code to Register Events
    4. Designing the Panel
    5. ActionScript
    6. Using Photomerge
Other Samples
Best Practices
Frequently Asked Questions
Acronyms and Definitions
Links
Adobe® Photoshop® Panel Developer's Guide

Best Practices

This section discusses recommended best practices that the guide hopes developers will follow to help all users and developers involved.

Honor the User's Preferences to Connect Online: This part was discussed under Connect on Preferences section of the Flickr Search Panel tutorial. It is important to honor the user's preferences if the user does not want to connect to the internet.

Resign Focus (Keyboard Events): It is important to resign focus to Adobe Photoshop whenever the user presses the ESC key and whenever the user presses the ENTER or RETURN key to execute an event or a text input control component. A spacebar should never press a button.

Resource Management: Since every Photoshop Panel requires a significant amount of memory, it is wise to test memory usage and eliminating unnecessary lines of code or components. The property Application.freeMemory in JavaScript returns the amount of unused memory available to Adobe Photoshop.

Resign Focus (Keyboard Events): It is important to resign focus to Adobe Photoshop whenever the user presses the ESC key and whenever the user presses the ENTER or RETURN key to execute an event or a text input control component. A spacebar should never press a button.

Resign Focus (Mouse Events): It is important to resign focus to Adobe Photoshop whenever the user clicks on any part of the panel other than the control components that retains focus (i.e. text input, combo box). This includes but are not limited to buttons, sliders, radio buttons, and the panel's background.

Focus Feedback: The user should be given specific visual feedback such as where the type in will be processed or which item in a combo box is selected. This includes but are not limited to a flashing bar "|" in a text input field, a selected text block in a text input field, or an active combo box.

Behavior of a Tab Key: If there are multiple text input or combo box control component, the tab key should cycle through each of them. However, if there exists only one text-input or combo box control component, the current entered value should only be selected. For example, the current value in a text input should be highlighted if cycled through the tab keys. Note: The user should not be able to able to cycle through other components such as buttons preventing the spacebar from executing or pressing a component.