sciGraphics::Camera Class Reference

#include </home/scilab/compilation_chain/sci_checkOut/scilab/modules/renderer/src/cpp/subwinDrawing/Camera.h>

Inheritance diagram for sciGraphics::Camera:

[legend]

Collaboration diagram for sciGraphics::Camera:

[legend]

Public Member Functions
	Camera (sciPointObj *pObj)
virtual	~Camera (void)
void	replaceCamera (void)
void	getPixelCoordinates (const double userCoord[3], int pixCoord[2])
void	getPixelCoordinates (const double userCoords[3], double pixCoords[3])
void	getPixelCoordinatesRaw (const double userCoords[3], double pixCoords[3])
void	get2dViewPixelCoordinates (const double userCoord[3], int pixCoord[2])
void	get2dViewPixelCoordinates (const double userCoord[3], double pixCoord[3])
void	getSceneCoordinates (const double pixCoords[3], double userCoords[3])
void	getSceneCoordinatesRaw (const double pixCoords[3], double userCoords[3])
void	get2dViewCoordinates (const int pixCoords[2], double userCoord2D[2])
void	get2dViewCoordinates (const double userCoords[3], double coord2D[2])
virtual EDisplayStatus	draw (void)
virtual EDisplayStatus	show (void)
virtual EDisplayStatus	redraw (void)
bool	zoomRect (int posX, int posY, int width, int height)
void	getViewingArea (int *xPos, int *yPos, int *width, int *height)
void	getViewport (int viewport[4])
Protected Member Functions
void	setViewingArea (double axesBounds[4], double margins[4])
void	setRotationAngles (double alpha, double theta)
void	setAxesReverse (BOOL axesReverse[3])
void	setSubwinBox (double bounds[6])
void	setCameraParameters (void)
void	renderPosition (void)
bool	zoomRect (const double corners[4][2])
CameraBridge *	getCameraImp (void)
Private Member Functions
void	computeZoomAreaLines (const double areaPixCorners[4][2], double areaLines[4][2][3])
bool	getXaxisIntersections (const double areaLines[4][2][3], double planeXCoord, double intersections[4][3])
bool	getYaxisIntersections (const double areaLines[4][2][3], double planeYCoord, double intersections[4][3])
bool	getZaxisIntersections (const double areaLines[4][2][3], double planeZCoord, double intersections[4][3])
void	getIntersection (const double p1[3], const double p2[3], double alpha, double intersection[3])
void	updateXCoordinate (const double intersections[][3], int nbIntersections, double oldXmin, double oldXmax, double &newXmin, double &newXmax)
void	updateYCoordinate (const double intersections[][3], int nbIntersections, double oldYmin, double oldYmax, double &newYmin, double &newYmax)
void	updateZCoordinate (const double intersections[][3], int nbIntersections, double oldZmin, double oldZmax, double &newZmin, double &newZmax)
int	getProjectedXIntersections (const double intersections[4][3], double projectedIntersections[8][3], double planeXCoord, double yMin, double yMax, double zMin, double zMax)
int	getProjectedYIntersections (const double intersections[4][3], double projectedIntersections[8][3], double planeYCoord, double xMin, double xMax, double zMin, double zMax)
int	getProjectedZIntersections (const double intersections[4][3], double projectedIntersections[8][3], double planeZCoord, double xMin, double xMax, double yMin, double yMax)
void	projectOnXPlane (const double point[3], double proj[2])
void	unProjectOnXPlane (const double proj[2], double point[3], double planeXCoord)
void	projectOnYPlane (const double point[3], double proj[2])
void	unProjectOnYPlane (const double proj[2], double point[3], double planeYCoord)
void	projectOnZPlane (const double point[3], double proj[2])
void	unProjectOnZPlane (const double proj[2], double point[3], double planeZCoord)
int	getProjectedIntersections2D (const double intersections[4][2], double projectedIntersections[8][2], double xMin, double xMax, double yMin, double yMax)
bool	computeLineFillRectangleIntersections (const double p1[2], const double p2[2], double xMin, double xMax, double yMin, double yMax, double intersections[2][2])
bool	isInsideRectangle (const double p[2], double xMin, double xMax, double yMin, double yMax)
int	computeLineRectangleIntersections (const double p1[2], const double p2[2], double xMin, double xMax, double yMin, double yMax, double intersections[2][2])
bool	checkXIntersection (const double p1[2], const double p2[2], double res[2], double rectXCoord, double yMin, double yMax)
bool	checkYIntersection (const double p1[2], const double p2[2], double res[2], double rectYCoord, double xMin, double xMax)
void	p1PlusAP1P2 (const double p1[2], const double p2[2], double a, double res[2])
bool	isPointInQuadrangle (const double point[2], const double corners[4][2])
void	visualizeZoomingArea (const double intersections[4][2][3])
void	visualizeIntersection (const double intersections[4][3])

---

Detailed Description

Definition at line 27 of file Camera.h.

---

Constructor & Destructor Documentation

sciGraphics::Camera::Camera

(

sciPointObj *

pObj

)

Definition at line 30 of file Camera.cpp.

                                   : DrawableObject(pObj)
{
  
}

sciGraphics::Camera::~Camera

(

void

)

[virtual]

Definition at line 35 of file Camera.cpp.

{
  
}

---

Member Function Documentation

void sciGraphics::Camera::replaceCamera

(

void

)

Put back camera to default position.

Definition at line 130 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::replaceCamera().

Referenced by sciGraphics::DrawableSubwin::draw(), sciGraphics::DrawableSubwin::drawSingleObjs(), sciGraphics::DrawableSubwin::redraw(), sciGraphics::DrawableSubwin::show(), and sciGraphics::DrawableSubwin::showSingleObjs().

{
  getCameraImp()->replaceCamera();
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::getPixelCoordinates	(	const double	userCoord[3],
		int	pixCoord[2]
	)

Convert user coordinates to pixel coordinates.

Definition at line 135 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getPixelCoordinates().

Referenced by get2dViewCoordinates(), sciGraphics::ConcreteDrawableSubwin::getEyeDistance(), and sciGetJavaPixelCoordinates().

{
  getCameraImp()->getPixelCoordinates(userCoord, pixCoord);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::getPixelCoordinates	(	const double	userCoords[3],
		double	pixCoords[3]
	)

Convert user coordinates to pixel coordinates including depth value

Definition at line 140 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getPixelCoordinates().

{
  getCameraImp()->getPixelCoordinates(userCoords, pixCoords);
}

Here is the call graph for this function:

void sciGraphics::Camera::getPixelCoordinatesRaw	(	const double	userCoords[3],
		double	pixCoords[3]
	)

Convert user coordinates to pixel coordinates including depth value. Does not take logarithmic scale into account.

Definition at line 145 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getPixelCoordinatesRaw().

Referenced by sciGraphics::SubwinAxisPositioner::checkTicksDirection(), sciGraphics::ConcreteDrawableSubwin::computeConcealedCornerIndex(), sciGraphics::SubwinAxisPositioner::findFrontXCoordinate(), sciGraphics::SubwinAxisPositioner::findFrontYCoordinate(), sciGraphics::ZAxisPositioner::findLeftMostXCoordinate(), sciGraphics::ZAxisPositioner::findLeftMostYCoordinate(), sciGraphics::SubwinAxisPositioner::findLowerZCoordinate(), sciGraphics::LabelPositioner::getLabelDisplacement(), sciGraphics::TextContentDrawerJoGL::getPixelBoundingBox(), and sciGraphics::AxisPositioner::setTicksDirectionLength().

{
  getCameraImp()->getPixelCoordinatesRaw(userCoords, pixCoords);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::get2dViewPixelCoordinates	(	const double	userCoord[3],
		int	pixCoord[2]
	)

Convert user coordinates to pixel coordinated using the 2d view.

Definition at line 150 of file Camera.cpp.

References sciGraphics::CameraBridge::get2dViewPixelCoordinates(), and getCameraImp().

Referenced by sciGraphics::TextContentDrawerJoGL::getPixelLength(), and sciGetJava2dViewPixelCoordinates().

{
  getCameraImp()->get2dViewPixelCoordinates(userCoord, pixCoord);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::get2dViewPixelCoordinates	(	const double	userCoord[3],
		double	pixCoord[3]
	)

Convert user coordinates to pixel coordinated using the 2d view.

Definition at line 155 of file Camera.cpp.

References sciGraphics::CameraBridge::get2dViewPixelCoordinates(), and getCameraImp().

{
  getCameraImp()->get2dViewPixelCoordinates(userCoord, pixCoord);
}

Here is the call graph for this function:

void sciGraphics::Camera::getSceneCoordinates	(	const double	pixCoords[3],
		double	userCoords[3]
	)

Unproject a 3 position in pixels into the standard scene coordinates

Definition at line 160 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getSceneCoordinates().

Referenced by computeZoomAreaLines(), sciGraphics::TitlePositioner::getAutoPosition(), and sciGraphics::TextContentDrawerJoGL::getBoundingRectangle().

{
  getCameraImp()->getSceneCoordinates(pixCoords, userCoords);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::getSceneCoordinatesRaw	(	const double	pixCoords[3],
		double	userCoords[3]
	)

Unproject a 3 position in pixels into the standard scene coordinates. Does not take logarithmic coordinates into account

Definition at line 165 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getSceneCoordinatesRaw().

Referenced by sciGraphics::AxisPositioner::setTicksDirectionLength().

{
  getCameraImp()->getSceneCoordinatesRaw(pixCoords, userCoords);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::get2dViewCoordinates	(	const int	pixCoords[2],
		double	userCoord2D[2]
	)

Find coordinates in 2D view from pixel ones

Definition at line 170 of file Camera.cpp.

References sciGraphics::CameraBridge::get2dViewCoordinates(), and getCameraImp().

Referenced by get2dViewCoordinates(), sciGetJava2dViewCoordFromPixel(), and sciGetJava2dViewCoordinates().

{
  getCameraImp()->get2dViewCoordinates(pixCoords, userCoord2D);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::get2dViewCoordinates	(	const double	userCoords[3],
		double	coord2D[2]
	)

Find the projection of user coords on the 2D frame.

Definition at line 175 of file Camera.cpp.

References get2dViewCoordinates(), and getPixelCoordinates().

{
  int pixCoords[2];
  // convert usetr coords to pixel ones
  getPixelCoordinates(userCoords, pixCoords);

  // convert pixel ones to 2d frame ones
  get2dViewCoordinates(pixCoords, coord2D);
}

Here is the call graph for this function:

DrawableObject::EDisplayStatus sciGraphics::Camera::draw

(

void

)

[virtual]

Draw the graphic handle and store it representation in memory for later faster drawing.

Implements sciGraphics::DrawableObject.

Definition at line 185 of file Camera.cpp.

References sciGraphics::DrawableObject::endDrawing(), getCameraImp(), sciGraphics::DrawableObject::initializeDrawing(), sciGraphics::CameraBridge::renderPosition(), setCameraParameters(), and sciGraphics::DrawableObject::SUCCESS.

Referenced by sciGraphics::DrawableSubwin::placeCamera().

{
  initializeDrawing();
  setCameraParameters();
  getCameraImp()->renderPosition();
  endDrawing();
  return SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

DrawableObject::EDisplayStatus sciGraphics::Camera::show

(

void

)

[virtual]

Fast draw of the graphic handle on the screen using the data created by draw. Warning, be sure that draw is called before show each time the handle is modified.

Implements sciGraphics::DrawableObject.

Definition at line 194 of file Camera.cpp.

References getCameraImp(), sciGraphics::DrawableObjectBridge::show(), and sciGraphics::DrawableObject::SUCCESS.

Referenced by sciGraphics::DrawableSubwin::show(), and sciGraphics::DrawableSubwin::showSingleObjs().

{
  getCameraImp()->show();
  return SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

DrawableObject::EDisplayStatus sciGraphics::Camera::redraw

(

void

)

[virtual]

Display the camera using precomputed data

Reimplemented from sciGraphics::DrawableObject.

Definition at line 200 of file Camera.cpp.

References sciGraphics::DrawableObject::endDrawing(), getCameraImp(), sciGraphics::DrawableObject::initializeDrawing(), sciGraphics::CameraBridge::redraw(), and sciGraphics::DrawableObject::SUCCESS.

{
  initializeDrawing();
  getCameraImp()->redraw();
  endDrawing();
  return SUCCESS;
}

Here is the call graph for this function:

bool sciGraphics::Camera::zoomRect	(	int	posX,
		int	posY,
		int	width,
		int	height
	)

Apply a zoom square on the axes box

Parameters:

	posX	X coordinate of the lower left point of the zoom box in pixels.
	posY	Y coordinate of the lower left point of the zoom box in pixels.
	width	width of the zooming rectangle.
	height	height of the zooming rectangle.

Returns:

true if the axes box has been zoomed, false otherwise

Definition at line 208 of file Camera.cpp.

{
  double rectCorners[4][2] = {{posX        , posY + height},
                              {posX        , posY         },
                              {posX + width, posY         },
                              {posX + width, posY + height}};

  return zoomRect(rectCorners);

}

void sciGraphics::Camera::getViewingArea	(	int *	xPos,
		int *	yPos,
		int *	width,
		int *	height
	)

Get the position and size of the rectangle in which the axes box must fit

Definition at line 406 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getViewingArea().

Referenced by sciGraphics::TitlePositioner::getAutoPosition(), sciGetJavaViewingArea(), and sciGraphics::AxisPositioner::setTicksDirectionLength().

{
  getCameraImp()->getViewingArea(xPos, yPos, width, height);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::getViewport

(

int

viewport[4]

)

Get viewport of the canvas

Definition at line 411 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::getViewport().

Referenced by sciGraphics::TextContentDrawerJoGL::getPixelBoundingBox().

{
  getCameraImp()->getViewport(viewport);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::setViewingArea	(	double	axesBounds[4],
		double	margins[4]
	)			[protected]

Set the viewing zone for a subwin.

Parameters:

	axesBounds	axesBounds (WRECT) of the subwin. This a a vector [x_left,y_up,w,h].
	margins	inside the axes bounds, set a surface to use. This is a vector [margin_left, margin_right, margin_top, margin_bottom].

Definition at line 40 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::setViewingArea().

Referenced by setCameraParameters().

{
  double translation[2] ;
  // T = Taxes + SizeAxes * [marginLeft, marginTop].
  translation[0] = axesBounds[0] + axesBounds[2] * margins[0] ;
  translation[1] = 1.0 - axesBounds[1] - axesBounds[3] * (1.0 - margins[3]) ;

  // S = Saxes - margin.Saxes
  // where Saxes = [w,h] and margin = [margin_left+margin_right, margin_top+margin_bottom].
  double scale[2] ;
  scale[0] = (1.0 - margins[0] - margins[1]) * axesBounds[2] ;
  scale[1] = (1.0 - margins[2] - margins[3]) * axesBounds[3] ;
  getCameraImp()->setViewingArea(translation, scale);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::setRotationAngles	(	double	alpha,
		double	theta
	)			[protected]

Set the rotation angles of the camera.

Definition at line 55 of file Camera.cpp.

References getCameraImp(), and sciGraphics::CameraBridge::setAxesRotation().

Referenced by setCameraParameters().

{
  getCameraImp()->setAxesRotation(alpha, theta);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::setAxesReverse

(

BOOL

axesReverse[3]

)

[protected]

Specify which axes must be reversed.

Definition at line 60 of file Camera.cpp.

References getCameraImp(), sciGraphics::CameraBridge::setAxesReverse(), and TRUE.

Referenced by setCameraParameters().

{
  getCameraImp()->setAxesReverse(axesReverse[0] == TRUE,
                                 axesReverse[1] == TRUE,
                                 axesReverse[2] == TRUE);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void sciGraphics::Camera::setSubwinBox

(

double

bounds[6]

)

[protected]

Specify the axes box to render.

Parameters:

bounds

[Xmin,Xmax,Ymin,Ymax,Zmin,Zmax] vector.

Definition at line 67 of file Camera.cpp.

References getCameraImp(), sciGraphics::DrawableObject::m_pDrawed, Min, sciGetIsCubeScaled(), sciGraphics::CameraBridge::setAxesCenter(), sciGraphics::CameraBridge::setAxesFittingScale(), sciGraphics::CameraBridge::setAxesNormalizationScale(), and sciGraphics::CameraBridge::setAxesTranslation().

Referenced by setCameraParameters().

{

  double boxCenter[3];
  boxCenter[0] = (bounds[0] + bounds[1]) / 2.0 ;
  boxCenter[1] = (bounds[2] + bounds[3]) / 2.0 ;
  boxCenter[2] = (bounds[4] + bounds[5]) / 2.0 ;
  getCameraImp()->setAxesCenter(boxCenter) ;
  
  double scale[3] ;
  // 1.0 / ( Xmax - Xmin )
  scale[0] = 1.0 / (bounds[1] - bounds[0]) ;
  scale[1] = 1.0 / (bounds[3] - bounds[2]) ;
  scale[2] = 1.0 / (bounds[5] - bounds[4]) ;
  
  getCameraImp()->setAxesNormalizationScale(scale) ;

  if (sciGetIsCubeScaled(m_pDrawed))
  {
    getCameraImp()->setAxesFittingScale(scale);
  }
  else
  {
    // preserve isometry by applying same scale
    double minScale = Min(scale[0], Min(scale[1], scale[2]));
    double fittingScale[3] = {minScale, minScale, minScale};
    getCameraImp()->setAxesFittingScale(fittingScale);
  }
  

  double trans[3];
  // put the min bounds to our origin
  trans[0] = -bounds[0] ;
  trans[1] = -bounds[2] ;
  trans[2] = bounds[4] ;
  getCameraImp()->setAxesTranslation(trans) ;

}

Here is the call graph for this function:

Here is the caller graph for this function: