TrapPreset

Methods:

addEventListener, duplicate, extractLabel, getElements, insertLabel, remove, removeEventListener, toSource, toSpecifier

Objects:

Boolean, EndJoin, EventListeners, Events, Number, Object, String, TrapEndTypes, TrapImagePlacementTypes

Property Listing

Property	Type	Access	Description
blackColorThreshold	Number (range 0 - 100)	read/write	The minimum amount (as a percentage) of black ink required before the black width setting is applied. (Range: 0 to 100)
blackDensity	Number (range 0 - 10)	read/write	The neutral density value at or above which an ink is considered black. (Range: .001 to 10)
blackWidth	Number String	read/write	The black width. (Range depends on unit. For points: 0.0 to 8.0; picas: 0p0 to 0p8; inches: 0 to 0.1111; mm: 0 to 2.822; cm: 0 to .2822; ciceros: 0c0 to 0c7.507)
colorReduction	Number (range 0 - 100)	read/write	The degree (as a percentage) to which components from abutting colors are used to reduce the trap color. (Range: 0 to 100) Note: 0% makes a trap whose neutral density is equal to the neutral density of the darker color.
defaultTrapWidth	Number String	read/write	The default width for trapping all colors except those involving solid black. (Range depends on unit. For points: 0.0 to 8.0; picas: 0p0 to 0p8; inches: 0 to 0.1111; mm: 0 to 2.822; cm: 0 to .2822; ciceros: 0c0 to 0c7.507)
eventListeners	EventListeners EventListener	readonly	A collection of event listeners.
events	Events Event	readonly	A collection of events.
id	Number	readonly	The unique ID of the TrapPreset.
imagePlacement	TrapImagePlacementTypes TrapImagePlacementTypes.CENTER_EDGES TrapImagePlacementTypes.CHOKE TrapImagePlacementTypes.IMAGES_OVER_SPREAD TrapImagePlacementTypes.IMAGE_NEUTRAL_DENSITY	read/write	The trap placement between vector objects and bitmap images.
imagesToImages	Boolean	read/write	If true, turns on trapping along the boundary of overlapping or abutting bitmap images.
index	Number	readonly	The index of the TrapPreset within its containing object.
internalImages	Boolean	read/write	If true, turns on trapping among colors within individual bitmap images.
isValid	Boolean	readonly	Returns true if the object specifier resolves to valid objects.
label	String	read/write	A property that can be set to any string.
name	String	read/write	The name of the TrapPreset.
objectsToImages	Boolean	read/write	If true, ensures that vector objects overlap bitmap images.
oneBitImages	Boolean	read/write	If true, ensures that one-bit images trap to abutting objects.
parent	Application Document	readonly	The parent of the TrapPreset (a Application or Document).
properties	Object	read/write	A property that allows setting of several properties at the same time.
slidingTrapThreshold	Number (range 0 - 100)	read/write	The difference (as a percentage) between the neutral densities of abutting colors at which the trap is moved from the darker side of a color edge toward the centerline. (Range: 0 to 100)
stepThreshold	Number (range 1 - 100)	read/write	The amount (as a percentage) that components of abutting colors must vary before a trap is created. (Range: 1 to 100)
trapEnd	TrapEndTypes TrapEndTypes.MITER_TRAP_ENDS TrapEndTypes.OVERLAP_TRAP_ENDS	read/write	The shape to use at the intersection of three-way traps.
trapJoin	EndJoin EndJoin.BEVEL_END_JOIN EndJoin.MITER_END_JOIN EndJoin.ROUND_END_JOIN	read/write	The join type of the trap preset.

Method Listing

EventListener addEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Adds an event listener.

Parameter	Type	Description
eventType	String	The event type.
handler	File JavaScriptFunction	The event handler. Can accept: File or JavaScript Function.
captures	Boolean	This parameter is obsolete. (Optional) (default: false)

Parameter

Type

Description

eventType

String

The event type.

handler

File

JavaScriptFunction

The event handler. Can accept: File or JavaScript Function.

captures

Boolean

This parameter is obsolete. (Optional)

(default: false)

TrapPreset duplicate ()

Duplicates the TrapPreset.

String extractLabel (key:String)

Gets the label value associated with the specified key.

Parameter	Type	Description
key	String	The key.

TrapPreset getElements ()

Resolves the object specifier, creating an array of object references.

undefined insertLabel (key:String, value:String)

Sets the label to the value associated with the specified key.

Parameter	Type	Description
key	String	The key.
value	String	The value.

undefined remove (replacingWith:TrapPreset)

Deletes the trap preset.

Parameter	Type	Description
replacingWith	TrapPreset	The trap preset to apply in place of the deleted preset.

Boolean removeEventListener (eventType:String, handler:Varies File JavaScriptFunction, [captures:Boolean=Boolean])

Removes the event listener.

Parameter	Type	Description
eventType	String	The registered event type.
handler	File JavaScriptFunction	The registered event handler. Can accept: File or JavaScript Function.
captures	Boolean	This parameter is obsolete. (Optional) (default: false)