libsswf: sswf::State Class Reference

These flags describe when a given button state is shown or used.

Enumerator:

STATE_FLAG_UP	The flag representing the mouse button not being clicked. This flag is used to represent the state of the button when the mouse is not being clicked. See also: enum sswf::State::STATE_FLAG_DOWN
STATE_FLAG_OVER	The flag representing the mouse button when over the hit test area. This flag is used to represent the state of the button when the mouse is over the button hit test area. Use this flag with the up or down flags to get the corresponding state. See also: enum sswf::State::STATE_FLAG_DOWN enum sswf::State::STATE_FLAG_UP
STATE_FLAG_DOWN	The flag representing the mouse button when clicked. This flag is used to represent the state of the button when the mouse is clicked over the button hit test area. See also: enum sswf::State::STATE_FLAG_UP
STATE_FLAG_HIT_TEST	The flag representing the hit test area. This flag is used to represent that special state of the button used to determine the hit test of the button. The hit test is used to know whether the end-user has his mouse pointer over the button or not and when clicking, whether the end-user really clicked on the button. The hit area is never drawn on the screen. You can put it in some other states if you want the shape to appear on the screen.
STATE_ALL_FLAGS	A mask representing all the flags. This value is used to know whether all the flags and only the flags you need were defined.

This function calls the State::Reset(void) function.

See also:

sswf::State::Reset(void)

References Reset().

Use this function to retrieve the flags of a state.

See also:

sswf::State::SetFlags(unsigned char flags)

References f_flags.

Referenced by sswf::TagButton::Save(), and sswf::TagButton::SetState().

This function can be used to query the State for a color transformation or not.

This function is used by the TagButton to check all the states you saved in said button. If any one has a color transformation matrix, then all the states will be saved with a color transformation matrix even one single state makes use of it (i.e. all the others are identity matrices.)

Note:

If the color transformation has no effect, but it was defined that way, then the function still returns true.

Returns:

true when the State has a color transformation.

References f_has_color_transform.

Referenced by sswf::TagButton::PreSave().

This function parses a data buffer that is expected to include one state.

Whenever the end of the list is found, the function returns ERROR_CODE_END_OF_STATES. Watch out! This happens only once. If you miss it, you will read the following data as if it were state data.

Also, whathever State was used to read the ERROR_CODE_END_OF_STATES will not be valid.

Note:

It is very important to pass the correct color_transform flag. The State by itself cannot know whether there is a color transform or not and we have to know for sure that it is there.

Parameters:

[in]	data	The data buffer where the State shall be saved
[in]	color_transform	Whether the color transform matrix is to be saved

Returns:

ERROR_CODE_NONE if no error occur, ERROR_CODE_END_OF_STATES when the special flags set of 0 is found, and another error code otherwise

References sswf::ErrorManager::ERROR_CODE_END_OF_STATES, sswf::ErrorManager::ERROR_CODE_NONE, f_blend_mode, f_color_transform, f_flags, f_has_color_transform, f_id, f_layer, f_matrix, sswf::Data::GetByte(), sswf::Data::GetShort(), sswf::BlendMode::Parse(), sswf::ColorTransform::Parse(), and sswf::Matrix::Parse().

Referenced by sswf::TagButton::ParseTag().

This function is used to reset a State object to its initial setup.

The referenced shape identifier is set to zero (no shape referenced).

The flags are set to zero which represents an invalid set of flags; you will have to initialize them with a call to sswf::State::SetFlags(unsigned char flags)

The layer is set to zero.

The matrix is reset to the identity.

The State is marked as not having a color transformation, color transform which is also reset to have no effect.

See also:

sswf::State::State(void)

sswf::State::HasColorTransform(void) const

State::SetObjectID(sswf_id_t id)

State::SetFlags(unsigned char flags)

State::SetLayer(unsigned short layer)

State::SetMatrix(const Matrix& matrix)

State::SetColorTransform(const ColorTransform& color_transform)

References f_color_transform, f_flags, f_has_color_transform, f_id, f_layer, f_matrix, sswf::ColorTransform::Reset(), and sswf::Matrix::Reset().

Referenced by State().

This function can be used to save the State in a Data buffer.

The color_transform flag is used to know whether the color transform needs to be saved or not.

Parameters:

[in]	data	The data buffer where the State shall be saved
[in]	color_transform	Whether the color transform matrix is to be saved

Returns:

ERROR_CODE_NONE if no error occur, another error code otherwise

References sswf::ErrorManager::ERROR_CODE_BAD_STATE_FLAGS, sswf::ErrorManager::ERROR_CODE_NONE, f_blend_mode, f_color_transform, f_error_manager, f_flags, f_id, f_layer, f_matrix, sswf::BlendMode::HasBlendMode(), sswf::ErrorManager::OnError(), sswf::Data::PutByte(), sswf::Data::PutShort(), sswf::BlendMode::Save(), sswf::ColorTransform::Save(), and sswf::Matrix::Save().

Referenced by sswf::TagButton::Save().

This function sets the blending mode to be used to render the object of this state. This is the same as the blending mode of the TagPlace object.

Parameters:

[in]

blend_mode

The blending mode to use

References f_blend_mode.

This function is used to define a color transformation matrix. This function has the side effect to setting a flag to know whether the color transformation matrix was defined or not.

Parameters:

[in]

color_transform

The color transformation matrix

See also:

State::HasColorTransform(void) const

References f_color_transform, and f_has_color_transform.

This function is used to define how the button will react in regard to this State. One or more of the following flags can be defined:

STATE_FLAG_UP STATE_FLAG_OVER STATE_FLAG_DOWN STATE_FLAG_HIT_TEST

Use the or (|) operator to define multiple flags at the same time.

The Reset() function sets the flags to zero. Thus this function must be called before you try saving the corresponding button.

Note:

At least one flag needs to be set or the Save() function will fail.

Bug:

Flags are defined on the lower 4 bits of the char. Trying to define another bit will generate an assert() in DEBUG mode.

Parameters:

[in]

flags

A set of STATE_FLAG_... flags

See also:

sswf::State::Save(Data& data, bool color_transform)

References sswf::ErrorManager::ERROR_CODE_BAD_STATE_FLAGS, f_error_manager, f_flags, sswf::ErrorManager::OnError(), and STATE_ALL_FLAGS.

Each state has a layer (or depth as in the display list) to define the z position of each shape within the button.

There is no known limits to the layer number. The objects with a smaller layer number appear behind the object with a larger layer number.

The layer number 0 shall not be used.

Parameters:

[in]

layer

The layer at which the object is to be saved

See also:

sswf::TagPlace::SetDepth(int depth)

References f_layer.

When placing an object on the screen, you can use a transformation matrix (to rotate, scale, skew and translate the object about.)

This is similar to the sswf::TagPlace::SetMatrix(const Matrix& matrix) function.

Parameters:

[in]

matrix

The transformation Matrix

See also:

sswf::TagPlace::SetMatrix(const Matrix& matrix)

References f_matrix.

The object referenced is used for two purposes: one is to draw a different shape on a mouse movement and/or click event (this renders the button quite dynamic,) and the other is to select an area which is sensitive to mouse clicks.

In order for a click to be triggered, it is necessary to know where the user needs to place the mouse to trigger the said event. This is done using the hit test shape (the object identifier needs to be the identifier of a shape for the State to function properly. This has changed in version 8 of SWF [it seems, TBD] and a Sprite can also be specified now.)

Parameters:

[in]

id

The identifier of the object referenced

References f_id.

Referenced by Parse(), Save(), and SetBlendMode().

Referenced by Parse(), Reset(), Save(), and SetColorTransform().

Referenced by Save(), and SetFlags().

Referenced by GetFlags(), Parse(), Reset(), Save(), and SetFlags().

Referenced by HasColorTransform(), Parse(), Reset(), and SetColorTransform().

Referenced by Parse(), Reset(), Save(), and SetObjectID().

Referenced by Parse(), Reset(), Save(), and SetLayer().

Referenced by Parse(), Reset(), Save(), and SetMatrix().