Function renderFrame

Engine/source/T3D/gameFunctions.cpp:440–624

================================================================================================ Render a full frame from a given transform and frustum, and render out to a target ================================================================================================

//Render a full frame from a given transform and frustum, and render out to a target
//================================================================================================
void renderFrame(GFXTextureTargetRef* target, MatrixF transform, Frustum frustum, U32 typeMask, ColorI canvasClearColor)
{
   if (!GFX->allowRender() || GFX->canCurrentlyRender())
      return;

   PROFILE_START(GameFunctions_RenderFrame);

   GFX->setActiveRenderTarget(*target);
   if (!GFX->getActiveRenderTarget())
      return;

   GFXTarget* renderTarget = GFX->getActiveRenderTarget();
   if (renderTarget == NULL)
      return;

   // Make sure the root control is the size of the canvas.
   Point2I size = renderTarget->getSize();
   if (size.x == 0 || size.y == 0)
      return;

   //Now, getting to the meat of it!
#ifdef TORQUE_GFX_STATE_DEBUG
   GFX->getDebugStateManager()->startFrame();
#endif
   RectI targetRect(0, 0, size.x, size.y);

   // Signal the interested parties.
   GuiCanvas::getGuiCanvasFrameSignal().trigger(true);

   GFXTransformSaver saver;

   // Gross hack to make sure we don't end up with advanced lighting and msaa 
   // at the same time, which causes artifacts. At the same time we don't 
   // want to just throw the settings the user has chosen if the light manager 
   // changes at a later time.
   /*GFXVideoMode mode = mPlatformWindow->getVideoMode();
   if (dStricmp(LIGHTMGR->getId(), "ADVLM") == 0 && mode.antialiasLevel > 0)
   {
      const char *pref = Con::getVariable("$pref::Video::mode");
      mode.parseFromString(pref);
      mode.antialiasLevel = 0;
      mPlatformWindow->setVideoMode(mode);

      Con::printf("AntiAliasing has been disabled; it is not compatible with AdvancedLighting.");
   }
   else if (dStricmp(LIGHTMGR->getId(), "BLM") == 0)
   {
      const char *pref = Con::getVariable("$pref::Video::mode");

      U32 prefAA = dAtoi(StringUnit::getUnit(pref, 5, " "));
      if (prefAA != mode.antialiasLevel)
      {
         mode.parseFromString(pref);
         mPlatformWindow->setVideoMode(mode);

         Con::printf("AntiAliasing has been enabled while running BasicLighting.");
      }
   }*/