2006-11-17 18:45:31 +00:00
|
|
|
<!-- ##### SECTION Title ##### -->
|
|
|
|
ClutterAlpha
|
|
|
|
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
|
|
<para>
|
|
|
|
#ClutterBehaviour, #ClutterTimeline
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### STRUCT ClutterAlpha ##### -->
|
|
|
|
<para>
|
|
|
|
The #ClutterAlpha structure contains only private data and should not be
|
|
|
|
accessed directly.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### ARG ClutterAlpha:alpha ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### ARG ClutterAlpha:timeline ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
<!-- ##### STRUCT ClutterAlphaClass ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@parent_class:
|
|
|
|
@_clutter_alpha_1:
|
|
|
|
@_clutter_alpha_2:
|
|
|
|
@_clutter_alpha_3:
|
|
|
|
@_clutter_alpha_4:
|
|
|
|
@_clutter_alpha_5:
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_new ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_new_full ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@timeline:
|
|
|
|
@func:
|
|
|
|
@data:
|
|
|
|
@destroy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_get_alpha ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_MAX_ALPHA ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
Maximum value of the alpha function. You should use this value to
|
|
|
|
scale the computed alpha value.
|
2006-11-17 18:45:31 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### USER_FUNCTION ClutterAlphaFunc ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
The alpha function is a function of time. You should provide a function
|
|
|
|
transforming the current position in the timeline.
|
2006-11-17 18:45:31 +00:00
|
|
|
</para>
|
|
|
|
|
2006-12-13 18:11:50 +00:00
|
|
|
@alpha: a #ClutterAlpha
|
|
|
|
@user_data: optional user defined data passed to the function
|
|
|
|
@Returns: a value between 0 and CLUTTER_ALPHA_MAX_ALPHA
|
2006-11-17 18:45:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_set_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@func:
|
|
|
|
@data:
|
|
|
|
@destroy:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_set_timeline ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@timeline:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_alpha_get_timeline ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-05-16 11:32:50 +00:00
|
|
|
<!-- ##### STRUCT ClutterSmoothstep ##### -->
|
|
|
|
<para>
|
|
|
|
Represents minimum and maximum thresholds for the smoothstep function. The
|
|
|
|
thresholds are values from <0,1> relative to the frame-length of the behaviour,
|
|
|
|
i.e., if the behaviour consists of 60 frames, threshold of 0.25 corresponds to
|
|
|
|
frame 15, and threshold of 1.0 to frame 60.
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@min: lower threshold; a #ClutterFixed value from <0,1>
|
|
|
|
@max: upper threshold; a #ClutterFixed value from <0,1>
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_smoothstep_copy ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@smoothstep:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_smoothstep_free ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@smoothstep:
|
|
|
|
|
|
|
|
|
2006-12-05 05:16:03 +00:00
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_RAMP_INC ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
Symbolic name for passing clutter_ramp_inc_func().
|
2006-12-05 05:16:03 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_ramp_inc_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@dummy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_RAMP_DEC ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
Symbolic name for passing clutter_ramp_dec_func().
|
2006-12-05 05:16:03 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_ramp_dec_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@dummy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_RAMP ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
Symbolic name for passing clutter_ramp_func().
|
2006-12-05 05:16:03 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_ramp_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@dummy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_SINE ##### -->
|
|
|
|
<para>
|
2006-12-13 18:11:50 +00:00
|
|
|
Symbolic name for passing clutter_sine_func().
|
2006-12-05 05:16:03 +00:00
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_sine_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@dummy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-03-22 20:23:29 +00:00
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_SQUARE ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_square_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@dummy:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|
2007-05-16 15:00:41 +00:00
|
|
|
<!-- ##### MACRO CLUTTER_ALPHA_SMOOTHSTEP ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- ##### FUNCTION clutter_smoothstep_func ##### -->
|
|
|
|
<para>
|
|
|
|
|
|
|
|
</para>
|
|
|
|
|
|
|
|
@alpha:
|
|
|
|
@data:
|
|
|
|
@Returns:
|
|
|
|
|
|
|
|
|