mh5video.c

Go to the documentation of this file.

/*******************************************************************************
 * Copyright © 2014 The DTVKit Open Software Foundation Ltd (www.dtvkit.org)
 * Copyright © 2004 Ocean Blue Software Ltd
 * Copyright © 2000 Koninklijke Philips Electronics N.V
 *
 * This file is part of a DTVKit Software Component
 * You are permitted to copy, modify or distribute this file subject to the terms
 * of the DTVKit 1.0 Licence which can be found in licence.txt or at www.dtvkit.org
 * 
 * THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
 * EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES
 * OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
 * 
 * If you or your organisation is not a member of DTVKit then you have access
 * to this source code outside of the terms of the licence agreement
 * and you are expected to delete this and any associated files immediately.
 * Further information on DTVKit, membership and terms can be found at www.dtvkit.org
 *******************************************************************************/
/*---includes for this file--------------------------------------------------*/
#include <string.h>
#include "mh5base.h"
#include "mh5debug.h"
#include "mh5misc.h"
#include "mh5object.h"
#include "mh5variable.h"        /* For actions */
#include "mh5video.h"
#include "mh5application.h"
#include "mh5memory.h"          /* for constructor/destructor */
#include "mh5display.h"

/*---constant definitions for this file--------------------------------------*/


/*---local typedef structs for this file-------------------------------------*/

/*---local (static) variable declarations for this file----------------------*/

/*---local function definitions----------------------------------------------*/

/*---global function definitions---------------------------------------------*/

/*
   Debug
 */
#ifdef MH5PRINTOUT

void MHEG5videoPrint(MHEG5Video *video, char *out)
{
   /* base print */
   MHEG5visiblePrint(&video->visible, out);

   MHEG5indent(out);
   MHEG_PRINT(out, ":componentTag ");
   MHEG5intPrint(video->componentTag, out);
   MHEG5newLine(out);

   if (video->terminationFreeze)
   {
      MHEG5indent(out);
      MHEG_PRINT(out, ":Termination freeze");
      MHEG5newLine(out);
   }
}

#endif  /* #ifdef MH5PRINTOUT */

void MHEG5videoInit(MHEG5Video *video)
{
   assert(video);

   MHEG5visibleInit(&video->visible);
}

void MHEG5videoFree(MHEG5Video *video)
{
   assert(video);

   MHEG5visibleFree(&video->visible);
}

/*
     39.3 Internal behaviours
     This class defines no additional internal behaviours.
 */

void MHEG5videoPrepare(MHEG5Video *video)
{
   assert(video);

   video->xOffset = 0;
   video->yOffset = 0;
   video->scaleSet = MHEG5FALSE;

   MHEG5visiblePrepare(&video->visible);
}

void MHEG5videoActivate(MHEG5Video *video)
{
   assert(video);

   if (!video->visible.ingredient.root.runningStatus)
   {
      if (!video->visible.ingredient.root.availabilityStatus)
      {
         MHEG5videoPrepare( video );
      }

      /* If the parent stream is running, start displaying the video object */
      if (video->parent->ingredient.root.runningStatus)
      {
         MHEG5displayVideoPlay(video);
      }
      /* Invoke the activation behaviour from the base class. This will cause
       * video window to be drawn into OSD plane.
       */
      MHEG5visibleActivate(&video->visible);
   }
}

void MHEG5videoDeactivate(MHEG5Video *video)
{
   assert(video);

   if (video->visible.ingredient.root.runningStatus)
   {
      /* Call deactivation behaviour of the base class. Video window will be
       * removed from OSD plane.
       */
      MHEG5visibleDeactivate(&video->visible);

      if ((MHEG5getCurrentApplication() == 0) ||
          (MHEG5getCurrentApplication()->streamContinuanceFlag == MHEG5FALSE))
      {
         /* Stop the video decoder */
         if (video->parent->ingredient.root.runningStatus)
         {
            MHEG5displayVideoStop();
         }
      }
   }
}

void MHEG5videoDestruct(MHEG5Video *video)
{
   assert(video);
   MHEG5visibleDestruct(&video->visible);
   MHEG5displayVideoDestroy( video );
}

/*
     39.4 Effect of MHEG-5 actions
     This class has the same set of MHEG-5 actions as its base class, with identical semantics. In addition, the
     following applicable MHEG-5 actions are defined:

     SetData, Clone
     SetData and Clone shall not be targeted to Video.
 */

MHEG5ErrorCode MHEG5scaleVideo(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam;
   MHEG5Int XScale, YScale;
   MHEG5Video *video;
   INFO_PRINT(("MHEG5scaleVideo: \n"));

   assert(target);

   if (target->clazz != MHEG5VIDEO)
   {
      return MHEG5ERR_WRONGTARGET;
   }
   video = (MHEG5Video *) target;

   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   thirdParam = MHEG5resolveGenericInteger(params, &XScale);

   if (!thirdParam)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   MHEG5resolveGenericInteger(thirdParam, &YScale);
   if (XScale == 0 || YScale == 0)
   {
      return MHEG5ERR_WRONGPARAM;
   }

   video->scaleSet = MHEG5TRUE;
   video->xScale = XScale;
   video->yScale = YScale;

   if (video->visible.ingredient.root.runningStatus)
   {
      MHEG5displayVideoPositionUpdate();
   }

   return MHEG5ERR_NOERROR;
}

MHEG5ErrorCode MHEG5setVideoDecodeOffset(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Video *video = 0;
   MHEG5Int xOffset = 0, yOffset = 0;

   assert(target);

   if (target->clazz != MHEG5VIDEO)
   {
      return MHEG5ERR_WRONGTARGET;
   }

   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   thirdParam = MHEG5resolveGenericInteger(params, &xOffset);

   if (!thirdParam)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   MHEG5resolveGenericInteger(thirdParam, &yOffset);

   video = (MHEG5Video *)target;
   video->xOffset = xOffset;
   video->yOffset = yOffset;
   if (video->visible.ingredient.root.runningStatus)
   {
      MHEG5displayVideoPositionUpdate();
   }

   return MHEG5ERR_NOERROR;
}

MHEG5ErrorCode MHEG5getVideoDecodeOffset(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Root *xOffset, *yOffset;
   MHEG5Video *video;

   assert(target);

   if (target->clazz != MHEG5VIDEO)
   {
      return MHEG5ERR_WRONGTARGET;
   }
   video = (MHEG5Video *)target;

   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   thirdParam = MHEG5resolveORef(params, &xOffset);

   if (!thirdParam)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   MHEG5resolveORef(thirdParam, &yOffset);

   if (!xOffset || !yOffset)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   if (xOffset->clazz != MHEG5INTEGERVARIABLE ||
       yOffset->clazz != MHEG5INTEGERVARIABLE)
   {
      return MHEG5ERR_WRONGPARAM;
   }
   if (!xOffset->runningStatus || !yOffset->runningStatus)
   {
      return MHEG5ERR_PARAMNOTACTIVE;
   }

   ((MHEG5IntegerVariable *) xOffset)->value = video->xOffset;
   ((MHEG5IntegerVariable *) yOffset)->value = video->yOffset;

   return MHEG5ERR_NOERROR;
}