NL3D::CComputedString Struct Reference

#include <computed_string.h>

---

Detailed Description

CComputedString A CComputedString is a structure which permits to render a string in a driver. It computes 4 vertices per char the renderer draw quads from them.

Author:

Stephane Coutelas

Nevrax France

Date:

2000

Definition at line 82 of file computed_string.h.

Public Types
enum	THotSpot {   BottomLeft = 0, MiddleLeft, TopLeft, MiddleBottom,   MiddleMiddle, MiddleTop, BottomRight, MiddleRight,   TopRight, HotSpotCount }
Public Member Functions
	CComputedString (bool bSetupVB=true)
CVector	getHotSpotVector (THotSpot hotspot)
void	render2D (IDriver &driver, float x, float z, THotSpot hotspot=BottomLeft, float scaleX=1, float scaleZ=1, float rotateY=0, bool useScreenAR43=false, bool roundToNearestPixel=true)
void	render2DClip (IDriver &driver, CRenderStringBuffer &rdrBuffer, float x, float z, float xmin=0, float ymin=0, float xmax=1, float ymax=1)
void	render2DUnProjected (IDriver &driver, CRenderStringBuffer &rdrBuffer, class NL3D::CFrustum &frustum, const NLMISC::CMatrix &scaleMatrix, float x, float z, float depth, float xmin=0, float ymin=0, float xmax=1, float ymax=1)
void	render3D (IDriver &driver, CMatrix matrix, THotSpot hotspot=MiddleMiddle)
Data Fields
CRGBA	Color
CMaterial *	Material
uint32	SelectSize
uint32	SelectStart
	Optionnal: each render*() method can draw a subset of letters. Default is 0/FFFFFFFF.
float	StringHeight
	The height of the string, in pixels (eg: 10).
float	StringLine
float	StringWidth
	The width of the string, in pixels (eg: 30).
CVertexBuffer	Vertices
float	XMax
	The BBox of all vertices. used for render2DClip().
float	XMin
	The BBox of all vertices. used for render2DClip().
float	ZMax
	The BBox of all vertices. used for render2DClip().
float	ZMin
	The BBox of all vertices. used for render2DClip().

---

Member Enumeration Documentation

enum NL3D::CComputedString::THotSpot

Hotspot positions (origine for the string placement) You should take care that for vertical hotspot, an imaginary line is defined under letters with no leg (like m,b,c etc..) between the leg of p and the loop of the p. Enumeration values: BottomLeft  MiddleLeft  TopLeft  MiddleBottom  MiddleMiddle  MiddleTop  BottomRight  MiddleRight  TopRight  HotSpotCount  Definition at line 112 of file computed_string.h. { BottomLeft=0, MiddleLeft, TopLeft, MiddleBottom, MiddleMiddle, MiddleTop, BottomRight, MiddleRight, TopRight, HotSpotCount };

---

Constructor & Destructor Documentation

NL3D::CComputedString::CComputedString (  bool  bSetupVB = true  )  [inline]

Default constructor Definition at line 130 of file computed_string.h. References SelectSize, SelectStart, NL3D::CVertexBuffer::setVertexFormat(), StringHeight, and StringWidth. { StringWidth = 0; StringHeight = 0; if (bSetupVB) { Vertices.setVertexFormat (CVertexBuffer::PositionFlag | CVertexBuffer::TexCoord0Flag); } SelectStart= 0; SelectSize= ~0; }

---

Member Function Documentation

CVector NL3D::CComputedString::getHotSpotVector (  THotSpot  hotspot  )

Get the string's origin Parameters: hotspot  the origin of the string Definition at line 49 of file computed_string.cpp. References BottomRight, MiddleBottom, MiddleLeft, MiddleMiddle, MiddleRight, MiddleTop, StringHeight, StringWidth, TopLeft, and TopRight. Referenced by render2D(), and render3D(). { CVector hotspotVector(0,0,0); if (hotspot==MiddleLeft) hotspotVector = CVector(0,0,-StringHeight/2); if (hotspot==TopLeft) hotspotVector = CVector(0,0,-StringHeight); if (hotspot==MiddleBottom) hotspotVector = CVector(-StringWidth/2,0,0); if (hotspot==MiddleMiddle) hotspotVector = CVector(-StringWidth/2,0,-StringHeight/2); if (hotspot==MiddleTop) hotspotVector = CVector(-StringWidth/2,0,-StringHeight); if (hotspot==BottomRight) hotspotVector = CVector(-StringWidth,0,0); if (hotspot==MiddleRight) hotspotVector = CVector(-StringWidth,0,-StringHeight/2); if (hotspot==TopRight) hotspotVector = CVector(-StringWidth,0,-StringHeight); return hotspotVector; }

void NL3D::CComputedString::render2D (  IDriver &  driver, float  x, float  z, THotSpot  hotspot = BottomLeft, float  scaleX = 1, float  scaleZ = 1, float  rotateY = 0, bool  useScreenAR43 = false, bool  roundToNearestPixel = true )

Render the unicode string in a driver. Parameters: driver  the driver where to render the primitives x  abscissa y  ordinate hotspot  position of string origine scaleX  abscissa scale scaleY  ordinate scale rotateY  rotation angle (axe perpendicular to screen) useScreenAR43  if false then string is displayed with a pixel Ratio 1:1 (independent of window resolution). if true, the string is scaled according to window width and height, to support 4:3 aspect ratio even on weird screen resolution such as 640*240 (ie the char still look square, but the pixel ratio is 2:1) roundToNearestPixel  if true, snap the final string position to the nearest pixel. if set to true, and if useScreenAR43= false, you are sure that texels of the fonts fit exactly on centers of pixels (no apparent bi-linear). Definition at line 84 of file computed_string.cpp. References NL3D::IDriver::activeVertexBuffer(), Color, getHotSpotVector(), NL3D::CVertexBuffer::getNumVertices(), NL3D::IDriver::getWindowSize(), Material, matrix, min, NL3D::IDriver::renderQuads(), SelectSize, SelectStart, NL3D::CMaterial::setColor(), NL3D::IDriver::setFrustum(), NL3D::IDriver::setupModelMatrix(), NL3D::IDriver::setupViewMatrix(), NL3D::CMaterial::setZFunc(), NL3D::CMaterial::setZWrite(), uint32, NLMISC::CVector::x, x, NLMISC::CVector::z, and z. Referenced by NL3D::CTextContext::printAt(), and NL3D::CTextContext::printfAt(). { if (Vertices.getNumVertices() == 0) return; // get window size uint32 wndWidth, wndHeight; driver.getWindowSize(wndWidth, wndHeight); // scale to window size. x*= wndWidth; z*= wndHeight; driver.setFrustum(0, (float)wndWidth, 0, (float)wndHeight, -1, 1, false); // resX/resY // Computing hotspot translation vector CVector hotspotVector = getHotSpotVector(hotspot); // tansformation matrix initialized to identity CMatrix matrix; matrix.identity(); // view matrix <-> identity driver.setupViewMatrix(matrix); // model matrix : // centering to hotspot, then scaling, rotating, and translating. matrix.translate(CVector(x,0,z)); matrix.rotateY(rotateY); matrix.scale(CVector(scaleX,1,scaleZ)); // scale the string to follow window aspect Ratio if(useScreenAR43) { matrix.scale(CVector((3.0f*wndWidth)/(4.0f*wndHeight),1,1)); } matrix.translate(hotspotVector); // if roundToNearestPixel, then snap the position to the nearest pixel if( roundToNearestPixel) { CVector pos= matrix.getPos(); pos.x= (float)floor(pos.x+0.5f); pos.z= (float)floor(pos.z+0.5f); matrix.setPos(pos); } // setup the matrix driver.setupModelMatrix(matrix); driver.activeVertexBuffer(Vertices); // rendering each primitives Material->setZFunc (CMaterial::always); Material->setZWrite (false); Material->setColor (Color); // Clamp for selection uint32 nNumQuad= Vertices.getNumVertices()/4; driver.renderQuads (*Material, SelectStart, min(nNumQuad, SelectSize) ); }

void NL3D::CComputedString::render2DClip (  IDriver &  driver, CRenderStringBuffer &  rdrBuffer, float  x, float  z, float  xmin = 0, float  ymin = 0, float  xmax = 1, float  ymax = 1 )

Special for interface. same as render2D but clip the quads to xmin,ymin/xmax,ymax. NB: behavior is same as render2D with: Hotspot = bottomLeft, scaleX=1, scaleZ=1, rotateY=0, useScreenAR43= false, roundToNearestPixel= false Additionnaly, this method don't render directly to the driver but add primitives to a CRenderStringBuffer Use the method CRenderStringBuffer::flush() to flush it all. Definition at line 183 of file computed_string.cpp. References Color, NL3D::CVertexBuffer::getColorOff(), NL3D::CVertexBuffer::getNumVertices(), NL3D::CVertexBuffer::getTexCoordOff(), NL3D::CVertexBuffer::getVertexCoordPointer(), NL3D::CVertexBuffer::getVertexSize(), NL3D::IDriver::getWindowSize(), min, NL3D::CRenderStringBuffer::NumQuads, SelectSize, SelectStart, NL3D::CVertexBuffer::setNumVertices(), sint, NLMISC::CUV::U, uint, uint32, uint8, NLMISC::CUV::V, NL3D::CRenderStringBuffer::Vertices, NLMISC::CVector::x, x, XMax, XMin, NLMISC::CVector::z, z, ZMax, and ZMin. Referenced by NL3D::CTextContext::printClipAt(). { if (Vertices.getNumVertices() == 0) return; if(SelectSize==0) return; // get window size uint32 wndWidth, wndHeight; driver.getWindowSize(wndWidth, wndHeight); // scale to window size. x*= wndWidth; z*= wndHeight; xmin*= wndWidth; xmax*= wndWidth; zmin*= wndHeight; zmax*= wndHeight; // Test String Bound against clip window // If entirely out skip if (((x+XMin) > xmax) || ((x+XMax) < xmin) || ((z+ZMin) > zmax) || ((z+ZMax) < zmin)) return; // test if entirely in. bool allIn; allIn= ((x+XMin) >= xmin) && ((x+XMax) <= xmax) && ((z+ZMin) >= zmin) && ((z+ZMax) <= zmax); // How many quad to render? uint nNumQuadSrc= Vertices.getNumVertices()/4; nNumQuadSrc= min(nNumQuadSrc, (uint)SelectSize); // Enlarge dest Buffer if needed if( (rdrBuffer.NumQuads+nNumQuadSrc)*4 > rdrBuffer.Vertices.getNumVertices() ) { rdrBuffer.Vertices.setNumVertices( (rdrBuffer.NumQuads+nNumQuadSrc)*4 ); } // prepare copy. sint ofsSrcUV= Vertices.getTexCoordOff(); sint ofsDstUV= rdrBuffer.Vertices.getTexCoordOff(); sint ofsDstColor= rdrBuffer.Vertices.getColorOff(); uint8 *srcPtr= (uint8*)Vertices.getVertexCoordPointer(); uint8 *dstPtr= (uint8*)rdrBuffer.Vertices.getVertexCoordPointer(rdrBuffer.NumQuads*4); sint srcSize= Vertices.getVertexSize(); sint dstSize= rdrBuffer.Vertices.getVertexSize(); // decal src for selection srcPtr+= SelectStart*4 * srcSize; // **** clipping? if(allIn) { // copy All vertices uint numVerts= nNumQuadSrc*4; for(uint i=0;i<numVerts;i++) { // copy and translate pos ((CVector*)dstPtr)->x= x + ((CVector*)srcPtr)->x; ((CVector*)dstPtr)->y= ((CVector*)srcPtr)->y; ((CVector*)dstPtr)->z= z + ((CVector*)srcPtr)->z; // uv *((CUV*)(dstPtr+ofsDstUV))= *((CUV*)(srcPtr+ofsSrcUV)); // color *((CRGBA*)(dstPtr+ofsDstColor))= Color; // next srcPtr+= srcSize; dstPtr+= dstSize; } // update the rdrBuffer rdrBuffer.NumQuads+= nNumQuadSrc; } else { uint nNumQuadClipped= 0; // the real number of vertices to comute (with selection) uint numVerts= nNumQuadSrc*4; // clip into VerticesClipped CVector *pIniPos0 = (CVector*)srcPtr; CVector *pIniPos2 = (CVector*)(((uint8*)pIniPos0) + srcSize*2); CVector *pClipPos0 = (CVector*)dstPtr; CVector *pClipPos1 = (CVector*)(((uint8*)pClipPos0) + dstSize); CVector *pClipPos2 = (CVector*)(((uint8*)pClipPos1) + dstSize); CVector *pClipPos3 = (CVector*)(((uint8*)pClipPos2) + dstSize); CUV *pClipUV0 = (CUV*)(dstPtr + ofsDstUV ); CUV *pClipUV1 = (CUV*)(((uint8*)pClipUV0) + dstSize); CUV *pClipUV2 = (CUV*)(((uint8*)pClipUV1) + dstSize); CUV *pClipUV3 = (CUV*)(((uint8*)pClipUV2) + dstSize); float ratio; for (uint32 i = 0; i < numVerts; i+=4) { if (((x+pIniPos0->x) > xmax) || ((x+pIniPos2->x) < xmin) || ((z+pIniPos0->z) > zmax) || ((z+pIniPos2->z) < zmin)) { // Totally clipped do nothing } else { // copy with no clip // v0 *((CVector*) (dstPtr + dstSize*0))= *((CVector*) (srcPtr + srcSize*0)); *((CUV*) (dstPtr + dstSize*0 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*0 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*0 + ofsDstColor))= Color; // v1 *((CVector*) (dstPtr + dstSize*1))= *((CVector*) (srcPtr + srcSize*1)); *((CUV*) (dstPtr + dstSize*1 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*1 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*1 + ofsDstColor))= Color; // v2 *((CVector*) (dstPtr + dstSize*2))= *((CVector*) (srcPtr + srcSize*2)); *((CUV*) (dstPtr + dstSize*2 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*2 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*2 + ofsDstColor))= Color; // v3 *((CVector*) (dstPtr + dstSize*3))= *((CVector*) (srcPtr + srcSize*3)); *((CUV*) (dstPtr + dstSize*3 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*3 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*3 + ofsDstColor))= Color; // translate dest pClipPos0->x += x; pClipPos1->x += x; pClipPos2->x += x; pClipPos3->x += x; pClipPos0->z += z; pClipPos1->z += z; pClipPos2->z += z; pClipPos3->z += z; if ((pClipPos0->x >= xmin) && (pClipPos0->z >= zmin) && (pClipPos2->x <= xmax) && (pClipPos2->z <= zmax)) { // Not clipped } else { // Partially clipped if (pClipPos0->x < xmin) { ratio = ((float)(xmin - pClipPos0->x))/((float)(pClipPos1->x - pClipPos0->x)); pClipPos3->x = pClipPos0->x = xmin; pClipUV0->U += ratio*(pClipUV1->U - pClipUV0->U); pClipUV3->U += ratio*(pClipUV2->U - pClipUV3->U); } if (pClipPos0->z < zmin) { ratio = ((float)(zmin - pClipPos0->z))/((float)(pClipPos3->z - pClipPos0->z)); pClipPos1->z = pClipPos0->z = zmin; pClipUV0->V += ratio*(pClipUV3->V - pClipUV0->V); pClipUV1->V += ratio*(pClipUV2->V - pClipUV1->V); } if (pClipPos2->x > xmax) { ratio = ((float)(xmax - pClipPos2->x))/((float)(pClipPos3->x - pClipPos2->x)); pClipPos2->x = pClipPos1->x = xmax; pClipUV2->U += ratio*(pClipUV3->U - pClipUV2->U); pClipUV1->U += ratio*(pClipUV0->U - pClipUV1->U); } if (pClipPos2->z > zmax) { ratio = ((float)(zmax - pClipPos2->z))/((float)(pClipPos1->z - pClipPos2->z)); pClipPos2->z = pClipPos3->z = zmax; pClipUV2->V += ratio*(pClipUV1->V - pClipUV2->V); pClipUV3->V += ratio*(pClipUV0->V - pClipUV3->V); } } // next quad out ++nNumQuadClipped; pClipPos0 = (CVector*)(((uint8*)pClipPos0) + dstSize*4); pClipPos1 = (CVector*)(((uint8*)pClipPos0) + dstSize); pClipPos2 = (CVector*)(((uint8*)pClipPos1) + dstSize); pClipPos3 = (CVector*)(((uint8*)pClipPos2) + dstSize); pClipUV0 = (CUV*)( ((uint8*)pClipUV0) + dstSize*4 ); pClipUV1 = (CUV*)(((uint8*)pClipUV0) + dstSize); pClipUV2 = (CUV*)(((uint8*)pClipUV1) + dstSize); pClipUV3 = (CUV*)(((uint8*)pClipUV2) + dstSize); dstPtr+= 4*dstSize; } // next quad in pIniPos0 = (CVector*)(((uint8*)pIniPos0) + srcSize*4); pIniPos2 = (CVector*)(((uint8*)pIniPos0) + srcSize*2); srcPtr+= 4*srcSize; } // update the rdrBuffer rdrBuffer.NumQuads+= nNumQuadClipped; } }

void NL3D::CComputedString::render2DUnProjected (  IDriver &  driver, CRenderStringBuffer &  rdrBuffer, class NL3D::CFrustum &  frustum, const NLMISC::CMatrix &  scaleMatrix, float  x, float  z, float  depth, float  xmin = 0, float  ymin = 0, float  xmax = 1, float  ymax = 1 )

Special for interface. same as render2DClip but unproject the vertices using a frustum and a scale matrix Use the method CRenderStringBuffer::flush() to flush it all. Definition at line 378 of file computed_string.cpp. References Color, depth, NL3D::CVertexBuffer::getColorOff(), NL3D::CVertexBuffer::getNumVertices(), NL3D::CVertexBuffer::getTexCoordOff(), NL3D::CVertexBuffer::getVertexCoordPointer(), NL3D::CVertexBuffer::getVertexSize(), NL3D::IDriver::getWindowSize(), min, NL3D::CRenderStringBuffer::NumQuads, SelectSize, SelectStart, NL3D::CVertexBuffer::setNumVertices(), sint, NLMISC::CUV::U, uint, uint32, uint8, NLMISC::CUV::V, NL3D::CRenderStringBuffer::Vertices, NLMISC::CVector::x, x, XMax, XMin, NLMISC::CVector::y, NLMISC::CVector::z, z, ZMax, and ZMin. Referenced by NL3D::CTextContext::printClipAtUnProjected(). { if (Vertices.getNumVertices() == 0) return; if(SelectSize==0) return; // get window size uint32 wndWidth, wndHeight; driver.getWindowSize(wndWidth, wndHeight); // scale to window size. x*= wndWidth; z*= wndHeight; xmin*= wndWidth; xmax*= wndWidth; zmin*= wndHeight; zmax*= wndHeight; // Test String Bound against clip window // If entirely out skip if (((x+XMin) > xmax) || ((x+XMax) < xmin) || ((z+ZMin) > zmax) || ((z+ZMax) < zmin)) return; // test if entirely in. bool allIn; allIn= ((x+XMin) >= (xmin-0.001f)) && ((x+XMax) <= (xmax+0.001f)) && ((z+ZMin) >= (zmin-0.001f)) && ((z+ZMax) <= (zmax+0.001f)); // How many quad to render? uint nNumQuadSrc= Vertices.getNumVertices()/4; nNumQuadSrc= min(nNumQuadSrc, (uint)SelectSize); // Enlarge dest Buffer if needed if( (rdrBuffer.NumQuads+nNumQuadSrc)*4 > rdrBuffer.Vertices.getNumVertices() ) { rdrBuffer.Vertices.setNumVertices( (rdrBuffer.NumQuads+nNumQuadSrc)*4 ); } // prepare copy. sint ofsSrcUV= Vertices.getTexCoordOff(); sint ofsDstUV= rdrBuffer.Vertices.getTexCoordOff(); sint ofsDstColor= rdrBuffer.Vertices.getColorOff(); uint8 *srcPtr= (uint8*)Vertices.getVertexCoordPointer(); uint8 *dstPtr= (uint8*)rdrBuffer.Vertices.getVertexCoordPointer(rdrBuffer.NumQuads*4); sint srcSize= Vertices.getVertexSize(); sint dstSize= rdrBuffer.Vertices.getVertexSize(); // decal src for selection srcPtr+= SelectStart*4 * srcSize; uint8 *dstPtrBackup = dstPtr; // **** clipping? if(allIn) { // copy All vertices uint numVerts= nNumQuadSrc*4; for(uint i=0;i<numVerts;i++) { // copy and translate pos ((CVector*)dstPtr)->x= x + ((CVector*)srcPtr)->x; ((CVector*)dstPtr)->z= z + ((CVector*)srcPtr)->z; // uv *((CUV*)(dstPtr+ofsDstUV))= *((CUV*)(srcPtr+ofsSrcUV)); // color *((CRGBA*)(dstPtr+ofsDstColor))= Color; // next srcPtr+= srcSize; dstPtr+= dstSize; } // update the rdrBuffer rdrBuffer.NumQuads+= nNumQuadSrc; } else { uint nNumQuadClipped= 0; // the real number of vertices to comute (with selection) uint numVerts= nNumQuadSrc*4; // clip into VerticesClipped CVector *pIniPos0 = (CVector*)srcPtr; CVector *pIniPos2 = (CVector*)(((uint8*)pIniPos0) + srcSize*2); CVector *pClipPos0 = (CVector*)dstPtr; CVector *pClipPos1 = (CVector*)(((uint8*)pClipPos0) + dstSize); CVector *pClipPos2 = (CVector*)(((uint8*)pClipPos1) + dstSize); CVector *pClipPos3 = (CVector*)(((uint8*)pClipPos2) + dstSize); CUV *pClipUV0 = (CUV*)(dstPtr + ofsDstUV ); CUV *pClipUV1 = (CUV*)(((uint8*)pClipUV0) + dstSize); CUV *pClipUV2 = (CUV*)(((uint8*)pClipUV1) + dstSize); CUV *pClipUV3 = (CUV*)(((uint8*)pClipUV2) + dstSize); float ratio; for (uint32 i = 0; i < numVerts; i+=4) { if (((x+pIniPos0->x) > xmax) || ((x+pIniPos2->x) < xmin) || ((z+pIniPos0->z) > zmax) || ((z+pIniPos2->z) < zmin)) { // Totally clipped do nothing } else { // copy with no clip // v0 *((CVector*) (dstPtr + dstSize*0))= *((CVector*) (srcPtr + srcSize*0)); *((CUV*) (dstPtr + dstSize*0 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*0 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*0 + ofsDstColor))= Color; // v1 *((CVector*) (dstPtr + dstSize*1))= *((CVector*) (srcPtr + srcSize*1)); *((CUV*) (dstPtr + dstSize*1 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*1 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*1 + ofsDstColor))= Color; // v2 *((CVector*) (dstPtr + dstSize*2))= *((CVector*) (srcPtr + srcSize*2)); *((CUV*) (dstPtr + dstSize*2 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*2 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*2 + ofsDstColor))= Color; // v3 *((CVector*) (dstPtr + dstSize*3))= *((CVector*) (srcPtr + srcSize*3)); *((CUV*) (dstPtr + dstSize*3 + ofsDstUV))= *((CUV*)(srcPtr + srcSize*3 + ofsSrcUV)); *((CRGBA*) (dstPtr + dstSize*3 + ofsDstColor))= Color; // translate dest pClipPos0->x += x; pClipPos1->x += x; pClipPos2->x += x; pClipPos3->x += x; pClipPos0->z += z; pClipPos1->z += z; pClipPos2->z += z; pClipPos3->z += z; if ((pClipPos0->x >= xmin) && (pClipPos0->z >= zmin) && (pClipPos2->x <= xmax) && (pClipPos2->z <= zmax)) { // Not clipped } else { // Partially clipped if (pClipPos0->x < xmin) { ratio = ((float)(xmin - pClipPos0->x))/((float)(pClipPos1->x - pClipPos0->x)); pClipPos3->x = pClipPos0->x = xmin; pClipUV0->U += ratio*(pClipUV1->U - pClipUV0->U); pClipUV3->U += ratio*(pClipUV2->U - pClipUV3->U); } if (pClipPos0->z < zmin) { ratio = ((float)(zmin - pClipPos0->z))/((float)(pClipPos3->z - pClipPos0->z)); pClipPos1->z = pClipPos0->z = zmin; pClipUV0->V += ratio*(pClipUV3->V - pClipUV0->V); pClipUV1->V += ratio*(pClipUV2->V - pClipUV1->V); } if (pClipPos2->x > xmax) { ratio = ((float)(xmax - pClipPos2->x))/((float)(pClipPos3->x - pClipPos2->x)); pClipPos2->x = pClipPos1->x = xmax; pClipUV2->U += ratio*(pClipUV3->U - pClipUV2->U); pClipUV1->U += ratio*(pClipUV0->U - pClipUV1->U); } if (pClipPos2->z > zmax) { ratio = ((float)(zmax - pClipPos2->z))/((float)(pClipPos1->z - pClipPos2->z)); pClipPos2->z = pClipPos3->z = zmax; pClipUV2->V += ratio*(pClipUV1->V - pClipUV2->V); pClipUV3->V += ratio*(pClipUV0->V - pClipUV3->V); } } // next quad out ++nNumQuadClipped; pClipPos0 = (CVector*)(((uint8*)pClipPos0) + dstSize*4); pClipPos1 = (CVector*)(((uint8*)pClipPos0) + dstSize); pClipPos2 = (CVector*)(((uint8*)pClipPos1) + dstSize); pClipPos3 = (CVector*)(((uint8*)pClipPos2) + dstSize); pClipUV0 = (CUV*)( ((uint8*)pClipUV0) + dstSize*4 ); pClipUV1 = (CUV*)(((uint8*)pClipUV0) + dstSize); pClipUV2 = (CUV*)(((uint8*)pClipUV1) + dstSize); pClipUV3 = (CUV*)(((uint8*)pClipUV2) + dstSize); dstPtr+= 4*dstSize; } // next quad in pIniPos0 = (CVector*)(((uint8*)pIniPos0) + srcSize*4); pIniPos2 = (CVector*)(((uint8*)pIniPos0) + srcSize*2); srcPtr+= 4*srcSize; } // update the rdrBuffer rdrBuffer.NumQuads+= nNumQuadClipped; } const float OOW = 1.f / (float)wndWidth; const float OOH = 1.f / (float)wndHeight; while (dstPtrBackup != dstPtr) { // preset unprojection CVector tmp; tmp.x = ((CVector*)dstPtrBackup)->x * OOW; tmp.y = ((CVector*)dstPtrBackup)->z * OOH; tmp.z = depth; // mul by user scale matrix tmp= scaleMatrix * tmp; // Unproject it *((CVector*)dstPtrBackup) = frustum.unProjectZ(tmp); dstPtrBackup += dstSize; } }

void NL3D::CComputedString::render3D (  IDriver &  driver, CMatrix  matrix, THotSpot  hotspot = MiddleMiddle )

Render the unicode string in a driver, in 3D with a user matrix. NB: size of the string is first scaled by 1/windowHeight. Parameters: driver  the driver where to render the primitives matrix  transformation matrix hotspot  position of string origine Definition at line 151 of file computed_string.cpp. References NL3D::IDriver::activeVertexBuffer(), Color, getHotSpotVector(), NL3D::CVertexBuffer::getNumVertices(), NL3D::IDriver::getWindowSize(), Material, matrix, min, NL3D::IDriver::renderQuads(), SelectSize, SelectStart, NL3D::CMaterial::setColor(), NL3D::IDriver::setupModelMatrix(), NL3D::CMaterial::setZFunc(), NL3D::CMaterial::setZWrite(), and uint32. Referenced by NL3D::CInstanceGroup::displayDebugClusters(), NL3D::CPSUtil::print(), and NL3D::CTextContextUser::render3D(). { if (Vertices.getNumVertices() == 0) return; // get window size uint32 wndWidth, wndHeight; driver.getWindowSize(wndWidth, wndHeight); // scale according to window height (backward compatibility) matrix.scale(1.0f/wndHeight); // Computing hotspot translation vector CVector hotspotVector = getHotSpotVector(hotspot); matrix.translate(hotspotVector); // render driver.setupModelMatrix(matrix); driver.activeVertexBuffer(Vertices); // Rendering each primitive blocks Material->setZFunc (CMaterial::lessequal); Material->setZWrite (true); Material->setColor (Color); // Clamp for selection uint32 nNumQuad= Vertices.getNumVertices()/4; driver.renderQuads (*Material, SelectStart, min(nNumQuad, SelectSize) ); }

---

Field Documentation

CRGBA NL3D::CComputedString::Color

Definition at line 88 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), NL3D::CFontManager::computeStringInfo(), NL3D::CTextContext::printAt(), NL3D::CTextContext::printClipAt(), NL3D::CTextContext::printClipAtUnProjected(), NL3D::CTextContext::printfAt(), render2D(), render2DClip(), render2DUnProjected(), render3D(), and NL3D::CTextContextUser::setStringColor().

CMaterial* NL3D::CComputedString::Material

Definition at line 87 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), render2D(), and render3D().

uint32 NL3D::CComputedString::SelectSize

Definition at line 105 of file computed_string.h. Referenced by CComputedString(), render2D(), render2DClip(), render2DUnProjected(), and render3D().

uint32 NL3D::CComputedString::SelectStart

Optionnal: each render*() method can draw a subset of letters. Default is 0/FFFFFFFF. Definition at line 104 of file computed_string.h. Referenced by CComputedString(), render2D(), render2DClip(), render2DUnProjected(), and render3D().

float NL3D::CComputedString::StringHeight

The height of the string, in pixels (eg: 10). Definition at line 92 of file computed_string.h. Referenced by CComputedString(), NL3D::CFontManager::computeString(), NL3D::CFontManager::computeStringInfo(), getHotSpotVector(), and NL3D::CTextContextUser::getStringInfo().

float NL3D::CComputedString::StringLine

StringLine is the size from bottom of the whole string image to the hotspot in pixels. for instance if the hotspot is bottomLeft the imaginary line of the string "bpc" is under the b, under the loop of the p but over the leg of the p. So StringLine is a positive value in this case. It may be a negative value for the string "^" for example. Definition at line 101 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), NL3D::CFontManager::computeStringInfo(), and NL3D::CTextContextUser::getStringInfo().

float NL3D::CComputedString::StringWidth

The width of the string, in pixels (eg: 30). Definition at line 90 of file computed_string.h. Referenced by CComputedString(), NL3D::CFontManager::computeString(), NL3D::CFontManager::computeStringInfo(), getHotSpotVector(), and NL3D::CTextContextUser::getStringInfo().

CVertexBuffer NL3D::CComputedString::Vertices

Definition at line 86 of file computed_string.h. Referenced by NL3D::CFontManager::computeString().

float NL3D::CComputedString::XMax

The BBox of all vertices. used for render2DClip(). Definition at line 94 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), render2DClip(), and render2DUnProjected().

float NL3D::CComputedString::XMin

The BBox of all vertices. used for render2DClip(). Definition at line 94 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), render2DClip(), and render2DUnProjected().

float NL3D::CComputedString::ZMax

The BBox of all vertices. used for render2DClip(). Definition at line 94 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), render2DClip(), and render2DUnProjected().

float NL3D::CComputedString::ZMin

The BBox of all vertices. used for render2DClip(). Definition at line 94 of file computed_string.h. Referenced by NL3D::CFontManager::computeString(), render2DClip(), and render2DUnProjected().

---

The documentation for this struct was generated from the following files:

• computed_string.h
• computed_string.cpp

---