Project

General

Profile

Download (3.16 KB) Statistics
| Branch: | Revision:

library / src / main / java / org / distorted / library / message / EffectListener.java @ cacc63de

1
///////////////////////////////////////////////////////////////////////////////////////////////////
2
// Copyright 2016 Leszek Koltunski                                                               //
3
//                                                                                               //
4
// This file is part of Distorted.                                                               //
5
//                                                                                               //
6
// Distorted is free software: you can redistribute it and/or modify                             //
7
// it under the terms of the GNU General Public License as published by                          //
8
// the Free Software Foundation, either version 2 of the License, or                             //
9
// (at your option) any later version.                                                           //
10
//                                                                                               //
11
// Distorted is distributed in the hope that it will be useful,                                  //
12
// but WITHOUT ANY WARRANTY; without even the implied warranty of                                //
13
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                 //
14
// GNU General Public License for more details.                                                  //
15
//                                                                                               //
16
// You should have received a copy of the GNU General Public License                             //
17
// along with Distorted.  If not, see <http://www.gnu.org/licenses/>.                            //
18
///////////////////////////////////////////////////////////////////////////////////////////////////
19

    
20
package org.distorted.library.message;
21

    
22
///////////////////////////////////////////////////////////////////////////////////////////////////
23

    
24
import org.distorted.library.EffectNames;
25

    
26
/**
27
 * This interface lets users of the Distorted library get notified when something happens to one of the effects.
28
 * To receive the notifications, we first have to register with a call to {@link org.distorted.library.DistortedEffects#registerForMessages(EffectListener)}.
29
 * List of all possible events that can happen is defined in {@link EffectMessage}
30
 */
31

    
32
public interface EffectListener 
33
  {
34
/**
35
 * Gets called when event of type 'eventType' happens to effect 'effectID'.
36
 * 
37
 * @param eventType  Type of event that happened.
38
 * @param effectID   ID of the effect the event happened to. This ID must have been previously returned by one
39
 *                   of the DistortedEffects.{deform,distort,move,...} functions.
40
 * @param effectName Name of the effect as defined by EffectNames.
41
 * @param objectID   the ID of the DistortedEffects object, as returned by {@link org.distorted.library.DistortedEffects#getID()},
42
 *                   this event happened to.
43
 * @see EffectMessage
44
 * @see EffectNames
45
 */
46
   
47
  void effectMessage(final EffectMessage eventType, final long effectID, final EffectNames effectName, final long objectID);
48
  }
49

    
50
///////////////////////////////////////////////////////////////////////////////////////////////////
(1-1/2)