2022-07-30 12:24:03 -04:00
|
|
|
#ifndef __CCEGLVIEWPROTOCOL_H__
|
|
|
|
#define __CCEGLVIEWPROTOCOL_H__
|
|
|
|
|
2022-10-17 08:46:36 -04:00
|
|
|
#include "../include/ccTypes.h"
|
2022-07-30 12:24:03 -04:00
|
|
|
|
|
|
|
enum ResolutionPolicy
|
|
|
|
{
|
|
|
|
// The entire application is visible in the specified area without trying to preserve the original aspect ratio.
|
|
|
|
// Distortion can occur, and the application may appear stretched or compressed.
|
|
|
|
kResolutionExactFit,
|
|
|
|
// The entire application fills the specified area, without distortion but possibly with some cropping,
|
|
|
|
// while maintaining the original aspect ratio of the application.
|
|
|
|
kResolutionNoBorder,
|
|
|
|
// The entire application is visible in the specified area without distortion while maintaining the original
|
|
|
|
// aspect ratio of the application. Borders can appear on two sides of the application.
|
|
|
|
kResolutionShowAll,
|
|
|
|
// The application takes the height of the design resolution size and modifies the width of the internal
|
|
|
|
// canvas so that it fits the aspect ratio of the device
|
|
|
|
// no distortion will occur however you must make sure your application works on different
|
|
|
|
// aspect ratios
|
|
|
|
kResolutionFixedHeight,
|
|
|
|
// The application takes the width of the design resolution size and modifies the height of the internal
|
|
|
|
// canvas so that it fits the aspect ratio of the device
|
|
|
|
// no distortion will occur however you must make sure your application works on different
|
|
|
|
// aspect ratios
|
|
|
|
kResolutionFixedWidth,
|
|
|
|
|
|
|
|
kResolutionUnKnown,
|
|
|
|
};
|
|
|
|
|
|
|
|
NS_CC_BEGIN
|
|
|
|
|
|
|
|
#define CC_MAX_TOUCHES 5
|
|
|
|
|
|
|
|
class EGLTouchDelegate;
|
|
|
|
class CCSet;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup platform
|
|
|
|
* @{
|
|
|
|
* @js NA
|
|
|
|
*/
|
|
|
|
|
|
|
|
class CC_DLL CCEGLViewProtocol
|
|
|
|
{
|
|
|
|
GEODE_FRIEND_MODIFY
|
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
CCEGLViewProtocol();
|
2023-06-07 11:58:19 -04:00
|
|
|
GEODE_CUSTOM_CONSTRUCTOR_BEGIN(CCEGLViewProtocol)
|
2022-07-30 12:24:03 -04:00
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual ~CCEGLViewProtocol();
|
|
|
|
|
|
|
|
/** Force destroying EGL view, subclass must implement this method.
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2023-06-07 11:58:19 -04:00
|
|
|
virtual void end() {}
|
2022-07-30 12:24:03 -04:00
|
|
|
|
|
|
|
/** Get whether opengl render system is ready, subclass must implement this method.
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2023-06-07 11:58:19 -04:00
|
|
|
virtual bool isOpenGLReady() { return false; }
|
2022-07-30 12:24:03 -04:00
|
|
|
|
|
|
|
/** Exchanges the front and back buffers, subclass must implement this method.
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2023-06-07 11:58:19 -04:00
|
|
|
virtual void swapBuffers() {}
|
2022-07-30 12:24:03 -04:00
|
|
|
|
|
|
|
/** Open or close IME keyboard , subclass must implement this method.
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2023-06-07 11:58:19 -04:00
|
|
|
virtual void setIMEKeyboardState(bool bOpen) {}
|
2022-07-30 12:24:03 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the frame size of EGL view.
|
|
|
|
* In general, it returns the screen size since the EGL view is a fullscreen view.
|
|
|
|
*/
|
|
|
|
virtual const CCSize& getFrameSize() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the frame size of EGL view.
|
|
|
|
*/
|
|
|
|
virtual void setFrameSize(float width, float height);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the visible area size of opengl viewport.
|
|
|
|
*/
|
|
|
|
virtual CCSize getVisibleSize() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the visible origin point of opengl viewport.
|
|
|
|
*/
|
|
|
|
virtual CCPoint getVisibleOrigin() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set the design resolution size.
|
|
|
|
* @param width Design resolution width.
|
|
|
|
* @param height Design resolution height.
|
|
|
|
* @param resolutionPolicy The resolution policy desired, you may choose:
|
|
|
|
* [1] kResolutionExactFit Fill screen by stretch-to-fit: if the design resolution ratio of width to height is different from the screen resolution ratio, your game view will be stretched.
|
|
|
|
* [2] kResolutionNoBorder Full screen without black border: if the design resolution ratio of width to height is different from the screen resolution ratio, two areas of your game view will be cut.
|
|
|
|
* [3] kResolutionShowAll Full screen with black border: if the design resolution ratio of width to height is different from the screen resolution ratio, two black borders will be shown.
|
|
|
|
*/
|
|
|
|
virtual void setDesignResolutionSize(float width, float height, ResolutionPolicy resolutionPolicy);
|
|
|
|
|
|
|
|
/** Get design resolution size.
|
|
|
|
* Default resolution size is the same as 'getFrameSize'.
|
|
|
|
*/
|
|
|
|
virtual const CCSize& getDesignResolutionSize() const;
|
|
|
|
|
|
|
|
/** Set touch delegate */
|
|
|
|
virtual void setTouchDelegate(EGLTouchDelegate * pDelegate);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set opengl view port rectangle with points.
|
|
|
|
*/
|
|
|
|
virtual void setViewPortInPoints(float x , float y , float w , float h);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Set Scissor rectangle with points.
|
|
|
|
*/
|
|
|
|
virtual void setScissorInPoints(float x , float y , float w , float h);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get whether GL_SCISSOR_TEST is enable
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual bool isScissorEnabled();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the current scissor rectangle
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual CCRect getScissorRect();
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void setViewName(const char* pszViewName);
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
const char* getViewName();
|
|
|
|
|
|
|
|
/** Touch events are handled by default; if you want to customize your handlers, please override these functions:
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void handleTouchesBegin(int num, int ids[], float xs[], float ys[]);
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void handleTouchesMove(int num, int ids[], float xs[], float ys[]);
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void handleTouchesEnd(int num, int ids[], float xs[], float ys[]);
|
|
|
|
/**
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
virtual void handleTouchesCancel(int num, int ids[], float xs[], float ys[]);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the opengl view port rectangle.
|
|
|
|
*/
|
|
|
|
const CCRect& getViewPortRect() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get scale factor of the horizontal direction.
|
|
|
|
*/
|
|
|
|
float getScaleX() const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Get scale factor of the vertical direction.
|
|
|
|
*/
|
|
|
|
float getScaleY() const;
|
2023-12-20 21:14:53 -05:00
|
|
|
|
|
|
|
virtual void pollInputEvents();
|
|
|
|
void updateDesignResolutionSize();
|
|
|
|
|
2022-07-30 12:24:03 -04:00
|
|
|
private:
|
|
|
|
void getSetOfTouchesEndOrCancel(CCSet& set, int num, int ids[], float xs[], float ys[]);
|
|
|
|
|
|
|
|
protected:
|
|
|
|
EGLTouchDelegate* m_pDelegate;
|
|
|
|
|
|
|
|
// real screen size
|
|
|
|
CCSize m_obScreenSize;
|
|
|
|
// resolution size, it is the size appropriate for the app resources.
|
|
|
|
CCSize m_obDesignResolutionSize;
|
|
|
|
// the view port size
|
|
|
|
CCRect m_obViewPortRect;
|
|
|
|
// the view name
|
|
|
|
char m_szViewName[50];
|
|
|
|
|
|
|
|
float m_fScaleX;
|
|
|
|
float m_fScaleY;
|
|
|
|
ResolutionPolicy m_eResolutionPolicy;
|
|
|
|
};
|
|
|
|
|
|
|
|
// end of platform group
|
|
|
|
/// @}
|
|
|
|
|
|
|
|
NS_CC_END
|
|
|
|
|
|
|
|
#endif /* __CCEGLVIEWPROTOCOL_H__ */
|