khanat-opennel-code/code/ryzom/client/src/misc.h

248 lines
8.7 KiB
C
Raw Normal View History

2010-05-06 00:08:41 +00:00
// Ryzom - MMORPG Framework <http://dev.ryzom.com/projects/ryzom/>
// Copyright (C) 2010 Winch Gate Property Limited
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as
// published by the Free Software Foundation, either version 3 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
#ifndef CL_MISC_H
#define CL_MISC_H
/////////////
// INCLUDE //
/////////////
// Misc
#include "nel/misc/types_nl.h"
#include "nel/misc/quat.h"
#include "nel/misc/rgba.h"
#include "nel/3d/u_instance.h"
#include "game_share/slot_types.h"
#include "game_share/mode_and_behaviour.h"
////////////
// DEFINE //
////////////
#define _MOVIE_SHOOTER_ON_ //
// They want profile functions in final version
#define _PROFILE_ON_
///////////
// CLASS //
///////////
namespace NL3D
{
class UInstance;
class UScene;
}
namespace NLMISC
{
class CNoiseValue;
class CVector;
class CBitmap;
}
struct SPropVisualA;
struct SPropVisualB;
class CPlayerSheet;
enum TLightGroup
{
LightGroupAlways = 0,
LightGroupDay,
LightGroupNight,
LightGroupFireworks,
};
class CSeeds;
//////////////
// FUNCTION //
//////////////
double keepIn_NegPi_Pi(double angle);
double angleBetween2Vect(const NLMISC::CVectorD &from, const NLMISC::CVectorD &to);
/**
* \param face : pointer on the face to make up (must not be null).
* \param idMakeUp : index of the make-up to apply.
* \warning This function does not check if 'face' is valid.
*/
void makeUp(NL3D::UInstance face, sint idMakeUp);
/**
* qStart est le quaterion <EFBFBD> t=0,
* qEnd est le quaterion <EFBFBD> t=TAnimEnd,
* time est entre 0 et 1. (1=> TAnimEnd)
*/
NLMISC::CQuat applyRotationFactor(NLMISC::CQuat in, float rotFactor, NLMISC::CQuat qStart, NLMISC::CQuat qEnd, float time);
/** Compute the angle between a source and a destination using the shortest way.
* \param from : angle between -Pi and Pi;
* \param to : angle between -Pi and Pi;
*/
double computeShortestAngle(double from, double to);
/** Return the animset base name corresponding to the mode.
* \param mode : the mode to convert.
* \param result : this will be filed with the mode animset name.
* \return bool : 'true' if 'result' is filled, 'false' if left untouched.
*/
bool mode2Anim(MBEHAV::EMode mode, std::string &result);
/** Compute the animation set to use according to weapons, mode and race.
* \param animSet : result pointer.
* \param mode : the mode.
* \param animSetBaseName : basic name to construc the complet name of the animSet.
* \param leftHand : animSet name for the left hand.
* \param rightHand : animSet name for the right hand.
* \param lookAtItemsInHands : compute animset according to items in hands or not.
* \return bool : 'true' if the new animation set is the right one. 'false' if the one choosen is not the right one.
*/
bool computeAnimSet(const class CAnimationSet *&animSet, MBEHAV::EMode mode, const std::string &animSetBaseName, const class CItemSheet *itemLeftHand, const CItemSheet *itemRightHand, bool lookAtItemsInHands);
/** Create a file with the current state of the client (good to report a bug).
*/
void dump(const std::string &name);
/** Create a file with the current state of the client (good to report a bug).
*/
void loadDump(const std::string &name);
/** Get the lod character id from the scene, according to LodCharacterName. Cached.
* -1 if id not found.
*/
sint getLodCharacterId(NL3D::UScene &scene, const std::string &lodCharacterName);
CItemSheet *getItem(const struct CGenderInfo &genderInfo, SLOTTYPE::EVisualSlot slot);
sint getColorIndex(const CGenderInfo &genderInfo, SLOTTYPE::EVisualSlot slot);
SPropVisualA buildPropVisualA(const CGenderInfo &genderInfo);
SPropVisualB buildPropVisualB(const CGenderInfo &genderInfo);
// Test wether user color is supported for a given visual slot
bool isUserColorSupported(const CPlayerSheet &playerSheet, SLOTTYPE::EVisualSlot vs);
SPropVisualA buildPropVisualA(const CPlayerSheet &playerSheet);
SPropVisualB buildPropVisualB(const CPlayerSheet &playerSheet);
// Draw a Box from 2 vectors.
void drawBox(const NLMISC::CVector &vMin, const NLMISC::CVector &vMax, const NLMISC::CRGBA &color);
// Draw a Wired Sphere
void drawSphere(const NLMISC::CVector &center, float radius, const NLMISC::CRGBA &color);
void getSeedsFromDB(CSeeds &dest);
/** Change a 'direction' vector.
* \param vectToChange : the vector to change.
* \param vect : new vector to use.
* \param compute : adjust the param 'vect' to be valid or leave the old one unchanged if impossible.
* \param check : warning if the param 'vect' is not valid (vector Null) even with compute=true.
* \return bool : 'true' if the vectToChange has been filled, else 'false'.
*/
bool setVect(NLMISC::CVector &vectToChange, const NLMISC::CVector &vect, bool compute, bool check);
// read color from client cfg system info colors
NLMISC::CRGBA interpClientCfgColor(const ucstring &src, ucstring &dest);
// Get the category from the string (src="&SYS&Who are you?" and dest="Who are you?" and return "SYS"), if no category, return "SYS"
std::string getStringCategory(const ucstring &src, ucstring &dest, bool alwaysAddSysByDefault = true);
// Get the category from the string (src="&SYS&Who are you?" and dest="Who are you?" and return "SYS"), if no category, return ""
std::string getStringCategoryIfAny(const ucstring &src, ucstring &dest);
NLMISC::CRGBA stringToRGBA(const char *ptr);
// Number of shortcut
#define RYZOM_MAX_SHORTCUT 20
// Number of render filters
enum TFilter3d
{
FilterMeshNoVP=0,
FilterMeshVP,
FilterFXs,
FilterLandscape,
FilterVegetable,
FilterSkeleton,
FilterWater,
FilterCloud,
FilterCoarseMesh,
FilterSky,
RYZOM_MAX_FILTER_3D,
};
enum TCaseMode
{
CaseNormal = 0, // Nothing done
CaseLower, // All letters in lowercase
CaseUpper, // All letters in uppercase
CaseFirstStringLetterUp, // The first letter of the string is uppercase, the others are lowercase
CaseFirstSentenceLetterUp, // The first letter of the string and each sentences are uppercase, the others are lowercase. Sentences are seprated with '.'.
CaseFirstWordLetterUp, // The first letter of each word is uppercase, the others are lowercase
CaseCount
};
// ***************************************************************************
// change the case mode of a string
void setCase (ucstring &str, TCaseMode mode);
// compare 2 ucstring s0 and s1, without regard to case. give start and size for sequence p0
sint ucstrnicmp(const ucstring &s0, uint p0, uint n0, const ucstring &s1);
/** Compute a non-continuous noise with uniform repartition in [0, 1], with the given noise object
* By default repartition is not uniform for noise
*/
float computeUniformNoise(const NLMISC::CNoiseValue &nv, const NLMISC::CVector &pos);
// ***************************************************************************
void computeCurrentFovAspectRatio(float &fov, float &ar);
/** draw a disc in a bitmap
* \TODO : find a place for this in NLMISC
*/
void drawDisc(NLMISC::CBitmap &dest, float x, float y, float radius, const NLMISC::CRGBA &color, bool additif = false, uint numSegs = 127);
// helper : get pointer to the current sky scene (new sky code, or fallback on old sky scene for continent that do not use the new system)
NL3D::UScene *getSkyScene();
// set emissive on all material of an instance (alpha is left unmodified)
void setEmissive(NL3D::UInstance instance, const NLMISC::CRGBA &color);
// set diffuse on all material of an instance (not including alpha)
void setDiffuse(NL3D::UInstance instance, bool onOff, const NLMISC::CRGBA &color);
// make an instance transparent (uses values from the shape material as a reference)
void makeInstanceTransparent(NL3D::UInstance &inst, uint8 opacity, bool disableZWrite);
// change the video mode, possibly centering the software mouse cursor if going to fullscreen
void setVideoMode(const NL3D::UDriver::CMode &mode);
// Get the current color depth (8, 16, or 32). In windowed mode, this will be the desktop color depth, in fullscreen mode, the color depth of the framebuffer.
uint getCurrentColorDepth();
#endif // CL_MISC_H
/* End of misc.h */