MACROMEDIA DIRECTOR MX 2004-DIRECTOR SCRIPTING, Reference

Page: 269 / 1130

constrainH() 269
Parameters
intPaletteIndex
Required if using 8-bit palette values. An integer that specifies the 8-bit palette
value to use. Valid values range from 0 to 255. All other values are truncated.
intRed
Required if using RGB values. An integer that specifies the red color component in the
current palette. Valid values range from 0 to 255. All other values are truncated.
intGreen
Required if using RGB values. An integer that specifies the green color component in
the current palette. Valid values range from 0 to 255. All other values are truncated.
intBlue
Required if using RGB values. An integer that specifies the blue color component in the
current palette. Valid values range from 0 to 255. All other values are truncated.
Example
These statements display the color of sprite 6 in the Message window, and then set the color of
sprite 6 to a new value:
-- Lingo syntax
put(sprite(6).color) -- paletteIndex(255)
sprite(6).color = color(137)
put(sprite(6).color) -- paletteIndex(137)
// JavaScript syntax
put(sprite(6).color) // paletteIndex(255);
sprite(6).color = color(137);
put(sprite(6).color) // paletteIndex(137);
constrainH()
Usage
-- Lingo syntax
_movie.constrainH(
intSpriteNum , intPosn )
// JavaScript syntax
_movie.constrainH(
intSpriteNum , intPosn );
Description
Movie method; returns an integer whose value depends on the horizontal coordinates of the left
and right sides of a sprite.
The returned integer can be one of three possible values.
•
If the
intPosn
parameter is between the values of the sprite’s left and right coordinates, the
returned integer equals
intPosn
.
•
If the
intPosn
parameter is less than the value of the sprite’s left coordinate, the returned
integer changes to the value of the sprite’s left coordinate.
•
If the
intPosn
parameter is greater than the value of the sprite’s right coordinate, the returned
integer changes to the value of the sprite’s right coordinate.
This method does not change the sprite’s properties.
Both the
constrainH()
and
constrainV()
methods constrain only one axis each.