mh5visible.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 "mh5visible.h"
#include "mh5display.h"         /* API to real display          */
#include "mh5application.h"     /* display stack                */
#include "mh5object.h"          /* for actions                  */
#include "mh5variable.h"        /* for actions                  */
#include "mh5queue.h"           /* Events           */
#include "mh5memory.h"
#include "mh5debug.h"
#include "mh5dynamiclineart.h"
#include "mh5profile.h"

#include "mh5drawtext.h"
#include "mg_api.h"

#include <string.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 MHEG5visiblePrint(MHEG5Visible *visible, char *out)
{
   /* Base Class */
   MHEG5ingredientPrint(&visible->ingredient, out);

   /* exchanged attributes */
   MHEG5indent(out);
   MHEG_PRINT(out, ":OrigBoxSize ");
   MHEG5intPrint(visible->originalBoxSize[0], out);
   MHEG_PRINT(out, " ");
   MHEG5intPrint(visible->originalBoxSize[1], out);
   MHEG5newLine(out);

   if (visible->originalPosition[0] || visible->originalPosition[1])
   {
      MHEG5indent(out);
      MHEG_PRINT(out, ":OrigPosition ");
      MHEG5intPrint(visible->originalPosition[0], out);
      MHEG_PRINT(out, " ");
      MHEG5intPrint(visible->originalPosition[1], out);
      MHEG5newLine(out);
   }

   if (visible->originalPaletteRefID != 0)
   {
      MHEG5indent(out);
      MHEG_PRINT(out, ":OriginalPaletteRefID ");
      MHEG5intPrint(visible->originalPaletteRefID, out);
      MHEG5newLine(out);
   }

   if (visible->originalPaletteRefGROUPID.len)
   {
      MHEG5indent(out);
      MHEG_PRINT(out, ":OriginalPaletteRefGROUPID ");
      MHEG5stringPrint( *((MHEG5String *)&visible->originalPaletteRefGROUPID), out );
      MHEG5newLine(out);
   }

   /* internal attributes */
   if (visible->boxSize[0] || visible->boxSize[1])
   {
      MHEG5indent(out);
      MHEG_PRINT(out, "// BoxSize:\t");
      MHEG5intPrint(visible->boxSize[0], out);
      MHEG_PRINT(out, " ");
      MHEG5intPrint(visible->boxSize[1], out);
      MHEG5newLine(out);
   }
   if (visible->position[0] || visible->position[1])
   {
      MHEG5indent(out);
      MHEG_PRINT(out, "// Position:\t");
      MHEG5intPrint(visible->position[0], out);
      MHEG_PRINT(out, " ");
      MHEG5intPrint(visible->position[1], out);
      MHEG5newLine(out);
   }
}

#endif

MHEG5Bool MHEG5visibleIs(MHEG5Root *target)
{
   switch (target->clazz)
   {
      case MHEG5RTGRAPHICS:
      case MHEG5LINEART:
      case MHEG5BITMAP:
      case MHEG5TEXT:
      case MHEG5VIDEO:
      case MHEG5SLIDER:
      case MHEG5DYNAMICLINEART:
      case MHEG5RECTANGLE:
      case MHEG5ENTRYFIELD:
      case MHEG5HYPERTEXT:
      case MHEG5HOTSPOT:
      case MHEG5PUSHBUTTON:
      case MHEG5SWITCHBUTTON:
         return MHEG5TRUE;
      default:;
   }
   return MHEG5FALSE;
}

void MHEG5visibleInit(MHEG5Visible *visible)
{
   assert(visible);

   MHEG5ingredientInit(&visible->ingredient);
}

void MHEG5visibleFree(MHEG5Visible *visible)
{
   assert(visible);

   MHEG5ingredientFree(&visible->ingredient);

   if (visible->originalPaletteRefGROUPID.len)
   {
      MHEG5stringDestruct((MHEG5String *)&visible->originalPaletteRefGROUPID);
   }
}

void MHEG5visibleClone(MHEG5Visible *destination, MHEG5Visible *source)
{
   assert(source);
   assert(destination);

   MHEG5ingredientClone(&destination->ingredient, &source->ingredient);

   destination->originalBoxSize[0] = source->originalBoxSize[0];
   destination->originalBoxSize[1] = source->originalBoxSize[1];
   destination->originalPosition[0] = source->originalPosition[0];
   destination->originalPosition[1] = source->originalPosition[1];
   destination->originalPaletteRefID = source->originalPaletteRefID;
   if (destination->originalPaletteRefGROUPID.len)
   {
      MHEG5String name;
      name.len = source->originalPaletteRefGROUPID.len;
      name.data = source->originalPaletteRefGROUPID.ptr.name;
      name = MHEG5stringCopy(name);
      destination->originalPaletteRefGROUPID.len = name.len;
      destination->originalPaletteRefGROUPID.ptr.name = name.data;
   }
}

void MHEG5visiblePrepare(MHEG5Visible *visible)
{
   CALL_PRINT((">> MHEG5visiblePrepare(%p)\n", visible));

   assert(visible);
   if (visible->ingredient.root.runningStatus)
   {
      INFO_PRINT(("MHEG5visiblePrepare : RunningStatus == TRUE\n"));
      CALL_PRINT(("<< MHEG5textPrepare\n"));
      return;
   }

   visible->boxSize[0] = visible->originalBoxSize[0];
   visible->boxSize[1] = visible->originalBoxSize[1];
   visible->position[0] = visible->originalPosition[0];
   visible->position[1] = visible->originalPosition[1];
#if 0
   visible->paletteRefID = visible->originalPaletteRefID;
   visible->paletteRefGROUPID = visible->originalPaletteRefGROUPID;
#endif
   assert( visible->graphic_data == NULL );

   MHEG5displayStackAdd((MHEG5Root *) visible, MHEG5TRUE);
   MHEG5ingredientPrepare(&visible->ingredient);

   CALL_PRINT(("<< MHEG5textPrepare\n"));
}

/*
     Destruction
     Execute the following sequence of actions:
     1. If the Visible object is referenced in the DisplayStack of the active
     Application object, remove the reference to this Visible from the
     DisplayStack.
     2. Execute the Destruction behaviour as defined in the base class.
 */

void MHEG5visibleDestruct(MHEG5Visible *visible)
{
   assert(visible);

   MHEG5displayStackDelete((MHEG5Root *) visible);
   MHEG5ingredientDestruct(&visible->ingredient);
}

/*
     Activation
     Execute the following sequence of actions:
     1. Execute the Activation behaviour as defined in the base class.
     2. Display the Visible according to its position in the DisplayStack and to the
     position and the bounding box defined by the Position and BoxSize
     attributes.
     3. Set the RunningStatus to True and generate an IsRunning event.
 */
void MHEG5visibleActivate(MHEG5Visible *visible)
{
   assert(visible);
   if (!visible->ingredient.root.runningStatus)
   {
      /* MHEG5ingredientActivate(&visible->ingredient); <- does nothing, so don't bother */

      visible->ingredient.root.runningStatus = MHEG5TRUE;

      MHEG5displayShow(visible);

      MHEG5sendSync((MHEG5Root *) visible, MHEG5ISRUNNING, 0);
   }
}

/*
     Deactivation
     Execute the following sequence of actions:
     1. If the RunningStatus attribute of the object is False, ignore the behaviour,
     otherwise:
     2. Stop displaying the Visible.
     3. Execute Deactivation behaviour as defined in the base class.
 */

void MHEG5visibleDeactivate(MHEG5Visible *visible)
{
   assert(visible);
   if (visible->ingredient.root.runningStatus)
   {
      MHEG5displayHide(visible);
      MHEG5ingredientDeactivate(&visible->ingredient);
   }
}

/*
     Actions
 */

MHEG5ErrorCode MHEG5setPosition(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Int x = 0, y = 0;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }
   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }

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

   MHEG5resolveGenericInteger(thirdParam, &y);

   MHEG5visibleSetPosition(((MHEG5Visible *) target), x, y);

   return MHEG5ERR_NOERROR;
}

/*
   For Listgroup
 */

void MHEG5visibleResetPosition(MHEG5Visible *visible)
{
   MHEG5visibleSetPosition(visible,
      visible->originalPosition[0],
      visible->originalPosition[1]);
}

void MHEG5visibleSetPosition(MHEG5Visible *visible, MHEG5Int x, MHEG5Int y)
{
   MHEG5Root *root = (MHEG5Root *)visible;

   assert(visible);
   if (!MHEG5visibleIs(root))
      return;
   if ((root->clazz != MHEG5DYNAMICLINEART) &&
       (visible->position[0] == x) &&
       (visible->position[1] == y))
   {
      return;
   }

   if (root->runningStatus)
   {
      MHEG5displayHide(visible);
   }

   visible->position[0] = x;
   visible->position[1] = y;

   switch (root->clazz)
   {
      case MHEG5VIDEO:
         if (root->runningStatus)
         {
            MHEG5displayVideoPositionUpdate();
         }
         break;

      case MHEG5BITMAP:
         if (((MHEG5Ingredient *)root)->contentHook == CHOOK_BITMAP_NORMAL_IFRAME ||
             ((MHEG5Ingredient *)root)->contentHook == CHOOK_BITMAP_H264_IFRAME
          #ifdef INCLUDE_FREESAT
             || ((MHEG5Ingredient *)root)->contentHook == CHOOK_BITMAP_IMAGE_PLANE_IFRAME
          #endif
             )
         {
            if (root->runningStatus)
            {
               MHEG5displayVideoPositionUpdate();
            }
         }
         break;

      #ifdef DRAW_IN_ADVANCE
      case MHEG5TEXT:
         if (visible->restricted && visible->graphic_data != NULL)
         {
            MG_FreeData( visible->graphic_data );
            visible->graphic_data = NULL;
         }
         break;
      #endif

      default:;
   }
   if (root->runningStatus)
   {
      MHEG5displayShow(visible);
   }
}

MHEG5ErrorCode MHEG5getPosition(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Root *xVar, *yVar;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

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

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

   if (xVar && yVar)
   {
      if ((xVar->clazz == MHEG5INTEGERVARIABLE) && (yVar->clazz == MHEG5INTEGERVARIABLE) &&
          (xVar->runningStatus) && (yVar->runningStatus))
      {
         ((MHEG5IntegerVariable *) xVar)->value = ((MHEG5Visible *) target)->position[0];
         ((MHEG5IntegerVariable *) yVar)->value = ((MHEG5Visible *) target)->position[1];
      }
      else
      {
         return MHEG5ERR_PARAMNOTACTIVE;
      }
   }
   else
   {
      return MHEG5ERR_PARAMNOTACTIVE;
   }
   return MHEG5ERR_NOERROR;
}

/*
     SetBoxSize (XNewBoxSize, YNewBoxSize)
     Change the size of the bounding box of the target Visible.
     Execute the following sequence of actions:
     1. Set the BoxSize attribute.
     2. Redraw the graphic widget representing the object on the screen in the
     bounding box defined by the BoxSize and Position attributes and according
     to its position in the DisplayStack of the active Application object.

     Provisions of use:
     The Target object shall be an available Visible object.
     XNewBoxSize and YNewBoxSize shall be positive values and different from 0.
 */
MHEG5ErrorCode MHEG5setBoxSize(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Int x = 0, y = 0;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

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

   MHEG5resolveGenericInteger(thirdParam, &y);

   if ((x >= 0) && (y >= 0) &&
       ((((MHEG5Visible *) target)->boxSize[0] != x) ||
        (((MHEG5Visible *) target)->boxSize[1] != y))
       )
   {
      MHEG5Visible *visible = (MHEG5Visible *)target;

      if (target->runningStatus)
      {
         MHEG5displayHide(visible);
      }

      visible->boxSize[0] = x;
      visible->boxSize[1] = y;

      #ifndef DRAW_IN_ADVANCE
      if (target->clazz != MHEG5DYNAMICLINEART &&
          visible->graphic_data != NULL)
      {
         MG_FreeData( visible->graphic_data );
         visible->graphic_data = NULL;
      }
      #endif

      /* need to re-do graphical data if box size changes */
      switch (target->clazz)
      {
         case MHEG5DYNAMICLINEART:
            MHEG5freeDynamicLineart((MHEG5DynamicLineart *)target);
            MHEG5initDynamicLineart((MHEG5DynamicLineart *)target);
            break;

      #ifdef DRAW_IN_ADVANCE
         case MHEG5HYPERTEXT:
            MHEG5drawHypertext((MHEG5Hypertext *)target );
            break;
         case MHEG5ENTRYFIELD:
            MHEG5drawEntry((MHEG5Entryfield *)target, CURSOR_INSERT);
            break;
         case MHEG5TEXT:
            MHEG5drawText((MHEG5Text *)target );
            break;

         case MHEG5BITMAP:
            if (visible->graphic_data != NULL)
            {
               MG_FreeData( visible->graphic_data );
               visible->graphic_data = NULL;
            }
            switch (visible->ingredient.contentHook)
            {
               case CHOOK_BITMAP_PNG:
                  MG_DrawPng( visible->ingredient.data, visible->ingredient.dataLen, visible );
                  break;

               case CHOOK_BITMAP_JPG:
                  MG_DrawJpg( visible->ingredient.data, visible->ingredient.dataLen, visible );
                  break;

               default:;
            }
            break;
      #endif /*DRAW_IN_ADVANCE*/

         default:;
      }

      if (target->runningStatus)
      {
         MHEG5displayShow( visible );
      }
   }
   return MHEG5ERR_NOERROR;
}

/*
     GetBoxSize (XBoxSizeVar, YBoxSizeVar)
     Returns the size of the bounding box of the target Visible.
     Set the Variables referenced by XBoxSizeVar and YBoxSizeVar to the value of the X
     and Y position of the target visible respectively.

     Provisions of use:
     The Target object shall be an available Visible object.
     XBoxSizeVar and YBoxSizeVar shall refer to active IntegerVariable objects.
 */
MHEG5ErrorCode MHEG5getBoxSize(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5GList *thirdParam = 0;
   MHEG5Root *xVar, *yVar;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

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

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

   if (xVar && yVar)
   {
      if ((xVar->clazz == MHEG5INTEGERVARIABLE) && (yVar->clazz == MHEG5INTEGERVARIABLE) &&
          (xVar->runningStatus) && (yVar->runningStatus))
      {
         ((MHEG5IntegerVariable *) xVar)->value = ((MHEG5Visible *) target)->boxSize[0];
         ((MHEG5IntegerVariable *) yVar)->value = ((MHEG5Visible *) target)->boxSize[1];
      }
      else
      {
         return MHEG5ERR_PARAMNOTACTIVE;
      }
   }
   else
   {
      return MHEG5ERR_PARAMNOTACTIVE;
   }

   return MHEG5ERR_NOERROR;
}

/*
     BringToFront
     Put a Visible at the foreground of the screen.
     Execute the following sequence of actions:
     1. If the target Visible object is not referenced in the DisplayStack of the active
     Application object, ignore this action.
     2. If the target Visible object is referenced in the DisplayStack of the active
     Application object, move the reference to this Visible at the top of the
     DisplayStack.
     3. If the target Visible object is active, redraw the graphic widget representing
     the object on the screen in the bounding box defined by the BoxSize and
     Position attributes and according to its position in the DisplayStack of the
     active Application object.

     Provisions of use:
     The Target object shall be an available Visible object.
 */
MHEG5ErrorCode MHEG5bringToFront(MHEG5Root *target, MHEG5GList *params)
{
   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

   MHEG5displayStackToTop(target);

   MHEG5displayRedraw((MHEG5Visible *) target);

   return MHEG5ERR_NOERROR;
}

/*
     SendToBack
     Put a Visible at the background of the screen.
     Execute the following sequence of actions:
     1. If the target Visible object is not referenced in the DisplayStack of the active
     Application object, ignore this action
     2. If the target Visible object is referenced in the DisplayStack of the active
     Application object, move the reference to this Visible at the bottom of the
     DisplayStack.
     3. If the target Visible object is active, redraw the graphic widget representing
     the object on the screen in the bounding box defined by the BoxSize and
     Position attributes and according to its position in the DisplayStack of the
     active Application object.

     Provisions of use:
     The Target object shall be an available Visible object.
 */
MHEG5ErrorCode MHEG5sendToBack(MHEG5Root *target, MHEG5GList *params)
{
   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

   MHEG5displayStackToBottom(target);

   MHEG5displayRedraw((MHEG5Visible *) target);

   return MHEG5ERR_NOERROR;
}

/*
     PutBefore (ReferenceVisible)
     Put a Visible exactly in front of another Visible in the display stack.
     Execute the following sequence of actions:
     1. If the target Visible object is not referenced in the DisplayStack of the active
     Application object, ignore this action.
     2. If the target Visible object is referenced in the DisplayStack of the active
     Application object, move the reference to this Visible at the position exactly
     before the reference to the ReferenceVisible in the DisplayStack.
     3. If the target Visible object is active, redraw the graphic widget representing
     the object on the screen in the bounding box defined by the BoxSize and
     Position attributes and according to its position in the DisplayStack of the
     active Application object.

     Provisions of use:
     The Target object shall be an available Visible object.
     ReferenceVisible shall be a reference to an available Visible object.
     The DisplayStack of the active Application object shall contain a reference to the
     ReferenceVisible object.
 */
MHEG5ErrorCode MHEG5putBefore(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5Root *refVisible = 0;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   (void)MHEG5resolveGenericORef(params, &refVisible);
   if (refVisible == NULL || !refVisible->availabilityStatus)
   {
      return MHEG5ERR_REFERENCEDPARAMNOTAVAILABLE;
   }
   if (!MHEG5visibleIs(refVisible))
   {
      return MHEG5ERR_WRONGPARAM;
   }

   MHEG5displayStackPutBefore(target, refVisible);

   MHEG5displayRedraw((MHEG5Visible *) target);

   return MHEG5ERR_NOERROR;
}

/*
     PutBehind (ReferenceVisible)
     Put a Visible exactly below another Visible in the display stack.
     Execute the following sequence of actions:
     1. If the target Visible object is not referenced in the DisplayStack of the active
     Application object, ignore this action.
     2. If the target Visible object is referenced in the DisplayStack of the active
     Application object, move the reference to this Visible at the position exactly
     after the reference to the ReferenceVisible in the DisplayStack.
     3. If the target Visible object is active, redraw the graphic widget representing
     the object on the screen in the bounding box defined by the BoxSize and
     Position attributes and according to its position in the DisplayStack of the
     active Application object.

     Provisions of use:
     The Target object shall be an available Visible object.
     ReferenceVisible shall be set or refer to a reference to an available Visible
     object.
     The DisplayStack of the active Application object shall contain a reference to the
     ReferenceVisible object.
 */
MHEG5ErrorCode MHEG5putBehind(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5Root *refVisible = 0;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }
   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   (void)MHEG5resolveGenericORef(params, &refVisible);
   if (refVisible == NULL || !refVisible->availabilityStatus)
   {
      return MHEG5ERR_REFERENCEDPARAMNOTAVAILABLE;
   }
   if (!MHEG5visibleIs(refVisible))
   {
      return MHEG5ERR_WRONGPARAM;
   }

   MHEG5displayStackPutBehind(target, refVisible);

   MHEG5displayRedraw((MHEG5Visible *) target);

   return MHEG5ERR_NOERROR;
}

/*
     SetPaletteRef(NewPaletteRef)
     Change the colour look-up table used to render colours of the Visible object.
     Execute the following sequence of actions:
     1. Set PaletteRef of the target Visible to NewPaletteRef.
     2. If the target Visible is active, redraw the Visible by taking into account the new
     value of PaletteRef.

     Provisions of use:
     The Target object shall be an available Visible object.
     NewPaletteRef shall contain a reference to an active Palette object.
 */
MHEG5ErrorCode MHEG5setPaletteRef(MHEG5Root *target, MHEG5GList *params)
{
   MHEG5Root *palette = 0;

   assert(target);

   if (!MHEG5visibleIs(target))
   {
      return MHEG5ERR_WRONGTARGET;
   }

   if (!params)
   {
      return MHEG5ERR_WRONGNUMBEROFPARAMS;
   }
   (void)MHEG5resolveGenericORef(params, &palette);
   if (palette == NULL || !palette->runningStatus)
   {
      return MHEG5ERR_PARAMNOTACTIVE;
   }
   if (palette->clazz != MHEG5PALETTE)
   {
      return MHEG5ERR_WRONGPARAM;
   }

#if 0
   ((MHEG5Visible *) target)->paletteRefID = palette->id;
   ((MHEG5Visible *) target)->paletteRefGROUPID.len = 0;
   ((MHEG5Visible *) target)->paletteRefGROUPID.ptr.group = palette->grp;
#endif

   MHEG5displayRedraw((MHEG5Visible *) target);

   return MHEG5ERR_NOERROR;
}