jedi-academy/code/ff/IFC/ImmDamper.h
2013-04-23 15:21:39 +10:00

185 lines
4.2 KiB
C++

/**********************************************************************
Copyright (c) 1997 - 2000 Immersion Corporation
Permission to use, copy, modify, distribute, and sell this
software and its documentation may be granted without fee;
interested parties are encouraged to request permission from
Immersion Corporation
801 Fox Lane
San Jose, CA 95131
408-467-1900
IMMERSION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
IN NO EVENT SHALL IMMERSION BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
FILE: ImmDamper.h
PURPOSE: Immersion Foundation Classes Damper Effect
STARTED: Oct.14.97
NOTES/REVISIONS:
Mar.02.99 jrm (Jeff Mallett): Force-->Feel renaming
Mar.02.99 jrm: Added GetIsCompatibleGUID
Mar.15.99 jrm: __declspec(dllimport/dllexport) the whole class
Nov.15.99 efw (Evan Wies): Converted to IFC
**********************************************************************/
#if !defined(AFX_IMMDamper_H__135B88C4_4175_11D1_B049_0020AF30269A__INCLUDED_)
#define AFX_IMMDamper_H__135B88C4_4175_11D1_B049_0020AF30269A__INCLUDED_
#if _MSC_VER >= 1000
#pragma once
#endif // _MSC_VER >= 1000
#ifndef _IFCDLL_
#define DLLIFC __declspec(dllimport)
#else
#define DLLIFC __declspec(dllexport)
#endif
#include <windows.h>
#include "ImmCondition.h"
//================================================================
// Constants
//================================================================
#define IMM_DAMPER_DEFAULT_VISCOSITY 2500
#define IMM_DAMPER_DEFAULT_SATURATION 10000
#define IMM_DAMPER_DEFAULT_MIN_VELOCITY 0
//================================================================
// CImmDamper
//================================================================
//
// ------ PUBLIC INTERFACE ------
//
class DLLIFC CImmDamper : public CImmCondition
{
//
// CONSTRUCTOR/DESTRUCTOR
//
public:
// Constructor
CImmDamper();
// Destructor
virtual ~CImmDamper();
//
// ATTRIBUTES
//
public:
virtual BOOL
GetIsCompatibleGUID(
GUID &guid
);
BOOL
ChangeParameters(
LONG lViscosity,
DWORD dwSaturation = IMM_EFFECT_DONT_CHANGE,
DWORD dwMinVelocity = IMM_EFFECT_DONT_CHANGE,
LONG lDirectionX = IMM_EFFECT_DONT_CHANGE,
LONG lDirectionY = IMM_EFFECT_DONT_CHANGE
);
BOOL
ChangeParametersPolar(
LONG lViscosity,
DWORD dwSaturation,
DWORD dwMinVelocity,
LONG lAngle
);
BOOL ChangeViscosity( LONG lViscosity );
BOOL ChangeMinVelocityX( DWORD dwMinVelocity );
BOOL ChangeMinVelocityY( DWORD dwMinVelocity );
//For setting both axes to the same value
BOOL ChangeMinVelocity( DWORD dwMinVelocity );
BOOL GetViscosity( LONG &lViscosity );
BOOL GetMinVelocityX( DWORD &dwMinVelocity );
BOOL GetMinVelocityY( DWORD &dwMinVelocity );
//
// OPERATIONS
//
public:
virtual BOOL
Initialize(
CImmDevice* pDevice,
DWORD dwViscosity = IMM_DAMPER_DEFAULT_VISCOSITY,
DWORD dwSaturation = IMM_DAMPER_DEFAULT_SATURATION,
DWORD dwMinVelocity = IMM_DAMPER_DEFAULT_MIN_VELOCITY,
DWORD dwfAxis = IMM_EFFECT_AXIS_BOTH,
LONG lDirectionX = IMM_EFFECT_DEFAULT_DIRECTION_X,
LONG lDirectionY = IMM_EFFECT_DEFAULT_DIRECTION_Y,
DWORD dwNoDownload = 0
);
virtual BOOL
InitializePolar(
CImmDevice* pDevice,
DWORD dwViscosity,
DWORD dwSaturation,
DWORD dwMinVelocity,
LONG lAngle,
DWORD dwNoDownload = 0
);
//
// ------ PRIVATE INTERFACE ------
//
//
// HELPERS
//
protected:
//
// INTERNAL DATA
//
protected:
};
//
// INLINES
//
inline BOOL
CImmDamper::GetIsCompatibleGUID(GUID &guid)
{
return IsEqualGUID(guid, GUID_Imm_Damper);
}
#endif // !defined(AFX_IMMDamper_H__135B88C4_4175_11D1_B049_0020AF30269A__INCLUDED_)